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

[Vincent Bela?che]

Author: vincentb1
Date: 2023-11-11 05:41:00 +0000 (Sat, 11 Nov 2023)
New Revision: 1165

Modified:
   trunk/ChangeLog
   trunk/latex2e.texi
Log:
[en] A few fixes related to footnotes + @c xx additions.

* latex2e.texi (\footnote): Add ``@c xx'' comment suggesting
propagating improvement from the French version.
Grammar fix ``is'' -> ``are''.
Insert explanatory LaTeX comments to the \footnoterule
\renewcommand example, and star the \renewcommand.
(\footnotemark): Typo ``by-hand giving'' -> ``by hand-giving''.
Move the ``footnoteValueSaver'' counter example after the next
example in order not to interleave it in between two related examples.
(Footnotes in section headings): Add ``@c xx'' comment indicating
need for handling the \listoftable/\listoffigures case.


Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2023-10-19 21:58:23 UTC (rev 1164)
+++ trunk/ChangeLog	2023-11-11 05:41:00 UTC (rev 1165)
@@ -1,8 +1,21 @@
+2023-11-11  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
+	* latex2e.texi (\footnote): Add ``@c xx'' comment suggesting
+	propagating improvement from the French version.
+	Grammar fix ``is'' -> ``are''.
+	Insert explanatory LaTeX comments to the \footnoterule
+	\renewcommand example, and star the \renewcommand.
+	(\footnotemark): Typo ``by-hand giving'' -> ``by hand-giving''.
+	Move the ``footnoteValueSaver'' counter example after the next
+	example in order not to interleave it in between two related examples.
+	(Footnotes in section headings): Add ``@c xx'' comment indicating
+	need for handling the \listoftable/\listoffigures case.
+
 2023-10-19  Karl Berry  <karl at freefriends.org>
 
 	* latex2e.texi (itemize): remove extra } in itemize* example.
 	Report from Stefan Pofahl, 18 Oct 2023 23:48:38.
-	
+
 	* latex2e.texi: fix most menus per texinfo 7.1 warnings.
 
 2023-10-11  Karl Berry  <karl at freefriends.org>

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2023-10-19 21:58:23 UTC (rev 1164)
+++ trunk/latex2e.texi	2023-11-11 05:41:00 UTC (rev 1165)
@@ -9174,6 +9174,8 @@
 \footnote[@var{number}]@{@var{text}@}
 @end example
 
+ at c xx In the French version the text is : ``Place a footnote mark in the
+ at c current page to a note @var{text} at the bottom of the page''.
 Place a footnote @var{text} at the bottom of the current page.
 
 @example
@@ -9210,13 +9212,16 @@
 @anchor{footnote footnoterule}
 Produces the rule separating the main text on a page from the page's
 footnotes.  Default dimensions in the standard document classes (except
- at code{slides}, where it does not appear) is: vertical thickness of
+ at code{slides}, where it does not appear) are: vertical thickness of
 @code{0.4pt}, and horizontal size of @code{0.4\columnwidth} long.
 Change the rule with something like this.
 
 @c Credit egreg: https://tex.stackexchange.com/a/21917
 @example
-\renewcommand@{\footnoterule@}@{% Kerns avoid vertical space
+% \footnoterule is expanded in vertical mode, thus \kern commands
+% ensure that no vertical space is created, and the rule is separated
+% vertically 2pt above the note text
+\renewcommand*@{\footnoterule@}@{%
   \kern -3pt                         % This -3 is negative
   \hrule width \textwidth height 1pt % of the sum of this 1
   \kern 2pt@}                         % and this 2
@@ -9283,7 +9288,7 @@
 If there are intervening footnotes then you must remember the value of
 the number of the common mark.  This example gives the same
 institutional affiliation to both the first and third authors
-(@code{\thanks} is a version of @code{\footnote}), by-hand giving the
+(@code{\thanks} is a version of @code{\footnote}), by hand-giving the
 number of the footnote.
 
 @example
@@ -9295,19 +9300,6 @@
 \maketitle
 @end example 
 
-This uses a counter to remember the footnote number.  The third sentence
-is followed by the same footnote marker as the first.
-
- at example
-\newcounter@{footnoteValueSaver@}
-All babies are illogical.\footnote@{%
-  Lewis Carroll.@}\setcounter@{footnoteValueSaver@}@{\value@{footnote@}@}
-Nobody is despised who can manage a crocodile.\footnote@{%
-  Captain Hook.@}
-Illogical persons are despised.\footnotemark[\value@{footnoteValueSaver@}]
-Therefore, anyone who can manage a crocodile is not a baby.
- at end example
-
 @PkgIndex{cleveref}
 @PkgIndex{hyperref}
 This example accomplishes the same by using the package @package{cleveref}.
@@ -9325,7 +9317,20 @@
 @PkgIndex{hyperref}
 It will work with the package @package{hyperref}.
 
+This uses a counter to remember the footnote number.  The third sentence
+is followed by the same footnote marker as the first.
 
+ at example
+\newcounter@{footnoteValueSaver@}
+All babies are illogical.\footnote@{%
+  Lewis Carroll.@}\setcounter@{footnoteValueSaver@}@{\value@{footnote@}@}
+Nobody is despised who can manage a crocodile.\footnote@{%
+  Captain Hook.@}
+Illogical persons are despised.\footnotemark[\value@{footnoteValueSaver@}]
+Therefore, anyone who can manage a crocodile is not a baby.
+ at end example
+
+
 @node \footnotetext
 @section @code{\footnotetext}
 
@@ -9366,6 +9371,8 @@
 contents, where it is not likely to be desired.  The simplest way
 to have it not appear on the table of contents is to use the optional
 argument to @code{\section}
+ at c xx Same issue with table/figure captions and
+ at c \listoftable/\listoffigures, and same sort of fix can be used.
 
 @example
 \section[Please]@{Please\footnote@{%