log --forward printed wrongly in 0.8rc1 and doc request...

[Jens Lund]

Hi

First: congratulations on all the hard work you have put into bzr :-) This 
stuff is great!

I have been playing a little around with 0.8rc1 and have only seen one 
issue:

When getting the log in forward order merged stuff is printed before the 
actual entry, it should be after. Example:

bzr.dev$ bzr log -r-1.. --forward
    ------------------------------------------------------------
    merged: mbp at sourcefrog.net-20060426045253-0728376fb99879af
    committer: Martin Pool <mbp at sourcefrog.net>
    branch nick: bzr.mbp.40508
    timestamp: Wed 2006-04-26 14:52:53 +1000
    message:
      Run ssh subprocess with SIGINT ignored, but in the same process group.  
(Malone #40508, #5987)
    ------------------------------------------------------------
    merged: mbp at sourcefrog.net-20060426063605-c66a7bf3f99f001c
    committer: Martin Pool <mbp at sourcefrog.net>
    branch nick: bzr.mbp.40508
    timestamp: Wed 2006-04-26 16:36:05 +1000
    message:
      doc
------------------------------------------------------------
revno: 1686
committer: Canonical.com Patch Queue Manager<pqm at pqm.ubuntu.com>
branch nick: +trunk
timestamp: Wed 2006-04-26 07:45:44 +0100
message:
  (mbp) #40508 ignore interrupts in ssh child


And then, please... It would be really great if the documentation 
(tutorial.txt in bzr.dev) was expanded to cover all the new functionality 
with repositories with several branches, checkouts, bound branches, in 
addition to describing possible ways to specify revisions, the default 
options/aliases in the config file, etc. I know most of this information is 
available on the wiki but IMHO it would be a lot better to have in in one 
place in one file in the code such that it can easily be converted to html, 
pdf and printed, etc. etc. A suggestion: Perhaps the file should then be 
renamed to bzr_manual.txt and include the tutorial as one part, the manual 
page as another part, and the more detailed sections in a separate part.

Other minor doc comments:

* The diff example in the tutorial shows the old style diffs.

* The doc directory is empty now. Why don't delete it then? (It could be 
made at install time if necessary.)

* tutorial.txt says "Current for bzr-0.7pre, 2006-01-06"
* NEWS lists "bzr 0.7rc1 2006-01-09" as the previous version. 
* Both of these two was correct in 0.7 so some things has not been merged to 
bzr.dev from 0.7 release. (BTW: where is the 0.7 release branch?)

Jens