[latexrefman-commits] r364 - in /trunk: ChangeLog aspell.en.pws latex2e.texi
karl at domain.hid
karl at domain.hid
Wed Jun 17 20:15:16 CEST 2015
Author: karl
Date: Wed Jun 17 20:15:15 2015
New Revision: 364
URL: http://svn.gna.org/viewcvs/latexrefman?rev=364&view=rev
Log:
wording in \newtheorem, \newfont
Modified:
trunk/ChangeLog
trunk/aspell.en.pws
trunk/latex2e.texi
Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=364&r1=363&r2=364&view=diff
==============================================================================
--- trunk/ChangeLog (original)
+++ trunk/ChangeLog Wed Jun 17 20:15:15 2015
@@ -1,3 +1,8 @@
+2015-06-17 Karl Berry <karl at domain.hid>
+
+ * latex2e.texi (\newfont): put obsolete note earlier.
+ (\newtheorem): wording.
+
2015-06-16 Karl Berry <karl at domain.hid>
* latex2e.texi (Low-level font commands): reformat the tables.
Modified: trunk/aspell.en.pws
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/aspell.en.pws?rev=364&r1=363&r2=364&view=diff
==============================================================================
--- trunk/aspell.en.pws (original)
+++ trunk/aspell.en.pws Wed Jun 17 20:15:15 2015
@@ -61,3 +61,4 @@
usrguide
Avant
Garde
+fd
Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=364&r1=363&r2=364&view=diff
==============================================================================
--- trunk/latex2e.texi (original)
+++ trunk/latex2e.texi Wed Jun 17 20:15:15 2015
@@ -3865,7 +3865,7 @@
* \newlength:: Define a new length.
* \newsavebox:: Define a new box.
* \newenvironment & \renewenvironment:: Define a new environment.
-* \newtheorem:: Define a new @code{theorem}-like environment.
+* \newtheorem:: Define a new theorem-like environment.
* \newfont:: Define a new font name.
* \protect:: Using tricky commands.
@end menu
@@ -4208,26 +4208,39 @@
@cindex theorems, defining
@cindex defining new theorems
-Define a new theorem-like environment. Synopses:
+ at cindex theorem-like environment
+ at cindex environment, theorem-like
+Define a new @dfn{theorem-like environment}. Synopses:
@example
\newtheorem at domain.hid}]
\newtheorem at domain.hid}@}
@end example
-Both create a theorem-like environment @var{name}. Using the form
- at domain.hid}]}
-with the optional argument after the second required argument, will
-create an environment whose counter will be subordinate to the counter
- at domain.hid} (it will be reset when @var{numbered_within} is
-reset). Using the form
- at domain.hid}@}}
-whose optional argument is between the two required arguments, will
-create an environment whose counter will share the previously defined
-counter @var{numbered_like}.
-
-You can specify at most one of @var{numbered_within} and
- at domain.hid}, not both.
+Both create a theorem-like environment @var{name}. Using the first
+form,
+
+ at example
+\newtheorem at domain.hid}]
+ at end example
+
+ at noindent with the optional argument after the second required argument,
+creates an environment whose counter is subordinate to the existing
+counter @var{numbered_within}: it will be reset when
+ at var{numbered_within} is reset).
+
+Using the second form,
+
+ at example
+\newtheorem at domain.hid}@}
+ at end example
+
+ at noindent with the optional argument between the two required
+arguments, will create an environment whose counter will share the
+previously defined counter @var{numbered_like}.
+
+You can specify one of @var{numbered_within} and @var{numbered_like},
+or neither, but not both.
This command creates a counter named @var{name}. In addition, unless
the optional argument @var{numbered_like} is used, the current
@@ -4241,8 +4254,8 @@
@table @var
@item name
The name of the environment. It must not begin with a backslash
-(@samp{\}). It must not be the name of an existing environment, and
-also the command name @code{\@var{name}} cannot be already defined.
+(@samp{\}). It must not be the name of an existing environment; indeed,
+the command name @code{\@var{name}} must not already be defined as anything.
@item title
The text printed at the beginning of the environment, before the
@@ -4265,58 +4278,60 @@
Without any optional arguments the environments are numbered
sequentially. This example has a declaration in the preamble that
-results in @samp{Definition 1} and @samp{Definition 2}.
+results in @samp{Definition at domain.hid} and @samp{Definition at domain.hid} in the output.
@example
\newtheorem at domain.hid@}
\begin at domain.hid@}
-\section@{..@}
+\section@{...@}
\begin at domain.hid@}
First def
\end at domain.hid@}
-\section@{..@}
+\section@{...@}
\begin at domain.hid@}
Second def
\end at domain.hid@}
@end example
-Because this example takes the optional argument @var{numbered_within}
-to be @code{section}, it gives @samp{Definition 1.1} and
- at domain.hid 2.1}.
+Because this example specifies the optional argument
+ at var{numbered_within} to @code{\newtheorem} as @code{section}, the
+example, with the same document body, gives @samp{Definition at domain.hid}
+and @samp{Definition at domain.hid}.
@example
\newtheorem at domain.hid]
\begin at domain.hid@}
-\section@{..@}
+\section@{...@}
\begin at domain.hid@}
First def
\end at domain.hid@}
-\section@{..@}
+\section@{...@}
\begin at domain.hid@}
Second def
\end at domain.hid@}
@end example
In this example there are two declarations in the preamble, the second
-of which calls for @code{thm} to use the same counter as @code{defn}.
-It gives @samp{Definition 1.1}, followed by @samp{Theorem 2.1} and
- at domain.hid 2.2}.
+of which calls for the new @code{thm} environment to use the same
+counter as @code{defn}. It gives @samp{Definition at domain.hid}, followed
+by @samp{Theorem at domain.hid} and @samp{Definition at domain.hid}.
@example
\newtheorem at domain.hid]
\newtheorem at domain.hid@}
\begin at domain.hid@}
-\section@{..@}
+\section@{...@}
\begin at domain.hid@}
First def
\end at domain.hid@}
-\section@{..@}
+\section@{...@}
\begin at domain.hid@}
First thm
\end at domain.hid@}
+
\begin at domain.hid@}
Second def
\end at domain.hid@}
@@ -4330,37 +4345,45 @@
@cindex fonts, new commands for
@cindex defining new fonts
- at domain.hid}, now obsolete, defines a command to switch fonts.
+ at code{\newfont}, now obsolete, defines a command that will switch fonts.
Synopsis:
@example
\newfont at domain.hid description}@}
@end example
-This defines a control sequence @code{\@var{cmd}} to switch the
-current font. The control sequence must must not already be defined.
-It must begin with a backslash (@samp{\}).
-
-The @var{font description} consists of a @var{fontname} and an optional
- at domain.hid} clause; see the example below. @LaTeX{} looks on your system
-for a file named @file{@var{fontname}.tfm}.
-
+This defines a control sequence @code{\@var{cmd}} that will change the
+current font. @LaTeX{} will look on your system for a file named
+ at file{@var{fontname}.tfm}. The control sequence must must not already
+be defined. It must begin with a backslash (@samp{\}).
+
+ at findex .fd @r{file}
This command is obsolete. It is a low-level command for setting up an
-individual font. Today fonts are defined in families (which allows
-you to, for example, associate a boldface with a roman) through the
-so-called ``New Font Selection Scheme'', either by using @file{.fd}
-files or through the use of an engine that can access system fonts
-such as Xe at domain.hid{} (@pxref{@TeX{} engines}).
+individual font. Today fonts are almost always defined in families
+(which allows you to, for example, associate a boldface with a roman)
+through the so-called ``New Font Selection Scheme'', either by using
+ at file{.fd} files or through the use of an engine that can access
+system fonts such as Xe at domain.hid{} (@pxref{@TeX{} engines}).
@c xx explain nfss somewhere
-This example sets the second string of characters using Computer Modern
-Roman 12 point at a magnified size.
-
- at domain.hid
-\newfont at domain.hid scaled 1200@}
-abcdef
-\testfont
-abcdef
+ at cindex at clause, in font definitions
+ at cindex design size, in font definitions
+But since it is part of @LaTeX{}, here is an explanation: the
+ at var{font description} consists of a @var{fontname} and an optional
+ at dfn{at clause}; this can have the form either @code{at @var{dimen}}
+or @code{scaled @var{factor}}, where a @var{factor} of @samp{1000}
+means no scaling. For @LaTeX{}'s purposes, all this does is scale all
+the character and other font dimensions relative to the font's design
+size, which is a value defined in the @file{.tfm} file.
+
+This example defines two equivalent fonts and typesets a few
+characters in each:
+
+ at example
+\newfont at domain.hid at 11pt@}
+\newfont at domain.hid scaled 11pt@}
+\testfontat abc
+\testfontscaled abc
@end example
@@ -4368,7 +4391,6 @@
@section @code{\protect}
@findex \protect
-
@cindex fragile commands
@cindex robust commands
@cindex moving arguments
More information about the latexrefman-commits
mailing list