summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-doc.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-doc.html')
-rw-r--r--Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-doc.html18
1 files changed, 10 insertions, 8 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-doc.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-doc.html
index b13fa3a39e8..b0248ad8f6e 100644
--- a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-doc.html
+++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-doc.html
@@ -20,8 +20,9 @@ source mechanism was first discussed, the <i>.drv</i> mechanism was
suggested, but it&rsquo;s not widely used nowadays).
<p/>Sometimes, the LaTeX run will complain that it can&rsquo;t find
<i>package.ind</i> (the code line index) and/or <i>package.gls</i>
-(the list of change records). Both types of file are processed with
-special <i>makeindex</i> style files; appropriate commands are:
+(the list of change records, not as you might imagine, a glossary).
+Both types of file are processed with special <i>makeindex</i>
+style files; appropriate commands are:
<blockquote>
<pre>
makeindex -s gind package
@@ -30,11 +31,12 @@ makeindex -s gglo -o package.gls package.glo
</blockquote><p>
This author finds that the second (the change record) is generally of
limited utility when reading package documentation; it is, however,
-valuable if you&rsquo;re part of the package development team.
-<p/>Another common (and reasonable) trick is to provide a separate file
-<i>package-doc.tex</i> or even simply <i>manual.tex</i>; if the file
-<i>package.dtx</i> doesn&rsquo;t help, simply look around for alternatives.
-Such files are treated in the same way as any &ldquo;ordinary&rdquo; LaTeX
-file.
+valuable if you&rsquo;re part of the package development team. If you don&rsquo;t
+feel you need it, just leave out that step
+<p/>Another common (and reasonable) trick performed by package authors is
+to provide a separate file <i>package-doc.tex</i> or even simply
+<i>manual.tex</i>; if the file <i>package.dtx</i> doesn&rsquo;t help, simply
+look around for such alternatives. The files are treated in the same
+way as any &ldquo;ordinary&rdquo; LaTeX file.
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=install-doc">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=install-doc</a>
</body>