[latexrefman-commits] [SCM] latexrefman updated: r992 - trunk
Vincent Belaiche
INVALID.NOREPLY at gnu.org.ua
Thu Aug 19 18:26:10 CEST 2021
Author: vincentb1
Date: 2021-08-19 16:26:10 +0000 (Thu, 19 Aug 2021)
New Revision: 992
Modified:
trunk/common.texi
trunk/latex2e.texi
Log:
[en] uniformize @code{...} or @file{...} for package names to @code{...}.
A macro is used in order to make the source code more maintainable. I
did the replacement with this Elisp macro:
(defun doit ()
(interactive)
(save-excursion
(let (re pkg-list pkg)
(goto-char (point-min))
(while (re-search-forward "@PkgIndex{\\([^}]+\\)}" nil t)
(setq pkg (match-string-no-properties 1))
(unless (member pkg pkg-list)
(push pkg pkg-list)))
(goto-char (point-min))
(setq re (concat "@\\(file\\|code\\){" (regexp-opt pkg-list) "}"))
(while (re-search-forward re nil t)
(replace-match "package" nil nil nil 1)))))
Modified: trunk/common.texi
===================================================================
--- trunk/common.texi 2021-08-19 16:23:04 UTC (rev 991)
+++ trunk/common.texi 2021-08-19 16:26:10 UTC (rev 992)
@@ -14,6 +14,9 @@
\else\@c
@end macro
@end ifnottex
+ at macro package {packagename}
+ at code{\packagename\}
+ at end macro
@tex
\globaldefs=1
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-08-19 16:23:04 UTC (rev 991)
+++ trunk/latex2e.texi 2021-08-19 16:26:10 UTC (rev 992)
@@ -598,8 +598,8 @@
@PkgIndex{expl3}
@PkgIndex{xparse}
@cindex @LaTeX{}3 syntax
-As of the 2020-10-01 release of @LaTeX{}, the @code{expl3} and
- at code{xparse} packages are part of the @LaTeX{}2e format. They
+As of the 2020-10-01 release of @LaTeX{}, the @package{expl3} and
+ at package{xparse} packages are part of the @LaTeX{}2e format. They
provide a completely different underlying programming language
syntax. We won't try to cover them in this document; see the related
package documentation and other @LaTeX{} manuals.
@@ -728,7 +728,7 @@
@item slides
@anchor{document classes slides}
For slide presentations---rarely used nowadays. The
- at code{beamer} package is perhaps the most prevalent
+ at package{beamer} package is perhaps the most prevalent
(@url{https://ctan.org/pkg/beamer}). @xref{beamer template}, for a
small template for a beamer document.
@@ -809,7 +809,7 @@
to do that is to put @code{\pdfpagewidth=\paperwidth} and
@code{\pdfpageheight=\paperheight} in your document's preamble.
@PkgIndex{geometry}
-The @code{geometry} package provides flexible ways of setting the print
+The @package{geometry} package provides flexible ways of setting the print
area and physical page size.
@findex draft @r{option}
@@ -1169,7 +1169,7 @@
using @code{\newcommand} so unless the command's data is fragile and the
command is used within a moving argument, use @code{\newcommand}.
- at PkgIndex{etoolbox} The @file{etoolbox} package offers the commands
+ at PkgIndex{etoolbox} The @package{etoolbox} package offers the commands
@code{\newrobustcmd}, @code{\newrobustcmd*}, as well as the commands
@code{\renewrobustcmd}, @code{\renewrobustcmd*}, and the commands
@code{\providerobustcmd}, and @code{\providerobustcmd*}. These are
@@ -1533,7 +1533,7 @@
@PkgIndex{fontspec}
This package only applies if you use the @code{pdflatex} engine
(@pxref{@TeX{} engines}). If you use the @command{xelatex} or
- at command{lualatex} engine then instead use the @file{fontspec} package.
+ at command{lualatex} engine then instead use the @package{fontspec} package.
@TeX{}'s original font family, Computer Modern, has a limited character
set. For instance, to make common accented characters you must use
@@ -1557,7 +1557,7 @@
If you are using an encoding such as @code{T1} and the characters appear
blurry or do not magnify well then your fonts may be bitmapped,
sometimes called raster or Type at tie{}3. You want vector fonts. Use a
-package such as @file{lmodern} or @file{cm-super} to get a font that
+package such as @package{lmodern} or @package{cm-super} to get a font that
extends @LaTeX{}'s default using vector fonts.
For each @var{font_encoding} given as an option but not already
@@ -2344,7 +2344,7 @@
invalid in math mode}, and the font size doesn't
change. To work with a too-large formula, often the best option is to
use the @code{displaymath} environment (@pxref{Math formulas}), or
-one of the environments from the @file{amsmath} package. For inline
+one of the environments from the @package{amsmath} package. For inline
mathematics, such as in a table of formulas, an alternative is something
like @code{@{\small $mv^2/2$@}}. (Sometimes @code{\scriptsize} and
@code{\scriptstyle} are confused. Both change the font size, but the
@@ -2564,7 +2564,7 @@
Equivalent to @code{\renewcommand@{\baselinestretch@}@{@var{factor}@}},
and therefore must be followed by @code{\selectfont} to have any
effect. Best specified in the preamble. @xref{\baselineskip &
-\baselinestretch}, for using @file{setspace} package instead.
+\baselinestretch}, for using @package{setspace} package instead.
@anchor{low level font commands selectfont}
@item \selectfont
@@ -3084,7 +3084,7 @@
@code{\selectfont}.)
@PkgIndex{setspace}
-A simpler approach is the @file{setspace} package. The basic example:
+A simpler approach is the @package{setspace} package. The basic example:
@example
\usepackage@{setspace@}
@@ -3115,7 +3115,7 @@
@LaTeX{} can have a number of different classes of floating material.
The default is the two classes, @code{figure} (@pxref{figure}) and
@code{table} (@pxref{table}), but you can create a new class with the
-package @file{float}.
+package @package{float}.
Within any one float class @LaTeX{} always respects the order, so that
the first figure in a document source must be typeset before the second
@@ -3199,7 +3199,7 @@
the @var{placement} parameter. If this is not desired, and deleting
the @code{t} is not acceptable as it keeps the float from being placed
at the top of the next page, then you can prevent it by either using
-the @file{flafter} package or using the command
+the @package{flafter} package or using the command
@findex \suppressfloats
@code{\suppressfloats[t]}, which causes floats for the top position on
this page to moved to the next page.
@@ -3390,7 +3390,7 @@
of any fragile commands. @xref{\protect}.
@PkgIndex{caption}
-The @code{caption} package has many options to adjust how the caption
+The @package{caption} package has many options to adjust how the caption
appears, for example changing the font size, making the caption be
hanging text rather than set as a paragraph, or making the caption
always set as a paragraph rather than centered when it is short.
@@ -3487,7 +3487,7 @@
letters with @code{\renewcommand\thesection@{\Alph@{section@}@}} in the
preamble (@pxref{\alph \Alph \arabic \roman \Roman \fnsymbol}). CTAN
has many packages that make this adjustment easier, notably
- at file{titlesec}.
+ at package{titlesec}.
Two counters relate to the appearance of headings made by sectioning commands.
@@ -3596,10 +3596,10 @@
@PkgIndex{indentfirst}
In the class @code{article}, if a paragraph immediately follows the part
title then it is not indented. To get an indent you can use the package
- at file{indentfirst}.
+ at package{indentfirst}.
@PkgIndex{titlesec}
-One package to change the behavior of @code{\part} is @file{titlesec}.
+One package to change the behavior of @code{\part} is @package{titlesec}.
See its documentation on CTAN.
@@ -3677,7 +3677,7 @@
@PkgIndex{indentfirst}
The paragraph that follows the chapter title is not indented, as is a
standard typographical practice. To get an indent use the package
- at file{indentfirst}.
+ at package{indentfirst}.
You can change what is shown for the chapter number. To change it to
something like @samp{Lecture 1}, put in the preamble either
@@ -3692,7 +3692,7 @@
@PkgIndex{babel}
@noindent To make this change because of the primary language for
-the document, see the package @file{babel}.
+the document, see the package @package{babel}.
In a two-sided document @LaTeX{} puts a chapter on odd-numbered page, if
necessary leaving an even-numbered page that is blank except for any
@@ -3703,7 +3703,7 @@
To change the behavior of the @code{\chapter} command, you can copy its
definition from the @LaTeX{} format file and make adjustments. But
there are also many packages on CTAN that address this. One is
- at file{titlesec}. See its documentation, but the example below gives a
+ at package{titlesec}. See its documentation, but the example below gives a
sense of what it can do.
@example
@@ -3796,13 +3796,13 @@
@PkgIndex{indentfirst}
The paragraph that follows the section title is not indented, as is a
standard typographical practice. One way to get an indent is to use the
-package @file{indentfirst}.
+package @package{indentfirst}.
@PkgIndex{titlesec}
In general, to change the behavior of the @code{\section} command, there
are a number of options. One is the @code{\@@startsection} command
(@pxref{\@@startsection}). There are also many packages on CTAN that
-address this, including @file{titlesec}. See the documentation but the
+address this, including @package{titlesec}. See the documentation but the
example below gives a sense of what they can do.
@c credit: egreg https://groups.google.com/forum/#!topic/comp.text.tex/tvc8oM5P4y4
@@ -3881,13 +3881,13 @@
@PkgIndex{indentfirst}
The paragraph that follows the subsection title is not indented, as is a
standard typographical practice. One way to get an indent is to use the
-package @file{indentfirst}.
+package @package{indentfirst}.
@PkgIndex{titlesec}
There are a number of ways to change the behavior of the
@code{\subsection} command. One is the @code{\@@startsection} command
(@pxref{\@@startsection}). There are also many packages on CTAN that
-address this, including @file{titlesec}. See the documentation but the
+address this, including @package{titlesec}. See the documentation but the
example below gives a sense of what they can do.
@example
@@ -3982,13 +3982,13 @@
@PkgIndex{indentfirst}
The paragraph that follows the subsubsection title is not indented, as is a
standard typographical practice. One way to get an indent is to use the
-package @file{indentfirst}.
+package @package{indentfirst}.
@PkgIndex{titlesec}
There are a number of ways to change the behavior of the these commands.
One is the @code{\@@startsection} command (@pxref{\@@startsection}).
There are also many packages on CTAN that address this, including
- at file{titlesec}. See the documentation on CTAN.
+ at package{titlesec}. See the documentation on CTAN.
@node \appendix
@@ -4030,7 +4030,7 @@
for another example.
@PkgIndex{appendix}
-The @file{appendix} package adds the command
+The @package{appendix} package adds the command
@code{\appendixpage} to put a separate @samp{Appendices} in the document
body before the first appendix, and the command @code{\addappheadtotoc}
to do the same in the table of contents. You can reset the name
@@ -4104,7 +4104,7 @@
Used to help redefine the behavior of commands that start sectioning
divisions such as @code{\section} or @code{\subsection}.
-Note that the @file{titlesec} package makes manipulation of sectioning
+Note that the @package{titlesec} package makes manipulation of sectioning
easier. Further, while most requirements for sectioning commands can be
satisfied with @code{\@@startsection}, some cannot. For instance, in
the standard @LaTeX{} @code{book} and @code{report} classes the commands
@@ -4380,7 +4380,7 @@
and the output contains the old reference information. In both cases,
resolve this by compiling the document a second time.
- at PkgIndex{cleveref} The @code{cleveref} package enhances @LaTeX{}'s
+ at PkgIndex{cleveref} The @package{cleveref} package enhances @LaTeX{}'s
cross referencing features. You can arrange that if you enter
@code{\begin@{thm@}\label@{th:Nerode@}...\end@{thm@}} then
@code{\cref@{th:Nerode@}} will output @samp{Theorem 3.21}, without you
@@ -4538,12 +4538,12 @@
@end example
@PkgIndex{cleveref}
-The @file{cleveref} package includes text such as @samp{Theorem} in the
+The @package{cleveref} package includes text such as @samp{Theorem} in the
reference. See the documentation on CTAN.
@node xr package
- at section @code{xr} package
+ at section @package{xr} package
@PkgIndex{xr}
@PkgIndex{xr-hyper}
@@ -4615,10 +4615,10 @@
exercises file. Without that prefix, both references would get the
number from the later file.
-Note: if the document uses the @code{hyperref} package then in place of
- at code{xr}, put @code{\usepackage@{xr-hyper@}} before the
+Note: if the document uses the @package{hyperref} package then in place of
+ at package{xr}, put @code{\usepackage@{xr-hyper@}} before the
@code{\usepackage@{hyperref@}}. Also, if any of the multiple documents
-uses @code{hyperref} then they all must use it.
+uses @package{hyperref} then they all must use it.
@node Environments
@@ -4804,7 +4804,7 @@
10 at dmn{pt} of space.
@PkgIndex{amsmath}
-To obtain arrays with braces the standard is to use the @file{amsmath}
+To obtain arrays with braces the standard is to use the @package{amsmath}
package. It comes with environments @code{pmatrix} for an array
surrounded by parentheses at tie{}@code{(...)}, @code{bmatrix} for an array
surrounded by square brackets at tie{}@code{[...]}, @code{Bmatrix} for an
@@ -4814,7 +4814,7 @@
bars at tie{}@code{||...||}, along with a number of other array constructs.
@PkgIndex{amsmath}
-The next example uses the @file{amsmath} package.
+The next example uses the @package{amsmath} package.
@example
\usepackage@{amsmath@} % in preamble
@@ -4830,7 +4830,7 @@
@PkgIndex{array (package)}
@PkgIndex{dcolumn}
There are many packages concerning arrays. The @file{array} package has
-many useful extensions, including more column types. The @file{dcolumn}
+many useful extensions, including more column types. The @package{dcolumn}
package adds a column type to center on a decimal point. For both see
the documentation on CTAN.
@@ -5014,7 +5014,7 @@
For information about list layout parameters, including the default
values, and for information about customizing list layout, see
- at ref{list}. The package @file{enumitem} is useful for customizing
+ at ref{list}. The package @package{enumitem} is useful for customizing
lists.
This example changes the description labels to small caps.
@@ -5050,7 +5050,7 @@
@LaTeX{} will not break the @var{math text} across lines.
@PkgIndex{amsmath}
-Note that the @file{amsmath} package has significantly more extensive
+Note that the @package{amsmath} package has significantly more extensive
displayed equation facilities. For example, there are a number of
ways in that package for having math text broken across lines.
@@ -5211,7 +5211,7 @@
For other major @LaTeX{} labeled list environments, see
@ref{description} and @ref{itemize}. For information about list layout
parameters, including the default values, and for information about
-customizing list layout, see @ref{list}. The package @file{enumitem} is
+customizing list layout, see @ref{list}. The package @package{enumitem} is
useful for customizing lists.
@findex \labelenumi
@@ -5248,14 +5248,14 @@
@cindex equations, aligning
@cindex aligning equations
- at cindex align @r{environment, from @code{amsmath}}
+ at cindex align @r{environment, from @package{amsmath}}
@cindex amsmath @r{package, replacing @code{eqnarray}}
@cindex Madsen, Lars
The @code{eqnarray} environment is obsolete. It has infelicities,
including spacing that is inconsistent with other mathematics elements.
(See ``Avoid eqnarray!''@: by Lars Madsen
@url{https://tug.org/TUGboat/tb33-1/tb103madsen.pdf}). New documents
-should include the @file{amsmath} package and use the displayed
+should include the @package{amsmath} package and use the displayed
mathematics environments provided there, such as the @code{align}
environment. We include a description only for completeness and for
working with old documents.
@@ -5339,7 +5339,7 @@
missing dollar sign.
@PkgIndex{amsmath}
-The package @file{amsmath} package has extensive displayed equation
+The package @package{amsmath} package has extensive displayed equation
facilities. New documents should include this package.
@@ -5702,7 +5702,7 @@
@end example
@noindent
-With the default locale---without loading e.g.@: @file{babel} package
+With the default locale---without loading e.g.@: @package{babel} package
with another language than USenglish---as a top-level list each label
would come out as a bullet, @bullet{}. The format of the labeling
depends on the nesting level; see below.
@@ -5782,7 +5782,7 @@
@code{enumerate} and @code{description} environment use the same list
layout parameters. For a description, including the default values, and
for information about customizing list layout, see @ref{list}. The
-package @file{enumitem} is useful for customizing lists.
+package @package{enumitem} is useful for customizing lists.
This example greatly reduces the margin space for outermost itemized
lists.
@@ -6106,7 +6106,7 @@
@end ftable
@PkgIndex{enumitem}
-The package @code{enumitem} is useful for customizing lists.
+The package @package{enumitem} is useful for customizing lists.
This example has the labels in red. They are numbered, and the left
edge of the label lines up with the left edge of the item text.
@@ -6750,7 +6750,7 @@
@end example
@PkgIndex{graphpap}
-Draw a coordinate grid. Requires the @file{graphpap} package.
+Draw a coordinate grid. Requires the @package{graphpap} package.
The grid's origin is @code{(@var{x_init}, at var{y_init})}.
Grid lines come every @var{spacing} units (the default is 10).
The grid extends @var{x_dimen} units to the right and @var{y_dimen} units up.
@@ -6813,7 +6813,7 @@
If @var{travel} is negative then you get @code{LaTeX Error: Bad \line or
\vector argument.}
- at cindex @code{pict2e} package
+ at cindex @package{pict2e} package
@cindex graphics packages
@PkgIndex{pict2e}
@PkgIndex{TikZ}
@@ -6828,7 +6828,7 @@
(4,2) (if you choose the latter then instead of lines you get sequences
of arrowheads; the solution is to switch to the former). To get lines
of arbitrary slope and plenty of other shapes in a system like
- at code{picture}, see the package @file{pict2e}
+ at code{picture}, see the package @package{pict2e}
(@url{https://ctan.org/pkg/pict2e}). Another solution
is to use a full-featured graphics system such as TikZ, PSTricks,
MetaPost, or Asymptote.
@@ -7405,8 +7405,8 @@
This example is just for illustration of the environment. To actually
typeset computer code in typewriter like this, a verbatim environment
(@pxref{verbatim}) would normally be best. For pretty-printed code,
-there are quite a few packages, including @code{algorithm2e},
- at code{fancyvrb}, @code{listings}, and @code{minted}.
+there are quite a few packages, including @package{algorithm2e},
+ at package{fancyvrb}, @package{listings}, and @package{minted}.
@node table
@@ -7948,7 +7948,7 @@
@code{\begin@{document@}}.
@PkgIndex{babel}
-Language support packages such as @file{babel} will automatically
+Language support packages such as @package{babel} will automatically
redefine @code{\refname} or @code{\bibname} to fit the selected
language.
@@ -8225,7 +8225,7 @@
@PkgIndex{amsmath}
@PkgIndex{amsthm}
-Most new documents use the packages @code{amsthm} and @code{amsmath}
+Most new documents use the packages @package{amsthm} and @package{amsmath}
from the American Mathematical Society. Among other things these
packages include a large number of options for theorem environments,
such as styling options.
@@ -8321,7 +8321,7 @@
processing its contents, and restore it immediately afterward,
nevertheless with a macro argument the content of the argument has
already be converted to a token list along the catcode regime in effect
-when the macro was called. However, the @code{cprotect} package can
+when the macro was called. However, the @package{cprotect} package can
help with this.
@PkgIndex{listings}
@@ -8329,13 +8329,13 @@
One common use of verbatim input is to typeset computer code. There are
packages that are an improvement the @code{verbatim} environment. For
instance, one improvement is to allow the verbatim inclusion of external
-files, or parts of those files. Such packages include @code{listings},
-and @code{minted}.
+files, or parts of those files. Such packages include @package{listings},
+and @package{minted}.
@PkgIndex{fancyvrb}
@PkgIndex{verbatimbox}
A package that provides many more options for verbatim environments is
- at code{fancyvrb}. Another is @code{verbatimbox}.
+ at package{fancyvrb}. Another is @package{verbatimbox}.
For a list of all the relevant packages, see CTAN (@pxref{CTAN}).
@@ -8396,14 +8396,14 @@
@end example
@PkgIndex{url}
-For typesetting Internet addresses, urls, the package @code{url}
+For typesetting Internet addresses, urls, the package @package{url}
is a better option than the @code{\verb} command, since
it allows line breaks.
@PkgIndex{listings}
@PkgIndex{minted}
For computer code there are many packages with advantages over
- at code{\verb}. One is @file{listings}, another is @file{minted}.
+ at code{\verb}. One is @package{listings}, another is @package{minted}.
@PkgIndex{cprotect}
You cannot use @code{\verb} in the argument to a macro, for instance in
@@ -8413,7 +8413,7 @@
argument, and restore it immediately afterward, nevertheless with a
macro argument the content of the argument has already be converted to a
token list along the catcode regime in effect when the macro was called.
-However, the @code{cprotect} package can help with this.
+However, the @package{cprotect} package can help with this.
@node verse
@@ -9292,7 +9292,7 @@
@PkgIndex{cleveref}
@PkgIndex{hyperref}
-This example accomplishes the same by using the package @file{cleveref}.
+This example accomplishes the same by using the package @package{cleveref}.
@c from SE user Jake http://tex.stackexchange.com/a/10116/339
@example
@@ -9305,7 +9305,7 @@
@end example
@PkgIndex{hyperref}
-It will work with the package @file{hyperref}.
+It will work with the package @package{hyperref}.
@node \footnotetext
@@ -9447,7 +9447,7 @@
@PkgIndex{bigfoot}
Particularly in the humanities, authors can have multiple classes of
footnotes, including having footnotes of footnotes. The package
- at file{bigfoot} extends @LaTeX{}'s default footnote mechanism in many
+ at package{bigfoot} extends @LaTeX{}'s default footnote mechanism in many
ways, including allow these two, as in this example.
@example
@@ -9866,11 +9866,11 @@
@PkgIndex{suffix}
@PkgIndex{xparse}
There are two alternative ways to accomplish the work of
- at code{\@@ifstar}. (1)@tie{}The @file{suffix} package allows the
+ at code{\@@ifstar}. (1)@tie{}The @package{suffix} package allows the
construct @code{\newcommand\mycommand@{@var{unstarred-variant}@}}
followed by
@code{\WithSuffix\newcommand\mycommand*@{@var{starred-variant}@}}.
-(2)@tie{}@LaTeX{} provides the @file{xparse} package, which allows
+(2)@tie{}@LaTeX{} provides the @package{xparse} package, which allows
this code:
@example
@@ -10548,7 +10548,7 @@
@samp{summers}. (Many authors instead instead use a backslash-space
@code{\ } for this. @xref{\(SPACE)}.)
-The @file{xspace} package provides @code{\xspace}. It is for writing
+The @package{xspace} package provides @code{\xspace}. It is for writing
commands which are designed to be used mainly in text. It must be place
at the very end of the definition of these commands. It inserts a space
after that command unless what immediately follows is in a list of
@@ -11697,7 +11697,7 @@
@PkgIndex{indentfirst}
Default @LaTeX{} styles have the first paragraph after a section that is
not indented, as is traditional typesetting in English. To change that,
-look on CTAN for the package @code{indentfirst}.
+look on CTAN for the package @package{indentfirst}.
@node \parindent & \parskip
@@ -11903,8 +11903,8 @@
@PkgIndex{mathtools}
The American Mathematical Society has made freely available a set of
packages that greatly expand your options for writing mathematics,
- at file{amsmath} and @file{amssymb} (also be aware of the @file{mathtools}
-package that is an extension to, and loads, @file{amsmath}). New
+ at package{amsmath} and @file{amssymb} (also be aware of the @package{mathtools}
+package that is an extension to, and loads, @package{amsmath}). New
documents that will have mathematical text should use these packages.
Descriptions of these packages is outside the scope of this document;
see their documentation on CTAN.
@@ -12002,7 +12002,7 @@
@PkgIndex{mhchem}
A common reason to want subscripts outside of a mathematics mode is to
typeset chemical formulas. There are packages for that, such as
- at file{mhchem}; see CTAN.
+ at package{mhchem}; see CTAN.
@node Math symbols
@@ -12586,7 +12586,7 @@
@item \Re
@BES{211C,\Re} Real part, real numbers, cursive capital R (ordinary). Related:
double-line, or blackboard bold, R at tie{}@code{\mathbb@{R@}}; to access
-this, load the @file{amsfonts} package.
+this, load the @package{amsfonts} package.
@item \restriction
@BES{21BE}, Restriction of a function (relation). Synonym:
@@ -12857,13 +12857,13 @@
@item \Vert
@BES{2016,\Vert} Vertical double bar (ordinary). @xref{Delimiters},
-for how to use the @file{mathtools} package to create flexibly-sized
+for how to use the @package{mathtools} package to create flexibly-sized
norm symbols.
@item \vert
@BES{007C,\vert} Single line vertical bar (ordinary). For ``such
that'', as in the definition of a set, use at tie{}@code{\mid} because it
-is a relation. @xref{Delimiters}, for how to use the @file{mathtools}
+is a relation. @xref{Delimiters}, for how to use the @package{mathtools}
package to create flexibly-sized absolute-value symbols.
@item \wedge
@@ -12930,7 +12930,7 @@
@PkgIndex{amsfonts}
@PkgIndex{latexsym}
These are the arrows that come with standard @LaTeX{}. The
- at file{latexsym} and @file{amsfonts} packages contain many more.
+ at package{latexsym} and @package{amsfonts} packages contain many more.
@multitable @columnfractions .10 .40 .50
@headitem Symbol at tab Command at tab
@@ -12994,7 +12994,7 @@
@PkgIndex{amscd}
@PkgIndex{tikz-cd}
For commutative diagrams there are a number of packages, including
- at file{tikz-cd} and @file{amscd}.
+ at package{tikz-cd} and @package{amscd}.
@node \boldmath & \unboldmath
@@ -13046,7 +13046,7 @@
@PkgIndex{bm}
There are many issues with @code{\boldmath}. New documents should use
-the @file{bm} package provided by the @LaTeX{} Project team. A complete
+the @package{bm} package provided by the @LaTeX{} Project team. A complete
description is outside the scope of this document (see the full
documentation on CTAN) but even this small example
@@ -13180,7 +13180,7 @@
@end multitable
@PkgIndex{mathtools}
-The @file{mathtools} package allows you to create commands for paired
+The @package{mathtools} package allows you to create commands for paired
delimiters. For instance, if you put
@code{\DeclarePairedDelimiter\abs@{\lvert@}@{\rvert@}} in your preamble
then you get two commands for single-line vertical bars (they only work
@@ -13259,8 +13259,8 @@
@noindent
Note that to get a curly brace as a delimiter you must prefix it with a
-backslash, @code{\@{}. (The packages @file{amsmath} and
- at file{mathtools} allow you to get the above construct through in a
+backslash, @code{\@{}. (The packages @package{amsmath} and
+ at package{mathtools} allow you to get the above construct through in a
@code{cases} environment.)
The @code{\left ... \right} pair make a group. One consequence is that
@@ -13432,7 +13432,7 @@
@PkgIndex{amsmath}
@noindent
(many authors would replace @code{\frac} with the @code{\tfrac} command
-from the @file{amsmath} package), and as with this larger slash.
+from the @package{amsmath} package), and as with this larger slash.
@example
\begin@{equation@}
@@ -13499,7 +13499,7 @@
@item \ldots
Ellipsis on the baseline, @BES{2026,\ldots}. Used as: @code{\(
x_0,\ldots x_@{n-1@} \)}. Another example is the above array example. A
-synonym is @code{\mathellipsis}. A synonym from the @file{amsmath}
+synonym is @code{\mathellipsis}. A synonym from the @package{amsmath}
package is @code{\hdots}.
You can also use this command outside of mathematical text, as in
@@ -13514,7 +13514,7 @@
@end ftable
@PkgIndex{amsmath}
-The @file{amsmath} package has the command @code{\dots} to semantically
+The @package{amsmath} package has the command @code{\dots} to semantically
mark up ellipses. This example produces two different-looking outputs
for the first two uses of the @code{\dots} command.
@@ -13604,7 +13604,7 @@
For omicron, if you are using @LaTeX{}'s default Computer Modern font
then enter omicron just as @samp{o} or @samp{O}. If you like having the
name or if your font shows a difference then you can use something like
- at code{\newcommand\omicron@{o@}}. The package @file{unicode-math} has
+ at code{\newcommand\omicron@{o@}}. The package @package{unicode-math} has
@code{\upomicron} for upright omicron and @code{\mitomicron} for math
italic.
@@ -13836,7 +13836,7 @@
@end ftable
@PkgIndex{amsmath}
-The @file{amsmath} package adds improvements on some of these, and also
+The @package{amsmath} package adds improvements on some of these, and also
allows you to define your own. The full documentation is on CTAN, but
briefly, you can define an identity operator with
@code{\DeclareMathOperator@{\identity@}@{id@}} that is like the ones
@@ -13978,7 +13978,7 @@
@code{\(\underline@{x@}\)}. This command is fragile (@pxref{\protect}).
@PkgIndex{ulem}
-Note that the package @file{ulem} does text mode underlining and allows
+Note that the package @package{ulem} does text mode underlining and allows
line breaking as well as a number of other features. See the
documentation on CTAN. See also at tie{}@ref{\hrulefill & \dotfill} for
producing a line, for such things as a signature.
@@ -14019,7 +14019,7 @@
@end ftable
@PkgIndex{mathtools}
-The package @file{mathtools} adds an over- and underbrace, as well as
+The package @package{mathtools} adds an over- and underbrace, as well as
some improvements on the braces. See the documentation on CTAN.
@@ -14056,13 +14056,13 @@
@anchor{spacing in math mode thickspace}
@PkgIndex{amsmath}
Synonym: @code{\thickspace}. Normally @code{5.0mu plus 5.0mu}. With
-the @file{amsmath} package, or as of the 2020-10-01 @LaTeX{} release,
+the @package{amsmath} package, or as of the 2020-10-01 @LaTeX{} release,
can be used in text mode as well as math mode; otherwise, in math mode
only.
@item \negthickspace
@findex \negthickspace
-Normally @code{-5.0mu plus 2.0mu minus 4.0mu}. With the @file{amsmath}
+Normally @code{-5.0mu plus 2.0mu minus 4.0mu}. With the @package{amsmath}
package, or as of the 2020-10-01 @LaTeX{} release, can be used in text
mode as well as math mode; otherwise, in math mode only.
@@ -14073,13 +14073,13 @@
@findex \medspace
@anchor{spacing in math mode medspace}
Synonym: @code{\medspace}. Normally @code{4.0mu plus 2.0mu minus
-4.0mu}. With the @file{amsmath} package, or as of the 2020-10-01
+4.0mu}. With the @package{amsmath} package, or as of the 2020-10-01
@LaTeX{} release, can be used in text mode as well as math mode; before
that, in math mode only.
@item \negmedspace
@findex \negmedspace
-Normally @code{-4.0mu plus 2.0mu minus 4.0mu}. With the @file{amsmath}
+Normally @code{-4.0mu plus 2.0mu minus 4.0mu}. With the @package{amsmath}
package, or as of the 2020-10-01 @LaTeX{} release, can be used in text
mode as well as math mode; before that, in math mode only.
@@ -14110,7 +14110,7 @@
@cindex thin space, negative
@anchor{spacing in math mode negthinspace}
Synonym: @code{\negthinspace}. A negative thin space. Normally
- at code{-3mu}. With the @file{amsmath} package, or as of the 2020-10-01
+ at code{-3mu}. With the @package{amsmath} package, or as of the 2020-10-01
@LaTeX{} release, can be used in text mode as well as math mode;
otherwise, the @code{\!} command is math mode only but the
@code{\negthinspace} command has always also worked in text mode
@@ -14211,7 +14211,7 @@
@end example
@PkgIndex{mathtools}
-The package @code{mathtools} has operators that provide even finer
+The package @package{mathtools} has operators that provide even finer
control over smashing a subformula box.
@@ -14283,14 +14283,14 @@
convenient, including @code{\makebox} (@pxref{\mbox & \makebox}) as well
as @code{\settodepth} (@pxref{\settodepth}), @code{\settoheight}
(@pxref{\settoheight}), and @code{\settowidth} (@pxref{\settowidth}).
-In addition, the @file{mathtools} package has many commands that offer
+In addition, the @package{mathtools} package has many commands that offer
fine-grained control over spacing.
@PkgIndex{amsmath}
All three commands produce an ordinary box, without any special
mathematics status. So to do something like attaching a superscript you
should give it such a status, for example with the @code{\operatorname}
-command from the package @file{amsmath}.
+command from the package @package{amsmath}.
While most often used in mathematics, these three can appear in other
contexts. However, they don't cause @LaTeX{} to change into horizontal
@@ -14470,7 +14470,7 @@
@code{\@{x\colon 0\leq x<1\@}}.
@PkgIndex{amsmath}
-But the widely-used @file{amsmath} package defines @code{\colon} for use
+But the widely-used @package{amsmath} package defines @code{\colon} for use
in the definition of functions @code{f\colon D\to C}. So if you want
the colon character as a punctuation then use @code{\mathpunct@{:@}}.
@@ -14694,7 +14694,7 @@
the first page of an article.
@PkgIndex{fancyhdr}
-The package @file{fancyhdr} is very helpful for constructing page
+The package @package{fancyhdr} is very helpful for constructing page
styles. See its documentation on CTAN.
@menu
@@ -14848,7 +14848,7 @@
@item gobble
@PkgIndex{hyperref} @LaTeX{} does not output a page number, although it
does get reset. References to that page also are blank. (This does not
-work with the popular package @file{hyperref} so to have the page number
+work with the popular package @package{hyperref} so to have the page number
not appear you may want to instead use @code{\pagestyle@{empty@}} or
@code{\thispagestyle@{empty@}}.)
@@ -14884,7 +14884,7 @@
@PkgIndex{fancyhdr}
A discussion with an example is below. Note first that the package
- at file{fancyhdr} is now the standard way to manipulate headers and
+ at package{fancyhdr} is now the standard way to manipulate headers and
footers. New documents that need to do anything other than one of the
standard options below should use this package. See its documentation
on CTAN.
@@ -15472,7 +15472,7 @@
the newline after @samp{one}, not by the space before @samp{word}.
@c @PkgIndex{xspace}
- at c Some individual commands, notably those defined with the @code{xspace},
+ at c Some individual commands, notably those defined with the @package{xspace},
@c package do not follow the standard behavior.
@@ -15535,7 +15535,7 @@
@PkgIndex{siunitx}
@item
Between a number and its unit: @code{$745.7.8$~watts} (the
- at file{siunitx} package has a special facility for this) or
+ at package{siunitx} package has a special facility for this) or
@code{144~eggs}. This includes between a month and day number in a date:
@code{October~12} or @code{12~Oct}. In general, in any expressions where
numbers and abbreviations or symbols are separated by a space:
@@ -15607,7 +15607,7 @@
@PkgIndex{amsmath}
@LaTeX{} provides a variety of similar spacing commands for math mode
-(@pxref{Spacing in math mode}). With the @file{amsmath} package, or as
+(@pxref{Spacing in math mode}). With the @package{amsmath} package, or as
of the 2020-10-01 @LaTeX{} release, they can be used in text mode as
well as math mode, including @code{\!} for @code{\negthinspace}; but
otherwise, they are available only in math mode.
@@ -15905,7 +15905,7 @@
@PkgIndex{TikZ} @PkgIndex{Asymptote}
The @code{\strut} command is often useful in graphics, such as in
- at file{TikZ} or @file{Asymptote}. For instance, you may have a command
+ at package{TikZ} or @package{Asymptote}. For instance, you may have a command
such as @code{\graphnode@{@var{node-name}@}} that fits a circle around
@var{node-name}. However, unless you are careful the @var{node-name}'s
@samp{x} and @samp{y} will produce different-diameter circles because
@@ -16111,7 +16111,7 @@
@PkgIndex{adjustbox}
There are many packages on CTAN that are useful for manipulating boxes.
-One useful adjunct to the commands here is @file{adjustbox}.
+One useful adjunct to the commands here is @package{adjustbox}.
@menu
* \mbox & \makebox:: Horizontal boxes.
@@ -16228,8 +16228,8 @@
@PkgIndex{Asymptote}
The right edge of the output @samp{10 points } (note the ending space
after @samp{points}) will be just before the @samp{What}. You can use
- at code{\makebox} similarly when making graphics, such as in @file{TikZ}
-or @file{Asymptote}, where you put the edge of the text at a known
+ at code{\makebox} similarly when making graphics, such as in @package{TikZ}
+or @package{Asymptote}, where you put the edge of the text at a known
location, regardless of the length of that text.
For boxes with frames see at tie{}@ref{\fbox & \framebox}. For colors
@@ -17271,7 +17271,7 @@
@end example
@PkgIndex{grfext}
-To change the order, use the @code{grfext} package.
+To change the order, use the @package{grfext} package.
You can use this command anywhere in the document. You can use it more
than once. Show its value with
@@ -18081,20 +18081,20 @@
@end example
@PkgIndex{textcase}
-The @file{textcase} package brings some of the missing feature of the
+The @package{textcase} package brings some of the missing feature of the
standard @LaTeX{} commands @code{\MakeUppercase} and
@code{\MakeLowerCase}.
@PkgIndex{mfirstuc}
To uppercase only the first letter of words, you can use the package
- at file{mfirstuc}.
+ at package{mfirstuc}.
@PkgIndex{expl3}
@cindex Wright, Joseph
Handling all the casing rules specified by Unicode, e.g., for
non-Latin scripts, is a much bigger job than anything envisioned in
the original @TeX{} and @LaTeX{}. It has been implemented in the
- at code{expl3} package as of 2020. The article ``Case changing: From
+ at package{expl3} package as of 2020. The article ``Case changing: From
@TeX{} primitives to the Unicode algorithm'', (Joseph Wright,
@cite{TUGboat}@tie{}41:1,
@url{https://tug.org/TUGboat/tb41-1/tb127wright-case.pdf}), gives a
@@ -18320,7 +18320,7 @@
The Euro currency symbol: @euro{}.
@PkgIndex{eurosym}
For an alternative glyph design, try the
- at file{eurosym} package; also, most fonts nowadays come with their own
+ at package{eurosym} package; also, most fonts nowadays come with their own
Euro symbol (Unicode U+20AC).
@item \textexclamdown @r{(or @code{!`})}
@@ -18460,9 +18460,9 @@
@PkgIndex{polyglossia}
@cindex multilingual support
@LaTeX{} has wide support for many of the world's scripts and
-languages, provided through the core @code{babel} package, which
+languages, provided through the core @package{babel} package, which
supports pdf at LaTeX{}, Xe at LaTeX{} and Lua at LaTeX{}. The
- at file{polyglossia} package provides similar support with the latter
+ at package{polyglossia} package provides similar support with the latter
two engines.
This section does not cover that support. It only lists the core
@@ -18867,7 +18867,7 @@
@PkgIndex{amsthm}
@noindent
-The @file{amsthm} package includes this command, with a somewhat
+The @package{amsthm} package includes this command, with a somewhat
different-looking symbol.
The mandatory arguments give the horizontal @var{width} and vertical
@@ -18910,7 +18910,7 @@
@PkgIndex{babel}
@PkgIndex{polyglossia}
-Multilingual packages such as @file{babel} or @file{polyglossia}, or
+Multilingual packages such as @package{babel} or @package{polyglossia}, or
classes such as @file{lettre}, will localize @code{\today}. For example,
the following will output @samp{4 juillet 1976}:
@@ -18928,7 +18928,7 @@
@code{\year} (@pxref{\day & \month & \year}).
@PkgIndex{datetime}
-A number of package on CTAN work with dates. One is @file{datetime} package
+A number of package on CTAN work with dates. One is @package{datetime} package
which can produce a wide variety of date formats, including ISO standards.
The date is not updated as the @LaTeX{} process runs, so in principle the
@@ -19377,9 +19377,9 @@
@PkgIndex{tocloft}
@PkgIndex{tocbibbind}
CTAN has many packages for the table of contents and lists of figures
-and tables (@pxref{CTAN}). The package @file{tocloft} is convenient for
+and tables (@pxref{CTAN}). The package @package{tocloft} is convenient for
adjusting some aspects of the default such as spacing. And,
- at file{tocbibbind} will automatically add the bibliography, index,
+ at package{tocbibbind} will automatically add the bibliography, index,
etc. to the table of contents.
To change the header for the table of contents page, do something like
@@ -19394,7 +19394,7 @@
@noindent
@PkgIndex{babel}
@PkgIndex{polyglossia}
-Internationalization packages such as @file{babel} or @file{polyglossia}
+Internationalization packages such as @package{babel} or @package{polyglossia}
will change these headers depending on the chosen base language.
@menu
@@ -19682,14 +19682,14 @@
@PkgIndex{tocloft}
For manipulating how the @code{\contentline} material is typeset, see
-the @file{tocloft} package.
+the @package{tocloft} package.
@PkgIndex{hyperref}
-Note that the @code{hyperref} package changes the definition of
+Note that the @package{hyperref} package changes the definition of
@code{\contentsline} (and @code{\addcontentsline}) to add more
arguments, to make hyperlinks. This is the source of the error
@code{Argument of \contentsline has an extra @}} when one adds/remove
-the use of package @file{hyperref} and a compilation was already run.
+the use of package @package{hyperref} and a compilation was already run.
Fix this error by deleting the @file{.toc} or @file{.lof} or @file{.lot}
file, and running @LaTeX{} again.
@@ -19833,10 +19833,10 @@
@PkgIndex{multind}
@cindex index, multiple
@cindex multiple indexes
-There are many packages in the area of indexing. The @code{showidx}
+There are many packages in the area of indexing. The @package{showidx}
package causes each index entries to be shown in the margin on the
page where the @code{\index} appears. This can help in preparing the index.
-The @code{multind} package, among others, supports multiple indexes.
+The @package{multind} package, among others, supports multiple indexes.
See also the @TeX{} FAQ entry on this topic,
@url{https://www.texfaq.org/FAQ-multind}, and the CTAN topic,
@url{https://ctan.org/topic/index-multi}.
@@ -19930,7 +19930,7 @@
function@}@}}. You can instead get @samp{see also} with @code{seealso}.
(The text @samp{see} is defined by @code{\seename}, and @samp{see also}
by @code{\alsoname}. You can redefine these either by using an
-internationalization package such as @file{babel} or @file{polyglossia},
+internationalization package such as @package{babel} or @package{polyglossia},
or directly as with @code{\renewcommand@{\alsoname@}@{Also see@}}.)
The @samp{see} feature is part of a more general functionality. After
@@ -19981,7 +19981,7 @@
@PkgIndex{index}
A number of packages on CTAN have additional functionality beyond that
-provided by @file{makeidx}. One is @file{index}, which allows for
+provided by @package{makeidx}. One is @package{index}, which allows for
multiple indices and contains a command
@code{\index*@{@var{index-entry-string}@}} that prints the
@var{index-entry-string} as well as indexing it.
@@ -20691,7 +20691,7 @@
contains the address for each recipient.
@PkgIndex{envlab}
-The package @code{envlab} makes formatting the labels easier, with
+The package @package{envlab} makes formatting the labels easier, with
standard sizes already provided. The preamble lines
@code{\usepackage[personalenvelope]@{envlab@}} and @code{\makelabels}
are all that you need to print envelopes.
@@ -20965,7 +20965,7 @@
@PkgIndex{datatool}
@cindex mail merges
A common reason to want to read from a data file is to do mail merges.
-CTAN has a number of packages for that; one is @file{datatool}.
+CTAN has a number of packages for that; one is @package{datatool}.
@node \typein
@@ -21222,7 +21222,7 @@
A common case where authors need to write their own file is for
answers to exercises, or another situation where you want to write
out verbatim, without expanding the macros. CTAN has a number of
-packages for this; one is @file{answers}.
+packages for this; one is @package{answers}.
@menu
* \write and security:: Security.
@@ -21400,7 +21400,7 @@
You sometimes need to do a multi-step process to get the information
that you want. This will insert into the input a list of all PDF files
-in the current directory (but see @file{texosquery} below):
+in the current directory (but see @package{texosquery} below):
@example
\immediate\write18@{ls *.pdf > tmp.dat@}
@@ -21446,19 +21446,19 @@
@cindex directory listings, from system
If what you need is system information, such as the operating system
name, locale information, or directory contents, take a look at the
- at file{texosquery} package, which provides a convenient and secure
+ at package{texosquery} package, which provides a convenient and secure
interface for this, unlike the above examples using the raw
@code{\write18}: @url{https://ctan.org/pkg/texosquery}.
@PkgIndex{shellesc}
@findex \ShellEscape
@findex \DelayedShellEscape
- at LaTeX{} provides a package @code{shellesc} on top of the primitive
+ at LaTeX{} provides a package @package{shellesc} on top of the primitive
@code{\write18} command. Its primary purpose is to provide a command
@code{\ShellEscape} which works identically on all @TeX{} engines;
Lua at TeX{} intentionally did not retain @code{\write18} as a way to
invoke a shell command, so some engine-specific code is needed. The
- at code{shellesc} package also provides a command
+ at package{shellesc} package also provides a command
@code{\DelayedShellEscape}, executed at @code{\output} time, for the
same reason.
@@ -21664,7 +21664,7 @@
allows you to do some special effects.
@PkgIndex{hyperref} For example, this file (which uses the
- at file{hyperref} package for hyperlinks) can produce two kinds of
+ at package{hyperref} package for hyperlinks) can produce two kinds of
output, one to be read on physical paper and one to be read online.
@example
@@ -21898,13 +21898,13 @@
@node beamer template
- at section @code{beamer} template
+ at section @package{beamer} template
- at cindex @code{beamer} template and class
- at cindex template, @code{beamer}
+ at cindex @package{beamer} template and class
+ at cindex template, @package{beamer}
@PkgIndex{beamer}
-The @code{beamer} class creates presentation slides. It has a vast
+The @package{beamer} class creates presentation slides. It has a vast
array of features, but here is a basic template:
@verbatim
More information about the latexrefman-commits
mailing list.