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 only pays attention to the
"\DIFaddbegin", "\DIFaddend", "\DIFdelbegin", 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 SIMPLIFY mode,
"\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend" 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
"\DIFaddend").
-s or --simplify
Run in SIMPLIFY mode (Keep all "\DIFaddbegin", "\DIFaddend",
"\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
Do not warn users about "\DIDadd{..}" or "\DIFdel{..}" statements
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 send bug reports
to tilmann@esc.cam.ac.uk. Include the serial number of latexrevise
(from comments at the top of the source). 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.
latexrevise gets confused by commented "\begin{document}" or
"\end{document}" statements
SEE ALSO
latexdiff
PORTABILITY
latexrevise does not make use of external commands and thus should run
on any platform supporting PERL v5 or higher.
AUTHOR
Copyright (C) 2004 Frederik Tilmann
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License Version 2