CVS access to LessTif

# LessTif CVS repository

CVS, the Concurrent Versions System, is a widely used, free source code-control system. The LessTif CVS tree always reflects the latest developments.

## Who should use it?

Most people should use stable LessTif releases. People with specific problems that have just been fixed should use the most recent version of the source, straight from the CVS repository. If you want to use CVS, keep reading this text. If not, you might want to go to the download page. We need people to test the current sources, so if you are up to it, go ahead!

## Retrieving sources from CVS

As of August 2000 (just after the 0.91.6 release), the LessTif sources have moved to SourceForge.
Instructions from SourceForge on accessing CVS (anonymous access) are available.

To access CVS, first set the environment variable `CVSROOT` to `:pserver:anonymous@cvs.lesstif.sourceforge.net:/cvsroot/lesstif`. How you do this depends on your shell. If you use the bourne shell, you can type

    export CVSROOT=:pserver:anonymous@cvs.lesstif.sourceforge.net:/cvsroot/lesstif

If you use csh, you will have to use the `setenv` command. After that, you have to login to CVS. You do this by typing `cvs login`. When prompted, just hit Enter (an empty password). After that, you can type `cvs -z5 checkout lesstif` to retrieve the sources for the first time.

You can also browse the CVS repository using your favourite web browser. This is obviously not useful for downloading the complete source tree, it is just a convenient way to use CVS's versioning mechanism to figure out exactly what is in which version, or what changed recently. The browsable CVS is at http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/lesstif/?cvsroot=lesstif.

## Building from CVS sources

To build LessTif from a CVS checkout you will also need libtool, automake and autoconf (see our installation instructions). Once you have the lesstif module checked out, and the GNU tools set up, you will need to go to the top directory in the LessTif tree and type:

    ./CVSMake

in order to create the configure script. Once this is done you are ready to carry on to configuring LessTif, as described in the INSTALL file of the distribution.

## Misc CVS issues

Here we collect some helpful suggestions for using the CVS repository. You don't need to read it if you're a "CVS professional" and are familiar with all its numerous commandline options ...

- Once you have a checked out CVS distribution, `cvs update` will get you up to date. However, when a directory is added, like the recent addition of lib/Xlt, `cvs update` alone is not sufficient. You should periodically run `cvs update -d` from the top of the tree to get any new directories and their contents.

- Sometimes you might checkout not the current version, but an older one, e.g. from a given date (`-D` option). However some people forget that CVS remembers these settings ("sticky") and won't update to the current level unless indicated to so. Specifying the current date will only help once, better remove the sticky bits by the `-A` option.

- The LessTif CVS repository carries some old, empty directories. You can get rid of them by using `cvs update -P`