CMMS structure
For detailed information read /usr/doc/how_cmms_works.txt in the CMMS tree.
CVS-Instructions
Useful information
CVSROOT:
USERNAME@cvs.sourceforge.net:/cvsroot/cmms
Main directory: /cmms-current (not /cmms!)
Authentication method: SSH
To keep track of the changes of the CVS version check /usr/doc/CVS-CHANGES.txt.
Useful links
The CVS Book Online -
Introduction to CVS
CVS Manual - official
documentation
Daily CVS
snapshot - If you did not update for a while
Browse CVS
tree - Web CVS viewer
Freshmeat - Here you find graphical
clients like gCVS, linCVS, Cervisia
Checkout: Get current files for the first time
1. Install the CVS and SSH packages of your Linux distribution
2. Go to your work/projects directory (some directory in your filesystem)
3. Make sure there is no folder called "cmms-current" in this directory
4. Type export CVS_RSH=ssh and add that line to your .bashrc
5. Now you will "check out" your copy of CMMS (one line!!!):
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/cmms co
cmms-current
Users with sourceforge account which are members of the cmms project can
use:
cvs -z3 -d:ext:USERNAME@cvs.sourceforge.net:/cvsroot/cmms co
cmms-current
You will find the CVS directory you can work with in "cmms-current".
If you ever want to start anew with a clean directory, just repeat step 5 or get
a daily CVS snapshot (see "useful links" above)
Update: Merge current CVS files into your copies
From within your cmms-current directory:
cvs update
CVS will try to merge your local files with the changes that have been commited
by others. If there are conflicts, you have to resolve those conflicts first,
before you can compile or commit your files. To resolve conflicts, you edit the
files which are told to you, search for conflict markers (===) and decide which
change to keep. It is a good idea to contact the other developer first. Use
cvs log FILENAME to get information on past changes of the file.
The following actions are only possible for users with sourceforge account
which are members of the cmms project
Commit: Upload files you have changed
From within your cmms-current directory:
cvs commit -m "comments for this commit" FILENAME
FILENAME can be empty: You then commit everything below the current directory.
It may well be that others have changed files you changed in the meantime. Then
you will have to get the updated files first (see next section)
Renaming files
mv cmms_display.c cmms_feedback.c
cvs delete cmms_display.c
cvs add cmms_feedback.c
cvs commit -m "renamed cmms_display to cmms_feedback" cmms_feedback.c
Adding entire directories
Either use add with a list of files, or go into the new directory
and use the import command:
cd cmms-current/PATH/NAME-OF-DIRECTORY
cvs import -m "new files" cmms-current/PATH/NAME-OF-DIRECTORY USERNAME
start
PATH is the path to the new directory and NAME-OF-DIRECTORY is the name of
the new directory. You may have to set the CVSROOT also (with the -d option). Be
careful with this command, and use it only when necessary!
Other useful commands
Add new file: cvs add FILENAME
Remove file: cvs remove FILENAME
Get current status of file: cvs status FILENAME
