[BUG] bzr.1 man page out of date

[James Blackwell]

On Thu, Jan 26, 2006 at 09:31:47PM -0600, John A Meinel wrote:
> 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/~jblack/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 :)

Fixed.

> 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 previous missing-list was a burn-test.

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

I reverted the changes here for now. I can pull it back out of the RCS
some other time and submit it seperately.

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

I can do that if you like. My thinking was that when somebody has some
time we'll also have bash completion, tcsh completion, emacs completion,
etc etc. That would get kind of crufty for something that often goes into
site-packages.

> There are some minor PEP8 issues

I've fixed the ones that I could catch.
 
> 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.

I'm not against it happening. I'm a little tight for time at the moment
though.

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

Fixed. I left it in the 0.7.0rc1 section for now. Whats the next version
of bzr? 0.7.1 or 0.8.0 ? 

> 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.

Nah. We're all busy. =)

> John
> =:->

  ^^^^
  This is the best signature that I've ever seen. 

-- 
My home page:   <a href="http://jblack.linuxguru.net">James Blackwell</a>
Gnupg 06357400  F-print AAE4 8C76 58DA 5902 761D  247A 8A55 DA73 0635 7400
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060130/94e1aa8e/attachment.pgp