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

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