Many CVS commands need certain command line switches to operate consistently. Rather than typing them every time that command is used, you can save the switches in a file that CVS will read before executing your command line.

Create a file named ~/.cvsrc in your home directory. It should contain the following commands, one per line:

cvs -z3
diff -uNp
rdiff -uNp
update -dP

If your goal is to download the various Fedora Core documents and to render them on your system, you only need read-only access to the CVS repository. Follow the instructions in this section and then skip directly to Section 10.4.1, “Checking Out Modules”.

Change directories to where you want your files from CVS to be located, and execute the following commands:

$ export CVSROOT=:pserver:cvs.fedora.redhat.com:/cvs/docs
$ cvs login
$ cvs checkout docs-common module-name
$ cvs checkout module-name
$ cd module-name

Once you have checked the module out, it doesn't matter what your CVSROOT is set to because it is stored in the file CVS/Root for each directory in your local repository. As long as your current working directory has a CVS/ directory, the CVS program will automatically locate the Fedora Core repository.

To author a new document or to change an existing one, you must obtain full read/write access to the Fedora Core Docs CVS repository. For the full details on this process, refer to the http://fedoraproject.org/wiki/DocsProject/NewWriters web site. Below is a summary:

After your self introduction has been approved your CVS access will be granted.

Every author, and that includes you once your self introduction has been received, has a unique $CVSROOT to access the CVS repository:

$ export CVSROOT=:ext:yourname@cvs.fedora.redhat.com:/cvs/docs
$ export CVS_RSH=/usr/bin/ssh

With the $CVSROOT and $CVS_RSH environment variables in place, you can access the repository:

$ cvs co -c

You will be asked for the passphrase for your SSH key. Press ENTER and you should receive a list of modules already in the repository.