[latexrefman-commits] [SCM] latexrefman updated: r1034 - in trunk: . latex2e-help-texinfo-tree/l [more]
Vincent Belaiche
INVALID.NOREPLY at gnu.org.ua
Tue Oct 5 23:17:35 CEST 2021
Author: vincentb1
Date: 2021-10-05 21:17:35 +0000 (Tue, 05 Oct 2021)
New Revision: 1034
Added:
trunk/latex2e-help-texinfo-tree/latex2e-fr/latex2e-figures
Modified:
trunk/ChangeLog
trunk/latex2e.texi
Log:
[en] ``@var{cmd}'' -> ``\@var{cmd}'', and much more.
* latex2e.texi (\DeclareFontEncoding): ``or'' -> ``and'' in
``@code{\selectfont} and @code{\fontencoding}'', see https://tug.org/pipermail/latexrefman/2021q3/000824.html.
(\DeclareTextAccent): Define word ``slot''. See https://tug.org/pipermail/latexrefman/2021q3/000825.html.
(\DeclareTextAccentDefault, \DeclareTextCommand &
\ProvideTextCommand, \DeclareTextCommandDefault &
\ProvideTextCommandDefault, \DeclareTextComposite)
(\DeclareTextCompositeCommand, \DeclareTextSymbol)
(\DeclareTextSymbolDefault, \UseTextSymbol & \UseTextAccent)
(\providecommand): ``@var{cmd}'' -> ``\@var{cmd}''.
(\DeclareTextCommand & \ProvideTextCommand): Remove
``\DeclareTextCommandDefault'' from index. Add \DeclareTextSymbol
to index.
(\DeclareTextCommand & \ProvideTextCommand): Typo on
``@var{optargdefault}''.
(\DeclareTextCommandDefault & \ProvideTextCommandDefault)
(\DeclareTextComposite): ``location'' -> ``slot''.
(Line breaking): Mention within @ignore comment alternative text
concerning word processors, see
https://tug.org/pipermail/latexrefman/2021q3/000803.html
(\footnotemark): @code{...}-ify ``footnote''. Typo.
(Footnotes of footnotes): Remove ``First'' concerning Wilson
theorem, see
https://tug.org/pipermail/latexrefman/2021q3/000839.html.
(\providecommand ): In exemple does not use the same definition
twice to illustrate that the first one met is that used.
* latex2e-help-texinfo-tree/latex2e-fr/latex2e-figures: Symlink to
the English one.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2021-09-05 20:24:12 UTC (rev 1033)
+++ trunk/ChangeLog 2021-10-05 21:17:35 UTC (rev 1034)
@@ -1,3 +1,59 @@
+2021-10-05 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+
+ * latex2e.texi (\DeclareFontEncoding): ``or'' -> ``and'' in
+ ``@code{\selectfont} and @code{\fontencoding}'', see https://tug.org/pipermail/latexrefman/2021q3/000824.html.
+ (\DeclareTextAccent): Define word ``slot''. See https://tug.org/pipermail/latexrefman/2021q3/000825.html.
+ (\DeclareTextAccentDefault, \DeclareTextCommand &
+ \ProvideTextCommand, \DeclareTextCommandDefault &
+ \ProvideTextCommandDefault, \DeclareTextComposite)
+ (\DeclareTextCompositeCommand, \DeclareTextSymbol)
+ (\DeclareTextSymbolDefault, \UseTextSymbol & \UseTextAccent)
+ (\providecommand): ``@var{cmd}'' -> ``\@var{cmd}''.
+ (\DeclareTextCommand & \ProvideTextCommand): Remove
+ ``\DeclareTextCommandDefault'' from index. Add \DeclareTextSymbol
+ to index.
+ (\DeclareTextCommand & \ProvideTextCommand): Typo on
+ ``@var{optargdefault}''.
+ (\DeclareTextCommandDefault & \ProvideTextCommandDefault)
+ (\DeclareTextComposite): ``location'' -> ``slot''.
+ (Line breaking): Mention within @ignore comment alternative text
+ concerning word processors, see
+ https://tug.org/pipermail/latexrefman/2021q3/000803.html
+ (\footnotemark): @code{...}-ify ``footnote''. Typo.
+ (Footnotes of footnotes): Remove ``First'' concerning Wilson
+ theorem, see
+ https://tug.org/pipermail/latexrefman/2021q3/000839.html.
+ (\providecommand ): In exemple does not use the same definition
+ twice to illustrate that the first one met is that used.
+
+ * latex2e-help-texinfo-tree/latex2e-fr/latex2e-figures: Symlink to
+ the English one.
+
+2021-09-15 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+
+ * latex2e.texi (\DeclareFontEncoding): ``or'' -> ``and'',
+ concerning \selectfont & \fontencoding.
+ (\DeclareTextAccent): Add definition of slot, and index it.
+ (\DeclareTextAccentDefault, \DeclareTextCommand &
+ \ProvideTextCommand, \DeclareTextCommandDefault &
+ \ProvideTextCommandDefault, \DeclareTextComposite)
+ (\DeclareTextCompositeCommand, \DeclareTextSymbol)
+ (\DeclareTextSymbolDefault, \UseTextSymbol & \UseTextAccent)
+ (\providecommand): @var{cmd} -> \@var{cmd} + some
+ @code{...}-ification.
+ (\DeclareTextCommand & \ProvideTextCommand): Suppress
+ \DeclareTextCommandDefault from index. Some rewording. Add
+ \DeclareTextSymbol to index, where applicable. Typoes.
+ (\DeclareTextCommandDefault & \ProvideTextCommandDefault): @noindent
+ inserted.
+ (\DeclareTextCommandDefault & \ProvideTextCommandDefault)
+ (\DeclareTextComposite): ``location'' -> ``slot''.
+ (Line breaking): Recall as @ignored text the alternative wording
+ about differing line break adjustments.
+ (Footnotes of footnotes): ``First noted in Wilson'' -> ``Noted in
+ Wilson''.
+
+
2021-09-05 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
* latex2e.texi Implement fix suggested by Laurent Van Deik.
Index: trunk/latex2e-help-texinfo-tree/latex2e-fr/latex2e-figures
===================================================================
--- trunk/latex2e-help-texinfo-tree/latex2e-fr/latex2e-figures 2021-09-05 20:24:12 UTC (rev 1033)
+++ trunk/latex2e-help-texinfo-tree/latex2e-fr/latex2e-figures 2021-10-05 21:17:35 UTC (rev 1034)
Property changes on: trunk/latex2e-help-texinfo-tree/latex2e-fr/latex2e-figures
___________________________________________________________________
Added: svn:special
## -0,0 +1 ##
+*
\ No newline at end of property
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-09-05 20:24:12 UTC (rev 1033)
+++ trunk/latex2e.texi 2021-10-05 21:17:35 UTC (rev 1034)
@@ -2,7 +2,7 @@
@c $Id$
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename latex2e.info
- at set UPDATED August 2021
+ at set UPDATED October 2021
@include common.texi
@settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
@comment %**end of header (This is for running Texinfo on a region.)
@@ -1651,7 +1651,7 @@
The @var{text-settings} are the commands that @LaTeX{} will run every
time it switches from one encoding to another with the
- at code{\selectfont} or @code{\fontencoding} command. The
+ at code{\selectfont} and @code{\fontencoding} commands. The
@var{math-settings} are the commands that @LaTeX{} will use whenever the
font is accessed as a math alphabet.
@@ -1688,6 +1688,9 @@
Define an accent, to be put on top of other glyphs, in the encoding
@var{encoding} at the location @var{slot}.
+ at cindex slot, font
+A @dfn{slot} is the number identifying a glyph within a font.
+
This line from @file{t1enc.def} declares that to make a circumflex
accent as in @code{\^A}, the system will put the accent in slot at tie{}2
over the @samp{A} character, which is represented in ASCII as at tie{}65.
@@ -1714,10 +1717,10 @@
Synopsis:
@example
-\DeclareTextAccentDefault@{@var{cmd}@}@{@var{encoding}@}
+\DeclareTextAccentDefault@{\@var{cmd}@}@{@var{encoding}@}
@end example
-If there is an encoding-specific accent command @var{cmd} but there is
+If there is an encoding-specific accent command \@var{cmd} but there is
no associated @code{\DeclareTextAccent} for that encoding then this
command will pick up the slack, by saying to use it as described for
@var{encoding}.
@@ -1738,8 +1741,8 @@
& \UseTextAccent}).
@example
-\DeclareTextCommandDefault[1]@{@var{cmd}@}
- @{\UseTextAccent@{@var{encoding}@}@{@var{cmd}@}@{#1@}@}
+\DeclareTextCommandDefault[1]@{\@var{cmd}@}
+ @{\UseTextAccent@{@var{encoding}@}@{\@var{cmd}@}@{#1@}@}
@end example
Note that @code{\DeclareTextAccentDefault} works for any one-argument
@@ -1750,30 +1753,29 @@
@subsection @code{\DeclareTextCommand} & @code{\ProvideTextCommand}
@findex \DeclareTextCommand
- at findex \DeclareTextCommandDefault
@findex \ProvideTextCommand
Synopsis, one of:
@example
-\DeclareTextCommand@{@var{cmd}@}@{@var{encoding}@}@{@var{defn}@}
-\DeclareTextCommand@{@var{cmd}@}@{@var{encoding}@}[@var{nargs}]@{@var{defn@}}
-\DeclareTextCommand@{@var{cmd}@}@{@var{encoding}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+\DeclareTextCommand@{\@var{cmd}@}@{@var{encoding}@}@{@var{defn}@}
+\DeclareTextCommand@{\@var{cmd}@}@{@var{encoding}@}[@var{nargs}]@{@var{defn@}}
+\DeclareTextCommand@{\@var{cmd}@}@{@var{encoding}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
@end example
or one of:
@example
-\ProvideTextCommand@{@var{cmd}@}@{@var{encoding}@}@{@var{defn}@}
-\ProvideTextCommand@{@var{cmd}@}@{@var{encoding}@}[@var{nargs}]@{@var{defn}@}
-\ProvideTextCommand@{@var{cmd}@}@{@var{encoding}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+\ProvideTextCommand@{\@var{cmd}@}@{@var{encoding}@}@{@var{defn}@}
+\ProvideTextCommand@{\@var{cmd}@}@{@var{encoding}@}[@var{nargs}]@{@var{defn}@}
+\ProvideTextCommand@{\@var{cmd}@}@{@var{encoding}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
@end example
-Define the command @var{cmd}, which will be specific to one encoding.
-The command name @var{cmd} must begin with a backslash, \. These
-commands can only appear in the preamble. Redefining @code{cmd} does
-not cause an error. The defined command will be robust even if the code
-in @var{defn} is fragile (@pxref{\protect}).
+Define the command @code{\@var{cmd}}, which will be specific to one
+encoding. The command name @var{cmd} must be preceded by a backslash,
+ at code{\}. These commands can only appear in the preamble. Redefining
+\@var{cmd} does not cause an error. The defined command will be robust
+even if the code in @var{defn} is fragile (@pxref{\protect}).
For example, the file @file{t1enc.def} contains this line.
@@ -1794,22 +1796,23 @@
@samp{LaTeX Error: Command \textperthousand unavailable in encoding
OT1}.
+ at findex \DeclareTextSymbol
The @code{\ProvideTextCommand} variant does the same, except that it
-does nothing if @var{cmd} is already defined. The
+does nothing if @code{\@var{cmd}} is already defined. The
@code{\DeclareTextSymbol} command is faster than this one for simple
slot-to-glyph association (@pxref{\DeclareTextSymbol})
-The optional @var{nargs} and @var{optargsdefault} arguments play the
-same role here as in @code{\newcommand} (@pxref{\newcommand &
+The optional @var{nargs} and @var{optargdefault} arguments play the same
+role here as in @code{\newcommand} (@pxref{\newcommand &
\renewcommand}). Briefly, @var{nargs} is an integer from 0 to 9
-specifying the number of arguments that the defined command @code{cmd}
-takes. This number includes any optional argument. Omitting this
-argument is the same as specifying 0, meaning that @var{cmd} will have
-no arguments. And, if @var{optargsdefault} is present then the first
-argument of @code{\@var{cmd}} is optional, with default value
- at var{optargdefault} (which may be the empty string). If
- at var{optargsdefault} is not present then @code{\@var{cmd}} does not take
-an optional argument.
+specifying the number of arguments that the defined command
+ at code{\@var{cmd}} takes. This number includes any optional argument.
+Omitting this argument is the same as specifying 0, meaning that
+ at code{\@var{cmd}} will have no arguments. And, if @var{optargdefault}
+is present then the first argument of @code{\@var{cmd}} is optional,
+with default value @var{optargdefault} (which may be the empty string).
+If @var{optargdefault} is not present then @code{\@var{cmd}} does not
+take an optional argument.
@node \DeclareTextCommandDefault & \ProvideTextCommandDefault
@@ -1823,18 +1826,18 @@
Synopsis:
@example
-\DeclareTextCommandDefault@{@var{cmd}@}@{@var{defn}@}
+\DeclareTextCommandDefault@{\@var{cmd}@}@{@var{defn}@}
@end example
or:
@example
-\ProvideTextCommandDefault@{@var{cmd}@}@{@var{defn}@}
+\ProvideTextCommandDefault@{\@var{cmd}@}@{@var{defn}@}
@end example
-Give a default definition for @var{cmd}, for when that command is not
-defined in the encoding currently in force. This default should only use
-encodings known to be available.
+Give a default definition for @code{\@var{cmd}}, for when that command
+is not defined in the encoding currently in force. This default should
+only use encodings known to be available.
This makes @code{\copyright} available.
@@ -1842,6 +1845,7 @@
\DeclareTextCommandDefault@{\copyright@}@{\textcircled@{c@}@}
@end example
+ at noindent
It uses only an encoding (OMS) that is always available.
The @code{\DeclareTextCommandDefault} should not occur in the encoding
@@ -1851,7 +1855,7 @@
As with the related non-default commands, the
@code{\ProvideTextCommandDefault} has exactly the same behavior as
@code{\DeclareTextCommandDefault} except that it does nothing if
- at var{cmd} is already defined (@pxref{\DeclareTextCommand &
+ at code{\@var{cmd}} is already defined (@pxref{\DeclareTextCommand &
\ProvideTextCommand}). So, packages can use it to provide fallbacks
that other packages can improve upon.
@@ -1865,7 +1869,7 @@
Synopsis:
@example
-\DeclareTextComposite@{@var{cmd}@}@{@var{encoding}@}@{@var{simple_object}@}@{@var{slot}@}
+\DeclareTextComposite@{\@var{cmd}@}@{@var{encoding}@}@{@var{simple_object}@}@{@var{slot}@}
@end example
Access an accented glyph directly, that is, without having to put an
@@ -1873,7 +1877,7 @@
This line from @file{t1enc.def} means that @code{\^o} will cause
@LaTeX{} to typeset lowercase at tie{}@samp{o} by taking the character
-directly from location 224 in the font.
+directly from slot 224 in the font.
@example
\DeclareTextComposite@{\^@}@{T1@}@{o@}@{244@}
@@ -1883,7 +1887,7 @@
@var{simple_object} should be a single character or a single command.
The @var{slot} argument is usually a positive integer represented in
decimal (although octal or hexadecimal are possible). Normally
- at var{cmd} has already been declared for this encoding, either with
+\@var{cmd} has already been declared for this encoding, either with
@code{\DeclareTextAccent} or with a one-argument
@code{\DeclareTextCommand}. In @file{t1enc.def}, the above line follows
the @code{\DeclareTextAccent@{\^@}@{T1@}@{2@}} command.
@@ -1898,11 +1902,11 @@
Synopsis:
@example
-\DeclareTextCompositeCommand@{@var{cmd}@}@{@var{encoding}@}@{@var{arg}@}@{@var{code}@}
+\DeclareTextCompositeCommand@{\@var{cmd}@}@{@var{encoding}@}@{@var{arg}@}@{@var{code}@}
@end example
A more general version of @code{\DeclareTextComposite} that runs
-arbitrary code with @var{cmd}.
+arbitrary code with @code{\@var{cmd}}.
This allows accents on @samp{i} to act like accents on dotless at tie{}i,
@code{\i}.
@@ -1912,7 +1916,7 @@
@end example
@xref{fontenc package}, for a list of common encodings. Normally
- at var{cmd} will have already been declared with @code{\DeclareTextAccent}
+ at code{\@var{cmd}} will have already been declared with @code{\DeclareTextAccent}
or as a one argument @code{\DeclareTextCommand}.
@@ -1925,7 +1929,7 @@
Synopsis:
@example
-\DeclareTextSymbol@{@var{cmd}@}@{@var{encoding}@}@{@var{slot}@}
+\DeclareTextSymbol@{\@var{cmd}@}@{@var{encoding}@}@{@var{slot}@}
@end example
Define a symbol in the encoding @var{encoding} at the location
@@ -1949,9 +1953,9 @@
hexadecimal (as in @code{"13}), although decimal has the advantage that
single quote or double quote could be redefined by another package.
-If @var{cmd} has already been defined then @code{\DeclareTextSymbol}
-does not give an error but it does log the redefinition in the
-transcript file.
+If @code{\@var{cmd}} has already been defined then
+ at code{\DeclareTextSymbol} does not give an error but it does log the
+redefinition in the transcript file.
@node \DeclareTextSymbolDefault
@@ -1964,13 +1968,13 @@
Synopsis:
@example
-\DeclareTextSymbolDefault@{@var{cmd}@}@{@var{encoding}@}
+\DeclareTextSymbolDefault@{\@var{cmd}@}@{@var{encoding}@}
@end example
-If there is an encoding-specific symbol command @var{cmd} but there is no
-associated @code{\DeclareTextSymbol} for that encoding, then this command
-will pick up the slack, by saying to get the symbol as described for
- at var{encoding}.
+If there is an encoding-specific symbol command @code{\@var{cmd}} but
+there is no associated @code{\DeclareTextSymbol} for that encoding, then
+this command will pick up the slack, by saying to get the symbol as
+described for @var{encoding}.
For example, to declare that if the current encoding has no meaning for
@code{\textdollar} then use the one from @code{OT1}, declare this.
@@ -1983,8 +1987,8 @@
& \UseTextAccent}).
@example
-\DeclareTextCommandDefault@{@var{cmd}@}
- @{\UseTextSymbol@{@var{encoding}@}@{@var{cmd}@}@}
+\DeclareTextCommandDefault@{\@var{cmd}@}
+ @{\UseTextSymbol@{@var{encoding}@}@{\@var{cmd}@}@}
@end example
Note that @code{\DeclareTextSymbolDefault} can be used to define a
@@ -2024,13 +2028,13 @@
Synopsis:
@example
-\UseTextSymbol@{@var{encoding}@}@{@var{cmd}@}
+\UseTextSymbol@{@var{encoding}@}@{\@var{cmd}@}
@end example
or:
@example
-\UseTextAccent@{@var{encoding}@}@{@var{cmd}@}@{@var{text}@}
+\UseTextAccent@{@var{encoding}@}@{\@var{cmd}@}@{@var{text}@}
@end example
Use a symbol or accent not from the current encoding.
@@ -8491,6 +8495,23 @@
breaks). This differs from word processing, where you are formatting
text as you input it. Putting these off until the end prevents a lot of
fiddling with breaks that will change anyway.
+ at c Alernative text proposed here: https://tug.org/pipermail/latexrefman/2021q3/000803.html
+ at c this text is that of the French version.
+ at ignore
+A common workflow with LaTeX is to get a final version of the document
+content before taking a final pass through and considering line breaks
+(and page breaks). Most people do not consider LaTeX as a word
+processor, because it does not show the output instantly. However
+differing the output encourages the user to put off until the end
+formatting adjustments, and thus it prevents a lot of fiddling with
+breaks that will change anyway.
+ at noindent
+Differing the output has other advantages: it enables to make no
+compromise about the typesetting, which ensures that what you see it
+exactly what you get, and it also helps authors concentrate their mind
+on either writing or reading rather than distract it by doing both a the
+same time.
+ at end ignore
@menu
* \\:: Start a new line.
@@ -9307,9 +9328,9 @@
(@pxref{Modes}).
If you use @code{\footnotemark} without the optional argument then it
-increments the footnote counter but if you use the optional @var{number}
-then it does not. The next example produces several consecutive footnote
-markers referring to the same footnote.
+increments the @code{footnote} counter, but if you use the optional
+ at var{number} then it does not. The next example produces several
+consecutive footnote markers referring to the same footnote.
@example
The first theorem\footnote@{Due to Gauss.@}
@@ -9317,10 +9338,11 @@
and the third theorem.\footnotemark[\value@{footnote@}]
@end example
-If there are intervening footnotes then you must remember the value of the
-common mark. This example gives the same institutional affiliation to
-both the first and third authors (@code{\thanks} is a version of
- at code{footnote}), by-hand giving the number of the footnote.
+If there are intervening footnotes then you must remember the value of
+the number of the common mark. This example gives the same
+institutional affiliation to both the first and third authors
+(@code{\thanks} is a version of @code{\footnote}), by-hand giving the
+number of the footnote.
@example
\title@{A Treatise on the Binomial Theorem@}
@@ -9511,7 +9533,7 @@
...
The third theorem is a partial converse of the
second.\footnotefrom@{%
- First noted in Wilson.\footnote@{Second edition only.@}@}
+ Noted in Wilson.\footnote@{Second edition only.@}@}
@end example
@@ -9758,12 +9780,12 @@
Synopses, one of:
@example
-\providecommand@{@var{cmd}@}@{@var{defn}@}
-\providecommand@{@var{cmd}@}[@var{nargs}]@{@var{defn}@}
-\providecommand@{@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
-\providecommand*@{@var{cmd}@}@{@var{defn}@}
-\providecommand*@{@var{cmd}@}[@var{nargs}]@{@var{defn}@}
-\providecommand*@{@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+\providecommand@{\@var{cmd}@}@{@var{defn}@}
+\providecommand@{\@var{cmd}@}[@var{nargs}]@{@var{defn}@}
+\providecommand@{\@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
+\providecommand*@{\@var{cmd}@}@{@var{defn}@}
+\providecommand*@{\@var{cmd}@}[@var{nargs}]@{@var{defn}@}
+\providecommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdefault}]@{@var{defn}@}
@end example
Defines a command, as long as no command of this name already exists.
@@ -9777,8 +9799,8 @@
@example
\providecommand@{\myaffiliation@}@{Saint Michael's College@}
-\providecommand@{\myaffiliation@}@{Saint Michael's College@}
->From \myaffiliation.
+\providecommand@{\myaffiliation@}@{Lyc\'ee Henri IV@}
+From \myaffiliation.
@end example
@noindent
More information about the latexrefman-commits
mailing list.