[MERGE] improved help on storage formats

[Ian Clatworthy]

Stephen J. Turnbull wrote:
> A few gnits:
> 
> Matthew D. Fuller writes:
> 
>  > I envision `help formats` looking more like:
> 
> Looks nice, really.

>  > 1.6:
>  >     (native) A branch and pack based repository that supports
>  >     stacking.
> 
> Urgh.  As you say, means what?

>  > See ``bzr help deprecated-formats`` for older formats.
>  > See ``bzr help experimental-formats`` for experimental formats.
> 
> Prefix 
> 
>     See ``bzr help semantics-of-formats`` for explanation of
>     capabilities of formats.
> 
> maybe?

>  >    Similarly, the ordering in deprecated could use rework too.  It
>  >    seems to me they should be in age order (whether newest-first or
>  >    oldest-first, there are points either way)
> 
> Newest-first.  Experimental should be either in order of expected
> landing or (as an approximation to that) oldest-first.

New patch attached addressing many of these issues. As suggested
in another email, I've gone with 3 topics: formats, current-formats
and other-formats. The first one is an overall introduction that
explains how to select a format, including the issues around
plain vs rich-root. The latter two topics are plain lists giving
the formats in the order they were introduced. (This allows the
descriptions to build on one another.)

I've also improved the descriptions for most of the current formats.
Hopefully they are better - and clearer - now.

Ian C.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: help-formats-2.patch
Type: text/x-diff
Size: 21479 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20081212/be7ba0f6/attachment-0001.bin