[pkg-fso-maint] Mumpot in Debian

[Enrico Zini]

On Mon, Nov 24, 2008 at 10:04:08AM +0100, Andreas Kemnade wrote:
> Joachim Breitner <nomeata at debian.org> wrote:
> > And BTW, for Debian, having manpages for all files installed to /usr/bin
> > would be highly appreciated. Do you plan to include these?
> I have never written manpages before. But I guess as a starting
> point looking at other manpages might be a good idea. And

There's also a shortcut that I like to use: write a good command line
help, then use help2man[1] to generate manpages.  That'll give you both
manpages and a good command line help, and guarantee that they are in
sync.

[1] http://packages.debian.org/help2man

You can pass options to tweak the output, including adding extra
sections like long descriptions and examples that may not fit in the
command line help.


Ciao,

Enrico

-- 
GPG key: 1024D/797EBFAB 2000-12-05 Enrico Zini <enrico at debian.org>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-fso-maint/attachments/20081124/268f9bfd/attachment.pgp