README revision 1.1 1 1.1 christos gdiffmk is approximately a recreation of the original Bell Labs/AT&T diffmk
2 1.1 christos command for troff/nroff documents, with enhancements.
3 1.1 christos
4 1.1 christos It should not be confused with `diffmk' commands that operate on XML.
5 1.1 christos
6 1.1 christos The inspiration for this code was a Perl 2 version written in 1989 by Randal
7 1.1 christos L. Schwartz. See
8 1.1 christos landfield.com/software/comp.sources.misc/archive-name/volume06/diffmk.p.gz
9 1.1 christos
10 1.1 christos The command also attempts to reproduce some of the functionality of the old
11 1.1 christos `nrchbar' command. See
12 1.1 christos open-systems.ufl.edu/mirrors/ftp.isc.org/usenet/comp.sources.unix/volume10/nrchbar.Z
13 1.1 christos
14 1.1 christos Thanks to Werner Lemberg for help in making the package more portable and
15 1.1 christos fit into the GNU groff source structure.
16 1.1 christos
17 1.1 christos Gnu diff(1) with the -Dname option does all of the work and sed(1)
18 1.1 christos translates the output into something groff/troff/nroff can handle.
19 1.1 christos
20 1.1 christos Note the BUGS on the man page.
21 1.1 christos
22 1.1 christos The `tests' directory contains simple tests. `runtests run' runs them and
23 1.1 christos compares the output against baseline files. Calling `runtests' without
24 1.1 christos argument gives the usage.
25 1.1 christos
26 1.1 christos ----------------------------------------------------------------------------
27 1.1 christos
28 1.1 christos Copyright (C) 2004, 2005 Free Software Foundation, Inc.
29 1.1 christos Written by Mike Bianchi <MBianchi (a] Foveal.com <mailto:MBianchi (a] Foveal.com>>
30 1.1 christos
31 1.1 christos This file is part of the gdiffmk utility, which is part of groff.
32 1.1 christos
33 1.1 christos groff is free software; you can redistribute it and/or modify it
34 1.1 christos under the terms of the GNU General Public License as published by
35 1.1 christos the Free Software Foundation; either version 2, or (at your option)
36 1.1 christos any later version.
37 1.1 christos
38 1.1 christos groff is distributed in the hope that it will be useful, but WITHOUT
39 1.1 christos ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
40 1.1 christos or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
41 1.1 christos License for more details.
42 1.1 christos
43 1.1 christos You should have received a copy of the GNU General Public License
44 1.1 christos along with groff; see the files COPYING and LICENSE in the top
45 1.1 christos directory of the groff source. If not, write to the Free Software
46 1.1 christos Foundation, 51 Franklin St - Fifth Floor, Boston, MA 02110-1301, USA.
47