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

[jhefferon at domain.hid]

Author: jhefferon
Date: Sun Aug  2 22:57:00 2015
New Revision: 391

URL: http://svn.gna.org/viewcvs/latexrefman?rev=391&view=rev
Log:
array environment

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=391&r1=390&r2=391&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sun Aug  2 22:57:00 2015
@@ -1,3 +1,9 @@
+2015-08-02  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (array): Refer to tabular for details.  Add suggestion
+	to use amsmath to get fences, and change example to make
+	justification vaguely defensible.
+
 2015-08-02  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (multicolumn): Adjust description of how intercolumn
@@ -6,7 +12,7 @@
 2015-08-01  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (multicolumn, vline, cline, hline): Adjust
-	wording.  
+	wording.
 
 2015-07-31  Jim Hefferon  <jhefferon at domain.hid>
 

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=391&r1=390&r2=391&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sun Aug  2 22:57:00 2015
@@ -1759,55 +1759,53 @@
 Synopsis:
 
 @example
-\begin at domain.hid}@}
- at domain.hid text} &@var{col2 text} ... &@var{coln text} \\
+\begin at domain.hid}@}
+ at var{column 1 entry} &@var{column 2 entry} ... &@var{column n entry} \\
 ...
 \end at domain.hid@}
 @end example
 
-Math arrays are produced with the @code{array} environment, normally
-within an @code{equation} environment (@pxref{equation}).  It has a
-single mandatory @var{template} argument describing the number of
-columns and the alignment within them.  Each column @var{col} is
-specified by a single letter that tells how items in each row of that
-column should be formatted, as follows:
-
- at domain.hid @code
- at domain.hid c
-centered
- at domain.hid l
-flush left
- at domain.hid r
-flush right
- at domain.hid table
-
- at domain.hid \\ @r{(for @code{array})}
-Column entries are separated by @code{&}.  Column entries may include
-other @LaTeX{} commands.  Each row of the array is terminated with
- at domain.hid{\\}.
-
- at domain.hid @@@{...@}
-In the template, the construct @code{@@@{@var{text}@}} puts @var{text}
-between columns in each row.
-
-Here's an example:
+Produce a mathematical array.  This environment can only be used in math
+mode, and normally appears within a displayed mathematics environment
+such as @code{equation} (@pxref{equation}).  The required argument
+ at var{cols} describes the number of columns, their alignment, and the
+formatting of the intercolumn regions.  Column entries are separated by
+ at code{&}.  Rows are terminated with @code{\\}.
+
+The @code{array} environment is just like the @code{tabular}
+environment, except that entries are typeset in mathematics mode (as
+ at code{\textstyle}, not @code{\displaystyle}).  
+
+There are two exception to this.  The first is that entries are not
+typeset in math mode if the column is specified with @code{@@p@{..@}} in
+the @var{cols} definition.  The second is that, instead of @code{tabular}'s @code{\tabcolsep}, @LaTeX{}'s intercolumn
+space in an array is governed by the parameter
+ at findex \arraycolsep
+ at code{\arraycolsep} which gives half the width between columns; the
+default is @samp{5pt}.
+
+See @ref{tabular} for the complete description of @var{cols}, and of the
+other features of the two environments.
+
+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 domain.hid{(..)}, @code{bmatrix} for an array
+surrounded by square brackets at domain.hid{[..]}, @code{Bmatrix} for an
+array surrounded by curly braces at domain.hid{@{..@}}, @code{vmatrix} for
+an array surrounded by vertical bars at domain.hid{|..|}, and
+ at code{Vmatrix} for an array surrounded by double vertical
+bars at domain.hid{||..||}, along with a number of other array constructs.
+
+Here's an example of an array:
 
 @example
 \begin at domain.hid@}
-  \begin at domain.hid@}
-  left1 & right1 & centered1 \\
-  left2 & right2 & centered2 \\
+  \begin at domain.hid@}
+    \sqrt at domain.hid@}  &12.3 \\
+    x^2       &3.4       
   \end at domain.hid@}
 \end at domain.hid@}
 @end example
-
- at domain.hid \arraycolsep
-The @code{\arraycolsep} parameter defines half the width of the space
-separating columns; the default is @samp{5pt}.  @xref{tabular}, for other
-parameters which affect formatting in @code{array} environments,
-namely @code{\arrayrulewidth} and @code{\arraystretch}.
-
-The @code{array} environment can only be used in math mode.
 
 
 @node center