Re: How to write a good manpage ?

2006-08-20 Thread Stefano Zacchiroli
On Thu, Aug 17, 2006 at 08:13:32AM -0700, Russ Allbery wrote: Just to add one more opinion, I always write new man pages in POD and make Perl do the hard work of converting them to *roff for me. (Of course, I'm biased since I maintain Pod::Man.) I also tend to like the POD syntax for writing

How to write a good manpage ?

2006-08-17 Thread Marco Bertorello
Hi Mentors, I always used help2man to generate a manpage for those packages that hasn't one. But now, I'm working on a package that has a non useful help output: $ gcstar --help Usage: /usr/bin/gcstar [[-u|--update [-a|--all] [-c|--collection] [-w|--website] [-i|--import] [-e|--export]

Re: How to write a good manpage ?

2006-08-17 Thread Daniel Leidert
Am Donnerstag, den 17.08.2006, 14:20 +0200 schrieb Marco Bertorello: Hi Mentors, I always used help2man to generate a manpage for those packages that hasn't one. But now, I'm working on a package that has a non useful help output: $ gcstar --help Usage: /usr/bin/gcstar [[-u|--update

Re: How to write a good manpage ?

2006-08-17 Thread Frank Terbeck
Marco Bertorello [EMAIL PROTECTED]: [...] How can I write a manpage good for debian? Branden Robinson held a talk about writing manuals for debian at debconf5. Here is a link to the corresponding video:

Re: How to write a good manpage ?

2006-08-17 Thread Damyan Ivanov
Hi, Marco, Marco Bertorello написа: I always used help2man to generate a manpage for those packages that hasn't one. But now, I'm working on a package that has a non useful help output: $ gcstar --help Usage: /usr/bin/gcstar [[-u|--update [-a|--all] [-c|--collection] [-w|--website]

Re: How to write a good manpage ?

2006-08-17 Thread Daniel Leidert
Am Donnerstag, den 17.08.2006, 15:46 +0300 schrieb Damyan Ivanov: Marco Bertorello написа: I always used help2man to generate a manpage for those packages that hasn't one. But now, I'm working on a package that has a non useful help output: $ gcstar --help Usage: /usr/bin/gcstar

Re: How to write a good manpage ?

2006-08-17 Thread Nico Golde
Hi Marco, * Marco Bertorello [EMAIL PROTECTED] [2006-08-17 14:44]: I always used help2man to generate a manpage for those packages that hasn't one. But now, I'm working on a package that has a non useful help output: $ gcstar --help Usage: /usr/bin/gcstar [[-u|--update [-a|--all]

Re: How to write a good manpage ?

2006-08-17 Thread Russ Allbery
Marco Bertorello [EMAIL PROTECTED] writes: I always used help2man to generate a manpage for those packages that hasn't one. But now, I'm working on a package that has a non useful help output: $ gcstar --help Usage: /usr/bin/gcstar [[-u|--update [-a|--all] [-c|--collection] [-w|--website]

Re: How to write a good manpage ?

2006-08-17 Thread Francesco Pedrini
On Thursday 17 August 2006 17:13, Russ Allbery wrote: Marco Bertorello [EMAIL PROTECTED] writes: How can I write a manpage good for debian? Just to add one more opinion, I always write new man pages in POD and make Perl do the hard work of converting them to *roff for me. (Of course, I'm