[latexrefman-commits] [SCM] latexrefman updated: r1158 - trunk

Mon Aug 28 03:05:56 CEST 2023

Author: karl
Date: 2023-08-28 01:05:56 +0000 (Mon, 28 Aug 2023)
New Revision: 1158

Modified:
   trunk/ChangeLog
   trunk/Makefile
   trunk/NEWS
   trunk/latex2e.texi
Log:
\thepage simplification; check menu structure in makeinfo 7.0.3

Modified: trunk/ChangeLog
===================================================================

--- trunk/ChangeLog	2023-07-19 17:32:32 UTC (rev 1157)
+++ trunk/ChangeLog	2023-08-28 01:05:56 UTC (rev 1158)
@@ -1,3 +1,12 @@
+2023-08-27  Karl Berry  <karl at freefriends.org>
+
+	* latex2e.texi (\thepage): simplify, as it turns out that
+	TUGboat's attempted complicated redefinition does not work well.
+	
+	* Makefile (htmlopts): add -c CHECK_NORMAL_MENU_STRUCTURE=1
+	for makeinfo 7.0.3 to emit warnings about menu problems.
+	Should be re-enabled by default in the next release.
+
 2023-07-19  Karl Berry  <karl at freefriends.org>
 
 	* Makefile (svri): rename svrsplit; mention for post-web cleanup.

Modified: trunk/Makefile
===================================================================
--- trunk/Makefile	2023-07-19 17:32:32 UTC (rev 1157)
+++ trunk/Makefile	2023-08-28 01:05:56 UTC (rev 1158)
@@ -29,17 +29,25 @@
 texi2txt = $(makeinfo) --plaintext --no-split
 texi2xml = $(makeinfo) --xml
 #
-htmlopts = --html $(html_css) $(t2html_top) $(t2html_home) $(html_pagewords)
+htmlopts = --html $(html_css) $(t2html_config)
 #
 html_css = --css-include=latex2e.css
 #
-# Nodes must be larger than this to get navigation panel at bottom of
-# page; default is 300.
-html_pagewords = -c WORDS_IN_PAGE=10000
+t2html_config = $(t2html_top) $(t2html_pagewords) $(t2html_menu) $(t2html_home)
 #
 # Go somewhere useful from Top:
 t2html_top = -c TOP_NODE_UP_URL=https://tug.org/texinfohtml/
 #
+# Nodes must be larger than this to get navigation panel at bottom of
+# page; default is 300.
+t2html_pagewords = -c WORDS_IN_PAGE=10000
+#
+# For makeinfo 7.0.3, need this to get warning when menu structure gets
+# messed up. The warning will again be enabled by default in the next release.
+t2html_menu = -c CHECK_NORMAL_MENU_STRUCTURE=1
+# Incidentally, a tree transformation can generate missing menu entries:
+#   -c TREE_TRANSFORMATIONS=complete_tree_nodes_menus file.texi
+#
 # Put a link in the footer:
 t2html_home = -c PRE_BODY_CLOSE="<hr/><div class='referenceinfo'>\
 <a href='https://latexref.xyz/'>\

Modified: trunk/NEWS
===================================================================
--- trunk/NEWS	2023-07-19 17:32:32 UTC (rev 1157)
+++ trunk/NEWS	2023-08-28 01:05:56 UTC (rev 1158)
@@ -7,7 +7,7 @@
 Updates are welcome.
 
 Additions:
-* \thepage page number representation.
+* \thepage for page number representation.
 * \nobreakspace and U+00A0 synonyms for ties.
 * The (simple) \slash command.
 

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2023-07-19 17:32:32 UTC (rev 1157)
+++ trunk/latex2e.texi	2023-08-28 01:05:56 UTC (rev 1158)
@@ -107,21 +107,22 @@
 href="https://latexref.xyz/">separate web pages for each section or
 subsection</a>.  It's also available as a <a
 href="https://latexref.xyz/dev/latex2e.html">single web page</a> and as
-a <a href="https://latexref.xyz/dev/latex2e.pdf">pdf</a>.  Note that
-there is also a separately-maintained <a
-href="https://latexref.xyz/fr/">French edition</a>.</p>
+a <a href="https://latexref.xyz/dev/latex2e.pdf">pdf</a>.
+Translations to French and Spanish are available at
+ at url{https://ctan.org/pkg/latex2e-help-texinfo}; they're maintained
+separately.
 
 <p> This document is not official.  It has not been reviewed by the
-LaTeX maintainers.  Our goal is to cover all (non-private) LaTeX
-commands.  Your comments and contributions, including bug reports, are
-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/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 -->
+LaTeX maintainers.  Our ultimate goal is to cover all (non-private)
+LaTeX commands.  Your comments and contributions, including bug
+reports, are 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/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
 
 @titlepage
@@ -15358,48 +15359,13 @@
 @code{\thepage}, which is the command @LaTeX{} uses for the
 representation of page numbers.
 
-For example, for the @cite{TUGboat} journal
-(@url{https://tug.org/TUGboat}), we often circulate draft versions of
-articles.  For this, we change the page numbering to start at 901, but
-want to print the page numbers with a `?', as in printing `?1' for the
-first page. This helps avoid people from thinking that the page
-numbers are final. We want the `?'@ to appear in the table of contents
-and cross-references as well as the headers; therefore, we redefine
- at code{\thepage}:
+However, @code{\thepage} should do any typesetting or other
+complicated maneuvers, but merely expand to the intended page number
+representation.  The results of a complicated redefinition of
+ at code{\thepage} are not predictable, but @LaTeX{}'s report of page
+numbers in diagnostic messages, at least, will become unusable.
 
- at example
-\renewcommand\thepage@{%
-  \ifnum\value@{page@}>900
-    % In CM, numerals are exactly .5em,
-    % so make our `?' have that width too.
-    % The \texorpdfstring avoids the hyperref warning:
-    %   Token not allowed in a PDF string ... removing `\@@ifnextchar' 
-    \texorpdfstring@{\makebox[.5em][l]@{\small ?@}@}@{?@}%
-    %
-    \textsl@{\@@arabic@{\numexpr\value@{page@}-900\relax@}@}% assume e-TeX
-  \else
-    \@@arabic@{\value@{page@}@}%
-  \fi
-@}
- at end example
-
- at cindex @command{makeindex} and special page numbers
-
-There is another complication.  Changing @code{\thepage} will probably
-break @command{makeindex}, since it only understands a few kinds of
-basic counter representations.  Thus, a method to extract a standard
-integer from the document's special representation has to be
-provided. Continuing our @cite{TUGboat} example:
-
- at example
-\usepackage@{index@}
-...
-\newcommand\specialthepage@{\inteval@{\value@{page@}-900@}@}
-\newindex[specialthepage]*@{default@}@{idx@}@{ind@}@{Index@}
- at end example
-
-Thanks to Ulrike Fischer for providing this code.
-There is more discussion at
+There is some discussion of this issue at
 @url{https://tex.stackexchange.com/questions/687258}.
 
 @node Spaces

