links to this page:    
View this PageEdit this PageUploads to this PageHistory of this PageTop of the SwikiRecent ChangesSearch the SwikiHelp Guide
Monticello Basics
Last updated at 12:13 am UTC on 1 January 2017

Note this is a work in progress. Please leave comments when you are finished.


See http://www.wiresong.ca/Monticello/ and Monticello for an introduction into concepts.
See also Adding and removing classes or methods from a Monticello Package and Monticello Technical for suggestions on creating a package using Monticello.

Getting Started

When you start a fresh image for the first time you will need to install Monticello. Once Squeak is up and running follow these steps:

After a while (depending on your internet connection) the install will finish and you'll be able to run Monticello

Note: For recent Monticello versions you also need to install PackageInfo. Follow the same steps as above.

Back to Contents

Running Monticello

To start Monticello from the World menu select the open submenu then select Monticello Browser.
This should display the following window: (note your installation will show different package names and repository directories from the figures included here.)

Uploaded Image: open.png

The pane on the left lists all the Monticello packages currently installed in your image. The pane on the right lists all the repositories Monticello currently knows for that package, and the order they will be searched for accessing repository editions.

Back to Contents

Selecting a Package

To select a package that is listed in the left pane
The buttons:

Back to Contents

Opening a Repository

To open a repository that is listed in the right pane
This should result in a window similar to the one below.

Uploaded Image: Open1.png

Here the left hand pane displays all the packages in the repository you opened; the right hand pane displays all the different versions of the packages in that repository. Yellow clicking in the right pane will bring up a menu that will allow you to sort the packages by different criterion.

Only the Refresh button is active. Pressing it will cause Monticello to re-read the repository and update the window.

Back to Contents

Opening a Package and Version

To open a particular version of a package:
This will collaspe the right hand pane down to just those files in the package.
Depending on the location of the repository (local or networked) this could take a few minutes.
You'll noticed two changes in the window. First, all the buttons at the top of the window will become active and second, the bottom pane will display data.

Uploaded Image: Open2.png

The bottom pane contains information about this version.
The final section of the bottom pane should contain information and comments the author entered when she did the commit.

The buttons support dynamic help messages, moving the mouse pointer over a button will bring up a brief help message. The buttons are:

Back to Contents

See also ChangeSorter vs. ChangeSet vs. Monticello
wiz (24 Jul 2005 )
  1. How much space does MC use in doing its work?
  2. How do I use MC if I want to add a changed class to a larger package. (I.E how do you incorperate sub-packages into an MC naming scheme?)

Nothing here tells me how to create a new package. For example, I've created some new classes and put them in a new System Category: how do I write them out as a package?

>> When you create a new package, you use the same name for the package that you use for the category in Squeak. You create a new category for the new package; when you add the package name to Monticello ( +Package button) use the category name. Highlight the category name and the repository name where you want to store the package and use the save button. This is confusing to me too, I have to figure it out every time I want to start using Monticello for a new package.

I user the term category rather than System Category because that is the term used when subclassing an object+