[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: Changes as suggested by David (3a04b8a1)

Joseph Wright joseph.wright at morningstar2.co.uk
Tue Apr 11 13:09:11 CEST 2023


Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/3a04b8a15c65f530ecdd36395887f2cb843d23da

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

commit 3a04b8a15c65f530ecdd36395887f2cb843d23da
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Tue Apr 11 12:08:34 2023 +0100

    Changes as suggested by David


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

3a04b8a15c65f530ecdd36395887f2cb843d23da
 base/doc/clsguide.tex | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/base/doc/clsguide.tex b/base/doc/clsguide.tex
index fbbf5bf3..1431678b 100644
--- a/base/doc/clsguide.tex
+++ b/base/doc/clsguide.tex
@@ -53,6 +53,7 @@
 \makeatletter
 \renewcommand \verbatim at font {\normalfont \ttfamily}
 \makeatother
+\providecommand\url[1]{\texttt{#1}}
 
 \begin{document}
 
@@ -68,7 +69,7 @@
 the \LaTeX{} team have worked on a number of ideas, firstly a programming
 language for \LaTeX{} (L3 programming layer) and then a range of tools for
 authors which build on that language. Here, we describe the current, stable set
-of tools provided by the \LaTeX{} kernel for packages and class developers. We
+of tools provided by the \LaTeX{} kernel for package and class developers. We
 assume familiarity with general \LaTeX{} usage as a document author, and that
 the material here is read in conjunction with \texttt{usrguide}, which provides
 information for general \LaTeX{} users on up-to-date approaches to creating
@@ -163,7 +164,8 @@ can I do to improve this?''
 
 \subsection{Command names}
 
-\LaTeX{} has three types of command.
+Prior to the introduction of the L3~programming layer described in the next
+section, \LaTeX{} had three types of command.
 
 There are the author commands, such as |\section|, |\emph| and
 |\times|:  most of these have short names, all in lower case.
@@ -214,7 +216,7 @@ introduction to the approach is provided at
 Even if you do not intend to use color in your own documents, by taking note of
 the points in this section you can ensure that your class or package is
 compatible with the |color| package. This may benefit people using your class
-or package who have access to color printers.
+or package and wish to use color.
 
 The simplest way to ensure `color safety' is to always use \LaTeX{} box
 commands rather than \TeX{} primitives, that is use |\sbox| rather than
@@ -279,9 +281,6 @@ then the user will get a warning:
                   but the package provides `baz'.
 \end{verbatim}
 Thus, for several reasons, using |\input| to load packages is not a good idea.
-Unfortunately, if you are upgrading the file |myclass.sty| to a class file then
-you have to make sure that any old files which contain |\input myclass.sty|
-still work.
 
 For example, |article.sty| contains just the following lines:
 \begin{verbatim}
@@ -303,7 +302,7 @@ interfaces |\NewDocumentCommand|, etc. (see \texttt{usrguide} for details of
 these commands).
 
 When you define an environment, use |\NewDocumentEnvironment|, etc., (or
-|\newenvironment|, etc., for simple cases) instead |\def\foo{...}| and
+|\newenvironment|, etc., for simple cases) instead of using |\def\foo{...}| and
 |\def\endfoo{...}|.
 
 If you need to set or change the value of a \m{dimen} or \m{skip} register, use
@@ -333,10 +332,10 @@ avoid every University having its own thesis class, all called |thesis.cls|.
 
 If you rely on some features of the \LaTeX{} kernel, or on a package,
 please specify the release-date you need.  For example, the package
-error commands were introduced in the June 1994 release so, if you use
+error commands were introduced in the June 2022 release so, if you use
 them then you should put:
 \begin{verbatim}
-   \NeedsTeXFormat{LaTeX2e}[1994-06-01]
+   \NeedsTeXFormat{LaTeX2e}[2022-06-01]
 \end{verbatim}
 
 \subsubsection{Useful hooks}





More information about the latex3-commits mailing list.