[MERGE] (0.91) branches and standalone-trees documentation

[Ian Clatworthy]

When the Bazaar User Reference was added to 0.90, Paul Moore provided
feedback (https://lists.ubuntu.com/archives/bazaar/2007q3/029239.html)
during the review process suggesting that the Concepts section was good
but lacking some important topics, particularly an explanation of
branches. He then went on to suggest some content at the end of the
thread (https://lists.ubuntu.com/archives/bazaar/2007q3/029353.html)
which I promised to put up for merge. And here it is.

Given a semi-related, recent thread in which Aaron has suggested concept
topics might not belong in on-line help, I've included a comment above
the place where the topics are registered to this effect. Part of
Aaron's gripe was the usage of strings instead of files for
documentation. In this case, the 2 new topics are concise so I hope
using strings is acceptable. If desirable, we could change the help
topic loader to get content from files, instead of strings, in a
separate patch.

Regardless of such implementation nuances, thanks to Paul for the
important bit: the content. :-)

Ian C.

PS: Yet another recent email thread has talked about the need for better
concepts documentation:
https://lists.ubuntu.com/archives/bazaar/2007q3/031060.html. Maybe the
result of that will take this whole (introductory) area to a new level
of clarity? In the meantime, this is a simple low risk improvement that
I'd like to see in 0.91.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: branches-and-standalone-trees-doc.patch
Type: text/x-patch
Size: 6973 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20070907/17056c4c/attachment.bin