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

[jhefferon at domain.hid]

Author: jhefferon
Date: Sun Sep 13 23:33:57 2015
New Revision: 433

URL: http://svn.gna.org/viewcvs/latexrefman?rev=433&view=rev
Log:
merge \hrulefill and dotfill

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=433&r1=432&r2=433&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sun Sep 13 23:33:57 2015
@@ -1,3 +1,8 @@
+2015-09-13  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (\hrulefill \dotfill): Add example, merge the
+	two nodes.
+
 2015-09-13  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (\addvspace): Add explanation, and link to

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=433&r1=432&r2=433&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sun Sep 13 23:33:57 2015
@@ -7376,15 +7376,14 @@
 @LaTeX{} has many ways to produce white (or filled) space.
 
 @menu
-Horizontal space
-* \hspace::             Fixed horizontal space.
-* \hfill::              Stretchable horizontal space.
-* \(SPACE) and \@@::    Space after a period.
-* \frenchspacing::      Make interword and intersentence space equal.
-* \thinspace::          One-sixth of an em.
-* \/::                  Insert italic correction.
-* \hrulefill::          Stretchable horizontal rule.
-* \dotfill::            Stretchable horizontal dots.
+Horizontal space 
+* \hspace::              Fixed horizontal space.  
+* \hfill::               Stretchable horizontal space.  
+* \(SPACE) and \@@::     Space after a period.  
+* \frenchspacing::       Make interword and intersentence space equal.  
+* \thinspace::           One-sixth of an em.  
+* \/::                   Insert italic correction.  
+* \hrulefill \dotfill::  Stretchable horizontal rule or dots.
 
 Vertical space
 * \addvspace::                    Add arbitrary vertical space if needed.
@@ -7560,23 +7559,34 @@
 in a different way.
 
 
- at domain.hid \hrulefill
- at domain.hid @code{\hrulefill}
+ at node \hrulefill \dotfill
+ at section @code{\hrulefill \dotfill}
 
 @findex \hrulefill
-
-The @code{\hrulefill} fill command produces a ``rubber length'' which can
-stretch or shrink horizontally.  It will be filled with a horizontal
-rule.
-
-
- at domain.hid \dotfill
- at domain.hid @code{\dotfill}
-
 @findex \dotfill
 
-The @code{\dotfill} command produces a ``rubber length'' that fills
-with dots instead of just white space.
+Produce an infinite rubber length (@pxref{Lengths}) filled with a
+horizontal rule (that is, a line) or with dots, instead of just white
+space.
+
+When placed between blank lines this example creates a paragraph that is
+left and right justified, where the space in the middle is filled with a
+evenly spaced dots.
+
+ at example
+\noindent Jack Aubrey\dotfill Melbury Lodge
+ at end example
+
+To make the rule or dots go to the line's end use @code{\null} at the
+start or end.  
+
+To change the rule's thickness, copy the definition and adjust it, as
+with @code{\renewcommand at domain.hid height
+1pt\hfill\kern\z@@@}}, which changes the default thickness of
+0.4 at domain.hid to 1 at domain.hid.  Similarly, adjust the dot spacing as with
+ at code{\renewcommand at domain.hid@@
+1.00em at domain.hid .\hss @}\hfill\kern\z@@@}}, which changes the default
+length of 0.33 at domain.hid to 1.00 at domain.hid.
 
 
 @node \addvspace
@@ -7599,6 +7609,8 @@
 environment is defined to begin and end in @code{\addvspace@{..@}} so
 that two consecutive Theorem's are separated by one vertical space, not
 two.)
+
+This command is fragile (@pxref{\protect}).
 
 The error @samp{Something's wrong--perhaps a missing \item} means that
 you were not in vertical mode when you invoked this command; one way to
@@ -7677,15 +7689,10 @@
 @cindex vertical space
 @cindex space, vertical
 
-Synopsis:
+Synopsis, one of these two:
 
 @example
 \vspace at domain.hid}@}
- at domain.hid example
-
-or
-
- at domain.hid
 \vspace*@{@var{length}@}
 @end example