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

[jhefferon at domain.hid]

Author: jhefferon
Date: Sat Sep 12 22:07:01 2015
New Revision: 431

URL: http://svn.gna.org/viewcvs/latexrefman?rev=431&view=rev
Log:
\vfill and \vspace

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=431&r1=430&r2=431&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sat Sep 12 22:07:01 2015
@@ -1,3 +1,8 @@
+2015-09-12  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (\vspace, \vfill): Add wording and example to
+	each node.
+
 2015-09-12  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (\frenchspacing): Move node to Spacing.

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=431&r1=430&r2=431&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sat Sep 12 22:07:01 2015
@@ -7635,28 +7635,67 @@
 @cindex stretch, infinite vertical
 @cindex infinite vertical stretch
 
-The @code{\vfill} fill command produces a rubber length (glue) which
-can stretch or shrink vertically as far as needed.  It's equivalent to
- at domain.hid@}} (@pxref{\hfill}).
+End the current paragraph and insert a vertical rubber length
+(@pxref{Lengths}) that is infinite, so it can stretch or shrink as far
+as needed.
+
+It is often used in the same way as @code{\vspace at domain.hid@}}, except that
+ at code{\vfill} ends the current paragraph, whereas
+ at code{\vspace at domain.hid@}} adds the infinite vertical space below its line
+irrespective of the paragraph structure.  In both cases that space will
+disappear at a page boundary; to circumvent this see at domain.hid}.
+
+In this example the page is filled, so the top and bottom lines contain
+the text @samp{Lost Dog!} and the third @samp{Lost Dog!} is exactly
+halfway between them.
+ 
+ at example
+\begin at domain.hid@}
+Lost Dog!
+\vfill
+Lost Dog!
+\vfill
+Lost Dog!
+\end at domain.hid@}
+ at end example
 
 
 @node \vspace
- at domain.hid @code{\vspace[*]@{@var{length}@}}
+ at section @code{\vspace at domain.hid}@}}
 
 @findex \vspace
+ at cindex vertical space
+ at cindex space, vertical
 
 Synopsis:
 
 @example
-\vspace[*]@{@var{length}@}
- at domain.hid example
-
-The @code{\vspace} command adds the vertical space @var{length}, i.e.,
-a rubber length.  @var{length} can be negative or positive.
-
-Ordinarily, @LaTeX{} removes vertical space added by @code{\vspace} at
-the top or bottom of a page.  With the optional @code{*} argument, the
-space is not removed.
+\vspace at domain.hid}@}
+ at end example
+
+or
+
+ at example
+\vspace*@{@var{length}@}
+ at end example
+
+Add the vertical space @var{length}.  This can be negative or positive,
+and is a rubber length (@pxref{Lengths}).
+
+Ordinarily, @LaTeX{} removes the vertical space at a page break, that
+is, at the top or bottom of a page.  With the starred version
+ at code{\vspace*@{..@}} the space is not removed.
+
+In this example the two questions will be evenly spaced vertically on
+the page, with at least one inch of space below each.
+
+ at example
+1) Who put the bomp in the bomp bah bomp bah bomp?
+\vspace at domain.hid plus 1fill@}
+
+2) Who put the ram in the rama lama ding dong?
+\vspace at domain.hid plus 1fill@}
+ at end example
 
 
 @node Boxes