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
19 discarded 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
23 "\DIFaddbegin", "\DIFaddend", "\DIFdelbegin", and "\DIFdelend" tokens
24 and corresponding FL varieties. All "\DIFadd" and "\DIFdel" commands
25 (but not their contents) are simply deleted. The commands added by
26 latexdiff to the preamble are also removed. In SIMPLIFY mode,
27 "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend" tokens and their
28 corresponding "FL" varieties are kept but all other markup (e.g.
29 "DIFadd" and <\DIFdel>) is removed. The result will not in general be
30 valid latex-code but it will be easier to read and edit in preparation
31 for a subsequent run in ACCEPT or DECLINE mode. In SIMPLIFY mode the
32 preamble is 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. These functions can be very
51 useful outside the latexdiff context, too
52 -c cmd or --comment=cmd
54 Remove "\cmd{...}" sequences. "cmd" is supposed to mark some
55 explicit annotations which should be removed from the file before
56 release.
57 -e envir or --comment-environment=envir
59 Remove explicit annotation environments from the text, i.e. remove
60 \begin{envir}
62 ...
63 \end{envir}
64 blocks.
66 -m cmd or --markup=cmd
68 Remove the markup command "\cmd" but leave its argument, i.e. turn
69 "\cmd{abc}" into "abc".
70 -n envir or --markup-environment=envir
72 Similarly, remove "\begin{envir}" and "\end{envir}" commands but
73 leave content of the environment in the text.
74 -r cmd or --replace=cmd
76 For constructions "\\cmd{..}{..}", remove the command, leave the
77 content of first argument, and delete second argument, i.e. turn
78 "\cmd{abc}{def}" into "abc".
79 -V or --verbose
81 Verbose output
82 -q or --no-warnings
84 Do not warn users about "\DIDadd{..}" or "\DIFdel{..}" statements
85 which should have been removed already.
86
88 The current version is a beta version which has not yet been
89 extensively tested. It has not been actively maintained so might not
90 process output of newer versions of latexdiff entirely correctly.
91 Please submit bug reports using the issue tracker of the github
92 repository page https://github.com/ftilmann/latexdiff.git, or send them
93 to tilmann -- AT -- gfz-potsdam.de. Include the serial number of
94 latexrevise (Option --version). If you come across latexdiff output
95 which is not processed correctly by latexrevise please include the
96 problem file as well as the old and new files on which it is based,
97 ideally edited to only contain the offending passage as long as that
98 still reproduces the problem.
99 Note that latexrevise gets confused by commented "\begin{document}" or
101 "\end{document}" statements
102
104 latexdiff
105
107 latexrevise does not make use of external commands and thus should run
108 on any platform supporting PERL v5 or higher.
109
111 Copyright (C) 2004 Frederik Tilmann
112 This program is free software; you can redistribute it and/or modify it
114 under the terms of the GNU General Public License Version 3
115perl v5.30.0 2021-12-27 LATEXREVISE(1)