[latexrefman-commits] r389 - in /trunk: ChangeLog latex2e.texi
jhefferon at domain.hid
jhefferon at domain.hid
Sat Aug 1 13:04:19 CEST 2015
Author: jhefferon
Date: Sat Aug 1 13:04:18 2015
New Revision: 389
URL: http://svn.gna.org/viewcvs/latexrefman?rev=389&view=rev
Log:
Adjust wording on tabular-related nodes
Modified:
trunk/ChangeLog
trunk/latex2e.texi
Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=389&r1=388&r2=389&view=diff
==============================================================================
--- trunk/ChangeLog (original)
+++ trunk/ChangeLog Sat Aug 1 13:04:18 2015
@@ -1,4 +1,9 @@
-2015-07-22 Jim Hefferon <jhefferon at domain.hid>
+2015-08-01 Jim Hefferon <jhefferon at domain.hid>
+
+ * latex2e.texi (multicolumn, vline, cline, hline): Adjust
+ wording.
+
+2015-07-31 Jim Hefferon <jhefferon at domain.hid>
* latex2e.texi (vline, cline, hline): Add examples. Also describe
how columns are counted.
Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=389&r1=388&r2=389&view=diff
==============================================================================
--- trunk/latex2e.texi (original)
+++ trunk/latex2e.texi Sat Aug 1 13:04:18 2015
@@ -2,7 +2,7 @@
@c $Id$
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename latex2e.info
- at domain.hid UPDATED July 2015
+ at set UPDATED August 2015
@settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
@comment %**end of header (This is for running Texinfo on a region.)
@@ -3396,38 +3396,44 @@
\multicolumn at domain.hid}@}
@end example
-Make an entry that spans several columns. The first argument
- at domain.hid} specifies the number of columns to span. The second
-argument @var{cols} specifies the formatting of the entry, with @code{c}
-for centered, @code{l} for flushleft, or @code{r} for flushright. The
-third argument @var{text} specifies the contents of that entry.
-
-The @var{cols} argument can also contain vertical bars @code{|},
-indicating the placement of vertical rules, and @code{@@@{..@}}
-expressions. Thus if @var{cols} is @samp{|c|} then a vertical rule will
-come at the start and end of each of that column's entries, which will
-be centered.
-
-The number of spanned columns @var{numcols} can be 1. This is useful to
+Make an @code{array} or @code{tabular} entry that spans several columns.
+The first argument @var{numcols} gives the number of columns to span.
+The second argument @var{cols} specifies the formatting of the entry,
+with @code{c} for centered, @code{l} for flush left, or @code{r} for
+flush right. The third argument @var{text} specifies the contents of
+that entry.
+
+The @var{cols} argument overrides the @code{array} or @code{tabular}
+environment's intercolumn area default adjoining this multicolumn
+entry. To affect that area, this argument can contain vertical bars
+ at code{|} indicating the placement of vertical rules, and @code{@@@{..@}}
+expressions. Thus if @var{cols} is @samp{|c} then this multicolumn
+entry will be centered, a vertical rule will come in the intercolumn
+area before it, and no vertical rule will come in the intercolumn area
+after it.
+
+The number of spanned columns @var{numcols} can be 1. Besides giving
+the ability to change the horizontal alignment, this also is useful to
override for one row the specification given in the @code{tabular}
-definition, including the placement of vertical rules.
-
-The set of spanned columns is counted as:@tie{}the specifier in
- at domain.hid argument is broken into parts, where each part (except
-the first) begins with @code{l}, @code{c}, @code{r}, or at domain.hid},
-and then the given number of parts is taken.
+definition, including the placement of vertical rules. See the example
+below where the column titles in the first row are centered and no
+vertical rule appears in the firs row, while one appears in the other
+rows between the first two columns.
+
+What counts as a column is:@tie{}the column format specifier for the
+ at code{array} or @code{tabular} environment is broken into parts, where
+each part (except the first) begins with @code{l}, @code{c}, @code{r},
+or at domain.hid}. So from @code{\begin at domain.hid@}|@}}
+the parts are @code{|r|}, @code{c}, @code{c},
+and~@tie{}@code{p at domain.hid@}|}.
In the example below, in the @code{tabular} definition the first column
-is specified as right-justified but in the first row the entry is
-centered with @code{\multicolumn at domain.hid@}@}}. Also in
-the first row, the second and third columns are spanned by a single
-entry with @code{\multicolumn at domain.hid@}@}}. Because
-the second and third column are arranged to center on the page range
-en-dash at domain.hid} this organizes the information into a single
-unit. In addition, although the @code{tabular} specification puts a
-vertical rule between the columns, because there is no vertical bar in
-the @var{pos} of either @code{\multicolumn} command, no rule appears in
-the first row.
+is specified to default to as right-justified but in the first row the
+entry is centered with @code{\multicolumn at domain.hid@}@}}.
+Also in the first row, the second and third columns are spanned by a
+single entry with @code{\multicolumn at domain.hid@}@}},
+overriding the specification to center those two columns on the page
+range double-dash.
@example
\begin at domain.hid@}
@@ -3438,19 +3444,35 @@
\end at domain.hid@}
@end example
+Note that although the @code{tabular} specification by default puts a
+vertical rule between the first and second columns, because there is no
+vertical bar in the @var{cols} of either of the first row's
+ at code{\multicolumn} commands, no rule appears in the first row.
+
@node \vline
@subsection @code{\vline}
@findex \vline
-Draw a vertical line extending the full height and depth of this entry's
-row. Can also be used in an @@-expression, although its synonym
-vertical bar at domain.hid{|} is more common.
-
-This command is rarely used; more typically the table's vertical lines
-are specified in @code{tabular}'s @var{cols} argument and overriden as
-needed with @code{\multicolumn}. This example illustrates some pitfalls.
+Draw a vertical line in a @code{tabular} or @code{array} environment
+extending the full height and depth of an entry's row. Can also be used
+in an @@-expression, although its synonym vertical bar at domain.hid{|} is
+more common. This command is rarely used; typically a table's vertical
+lines are specified in @code{tabular}'s @var{cols} argument and
+overriden as needed with @code{\multicolumn}.
+
+This example illustrates some pitfalls. In the first line's second
+entry the @code{\hfill} moves the @code{\vline} to the left edge of the
+cell. But that is different than putting it halfway between the two
+columns, so in that row between the first and second columns there are
+two vertical rules, with the one from the @code{@{c|cc@}} specifier
+coming before the one produced by the @code{\vline\hfill}. In contrast,
+the first line's third entry shows the usual way to put a vertical bar
+between two columns. In the second line, the @code{ghi} is the widest
+entry in its column so in the @code{\vline\hfill} the @code{\hfill} has
+no effect and the vertical line in that entry appears immediately next
+to the @code{g}, with no whitespace.
@example
\begin at domain.hid@}
@@ -3459,15 +3481,6 @@
\end at domain.hid@}
@end example
-In the first line's second entry the @code{\hfill} moves the
- at domain.hid} to the left edge of the cell. But that is different than
-putting it halfway between the two columns, so the vertical bar from the
- at domain.hid@}} specifier comes before the one produced by
- at domain.hid}. The first line's third entry gives the usual way
-to put a vertical bar between the two columns. In the second line, the
- at domain.hid} is the widest entry in its column so @code{\vline\hfill} puts
-the vertical line immediately next to the @code{g}, with no whitespace.
-
@node \cline
@subsection @code{\cline}
@@ -3480,13 +3493,15 @@
\cline at domain.hid}@}
@end example
-Draw a horizontal rule beginning in column @var{i} and ending in column
- at domain.hid} The dash at domain.hid} must appear in the mandatory
-argument. To span a single column use equal numbers.
+Draw a horizontal rule in an @code{array} or @code{tabular} environment
+beginning in column @var{i} and ending in column @var{j}. The
+dash at domain.hid} must appear in the mandatory argument. To span a
+single column use the number twice.
This example puts two horizontal lines between the first and second
-rows, one line only in the first column and the other spanning the third
-and fourth columns. The two lines are at the same height.
+rows, one line in the first column only, and the other spanning the
+third and fourth columns. The two lines are side-by-side, at the same
+height.
@example
\begin at domain.hid@}
@@ -3505,10 +3520,11 @@
@code{array} environment. It's most commonly used to draw a line at the
top, bottom, and between the rows of a table.
-Here the top of the table has two horizontal rules, one above the other,
-that span both columns. The bottom of the table has a single rule.
-Because of the @code{\hline} the second line's line ending double
-backslash at domain.hid{\\} is required.
+In this example the top of the table has two horizontal rules, one above
+the other, that span both columns. The bottom of the table has a single
+rule spanning both columns. Because of the @code{\hline}, the
+ at code{tabular} second row's line ending double backslash at domain.hid{\\}
+is required.
@example
\begin at domain.hid@} \hline\hline
More information about the latexrefman-commits
mailing list