1LATEXREVISE(1) LATEXREVISE(1)
2
6 latexrevise - selectively remove markup and text from latexdiff output
7
9 latexrevise [ OPTIONS ] [ diff.tex ] > revised.tex
10
12 latexrevise reads a file "diff.tex" (output of latexdiff), and remove
13 the markup commands. If no filename is given the input is read from
14 standard input. The command can be used in ACCEPT, DECLINE, or SIMPLIFY
15 mode, or can be used to remove user-defined latex commands from the
16 input (see -c, -e, -m, and -n below). In ACCEPT mode, all appended
17 text fragments (or preamble lines) are kept, and all discarded text
18 fragments (or preamble lines) are deleted. In DECLINE mode, all dis‐
19 carded text fragments are kept, and all appended text fragments are
20 deleted. If you wish to keep some changes, edit the diff.tex file in
21 advance, and manually remove those tokens which would otherwise be
22 deleted. Note that latexrevise only pays attention to the "\DIFaddbe‐
23 gin", "\DIFaddend", "\DIFdelbegin", and "\DIFdelend" tokens and corre‐
24 sponding FL varieties. All "\DIFadd" and "\DIFdel" commands (but not
25 their contents) are simply deleted. The commands added by latexdiff
26 to the preamble are also removed. In SIMPLIFY mode, "\DIFaddbegin,
27 \DIFaddend, \DIFdelbegin, \DIFdelend" tokens and their corresponding
28 "FL" varieties are kept but all other markup (e.g. "DIFadd" and
29 <\DIFdel>) is removed. The result will not in general be valid latex-
30 code but it will be easier to read and edit in preparation for a subse‐
31 quent run in ACCEPT or DECLINE mode. In SIMPLIFY mode the preamble is
32 left unmodified.
33
35 -a or --accept
36 Run in ACCEPT mode (delete all blocks marked by "\DIFdelbegin" and
37 "\DIFdelend").
38 -d or --decline
40 Run in DECLINE mode (delete all blocks marked by "\DIFaddbegin" and
41 "\DIFaddend").
42 -s or --simplify
44 Run in SIMPLIFY mode (Keep all "\DIFaddbegin", "\DIFaddend",
45 "\DIFdelbegin", "\DIFdelend" tokens, but remove all other latexdiff
46 markup from body).
47 Note that the three mode options are mutually exclusive. If no mode
49 option is given, latexrevise simply removes user annotations and markup
50 according to the following four options.
51 -c cmd or --comment=cmd
53 Remove "\cmd{...}" sequences. "cmd" is supposed to mark some
54 explicit anotations which should be removed from the file before
55 release.
56 -e envir or --comment-environment=envir
58 Remove explicit annotation environments from the text, i.e. remove
59 \begin{envir}
61 ...
62 \end{envir}
63 blocks.
65 -m cmd or --markup=cmd
67 Remove the markup command "\cmd" but leave its argument, i.e. turn
68 "\cmd{abc}" into "abc".
69 -n envir or --markup-environment=envir
71 Similarly, remove "\begin{envir}" and "\end{envir}" commands but
72 leave content of the environment in the text.
73 -V or --verbose
75 Verbose output
76 -q or --no-warnings
78 Do not warn users about "\DIDadd{..}" or "\DIFdel{..}" statements
79 which should have been removed already.
80
82 The current version is a beta version which has not yet been exten‐
83 sively tested, but worked fine locally. Please send bug reports to
84 tilmann@esc.cam.ac.uk. Include the serial number of latexrevise (from
85 comments at the top of the source). If you come across latexdiff out‐
86 put which is not processed correctly by latexrevise please include the
87 problem file as well as the old and new files on which it is based,
88 ideally edited to only contain the offending passage as long as that
89 still reproduces the problem.
90 latexrevise gets confused by commented "\begin{document}" or "\end{doc‐
92 ument}" statements
93
95 latexdiff
96
98 latexrevise does not make use of external commands and thus should run
99 on any platform supporting PERL v5 or higher.
100
102 Copyright (C) 2004 Frederik Tilmann
103 This program is free software; you can redistribute it and/or modify it
105 under the terms of the GNU General Public License Version 2
106perl v5.8.5 2006-01-10 LATEXREVISE(1)