summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-changebars.html
diff options
context:
space:
mode:
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.html39
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, &ldquo;change bars&rdquo; (also known as &ldquo;revision
bars&rdquo;), requires surprisingly much
trickery of the programmer (the problem being that TeX &lsquo;proper&rsquo;
@@ -11,14 +11,15 @@ doesn&rsquo;t provide the programmer with any information about the
bar might be calculated; PDFTeX <em>does</em> provide the
information, but we&rsquo;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&rsquo;s
+<p/>The simplest package that offers change bars is Peter Schmitt&rsquo;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&rsquo;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 &mdash; 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&rsquo;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 &mdash; to produce a document that embodies both &ldquo;old&rdquo;
-and &ldquo;new&rdquo; 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 &mdash; to produce a document that embodies both
+&ldquo;old&rdquo; and &ldquo;new&rdquo; 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>