revision: A LaTeX package to suggest editions and add comments.

Options

• todonotes: Use package todonotes to create comments instead of footnotes.
• inline : make comments appear inline instead of footnotes or margin notes.
• hide=[before|after]: hide all comments. Furthermore, either keep added text and hide deleted text (hide=before) or keep deleted text and hide added text (hide=after). Just using hide is equivalent to hide=before.
• soul: Use package soul instead of ulem for crossing out deleted text. This may be useful if a conflict with another package prevents using the ulem package.
• norelsize: Disable use of the relsize package. Useful to keep compatibility with broken LaTeX templates like the one from Wiley.

Usage

This package defines 3 commands:

1. \newrevisor{name}{color-for-insert}[color-for-delete] where the first argument is the name of the revisor, second argument is color for additions and third optional argument is color for deletions. If the third argument is missing, the second argument is used for both additions and deletions. See colornames in https://en.wikibooks.org/wiki/LaTeX/Colors . This command creates two new commands:

• Lowercase \name{text-to-delete}{text-to-insert} for suggesting changes.

• Uppercase \NAME{text} for adding comments. The starred version \NAME*{text} for the comment to be inline (useful for placing comments in footnotes, captions, tables, etc.)

2. \hiderevisor{name} Modifies the corresponding commands generated by \newrevisor{name} so that comments and suggested deletions are hidden and suggested additions are shown without coloring them.

3. \listofrevisions: Creates a list of revisions (comments and suggested changes).

Example:

\usepackage{newrevisor}
\newrevisor{manuel}{red!75} 
\newrevisor{maria}{green!75} 
% Creates lowercase \manuel{}{} for marking edits and uppercase \MANUEL{} and \MANUEL*{} (inline version) for comments.
% \hiderevisor{manuel} % Modifies the generated commands as described above.
\begin{document}

Then in a sentence you can you use \manuel{text-marked-for-deletion}{text-marked-for-insertion} and you can also add comments.\MANUEL{\label{comment:this} This is a comment\MARIA{Nested comment (a reply)}}

And more text.\MANUEL*{This is an inline comment. See my comment \ref{comment:this} on \pageref{comment:this}.}

\end{document}

For a more detailed example see: https://github.com/MLopez-Ibanez/revision/blob/main/example.pdf

ChangeLog

• 0.8: Fix error when using an edition command within \title{}.

• 0.7: A comment within a comment creates an inline comment. Example:

\MANUEL{Creates a footnote\MAURA{Creates an inline comment within the footnote}}

Limitations

• It is currently not possible to mark equation environments for deletion (see issue #7).

• It is not possible to mark a \section (or \subsection or \paragraph) command for deletion (see issue #9). The workaround is to mark the text inside the section:

# This doesn't work
\manuel{\section{Old}}{\section{New}}
# This should work
\section{\manuel{Old}{New}}