Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
LATEXREVISE(1)							  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 pream-
     ble 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, \DIFad-
     dend,  \DIFdelbegin,  \DIFdelend" tokens and their corresponding "FL" vari-
     eties are kept but all other markup (e.g. "DIFadd" and  <\DIFdel>)  is  re-
     moved.   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", "\DIFdel-
	 begin", "\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 con-
	 tent  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 --ver-
     sion).  If you come across latexdiff output which	is  not  processed  cor-
     rectly  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  of-
     fending 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 un-
     der the terms of the GNU General Public License Version 3

perl v5.38.2			   2024-11-17			  LATEXREVISE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=latexrevise&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help