Bug#138752: please at least document this limitation

2007-09-27 Thread Brendan O'Dea 
On Wed, Sep 26, 2007 at 01:50:30PM +0200, [EMAIL PROTECTED] wrote:
I just spent a little while understanding why help2man -h '-h' foo
was returning 

help2man: can't get `-h' info from foo

In order to save the next person the trouble, I have a suggestion.
If you plan to not handle output on stderr, could you please document
this in the man page (and the help output)? 

The documentation could perhaps be more obvious, although note that the
help2man documentation defers to the GNU standards document which states
WRT --help:

 This option should output brief documentation for how to invoke the
 program, on standard output, then exit successfully.

--bod



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]

Bug#138752: please at least document this limitation

2007-09-26 Thread bremner 

I just spent a little while understanding why help2man -h '-h' foo
was returning 

help2man: can't get `-h' info from foo

In order to save the next person the trouble, I have a suggestion.
If you plan to not handle output on stderr, could you please document
this in the man page (and the help output)? 

Also, it might be nice if a more suggestive error message was printed
when stdin is empty but status is OK.  Something along the lines of
Oh, your program probably prints its help message to stderr. help2man
does not support this.  

David



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]