[latexrefman-commits] [SCM] latexrefman updated: r571 - trunk
vincentb1 at gnu.org.ua
vincentb1 at gnu.org.ua
Mon Jul 31 00:42:27 CEST 2017
Author: vincentb1
Date: 2017-07-31 01:42:27 +0300 (Mon, 31 Jul 2017)
New Revision: 571
Modified:
trunk/latex2e.texi
Log:
Fix URL & BUG report addresses.
* latex2e.texi (document header): @include common.texi for URL's
and other flags that we want to make common between all the translations.
(document titlepage): take home page URL from common.texi
(About this document): take home page URL from common.texi, same
for bug report address. @cindex bug report.
(Floats): @PkgIndex{flafter}.
(\@@startsection): @code{}-ify book and report class names.
(array): @PkgIndex{amsmath}.
(displaymath): @var{}-ify `math text'. Move upward sentence
`@LaTeX{} will not break the @var{math text} across lines.' in
order not to interrupt description about equation
numbering. @PkgIndex{amsmath}. Suppress verbous sentance `Those
facilities are the best approach for such output in new
documents.' and replace by add `significantly more' before
`extensive displayed equation facilities'. `options' -> `ways' in
order not to create confusion with package options.
(\parbox): @dfn{}-ize and @cindex-ize `paragraphe mode', so remove
@code{} around `paragraph'.
(\includeonly): Typo.
(\addcontentsline): extension -> filename extension.
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2017-07-30 22:40:51 UTC (rev 570)
+++ trunk/latex2e.texi 2017-07-30 22:42:27 UTC (rev 571)
@@ -3,6 +3,7 @@
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename latex2e.info
@set UPDATED November 2016
+ at include common.texi
@settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
@comment %**end of header (This is for running Texinfo on a region.)
@@ -84,7 +85,7 @@
@titlepage
@title @LaTeX{}2e: An unofficial reference manual
@subtitle @value{UPDATED}
- at author @url{http://home.gna.org/latexrefman}
+ at author @url{@value{LTXREFMAN_HOME_PAGE}}
@page
@vskip 0pt plus 1filll
@insertcopying
@@ -176,13 +177,11 @@
@node About this document
@chapter About this document
- at cindex bug reporting
- at cindex reporting bugs
- at findex @url{http://home.gna.org/latexrefman} @r{home page}
+ at findex @url{@value{LTXREFMAN_HOME_PAGE}} @r{home page}
This is an unofficial reference manual for the @LaTeX{}2e document
preparation system, which is a macro package for the @TeX{}
typesetting program (@pxref{Overview}). This document's home page is
- at url{http://home.gna.org/latexrefman}. That page has links to the
+ at url{@value{LTXREFMAN_HOME_PAGE}}. That page has links to the
current output in various formats, sources, mailing list archives and
subscriptions, and other infrastructure.
@@ -193,14 +192,16 @@
@cindex unofficial nature of this manual
@cindex @LaTeX{} Project team
- at findex @email{latexrefman-discuss@@gna.org} @r{email address}
+ at findex @email{@value{LTXREFMAN_BUGS}} @r{email address}
@LaTeX{} is currently maintained by a group of volunteers
(@url{http://latex-project.org}). The official documentation written by
the @LaTeX{} project is available from their web site. This document is
completely unofficial and has not been reviewed by the @LaTeX{}
-maintainers. Do not send bug reports or anything else about this
-document to them. Instead, please send all comments to
- at email{latexrefman-discuss@@gna.org}.
+maintainers.
+ at cindex bug reporting
+ at cindex reporting bugs
+Do not send bug reports or anything else about this document to them.
+Instead, please send all comments to @email{@value{LTXREFMAN_BUGS}}.
This document is a reference. There is a vast array of other sources
of information about @LaTeX{}, at all levels. Here are a few
@@ -2323,6 +2324,7 @@
@code{\afterpage@{\clearpage@}}. This will wait until the current page
is finished and then flush all outstanding floats.
+ at PkgIndex{flafter}
@LaTeX{} can typeset a float before where it appears in the source
(although on the same output page) if there is a @code{t} specifier in
the @var{placement} parameter. If this is not desired, and deleting
@@ -2511,7 +2513,7 @@
Note that the @file{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{} book and report classes the commands
+the standard @LaTeX{} @code{book} and @code{report} classes the commands
@code{\chapter} and @code{\report} are not constructed in this way. To
make such a command you may want to use the @code{\secdef} command.
@c xx define, and make a cross reference to, secdef.
@@ -3009,6 +3011,7 @@
@code{\arraycolsep}, which gives half the width between columns. The
default for this is @samp{5pt}.
+ at PkgIndex{amsmath}
To obtain arrays with braces the standard is to use the @file{amsmath}
package. It comes with environments @code{pmatrix} for an array
surrounded by parentheses at tie{}@code{(...)}, @code{bmatrix} for an array
@@ -3201,7 +3204,7 @@
@example
\begin@{displaymath@}
- ... math text ...
+ at var{math text}
\end@{displaymath@}
@end example
@@ -3209,29 +3212,29 @@
and centered. To make the text be flush-left use the global option
@code{fleqn}; see @ref{Document class options}.
- at LaTeX{} will not break the math text across lines.
-
In the @code{displaymath} environment no equation number is added to the
math text. One way to get an equation number is to use the
@code{equation} environment (@pxref{equation}).
-Note that the @file{amsmath} package has extensive displayed equation
-facilities. Those facilities are the best approach for such output in
-new documents. For example, there are a number of options in that
-package for having math text broken across lines.
+ at LaTeX{} will not break the @var{math text} across lines.
-The construct @code{\[..math text..\]} is essentially a synonym for
- at code{\begin@{displaymath@}..math text..\end@{displaymath@}} but the
+ at PkgIndex{amsmath}
+Note that the @file{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.
+
+The construct @code{\[@var{math text}\]} is essentially a synonym for
+ at code{\begin@{displaymath@}@var{math text}\end@{displaymath@}} but the
latter is easier to work with in the source file; for instance,
searching for a square bracket may get false positives but the word
- at code{displaymath} will likely be unique. (The construct @code{$$..math
-text..$$} from Plain at tie{}@TeX{} is sometimes mistakenly used as a
-synonym for @code{displaymath}. It is not a synonym, because the
- at code{displaymath} environment checks that it isn't started in math mode
-and that it ends in math mode begun by the matching environment start,
-because the @code{displaymath} environment has different vertical
-spacing, and because the @code{displaymath} environment honors the
- at code{fleqn} option.)
+ at code{displaymath} will likely be unique. (The construct
+ at code{$$@var{math text}$$} from Plain at tie{}@TeX{} is sometimes
+mistakenly used as a synonym for @code{displaymath}. It is not a
+synonym, because the @code{displaymath} environment checks that it isn't
+started in math mode and that it ends in math mode begun by the matching
+environment start, because the @code{displaymath} environment has
+different vertical spacing, and because the @code{displaymath}
+environment honors the @code{fleqn} option.)
The output from this example is centered and alone on its line.
@example
@@ -9320,8 +9323,9 @@
\parbox[@var{position}][@var{height}][@var{inner-pos}]@{@var{width}@}@{@var{text}@}
@end example
+ at cindex paragraph mode
The @code{\parbox} command produces a box whose contents are created
-in @code{paragraph} mode. It should be used to make a box small
+in @dfn{paragraph mode}. It should be used to make a box small
pieces of text, with nothing fancy inside. In particular, you
shouldn't use any paragraph-making environments inside a
@code{\parbox} argument. For larger pieces of text, including ones
@@ -10188,7 +10192,7 @@
@node \includeonly
- at section \@code{includeonly}
+ at section @code{\includeonly}
@findex \includeonly
@@ -10291,7 +10295,7 @@
@table @var
@item ext
-The extension of the file on which information is to be written,
+The filename extension of the file on which information is to be written,
typically one of: @code{toc} (table of contents), @code{lof} (list of
figures), or @code{lot} (list of tables).
More information about the latexrefman-commits
mailing list