[% title = "Debian Packaging Manual - 古いソースパッケージからの変換手続き" %]

<p><a name="ch-conversion"></a></p>
<hr>

<p>
[ <a href="ch-methif.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ <a href="ch-scope.html">1</a> ]
[ <a href="ch-binarypkg.html">2</a> ]
[ <a href="ch-sourcepkg.html">3</a> ]
[ <a href="ch-controlfields.html">4</a> ]
[ <a href="ch-versions.html">5</a> ]
[ <a href="ch-maintainerscripts.html">6</a> ]
[ <a href="ch-descriptions.html">7</a> ]
[ <a href="ch-relationships.html">8</a> ]
[ <a href="ch-conffiles.html">9</a> ]
[ <a href="ch-alternatives.html">10</a> ]
[ <a href="ch-diversions.html">11</a> ]
[ <a href="ch-sharedlibs.html">12</a> ]
[ <a href="ch-methif.html">13</a> ]
[ 14 ]
[ <a href="index.html">next</a> ]
</p>

<hr>

<h2>
Debian Packaging Manual
<br>Chapter 14 - 古いソースパッケージからの変換手続き
</h2>

<hr>

<p>
ここでは、2.0.0.0 以前の形式のソースパッケージを新しい形式に
変換する手続きについて簡単にまとめます。
</p>

<p>
まず、 <code>hello</code> パッケージをダウンロードして調べて
みることを強くお薦めします。そして、<code>dpkg</code>
プログラマーマニュアルのソースパッケージツールに関する部分を
お読みになってください。これらのツールに関する正確な機能の 詳細は、
<code>dpkg-source(1)</code> を参照してください。
</p>
<ul>
<li>
<p>
オリジナルのソースコードをダウンロードし、Debian の
ソースのオリジナルツリーに必要なすべての編集を 行ってください。そして、それを
<samp><var>package</var>-<var>upstream-version</var>.orig/</samp> か、
<samp><var>package</var>_<var>upstream-version</var>.orig.tar.gz</samp>
の中に置いて下さい。
</p>
</li>
</ul>
<ul>
<li>
<p>
すべての <samp>debian.*</samp> ファイル名を <samp>debian/*</samp>
へと変更してください。いくつかの例外はありますが、 まずここから始めましょう。
</p>
</li>
</ul>
<ul>
<li>
<p>
<samp>debian/changelog</samp> ファイルを編集してください。-
必要であれば、作成するかファイル名を変更してください。
新しいリビジョンを適切な説明とともにファイルの先頭に
付け加えてください。また、Emacs がきちんとしたモードで
動作するように、ローカル変数のエントリを最後に 付けて加えてください。:
</p>

<pre>
       Local variables:
       mode: debian-changelog
       End:
</pre>
</li>
</ul>
<ul>
<li>
<p>
<samp>debian/control</samp> ファイルを編集または 作成してください。
</p>
<ul>
<li>
<p>
<samp>Version</samp> フィールドを削除してください。
そのフィールドの生成が通常の方法で行われて いなかった場合
(ソースのバージョンと違う場合)、 dpkg-gencontrol の -v オプションを
使用しなければいけません (以下をごらん下さい)。
<samp>Section</samp>、<samp>Priority</samp>、 <samp>Maintainer</samp>
フィールドは、最初の空行より上に 置いてください。その他のたいていの部分は、
その下に来ます。
</p>
</li>
<li>
<p>
フィールド順を並びかえ、ソースパッケージの
フィールドをバイナリパッケージのフィールドから
分割するように、空行を適切な位置に加えてください。
</p>
</li>
<li>
<p>
<samp>Source</samp> フィールドを加えて下さい。
</p>
</li>
<li>
<p>
<samp>Standards-Version</samp> フィールドを加えてください
(このフィールドの詳細については、Debian Policy Manual を参照してください)。
</p>
</li>
<li>
<p>
それぞれのパッケージに対する <samp>Architecture</samp>
フィールドを、<samp>any</samp>、<samp>all</samp> やその他に
変更してください。<samp>Architecture</samp> がない場合は 加えてください。
</p>
</li>
<li>
<p>
sed やその他のツールによって、バイナリ制御ファイルを
作成している場合には、同様の効果を得るために、 <code>dpkg-gencontrol</code>
の変数置換機能を 使用して下さい。通常生成される以外の情報
(<samp>.deb</samp>ファイルの詳細とは別に) を
<samp>.changes</samp>ファイルに挿入することが必要な
場合は、<samp>debian/substvars</samp> を使ってください。
</p>
</li>
</ul>
</li>
</ul>
<ul>
<li>
<p>
<samp>debian/rules</samp> を編集する：
</p>
<ul>
<li>
<p>
<code>source</code> と <code>diff</code>、 あらゆる <code>changes</code> と
<code>dist</code> ターゲットを削除します。これらの項目は、現在、
パッケージと独立した方法で生成されていて、 <samp>debian/rules</samp>
によって指定されるものでは ありません。
</p>
</li>
<li>
<p>
<code>binary</code> ターゲットを <code>binary-arch</code> と
<code>binary-indep</code> とに分割します；たいてい、すべての
<code>binary</code> は <code>binary-arch</code>
に分類されます。<code>binary</code> およびもし一方の <code>binary-*</code>
しか存在しなかった場合は他方を 作成してください - <code>hello</code>
パッケージから コピーすることもできます。
</p>
</li>
<li>
<p>
<code>binary</code> ターゲットを変更して、 <code>dpkg-gencontrol</code>
を使って パッケージ制御ファイルを生成するように
します。そしてそれを、ファイルがすべてインストール
された後、ターゲット中の最後の <code>chown</code> と <code>chmod</code>
コマンドの実行前に、 パッケージ制御ファイルの作成を行うように 移動します。
</p>
</li>
<li>
<p>
<samp>debian-tmp</samp> を <samp>debian/tmp</samp> に 変更します。
</p>
</li>
<li>
<p>
<samp>debian.{post,pre}{inst,rm}</samp> ファイルを <samp>debian/*</samp>
に変更します。
</p>
</li>
<li>
<p>
トップでバージョン番号の設定を行っていた場合は、 削除します。
</p>
</li>
<li>
<p>
Debian 固有の修正と、上流のパッケージに関する
修正履歴がインストールされるようにします。
</p>
</li>
</ul>
</li>
</ul>
<ul>
<li>
<p>
パッケージの共有ライブラリに関する依存性を決めるには、
<code>dpkg-shlibdeps</code> を使用するように変更します。
今後、共有ライブラリ依存性をソースパッケージ中に 直接記述してはいけません。
</p>
</li>
</ul>
<ul>
<li>
<p>
<samp>debian/README</samp> ファイルが実はコピーライトに関する
ファイルになっていないかチェックし、そうであった時は、 ファイル名を
<samp>debian/copyright</samp> に変更します。 また、これに合わせて
<samp>debian/rules</samp> ファイルを
編集してこのファイルとコピーライトファイルの インストール場所を、
<samp>/usr/doc/<var>package</var>/copyright</samp> から
<samp>/usr/doc/copyright/<var>package</var></samp> へと
変更します。<samp>debian/README</samp> が
コピーライトファイルでなかった場合は、別途 <samp>debian/copyright</samp>
を用意します。 <samp>README</samp>
ファイルをどう処理するかは、各自で判断してください。
</p>
</li>
</ul>
<ul>
<li>
<p>
その他、時代遅れなところや問題がないかチェックします。
</p>
<ul>
<li>
<p>
<samp>Package_Revision</samp>、<samp>Package-Revision</samp>、
<samp>Revision</samp> の各フィールドを削除してください。
</p>
</li>
<li>
<p>
<samp>Optional</samp> フィールドを <samp>Suggests</samp>に、
<samp>Recommended</samp> フィールドを <samp>Recommends</samp>
に変更してください。
</p>
</li>
<li>
<p>
<samp>/usr/doc/examples/<var>package</var></samp> ディレクトリを
<samp>/usr/doc/<var>package</var>/examples</samp> に変更してください。
</p>
</li>
<li>
<p>
man ページが圧縮されてインストールされているかを 確認します。
</p>
</li>
<li>
<p>
説明文が、さらに詳細な説明部分を持っているか、また
その詳細部分が正しいフォーマットになっているのかを
チェックします。さらに、パッケージを
インストールするかどうか考えているユーザに、有意義で
有用な情報を提供できているかどうかといった点も チェックします。
</p>
</li>
</ul>
</li>
</ul>
<ul>
<li>
<p>
もう一度すべてを見直します。
</p>
</li>
</ul>
<ul>
<li>
<p>
<samp>dpkg-buildpackage -us -uc -sa -r<var>whatever</var></samp>
を用いて構築テストを行います。出来あがってきたパッケージの
ファイルのパーミッションと場所を <samp>dpkg-deb --contents</samp>
によってチェックします。 この時、ソースパッケージの構築がうまくいったかどうかも
チェックします。さらに、バイナリパッケージの
テストインストール、ソースパッケージの展開テストを 行ってください。
</p>
</li>
</ul>
<ul>
<li>
<p>
リリース版には署名をしてください。署名を行うには、 <samp>dpkg-buildpackage
-sa</samp> を使ってすべてを 再構築し直す方法と、<samp>.dsc</samp> に PGP
署名してから <samp>dpkg-genchanges -sa</samp> で <samp>.changes</samp>
ファイルを再構築し、更に <samp>.changes</samp> に PGP 署名する方法の 2
通りがあります。
</p>
</li>
</ul>

<p>
新形式のソースパッケージを初めて構築またはアップロードするとき
には、<code>dpkg-buildpackage</code> および <code>dpkg-genchanges</code> に
<samp>-sa</samp> オプションを 使用することが大切です。<samp>-sa</samp>
オプションを使用しないと、 パッケージの Debian
リビジョンがたまたまデフォルトである <samp>0</samp> もしくは <samp>1</samp>
でない場合、<samp>.changes</samp>
ファイルに掲載されるアップロードファイルに、オリジナルソース tar
ファイルが含まれないことになります。つまり、FTP サイトに
アップロードされません。<samp>-sa</samp> オプションを
使用すると、デフォルトでオリジナルのソースを含むように パッケージします。
</p>

<hr>

<p>
[ <a href="ch-methif.html">previous</a> ]
[ <a href="index.html#contents">Contents</a> ]
[ <a href="ch-scope.html">1</a> ]
[ <a href="ch-binarypkg.html">2</a> ]
[ <a href="ch-sourcepkg.html">3</a> ]
[ <a href="ch-controlfields.html">4</a> ]
[ <a href="ch-versions.html">5</a> ]
[ <a href="ch-maintainerscripts.html">6</a> ]
[ <a href="ch-descriptions.html">7</a> ]
[ <a href="ch-relationships.html">8</a> ]
[ <a href="ch-conffiles.html">9</a> ]
[ <a href="ch-alternatives.html">10</a> ]
[ <a href="ch-diversions.html">11</a> ]
[ <a href="ch-sharedlibs.html">12</a> ]
[ <a href="ch-methif.html">13</a> ]
[ 14 ]
[ <a href="index.html">next</a> ]
</p>

<hr>

<p>
Debian Packaging Manual
</p>

<address>
version revision 1.13, 2000-08-22<br>
<br>
Ian Jackson <code><a href="mailto:ijackson&#64;gnu.ai.mit.edu">ijackson&#64;gnu.ai.mit.edu</a></code><br>
校正: David A. Morris <code><a href="mailto:bweaver&#64;debian.org">bweaver&#64;debian.org</a></code><br>
メンテナー: Christian Schwarz <code><a href="mailto:schwarz&#64;debian.org">schwarz&#64;debian.org</a></code><br>
メンテナー: Manoj Srivastava <code><a href="mailto:srivasta&#64;debian.org">srivasta&#64;debian.org</a></code><br>
メンテナー: Julian Gilbey <code><a href="mailto:J.D.Gilbey&#64;qmw.ac.uk">J.D.Gilbey&#64;qmw.ac.uk</a></code><br>
メンテナー: The Debian Policy group <code><a href="mailto:debian-policy&#64;lists.debian.org">debian-policy&#64;lists.debian.org</a></code><br>
日本語版メンテナー: 早瀬 茂規 <code><a href="mailto:shayase&#64;tky3.3web.ne.jp">shayase&#64;tky3.3web.ne.jp</a></code><br>
日本語版校正: Japanese Debian Documentation Project <code><a href="mailto:debian-doc&#64;debian.or.jp">debian-doc&#64;debian.or.jp</a></code><br>
<br>
</address>
<hr>