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.
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
83 extensively tested, but worked fine locally. Please submit bug reports
84 using the issue tracker of the github repository page
85 https://github.com/ftilmann/latexdiff.git, or send them to tilmann --
86 AT -- gfz-potsdam.de.. Include the serial number of latexrevise
87 (Option --version). If you come across latexdiff output which is not
88 processed correctly by latexrevise please include the problem file as
89 well as the old and new files on which it is based, ideally edited to
90 only contain the offending passage as long as that still reproduces the
91 problem.
92 Note that latexrevise gets confused by commented "\begin{document}" or
94 "\end{document}" statements
95
97 latexdiff
98
100 latexrevise does not make use of external commands and thus should run
101 on any platform supporting PERL v5 or higher.
102
104 Copyright (C) 2004 Frederik Tilmann
105 This program is free software; you can redistribute it and/or modify it
107 under the terms of the GNU General Public License Version 3
108perl v5.22.1 2015-12-27 LATEXREVISE(1)