Using Mezzanine With cAos CVS

The first step is to create a SSH key pair to connect to the cAos 
CVS server, as only SSH key authentication is allowed:

  $ ssh-keygen -t dsa -b 2048 -f ~/.ssh/caos-cvs-dsa-2048

Use a "good" (cryptographically) password at the prompts and it 
will produce the private and public key files:

  /home/username/.ssh/caos-cvs-dsa-2048
  /home/username/.ssh/caos-cvs-dsa-2048.pub

Add the keys to your SSH client configuration file (the first line 
creates one if it does not already exist):

  $ if [ ! -f ~/.ssh/config ]; then touch ~/.ssh/config ; chmod 600 ~/.ssh/config ; fi
  $ echo "Host cvs.caosity.org" >> ~/.ssh/config
  $ echo "IdentityFile ~/.ssh/caos-cvs-dsa-2048" >> ~/.ssh/config

And now you can ask for CVS access from KainX on #caos and email your 
preferred username (from 1 to 8 character in length) and public SSH key 
(the one with the ".pub" file extension) to him. Keep the private key 
secret and safe.

Now prepare an area to check out files from the cAos CVS repository. 
The partition the check out directory is on should have a good amount 
of room to allow for future expansion. If you don't have a place 
already, and your "/home/" partition has lots of room, type:

  $ mkdir ~/cvs-checkout
  $ cd ~/cvs-checkout

When you have received the green light for the CVS access, put this line 
in your "~/.bashrc" file (or the "rc' file specific to your shell):

  export CVS_RSH=ssh

assuming "ssh" is in your PATH. Otherwise you can use the full path to 
"ssh" instead. Execute that command at the command prompt, along with 
a temporary setting for CVSROOT (in case you use other CVS repositories):

  $ export CVS_RSH=ssh
  $ export CVSROOT=username@cvs.caosity.org:/cvs

where "username" is the preferred username you supplied to KainX.

You are now ready to check out files from the cAos CVS repository. Get 
ready to type in the password you used to encrypt the SSH key you will 
use for this repository, because it can ask for it more than once per 
CVS command:

  $ mzget caos

another possibility is to avoid setting the CVSROOT environment variable 
and doing this "mzget" command instead"

  $ mzget -D username@cvs.caosity.org:/cvs caos

Either way, a bunch of CVS checkout messages should be rolling up the 
console.

You should now have a "caos" directory, corresponding to the "caos" 
module name in the "mzget" command line, in the "~/cvs-checkout/" 
directory. When executing "mz*" commands immediately within this "caos" 
directory, you will be interacting with the "caos" module from the 
"cvs.caosity.org/cvs" repository as "username". This information is 
stored in the "CVS" subdirectories in the "caos" directory tree.