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

[James Westby]

On Mon, 2009-03-02 at 20:46 +1100, Ben Finney wrote:
> Please find attached a Bazaar patch bundle, against the repository
> specified in the package's ‘Vcs-Bzr’ field, updating the package with
> a proper manpage and incorporating it into the Debian packaging.

I was actually suggesting a patch that automatically generated the
man page based on the information that is already there. You said
yourself that you didn't believe I would keep the document up to
date.

By merging your patch I would place myself in the situation where I
either had to keep another piece of documentation up to date, or I
would cause users to get confused when there was a discrepancy. I'd
rather have the current situation, while it may displease those who
are particularly attached to reading documentation in man format,
it ensures that the information is always correct, and that those
who type "man bzr-buildpackage" get a pointer to the information that
they want.

I'm not going to merge this now. If your discussion leads to this
becoming an RC bug then I will look at it again. I will also creating
a method to attempt to represent bzr's "help" output in a manpage to
my TODO list so that this can be solved properly.

Thanks,

James