Instructions on How to Use the RTAI CVS Tree
============================================


Accessing the repository
------------------------

Log in (password is "anoncvs"):

  cvs -d :pserver:anonymous@cvs.rtai.org:/opt/cvsroot/rtai login

Check out the RTAI CVS tree:

  cvs -d :pserver:anonymous@cvs.rtai.org:/opt/cvsroot/rtai co rtai4

The CVS repository is called "rtai4", because it is the 4th CVS
repository that we've used.  The number has no correllation with
the release version number.


Updating the local tree
-----------------------

Periodically, in order to keep up-to-date, you may want to download
changes instead of an entire tree.  In the rtai4 directory, run:

  cvs update -dP

(The -d and -P options are convenient, but not necessary.  See the
CVS man page for details.)


Creating patches
----------------

This command will create a patch with all the local modifications
that you have made:

  cvs diff -u <file>


Diffing against older releases
------------------------------

You can see the history of a file by issuing

  cvs log <file> [<file> ...]

As you see, there are "tags" attached to version numbers. For example
a tag of "r24_1_9" represents release 24.1.9 of RTAI.  To diff a file
against a tag use:

  cvs diff -r <tag> <file> [<file> ...]

You can also bring your tree to a specific release, for example

  cvs update -dP -r <tag>

For details refer to CVS documentation.

Please note that while r24_1_9 and r24_1_10 match official tarball
distributions, older tags aren't exactly in sync with the distribution.
In the future we'll be careful to tag properly.

