[MERGE] initial cut of user doc for knitpack repositories

[Aaron Bentley]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Robert Collins wrote:
> if
> you are upgrading from an old (e.g. < 0.17) bzr you will need to also
> upgrade each branch individually.

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

It doesn't, but maybe it should?

It's certainly more convenient and reduces the chances of unexpected
branch/repo combinations.  While in general, repos ignore the branches
they contain, I think it's legitimate for commands like this to ensure
that contained branches are in the expected format.

Aaron
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFHIKTu0F+nu1YWqI0RAo9DAJ94v8rMmbH3beqNAEZdF1f9cjbh+wCfa+l5
y0L8ISErTd9kW6Ue9uQ7yfA=
=WU7I
-----END PGP SIGNATURE-----