bug#11044: bug & RFE

[Bruce Korb]

The "T" crossings and "I" dottings ... I did the icky thing anyway.


diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 835c245..a9dabc4
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2133,7 +2133,7 @@ These commands reformat the contents of files.
 a given number of characters (75 by default).  Synopsis:

 @example
-fmt address@hidden@dots{} address@hidden@dots{}
+fmt address@hidden@dots{} address@hidden address@hidden address@hidden@dots{}
 @end example

 @command{fmt} reads from the specified @var{file} arguments (or standard
@@ -2144,6 +2144,13 @@ preserved in the output; successive input lines with 
different
 indentation are not joined; tabs are expanded on input and introduced on
 output.

address@hidden and @var{width} are only recognized if neither
address@hidden/@var{--goal} nor @var{-w}/@var{--width} have been specified; and 
if
+the strings represent numbers; and if the numbers do not exceed about 2,500;
+and if these strings do not match existing file names.  If @var{goal} is
+provided but @var{width} not, then @var{width} will be set to @var{goal}
+plus 10.
+
 @cindex line-breaking
 @cindex sentences and line-breaking
 @cindex Knuth, Donald E.
@@ -2203,9 +2210,16 @@ between sentences to two spaces.
 @opindex address@hidden
 @opindex -w
 @opindex --width
-Fill output lines up to @var{width} characters (default 75).  @command{fmt}
-initially tries to make lines about 7% shorter than this, to give it
-room to balance line lengths.
+Fill output lines up to @var{width} characters (default 75).
+
address@hidden address@hidden
address@hidden -g @var{goal}
address@hidden address@hidden
address@hidden address@hidden
address@hidden -g
address@hidden --goal
address@hidden initially tries to make lines @var{goal} characters wide.
+By default, this is 7% shorter than @var{width}.

 @item -p @var{prefix}
 @itemx address@hidden