← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/ja/user-guide/version_info.txt

Rework test_script a little bit.


Don't allow someone to request a stdin request to echo.
Echo never reads from stdin, it just echos its arguments.
You use 'cat' if you want to read from stdin.

A few other fixes because the tests were using filenames
that are actually illegal on Windows, rather than just
nonexistant.


Change the exception handling for commands so that
unknown errors don't get silently squashed and then
turn into hard-to-debug errors later.

test_script now passes on Windows.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ja/user-guide/version_info.txt
1
 
バージョンの情報をエクスポートする
2
 
==================================
3
 
 
4
 
最新のリビジョン番号を得る
5
 
--------------------------
6
 
 
7
 
ビルドスクリプトの中で最新のリビジョン番号だけが必要な場合、 ``revno`` コマンドを使用できます::
8
 
 
9
 
  $ bzr revno
10
 
  3104
11
 
 
12
 
 
13
 
詳細なバージョン情報を得る
14
 
---------------------------
15
 
 
16
 
最新バージョンに関する詳細な情報を出力するには ``version-info`` コマンドを使用できます::
17
 
 
18
 
  $ bzr version-info
19
 
  revision-id: pqm@pqm.ubuntu.com-20071211175118-s94sizduj201hrs5
20
 
  date: 2007-12-11 17:51:18 +0000
21
 
  build-date: 2007-12-13 13:14:51 +1000
22
 
  revno: 3104
23
 
  branch-nick: bzr.dev
24
 
 
25
 
オペレーティングシステムツールもしくはスクリプトを使用して出力を簡単にフィルタリングできます。
26
 
例です(Linux/Unix)::
27
 
 
28
 
  $ bzr version-info | grep ^date
29
 
  date: 2007-12-11 17:51:18 +0000
30
 
 
31
 
より高度な後処理のためにすべてのリビジョンに関するバージョン情報が必要であれば、
32
 
``--all`` オプションはその情報を実際にダンプします。
33
 
 
34
 
 
35
 
Pythonのプロジェクト
36
 
--------------------
37
 
 
38
 
.. TODO: Figure out how to attach into ``setup.py``
39
 
 
40
 
 
41
 
プロジェクトファイルをビルドするためにMakefileを使う場合、
42
 
次のようにバージョン情報用のファイルを簡単に生成できます::
43
 
 
44
 
  library/_version.py:
45
 
        bzr version-info --format python > library/_version.py
46
 
 
47
 
これは3つのディレクトリを含むファイルを生成します:
48
 
 
49
 
  * `version_info`: 現在の状態に関する基本情報を含むディレクトリ。
50
 
 
51
 
  * `revisions`: コミット時間とコミットメッセージと一緒に、
52
 
    ツリーの履歴の中のすべてのリビジョンのリストを表示するディクショナリ。
53
 
    ``--all`` もしくは ``--include-history`` が提供されない限り、デフォルトではこれは空です。
54
 
    リリースバージョンに含まれる、バグ修正などを追跡したい場合に便利です。
55
 
    しかし多くのプロジェクトに対してこれは必要以上の情報です。
56
 
 
57
 
  * `file_revisions`: プロジェクトのすべてのファイルに対する最終修正のリビジョンのリストを示すディクショナリ。
58
 
    これは ``$Id$`` キーワードがCVSで管理されたファイルと同じように使われます。
59
 
    最終修正の日付は ``revisions`` マップで探すことで決定されます。 
60
 
    デフォルトではこれは空で、 ``--all`` もしくは ``--include-file-revisions`` によってのみ有効になります
61
 
 
62
 
 
63
 
別のフォーマットでバージョン情報を得る
64
 
--------------------------------------
65
 
 
66
 
任意のフォーマットのバージョン情報を取得するためにBazaarはテンプレートベースの方法をサポートします。
67
 
``version-info`` への ``--custom`` オプションは作業ツリーのステータスに基づいて拡張された変数を含む
68
 
``--template`` 引数を提供することで使用できます。
69
 
 
70
 
たとえば、現在のリビジョン番号を含むフォーマットされた文字列を伴うCヘッダーファイルを生成するには::
71
 
 
72
 
 bzr version-info --custom \
73
 
      --template="#define VERSION_INFO \"Project 1.2.3 (r{revno})\"\n" \
74
 
      > version_info.h
75
 
 
76
 
``{revno}`` は作業ツリーのリビジョン番号に置き換えされます。
77
 
(上記の例があなたのOSで動作しない場合、一行ですべてのコマンドを入力してみてください) 
78
 
テンプレートの中で利用できる変数の詳細な情報に関しては、
79
 
Bazaarのユーザーリファレンスの `Version Info`_ を参照してください。
80
 
 
81
 
.. _Version Info: ../user-reference/bzr_man.html#version-info
82
 
 
83
 
特定の言語でバージョン情報をダンプするために予め定義されるフォーマットはは現在開発段階にあります。
84
 
この領域の要求に関してはメーリングリストで私達開発者に連絡して下さるようお願いします。
85
 
 
86
 
チェッククリーン
87
 
-----------------
88
 
 
89
 
プロジェクトの内容に関する大抵の情報はリビジョンエントリを読むだけで簡単に決定できます。
90
 
しかしながら、作業ツリーがパッケージされたときにそれが最新であったこと、
91
 
もしくはローカルな修正があったことを知るためには便利です。
92
 
``--all`` もしくは ``--check-clean`` のどちらかを提供することで ``bzr`` は作業ツリーを検査して、
93
 
``version_info`` ``clean`` を設定します。
94
 
同様に ``modified`` が適切である場合に ``file_revisions`` でエントリを設定します。
95
 
 
96
 
.. 
97
 
   vim: tw=74 ft=rst spell spelllang=en_us