See http://people.ubuntu.com/~ianc/doc/en/upgrade-guide/. If there are corrections required, please add comments to the merge proposal: https://code.launchpad.net/~ian-clatworthy/bzr/upgrade-guide/+merge/8169 Thanks, Ian C.