diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/base/ltdefns.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/base/ltdefns.dtx | 132 |
1 files changed, 66 insertions, 66 deletions
diff --git a/Master/texmf-dist/source/latex/base/ltdefns.dtx b/Master/texmf-dist/source/latex/base/ltdefns.dtx index d6a51b6ea36..5bec77aebdf 100644 --- a/Master/texmf-dist/source/latex/base/ltdefns.dtx +++ b/Master/texmf-dist/source/latex/base/ltdefns.dtx @@ -2,29 +2,29 @@ % % Copyright 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 % The LaTeX3 Project and any individual authors listed elsewhere -% in this file. -% +% in this file. +% % This file is part of the LaTeX base system. % ------------------------------------------- -% +% % It may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3c % of this license or (at your option) any later version. % The latest version of this license is in % http://www.latex-project.org/lppl.txt -% and version 1.3c or later is part of all distributions of LaTeX +% and version 1.3c or later is part of all distributions of LaTeX % version 2005/12/01 or later. -% +% % This file has the LPPL maintenance status "maintained". -% +% % The list of all files belonging to the LaTeX base distribution is % given in the file `manifest.txt'. See also `legal.txt' for additional % information. -% -% The list of derived (unpacked) files belonging to the distribution -% and covered by LPPL is defined by the unpacking scripts (with +% +% The list of derived (unpacked) files belonging to the distribution +% and covered by LPPL is defined by the unpacking scripts (with % extension .ins) which are part of the distribution. -% +% % \fi % % \iffalse @@ -56,23 +56,23 @@ % \CheckSum{746} % % \changes{v1.0n}{1994/05/10}{(ASAJ) Added -% \cs{DeclareProtectedCommand}.} +% \cs{DeclareProtectedCommand}.} % \changes{v1.0p}{1994/05/12}{(ASAJ) Fixed a bug with \cs{relax} -% which was +% which was % using \cs{@gobble} before defining it.} % \changes{v1.0q}{1994/05/13}{(ASAJ) Renamed -% \cs{DeclareProtectedCommand} to -% \cs{DeclareRobustCommand}. Removed \cs{@if@short@command}.} +% \cs{DeclareProtectedCommand} to +% \cs{DeclareRobustCommand}. Removed \cs{@if@short@command}.} % \changes{v1.0q}{1994/05/13}{(ASAJ) Replaces \cs{space} by `~' in -% \cs{csname}.} +% \cs{csname}.} % \changes{v1.0r}{1994/05/13}{(ASAJ) Added logging message to -% \cs{DeclareProtectedCommand}.} +% \cs{DeclareProtectedCommand}.} % \changes{v1.0s}{1994/05/13}{(ASAJ) Added \cs{@backslashchar}.} % \changes{v1.0s}{1994/05/13}{(ASAJ) Coded \cs{@ifdefinable} more -% efficiently.} +% efficiently.} % \changes{v1.1a}{1994/05/16}{(ASAJ) Split from ltinit.dtx.} % \changes{v1.1b}{1994/05/17}{(ASAJ) Removed warnings and logging to -% lterror.dtx.} +% lterror.dtx.} % \changes{v1.1b}{1994/05/17}{(ASAJ) Added definitions for protect.} % \changes{v1.1c}{1994/05/17}{(ASAJ) Redid definitions for protect.} % \changes{v1.1d}{1994/05/19}{(RmS) Added definitions for @@ -88,11 +88,11 @@ % \changes{v1.0g}{1994/11/17} % {\cs{@tempa} to \cs{reserved@a}} % \changes{v1.0p}{1995/07/13}{Updates to documentation} -% +% % \section{Definitions} % % This section contains commands used in defining other macros. -% +% % \StopEventually{} % % \begin{macrocode} @@ -173,12 +173,12 @@ % The redefinition (via |\let|) of |\-| within tabbing also makes the % use of a robust command advisable since then any redefinition % of |\-| via |\DeclareRobustCommand| will not cause a conflict. -% +% % Therefore, macro writers should be hereby warned that % these internals will probably change! It is likely that a future % release of \LaTeX{} will make |\-| effectively an encoding specific % text command. -% +% % \begin{macrocode} \let\@@hyph=\- % Save original primitive definition \def\-{\discretionary{-}{}{}} @@ -209,7 +209,7 @@ % \changes{LaTeX2e}{1993/11/22}{Macro added} % \begin{macro}{\@plus} % \changes{LaTeX2e}{1993/11/22}{Macro added} -% +% % The following definitions save token space. E.g., using % |\@height| instead of height saves 5 tokens at the cost in time % of one macro expansion. @@ -240,7 +240,7 @@ % This section defines the following commands: % % \DescribeMacro -% {\@namedef}\marg{NAME}\\ Expands to |\def\|\marg{NAME}, +% {\@namedef}\marg{NAME}\\ Expands to |\def\|\marg{NAME}, % except name can contain any characters. % % \DescribeMacro @@ -250,7 +250,7 @@ % \DescribeMacro % {\@ifnextchar} X\marg{YES}\marg{NO}\\ % Expands to \meta{YES} if next character is an `X', -% and to \meta{NO} otherwise. +% and to \meta{NO} otherwise. % (Uses |\reserved@a|--|\reserved@c|.) % NOTE: GOBBLES ANY SPACE FOLLOWING IT. % @@ -329,7 +329,7 @@ % instead of executing it. % % \changes{LaTeX209}{1992/03/18} -% {(RMS) changed input channel from 0 to \cs{@inputcheck} to avoid +% {(RMS) changed input channel from 0 to \cs{@inputcheck} to avoid % conflicts with other channels allocated by \cs{newread}} % % \begin{macro}{\typein} @@ -493,7 +493,7 @@ % \changes{v1.2q}{1995/10/02} % {Add \cs{aut@global} in autoload version} % \changes{v1.2z2}{1998/03/04} -% {Unnecessary \cs{expandafter} removed: pr/2758} +% {Unnecessary \cs{expandafter} removed: pr/2758} % \begin{macrocode} %<autoload>\aut@global \expandafter\def\expandafter#1\expandafter{% @@ -530,7 +530,7 @@ % be followed by |[|. If this command were only used in |\newcommand| % definitions then |#1| would be a single token and the braces could % be omitted from |{#1}| in the definition below, saving a bit of -% memory. +% memory. % \changes{v1.1g}{2004/01/23}{Use kernel version of % \cs{@ifnextchar} (pr/3501)} % \begin{macrocode} @@ -545,7 +545,7 @@ % Robust version of |\@testopt|. The extra argument (|#1|) must be a % single token. If protection is needed the call expands to |\protect| % applied to this token, and the 2nd and 3rd arguments are -% discarded (by |\@x@protect|). Otherwise |\@testopt| is called on +% discarded (by |\@x@protect|). Otherwise |\@testopt| is called on % the 2nd and 3rd arguments. % % This method of making commands robust avoids the need for using up @@ -564,9 +564,9 @@ % \begin{macro}{\@yargdef} % \begin{macro}{\@yargd@f} % \changes{v1.3f}{1999/04/29}{New macro added} -% -% \changes{LaTeX2e}{1993/11/23}{Macro interface changed} -% \changes{LaTeX2e}{1993/11/23}{Avoid \cs{@?@?} token} +% +% \changes{LaTeX2e}{1993/11/23}{Macro interface changed} +% \changes{LaTeX2e}{1993/11/23}{Avoid \cs{@?@?} token} % \changes{v1.0b}{1994/03/12}{Name changed from \cs{XXX@argdef}} % \changes{v1.3c}{1999/01/18}{New implementation DPC /2942} % \changes{v1.3d}{1999/02/09}{catch bad argument forms by re-inserting \#3} @@ -580,7 +580,7 @@ % Reorganised slightly so that |\renewcommand{\reserved@a}[1]{foo}| % works. I am not sure this is worth it, as a following % |\newcommand| would over-write the definition of |\reserved@a|. -% +% % Recall that \LaTeX2.09 goes into an infinite loop with % |\renewcommand[1]{\@tempa}{foo}| (DPC 6 October 93). % @@ -595,7 +595,7 @@ % this argument and use of) |\number| was added later in 1999. % % It is not clear why these are still |\long|. -% +% % \begin{macrocode} \long \def \@yargdef #1#2#3{% \ifx#2\tw@ @@ -607,7 +607,7 @@ \@yargd@f \expandafter{\number #3}#1% } % \end{macrocode} -% +% % The |\aut@global| command below is only used in the autoload % format. If it is |\global| then a global definition will be made. % \changes{v1.2q}{1995/10/02} @@ -621,7 +621,7 @@ \l@ngrel@x \reserved@a 0##1##2##3##4##5##6##7##8##9###1% } % \end{macrocode} -% +% % \end{macro} % \end{macro} % @@ -652,7 +652,7 @@ % \changes{v1.2y}{1996/07/26}{use \cs{relax} in place of empty arg} % \changes{v1.2y}{1996/07/26}{use \cs{noexpand} instead of \cs{string}} % \changes{v1.2z1}{1997/10/21}{Use \cs{begingroup}/\cs{endgroup} rather -% than braces for grouping, to avoid generating empty math atom.} +% than braces for grouping, to avoid generating empty math atom.} % \begin{macrocode} \def\renew@command#1{% \begingroup \escapechar\m@ne\xdef\@gtempa{{\string#1}}\endgroup @@ -691,7 +691,7 @@ % \end{macrocode} % Version of |\@ifdefinable| for use with |\renewcommand|. Does % not do the check this time, but restores the normal definition. -% \begin{macrocode} +% \begin{macrocode} \long\def\@rc@ifdefinable#1#2{% \let\@ifdefinable\@@ifdefinable #2} @@ -751,7 +751,7 @@ % here as there should not be a |@temp|\ldots\ environment. % \changes{LaTeX2e}{1993/11/23}{Macro reimplemented and extended} % \changes{v1.1f}{1994/05/2}{Removed surplus \cs{space} in error} -% \begin{macrocode} +% \begin{macrocode} \def\renewenvironment{\@star@or@long\renew@environment} % \end{macrocode} % @@ -809,7 +809,7 @@ % \changes{v1.2q}{1995/10/02} % {Add \cs{aut@global} in autoload version} % And here's a different sort of allocation: -% For example, +% For example, % |\newif\iffoo| creates |\footrue|, |\foofalse| to go with |\iffoo|. % \begin{macrocode} \def\newif#1{% @@ -839,9 +839,9 @@ % |\providecommand| takes the same arguments as |\newcommand|, but % discards them if |#1| is already defined, Otherwise it just acts like % |\newcommand|. This implementation currently leaves any discarded -% definition in |\reserved@a| (and possibly |\\reserved@a|) this -% wastes a bit of space, but it will be reclaimed as soon as these -% scratch macros are redefined. +% definition in |\reserved@a| (and possibly |\\reserved@a|) this +% wastes a bit of space, but it will be reclaimed as soon as these +% scratch macros are redefined. % % \changes{LaTeX2e}{1993/11/22}{Macro added} % \begin{macrocode} @@ -895,7 +895,7 @@ % \end{macrocode} % \end{macro} % \end{macro} -% +% % \begin{macro}{\@check@c} % \changes{v1.2i}{1995/04/25}{Make \cs{long} for latex/1346} % |\CheckCommand| itself just grabs all the arguments we need, @@ -921,7 +921,7 @@ \def\@check@eq#1#2{% \ifx#1#2\else \@latex@warning@no@line - {Command \noexpand#1 has + {Command \noexpand#1 has changed.\MessageBreak Check if current package is valid}% \fi} @@ -953,7 +953,7 @@ \long\def\@secondoftwo#1#2{#2} % \end{macrocode} % \begin{macro}{\@iden} -% |\@iden| is another name for |\@firstofone| for +% |\@iden| is another name for |\@firstofone| for % compatibility reasons. % \begin{macrocode} \let\@iden\@firstofone @@ -993,16 +993,16 @@ % using \cs{@gobble} before defining it.} % \changes{v1.0q}{1994/05/13}{Renamed \cs{DeclareProtectedCommand} to % \cs{DeclareRobustCommand}. Removed \cs{@if@short@command}. -% Moved to after the definition of \cs{@gobble}.} +% Moved to after the definition of \cs{@gobble}.} % \changes{v1.0r}{1994/05/13}{Added logging message to -% \cs{DeclareProtectedCommand}.} +% \cs{DeclareProtectedCommand}.} % % \subsection{Robust commands and protect} % % \changes{v1.1b}{1994/05/17}{Added the discussion of protected % commands, defined the values that \cs{protect} should have.} % \changes{v1.1c}{1994/05/18}{Redid the discussion and definitions, in -% line with the proposed new setting of \cs{protect} in the output +% line with the proposed new setting of \cs{protect} in the output % routine.} % % Fragile and robust commands are one of the thornier issues in @@ -1013,14 +1013,14 @@ % `moving arguments' by \LaTeX, and consist of: % \begin{itemize} % \item writing information to a file, such as indexes or tables of -% contents. +% contents. % \item writing information to the screen. % \item inside an |\edef|, |\message|, |\mark|, or other command which % evaluates its argument fully. % \end{itemize} % The method \LaTeX{} uses for making fragile commands robust is to % precede them with |\protect|. This can have one of five possible -% values: +% values: % \begin{itemize} % \item |\relax|, for normal typesetting. So |\protect\foo| will % execute |\foo|. @@ -1063,19 +1063,19 @@ % This is a package-writers command, which has the same syntax as % |\newcommand|, but which declares a protected command. It does % this by having\\ -% |\DeclareRobustCommand\foo|\\ +% |\DeclareRobustCommand\foo|\\ % define |\foo| to be % |\protect\foo<space>|,\\ % and then use |\newcommand\foo<space>|.\\ % Since the internal command is |\foo<space>|, when it is written -% to an auxiliary file, it will appear as |\foo|. -% +% to an auxiliary file, it will appear as |\foo|. +% % We have to be a % bit cleverer if we're defining a short command, such as |\_|, in % order to make sure that the auxiliary file does not include a % space after the command, since |\_ a| and |\_a| aren't the same. % In this case we define |\_| to be: -%\begin{verbatim} +%\begin{verbatim} % \x@protect\_\protect\_<space> %\end{verbatim} % which expands to: @@ -1088,7 +1088,7 @@ % Then if |\protect| is |\@typeset@protect| (normally |\relax|) % then we just perform |\_<space>|, and otherwise % |\@x@protect@| gobbles everything up and expands to -% |\protect\_|. +% |\protect\_|. % % \emph{Note}: setting |\protect| to any value other than |\relax| % whilst in `typesetting' mode will cause commands to go into an @@ -1159,12 +1159,12 @@ % \end{macro} % % \changes{v1.2e}{1994/11/04}{Added commands for setting and restoring -% \cs{protect}. ASAJ.} +% \cs{protect}. ASAJ.} % % \begin{macro}{\set@display@protect} % \begin{macro}{\set@typeset@protect} % These macros set |\protect| appropriately for typesetting or -% displaying. +% displaying. % \changes{v1.2o}{1995/07/03}{Use \cs{@typeset@protect} for init} % \begin{macrocode} \def\set@display@protect{\let\protect\string} @@ -1218,7 +1218,7 @@ % \subsection{Internal defining commands} % % These commands are used internally to define other \LaTeX{} -% commands. +% commands. % \begin{macro}{\@ifundefined} % \changes{LaTeX2e}{1993/11/23}{Redefined to remove a trailing \cs{fi}} % Check if first arg is undefined or \cs{relax} and execute second or @@ -1236,7 +1236,7 @@ % % \begin{macro}{\@qend} % \begin{macro}{\@qrelax} -% The following define |\@qend| and |\@qrelax| to be the strings +% The following define |\@qend| and |\@qrelax| to be the strings % `|end|' and `|relax|' with the characters |\catcode|d 12. % \begin{macrocode} \edef\@qend{\expandafter\@cdr\string\end\@nil} @@ -1248,7 +1248,7 @@ % % \begin{macro}{\@ifnextchar} % \changes{LaTeX209}{1992/08/24} -% {(Rms) \cs{@ifnextchar} didn't work if its +% {(Rms) \cs{@ifnextchar} didn't work if its % first argument was an equal sign.} % \changes{v1.2q}{1995/10/02} % {Use \cs{@let@token} } @@ -1269,7 +1269,7 @@ \futurelet\@let@token\@ifnch} % \end{macrocode} % \end{macro} -% +% % \begin{macro}{\kernel@ifnextchar} % \changes{v1.3g}{2004/01/23}{Added macro (pr/3501)} % This macro is the kernel version of |\@ifnextchar| which is used @@ -1278,7 +1278,7 @@ % if an \texttt{fd} file % is loaded in a random place then the optional argument to % |\ProvidesFile| could get printed there instead of being written -% only in the log file. This happened +% only in the log file. This happened % when there was a space or a newline between the mandatory and % optional arguments! It should really be fixed in the % \texttt{amsmath} package one day, but\ldots @@ -1335,7 +1335,7 @@ % \end{macrocode} % \end{macro} -% \changes{v1.0n}{1994/05/10}{Added \cs{makeatletter} and +% \changes{v1.0n}{1994/05/10}{Added \cs{makeatletter} and % \cs{makeatother} ASAJ.} % % \begin{macro}{\makeatletter} @@ -1386,11 +1386,11 @@ % % \begin{macro}{\@onelevel@sanitize} % \changes{v1.2c}{1994/10/30}{Macro added} -% +% % This makes the whole ``meaning'' of |#1| (its one-level % expansion) into catcode 12 tokens: it could be used in % |\DeclareRobustCommand|. -% +% % If it is to be used on default float specifiers, this should be % done when they are defined. % \begin{macrocode} |