[latex3-commits] [git/LaTeX3-latex3-latex2e] starredrefs: resolve comments about text and typos [ci-skip] (a8933d6c)

[Ulrike Fischer]

Repository : https://github.com/latex3/latex2e
On branch  : starredrefs
Link       : https://github.com/latex3/latex2e/commit/a8933d6caed0e10fef0a2dc955ded56a50b7367a

>---------------------------------------------------------------

commit a8933d6caed0e10fef0a2dc955ded56a50b7367a
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Thu Apr 14 20:49:12 2022 +0200

    resolve comments about text and typos [ci-skip]


>---------------------------------------------------------------

a8933d6caed0e10fef0a2dc955ded56a50b7367a
 base/doc/ltnews35.tex | 12 +++++++-----
 base/ltxref.dtx       |  8 +++++---
 2 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/base/doc/ltnews35.tex b/base/doc/ltnews35.tex
index 8f7aac69..ab1554f1 100644
--- a/base/doc/ltnews35.tex
+++ b/base/doc/ltnews35.tex
@@ -457,13 +457,15 @@ lua.get_functions_table()
 
 \subsection{Starred command version for \cs{ref}, \cs{Ref} and \cs{pageref}}
 
-Since a long time \pkg{hyperref} provided starred versions for the reference commands
-that don't create active links. The different syntax required from users and package authors
-to check for \pkg{hyperref} if both types should be supported. The commands have now been aligned with
-the \pkg{hyperref} usage and allow an optional star. The \pkg{showkeys} package
+For a long time \pkg{hyperref} provides starred versions for the reference commands
+that don't create active links. This syntax extension required users and 
+package authors to check if \pkg{hyperref} was loaded and adjust the coding 
+accordingly or take the starrred forms out iff text was copied to a document 
+without \pkg{hyperref}. The commands have now been aligned with
+the \pkg{hyperref} usage and always allow an optional star. The \pkg{showkeys} package
 has been updated to handle the starred versions too, both with \pkg{hyperref} or \pkg{nameref}
 and without. The command are defined with \cs{NewDocumentCommand} and so no longer expand when
-written to auxiliary files. This reduce the number of compilations needed to resolve references
+written to auxiliary files. This reduces the number of compilations needed to resolve references
 in captions and sectioning commands. The package \pkg{ifthen} has been updated to ensure that
 \cs{pageref} can still be used inside tests like \cs{isodd}.
 
diff --git a/base/ltxref.dtx b/base/ltxref.dtx
index 8c387765..a7c5b102 100644
--- a/base/ltxref.dtx
+++ b/base/ltxref.dtx
@@ -71,8 +71,9 @@
 %
 %   |\ref|*\marg{foo}: value of most recently incremented referenceable
 %             counter. in the current environment. (Chapter, section,
-%             theorem and enumeration counters are
-%             referenceable, footnote counters are not.)
+%             theorem, footnote and enumeration counters and other counter
+%             stepped with |refstepcounter| are
+%             referenceable.)
 %
 %   |\pageref|*\marg{foo}: page number at which |\label{foo}|  command
 %             appeared.  where  foo  can be any string of characters not
@@ -89,7 +90,8 @@
 %  a space on either side.
 %
 %  Note: the starred version |\ref*| and |\pageref*| are provided
-%  to align with the of hyperref.
+%  to align with the use of hyperref. Without \pkg{hyperref} (or some
+%  other package using the starred form) it is simply ignored.
 %
 %
 % \MaybeStop{}