Developer's Reference chap.11

[Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>]

遠藤です。

# やっと完了 :-)。

Debian デベロッパーズリファレンス最終章 (第 11 章) の翻訳です。
チェックお願いします。

|     <chapt id="tools">Overview of Debian Maintainer Tools
|       <p>
| This section contains a rough overview of the tools available to
| maintainers.  These tools are meant to help convenience developers and 
| free their time for critical tasks.  

    <chapt id="tools">Debian 開発者用ツールの概観
      <p>
この章では、開発者が利用できるツール群を大まかに概観します。
これらのツール群は、開発者の便宜を図り、
開発者が重要な作業に時間を割けるよう用意されています。

|       <p>
| Some people prefer to use high-level package maintenance tools and
| some do not.  Debian is officially agnostic on this issue; any tool
| which gets the job done is fine.  Therefore, this section is not meant
| to stipulate to anyone which tools they should use or how they should
| go about with their duties of maintainership.  Nor is it meant to
| endorse any particular tool to the exclusion of a competing tool.

      <p>
高レベルのパッケージ開発ツールの利用を好む人もいれば、好まない人もいます。
Debian が公式にこの問題に関知することはありません。
つまり、どのツールを用いても作業を行なうことができるならば問題ありません。
そのため、この章は、どのツールを使うべきなのか、
開発に伴う作業にどのように取り組むべきなのか、
について規定するものではありません。
また、競合するツールの排除を避けるために、
特定のツールを推奨することもしません。

|       <p>
| Most of the descriptions of these packages come from the actual
| package descriptions themselves.  Further information can be found in
| the package documentation itself.

      <p>
これらパッケージの説明文の大半は、
現行のパッケージ説明文そのものを参考にしたものです。
より詳細な情報は各パッケージのドキュメントをご覧ください。

|       <sect id="dpkg-dev">
| 	<heading><package>dpkg-dev</package>
| 	<p>
| <package>dpkg-dev</package> contains the tools (including
| <prgn>dpkg-source</prgn>) required to unpack, build and upload Debian
| source packages.  These utilities contain the fundamental, low-level
| functionality required to create and manipulated packages; as such,
| they are required for any Debian maintainer.

      <sect id="dpkg-dev">
	<heading><package>dpkg-dev</package>
	<p>
<package>dpkg-dev</package> には、Debian ソースパッケージの展開、
ビルド、アップロードに必要となる (<prgn>dpkg-source</prgn> を含む) 
ツール群が収録されています。
これらのユーティリティ群は、パッケージの作成および操作に必要となる
基本的で低レベルな機能を提供します。
そのため、こちらはいずれの Debian 開発者にも必要となるものです。

|       <sect id="lintian">
| 	<heading><package>lintian</package>
| 	<p>
| <package>Lintian</package> dissects Debian packages and reports bugs
| and policy violations. It contains automated checks for many aspects
| of Debian policy as well as some checks for common errors.  The use of
| <package>lintian</package> has already been discussed in <ref
| id="upload-checking"> and <ref id="lintian-reports">.

      <sect id="lintian">
	<heading><package>lintian</package>
	<p>
<package>lintian</package> は Debian パッケージを精査し、
バグやポリシー違反を報告します。
こちらは、一般的なエラーのチェックとともに、
Debian ポリシーの多角的な自動チェックも行ないます。
<package>lintian</package> の利用については、
<ref id="upload-checking"> および <ref id="lintian-reports"> 
ですでに説明してあります。

|       <sect id="debhelper">
| 	<heading><package>debhelper</package>
| 	<p>
| <package>debhelper</package> is a collection of programs that can be
| used in <file>debian/rules</file> to automate common tasks related to
| building binary Debian packages. Programs are included to install
| various files into your package, compress files, fix file permissions,
| integrate your package with the Debian menu system.

      <sect id="debhelper">
	<heading><package>debhelper</package>
	<p>
<package>debhelper</package>は、
バイナリ Debian パッケージのビルドに関連する
一般的な作業を自動化するために、
<file>debian/rules</file> 作成に利用できるプログラム集です。
こちらには、作成するパッケージへのさまざまなファイルのインストールや、
ファイルの圧縮、ファイルパーミッションの修正、作成するパッケージの 
Debian menu システムへの統合を行なうプログラム群が含まれています。

| 	<p>
| Unlike <package>debmake</package>, <package>debhelper</package> is
| broken into several small, granular commands which act in a consistent
| manner.  As such, it allows a greater granularity of control than
| <package>debmake</package>.

	<p>
<package>debmake</package> とは異なり、<package>debhelper</package> は、
一貫した流儀で動作しながらも、小さく、
独立している複数のコマンド群から構成されています。
そのため、こちらは <package>debmake</package> 
より細かな管理を行なうことができます。

|       <sect id="debmake">
| 	<heading><package>debmake</package>
| 	<p>
| <package>debmake</package>, a pre-cursor to
| <package>debhelper</package>, is a less granular
| <file>debian/rules</file> assistant. It includes two main programs:
| <prgn>deb-make</prgn>, which can be used to help a maintainer convert
| a regular (non-Debian) source archive into a Debian source package;
| and <prgn>debstd</prgn>, which incorporates in one big shot the same
| sort of automated functions that one finds in
| <package>debhelper</package>.

      <sect id="debmake">
	<heading><package>debmake</package>
	<p>
<package>debmake</package> は、<package>debhelper</package> 
に先行して開発されたもので、より大まかに少ないコマンドで 
<file>debian/rules</file> 作成の補助を行なうものです
こちらには主に二つのプログラムが含まれています。
一つは <prgn>deb-make</prgn> で、
こちらは、開発者が通常の (Debian 的ではない)
ソースアーカイブを Debian ソースパッケージへ変換する際、
それを補助するために用いられます。
もう一つは <prgn>debstd</prgn> で、
こちらは <package>debhelper</package> で実現されているような、
同種の自動化された機能を一つにまとめたものです。

| 	<p>
| The consensus is that <package>debmake</package> is now deprecated in
| favor of <package>debhelper</package>.  However, it's not a bug to use
| <package>debmake</package>.
| 

	<p>
今では <package>debhelper</package> の利用が好まれ、
<package>debmake</package> の利用は避けようとの合意があります。
しかしながら、<package>debmake</package> を利用するにあたって、
そのバグが問題になることがあるわけではありません。

|       <sect id="yada">
| 	<heading><package>yada</package>
| 	<p>
| <package>yada</package> is a new packaging helper tool with a slightly
| different philosophy.  It uses a <file>debian/packages</file> file to
| auto-generate other necessary files in the <file>debian/</file>
| subdirectory.

      <sect id="yada">
	<heading><package>yada</package>
	<p>
<package>yada</package> は若干異なる思想を持つ、
新たなパッケージング補助ツールです。
<file>debian/packages</file> ファイルを用いて、
<file>debian/</file> サブディレクトリ以下に設置される
他の必要なファイルを自動生成します。

| 	<p>
| Note that <package>yada</package> is still quite new and possibly not
| yet as robust as other systems.

	<p>
なお <package>yada</package> はまだまだ新しいものですので、
他のシステムに比べればロバストでない可能性があります。

|       <sect id="equivs">
| 	<heading><package>equivs</package>
| 	<p>
| <package>equivs</package> is another package for making packages.  It
| is often suggested for local use if you need to make a package simply
| to fulfill dependancies.  It is also sometimes used when making
| ``meta-packages'', which are packages whose only purpose is to depend
| on other packages.

      <sect id="equivs">
	<heading><package>equivs</package>
	<p>
<package>equivs</package> は、パッケージ作成用に
また別に用意されているパッケージです。
こちらは、
単に依存関係を満たすためにパッケージを作成しなければならない場合などの、
ローカルな利用にしばしば推奨されているものです。
また、他パッケージに依存することのみを目的としたパッケージ
``meta-packages'' を作成する場合などにも利用されます。

|       <sect id="cvs-buildpackage">
| 	<heading><package>cvs-buildpackage</package>
| 	<p>
| <package>cvs-buildpackage</package> provides the capability to inject
| or import Debian source packages into a CVS repository, build a Debian
| package from the CVS repository, and helps in integrating upstream
| changes into the repository.

      <sect id="cvs-buildpackage">
	<heading><package>cvs-buildpackage</package>
	<p>
<package>cvs-buildpackage</package> は、
Debian ソースパッケージの CVS リポジトリへの導入やインポート、
CVS リポジトリからの Debian パッケージのビルド、
アップストリームにおける変更のリポジトリへの統合の補助
といった機能を提供します。

| 	<p>
| These utilities provide an infrastructure to facilitate the use of CVS
| by Debian maintainers. This allows one to keep separate CVS branches
| of a package for <em>stable</em>, <em>unstable</em>, and possibly
| <em>experimental</em> distributions, along with the other benefits of
| a version control system.

	<p>
これらのユーティリティは、Debian 開発者による CVS 
の利用を容易にするインフラを提供します。
こちらを利用すれば、バージョンコントロールシステムの利点を生かして、
<em>stable</em> や、<em>unstable</em>、場合によっては <em>experimental</em> 
といったディストリビューション向けに、あるパッケージを独立した複数の 
CVS ブランチにて管理できます。

|       <sect id="dupload">
| 	<heading><package>dupload</package>
| 	<p>
| <package>dupload</package> is a package and a script to automagically
| upload Debian packages to the Debian archive, to log the upload, and
| to send mail about the upload of a package.  You can configure it for
| new upload locations or methods.

      <sect id="dupload">
	<heading><package>dupload</package>
	<p>
<package>dupload</package> は、
Debian パッケージを Debian アーカイブに自動アップロードしたり、
アップロードのログをとったり、
パッケーアップロードに関する電子メールを送信したりする、
スクリプトおよびパッケージです。
こちらでは、新規アップロードを行なう先の場所や、
その方法を設定することも可能です。

|       <sect id="fakeroot">
| 	<heading><package>fakeroot</package>
| 	<p>
| <package>fakeroot</package> simulates root privileges.  This enables
| you to build packages without being root (packages usually want to
| install files with root ownership).  If you have
| <package>fakeroot</package> installed, you can say, i.e.,
| <tt>dpkg-buildpackage -rfakeroot</tt> as a user.

      <sect id="fakeroot">
	<heading><package>fakeroot</package>
	<p>
<package>fakeroot</package> は root 権限をシミュレートします。
こちらを利用すれば、root にならずにパッケージをビルドできます。
(各パッケージでは、通常 root
 の所有権でファイルがインストールされている必要があります。)
<package>fakeroot</package> がインストールされていれば、
一般ユーザで、例えば <tt>dpkg-buildpackage -rfakeroot</tt> 
とすることができます。

|       <sect id="devscripts">
| 	<heading><package>devscripts</package>
| 	<p>
| <package>devscripts</package> is a package containing a few wrappers
| and tools which you may find helpful for maintaining your Debian
| packages.  Example scripts include <prgn>debchange</prgn>, which will
| manipulate your <file>debian/changelog</file> file from the
| command-line, and <prgn>debuild</prgn>, which is a wrapper around
| <prgn>dpkg-buildpackage</prgn>.

      <sect id="devscripts">
	<heading><package>devscripts</package>
	<p>
<package>devscripts</package> は、Debian パッケージ開発に役立つ
ラッパーやツールを収録したパッケージです。
例題スクリプトとして、<file>debian/changelog</file> 
ファイルをコマンドラインから操作するための <prgn>debchange</prgn> 
や、<prgn>dpkg-buildpackage</prgn> のラッパーである <prgn>debuild</prgn> 
が含まれています。

|       <sect id="debget">
| 	<heading><package>debget</package>
| 	<p>
| <package>debget</package> is a package containing a convenient script
| which can be helpful in downloading files from the Debian archive.
| You can use it to download source packages, for instance.

      <sect id="debget">
	<heading><package>debget</package>
	<p>
<package>debget</package> は、Debian 
アーカイブからファイルをダウンロードする際に役立つ
便利なスクリプトを収録したパッケージです。
例えば、ソースパッケージのダウンロードにこちらを利用することができます。

-- 
Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>