another bug in tail(1)

Greg Woods woods at hao.UUCP
Thu Apr 24 10:21:22 AEST 1986


> The syntax for tail(1) is
> 
> 	tail [-options] [file]
> 
> Excess file arguments are silently ignored.  No big deal, but should
> be manualled under BUGS.

  Actually, the "standard" syntax for documentation (the real problem is that
there is no such thing!) has a word mean exactly one of that item, and a word
followed by an ellipsis (...) meaning one or more of that item. In other words,
as written above it implies that exactly one (or zero, since the file argument
is optional as indicated by []) file name is allowed. To indicate zero or more,
the syntax would be "[file...]" and to indicate one or more the syntax would
be "file...". "file" would mean exactly one. That impromptu standard seems to 
be adhered to throughout most of the 4.2 manuals. As written, "[file]" means 
one or zero files, which is what the actual program recognizes.

--Greg



More information about the Comp.bugs.4bsd.ucb-fixes mailing list