summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/changebar/chbar.1
blob: f36e68e2bbb52ab7c6b33766c73ef50a20ef2e4a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
.ds AL L\\v'.3m'A\\v'-.3m'\\*(ET
.TH CHBAR 1 TeX
.SH NAME
chbar \- write \*(AL file with `change bars' showing change between input \*(AL files
.SH SYNOPSIS
.B chbar
[
.B \-h
] [
.B \-g
] [
.B \-G
] [
.BI \-d " dir"
] [
.BI \-r " rev"
]
.I old new
[
.I output
]
.sp
.B chbar
[
.B \-h
] [
.B \-g
] [
.B \-G
] [
.BI \-d " dir"
] [
.BI \-r " rev"
]
.I old
.sp
.B chbar
[
.B \-h
] [
.B \-g
] [
.B \-G
]
.BI \-d " dir"
.BI \-r " rev"
.I files
.SH DESCRIPTION
.I chbar
takes two \*(AL files and produce a third which
has change bars highlighting the difference between them. There
are three basic modes of operation: first, pathnames can
be given for
.I old
and
.IR new ;
second, if only
.I old
is named, the
.I new
file is taken from standard input and the output is written to standard
output; thirdly, if the
.B \-r
option is used
.I files
held by RCS must be named - (see the explanation of the
.B \-r
option).
.sp
Change bars are inserted for differences after '\ebegin{document}'.
.SH OPTIONS
.TP
.BI \-d " dir"
Write the output to file
.IR dir/new ,
if
.I new
is given or to file
.IR dir/old .
If
.I dir
does not exist, it is created.
If
.I output
is given, it is discarded.
.TP
.BI \-r " rev"
If the \*(AL
.I files
are kept under control of the Revision Control System RCS, the old files of
the revision
.I rev
can be retrieved.
.I rev
is specified using the RCS conventions.
This option must be used together with the
.BI \-d " dir"
option.
.I files
must be a nonempty list of files.
.TP
.B \-h
Print a help text.
.TP
.B \-g
Print some debugging info.
.TP
.B \-G
Even more debug info.
.SH SEE ALSO
.IR diff (1),
.IR rcs (1)
.SH BUGS
The
.I new
file can not be named `-'.