[latexrefman-commits] r390 - in /trunk: ChangeLog latex2e.texi

[jhefferon at domain.hid]

Author: jhefferon
Date: Sun Aug  2 20:08:26 2015
New Revision: 390

URL: http://svn.gna.org/viewcvs/latexrefman?rev=390&view=rev
Log:
multicolumn intercolumn material

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=390&r1=389&r2=390&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sun Aug  2 20:08:26 2015
@@ -1,3 +1,8 @@
+2015-08-02  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (multicolumn): Adjust description of how intercolumn
+	material is placed.  I shall get this right eventually, I suppose.
+
 2015-08-01  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (multicolumn, vline, cline, hline): Adjust

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=390&r1=389&r2=390&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sun Aug  2 20:08:26 2015
@@ -3400,47 +3400,77 @@
 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 domain.hid{|} 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.  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.
+flush right.  The third argument @var{text} gives the contents of that
+entry.
+
+In this example, in the first row, the second and third columns are
+spanned by the single heading @samp{Name}.
+
+ at example
+\begin at domain.hid@} 
+  \textit at domain.hid@}       &\multicolumn at domain.hid@}@} &\textit at domain.hid@} \\ \hline % row one 
+  978-0-393-03701-2 &O'Brian &Patrick                  &55           \\        % row two 
+    ..
+\end at domain.hid@}
+ at end example
 
 What counts as a column is:@tie{}the column format specifier for the
 @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@}|}.
+and at domain.hid@}|}.
+
+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 and a vertical rule will come in the intercolumn
+area before it and after it.  This table details the exact behavior.
+
+ at example
+\begin at domain.hid|@}
+  \multicolumn at domain.hid@}       % entry one
+    &\multicolumn at domain.hid@}  % entry two 
+    &\multicolumn at domain.hid@}   % entry three
+    &z                        % entry four
+\end at domain.hid@}
+ at end example
+Before the first entry the output will not have a vertical rule because
+the @code{\multicolumn} has the @var{cols} specifier @samp{r} with no
+initial vertical bar.  Between entry one and entry two there will be a
+vertical rule; although the first @var{cols} does not have an ending
+vertical bar, the second @var{cols} does have a starting one.  Between
+entry two and entry three there is a single vertical rule; despite that
+the @var{cols} in both of the surrounding @code{multicolumn}'s call for
+a vertical rule, you only get one rule.  Between entry three and entry
+four there is no vertical rule; the default calls for one but the
+ at var{cols} in the entry three @code{\multicolumn} leaves it out, and
+that takes precedence.  Finally, following entry four there is a
+vertical rule because of the default.
+
+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 @code{tabular} definition's default intercolumn
+area specification, including the placement of vertical rules.
 
 In the example below, in the @code{tabular} definition the first column
-is specified to default to as right-justified but in the first row the
-entry is centered with @code{\multicolumn at domain.hid@}@}}.
+is specified to default to left 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@}@}},
+single entry with @code{\multicolumn at domain.hid@}@}},
 overriding the specification to center those two columns on the page
-range double-dash.
-
- at domain.hid
-\begin at domain.hid@}
-  \multicolumn at domain.hid@}@}  
-    &\multicolumn at domain.hid@}@} \\ \hline
-     Dawkins  &31 &58  \\
-     Watts    &9  &28
+range en-dash.
+
+ at example
+\begin at domain.hid@} 
+  \multicolumn at domain.hid@}@}  
+    &multicolumn at domain.hid@}@} \\ \hline
+  Baroque          &1600           &1760         \\
+  Classical        &1730           &1820         \\
+  Romantic         &1780           &1910         \\
+  Impressionistic  &1875           &1925
 \end at domain.hid@}
 @end example