NAME
rcsmerge — merge RCS revisions
SYNOPSIS
rcsmerge
-rrev1
[-r
rev2]
[-p]
file
DESCRIPTION
rcsmerge
incorporates the changes between
rev1
and
rev2
of an RCS file into the corresponding working file.
If
-p
is given, the result is printed on the standard output;
otherwise the result overwrites the working file.
A file name ending in
,v
is an RCS file name; otherwise it is a working file name.
rcsmerge
derives the working file name from the
RCS file name and vice versa, as explained in
rcsintro(5).
A pair consisting
of both an RCS and a working file name can also be specified.
rev1
cannot be omitted.
If
rev2
is omitted, the latest revision on the trunk is assumed.
Both
rev1
and
rev2
can be given numerically or symbolically.
rcsmerge
prints a warning if there are overlaps,
and delimits the overlapping regions as explained for the
-j
option of
co(1).
The command is useful for incorporating changes into a checked-out revision.
EXAMPLES
Suppose you have released revision 2.8 of
f.c.
Assume furthermore that you just completed revision 3.4
when you receive updates to release 2.8 from someone else.
To combine the updates to 2.8 and your changes between 2.8 and 3.4,
put the updates to 2.8 into file
f.c
and execute:
rcsmerge -p -r2.8 -r3.4 f.c >f.merged.c
Then examine
f.merged.c.
Alternatively, if you want to save the updates to 2.8 in the
RCS file, check them in as revision 2.8.1.1 and execute
co -j:
ci -r2.8.1.1 f.c
co -r3.4 -j2.8:2.8.1.1 f.c
As another example, the following command
undoes the changes between revision 2.4 and 2.8
in your currently checked out revision in
f.c:
Note the order of the arguments, and that
f.c
is overwritten.
WARNINGS
rcsmerge
does not work for files that contain lines with a single period
(.).
AUTHOR
rcsmerge
was developed by Walter F. Tichy.