[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Packaging Manual 第５章
早瀬です。
引続き、第５章の作業が完了したので、よろしくお願いします。
--
早瀬 茂規 (shayase@xxxxxxxxxxxxxxx)
<!-- ORIG
<chapt id="versions"><heading>Version numbering
ORIG -->
<chapt id="versions"><heading>バージョン番号付け
</heading>
<p>
<!-- ORIG
Every package has a version number, in its <tt>Version</tt>
control file field.
ORIG -->
全てのパッケージは、コントロールファイルの <tt>Version</tt>
フィールドにバージョン番号を持っています。
</p>
<p>
<!-- ORIG
<prgn>dpkg</prgn> imposes an ordering on version numbers, so
that it can tell whether packages are being up- or downgraded
and so that <prgn>dselect</prgn> can tell whether a package it
finds available is newer than the one installed on the system.
The version number format has the most significant parts (as
far as comparison is concerned) at the beginning.
ORIG -->
<prgn>dpkg</prgn> はバージョン番号に従って順序付けるように
なっています。これによって、<prgn>dpkg</prgn> はパッケージが
アップグレードされるのか、あるいは、ダウングレードされるのかを
知ることができ、さらに、<prgn>dselect</prgn> は利用できる
パッケージがシステムにインストールされているものよりも
新しいかどうかを知ることができます。バージョン番号の形式は
(比較に関する限り) 重要なものが前にくる順となっています。
</p>
<p>
<!-- ORIG
The version number format is:
&lsqb<var>epoch/<tt>:</tt>]<var>upstream-version</var>[<tt>-/<var>debian-revision</var>].</tt></var>
ORIG -->
バージョン番号のフォーマットは、
&lsqb<var>epoch/<tt>:</tt>]<var>upstream-version</var>[<tt>-/<var>debian-revision</var>]</tt></var>
です。
</p>
<p>
<!-- ORIG
The three components here are:
ORIG -->
ここには3つの構成要素があります:
<taglist>
<tag><var>epoch</var></tag>
<item>
<p>
<!-- ORIG
This is a single unsigned integer, which should usually
be small. It may be omitted, in which case zero is
assumed. If it is omitted then the
<var>upstream-version</var> may not contain any colons.
ORIG -->
これは1桁の符号なし整数です。普通は小さい数に
なるはずです。0の場合は省略しても構いません。
省略した時には、<var>upstream-version</var> にコロンを
含んではいけません。
</p>
<p>
<!-- ORIG
It is provided to allow mistakes in the version numbers
of older versions of a package, and also a package's
previous version numbering schemes, to be left behind.
ORIG -->
これはパッケージの古いバージョンのバージョン番号の誤りを
許すため、また、パッケージの以前のバージョン番号体系を
残しておくためにあります。
</p>
<p>
<!-- ORIG
<prgn>dpkg</prgn> will not usually display the epoch
unless it is essential (non-zero, or if the
<var>upstream-version</var> contains a colon);
<prgn>dselect</prgn> does not display epochs at all in
the main part of the package selection display.</p>
ORIG -->
<prgn>dpkg</prgn> は epoch に意味のある文字列が
含まれている場合 (0でない、または
<var>upstream-version</var> がコロンを含んでいる場合)
でなければ、通常それを表示しません。<prgn>dselect</prgn>
はパッケージ選択表示のメイン部分において、全く epoch を
表示しません。</p>
</item>
<tag><var>upstream-version</var></tag>
<item>
<p>
<!-- ORIG
This is the main part of the version. It is usually
version number of the original (`upstream') package of
which the <tt>.deb</tt> file has been made, if this is
applicable. Usually this will be in the same format as
that specified by the upstream author(s); however, it
may need to be reformatted to fit into
<prgn>dpkg</prgn>'s format and comparison scheme.
ORIG -->
これがバージョンの主要部分です。適用可能であれば、
これは通常、<tt>.deb</tt> ファイルが作られるオリジナルの
(「上流の」) パッケージのバージョン番号になります。通常、
これはもともとの上流の作者によって定められたものと
同じ形式になります。しかしながら、<prgn>dpkg</prgn>
の形式と比較体系に合わせるために再形式化する必要が
あるかも知れません。
</p>
<p>
<!-- ORIG
The comparison behaviour of <prgn>dpkg</prgn> with
respect to the <var>upstream-version</var> is described
below. The <var>upstream-version</var> portion of the
version number is mandatory.
ORIG -->
<var>upstream-version</var> に関する <prgn>dpkg</prgn>
の比較の振る舞いは後で述べます。バージョン番号の
<var>upstream-version</var> 部分は必須です。
</p>
<p>
<!-- ORIG
The <var>upstream-version</var> may contain only
alphanumerics and the characters <tt>+</tt> <tt>.</tt>
<tt>-</tt> <tt>:</tt> (full stop, plus, hyphen, colon)
and should start with a digit. If there is no
<var>debian-revision</var> then hyphens are not allowed;
if there is no <var>epoch</var> then colons are not
allowed.</p>
ORIG -->
<var>upstream-version</var> は英数字と文字 <tt>+</tt>
<tt>.</tt> <tt>-</tt> <tt>:</tt> (ピリオド、プラス、
ハイフン、コロン) だけから構成されており、数字で
始まらなくてはいけません。ただし、
<var>debian-revision</var> がなければ、ハイフンは
許されません。また、<var>epoch</var> がなければ、
コロンは許されません。</p>
</item>
<tag><var>debian-revision</var></tag>
<item>
<p>
<!-- ORIG
This part of the version represents the version of the
modifications that were made to the package to make it a
Debian binary package. It is in the same format as the
<var>upstream-version</var> and <prgn>dpkg</prgn>
compares it in the same way.
ORIG -->
バージョンのこの部分は、そのパッケージを Debian
バイナリパッケージにするためにほどこした修正の
バージョンを表しています。これは
<var>upstream-version</var> と同じ形式であり、
<prgn>dpkg</prgn> は同じやり方で比較を行います。
</p>
<p>
<!-- ORIG
It is optional; if it isn't present then the
<var>upstream-version</var> may not contain a hyphen.
This format represents the case where a piece of
software was written specifically to be turned into a
Debian binary package, and so there is only one
`debianization' of it and therefore no revision
indication is required.
ORIG -->
これはオプションです。<var>debian-revision</var>
を持たない形式では、<var>upstream-version</var> に
ハイフンを含んではいけません。この形式のものは
Debian バイナリパッケージになるように特別に
書かれたソフトウェアであることを示しています。ですから、
そのソフトウェアの 「Debian 化」 はたった一つだけあり、
それゆえ、リビジョンの表示は必要ありません。
</p>
<p>
<!-- ORIG
It is conventional to restart the
<var>debian-revision</var> at <tt>1</tt> each time the
<var>upstream-version</var> is increased.
ORIG -->
<var>upstream-version</var> が増加するたびに、
<var>debian-revision</var> を <tt>1</tt> から
再スタートするのが慣習となっています。
</p>
<p>
<!-- ORIG
<prgn>dpkg</prgn> will break the
<var>upstream-version</var> and
<var>debian-revision</var> apart at the last hyphen in
the string. The absence of a <var>debian-revision</var>
compares earlier than the presence of one (but note that
the <var>debian-revision</var> is the least significant
part of the version number).
ORIG -->
<prgn>dpkg</prgn> は文字列中の最後のハイフンのところで
<var>upstream-version</var> と <var>debian-revision</var>
とに分割しようとします。<var>debian-revision</var>
がないものは、それがあるものより以前のものであると
比較されます (でも <var>debian-revision</var> は
バージョン番号の最下位部分であることに注意して下さい)。
</p>
<p>
<!-- ORIG
The <var>debian-revision</var> may contain only
alphanumerics and the characters <tt>+</tt> and
<tt>.</tt> (plus and full stop).
ORIG -->
<var>debian-revision</var> は英数字と文字 <tt>+</tt>
<tt>.</tt> (プラスとピリオド) だけから構成されます。
</p>
</item>
</taglist>
<!-- ORIG
The <var>upstream-version</var> and <var>debian-revision</var> parts are
compared by <prgn>dpkg</prgn> using the same algorithm:
ORIG -->
<var>upstream-version</var> と <var>debian-revision</var> の部分は、
<prgn>dpkg</prgn> によって同じアルゴリズムを使って比較されます:
</p>
<p>
<!-- ORIG
The strings are compared from left to right.
ORIG -->
文字列は左から右へと比較されます。
</p>
<p>
<!-- ORIG
First the initial part of each string consisting entirely of
non-digit characters is determined. These two parts (one of
which may be empty) are compared lexically. If a difference
is found it is returned. The lexical comparison is a
comparison of ASCII values modified so that all the letters
sort earlier than all the non-letters.
ORIG -->
最初に、比較対象となる2つの文字列の中で、全て非数字で
構成される最初の部分を決定します。それぞれの文字列に対する、
この部分 (そのうちの一つは空であっても構いません) は辞書順で
比較します。もし違いが見つかれば、それを返します。ここでの
辞書順とは，すべての文字が非文字より先に来る様に修正した
ASCII 順です。
</p>
<p>
<!-- ORIG
Then the initial part of the remainder of each string which
consists entirely of digit characters is determined. The
numerical values of these two parts are compared, and any
difference found is returned as the result of the comparison.
For these purposes an empty string (which can only occur at
the end of one or both version strings being compared) counts
as zero.
ORIG -->
次に、2つの文字列の残りのうちで、全て数字で構成される最初の
部分を決定します。この2つの数値を比較し、比較結果として
見つかった違いを返します。こうするために、空文字列
(比較している一方もしくは双方のバージョン文字列の末尾に
おいてのみ生じる）は0として数えます。
</p>
<p>
<!-- ORIG
These two steps are repeated (chopping initial non-digit
strings and initial digit strings off from the start) until a
difference is found or both strings are exhausted.
ORIG -->
違いが見つかるか、双方の文字列を調べ尽くすかするまで、
この2つのステップを (先頭から、最初の非数字の文字列と
最初の数字の文字列を切り離しながら) 繰り返します。
</p>
<p>
<!-- ORIG
Note that the purpose of epochs is to allow us to leave behind
mistakes in version numbering, and to cope with situations
where the version numbering changes. It is <em>not</em> there
to cope with version numbers containing strings of letters
which <prgn>dpkg</prgn> cannot interpret (such as
<tt>ALPHA</tt> or <tt>pre-</tt>), or with silly orderings (the
author of this manual has heard of a package whose versions
went <tt>1.1</tt>, <tt>1.2</tt>, <tt>1.3</tt>, <tt>1</tt>,
<tt>2.1</tt>, <tt>2.2</tt>, <tt>2</tt> and so forth).
ORIG -->
epoch の目的はバージョン番号付けのミスをそのままにできるように
するため，またバージョン番号の付け方を変更した場合にそれを
うまく扱えるようにするためだということに注意してください。
<prgn>dpkg</prgn> が解釈することのできない文字
(<tt>ALPHA</tt> や <tt>pre-</tt>) から成る文字列を含む
バージョン番号や、思慮の浅い順序付け
(このマニュアルの著者は、<tt>1.1</tt>, <tt>1.2</tt>,
<tt>1.3</tt>, <tt>1</tt>, <tt>2.1</tt>, <tt>2.2</tt>,
<tt>2</tt> などとバージョンが進んでいったパッケージを
聞いたことがあります) をうまく処理するためでは
<em>ありません</em>。
</p>
<p>
<!-- ORIG
If an upstream package has problematic version numbers they
should be converted to a sane form for use in the
<tt>Version</tt> field.
ORIG -->
もし上流のパッケージが問題のあるバージョン番号になっている
ならば、<tt>Version</tt> フィールドで使っている健全な形式に
変換すべきです。
</p>
<p>
<!-- ORIG
If you need to compare version numbers in a script, you may use
<tt>dpkg −compare-versions ...</tt>. Type <tt>dpkg
−help</tt> −> −for details on arguments.
ORIG -->
もしスクリプト中でバージョン番号を比較する必要があれば、
<tt>dpkg --compare-versions ...</tt> を使うと良いでしょう。
引数について詳しく知りたければ、<tt>dpkg --help</tt>
--> -- とタイプして下さい。
</p>
</chapt>