[Pkg-bazaar-maint] Bug#517494: bzr-buildpackage: Does not have a useful manpage

[Ben Finney]

Package: bzr-builddeb
Version: 0.95
Severity: normal

The program ‘bzr-buildpackage’ has a manpage, but it is virtually no
use:

=====
NAME
        bzr-buildpackage - build a debian package from a bazaar branch

SEE ALSO
        Please see the output of bzr-buildpackage --help, and the file
        /usr/share/doc/bzr-builddeb/README.gz
=====

This is little more than a placeholder, and serves only to fool
‘lintian’ without actually providing the information for users that
should be in a manpage.

Policy §12.1 requires “a proper manpage” for every program, and this
does not, IMO, qualify, so arguably this is a policy violation; I
leave that call to someone else, though.

Since this is not yet a useful manpage for the program, it should
instead be removed, so that ‘lintian’ will correctly report the lack.

One possibility for generating a useful manpage would be to start with
the ‘help2man’ tool.

-- 
 \     “We are not gonna be great; we are not gonna be amazing; we are |
  `\           gonna be *amazingly* amazing!” —Zaphod Beeblebrox, _The |
_o__)                Hitch-Hiker's Guide To The Galaxy_, Douglas Adams |
Ben Finney <ben at benfinney.id.au>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-bazaar-maint/attachments/20090228/eb61e96d/attachment.pgp