Re: Requirement for a “proper manpage” for every command

2009-03-02 Thread Filipus Klutiero
Ben Finney wrote: Wording and tone aside, is that expectation reasonable? Yes. What course of action is open to a user of the package, with a maintainer who has made it plain they're not interested in following (this part of) policy? There's nothing direct you can do as user. As a packager,

Re: Requirement for a “proper manpage” for every command

2009-03-02 Thread Lars Wirzenius
ma, 2009-03-02 kello 14:19 -0600, Manoj Srivastava kirjoitti: > Then, every few revisions, I would resync the man page. I > consider this just one of the things that Debian maintainedrs > ought to do -- I mean, we are not just glorified packagers. We could aid this process by having a to

Re: Requirement for a “proper manpage” for every command

2009-03-02 Thread Ben Finney
(Gunnar, and others, please don't send individual responses that you also send to the mailing list.) Gunnar Wolf writes: > 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

Re: Requirement for a “proper manpage” for every command

2009-03-02 Thread Manoj Srivastava
On Mon, Mar 02 2009, Gunnar Wolf wrote: > 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 docum

Re: Requirement for a “proper manpage” for every command

2009-03-02 Thread Manoj Srivastava
On Mon, Mar 02 2009, Adeodato Simó wrote: > Many times the problem is that upstreams do provide such adequate > documentation... in other formats than man pages. What should the > packager do in that case? Create a dummy man page pointing out to eg. > /usr/share/doc/foopkg/html/fooprog.html? Copy

Re: Requirement for a “proper manpage” for every command

2009-03-02 Thread David Bremner
At Mon, 2 Mar 2009 13:29:06 -0600, Gunnar Wolf wrote: > > 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? Not to rehash a

Re: Requirement for a “proper manpage” for every command

2009-03-02 Thread Simon Josefsson
Ben Finney writes: > I'm having a conversation with a Debian packager regarding a manpage > that, currently, is a mere placeholder saying “please see foocommand > --help”, giving none of the useful information normally found in a > manpage. ... > I have submitted a manpage as a patch. However, th

Requirement for a “proper manpage” for every command

2009-03-02 Thread Ben Finney
Howdy all, I'm having a conversation with a Debian packager regarding a manpage that, currently, is a mere placeholder saying “please see foocommand --help”, giving none of the useful information normally found in a manpage. I would like the specific package to remain anonymous at the moment (tho