From a3f89152f66285a955a51e3dbeeae31e1f8a63e1 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 15 May 2013 21:52:09 +0000 Subject: latex2e-help-texinfo (15may13) git-svn-id: svn://tug.org/texlive/trunk@30487 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/latex2e-help-texinfo/latex2e.dbk | 131 +++++++++++++-------- 1 file changed, 85 insertions(+), 46 deletions(-) (limited to 'Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk') diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk index 6d42c9c12d1..94aba2c18a0 100644 --- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk +++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo/latex2e.dbk @@ -4,14 +4,15 @@ ]> -&latex;2e reference manual (May 2012) +&latex;2e reference manual (May 2013) - + + @@ -19,12 +20,12 @@ + - - + This document is an unofficial reference manual for &latex;, a -document preparation system, version of May 2012. +document preparation system, version of May 2013. This manual was originally translated from LATEX.HLP v1.0a in the VMS Help Library. The pre-translation version was written by @@ -38,7 +39,7 @@ and C. Biemesderfer (published by the &tex; Users Group as &tex;niques number 10), as reference material (no text was directly copied). -Copyright © 2007, 2008, 2009, 2010, 2011, 2012 Karl Berry. +Copyright © 2007, 2008, 2009, 2010, 2011, 2012, 2013 Karl Berry. Copyright © 1988, 1994, 2007 Stephen Gilmore. @@ -60,7 +61,7 @@ into another language, under the above conditions for modified versions. This document is an unofficial reference manual for &latex;, a -document preparation system, version of May 2012. +document preparation system, version of May 2013. This manual was originally translated from LATEX.HLP v1.0a in the VMS Help Library. The pre-translation version was written by @@ -74,7 +75,7 @@ and C. Biemesderfer (published by the &tex; Users Group as &tex;niques number 10), as reference material (no text was directly copied). -Copyright © 2007, 2008, 2009, 2010, 2011, 2012 Karl Berry. +Copyright © 2007, 2008, 2009, 2010, 2011, 2012, 2013 Karl Berry. Copyright © 1988, 1994, 2007 Stephen Gilmore. @@ -99,7 +100,7 @@ into another language, under the above conditions for modified versions. &latex;2e This document is an unofficial reference manual for &latex;, a -document preparation system, version as of May 2012. It is +document preparation system, version as of May 2013. It is intended to cover &latex;2e, which has been the standard version of &latex; for many years. @@ -135,17 +136,17 @@ infrastructure. Of course, there are many, many other sources of information about &latex;. Here are a few: - +http://www.ctan.org/pkg/latex-doc-ptr Two pages of recommended references to &latex; documentation. - +http://www.ctan.org/pkg/first-latex-doc Writing your first document, with a bit of both text and math. - +http://www.ctan.org/pkg/usrguide The guide for document authors maintained as part of &latex;; there are several others. - +http://tug.org/begin.html Introduction to the &tex; system, including &latex;. @@ -458,40 +459,50 @@ instance, \begin{ttfamily}...\end{ttfamily}. \textbf \bfseries Boldface. -\textup (\upshape) + +\textup (\upshape) \textup \upshape Upright (default). The opposite of slanted. -\textsl (\slshape) + +\textsl (\slshape) \textsl \slshape Slanted. -\textsf (\sffamily) + +\textsf (\sffamily) \textsf \sffamily Sans serif. -\textsc (\scshape) + +\textsc (\scshape) \textsc \scshape Small caps. -\texttt (\ttfamily) + +\texttt (\ttfamily) \texttt \ttfamily Typewriter. -\textnormal (\normalfont) + +\textnormal (\normalfont) \textnormal \normalfont Main document font. -\mathrm + +\mathrm \mathrm Roman, for use in math mode. -\mathbf + +\mathbf \mathbf Boldface, for use in math mode. -\mathsf + +\mathsf \mathsf Sans serif, for use in math mode. -\mathtt + +\mathtt \mathtt Typewriter, for use in math mode. @@ -502,16 +513,32 @@ instance, \begin{ttfamily}...\end{ttfamily}. \mathnormal \mathnormal For use in math mode, e.g. inside another type style declaration. -\mathcal + +\mathcal \mathcal ‘Calligraphic’ letters, for use in math mode. - -In addition, the command -\mathversion{bold} + + \mathversion -can be used for switching to bold letters and symbols in +In addition, the command \mathversion{bold} can be used for +switching to bold letters and symbols in formulas. \mathversion{normal} restores the default. +\oldstylenums +numerals, old-style +old-style numerals +lining numerals +textcomp package +Finally, the command \oldstylenums{numerals} will +typeset so-called “old-style” numerals, which have differing heights +and depths (and sometimes widths) from the standard “lining” +numerals. &latex;’s default fonts support this, and will respect +\textbf (but not other styles; there are no italic old-style +numerals in Computer Modern). Many other fonts have old-style +numerals also; sometimes the textcomp package must be loaded, +and sometimes package options are provided to make them the default. +FAQ entry: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf. + &latex; also provides these commands, which unconditionally switch to the given style, that is, are not cumulative. They are used differently than the above commands, too: {\cmd ...} @@ -1793,9 +1820,11 @@ point and a minus sign—a number like 5, 0.3-3.1416. A coordinate specifies a length in multiples of the unit length \unitlength, so if \unitlength has been set to 1cm, then the coordinate 2.54 specifies a length of 2.54 -centimeters. You should only change the value of \unitlength, -using the \setlength command, outside of a picture -environment. +centimeters. + +You should only change the value of \unitlength, using the +\setlength command, outside of a picture environment. +The default value is 1pt. A position is a pair of coordinates, such as (2.4,-5), specifying the point with x-coordinate 2.4 and y-coordinate -5. @@ -3070,13 +3099,15 @@ footnotes. This is ‘6.65pt’ for ‘ \newcommand and \renewcommand define and redefine a command, respectively. Synopses: - \newcommand{cmd}[nargs]{defn} -\renewcommand{cmd}[nargs]{defn} - \newcommand{cmd}[nargs][default]{defn} -\renewcommand{cmd}[nargs][default]{defn} + \newcommand[*]{cmd}[nargs][optarg]{defn} +\renewcommand[*]{cmd}[nargs][optarg]{defn} - -cmd +* +*-form of defining new commands +The *-form of these commands requires that the arguments not contain +multiple paragraphs of text (not \long, in plain &tex; terms). + +cmd The command name beginning with \. For \newcommand, it must not be already defined and must not begin with \end; for \renewcommand, it must already be defined. @@ -3086,11 +3117,12 @@ must not be already defined and must not begin with \end; for that the command will take. The default is for the command to have no arguments. -default +optarg If this optional parameter is present, it means that the command’s -first argument is optional. When the new command is called, the -default value of the optional argument (i.e., if it is not specified -in the call) is the string ‘def’. +first argument is optional. The default value of the optional +argument (i.e., if it is not specified in the call) is optarg, +or, if that argument is present in the \newcommand but has an +empty value, the string ‘def’. defn The text to be substituted for every occurrence of cmd; a @@ -3162,14 +3194,18 @@ defined, to refer to a new bin for storing boxes. Synopses: - \newenvironment{env}[nargs]{begdef}{enddef} - \newenvironment{env}[nargs][default]{begdef}{enddef} -\renewenvironment{env}[nargs]{begdef}{enddef} + \newenvironment[*]{env}[nargs][default]{begdef}{enddef} +\renewenvironment[*]{env}[nargs]{begdef}{enddef} These commands define or redefine an environment env, that is, \begin{env} … \end{env}. -env +* +*-form of environment commands +The *-form of these commands requires that the arguments (not the +contents of the environment) not contain multiple paragraphs of text. + +env The name of the environment. For \newenvironment, env must not be an existing environment, and the command \env must be undefined. For \renewenvironment, env must be @@ -4879,6 +4915,7 @@ a capital letter. Here are side-by-side examples with and without
… in C. Pascal, though … + … in C. Pascal, though …
@@ -6420,8 +6457,10 @@ The end. \end{frame} \end{document} -
+One web resource for this: +http://robjhyndman.com/hyndsight/beamer/. + -- cgit v1.2.3