home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / rcs / rcsmerge.man < prev    next >
Text File  |  1992-02-19  |  3KB  |  97 lines
  1. NAME
  2.      rcsmerge - merge RCS revisions
  3.  
  4. SYNOPSIS
  5.      rcsmerge [options] file
  6.  
  7. DESCRIPTION
  8.      rcsmerge incorporates the changes between two revisions of
  9.      an RCS file into the corresponding working file.
  10.  
  11.      Pathnames matching an RCS suffix denote RCS files; all
  12.      others denote working files.  Names are paired as explained
  13.      in ci(1).
  14.  
  15.      At least one revision must be specified with one of the
  16.      options described below, usually -r.  At most two revisions
  17.      may be specified.  If only one revision is specified, the
  18.      latest revision on the default branch (normally the highest
  19.      branch on the trunk) is assumed for the second revision.
  20.      Revisions may be specified numerically or symbolically.
  21.  
  22.      rcsmerge prints a warning if there are overlaps, and
  23.      delimits the overlapping regions as explained in merge(1).
  24.      The command is useful for incorporating changes into a
  25.      checked-out revision.
  26.  
  27. OPTIONS
  28.      -ksubst
  29.           Use subst style keyword substitution.  See co(1) for
  30.           details.  For example, -kk -r1.1 -r1.2 ignores
  31.           differences in keyword values when merging the changes
  32.           from 1.1 to 1.2.
  33.  
  34.      -p[rev]
  35.           Send the result to standard output instead of
  36.           overwriting the working file.
  37.  
  38.      -q[rev]
  39.           Run quietly; do not print diagnostics.
  40.  
  41.      -r[rev]
  42.           Merge with respect to revision rev.  Here an empty rev
  43.           stands for the latest revision on the default branch,
  44.           normally the head.
  45.  
  46.      -Vn  Emulate RCS version n.  See co(1) for details.
  47.  
  48.      -xsuffixes
  49.           Use suffixes to characterize RCS files.  See ci(1) for
  50.           details.
  51.  
  52. EXAMPLES
  53.      Suppose you have released revision 2.8 of f.c.  Assume
  54.      furthermore that after you complete an unreleased revision
  55.      3.4, you receive updates to release 2.8 from someone else.
  56.      To combine the updates to 2.8 and your changes between 2.8
  57.      and 3.4, put the updates to 2.8 into file f.c and execute
  58.  
  59.          rcsmerge  -p  -r2.8  -r3.4  f.c  >f.merged.c
  60.  
  61.      Then examine f.merged.c.  Alternatively, if you want to save
  62.      the updates to 2.8 in the RCS file, check them in as
  63.      revision 2.8.1.1 and execute co -j:
  64.  
  65.          ci  -r2.8.1.1  f.c
  66.          co  -r3.4  -j2.8:2.8.1.1  f.c
  67.  
  68.      As another example, the following command undoes the changes
  69.      between revision 2.4 and 2.8 in your currently checked out
  70.      revision in f.c.
  71.  
  72.          rcsmerge  -r2.8  -r2.4  f.c
  73.  
  74.      Note the order of the arguments, and that f.c will be
  75.      overwritten.
  76.  
  77. ENVIRONMENT
  78.      RCSINIT
  79.           options prepended to the argument list, separated by
  80.           spaces.  See ci(1) for details.
  81.  
  82. DIAGNOSTICS
  83.      Exit status is 0 for no overlaps, 1 for some overlaps, 2 for
  84.      trouble.
  85.  
  86. IDENTIFICATION
  87.      Author: Walter F. Tichy.
  88.      Revision Number: 5.3; Release Date: 1991/08/19.
  89.      Copyright 1982, 1988, 1989 by Walter F. Tichy.
  90.      Copyright 1990, 1991 by Paul Eggert.
  91.  
  92. SEE ALSO
  93.      ci(1), co(1), ident(1), merge(1), rcs(1), rcsdiff(1),
  94.      rcsintro(1), rlog(1), rcsfile(5)
  95.      Walter F. Tichy, RCS--A System for Version Control,
  96.      Software--Practice & Experience 15, 7 (July 1985), 637-654.
  97.