summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/changebar/chbar.1
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/changebar/chbar.1')
-rw-r--r--macros/latex/contrib/changebar/chbar.1117
1 files changed, 117 insertions, 0 deletions
diff --git a/macros/latex/contrib/changebar/chbar.1 b/macros/latex/contrib/changebar/chbar.1
new file mode 100644
index 0000000000..f36e68e2bb
--- /dev/null
+++ b/macros/latex/contrib/changebar/chbar.1
@@ -0,0 +1,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 `-'.
+