From AlphaWiki

CVS: CVS Updates Alpha8/X Mac OS

This page contains information for updating from the AlphaTcl CVS for Alpha 8/X in the MacOS.

Important Note (15 May 2006) : has announced a change in its CVS servers, and the Server Hostname should no longer be

but rather

Macintosh users should use the version of MacCVS Pro and its session files that are provided with the Alpha executable.

If you are not using OSX, note that MacCVS Pro requires UTCUtils and therefore has a system requirement of Mac OS 9.0 or newer. No matter what OS you are using, you should always quit your Alpha application before attempting to update via the CVS.

This page includes the following sections:

Using the "AlphaDev Menu > AlphaTcl CVS" menu

The "AlphaDev Menu > AlphaTcl CVS" menu provides you with some menu items that will make it easier for you to update from the cvs using the MacCVS Pro that was included with your distribution. Activate this menu using the

Config > Global Setup > Menus

command, click on the checkbox next to "Alpha Developer Menu", and then press "OK".

To use this menu to update to HEAD versions of AlphaTcl, select

AlphaDev Menu > AlphaTcl CVS > AlphaTcl Devel Checkout

This should open MacCVS Pro for you. (More information below about this application.) If this is the first time that you've used this command, MacCVS Pro should inform you that no "Project root file" has been set, and open the dialog for you. If not, select "Edit > Session Settings" to see this dialog. The "local tree directory" should be set to the folder containing AlphaX/8; when this is set the viewer window will show your Help, Examples, Tcl, etc folders. Before you close this dialog, make sure that the "Default Checkout Options" include


(case matters here) and the next "default revision" field should be empty. Now you can close this dialog (press OK) and select the command

Action > Check Out Default Module

This will update your AlphaTcl library to the most recent "HEAD" sources. After the checkout is complete, close MacCVS Pro, go back to AlphaX/8, close that application, and then restart. Package indices should be automatically rebuilt when necessary.

The next time that you select the "AlphaDev > AlphaTcl CVS > AlphaTcl Devel Checkout" command MacCVS Pro should proceed to update your library without any further prompting.

MacCVS Pro

Alpha 8 and X were distributed with base CVS installations, as well as the MacCVS Pro application -- look in your Tools directory. The MacCVS Pro application can live anywhere on your local drive. (See the MacCVS Pro Home Page at for software documentation.)

There should be a file named Update AlphaTcl in your Alpha folder, at the same level as the application . Double click on this file/alias, and it should be opened in the MacCVS Pro application with the proper settings. (These settings are described below if you need to change them for any reason.) You'll know that the settings are correct if a new window appears listing the contents of your Alpha folder, with columns for

    Name    Status    Version    Tag    Last Modified

The window should look something like this (but with AlphaTcl folders, and with an OSX look instead of OS9):


If this is not the case, see the Session Settings section below.

During the Checkout procedures described below, a listing of all files in your distribution along with their tag information is transmitted via the internet and compared to those contained the central cvs repository -- if any files need to be updated, they will then be changed in your local disk. Any errors will be reported in the Message window -- see [CVS Messages and What They Mean] for more details.

Updating to the CURRENT version

The default session preference for the Default Revision tag in this .cvs file is CURRENT. As described in the CVS.AlphaTclCVS page, all of the files in the cvs with this tag are reasonably stable, though there are likely some known but unresolved issues remaining to be dealt with. Files in the AlphaTcl CVS are periodically tagged as CURRENT during the development cycle between public 'final' releases.

To update your current distribution to the CURRENT tag, all that you need to do is select the Action > Check Out Default Module menu item, bound to "Command-;" -- all files will be updated as necessary. When the checkout is complete, you can close all windows and quit the Mac CVS Pro application.

Updating to the HEAD version

To update to HEAD sources, you need to use the ''Edit > Session Settings'' menu item which will open a dialog window. In the Default Checkout Options section, there is an editable text field for Default Revision/Date ... Make sure that the pop-up menu is set to Revision, and ensure that the tag is HEAD instead of CURRENT or STABLE. Click on OK to dismiss this dialog, and then use the Action > Check Out Default Module menu item as described above.

When you close the Mac CVS Pro windows, you should be prompted to save the new session settings. You should save them. The next time you open the "Update AlphaTcl'' file and perform a Checkout operation, the HEAD tags will be used.

Session Settings

The file named Update AlphaTcl in your Alpha folder, at the same level as the application, contains default settings for checking files out of the CVS. All settings should be ready to go, but if you wish to verify them, select Edit > Session Settings...

The first pane of the dialog should look something like this:


The enclosed :Alpha: directory is ${HOME} below.

  1. Set Local Tree Directory to point to ${HOME}.
  2. Merge Policy should be 'Auto Merge Text Files and Update Binary Files'.
  3. Default Module should be 'Tools/AlphaTcl.maccvs'.
  4. Default Revision is either CURRENT or HEAD.
  5. Use gzip compression 3.

The second pane in the dialog should look something like this:


  1. Server hostname is ''.
  2. CVS Root is '/cvsroot/alphatcl'.
  3. Authentication Method is 'Password'.
  4. CVS User Name is 'anonymous'.
  5. CVS Password is empty.

To checkout, close this dialog and select Action > Check Out Default Module.

das 11jun01 jeg 06oct01 cbu 24may03


Retrieved from
Page last modified on October 18, 2006, at 09:39 PM