Bazaar-NG の branch format をアップグレードする

調子に乗って Bazaar-NG のバージョンを 0.0.9 から 0.1.1 に上げたら、bzr のコマンドが全く通らなくなってしまった。エラー・メッセージはこんな感じ。

$ bzr log
bzr: ERROR: command: '/usr/bin/bzr' 'log'
pwd: /home/foo/path/to/your/bzr-project
unsupported branch format: sorry, branch format u'Bazaar-NG branch, format 0.0.4\n' not supported
  at /usr/lib/python2.4/site-packages/bzrlib/branch.py line 515, in _check_format()
  see ~/.bzr.log for debug information

これは、Bazaar-NG のリポジトリーの形式 (branch format というのかな?) が変更されたのが原因らしい。新しい format は、weave format と呼ぶそうな。

リポジトリーのアップグレードは、ソース・ツリーの中で bzr upgrade と打つだけでよいみたい。

$ pwd
/home/foo/path/to/your/bzr-project
$ bzr upgrade
starting upgrade of /home/foo/path/to/your/bzr-project
making backup of tree history
./.bzr has been backed up to ./.bzr.backup
if conversion fails, you can move this directory back to .bzr
if it succeeds, you can remove this directory if you wish
starting upgrade from format 4 to 5
note: upgrade may be faster if all store files are ungzipped first
upgraded to weaves:
      17 revisions and inventories
       0 revisions not present
      45 texts
starting upgrade from format 5 to 6
adding prefixes to weaves
adding prefixes to revision-store
this branch is in the most current format
finished

アップグレードは、あっという間に終わる。でも、念のため、ディレクトリーのコピーを取ってからやることをお勧めする。

一応、Bazaar-NG 0.1.1 の bzr help upgrade を和訳 (意訳) しておく。

ブランチのストレージを最新のフォーマットにアップグレードする。

(bzr の) check コマンドや bzr の開発者は、時々このコマンドを実行するようアドバイスするでしょう。

このバージョン (0.1.1) のこのコマンドは、0.0.8 及びそれ以前のバージョンで使われていた full-text storage から weave format (v5) にアップグレードします。