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 writin

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 > cours

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|--w

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 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: /us

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|--websit

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 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|--u

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] [-l|--lan