RCS-Guideline for IDE-project
	Ulf Schuenemann, Jan 26 1998

Sources: manpages rcs(1), rlog(1), co(1), ci(1)

1. General

RCS controls single files.
The database for each controlled file 'name' is 'RCS/name,v'.
Write permission of the database file is reset by the RCS tools.

     database                 working file
     name,v  ----check-out---> name
             <---check-in----

The file written-to by checking out or read-from by checking in
is called the working file.
Each controlled file can be *locked* at most by one user.
Only the locking user can check in a new revision of a file.
Note: only a locked working file has write permission.

2. Setup your directory ide for shared work with RCS

	(mkdir ide)
	cd ide
	ln -s ~zhikai/RCS .

To retrieve this RCS guideline for reading:
	co rcsguide.asc

3. Create and initialize a new RCS database

NB don't forget to chmod the database file.

If first revision 'file' does exist (see point 6 below):
	ci file
	<Enter some file description>
	rcs -L -adspencer,marian,ulf,zhikai,jimmy file
	chmod g+r RCS/file,v

If 'file' does not yet exist:
	rcs -L -i -adspencer,marian,ulf,zhikai,jimmy file
	<Enter some file description>
	chmod g+r RCS/file,v

4. Information on controlled file

rlog file	- all information
rlog -l file	- information on locked revisions
rlog -h file	- information on head and default branch

5. Working with latest revision of controlled file

Reading:
co file		- read: check out unlocked for reading

Editing:
co -l file	- lock: check out + lock for editing
ci -l file	- commit: check in during editing + remains locked
ci file		- done: check in after editing + remove working file
ci -u file	- done(b): check in after editing + unlock

Etc:
rcs -l file	- lock (without check out)
rcs -u file	- unlock (without check in + working file remains)
co -u file	- check out locked file again + unlock

-------------------------------------------------------------------
LATER ON WE MIGHT MAKE USE OF:

6. Working with old revisions

7. Working with multiple revision branches

Information on default branch:
rlog -t file	- description + information on head and default branch
rlog -b file	- information on default branch