[latex3-commits] [latex3/latex2e] ltproperties: small corrections from review (060fcf71)
github at latex-project.org
github at latex-project.org
Mon Sep 11 13:14:25 CEST 2023
Repository : https://github.com/latex3/latex2e
On branch : ltproperties
Link : https://github.com/latex3/latex2e/commit/060fcf71c8771f012e988f711cd1d3089b481ab2
>---------------------------------------------------------------
commit 060fcf71c8771f012e988f711cd1d3089b481ab2
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date: Mon Sep 11 13:14:25 2023 +0200
small corrections from review
>---------------------------------------------------------------
060fcf71c8771f012e988f711cd1d3089b481ab2
base/doc/ltnews38.tex | 12 ++++++------
base/ltproperties.dtx | 32 ++++++++++++++++----------------
2 files changed, 22 insertions(+), 22 deletions(-)
diff --git a/base/doc/ltnews38.tex b/base/doc/ltnews38.tex
index c249e76f..4bca15f3 100644
--- a/base/doc/ltnews38.tex
+++ b/base/doc/ltnews38.tex
@@ -152,9 +152,9 @@ For documentation see \texttt{texdoc ltsockets-doc} for now.
Traditionally \LaTeX{} allowed with \cs{label} to record two \enquote{local}
properties of the document: the representation of the current page number and
-of the current counter. Their values could then be referenced with the (not
-expandable) commands \cs{ref} and \cs{pageref} in arbitrary places of a
-document. With the summer release 2023 the \cs{label} was enhanced to record
+of the current counter. Their values could then be referenced with the
+(non-expandable) commands \cs{ref} and \cs{pageref} in arbitrary places of a
+document. With the summer 2023 release the \cs{label} was enhanced to record
also if set by packages like \pkg{nameref} or \pkg{hyperref} the title and
the name of the link target.
@@ -194,14 +194,14 @@ two arguments, the label and the property:
The new module predeclares a set of generally useful properties:
\texttt{currentlabel} (the standard counter representation), \texttt{page}
-(the page representation), \texttt{title} (the title if set e.g. by
-\pkg{nameref}), \texttt{target} (the name of the link target if set e.g. by
+(the page representation), \texttt{title} (the title if set e.g.~by
+\pkg{nameref}), \texttt{target} (the name of the link target if set e.g.~by
\pkg{hyperref}), \texttt{pagenum} (the page as an arabic number),
\texttt{abspage} (the absolute page number), \texttt{counter} (the name of
the current counter), \texttt{xpos} and \texttt{ypos} the position on the
page as set by a previous \cs{pdfsavepos}.
-The module provides both \LaTeX2e camel case commands and expl3 commands.
+The module provides both \LaTeXe{} camel case commands and expl3 commands.
For documentation see \texttt{texdoc ltproperties-doc}.
diff --git a/base/ltproperties.dtx b/base/ltproperties.dtx
index 3ced0218..b92875b6 100644
--- a/base/ltproperties.dtx
+++ b/base/ltproperties.dtx
@@ -2,7 +2,7 @@
%
%% File: ltproperties.dtx
%
-% Copyright (C) 2021-2023 The LaTeX3 Project
+% Copyright (C) 2021-2023 The LaTeX Project
%
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
@@ -22,7 +22,7 @@
%
% for those people who are interested.
% \begin{macrocode}
-\def\ltpropertiesversion{0.9a}
+\def\ltpropertiesversion{1.0a}
\def\ltpropertiesdate{2023-09-05}
% \end{macrocode}
@@ -103,9 +103,9 @@
% text} not keyvals: this avoids any restrictions on names and again offers
% increased performance.
%
-% The expl3 versions of the label command do not
+% The \pkg{expl3} versions of the label command do not
% use \cs{@bsphack}/\cs{@esphack} to avoid double spaces,
-% but the \LaTeX2e command does as it lives at the document command level.
+% but the \LaTeXe{} command does as it lives at the document command level.
%
% The reference commands are expandable.
%
@@ -137,7 +137,7 @@
%
% \section{Rerun messages}
%
-% As the reference commands are expandable they can't neither issue a message that
+% As the reference commands are expandable they can neither issue a message that
% the label or the label-property combination is unknown, nor can they trigger the
% rerun message at the end of the \LaTeX{} run.
%
@@ -150,8 +150,7 @@
% \begin{itemize}
% \item The \texttt{xpos} and \texttt{ypos} properties require that the position is
% stored first but there is no (public) engine independent interface yet. Code must
-% use either \cs{tex_savepos:D} or \cs{pdfsavepos} (pdftex,xetex)
-% or \cs{savepos} (luatex).
+% use \cs{tex_savepos:D}.
% \end{itemize}
%
% \section{Code interfaces}
@@ -161,7 +160,7 @@
% \cs{property_new:nnnn} \Arg{property} \Arg{setpoint} \Arg{default} \Arg{code}
% \cs{property_gset:nnnn} \Arg{property}\Arg{setpoint} \Arg{default} \Arg{code}
% \end{syntax}
-% \LaTeX2e-interface: see \cs{NewProperty}, \cs{SetProperty}.\\
+% \LaTeXe-interface: see \cs{NewProperty}, \cs{SetProperty}.\\
% Sets the \meta{property} to have the \meta{default} specified, and at the
% \meta{setpoint} (either |now| or |shipout|) to write the result of the
% \meta{code} as part of a label. The \meta{code} should be expandable. The expansion
@@ -404,7 +403,7 @@
% \begin{variable}{title}
% (now) The content of \cs{@currentlabelname}.
% This command is filled beside others by the \pkg{nameref} package and some
-% classes (e.g. \pkg{memoir}).
+% classes (e.g.~\pkg{memoir}).
% \end{variable}
%
% \begin{variable}{target}
@@ -419,9 +418,9 @@
% \end{variable}
%
% \begin{variable}{xpos,ypos}
-% (shipout) This stores the x and y coordinates of a point previously
+% (shipout) This stores the $x$~and $y$ coordinates of a point previously
% stored with \cs{pdfsavepos}/\cs{savepos}.
-% E.g. (if bidi is used it can be necessary to save the position
+% E.g.~(if bidi is used it can be necessary to save the position
% before and after the label):
% \begin{verbatim}
% \tex_savepos:D
@@ -485,7 +484,7 @@
}
\cs_new_protected:Npn \property_gset:nnnn #1#2#3#4
{
- \exp_args:Nx \@@_gset:nnnn { \tl_to_str:n {#1} }
+ \@@_gset:xnnn { \tl_to_str:n {#1} }
{#2} {#3} {#4}
}
\cs_new_protected:Npn \@@_gset:nnnn #1#2#3#4
@@ -503,6 +502,7 @@
}
{ \msg_error:nnnn { property } { unknown-setpoint } {#1} {#2} }
}
+\cs_generate_variant:Nn \@@_gset:nnnn {xnnn}
% \end{macrocode}
% \end{macro}
%
@@ -746,7 +746,7 @@
%
% \begin{macro}[pTF]{\property_if_recorded:nn}
% tests if the label/property combination has been set
-% This can then be used to setup e.g. rerun messages.
+% This can then be used to setup e.g.~rerun messages.
% \begin{macrocode}
\prg_new_conditional:Npnn \property_if_recorded:nn #1#2 { p , T , F, TF }
% #1 label #2 property
@@ -871,7 +871,7 @@
% \subsection{Messages}
% \begin{macrocode}
\msg_new:nnnn { property } { exists }
- { property~'#1'~ has~ already~ been~ declared. }
+ { Property~'#1'~ has~ already~ been~ declared. }
{ There~ already~ exists~ a~ property~ declaration~ with~ this~
name.\\
Please~ use~ a~ different~ name~ for~ your~ property.}
@@ -883,10 +883,10 @@
name~has~not~been~declared.
}
\msg_new:nnnn { property } { unknown-setpoint }
- { Unknown~keyword~'#3'~for~setting~property~'#1'. }
+ { Unknown~keyword~'#2'~for~setting~property~'#1'. }
{
LaTeX~has~been~asked~to~set~the~property~'#1',~but~the~keyword~
- '#3'~is~not~one~of~the~two~known~values:~'now'~or~'shipout'.
+ '#2'~is~not~one~of~the~two~known~values:~'now'~or~'shipout'.
}
% \end{macrocode}
%
More information about the latex3-commits
mailing list.