Keeping Image Current

From Croquet Consortium

These instructions are largely for the Hedgehog version of Croquet, but are useful to understanding the process. For some guidelines to updating the Jabberwocky version of Croquet, see https://lists.duke.edu/sympa/arc/croquet-dev/2007-05/msg00035.html

Overview

Generally, if you don't understand what this is about, then don't do it ;-) There will be another release which has all the new stuff properly included. This section is only useful if you like living dangerously and want to have the absolute latest updates for Croquet. These instructions come with the disclaimer "some assembly required". If you don't feel like you can do the assembly on your own, wait for the next release.

Monticello is a version control system used by Croquet and Squeak. The "official" CroquetSource Monticello site is accessible by web browser at http://hedgehog.software.umn.edu:8888/ and within Croquet in the Monticello browser. Monticello deals mainly with two things, repositories and packages. We have currently four "official" repositories which are present in the Monticello browser by default. Their respective names and urls are:

1. Homebase: This is the repository for all the Squeak base packages. http://hedgehog.software.umn.edu:8888/Homebase
2. Tweak: This is the repository for all the Tweak packages. http://hedgehog.software.umn.edu:8888/Tweak
3. Hedgehog: This is the repository for all the core Croquet packages. http://hedgehog.software.umn.edu:8888/hedgehogRC
4. Contributions: The repository for all the contributed packages. http://hedgehog.software.umn.edu:8888/Contributions

Within these four repositories you should generally update "top-to-bottom", that is, first Homebase, then Tweak, then Hedgehog, then Contributions. There are some additional internal dependencies, for example you need to load the Monticello changes before you can load the Compiler changes in the Homebase repository, and you need to load the new packages in the Hedgehog repository before the changed packages.

You don't have to load anything from MetaCroquet since it is an entirely different repository which has nothing to do with the standard Croquet distribution.

See also Developer_FAQs#Keeping_Image_Current.

There is also a PublicContributions repository at CroquetSource.

Step By Step

Here is a Mark P. McCahill movie that describes how to update your Croquet image: http://hedgehog.software.umn.edu/croquet/croquetMovies/updateToMotion.mov

and here are step by step instructions:

1. Click somewhere in the Croquet desktop to open the World menu, and select the "open" item.
2. Open a Monticello browser.
3. In the right pane of the Monticello browser, click on the line that says "http://hedgehog.software.umn.edu:8888/Homebase" then click on the "open" button at the top of the Monticello window. A new Monticello window appears listing the categories within that repository.
4. Click on the refresh button, then scroll the left pane of the window and look for a bolded category name. If the category "Monticello" is bolded, that category should be updated first. For this example, the category named "Morphic" may be bolded. Click on Morphic. You will now see that the right pane has a list of Morphic packages. The most recent is at the top of the list and bolded if it is not installed. Click on it to select it. You may have to wait a little for Croquet to download the package from the network, but once a local copy of the package exists, the "load" and "merge" buttons will be enabled.
5. Click on the "merge" button to apply the update. Croquet will display some messages about snapshotting methods and diffing, and will then open another window titled "Merging Morphic" and a list of things that will be changed. Click on the "merge" button in this window to update. After the update is installed completely, the formerly bolded items in the previous window will no longer be bold. Yippee! one update done...
6. Repeat these steps for any other categories that are bolded. If there are no other categories in the left pane that are bolded, you are done with the updates in this repository.
7. Close the Homebase repository window, go back to the first Monticello window and select the "http://hedgehog.software.umn.edu:8888/Tweak" line to open the Tweak repository. This makes a new Monticello window, and again you may see categories that are bolded. Open each of them, and apply the updates as described above. Be sure to scroll down the left pane categories list to make sure you check all the categories for pending updates.
8. Close the Tweak repository window, go back to the first Monticello window and select the "http://hedgehog.software.umn.edu:8888/hedgehogRC" line and apply any updates available.
9. Close the Hedgehog repository window, go back to the first Monticello window and select the "http://hedgehog.software.umn.edu:8888/Contributions" line. There will likely be more updates available here, and the order of install is important.
10. There may be one or more categories that will not be bolded and are not underlined because they have not been installed at all yet, possibly at the end of the list. Those categories should be updated first.
11. Then install the other bolded category updates as described above.
12. Close the Contributions repository window, go back to the first Monticello browser window and close it too.
13. Voila! you are completely up to date. :-)
14. You may also choose to click somewhere in the Croquet desktop to open the World menu, and select the "save as new version" item at this point.