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 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

		       egin{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 "egin{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 "egin{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

perl v5.14.2							    2007-09-29							    LATEXREVISE(1)