[BUG] bzr.1 man page out of date

John A Meinel john at arbash-meinel.com
Fri Jan 27 03:31:47 GMT 2006


James Blackwell wrote:
> On Thu, Jan 26, 2006 at 09:37:17AM -0600, John A Meinel wrote:
>> The bzr.1 man file in bzr.dev is very out of date. It still references
>> ~/.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?
> 
> I submitted it a few times and gave up. I don't know if it ever got merged
> or not.
> 
> http://merconline.com/~jlback/branches/bzr-help
> 
> 
>> 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.
>>
>>
>> John
>> =:->
>>

Well, it still has the invalid ~/.bzr.conf at the bottom :)

It definitely generates a more complete man page. And I think I like it.
I don't remember what the specific complaints were in the past. But I've
read through it, and this is my list of small issues.

The tutorial.txt conflicts, which I don't really know how to fix. It
looks like it could all just be included.

I would probably rather the code was inside bzrlib rather than being in
tools.

There are some minor PEP8 issues

I wonder if some of the hidden commands could show up in the man page,
perhaps in a separate location, or maybe an alternate man page.

You updated the NEWS to say "use bzr-infogen.py" but that file doesn't
exist.

Otherwise, I would be happy to merge it. I'm sorry things get dropped.
There tends to be a lot going on. I'd really like to see a review list
worked out.

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/a35036c1/attachment.pgp 


More information about the bazaar mailing list