# latexrevise

LATEXREVISE(1)         User Contributed Perl Documentation        LATEXREVISE(1)

NAME
latexrevise - selectively remove markup and text from latexdiff output

SYNOPSIS
latexrevise [ OPTIONS ] [ diff.tex ] > revised.tex

DESCRIPTION
latexrevise reads a file "diff.tex" (output of latexdiff), and remove the
markup commands.  If no filename is given the input is read from standard
input. The command can be used in ACCEPT, DECLINE, or SIMPLIFY mode, or
can be used to remove user-defined latex commands from the input (see -c,
-e, -m, and -n below).  In ACCEPT mode, all appended text fragments  (or
preamble lines) are kept, and all discarded text fragments (or preamble
lines) are deleted.  In DECLINE mode, all discarded text fragments are
kept, and all appended text fragments are deleted.  If you wish to keep
some changes, edit the diff.tex file in advance, and manually remove
those tokens  which would otherwise be deleted.  Note that latexrevise
and "\DIFdelend" tokens and corresponding FL varieties.  All "\DIFadd"
and "\DIFdel" commands (but not their contents) are simply deleted.   The
commands added by latexdiff to the preamble are also removed.  In
tokens and their corresponding "FL" varieties are kept but all other
markup (e.g. "DIFadd" and <\DIFdel>) is removed.  The result will not in
general be valid latex-code but it will be easier to read and edit in
preparation for a subsequent run in ACCEPT or DECLINE mode.  In SIMPLIFY
mode the preamble is left unmodified.

OPTIONS
-a or --accept
Run in ACCEPT mode (delete all blocks marked by "\DIFdelbegin" and
"\DIFdelend").

-d or --decline
Run in DECLINE mode (delete all blocks marked by "\DIFaddbegin" and

-s or --simplify
"\DIFdelbegin", "\DIFdelend" tokens, but remove all other latexdiff
markup from body).

Note that the three mode options are mutually exclusive.  If no mode
option is given, latexrevise simply removes user annotations and markup
according to the following four options.

-c cmd or --comment=cmd
Remove "\cmd{...}" sequences.  "cmd" is supposed to mark some
explicit anotations which should be removed from the file before
release.

-e envir or --comment-environment=envir
Remove explicit annotation environments from the text, i.e. remove

\begin{envir}
...
\end{envir}

blocks.

-m cmd or --markup=cmd
Remove the markup command "\cmd" but leave its argument, i.e.  turn
"\cmd{abc}" into "abc".

-n envir or --markup-environment=envir
Similarly, remove "\begin{envir}" and "\end{envir}" commands but
leave content of the environment in the text.

-V or --verbose
Verbose output

-q or --no-warnings
which should have been removed already.

BUGS
The current version is a beta version which has not yet been extensively
tested, but worked fine locally.  Please submit bug reports using the
issue tracker of the github repository page
https://github.com/ftilmann/latexdiff.git, or send them to tilmann -- AT
-- gfz-potsdam.de..  Include the serial number of latexrevise (Option
--version).  If you come across latexdiff output which is not processed
correctly by latexrevise please include the problem file as well as the
old and new files on which it is based, ideally edited to only contain
the offending passage as long as that still reproduces the problem.

Note that latexrevise gets confused by commented "\begin{document}" or
"\end{document}" statements

latexdiff

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

AUTHOR
perl v5.28.1                       2018-12-26                     LATEXREVISE(1)