latexrevise (1)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man1/latexrevise.1".)

NAME

latexrevise - selectively remove markup and text from latexdiff output

SYNOPSIS

latexrevise [ ] [ 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 , , or mode, or can be used to remove user-defined latex commands from the input (see -c, -e, -m, and -n below). In mode, all appended text fragments (or preamble lines) are kept, and all discarded text fragments (or preamble lines) are deleted. In 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 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 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 or mode. In 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 submit bug reports using the issue tracker of the github repository page github.com/ftilmann/latexdiff.git, or send them to tilmann --- --- 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

SEE ALSO

latexdiff

PORTABILITY

latexrevise does not make use of external commands and thus should run on any platform supporting 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

General Public License Version 3