home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / dev / RevisionControl / HWGRCS / hwgrcs / man / rcsmerge.man < prev    next >
Text File  |  1993-01-19  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. RCSMERGE(1)              USER COMMANDS                RCSMERGE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      rcsmerge - merge RCS revisions
  10.  
  11. SYNOPSIS
  12.      rcsmerge [_o_p_t_i_o_n_s] _f_i_l_e
  13.  
  14. DESCRIPTION
  15.      rcsmerge incorporates the changes between two  revisions  of
  16.      an RCS file into the corresponding working file.
  17.  
  18.      Pathnames matching an RCS suffix denote RCS files; all  oth-
  19.      ers  denote working files.  Names are paired as explained in
  20.      ci(1).
  21.  
  22.      At least one revision must be  specified  with  one  of  the
  23.      options  described below, usually -r.  At most two revisions
  24.      may be specified.  If only one revision  is  specified,  the
  25.      latest  revision on the default branch (normally the highest
  26.      branch on the trunk) is assumed  for  the  second  revision.
  27.      Revisions may be specified numerically or symbolically.
  28.  
  29.      rcsmerge prints a warning if there are overlaps, and  delim-
  30.      its  the  overlapping regions as explained in merge(1).  The
  31.      command is useful for incorporating changes into a  checked-
  32.      out revision.
  33.  
  34. OPTIONS
  35.      -k_s_u_b_s_t
  36.           Use _s_u_b_s_t style keyword substitution.   See  co(1)  for
  37.           details.   For example, -kk -r1.1 -r1.2 ignores differ-
  38.           ences in keyword values when merging the  changes  from
  39.           1.1 to 1.2.
  40.  
  41.      -p[_r_e_v]
  42.           Send the result to standard output instead of overwrit-
  43.           ing the working file.
  44.  
  45.      -q[_r_e_v]
  46.           Run quietly; do not print diagnostics.
  47.  
  48.      -r[_r_e_v]
  49.           Merge with respect to revision _r_e_v.  Here an empty  _r_e_v
  50.           stands  for  the latest revision on the default branch,
  51.           normally the head.
  52.  
  53.      -V_n  Emulate RCS version _n.  See co(1) for details.
  54.  
  55.      -x_s_u_f_f_i_x_e_s
  56.           Use _s_u_f_f_i_x_e_s to characterize RCS files.  See ci(1)  for
  57.           details.
  58.  
  59.  
  60.  
  61.  
  62.  
  63. GNU                  Last change: 1991/08/19                    1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCSMERGE(1)              USER COMMANDS                RCSMERGE(1)
  71.  
  72.  
  73.  
  74. EXAMPLES
  75.      Suppose you have  released  revision  2.8  of  f.c.   Assume
  76.      furthermore  that  after you complete an unreleased revision
  77.      3.4, you receive updates to release 2.8 from  someone  else.
  78.      To  combine  the updates to 2.8 and your changes between 2.8
  79.      and 3.4, put the updates to 2.8 into file f.c and execute
  80.  
  81.          rcsmerge  -p  -r2.8  -r3.4  f.c  >f.merged.c
  82.  
  83.      Then examine f.merged.c.  Alternatively, if you want to save
  84.      the  updates  to 2.8 in the RCS file, check them in as revi-
  85.      sion 2.8.1.1 and execute co -j:
  86.  
  87.          ci  -r2.8.1.1  f.c
  88.          co  -r3.4  -j2.8:2.8.1.1  f.c
  89.  
  90.      As another example, the following command undoes the changes
  91.      between  revision  2.4 and 2.8 in your currently checked out
  92.      revision in f.c.
  93.  
  94.          rcsmerge  -r2.8  -r2.4  f.c
  95.  
  96.      Note the order of  the  arguments,  and  that  f.c  will  be
  97.      overwritten.
  98.  
  99. ENVIRONMENT
  100.      RCSINIT
  101.           options prepended to the argument  list,  separated  by
  102.           spaces.  See ci(1) for details.
  103.  
  104. DIAGNOSTICS
  105.      Exit status is 0 for no overlaps, 1 for some overlaps, 2 for
  106.      trouble.
  107.  
  108. IDENTIFICATION
  109.      Author: Walter F. Tichy.
  110.      Revision Number: 5.3; Release Date: 1991/08/19.
  111.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  112.      Copyright c 1990, 1991 by Paul Eggert.
  113.  
  114. SEE ALSO
  115.      ci(1), co(1), ident(1), merge(1), rcs(1), rcsdiff(1), rcsin-
  116.      tro(1), rlog(1), rcsfile(5)
  117.      Walter  F.  Tichy,  RCS--A  System  for   Version   Control,
  118.      _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e & _E_x_p_e_r_i_e_n_c_e 15, 7 (July 1985), 637-654.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. GNU                  Last change: 1991/08/19                    2
  130.  
  131.  
  132.  
  133.