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

[Ben Finney]

package bzr-builddeb
severity 517494 serious
thanks

On 01-Mar-2009, Ben Finney wrote:
> On 28-Feb-2009, James Westby wrote:
> > I'm interested in why you feel providing a man page that points
> > users to the preferred way to get the help for the tool is a bad
> > thing?
> 
> Preferred by whom? The Debian operating system has a deliberate
> policy of providing a manual page for every command, precisely so
> that there is a *single* preferred place to get at the information
> that a manual page provides for commands.

After seeking discussion on policy §12.1 in the Debian forums[0], the
apparent consensus is that, yes, a proper and maintained manpage for
every command in a package is requirement for compliance with policy.

Accordingly, this reported bug is of ‘serious’ severity.


[0] Message-id: <87zlg48clk.fsf at benfinney.id.au>,
    <http://lists.debian.org/debian-devel/2009/03/msg00068.html>

-- 
 \         “I have yet to see any problem, however complicated, which, |
  `\      when you looked at it in the right way, did not become still |
_o__)                                more complicated.” —Paul Anderson |
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/20090311/955f375e/attachment.pgp