diff options
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-changebars.html')
-rw-r--r-- | Master/texmf-doc/doc/english/FAQ-en/html/FAQ-changebars.html | 39 |
1 files changed, 25 insertions, 14 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-changebars.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-changebars.html index f9785178d79..1c0915f7768 100644 --- a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-changebars.html +++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-changebars.html @@ -2,7 +2,7 @@ <title>UK TeX FAQ -- question label changebars</title> </head><body> <h3>Marking changed parts of your document</h3> -<p>One often needs clear indications of how a document has changed, but +<p/>One often needs clear indications of how a document has changed, but the commonest technique, “change bars” (also known as “revision bars”), requires surprisingly much trickery of the programmer (the problem being that TeX ‘proper’ @@ -11,14 +11,15 @@ doesn’t provide the programmer with any information about the bar might be calculated; PDFTeX <em>does</em> provide the information, but we’re not aware yet of any programmer taking advantage of the fact to write a PDFTeX-based changebar package). -<p>The simplest package that offers change bars is Peter Schmitt’s +<p/>The simplest package that offers change bars is Peter Schmitt’s <i>backgrnd.tex</i>; this was written as a Plain TeX application that patches the output routine, but it appears to work at least on simple LaTeX documents. Wise LaTeX users will be alerted by the information that <i>backgrnd</i> patches their output routine, and will watch its behaviour very carefully (patching the LaTeX output routine is not something to undertake lightly...). -<p>The longest-established solution is the <i>changebar</i> package, +<p/>The longest-established LaTeX-specific solution is the +<i>changebar</i> package, which uses <code>\</code><code>special</code> commands supplied by the driver you’re using. You need therefore to tell the package which driver to generate <code>\</code><code>special</code>s for (in the same way that you need to tell the @@ -32,41 +33,51 @@ shareware <i>WinEDT</i> editor has a macro that will generate earlier version of your file, stored in an <i>RCS</i>-controlled repository — see <a href="http://www.winedt.org/Macros/LaTeX/RCSdiff.php">http://www.winedt.org/Macros/LaTeX/RCSdiff.php</a> -<p>The <i>vertbars</i> package uses the techniques of the +<p/>The <i>vertbars</i> package uses the techniques of the <i>lineno</i> package (which it loads, so the <i>lineno</i> itself must be installed); it’s thus the smallest of the packages for change bar marking, since it leaves all the trickery to another package. <i>Vertbars</i> defines a <code>vertbar</code> environment to create changebars. -<p>The <i>framed</i> package is +<p/>The <i>framed</i> package is another that provides bars as a side-effect of other desirable functionality: its <code>leftbar</code> environment is simply a stripped-down frame (note, though, that the environment makes a separate paragraph of its contents, so it is best used when the convention is to mark a whole changed paragraph. -<p>Finally, the <i>memoir</i> class allows marginal editorial comments, +<p/>Finally, the <i>memoir</i> class allows marginal editorial comments, which you can obviously use to delimit areas of changed text. -<p>Another way to keep track of changes is employed by some -word-processors — to produce a document that embodies both “old” -and “new” versions. The <i>Perl</i> script <i>latexdiff</i> -does this for LaTeX documents; you feed it the two documents, and -it produces a new LaTeX document in which the changes are very -visible. An example of the output is embedded in the documentation, +<p/>An even more comprehensive way to keep track of changes is employed by +some word-processors — to produce a document that embodies both +“old” and “new” versions. +<p/>To this end, he package <i>changes</i> allows the user to manually +markup changes of text, such as additions, deletions, or replacements. +Changed text is shown in a different colour; deleted text is crossed +out. The package allows you to define additional authors and their +associated colour; it also allows you to define a markup for authors +or annotations. The documentation (very clearly) demonstrates how the +various functions work. +<p/>The <i>Perl</i> script <i>latexdiff</i> may also be used to +generate such markup for LaTeX documents; you feed it the two +documents, and it produces a new LaTeX document in which the +changes are very visible. An example of the output is embedded in the +documentation, <a href="http://www.tex.ac.uk/tex-archive/support/latexdiff/latexdiff-man.pdf">latexdiff-man.pdf</a> (part of the distribution). A rudimentary revision facility is provided by another <i>Perl</i> script, <i>latexrevise</i>, which accepts or rejects all changes. Manual editing of the difference file can be used to -accept or reject selected changes only. +accept or reject selected changes only. <dl> <dt><tt><i>backgrnd.tex</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/generic/misc/backgrnd.tex">macros/generic/misc/backgrnd.tex</a> <dt><tt><i>changebar.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/changebar.zip">macros/latex/contrib/changebar</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/changebar.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/changebar/">browse</a>) +<dt><tt><i>changes.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/changes.zip">macros/latex/contrib/changes</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/changes.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/changes/">browse</a>) <dt><tt><i>framed.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/misc/framed.sty">macros/latex/contrib/misc/framed.sty</a> <dt><tt><i>latexdiff, latexrevise</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/support/latexdiff.zip">support/latexdiff</a> (<a href="ftp://cam.ctan.org/tex-archive/support/latexdiff.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/support/latexdiff/">browse</a>) <dt><tt><i>lineno.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/lineno.zip">macros/latex/contrib/lineno</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/lineno.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/lineno/">browse</a>) <dt><tt><i>memoir.cls</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/memoir.zip">macros/latex/contrib/memoir</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/memoir.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/memoir/">browse</a>) <dt><tt><i>vertbars.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/misc/vertbars.sty">macros/latex/contrib/misc/vertbars.sty</a> </dl> -<p><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=changebars">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=changebars</a> +<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=changebars">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=changebars</a> </body> |