/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

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

  • Committer: Vincent Ladeuil
  • Date: 2012-01-18 14:09:19 UTC
  • mto: This revision was merged to the branch mainline in revision 6468.
  • Revision ID: v.ladeuil+lp@free.fr-20120118140919-rlvdrhpc0nq1lbwi
Change set/remove to require a lock for the branch config files.

This means that tests (or any plugin for that matter) do not requires an
explicit lock on the branch anymore to change a single option. This also
means the optimisation becomes "opt-in" and as such won't be as
spectacular as it may be and/or harder to get right (nothing fails
anymore).

This reduces the diff by ~300 lines.

Code/tests that were updating more than one config option is still taking
a lock to at least avoid some IOs and demonstrate the benefits through
the decreased number of hpss calls.

The duplication between BranchStack and BranchOnlyStack will be removed
once the same sharing is in place for local config files, at which point
the Stack class itself may be able to host the changes.

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
例です::
 
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/index.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