home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / RCS43X.ZIP / RCSMERGE.MAN < prev    next >
Text File  |  1990-11-19  |  3KB  |  71 lines
  1. NAME
  2.      rcsmerge - merge RCS revisions
  3.  
  4. SYNOPSIS
  5.      rcsmerge -rrev1 [ -rrev2 ] [ -p ] file
  6.  
  7. DESCRIPTION
  8.      Rcsmerge incorporates the changes between rev1 and rev2 of
  9.      an RCS file into the corresponding working file. If -p is
  10.      given, the result is printed on the standard output, other-
  11.      wise the result overwrites the working file.
  12.  
  13.      A file name ending in ',v' is an RCS file name, otherwise a
  14.      working file name. Merge derives the working file name from
  15.      the RCS file name and vice versa, as explained in co(L).  A
  16.      pair consisting of both an RCS and a working file name may
  17.      also be specified.
  18.  
  19.      Rev1 may not be omitted. If rev2 is omitted, the latest
  20.      revision on the default branch (normally the highest branch
  21.      on the trunk) is assumed.  Both rev1 and rev2 may be given
  22.      numerically or symbolically.
  23.  
  24.      Rcsmerge prints a warning if there are overlaps, and delim-
  25.      its the overlapping regions as explained in co -j.  The com-
  26.      mand is useful for incorporating changes into a checked-out
  27.      revision.
  28.  
  29. EXAMPLES
  30.      Suppose you have released revision 2.8 of f.c. Assume furth-
  31.      ermore that you just completed revision 3.4, when you
  32.      receive updates to release 2.8 from someone else.  To com-
  33.      bine the updates to 2.8 and your changes between 2.8 and
  34.      3.4, put the updates to 2.8 into file f.c and execute
  35.  
  36.              rcsmerge  -p  -r2.8  -r3.4  f.c  >f.merged.c
  37.  
  38.      Then examine f.merged.c.  Alternatively, if you want to save
  39.      the updates to 2.8 in the RCS file, check them in as revi-
  40.      sion 2.8.1.1 and execute co -j:
  41.  
  42.              ci  -r2.8.1.1  f.c
  43.              co  -r3.4  -j2.8:2.8.1.1  f.c
  44.  
  45.      As another example, the following command undoes the changes
  46.      between revision 2.4 and 2.8 in your currently checked out
  47.      revision in f.c.
  48.  
  49.              rcsmerge  -r2.8  -r2.4  f.c
  50.  
  51.      Note the order of the arguments, and that f.c will be
  52.      overwritten.
  53.  
  54. IDENTIFICATION
  55.      Author: Walter F. Tichy, Purdue University, West Lafayette,
  56.      IN, 47907.
  57.      Revision Number: 1.3 ; Release Date: 89/10/30 .
  58.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  59.  
  60. SEE ALSO
  61.      ci(L), co(L), merge(L), ident(L), rcs(L), rcsdiff(L),
  62.      rlog(L), rcsfile(L),
  63.      Walter F. Tichy, "Design, Implementation, and Evaluation of
  64.      a Revision Control System," in Proceedings of the 6th Inter-
  65.      national Conference on Software Engineering, IEEE, Tokyo,
  66.      Sept. 1982.
  67.  
  68. BUGS
  69.      Rcsmerge does not work on files that contain lines with a
  70.      single `.'.
  71.