[MERGE] initial cut of user doc for knitpack repositories

Robert Collins robertc at robertcollins.net
Thu Oct 25 12:46:54 BST 2007


On Thu, 2007-10-25 at 21:24 +1000, Ian Clatworthy wrote:

Three remaining things.

> +  bzr upgrade path-to-my-branch

'bzr upgrade' will NOT migrate to packknit-experimental unless it's
provided on the command line. I mentioned this last time but I think you
dropped it.

> +If branches are within a shared repository, each branch needs to be
> +upgraded separately.

This is more accurate but possibly even more confusing. To give you some
prose instead of talking about what the command does, perhaps:

"If you are using a shared repository, run ``bzr upgrade
--knitpack-experimental ROOT_OF_REPOSITORY`` to upgrade the history
database. This will not alter the branch format of each branch, and if
you are upgrading from an old (e.g. < 0.17) bzr you will need to also
upgrade each branch individually. More modern bzr's will already have
the branch format at our latest branch format which adds support for
tags."

Or something like that. I was objecting previously to the 'and upgrades
all the branches', because it doesn't iterate over branches - running
upgrade in the root of a repository upgrades the repository itself,
which all the branches *use*, but it doesn't touch the branch objects,
and I have found in the past that being unclear about the [in code at
least] crisp separation between Branch and Repository leads to confusion
in the users and a lack of understanding of what the commands do.
....
> +
> +Testing the knitpack-subtree-experimental format
> +------------------------------------------------

Perhaps this section would be better as 

Testing packs for bzr-svn users
-------------------------------

-Rob

-- 
GPG key available at: <http://www.robertcollins.net/keys.txt>.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20071025/63d0dd5d/attachment.pgp 


More information about the bazaar mailing list