LATEXREVISE(1)

💖 LATEXREVISE(1) — the manual page, but make it cute ✨

okay so bestie, welcome to latexrevise, section 1 of the manual pages. it's giving "quietly powerful little cleanup tool" and honestly? we're obsessed. 🫶

---

✨ NAME ✨

latexrevise — selectively remove markup and text from latexdiff output. no cap, that's the whole job description. 💅

---

🌸 SYNOPSIS 🌸

latexrevise [ OPTIONS ] [ diff.tex ] > revised.tex

like. that's it. that's the whole vibe. 😌

---

🦋 DESCRIPTION 🦋

so latexrevise reads a file called diff.tex (which is the output of latexdiff, obviously, the whole family tree iykyk) and it removes the markup commands. if you don't hand it a filename, it just reads from standard input instead. lowkey flexible of it. 💁

the command can run in ACCEPT mode, DECLINE mode, or SIMPLIFY mode — or it can be used to remove user-defined latex commands from the input (peep -c, -e, -m, and -n below, bestie, don't skip them).

• ACCEPT mode — all appended text fragments (or preamble lines) are kept, and all discarded text fragments (or preamble lines) get deleted. bye. 💀
• DECLINE mode — flip it: all discarded text fragments are kept, and all appended text fragments are deleted. 🪦

now, if you want to keep some changes, you gotta edit the diff.tex file in advance and manually remove those tokens which would otherwise be deleted. it does not read your mind, bestie. 😭

heads up: latexrevise only pays attention to the "\DIFaddbegin", "\DIFaddend", "\DIFdelbegin", and "\DIFdelend" tokens and the corresponding FL varieties. that's the whole guest list.

all "\DIFadd" and "\DIFdel" commands (but not their contents) are simply deleted. the commands that latexdiff added to the preamble are also removed. 🧹✨

in SIMPLIFY mode, the "\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend" tokens and their corresponding "FL" varieties are kept but all other markup (e.g. "DIFadd" and <\DIFdel>) is removed. fair warning: the result will not in general be valid latex-code — but it will be easier to read and edit while you get ready for a subsequent run in ACCEPT or DECLINE mode. it's giving ✨rough draft energy✨.

in SIMPLIFY mode the preamble is left unmodified. untouched. pristine. we respect her boundaries. 🙈

---

💅 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). 🧼

ok so the three mode options are mutually exclusive, bestie. pick ONE. you cannot have all three. that's not how this works. 💀

if no mode option is given, latexrevise simply removes user annotations and markup according to the following four options. and honestly? these functions can be very useful outside the latexdiff context, too. they're not just side characters, they're main characters. 👑

• -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. so like, the notes you left for yourself that absolutely cannot go out into the world. 🫣
• -e envir or --comment-environment=envir — remove explicit annotation environments from the text, i.e. remove these blocks:

\begin{envir}
...
\end{envir}

whole thing. gone. 🧚

• -m cmd or --markup=cmd — remove the markup command "\cmd" but leave its argument, i.e. turn "\cmd{abc}" into "abc". the wrapper leaves, the filling stays. iconic behaviour tbh. 🍓
• -n envir or --markup-environment=envir — similarly, remove "\begin{envir}" and "\end{envir}" commands but leave content of the environment in the text. same energy, different costume. 🎀
• -r cmd or --replace=cmd — for constructions "\\cmd{..}{..}", remove the command, leave the content of the first argument, and delete the second argument, i.e. turn "\cmd{abc}{def}" into "abc". one argument survives. the other one... didn't make it. 😭
• -V or --verbose — verbose output. she will talk. 🗣️
• -q or --no-warnings — do not warn users about "\DIDadd{..}" or "\DIFdel{..}" statements which should have been removed already. (yes, DIDadd, that's exactly how it's spelled in the manual, don't come for me, i'm just the messenger 💀)

---

💀 BUGS 💀

ngl bestie, the current version is a beta version which has not yet been extensively tested. it has not been actively maintained, so it might not process output of newer versions of latexdiff entirely correctly. she's doing her best but she's been through a lot. 😭

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. yes, we need the receipts. all of them. 🧾

⚠️ also note: latexrevise gets confused by commented "\begin{document}" or "\end{document}" statements. so. don't do that. or do, but know she's gonna spiral. 🙈

---

🌈 SEE ALSO 🌈

latexdiff

(that's it. that's the whole list. the origin story. the mothership. 🛸)

---

🧚 PORTABILITY 🧚

latexrevise does not make use of external commands and thus should run on any platform supporting PERL v5 or higher. no dependencies, no drama, no "but have you installed..." — she's self-sufficient. 💅

---

👑 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. slay, legally. 📜✨

---

and that's the whole page, bestie!! 🎀 this was perl v5.34.0, dated 2021-12-27, and you've been reading LATEXREVISE(1). go forth and revise your latex. periodt. 💖🦋🌸