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 anotations 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, 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
93       Note that latexrevise gets confused by commented "\begin{document}" or
94       "\end{document}" statements
95

SEE ALSO

97       latexdiff
98

PORTABILITY

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

AUTHOR

104       Copyright (C) 2004 Frederik Tilmann
105
106       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
108
109
110
111perl v5.22.1                      2015-12-27                    LATEXREVISE(1)
Impressum