Re: sleep args

[Eric Blake]

> OK, but document all this with examples on the info AND man pages,
> something in the usage message too.
> Yes, I now see the "...", but without an explanation, one cannot
> assume that args are added...

Quoting from 'info sleep':
`sleep' pauses for an amount of time specified by the sum of the values
of the command line arguments.

That's pretty clear to me.  The --help output (and thus man pages)
are intentionally less verbose, since GNU projects favor info
documentation.

> And mention what is a GNU extension, and what is portable.

You know, you could have done this, and provided a patch that
specifies what you want to see, rather than just a complaint:

2006-06-20  Eric Blake  <address@hidden>

        * coreutils.texi (sleep invocation): Document that accepting
        multiple arguments and suffixes are extensions.
        Reported by Dan Jacobson.

Index: doc/coreutils.texi
===================================================================
RCS file: /sources/coreutils/coreutils/doc/coreutils.texi,v
retrieving revision 1.329
diff -u -p -r1.329 coreutils.texi
--- doc/coreutils.texi  25 May 2006 16:48:05 -0000      1.329
+++ doc/coreutils.texi  20 Jun 2006 11:25:16 -0000
@@ -13410,7 +13410,8 @@ days
 @end table
 
 Historical implementations of @command{sleep} have required that
address@hidden be an integer.  However, GNU @command{sleep} accepts
address@hidden be an integer, and only accepted a single argument
+without a suffix.  However, GNU @command{sleep} accepts
 arbitrary floating point numbers (using a period before any fractional
 digits).