[latex3-commits] [latex3/latex2e] If-X-TF: Re-phrase various blocks of text (6be635f8)

[github at latex-project.org]

Repository : https://github.com/latex3/latex2e
On branch  : If-X-TF
Link       : https://github.com/latex3/latex2e/commit/6be635f82f4718d8b41391ef03711527a207f450

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

commit 6be635f82f4718d8b41391ef03711527a207f450
Author: Joseph Wright <joseph at texdev.net>
Date:   Mon Sep 2 13:02:46 2024 +0100

    Re-phrase various blocks of text


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

6be635f82f4718d8b41391ef03711527a207f450
 base/doc/clsguide.tex | 38 ++++++++++++++++++++------------------
 1 file changed, 20 insertions(+), 18 deletions(-)

diff --git a/base/doc/clsguide.tex b/base/doc/clsguide.tex
index 9106d055..b0a948b4 100644
--- a/base/doc/clsguide.tex
+++ b/base/doc/clsguide.tex
@@ -395,7 +395,7 @@ The \m{date} should be given in the form `\textsc{yyyy-mm-dd}' or
 Exactly four digits are required for the year and two each for the month and
 day. Where necessary, zeros should be added to pad the month and day
 appropriately. If digits or separators are missing, the date will likely be
-misinterpreted: the commands expect a valid syntax to speed up the daily usage
+misinterpreted: the commands expect a valid syntax to speed up the routine usage
 of the package or class and make no provision for the case that the developer
 made a mistake!
 
@@ -678,7 +678,8 @@ This command tells \TeX{} that this file should be processed using a format
 with name \m{format-name}. You can use the optional argument \m{release-date}
 to further specify the earliest release date of the format that is needed. When
 the release date of the format is older than the one specified a warning will
-be generated. The standard \m{format-name} is \texttt{LaTeX2e}. The date, if
+be generated. The standard \m{format-name} is \texttt{LaTeX2e}. The
+\meta{release-date}, if
 present, must be in the form `\textsc{yyyy-mm-dd}' or
 `\textsc{yyyy/mm/dd}'.
 
@@ -989,7 +990,7 @@ release and other related ideas. Three forms of each test are provided, one
 requiring arguments for both \meta{true} and \meta{false} branches, one
 requiring only a \meta{true} branch and one requiring only a \meta{false}
 branch. These are indicated in their names as |TF|, |T| and |F|, respectively.
-Here, we document only the |TF| versions: the other forms are however
+Here, we document only the |TF| versions: the other forms are however also
 available.
 
 \begin{decl}
@@ -997,36 +998,37 @@ available.
   |\IfClassLoadedTF| \arg{class-name} \arg{true code} \arg{false code}\\
   |\IfFileLoadedTF| \arg{file-name} \arg{true code} \arg{false code}
 \end{decl}
-These commands test whether the named package, class or file is loaded: this
-requires that this information is available in an appropriate |\Provides...|
-line, as described in Section~\ref{sec:ID}. In the case of \cs{IfFileLoadedTF},
-the full \meta{file-name} must be provided; in contrast, no extension should be
-given if testing for a package or class.
+These commands test whether the named package, class or file is loaded: this is
+done by using information that must be contained in an appropriate
+|\Provides...| line, as described in Section~\ref{sec:ID}. In the case of
+\cs{IfFileLoadedTF}, the full \meta{file-name} must be provided; in contrast,
+no extension should be given if testing for a package or class.
 
 \begin{decl}
   |\IfPackageLoadedWithOptionsTF| \arg{package-name} \arg{options} \arg{true code} \arg{false code}\\
   |\IfClassLoadedOptionsTF| \arg{class-name} \arg{options} \arg{true code} \arg{false code}
 \end{decl}
-These commands test if the named package or class was loaded with
-\emph{exactly} the \meta{options} specified. Thus the package or class must be
-loaded (giving a \texttt{true} result for \cs{If...LoadedT}) and the option
-list used when loading it must be identifical to the \meta{options}.
+These commands test whether the named package or class has been loaded with
+\emph{exactly} the \meta{options} specified. In order to take the \meta{true}
+branch, the package or class must be loaded (giving a \meta{true} result for
+\cs{If...LoadedT}) and the option list used when loading it must be identical
+to the \meta{options}.
 
 \begin{decl}
   |\IfPackageAtLeastTF| \arg{package-name} \arg{date} \arg{true code} \arg{false code}\\
   |\IfClassAtLeastTF| \arg{class-name} \arg{date} \arg{true code} \arg{false code}\\
   |\IfFileAtLeastTF| \arg{file-name} \arg{date} \arg{true code} \arg{false code}
 \end{decl}
-These tests are used to check wheteher the date information given in the
-|\Provides...| line of a package or class is least a given \meta{date}.
-The \meta{date} is compared with that in the
+These tests are used to check whether the date information given in the
+|\Provides...| line of a package, class or file is no earlier than the given
+\meta{date}. The \meta{date} is compared with that in the
 optional argument to \cs{Provides...} (as described in Section~\ref{sec:ID});
-if \cs{Provides...} was missing or had no optional argument, the reference
-date is treated as |0000/00/00|.
+if \cs{Provides...} was missing or had no optional argument, it is treated
+as |0000/00/00| (i.e.~earlier than any other date).
 As for \cs{Provides...}, the \meta{date} should be given in the form
 `\textsc{yyyy-mm-dd}' or `\textsc{yyyy/mm/dd}'. If the package, class or file is not
 loaded, the \meta{false} branch will be taken; in contrast, if the \meta{date}
-is not of the required form, the behavior is formally undefined.
+is not given in the required form, the behavior is formally undefined.
 
 \begin{decl}
   |\IfFormatAtLeastTF| \arg{date} \arg{true code} \arg{false code}