[latexrefman-commits] [SCM] latexrefman updated: r954 - trunk
Vincent Belaiche
INVALID.NOREPLY at gnu.org.ua
Wed Aug 11 15:16:49 CEST 2021
Author: vincentb1
Date: 2021-08-11 13:16:49 +0000 (Wed, 11 Aug 2021)
New Revision: 954
Modified:
trunk/ChangeLog
trunk/latex2e.texi
Log:
[en] clarify Modes and much more.
* latex2e.texi (\newlength): ``command sequence'' -> ``control sequene''.
(Making paragraphs): Clarify the empty lines are in the source
code. Clarify that the paragrapgh separation can have more than
one blank line, and the line may be not empty for the
blanks. ``line'' -> ``blank line'' where applicable for clarity. Typo.
(\par): Refer to node ``Making paragraph'' for the usual par
separator. Fix description of what \par does in LR and in
paragraph mode.
(Modes): Clarify that ``paragraph mode'' is the same as
``horizontal mode'' and the the actual page breaks occur in outer
vertical mode, horizontal mode gets just the line break positions.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2021-08-11 06:29:01 UTC (rev 953)
+++ trunk/ChangeLog 2021-08-11 13:16:49 UTC (rev 954)
@@ -1,5 +1,19 @@
2021-08-11 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+ * latex2e.texi (\newlength): ``command sequence'' -> ``control sequene''.
+ (Making paragraphs): Clarify the empty lines are in the source
+ code. Clarify that the paragrapgh separation can have more than
+ one blank line, and the line may be not empty for the
+ blanks. ``line'' -> ``blank line'' where applicable for clarity. Typo.
+ (\par): Refer to node ``Making paragraph'' for the usual par
+ separator. Fix description of what \par does in LR and in
+ paragraph mode.
+ (Modes): Clarify that ``paragraph mode'' is the same as
+ ``horizontal mode'' and the the actual page breaks occur in outer
+ vertical mode, horizontal mode gets just the line break positions.
+
+2021-08-11 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+
* latex2e.texi (\newcommand & \renewcommand): ``alphabetic control
sequence'' -> ``control word''.
(Control sequences): new node.
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-08-11 06:29:01 UTC (rev 953)
+++ trunk/latex2e.texi 2021-08-11 13:16:49 UTC (rev 954)
@@ -9861,7 +9861,7 @@
@end example
If you forget the backslash then you get @samp{Missing control sequence
-inserted}. If the command sequence already exists then you get
+inserted}. If the control sequence already exists then you get
something like @samp{LaTeX Error: Command \graphichgt already defined.
Or name \end... illegal, see p.192 of the manual}.
@@ -11383,8 +11383,8 @@
@cindex paragraphs
To start a paragraph, just type some text. To end the current
-paragraph, put an empty line. This is three paragraphs, separated by
-two empty lines.
+paragraph, put an empty line. This is three paragraphs, the
+separatation of which is made by two empty lines.
@example
It is a truth universally acknowledged, that a single man in possession
@@ -11399,15 +11399,35 @@
``have you heard that Netherfield Park is let at last?''
@end example
-The separator lines must be empty, including not containing a comment
-character, @code{%}.
+The paragraph separator can be made of any sequence of at least one
+blank line, amongst which at least one is not terminated by a comment. A
+blank line is a line that is empty or made only of blank characters such
+as space or tab. Comments in source code are started with a @code{%} and
+span up to the end of line. In the following example the two columns are
+identical:
+ at example
+\documentclass[twocolumn]@{article@}
+\begin@{document@}
+First paragraph.
+
+Second paragraph.
+\newpage
+First paragraph.
+
+ % separator lines may contain blank characters.
+
+Second paragraph.
+\end@{document@}
+ at end example
+
+
Once @LaTeX{} has gathered all of a paragraph's contents it divides that
content into lines in a way that is optimized over the entire paragraph
(@pxref{Line breaking}).
There are places where a new paragraph is not permitted. Don't put a
-blank line in math mode (@pxref{Modes}); here the line before the
+blank line in math mode (@pxref{Modes}); here the blank line before the
@code{\end@{equation@}}
@example
@@ -11419,7 +11439,7 @@
@noindent
will get you the error @samp{Missing $ inserted}. Similarly, the blank
-line in this @code{section} argument
+line in this @code{\section} argument
@example
\section@{aaa
@@ -11446,8 +11466,8 @@
@findex \par
@cindex paragraph, ending
-Synopsis (note that while reading the input @TeX{} converts two
-consecutive newlines to a @code{\par}):
+Synopsis (note that while reading the input @TeX{} converts any sequence
+of one or more blank lines to a @code{\par}, @ref{Making paragraphs}):
@example
\par
@@ -11465,18 +11485,18 @@
\whatCheatingIs\par\whatHappensWhenICatchYou@}
@end example
-In LR mode or a vertical mode the @code{\par} command does nothing but
-it terminates paragraph mode, switching @LaTeX{} to vertical mode
-(@pxref{Modes}).
+In LR mode the @code{\par} command does nothing and is ignored. In
+pragraph mode, the @code{\par} command terminates paragraph mode,
+switching @LaTeX{} to vertical mode (@pxref{Modes}).
You cannot use the @code{\par} command in a math mode. You also cannot
-use it in the argument of many commands, such as the @code{\section}
-command (@pxref{Making paragraphs} and @ref{\newcommand &
-\renewcommand}).
+use it in the argument of many commands, such as the sectionning
+commands, e.g.@: @code{\section} (@pxref{Making paragraphs} and
+ at ref{\newcommand & \renewcommand}).
The @code{\par} command is not the same as the @code{\paragraph}
command. The latter is, like @code{\section} or @code{\subsection}, a
-sectioning unit used by the standard @LaTeX{} documents
+sectioning command used by the @LaTeX{} document standard classes
(@pxref{\subsubsection & \paragraph & \subparagraph}).
The @code{\par} command is not the same as @code{\newline} or the line
@@ -14450,9 +14470,11 @@
@item
@anchor{modes paragraph mode}
@cindex paragraph mode
- at dfn{Paragraph mode} is what @LaTeX{} is in when processing ordinary
-text. It breaks the input text into lines and breaks the lines into
-pages. This is the mode @LaTeX{} is in most of the time.
+ at dfn{Paragraph mode} (in plain @TeX{} this is called @dfn{horizontal
+mode}) is what @LaTeX{} is in when processing ordinary text. It breaks
+the input text into lines and finds the positions of line breaks, so that
+in vertical mode page breaks can be done. This is the mode @LaTeX{} is
+in most of the time.
@cindex left-to-right mode
@cindex LR mode
@@ -14480,15 +14502,16 @@
@item
@cindex vertical mode
- at anchor{modes vertical mode}
- at dfn{Vertical mode} is when @LaTeX{} is building the list of lines and
-other material making the output page. This is the mode @LaTeX{} is in
-when it starts a document.
+ at anchor{modes vertical mode} @dfn{Vertical mode} is when @LaTeX{} is
+building the list of lines and other material making the output page,
+which comprises insertion of page breaks. This is the mode @LaTeX{} is
+in when it starts a document.
@cindex internal vertical mode
@anchor{modes internal vertical mode}
@dfn{Internal vertical mode} is in effect when @LaTeX{} starts making a
- at code{\vbox}. This is the vertical analogue of LR mode.
+ at code{\vbox}. It has not such thing as page breaks, and as such is the
+vertical analogue of LR mode.
@end itemize
More information about the latexrefman-commits
mailing list.