Re: Requirement for a “pro per manpage” for every command

2009-03-05 Thread Adeodato Simó
* Charles Plessy [Tue, 03 Mar 2009 13:23:37 +0900]: > Le Tue, Mar 03, 2009 at 12:10:09AM +, Roger Leigh a écrit : > > crap maintainer > > bloody lazy. > I thought I was doing something good when writing manpages, now I realise what > I am for not writing enough : « responsable de merde putai

Re: Requirement for a “pro per manpage” for every command

2009-03-02 Thread Charles Plessy
Le Tue, Mar 03, 2009 at 12:10:09AM +, Roger Leigh a écrit : > > crap maintainer > bloody lazy. I thought I was doing something good when writing manpages, now I realise what I am for not writing enough : « responsable de merde putain de feignant » (translated in my language). Thank you for op

Re: Requirement for a “pro per manpage” for every command

2009-03-02 Thread Gunnar Wolf
Manoj Srivastava dijo [Mon, Mar 02, 2009 at 02:22:57PM -0600]: > > Hmh, this could even be promoted as a "best packaging practice". Many > > authors do ship properly-formatted --help entries, and our > > hand-generated manpages can often linger behind the truth. Any strong > > opinions against? >

Re: Requirement for a “pro per manpage” for every command

2009-03-02 Thread Roger Leigh
On Mon, Mar 02, 2009 at 09:04:39PM +1100, Ben Finney wrote: > The response from the maintainer (who is also the upstream author) so > far is, essentially, “Patches welcome, but I'm not interested in > maintaining manpages”. > > I have submitted a manpage as a patch. However, that response pretty

Re: Requirement for a “pro per manpage” for every command

2009-03-02 Thread Adeodato Simó
* brian m. carlson [Mon, 02 Mar 2009 19:45:22 +]: > help2man is a fine starting point for a manpage, but unless the help > messages are very verbose, it is not sufficient. A manpage needs to > explain all the possibilities and interactions between different > options that are usually not prov

Re: Requirement for a “pro per manpage” for every command

2009-03-02 Thread brian m. carlson
On Mon, Mar 02, 2009 at 11:22:52AM +0100, Simon Josefsson wrote: How about submitting a patch to use help2man instead? http://www.gnu.org/software/help2man/ Then the man page will be kept up to date with --help output. help2man is a fine starting point for a manpage, but unless the help messa

Re: Requirement for a “pro per manpage” for every command

2009-03-02 Thread Gunnar Wolf
Simon Josefsson dijo [Mon, Mar 02, 2009 at 11:22:52AM +0100]: > How about submitting a patch to use help2man instead? > > http://www.gnu.org/software/help2man/ > > Then the man page will be kept up to date with --help output. > > Possibly the document around the man page requirement could point