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. These functions can be  very
       useful outside the latexdiff context, too

       -c cmd or --comment=cmd
           Remove  "\cmd{...}"  sequences.   "cmd" is supposed to mark some explicit annotations 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.

       -r cmd or --replace=cmd
           For  constructions  "\\cmd{..}{..}",  remove  the  command,  leave the content of first argument, and
           delete second argument, i.e. turn "\cmd{abc}{def}" into "abc".

       -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. It has not been actively
       maintained  so might not process output of newer versions of latexdiff entirely correctly.  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

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 3

perl v5.34.0                                       2022-07-14                                     LATEXREVISE(1)