more update suggestions

base/doc/ltnews38.tex

@@ -285,12 +285,12 @@ \section{Document properties and cross-referencing}
 properties of the document: the textual representations of the
 %% FMi added back in, be cause it is the "current", see Lamport:
 \emph{current
-page number} and the
+page number} and
 %%FMi from Lamport
 the \emph{current \textup{\cs{ref}} value} set by
 \cs{refstepcounter} declarations~\cite[p.~209]{38:Lamport}.
-(These declarations are issued by
-sectioning commands, by numbered environments, and by \cs{item} in an
+(These declarations are issued, for example, by
+sectioning commands, by numbered environments like \env{equation}, and by \cs{item} in an
 \env{enumerate} or a similar environment.)
 
 These two recorded values can then be accessed and typeset
@@ -394,7 +394,7 @@ \section{Document properties and cross-referencing}
 %%FMi changed:
 %\texttt{label} (the textual representation of the counter);
 \item[\texttt{label}] the textual representation of the \emph{current \textup{\cs{ref}} value}, see above;
-\item[\texttt{page}] the textual representation of the page;
+\item[\texttt{page}] the textual representation of the page number for the page currently under construction;
 \item[\texttt{title}] the title, if set by, e.g.,~\pkg{nameref};
 \item[\texttt{target}] the logical name of the associated link target, if set by,
 e.g.,~\pkg{hyperref};
@@ -404,7 +404,7 @@ \section{Document properties and cross-referencing}
 %% NOT as an Arabic number -- Arabic numbers are "something totally different"!!
 %%FMi changed:
 %\texttt{abspage} (the value of the \texttt{shipout count});
-\item[\texttt{abspage}] the current number of shipped out pages plus 1;
+\item[\texttt{abspage}] the absolute page number of the page under construction, i.e., number of already shipped out pages plus 1;
 %%FMi changed:
 %\texttt{counter}] (the name of the counter stepped in the (local) most recent \cs{refstepcounter});
 \item[\texttt{counter}] the name of the counter that produced the \emph{current \textup{\cs{ref}} value}, i.e.,