Annotation of src/usr.bin/rcs/merge.1, Revision 1.4
1.4 ! jmc 1: .\" $OpenBSD: merge.1,v 1.3 2010/10/28 15:08:50 jmc Exp $
1.1 xsa 2: .\"
3: .\" Copyright (c) 2006 Xavier Santolaria <xsa@openbsd.org>
4: .\" All rights reserved.
5: .\"
6: .\" Permission to use, copy, modify, and distribute this software for any
7: .\" purpose with or without fee is hereby granted, provided that the above
8: .\" copyright notice and this permission notice appear in all copies.
9: .\"
10: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.4 ! jmc 17: .Dd $Mdocdate: October 28 2010 $
1.1 xsa 18: .Dt MERGE 1
19: .Os
20: .Sh NAME
21: .Nm merge
22: .Nd 3-way file merge
23: .Sh SYNOPSIS
24: .Nm
25: .Op Fl EepqV
26: .Op Fl L Ar label
27: .Ar file1 file2 file3
28: .Sh DESCRIPTION
29: The
30: .Nm
31: program merges changes leading from
32: .Ar file2
33: to
34: .Ar file3
35: into
36: .Ar file1 .
37: .Pp
38: The following options are supported:
39: .Bl -tag -width Ds
40: .It Fl E
41: Default merge:
42: see
43: .Xr diff3 1
44: for details.
45: .It Fl e
46: Same as
47: .Fl E
48: but does not warn about conflicts.
49: .It Fl L Ar label
50: Specifies labels to be used in place of corresponding file names
1.3 jmc 51: in conflict reports.
1.1 xsa 52: May be given up to three times.
53: .It Fl p
54: Print result to standard output.
55: .It Fl q
56: Be quiet about reporting.
57: .It Fl V
58: Print RCS's version number.
59: .El
1.4 ! jmc 60: .Sh EXIT STATUS
1.1 xsa 61: The
62: .Nm
63: utility exits with one of the following values:
64: .Pp
65: .Bl -tag -width Ds -compact -offset indent
66: .It 0
67: No overlaps.
68: .It 1
69: Overlaps were found.
70: .It 2
71: An error occurred.
72: .El
1.4 ! jmc 73: .Sh EXAMPLES
! 74: Using labels:
! 75: .Bd -literal -offset indent
! 76: $ merge -q -p -L one -L two -L three file1 file2 file3
! 77: <<<<<<< one
! 78: =======
! 79: bar
! 80: >>>>>>> three
! 81: .Ed
1.1 xsa 82: .Sh SEE ALSO
83: .Xr co 1 ,
84: .Xr diff 1 ,
85: .Xr diff3 1 ,
86: .Xr rcsmerge 1
87: .Sh STANDARDS
88: The flag
89: .Op Fl A
90: has no effect and is provided
91: for compatibility only.