[latexrefman-commits] [SCM] latexrefman updated: r934 - in trunk: . src
Karl Berry
INVALID.NOREPLY at gnu.org.ua
Thu Jul 22 00:33:44 CEST 2021
Author: karl
Date: 2021-07-21 22:33:44 +0000 (Wed, 21 Jul 2021)
New Revision: 934
Modified:
trunk/ChangeLog
trunk/Makefile
trunk/aspell.en.pws
trunk/latex2e.texi
trunk/src/easyurls.py
Log:
intro wording tweaks; indexing references
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2021-07-21 18:37:08 UTC (rev 933)
+++ trunk/ChangeLog 2021-07-21 22:33:44 UTC (rev 934)
@@ -1,3 +1,11 @@
+2021-07-21 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (intro): wording.
+ (Indexes): mention CTAN topic.
+ (makeindex): mention xindex.
+ * GNUmakefile (easyurls): use name testdist instead of test.
+ * src/easyurls.py (INDEX_FILE_NOTE): intro wording.
+
2021-07-21 Jim Hefferon <jhefferon at smcvt.edu>
* latex2e.texi: Added comment at end of top page header,
Modified: trunk/Makefile
===================================================================
--- trunk/Makefile 2021-07-21 18:37:08 UTC (rev 933)
+++ trunk/Makefile 2021-07-21 22:33:44 UTC (rev 934)
@@ -118,8 +118,8 @@
easyurls: htmlsplit dist
cd src \
&& mkdir -p test \
- && cp ../latex2e-help-texinfo-tree.zip test \
- && rm -Rf latex2e && unzip -q test/latex2e-help-texinfo-tree \
+ && cp ../latex2e-help-texinfo-tree.zip testdist \
+ && rm -rf latex2e && unzip -q testdist/latex2e-help-texinfo-tree \
&& ./easyurls.py --directory latex2e --action softlink --lower_case --rewrite_index --debug \
&& zip -rq ../latex2e-help-texinfo-tree-easyurls.zip latex2e
Modified: trunk/aspell.en.pws
===================================================================
--- trunk/aspell.en.pws 2021-07-21 18:37:08 UTC (rev 933)
+++ trunk/aspell.en.pws 2021-07-21 22:33:44 UTC (rev 934)
@@ -280,3 +280,4 @@
xstring
qed
dottedtocline
+xindex
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-07-21 18:37:08 UTC (rev 933)
+++ trunk/latex2e.texi 2021-07-21 22:33:44 UTC (rev 934)
@@ -92,9 +92,9 @@
@end tex
@html
-<div class='intro'> <p>This is a reference manual for LaTeX. See below
-for the <a href='#SEC_Overview'>Table of Contents</a>. If you want a
-tutorial then please instead visit <a
+<div class='intro'> <p>This is an unofficial reference manual for
+LaTeX. See below for the <a href='#SEC_Overview'>Table of Contents</a>.
+If you want a tutorial then please instead visit <a
href="https://www.learnlatex.org/"><code>learnlatex.org</code></a> or <a
href='https://ctan.org/topic/tut-latex'>this list</a>.</p>
@@ -110,10 +110,10 @@
very welcome. See <a href='https://latexref.xyz/dev/'>our project
page</a> for more, including <a
href='https://latexref.xyz/dev/#license'>license information</a> and
-information on how you can <a
-href='https://latexref.xyz/dev/mirroring.html'>mirror this manual</a>,
-as well as <a href='https://latexref.xyz/dev/writing.html'>contribute to
-it</a>.</p>
+information on how you can
+<a href='https://latexref.xyz/dev/writing.html'>contribute to this manual</a>
+as well as
+<a href='https://latexref.xyz/dev/mirroring.html'>mirror it</a>.</p>
<!-- End of opening header -->
@end html
@@ -19453,12 +19453,15 @@
@PkgIndex{showidx}
@PkgIndex{multind}
-There are many packages that apply to indexing commands. The
- at code{showidx} package causes each index entries to be shown in the
-margin on the page where the entry appears. This can help in preparing
-the index. The @code{multind} package supports multiple indexes. See
-also the @TeX{} FAQ entry on this topic,
- at url{https://www.texfaq.org/FAQ-multind}.
+ at cindex index, multiple
+ at cindex multiple indexes
+There are many packages in the area of indexing. The @code{showidx}
+package causes each index entries to be shown in the margin on the
+page where the entry appears. This can help in preparing the index.
+The @code{multind} package, among others, supports multiple indexes.
+See also the @TeX{} FAQ entry on this topic,
+ at url{https://www.texfaq.org/FAQ-multind}, and the CTAN topic,
+ at url{https://ctan.org/topic/index-multi}.
@menu
* \index:: Declare an index entry.
@@ -19810,16 +19813,20 @@
@end ftable
- at findex xindy
- at cindex @command{xindy} program
+ at findex xindy @r{program}
There are a number of other programs that do the job
- at command{makeindex} does. One is @command{xindy}, which does
-internationalization and can process indexes for documents marked up
-using @LaTeX{} and a number of other languages. It is highly
-configurable, both in markup terms and in terms of the collating order
-of the text, as described in its documentation.
+ at command{makeindex} does. One is @command{xindy}
+(https://ctan.org/pkg/xindy), which does internationalization and can
+process indexes for documents marked up using @LaTeX{} and a number of
+other languages. It is written in Lisp, highly configurable, both in
+markup terms and in terms of the collating order of the text, as
+described in its documentation.
+ at findex xindex @r{program}
+A more recent indexing program supporting Unicode is @code{xindex},
+written in Lua (@url{https://ctan.org/pkg/xindex}).
+
@node \printindex
@subsection @command{\printindex}
@@ -21455,7 +21462,8 @@
There are two other error scenarios. The first is that you forgot to
include the @code{\end@{document@}} or misspelled it. In this case
@LaTeX{} gives you a @samp{*} prompt. You can get back to the command
-line by typing @kbd{\stop} and @kbd{RETURN}.
+line by typing @kbd{\stop} and @kbd{RETURN}; this command does its
+best to exit @LaTeX{} immediately, whatever state it may be in.
The last scenario is that you mistyped the filename. For instance,
instead of @code{pdflatex test} you might type @code{pdflatex tste}.
Modified: trunk/src/easyurls.py
===================================================================
--- trunk/src/easyurls.py 2021-07-21 18:37:08 UTC (rev 933)
+++ trunk/src/easyurls.py 2021-07-21 22:33:44 UTC (rev 934)
@@ -80,27 +80,27 @@
INDEX_FILE_NOTE = """
<div class='note-about-urls'>
<p>
-<i>A note about remembering URL's.</i>
+<i>A note about remembering urls.</i>
The page addresses here come from the page titles.
Thus, the page about the <code>itemize</code> environment
-is titled <i>itemize</i> and its URL ends with
+is titled <i>itemize</i> and its url ends with
<a href='itemize.html'><code>itemize.html</code></a>.
-But some characters are troublesome in URL's.
-For instance, the <code>\\rule</code> command's page URL cannot use
-the backslash character because in URL's backslashes
-separate parts of a path.
+But some characters are troublesome in urls.
+For instance, the url for the <code>\\rule</code> command cannot use
+the backslash character because backslashes are special in urls.
Instead, the page's address uses
-the hexadecimal representation of backslash, giving
+the hexadecimal representation of backslash (namely <code>5c</code>), giving
<a href='_005crule.html'><code>_005crule.html</code></a>.
That fixes the technical problem but is hard to remember.
-We have added some alternative page names, in this case
+
+<p>So we have added some alternative page names, in this case
<a href='bs-rule.html'><code>bs-rule.html</code></a>.
These alternative names use dashes,
-replacing backslash with `<code>bs-</code>',
-replacing space with just a dash, `<code>-</code>',
-replacing @ with `<code>at-</code>',
-and replacing & with `<code>and-</code>'.
-An example is that you can reach the page describing
+replacing backslash with ‘<code>bs-</code>’,
+replacing space with just a dash, ‘<code>-</code>’,
+replacing @ with ‘<code>at-</code>’,
+and replacing & with ‘<code>and-</code>’.
+An example: you can reach the page describing
<code>\@startsection</code> with
<a href='bs-at-startsection.html'><code>bs-at-startsection.html</code></a>.
</p>
More information about the latexrefman-commits
mailing list.