1LATEXREVISE(1)                                                  LATEXREVISE(1)
2
3
4

NAME

6       latexrevise - selectively remove markup and text from latexdiff output
7

SYNOPSIS

9       latexrevise [ OPTIONS ] [ diff.tex ] > revised.tex
10

DESCRIPTION

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

OPTIONS

35       -a or --accept
36           Run in ACCEPT mode (delete all blocks marked by "\DIFdelbegin" and
37           "\DIFdelend").
38
39       -d or --decline
40           Run in DECLINE mode (delete all blocks marked by "\DIFaddbegin" and
41           "\DIFaddend").
42
43       -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
48       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
52       -c cmd or --comment=cmd
53           Remove "\cmd{...}" sequences.  "cmd" is supposed to mark some
54           explicit annotations which should be removed from the file before
55           release.
56
57       -e envir or --comment-environment=envir
58           Remove explicit annotation environments from the text, i.e. remove
59
60                       \begin{envir}
61                       ...
62                       \end{envir}
63
64           blocks.
65
66       -m cmd or --markup=cmd
67           Remove the markup command "\cmd" but leave its argument, i.e.  turn
68           "\cmd{abc}" into "abc".
69
70       -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
74       -V or --verbose
75           Verbose output
76
77       -q or --no-warnings
78           Do not warn users about "\DIDadd{..}" or "\DIFdel{..}" statements
79           which should have been removed already.
80

BUGS

82       The current version is a beta version which has not yet been
83       extensively tested. It has not been actively maintained so might not
84       process output of newer versions of latexdiff entirely correctly.
85       Please submit bug reports using the issue tracker of the github
86       repository page https://github.com/ftilmann/latexdiff.git, or send them
87       to tilmann -- AT -- gfz-potsdam.de.  Include the serial number of
88       latexrevise (Option --version).  If you come across latexdiff output
89       which is not processed correctly by latexrevise please include the
90       problem file as well as the old and new files on which it is based,
91       ideally edited to only contain the offending passage as long as that
92       still reproduces the problem.
93
94       Note that latexrevise gets confused by commented "\begin{document}" or
95       "\end{document}" statements
96

SEE ALSO

98       latexdiff
99

PORTABILITY

101       latexrevise does not make use of external commands and thus should run
102       on any platform  supporting PERL v5 or higher.
103

AUTHOR

105       Copyright (C) 2004 Frederik Tilmann
106
107       This program is free software; you can redistribute it and/or modify it
108       under the terms of the GNU General Public License Version 3
109
110
111
112perl v5.22.1                      2020-06-13                    LATEXREVISE(1)
Impressum