[BUG] bzr.1 man page out of date

[John A Meinel]

Jan Hudec wrote:
> On Thu, Jan 26, 2006 at 09:37:17 -0600, John A Meinel wrote:
>> The bzr.1 man file in bzr.dev is very out of date. It still references
> 
> There is no such file in bzr.dev!
> 
> bulb at efreet:~/dev/bzr/bzr.dev$ bzr pull
> Using saved location: http://bazaar-ng.org/bzr/bzr.dev
> 0 revision(s) pulled.
> bulb at efreet:~/dev/bzr/bzr.dev$ bzr revert
> bulb at efreet:~/dev/bzr/bzr.dev$ ls **/*.1
> zsh: no matches found: **/*.1
> FAILED 1
> 
> (I never ran setup.py -- just pulled and started using it.)
> 
>> ~/.bzr.conf/email as the file to set your email in.
>>
>> I know jblack did work to have a man-page generated from the doc
>> strings, what happened to it?
> 
> It is used. The man page is generated by bzr_man.py when you run setup.py.
> 
>> But even if we have to manually update bzr.1, I think it needs to be
>> done. Either that, or just delete the file, because it is out of date.
> 
> Most of the man page is generated from doc strings. But it has a preamble and
> postamble, that are strings inside bzr_man.py. That is the right place to fix
> things.
> 
> I think that besides command help, there could be a few more doc sections in
> the builtin help, which should contain this stuff.
> 

Actually, jblack had worked on an even better one, which had its code
inside of 'tools/'.

But you're right, bzr_man.py is what needs to be updated right now.

John
=:->



-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 249 bytes
Desc: OpenPGP digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060126/80776e56/attachment.pgp