gnu/usr.bin/rcs/rcsmerge/rcsmerge.1

   1 .de Id
   2 .ds Rv \\$3
   3 .ds Dt \\$4
   4 ..
   5 .Id $FreeBSD: src/gnu/usr.bin/rcs/rcsmerge/rcsmerge.1,v 1.5 1999/08/27 23:36:58 peter Exp $
   6 .Id $DragonFly: src/gnu/usr.bin/rcs/rcsmerge/rcsmerge.1,v 1.2 2003/06/17 04:25:48 dillon Exp $
   7 .ds r \&\s-1RCS\s0
   8 .if n .ds - \%--
   9 .if t .ds - \(em
  10 .TH RCSMERGE 1 \*(Dt GNU
  11 .SH NAME
  12 rcsmerge \- merge RCS revisions
  13 .SH SYNOPSIS
  14 .B rcsmerge
  15 .RI [ options ] " file"
  16 .SH DESCRIPTION
  17 .B rcsmerge
  18 incorporates the changes between two revisions
  19 of an \*r file into the corresponding working file.
  20 .PP
  21 Pathnames matching an \*r suffix denote \*r files;
  22 all others denote working files.
  23 Names are paired as explained in
  24 .BR ci (1).
  25 .PP
  26 At least one revision must be specified with one of the options
  27 described below, usually
  28 .BR \-r .
  29 At most two revisions may be specified.
  30 If only one revision is specified, the latest
  31 revision on the default branch (normally the highest branch on the trunk)
  32 is assumed for the second revision.
  33 Revisions may be specified numerically or symbolically.
  34 .PP
  35 .B rcsmerge
  36 prints a warning if there are overlaps, and delimits
  37 the overlapping regions as explained in
  38 .BR merge (1).
  39 The command is useful for incorporating changes into a checked-out revision.
  40 .SH OPTIONS
  41 .TP
  42 .B \-A
  43 Output conflicts using the
  44 .B \-A
  45 style of
  46 .BR diff3 (1),
  47 if supported by
  48 .BR diff3 .
  49 This merges all changes leading from
  50 .I file2
  51 to
  52 .I file3
  53 into
  54 .IR file1 ,
  55 and generates the most verbose output.
  56 .TP
  57 \f3\-E\fP, \f3\-e\fP
  58 These options specify conflict styles that generate less information
  59 than
  60 .BR \-A .
  61 See
  62 .BR diff3 (1)
  63 for details.
  64 The default is
  65 .BR \-E .
  66 With
  67 .BR \-e ,
  68 .B rcsmerge
  69 does not warn about conflicts.
  70 .TP
  71 .BI \-k subst
  72 Use
  73 .I subst
  74 style keyword substitution.
  75 See
  76 .BR co (1)
  77 for details.
  78 For example,
  79 .B "\-kk\ \-r1.1\ \-r1.2"
  80 ignores differences in keyword values when merging the changes from
  81 .B 1.1
  82 to
  83 .BR 1.2 .
  84 It normally does not make sense to merge binary files as if they were text, so
  85 .B rcsmerge
  86 refuses to merge files if
  87 .B \-kb
  88 expansion is used.
  89 .TP
  90 .BR \-p [\f2rev\fP]
  91 Send the result to standard output instead of overwriting the working file.
  92 .TP
  93 .BR \-q [\f2rev\fP]
  94 Run quietly; do not print diagnostics.
  95 .TP
  96 .BR \-r [\f2rev\fP]
  97 Merge with respect to revision
  98 .IR rev .
  99 Here an empty
 100 .I rev
 101 stands for the latest revision on the default branch, normally the head.
 102 .TP
 103 .B \-T
 104 This option has no effect;
 105 it is present for compatibility with other \*r commands.
 106 .TP
 107 .BI \-V
 108 Print \*r's version number.
 109 .TP
 110 .BI \-V n
 111 Emulate \*r version
 112 .IR n .
 113 See
 114 .BR co (1)
 115 for details.
 116 .TP
 117 .BI \-x "suffixes"
 118 Use
 119 .I suffixes
 120 to characterize \*r files.
 121 See
 122 .BR ci (1)
 123 for details.
 124 .TP
 125 .BI \-z zone
 126 Use
 127 .I zone
 128 as the time zone for keyword substitution.
 129 See
 130 .BR co (1)
 131 for details.
 132 .SH EXAMPLES
 133 Suppose you have released revision 2.8 of
 134 .BR f.c .
 135 Assume
 136 furthermore that after you complete an unreleased revision 3.4, you receive
 137 updates to release 2.8 from someone else.
 138 To combine the updates to 2.8 and your changes between 2.8 and 3.4,
 139 put the updates to 2.8 into file f.c and execute
 140 .LP
 141 .B "    rcsmerge  \-p  \-r2.8  \-r3.4  f.c  >f.merged.c"
 142 .PP
 143 Then examine
 144 .BR f.merged.c .
 145 Alternatively, if you want to save the updates to 2.8 in the \*r file,
 146 check them in as revision 2.8.1.1 and execute
 147 .BR "co \-j":
 148 .LP
 149 .B "    ci  \-r2.8.1.1  f.c"
 150 .br
 151 .B "    co  \-r3.4  \-j2.8:2.8.1.1  f.c"
 152 .PP
 153 As another example, the following command undoes the changes
 154 between revision 2.4 and 2.8 in your currently checked out revision
 155 in
 156 .BR f.c .
 157 .LP
 158 .B "    rcsmerge  \-r2.8  \-r2.4  f.c"
 159 .PP
 160 Note the order of the arguments, and that
 161 .B f.c
 162 will be
 163 overwritten.
 164 .SH ENVIRONMENT
 165 .TP
 166 .B \s-1RCSINIT\s0
 167 options prepended to the argument list, separated by spaces.
 168 See
 169 .BR ci (1)
 170 for details.
 171 .SH DIAGNOSTICS
 172 Exit status is 0 for no overlaps, 1 for some overlaps, 2 for trouble.
 173 .SH IDENTIFICATION
 174 Author: Walter F. Tichy.
 175 .br
 176 Manual Page Revision: \*(Rv; Release Date: \*(Dt.
 177 .br
 178 Copyright \(co 1982, 1988, 1989 Walter F. Tichy.
 179 .br
 180 Copyright \(co 1990, 1991, 1992, 1993, 1994, 1995 Paul Eggert.
 181 .SH "SEE ALSO"
 182 ci(1), co(1), ident(1), merge(1), rcs(1), rcsdiff(1), rcsintro(1), rlog(1),
 183 rcsfile(5)
 184 .br
 185 Walter F. Tichy,
 186 \*r\*-A System for Version Control,
 187 .I "Software\*-Practice & Experience"
 188 .BR 15 ,
 189 7 (July 1985), 637-654.
 190 .br