RCS – A System for Version Control

The Revision Control System

Edition 1.1 RCS Version 5.7

by Walter F. Tichy, Paul Eggert

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Foundation.

– About the manual –
• About		About the manul.
• AboutDesc		Informations about that manual.
• Versions		Versions of the troff/nroff manuals.
• BugReport		Bugs? suggestions?
– RCS - A System for Version Control –
• VersionControl		RCS – A System for Version Control.
• Introduction		Introduction to RCS.
• StartRCS		Getting started with RCS.
• Identification		Automatic Identification.
• RevisionTree		The RCS Revision Tree.
• Branches		When are branches needed?.
• Deltas		Revisions are represented as deltas.
• Controversial		Locking: A Controversial Issue.
• Configuration		Configuration Management.
• Functions		RCS Selection Functions.
• MAKERCS		Combining MAKE and RCS.
• Statistics		Usage Statistics.
• Survey		Survey of Version Control Tools.
– rcsintro - introduction to RCS commands –
• rcsIntroduction		Introduction to RCS commands.
• rcsintroDesc		Introduction to `RCS`.
• rcsintroFunc		Functions of `RCS`.
• rcsintroStart		Getting started with `RCS`.
• rcsintroAutoIdent		Automatic identification.
– Synopsis of RCS Operations –
• Synopsis		Synopsis of RCS Operations.
– ci - check in RCS revsisions –
• CheckIn		ci – check in RCS revsisions.
• ciIntro		Introduction to `ci`.
• ciEnv		Environment which can change the behaviour of `ci` and other RCS commands.
• ciFileModes		File modes.
• ciFiles		Files.
• setuid use		Using of uid.
• ciExamples		Examples.
• ciDiag		Diagnostic output of `ci`.
• ciOptions		command line options of `ci`.
– co - check out RCS revsisions –
• CheckOut		co – check out RCS revsisions
• coIntro		Introduction to `co`.
• coOptions		command line options of `co`.
• coKeyword		Keyword expansion and valid keywords.
• coEnv		Environment which can change the behaviour of `co` and other RCS commands.
• coFileModes		File modes.
• coFiles		Files.
• coDiag		Diagnostic output of `co`.
• coLimits		Limits.
– rcs - change RCS file attributes –
• rcs		rcs – change RCS file attributes.
• rcsIntro		Introduction to `rcs`.
• rcsOptions		command line options of `rcs`.
• rcsCompatibility		Compatibility between RCS Versions.
• rcsFiles		Files.
• rcsEnv		The Environment which can change the behaviour of much of the RCS commands.
• rcsDiag		Diagnostic output of `rcs`.
• rcsBugs		Bugs.
– ident - identify RCS keyword strings in files –
• ident		ident – identify RCS keyword strings in files.
• identIntro		Introduction to `rcs`.
• identOptions		command line options of `rcs`.
• identKeywords		Keywords.
– rcsclean - clean up working files –
• rcsclean		rcsclean – clean up working files.
• rcscleanIntro		Introduction to `rcsclean`.
• rcscleanOptions		command line options of `rcsclean`.
• rcscleanExamples		Examples in using `rcsclean`.
• rcscleanFiles		Files.
• rcscleanEnv		The Environment which can change the behaviour of much of the RCS commands.
• rcscleanDiag		Diagnostic output of `rcsclean`.
• rcscleanBugs		Bugs.
– rcsdiff – compare RCS revisions –
• rcsdiff		rcsdiff – compare RCS revisions.
• rcsdiffIntro		Introduction to `rcsdiff`.
• rcsdiffOptions		command line options of `rcsdiff`.
• rcsdiffExamples		Examples in using `rcsdiff`.
• rcsdiffEnv		The Environment which can change the behaviour of much of the RCS commands.
• rcsdiffDiag		Diagnostic output of `rcsdiff`.
– rcsmerge – merge RCS versions –
• rcsmerge		rcsmerge – merge RCS versions.
• rcsmergeIntro		Introduction to `rcs`.
• rcsmergeOptions		command line options of `rcs`.
• rcsmergeExamples		Examples of `rcsmerge`.
• rcsmergeEnv		The Environment which can change the behaviour of much of the RCS commands.
• rcsmergeDiag		Diagnostic output of `rcs`.
– rlog – print log messages and other information about RCS files –
• rlog		rlog – print log messages and other information about RCS files.
• rlogIntro		Introduction to `rlog`.
• rlogOptions		command line options of `rlog`.
• rlogExamples		Examples.
• rlogEnv		The Environment which can change the behaviour of much of the RCS commands.
• rlogDiag		Diagnostic output of `rlog`.
• rlogBugs		Bugs.
– merge – three-way file merge –
• merge		merge – three-way file merge.
• mergeIntro		Introduction to `merge`.
• mergeOptions		command line options of `merge`.
• mergeDiag		Diagnostic output of `merge`.
• mergeBugs		Bugs.
———— Appendencies ———— – Appendix A –
• AppendixA		Format of RCS file.
– Appendix B –
Appendix A Books and related manuals
A.1 Feldman,Stuart I.		GNU - Make.
A.2 Hunt, James W. and McIlroy, M. D.		GNU - diff.
A.3 Rochkind, Marc J.		SCCS.
A.4 Tichy, Walter F.		Design and implementation of RCS.
A.5 Leblang, David B. and Chase, Robert P.		Computer-Aided Software Engineering.
A.6 Glasser, Alan L.		The Evolution of a Source Code Control System.
A.7 Brown, H.B.		The Clear/Caster System.
A.8 Habermann, A. Nico		A Software Development Control System.
A.9 Code Management System
A.10 Lampson, Butler W. and Schmidt, Eric E.		Practical Use of a Polymorphic Applicative Language.
A.11 Tichy, Walter F.		A Data Model for Programming Support Environments and its Application.
A.12 Heckel, Paul		A Technique for Isolating Differences Between Files.
A.13 Tichy, Walter F.		The String-to-String Correction Problem with Block Moves.
Index		Concept Index.

Appendix A Books and related manuals

A.1 Feldman,Stuart I.

Feldman, Stuart I.,


"Make -- A Program for Maintaining Computer Programs",
Software -- Practice & Experience,
vol. 9, no. 3, pp. 255-265, March 1979.

A.2 Hunt, James W. and McIlroy, M. D.

Hunt, James W. and McIlroy, M. D.,


"An Algorithm for Differential File Comparison",
41, Computing Science Technical Report,
Bell Laboratories, June 1976.

A.3 Rochkind, Marc J.

Rochkind, Marc J.


"The Source Code Control System",
IEEE Transactions on Software Engineering, vol. SE-1,
no. 4, pp. 364-370, Dec. 1975.

A.4 Tichy, Walter F.

Tichy, Walter F.


"Design, Implementation, and Evaluation of a Revision Control System"
Proceedings of the 6th International Conference on Software Engineering,
pp. 58-67, ACM, IEEE, IPS, NBS, September 1982.

A.5 Leblang, David B. and Chase, Robert P.

Leblang, David B. and Chase, Robert P.


"Computer-Aided Software Engineering in a Distributed
Workstation Environment",
SIGPLAN Notices, vol. 19, no. 5, pp. 104-112, May 1984.
Proceedings of the ACM SIGSOFT/SIGPLAN Software Engineering Symposium
on Practical Software Development Environments.

A.6 Glasser, Alan L.

Glasser, Alan L.


"The Evolution of a Source Code Control System"
Software Engineering Notes, vol. 3, no. 5, pp. 122-125, Nov. 1978.
Proceedings of the Software Quality and Assurance Workshop.

A.7 Brown, H.B.

Brown, H.B.


"The Clear/Caster System",
Nato Conference on Software Engineering, Rome 1970

A.8 Habermann, A. Nico

Habermann, A. Nico


"A Software Development Control System",
Technical Report, Carnegie-Mellon University,
Department of Computer Science, Jan. 1979.

A.9 Code Management System

Digital Equipment Corporation


"Code Management System",
Document No. EA-23134-82, 1982

A.10 Lampson, Butler W. and Schmidt, Eric E.

Lampson, Butler W. and Schmidt, Eric E.


"Practical Use of a Polymorphic Applicative Language",
Proceedings of the 10th Symposium on Principles of
Programming Languages,
pp. 237-255, ACM, January 1983.

A.11 Tichy, Walter F.

Tichy, Walter F.


"A Data Model for Programming Support Environments and its Application",
Automated Tools for Information System Design and Development, ed.
Hans-Jochen Schneider and Anthony I. Wasserman,
North-Holland Publishing Company, Amsterdam 1982.

A.12 Heckel, Paul

Heckel, Paul


"A Technique for Isolating Differences Between Files",
Communications of the ACM, vol. 21, no. 4, pp. 264-268, April
1978.

A.13 Tichy, Walter F.

Tichy, Walter F.


"The String-to-String Correction Problem with Block Moves",
ACM Transactions on Computer Systems, vol. 2, no. 4, pp. 309-321,
Nov. 1984.

Index

Jump to:	A B C D E F G H M P R S T W

	Index Entry	Section

A
	ACM	A.10 Lampson, Butler W. and Schmidt, Eric E.
	ACM	A.12 Heckel, Paul

B
	Block moves	A.13 Tichy, Walter F.

C
	Clear/Caster	A.7 Brown, H.B.
	Clear/Caster	A.8 Habermann, A. Nico
	Code Management System	A.9 Code Management System

D
	Data Model	A.11 Tichy, Walter F.
	DEC	A.9 Code Management System
	Diff	A.2 Hunt, James W. and McIlroy, M. D.
	Diff	A.12 Heckel, Paul
	Differences between files	A.12 Heckel, Paul

E
	Environments	A.11 Tichy, Walter F.

F
	Feldman Stuart I.	A.1 Feldman,Stuart I.

G
	GNU-Diff	A.2 Hunt, James W. and McIlroy, M. D.
	GNU-Make	A.1 Feldman,Stuart I.

H
	Hunt, James W. and McIlroy, M. D.	A.2 Hunt, James W. and McIlroy, M. D.

M
	Make	A.1 Feldman,Stuart I.

P
	Polymorhpic Applicative Language	A.10 Lampson, Butler W. and Schmidt, Eric E.

R
	RCS	A.4 Tichy, Walter F.

S
	SCCS	A.3 Rochkind, Marc J.
	SCCS	A.6 Glasser, Alan L.
	SIGPLAN	A.5 Leblang, David B. and Chase, Robert P.
	Software Quality	A.6 Glasser, Alan L.
	String-To-String Correction	A.13 Tichy, Walter F.
	Support	A.11 Tichy, Walter F.
	Symposium	A.5 Leblang, David B. and Chase, Robert P.

T
	Tools	A.11 Tichy, Walter F.

W
	Workstation	A.5 Leblang, David B. and Chase, Robert P.

Jump to:	A B C D E F G H M P R S T W

Appendix A Books and related manuals
Index

About This Document

This document was generated on February 15, 2023 using texi2html 5.0.

The buttons in the navigation panels have the following meaning:

Button	Name	Go to	From 1.2.3 go to
[ << ]	FastBack	Beginning of this chapter or previous chapter	1
[ < ]	Back	Previous section in reading order	1.2.2
[ Up ]	Up	Up section	1.2
[ > ]	Forward	Next section in reading order	1.2.4
[ >> ]	FastForward	Next chapter	2
[Top]	Top	Cover (top) of document
[Contents]	Contents	Table of contents
[Index]	Index	Index
[ ? ]	About	About (help)

where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:

1. Section One
- 1.1 Subsection One-One
  - ...
- 1.2 Subsection One-Two
  - 1.2.1 Subsubsection One-Two-One
  - 1.2.2 Subsubsection One-Two-Two
  - 1.2.3 Subsubsection One-Two-Three <== Current Position
  - 1.2.4 Subsubsection One-Two-Four
- 1.3 Subsection One-Three
  - ...
- 1.4 Subsection One-Four