GNU bug report logs - #28763
docbug (stat -t): missing field names in docs(manpage) for 'stat -t'

Previous Next

Full log

Message #23 received at 28763 <at> debbugs.gnu.org (full text, mbox):

From: Assaf Gordon <assafgordon <at> gmail.com>
To: Bernhard Voelker <mail <at> bernhard-voelker.de>,
 L A Walsh <coreutils <at> tlinx.org>, 28763 <at> debbugs.gnu.org
Subject: Re: bug#28763: docbug (stat -t): missing field names in docs(manpage)
 for 'stat -t'
Date: Wed, 11 Oct 2017 13:26:26 -0600

[Message part 1 (text/plain, inline)]

Hello,

On 2017-10-11 12:58 AM, Bernhard Voelker wrote:
> Adding a bit more context (-A1) to the grep command helps:
> 
>   $ man man/stat.1 | grep -A1 Full
>        Full documentation at: <http://www.gnu.org/software/coreutils/stat>
>        or available locally via: info '(coreutils) stat invocation'
> 
> I personally prefer 'pinfo' over 'info' as reader.

Perhaps there is some merit in making the usage text more complete ?

For example, "date --help" does show the exact output of --iso-8601,
--rfc-2822 and --rfc-3339 .

Attached are two draft patches, one adds the information at the end of
the "--help" screen, the other inside the "--terse" parameter.
(these will also be propagated to the man-pages).

What do you think ?


regards,
 - assaf

[0001-stat-update-usage-with-terse-FORMAT-at-end-of-usage.patch (text/x-patch, attachment)]

[0001-stat-update-usage-with-terse-FORMAT-inlined-in-terse.patch (text/x-patch, attachment)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.