Add support for highlighting of multi-line C preprocessor statements.
[enscript.git] / scripts / diffpp.1
1 .\" 
2 .\" diffpp manual page.
3 .\" Copyright (c) 1996 Markku Rossi.
4 .\" Author: Markku Rossi <mtr@iki.fi>
5 .\"
6 .\"
7 .\" This program is free software; you can redistribute it and/or modify
8 .\" it under the terms of the GNU General Public License as published by
9 .\" the Free Software Foundation; either version 2, or (at your option)
10 .\" any later version.
11 .\"
12 .\" This program is distributed in the hope that it will be useful,
13 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
14 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 .\" GNU General Public License for more details.
16 .\"
17 .\" You should have received a copy of the GNU General Public License
18 .\" along with this program; see the file COPYING.  If not, write to
19 .\" the Free Software Foundation, 51 Franklin Street, Fifth Floor,
20 .\" Boston, MA 02110-1301, USA.
21 .\"
22 .TH DIFFPP 1 "Jan 29, 1997" "DIFFPP" "DIFFPP"
23
24 .SH NAME
25 diffpp \- pretty\-print diff outputs with GNU enscript
26
27 .SH SYNOPSIS
28 .B diffpp \f2currentfile\f1 < \f2diff\-file\f1
29
30 .SH DESCRIPTION
31
32 \f3Diffpp\f1 converts \f3diff(1)\f1\-program's output files to a
33 format suitable to be printed with GNU \f3enscript(1)\f1.  Program
34 annotates the changes with enscript's special escapes so enscript can
35 highlight the modified portions of the file.  All changed and added
36 lines are printed with gray\-background, deleted lines are marked with
37 minus (`\-') characters; \f3diffpp\f1 prints one minus character for
38 each deleted line.
39
40 .SH EXAMPLES
41
42 The easiest way to use \f3diffpp\f1 is to use it as an input filter
43 for enscript.  If an input filter is specified for enscript it is used
44 to pre\-process the incoming data\-stream.  Filtering does not alter any
45 header strings or file\-timestamps which might be printed on enscript
46 headers; only the incoming data is modified.
47
48 .TP 8
49 \f3enscript \-G2re \-\-filter='rcsdiff %s | diffpp %s' *.c *.h\f1
50 Print the changes between current source files and their latest
51 RCS\-versions.
52 .TP 8
53 \f3enscript \-G2re \-\-filter='diff %s~ %s | diffpp %s' *.c *.h\f1
54 Print changes between source files and the corresponding backup\-files.
55
56 .SH SEE ALSO
57 diff(1), enscript(1)
58
59 .SH AUTHOR
60 Markku Rossi <mtr@iki.fi> <http://www.iki.fi/~mtr/>