Re: [LAD] Build and get your package in Debian/ Ubuntu (was Re: [LAU] Join the Debian Multimedia Team! (to improve the state of Linux audio)) - Linux-audio-dev

1 Apr 2009

Dennis Schulmeister wrote:
...
  Hi,

 On Wed, 2009-04-01 at 14:48 +0200, Grammostola Rosea wrote:

   3.
Documentation - especially man pages which are required for all
 binaries (even if they just refer to online documentation or info
 pages). This requirement is often skipped for Ubuntu-only packages which
 makes me as a user sad. 
         Yeah an manpage is required. You can use the app gmanedit for example to 
 create one.

 I really got accustomed to help2man because creating man pages is a snap
 with it. All it takes is the following:

       * A sanely formated text file (w/ optional troff commands)
       * Your program's --version string
       * Your program's --help string

 That's it. With such tools available there's really no excuse for not
 having a man page.

    Thanks for the tip!

What do you think, should an upstream author take care of the manpage or 
the package maintainer?

\r