RCS

From LQWiki
Jump to navigation Jump to search

RCS stands for Revision Control System. It's not as sophisticated as some of the newer revision systems such as CVS or GNU Arch but for a single-developer project or maintaining a single-user Linux machine, it's more than adequate.

Base Commands

  • rcs
  • co
  • ci

Quick Start

Putting a new file under version control.

Create directory 'RCS'.

$ mkdir RCS

This is not required but keeps the working directory from being cluttered with the version control files.

Initialize the file:

$ rcs -i new-file
RCS new-file: RCS/new-file,v
enter description, terminated with single '.' or end of 
file:
NOTE: This is NOT the log message!
>>

Enter file description at '>>' prompt, press RETURN, period, RETURN

This places a file named 'new-file,v' in the RCS directory.

Edit the file

$ co -l new-file

This creates 'new-file' with read-write permissions. Edit as usual.

Place the newly edited file under version control.

$ ci -l new-file
RCS/new-file,v  <--  new-file
new revision: 1.2; previous revision: 1.1
enter log message, terminated with single '.' or end of 
file:
>>

Enter log message at '>>' prompt, press RETURN, period, RETURN

The file is now under revision control and a copy of the file with read-write permissions is left in the working directory for further editing.

Detailed Command Descriptions

Man Pages:

File Locking

By default, files must be locked in order to be returned to version control. This is the '-l' option for the co command. When checking a file back under version control, normally the working file is deleted. By using the '-l' command line switch with the ci command, the file is versioned and then automatically checked out and locked once again. It's a bit confusing at first, but as long as you use the '-l' switch with both commands, a working copy of the versioned file will always be present.

File locking can be disabled with the command:

$ rcs -u file-name

See the rcs man page.

Retrieving Previous Revisions

Revision control