maint-guide r7640 - en to ja translation catalogue (955 entries)

note: type: Attribute 'lang' of: <book>
en: en
ja: ja

note: type: Content of: <book><title>
en: Debian New Maintainers' Guide
ja: Debian 新メンテナーガイド

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: original contents
ja: 初期の内容

note: type: Content of: <book><bookinfo><authorgroup><author><contrib>
en: updated contents
ja: 更新された内容

note: type: Content of: <book><bookinfo><releaseinfo>
en: version &docversion;
ja: バージョン &docversion;

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document may be used under the terms of the GNU General Public License version 2 or higher.
ja: この文書は GNU 一般公有使用許諾書、バージョン 2 もしくはそれ以降により規定される条件の下で使用できます。

note: type: Content of: <book><bookinfo><legalnotice><para>
en: This document was made using these two documents as examples:
ja: この文書は以下の二つの文書を参考にして書かれました:

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: Making a Debian Package (AKA the Debmake Manual), copyright © 1997 Jaldhar Vyas.
ja: Debian パッケージの作り方 (別名 Debmake マニュアル)、Copyright © 1997 Jaldhar Vyas.

note: type: Content of: <book><bookinfo><legalnotice><itemizedlist><listitem><para>
en: The New-Maintainer's Debian Packaging Howto, copyright © 1997 Will Lowe.
ja: 新メンテナー向け Debian パッケージング法、copyright © 1997 Will Lowe.

note: type: Content of: <book><chapter><title>
en: Getting started The Right Way
ja: まずは正攻法で始めよう

note: type: Content of: <book><appendix><para>
en: The rewrite of this tutorial document with updated contents and more practical examples is available as <ulink url="&guidedeb;">Guide for Debian Maintainers</ulink>.  Please use this new tutorial as the primary tutorial document.
ja: 最新の内容とより実用的な例でこの入門書を書き換えたものが <ulink url="&guidedeb;">Guide for Debian Maintainers</ulink> として入手できます。この新しい入門書を第一次的な入門書として使ってください。

note: type: Content of: <book><chapter><para>
en: This document tries to describe the building of a Debian package to ordinary Debian users and prospective developers.  It uses fairly non-technical language, and it's well covered with working examples.  There is an old Latin saying: <emphasis>Longum iter est per praecepta, breve et efficax per exempla</emphasis> (It's a long way by the rules, but short and efficient with examples).
ja: この文書では、一般の Debian ユーザーやデベロッパーを目指している人を対象に Debian パッケージのビルド方法の解説を試みます。技術用語はできるだけ避けて、実用的な例示を多用しています。古いラテンの諺にもあるように、<emphasis>Longum iter est per praecepta, breve et efficax per exempla</emphasis> (百聞は一見にしかず) です。

note: type: Content of: <book><chapter><para><footnote><para>
en: The document assumes you are using a <literal>&base-release;</literal> or newer system.  If you need to follow this text in an older system (including an older Ubuntu system etc.), you must install backported <systemitem role="package">dpkg</systemitem> and <systemitem role="package">debhelper</systemitem> packages, at least.
ja: 文中では、<literal>&base-release;</literal> より新しいシステムを使っていると想定しています。古いシステム (古い Ubuntu システム等を含む)を使ってこの文書についていきたいのであれば、少なくともバックポートされた <systemitem role="package">dpkg</systemitem> および <systemitem role="package">debhelper</systemitem> パッケージをインストールする必要があります。

note: type: Content of: <book><chapter><para>
en: This document is made available for the Debian <literal>Buster</literal> release since this offers many translations.  This document will be dropped in the following releases since contents are getting outdated.  <placeholder type="footnote" id="0"/>
ja: 本文書は多くの翻訳があるため Debian <literal>Buster</literal> リリースでは提供されます。本文書はこれに続くリリースでは内容が陳腐化しているため提供されなくなります。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><para><footnote><para>
en: You can learn about the basic handling of a Debian system from the <ulink url="&debref;">Debian Reference</ulink>.  It contains some pointers to learn about Unix programming, too.
ja: Debian システムの基本的な操作は <ulink url="&debref;">Debian Reference</ulink> から学べます。Unix プログラミングに関しても学べるいくつかのポインターも含まれています。

note: type: Content of: <book><chapter><para>
en: One of the things that makes Debian such a top-notch distribution is its package system.  While there is a vast quantity of software already in the Debian format, sometimes you need to install software that isn't.  You may be wondering how you can make your own packages; and perhaps you think it is a very difficult task.  Well, if you are a real novice on Linux, it is hard, but if you were a rookie, you wouldn't be reading this document now&nbsp;:-)  You do need to know a little about Unix programming but you certainly don't need to be a wizard.  <placeholder type="footnote" id="0"/>
ja: Debian を最高峰の Linux ディストリビューションたらしめている理由のひとつが、そのパッケージ管理システムです。すでに膨大な数のソフトウェアが Debian 形式で配布されていますが、まだパッケージ化されていないソフトウェアをインストールしなければならないことがあるでしょう。どうやったら自分でパッケージが作れるんだろうとか、それはとても難しいことなんじゃないかなどと考えたことがありませんか。確かに、もしあなたが本当に駆け出しの Linux ユーザーなら難しいでしょうが、それなら今ごろこんな文書を読んでませんよね&nbsp;:-) Unix のプログラミングについて少々知っている必要がありますが、神様みたいに精通している必要は全くありません。 <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><para>
en: One thing is certain, though: to properly create and maintain Debian packages takes many hours.  Make no mistake, for our system to work the maintainers need to be both technically competent and diligent.
ja: ただ、確かなことがひとつあります。Debian パッケージをきちんと作成し保守していくには時間がかかるということです。間違えないでください、Debian のシステムが機能するには、メンテナーは技術的に有能であるだけでなく、勤勉であることも必要なのです。

note: type: Content of: <book><chapter><para>
en: If you need some help with packaging, please read <xref linkend="helpme"/>.
ja: パッケージ作成において手助けが必要な際には、<xref linkend="helpme"/> を読んでください。

note: type: Content of: <book><chapter><para>
en: Newer versions of this document should always be available online at <ulink url="&maint-guide;"/> and in the <systemitem role="package">maint-guide</systemitem> package.  The translations may be available in packages such as <systemitem role="package">maint-guide-es</systemitem>.  Please note that this documentation may be slightly outdated.
ja: この文書の最新版は常に以下の場所からネットワーク経由で入手できます。<ulink url="&maint-guide;"/> また、<systemitem role="package">maint-guide</systemitem>パッケージにも含まれています。日本語訳は<systemitem role="package">maint-guide-ja</systemitem>パッケージに含まれています。本文書の内容が少々古くなっているかもしれない事に注意して下さい。

note: type: Content of: <book><chapter><para>
en: Since this is a tutorial, I choose to explain each detailed step for some important topics.  Some of them may look irrelevant to you.  Please be patient.  I have also intentionally skipped some corner cases and provided only pointers to keep this document simple.
ja: 本書は入門書ですので、一部の重要なトピックスは詳細なステップを個々説明するようにしました。あなたには不要と思われる部分があるかもしれません。我慢して下さい。本文書を簡潔にするように一部のコーナーケースを意識的に省略したり参照を提供するだけに止めています。

note: type: Content of: <book><chapter><section><title>
en: Social dynamics of Debian
ja: Debianにおける社会ダイナミクス

note: type: Content of: <book><chapter><section><para>
en: Here are some observations of Debian's social dynamics, presented in the hope that it will prepare you for interactions with Debian:
ja: あなたがDebian と関わる際の準備となることを望み、Debianの社会ダイナミクスの観察結果を記します:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: We all are volunteers.
ja: 我々全員はボランティアです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You cannot impose on others what to do.
ja: 他人に何をするかを押し付けてはいけません。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be motivated to do things by yourself.
ja: 自分自身で行う意欲を持つべきです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Friendly cooperation is the driving force.
ja: 友好的な協力が推進力です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution should not overstrain others.
ja: あなたの寄与は他人にストレスを掛けすぎてはいけません。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Your contribution is valuable only when others appreciate it.
ja: あなたの寄与は他人に評価されて初めて価値があります。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is not your school where you get automatic attention of teachers.
ja: Debian は教師の注意が自動的にあなたに注がれるあなたの学校とは違います。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should be able to learn many things by yourself.
ja: 多様な案件の独学能力を持つべきです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Attention from other volunteers is a very scarce resource.
ja: 他ボランティアに注意を払ってもらうことは貴重なリソースです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Debian is constantly improving.
ja: Debian は常に改良されています。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You are expected to make high quality packages.
ja: あなたには高品質パッケージを作成することが期待されています。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should adapt yourself to change.
ja: あなたは変化に自らを適合させる必要があります。

note: type: Content of: <book><chapter><section><para>
en: There are several types of people interacting around Debian with different roles:
ja: Debian 界隈では異なる役割で色々なタイプの人が交流しています:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream author</emphasis>: the person who made the original program.
ja: <emphasis role="strong">upstream author (アップストリームの作者)</emphasis>: 元のプログラムを作った人です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">upstream maintainer</emphasis>: the person who currently maintains the program.
ja: <emphasis role="strong">upstream maintainer (アップストリームのメンテナー)</emphasis>: 現在プログラムをメンテナンスしている人です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">maintainer</emphasis>: the person making the Debian package of the program.
ja: <emphasis role="strong">maintainer (メンテナー)</emphasis>: プログラムの Debian パッケージを作成している人です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">sponsor</emphasis>: a person who helps maintainers to upload packages to the official Debian package archive (after checking their contents).
ja: <emphasis role="strong">sponsor (スポンサー)</emphasis>: メンテナーのパッケージを、(内容をチェックした後で)公式 Debian パッケージアーカイブにアップロードするのを手伝う人です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">mentor</emphasis>: a person who helps novice maintainers with packaging etc.
ja: <emphasis role="strong">mentor (指導役)</emphasis>: 新米メンテナーをパッケージを作成等で手助けする人です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Developer</emphasis> (DD): a member of the Debian project with full upload rights to the official Debian package archive.
ja: <emphasis role="strong">Debian Developer (Debian デベロッパー)</emphasis> (DD): 公式 Debian パッケージアーカイブへの全面的アップロード権限を持っているDebian プロジェクトのメンバーです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <emphasis role="strong">Debian Maintainer</emphasis> (DM): a person with limited upload rights to the official Debian package archive.
ja: <emphasis role="strong">Debian Maintainer (Debian メンテナー)</emphasis> (DM): 公式 Debian パッケージアーカイブへの限定的アップロード権限持っている人です。

note: type: Content of: <book><chapter><section><para>
en: Please note that you cannot become an official <emphasis role="strong">Debian Developer</emphasis> (DD) overnight, because it takes more than technical skill.  Please do not be discouraged by this.  If it is useful to others, you can still upload your package either as a <emphasis role="strong">maintainer</emphasis> through a <emphasis role="strong">sponsor</emphasis> or as a <emphasis role="strong">Debian Maintainer</emphasis>.
ja: 技術的なスキル以外の要件があるので、一夜にして正式な <emphasis role="strong">Debian デベロッパー</emphasis> (DD)  になることはできません。これでがっかりしないでください。あなたのパッケージが他の人にとっても有用ならば、あなたはそれを<emphasis role="strong">メンテナー</emphasis>として <emphasis role="strong">スポンサー</emphasis> を通して、あるいは <emphasis role="strong">Debian メンテナー</emphasis> として、アップロードすることが可能です。

note: type: Content of: <book><chapter><section><para>
en: Please note that you do not need to create any new package to become an official Debian Developer.  Contributing to the existing packages can provide a path to becoming an official Debian Developer too.  There are many packages waiting for good maintainers (see <xref linkend="choose"/>).
ja: 正式な Debian デベロッパーになるのに新しいパッケージの作成は必須ではないことに注意してください。既存のパッケージに対して貢献していくことでも正式な Debian デベロッパーへの道は開かれます。多くのパッケージがよいメンテナーを待っています (<xref linkend="choose"/> を参照)。

note: type: Content of: <book><chapter><section><para>
en: Since we focus only on technical aspects of packaging in this document, please refer to the following to learn how Debian functions and how you can get involved:
ja: 本書ではパッケージングの技術面にのみフォーカスするので、Debian が如何にして機能し、あなたが如何にすれば関与できるのかは以下を参照下さい:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&logiciellibre;">Debian: 17 years of Free Software, "do-ocracy", and democracy</ulink> (Introductory slides)
ja: <ulink url="&logiciellibre;">Debian: フリーソフトウェアと、"do-ocracy" (実行による支配)と、democracy (多数決による支配)の17年間</ulink> (紹介スライド、英語)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianorghelp;">How can you help Debian?</ulink> (official)
ja: <ulink url="&debianorghelp;">Debian に協力するには?</ulink> (正規)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianfaqhelp;">The Debian GNU/Linux FAQ, Chapter 13 - "Contributing to the Debian Project"</ulink> (semi-official)
ja: <ulink url="&debianfaqhelp;">The Debian GNU/Linux FAQ, Chapter 13 - "Contributing to the Debian Project"</ulink> (準正規)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (supplemental)
ja: <ulink url="&debianwikihelp;">Debian Wiki, HelpDebian</ulink> (補足)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&nm-do;">Debian New Member site</ulink> (official)
ja: <ulink url="&nm-do;">Debian New Member サイト</ulink> (正規)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (supplemental)
ja: <ulink url="&debianmentorfaq;">Debian Mentors FAQ</ulink> (補足)

note: type: Content of: <book><chapter><section><title>
en: Programs needed for development
ja: 開発に必要なプログラム

note: type: Content of: <book><chapter><section><para>
en: Before you start anything, you should make sure that you have properly installed some additional packages needed for development.  Note that the list doesn't contain any packages marked <literal>essential</literal> or <literal>required</literal> - we expect that you have those installed already.
ja: 何はさておき、開発に必要なパッケージがきちんとインストールされていることを確認するべきです。以下のリストには <literal>essential</literal> または <literal>required</literal> なパッケージが含まれていないことに注意してください。これらのパッケージは既にインストールされていることを前提としています。

note: type: Content of: <book><chapter><section><para>
en: The following packages come with the standard Debian installation, so you probably have them already (along with any additional packages they depend on).  Still, you should check them with <literal>aptitude show <replaceable>package</replaceable></literal> or with <literal>dpkg -s <replaceable>package</replaceable></literal>.
ja: 以下のパッケージは Debian の標準 (standard) インストール構成に含まれており、すでに (それらが依存する他のパッケージとともに)  システムに含まれているはずです。しかし、念のために <literal>aptitude show <replaceable>package</replaceable></literal> もしくは <literal>dpkg -s <replaceable>package</replaceable></literal> を用いて確認しておきましょう。

note: type: Content of: <book><chapter><section><para>
en: The most important package to install on your development system is the <systemitem role="package">build-essential</systemitem> package.  Once you try to install that, it will <emphasis>pull in</emphasis> other packages required to have a basic build environment.
ja: 開発用システムにインストールする一番重要なパッケージは、<systemitem role="package">build-essential</systemitem> です。これをインストールしようとすると、基本的なビルド環境で必要な他のパッケージを <emphasis>引き込む</emphasis>でしょう。

note: type: Content of: <book><chapter><section><para>
en: For some types of packages, that is all you will require; however, there is another set of packages that while not essential for all package builds are useful to have installed or may be required by your package:
ja: パッケージの種類によっては、必要になるのはこれが全てかもしれません。ただ、すべてのパッケージのビルドに必須ではないにせよ、インストールしておくと便利だったり、パッケージによっては必要になったりするパッケージ群があります:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">autoconf</systemitem>, <systemitem role="package">automake</systemitem>, and <systemitem role="package">autotools-dev</systemitem> - many newer programs use configure scripts and <filename>Makefile</filename> files preprocessed with the help of programs like these (see <literal>info autoconf</literal>, <literal>info automake</literal>).  <systemitem role="package">autotools-dev</systemitem> keeps up-to-date versions of certain auto files and has documentation about the best way to use those files.
ja: <systemitem role="package">autoconf</systemitem> と <systemitem role="package">automake</systemitem> と <systemitem role="package">autotools-dev</systemitem> - 多くの新しいプログラムが、これらのプログラムを使って前処理される設定スクリプトや <filename>Makefile</filename> を利用しています。 (詳しくは <literal>info autoconf</literal>, <literal>info automake</literal> を参照)。 <systemitem role="package">autotools-dev</systemitem> には、特定の auto ファイルを最新版に保ち、 そのようなファイルを使う最善の方法についてのドキュメントが含まれています。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: There are also some more specialized but similar packages such as <systemitem role="package">dh-make-perl</systemitem>, <systemitem role="package">dh-make-php</systemitem>, etc.
ja: <systemitem role="package">dh-make-perl</systemitem>、<systemitem role="package">dh-make-php</systemitem>等のように、同様の内容で特化したパッケージもいくつかあります。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debhelper</systemitem> and <systemitem role="package">dh-make</systemitem> - <systemitem role="package">dh-make</systemitem> is necessary to create the skeleton of our example package, and it will use some of the <systemitem role="package">debhelper</systemitem> tools for creating packages.  They are not essential for this purpose, but are <emphasis>highly</emphasis> recommended for new maintainers.  It makes the whole process very much easier to start, and to control afterwards.  (See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.) <placeholder type="footnote" id="0"/>
ja: <systemitem role="package">debhelper</systemitem> と <systemitem role="package">dh-make</systemitem>  - <systemitem role="package">dh-make</systemitem> は例示に用いられたパッケージのひな型を用意するのに必要となり、またそれはパッケージの生成をするために <systemitem role="package">debhelper</systemitem> ツールをいくつか使います。これらを使わなくてもパッケージ作成は可能ですが、初めてパッケージを作る方には利用を<emphasis>強く</emphasis>お勧めします。こうすると、取り付きやすく、以後パッケージを管理するのもずっと簡単です。 (詳しくは <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>、<citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を参照。) <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The new <systemitem role="package">debmake</systemitem> may be used as the alternative to the standard <systemitem role="package">dh-make</systemitem>.  It does more and comes with HTML documentation with extensive packaging examples in <systemitem role="package">debmake-doc</systemitem>.
ja: 標準的な <systemitem role="package">dh-make</systemitem> の代わりに、新しい<systemitem role="package">debmake</systemitem> が使えます。機能が多く種々のパッケージング例が <systemitem role="package">debmake-doc</systemitem> 中の文書に含まれます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">devscripts</systemitem> - this package contains some useful scripts that can be helpful for maintainers, but they are also not necessary for building packages.  Packages recommended and suggested by this package are worth looking into.  (See <filename>&devscripts-readme;</filename>.)
ja: <systemitem role="package">devscripts</systemitem> - このパッケージはメンテナーにとって便利であると思われる有用で優れたスクリプトを含んでいますが、だからといってパッケージをビルドするために必須というわけではありません。このパッケージが推奨 (Recommends)、あるいは提案 (Suggests)  しているパッケージは、一見の価値があります。(詳しくは <filename>&devscripts-readme;</filename> を参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">fakeroot</systemitem> - this utility lets you emulate being root, which is necessary for some parts of the build process.  (See <citerefentry> <refentrytitle>fakeroot</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">fakeroot</systemitem> - このユーティリティを使うと、ビルドの過程で何度か必要となる root 権限をエミュレートすることができます。(詳しくは <citerefentry> <refentrytitle>fakeroot</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">file</systemitem> - this handy program can determine what type a file is.  (See <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">file</systemitem> - この便利なプログラムを使うと、そのファイルがどういう形式のものか判定することができます。(詳しくは <citerefentry> <refentrytitle>file</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gfortran</systemitem> - the GNU Fortran 95 compiler, necessary if your program is written in Fortran.  (See <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">gfortran</systemitem> - GNU Fortran 95 コンパイラ。あなたのプログラムが Fortran 言語で書かれている場合に必要です。(詳しくは <citerefentry> <refentrytitle>gfortran</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git</systemitem> - this package provides a popular version control system designed to handle very large projects with speed and efficiency; it is used for many high profile open source projects, most notably the Linux kernel.  (See <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, git Manual (<filename>&git-doc;</filename>).)
ja: <systemitem role="package">git</systemitem> - このパッケージは人気のあるバージョン管理システムで、大規模なプロジェクトを素早く、効率的に扱えるように設計されています。知名度の高い多数のオープンソースプロジェクトで使われており、特に有名なものとして Linux カーネルがあります。(詳しくは <citerefentry> <refentrytitle>git</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>、git Manual (<filename>&git-doc;</filename>) 参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gnupg</systemitem> - a tool that enables you to digitally <emphasis>sign</emphasis> packages.  This is especially important if you want to distribute packages to other people, and you will certainly be doing that when your work gets included in the Debian distribution.  (See <citerefentry> <refentrytitle>gpg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">gnupg</systemitem> - このツールを使うと、パッケージに「デジタル <emphasis>署名</emphasis>」を付けることができます。もしあなたが自分の作成したパッケージを他の人々に配布したいのなら、これは特に重要です。また、Debian ディストリビューションにあなたの作成したパッケージが含まれるようになった時には、確実にこのデジタル署名をすることになります。(詳しくは <citerefentry> <refentrytitle>gpg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gpc</systemitem> - the GNU Pascal compiler, necessary if your program is written in Pascal.  Worthy of note here is <systemitem role="package">fp-compiler</systemitem>, the Free Pascal Compiler, which is also good at this task.  (See <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">gpc</systemitem> - GNU Pascal コンパイラ。あなたのプログラムが Pascal 言語で書かれている場合に必要です。ここで注目に値するのは <systemitem role="package">fp-compiler</systemitem> Free Pascal コンパイラで、こちらもまたこの作業に適しています。(詳しくは <citerefentry> <refentrytitle>gpc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>、 <citerefentry> <refentrytitle>ppc386</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">lintian</systemitem> - this is the Debian package checker, which lets you know of any common mistakes after you build the package and explains the errors found.  (See <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <ulink url="&lintian-doc;">Lintian User's Manual</ulink>.)
ja: <systemitem role="package">lintian</systemitem> - これは Debian パッケージチェッカで、あなたがビルドしたパッケージを調べて、その中にありがちなミスが見つかったらそれを指摘し、その問題について説明してくれます。(詳しくは <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>、 <ulink url="&lintian-doc;">Lintian User's Manual</ulink> 参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patch</systemitem> - this very useful utility will take a file containing a difference listing (produced by the <command>diff</command> program) and apply it to the original file, producing a patched version.  (See <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">patch</systemitem> - このとても有用なユーティリティは、(<command>diff</command> プログラムによって生成された)  オリジナルとの差分が列挙されたファイルを読み込んでオリジナルのファイルに適用し、パッチが当てられたバージョンを作成します。 (詳しくは <citerefentry> <refentrytitle>patch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">patchutils</systemitem> - this package contains some utilities to work with patches such as the <command>lsdiff</command>, <command>interdiff</command> and <command>filterdiff</command> commands.
ja: <systemitem role="package">patchutils</systemitem> - このパッケージには、<command>lsdiff</command>、 <command>interdiff</command> や <command>filterdiff</command> といったパッチを扱うユーティリティが含まれています。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">pbuilder</systemitem> - this package contains programs which are used for creating and maintaining a <command>chroot</command> environment.  Building a Debian package in this <command>chroot</command> environment verifies the proper build dependency and avoids FTBFS (Fails To Build From Source) bugs.  (see <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> and <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)
ja: <systemitem role="package">pbuilder</systemitem> - このパッケージには <command>chroot</command> 環境の作成や保守に使用されるプログラムが含まれます。この <command>chroot</command> 環境下で Debian パッケージをビルドすることで適切なビルド依存を確認して FTBFS (Fails To Build From Source)  バグを回避することができます。(詳しくは <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> と <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 参照)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">perl</systemitem> - Perl is one of the most used interpreted scripting languages on today's Unix-like systems, often referred to as Unix's Swiss Army Chainsaw. (See <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">perl</systemitem> - Perl は今日の UNIX 系システムにおいてもっとも使われているインタープリタ型スクリプト言語のひとつで、その強力さはしばしば「Unix のスイス軍用チェーンソー」と形容されるほどです。(詳しくは <citerefentry> <refentrytitle>perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">python</systemitem> - Python is another of the most used interpreted scripting languages on the Debian system, combining remarkable power with very clear syntax. (See <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">python</systemitem> - Python は Debian システムにおいてもっとも使われているもう一つの インタープリタ型スクリプト言語で、並外れたパワーと非常に明快な書式を 兼ねそなえています。 (詳しくは <citerefentry> <refentrytitle>python</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">quilt</systemitem> - this package helps you to manage large numbers of patches by keeping track of the changes each patch makes. Patches can be applied, un-applied, refreshed, and more.  (See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum></citerefentry>, and <filename>&quilt-pdf;</filename>.)
ja: <systemitem role="package">quilt</systemitem> - このパッケージは、一連のパッチそれぞれの変更点を追跡して、その管理を補助するものです。パッチは簡単に当てたり、外したり、刷新したり色々することができます。(詳しくは <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>、 <filename>&quilt-pdf;</filename> 参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">xutils-dev</systemitem> - some programs, usually those made for X11, also use these programs to generate <filename>Makefile</filename> files from sets of macro functions.  (See <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.)
ja: <systemitem role="package">xutils-dev</systemitem> - ある種のプログラム (通常 X11のために開発されたもの)  は、これらのプログラムを利用して、マクロ関数の組み合わせから <filename>Makefile</filename> 群を生成します。(詳しくは <citerefentry> <refentrytitle>imake</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>、 <citerefentry> <refentrytitle>xmkmf</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 参照。)

note: type: Content of: <book><chapter><section><para>
en: The short descriptions that are given above only serve to introduce you to what each package does.  Before continuing please read the documentation of each relevant program including ones installed through the package dependency such as <command>make</command>, at least, for the standard usage.  It may seem like heavy going now, but later on you'll be <emphasis>very</emphasis> glad you read it.  If you have specific questions later, I would suggest re-reading the documents mentioned above.
ja: 上記の簡単な説明は、それぞれのパッケージが何をするのか紹介するだけのものです。先に進む前に<command>make</command>等のようにパッケージ依存関係でインストールされたプログラムを含むパッケージングに関連する各プログラムに付属の文書を読み、標準的な使い方だけでも理解しておいてください。いまはきついと思われるかも知れませんが、あとになればきっと <emphasis>読んでてよかったなあ</emphasis> と思うことでしょう。もし後日特定の疑問を持った場合は上記で触れた文書を読み返すことをお勧めします。

note: type: Content of: <book><chapter><section><title>
en: Documentation needed for development
ja: 開発に必要な文書

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>very important</emphasis> documentation which you should read along with this document:
ja: 以下は、この文書と合わせて読むべき<emphasis>とても重要な</emphasis>文書です:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">debian-policy</systemitem> - the <ulink url="&debian-policy;">Debian Policy Manual</ulink> includes explanations of the structure and contents of the Debian archive, several OS design issues, the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS, which says where each file and directory should be), etc.  For you, the most important thing is that it describes requirements that each package must satisfy to be included in the distribution. (See the local copies of <filename>&policy-pdf;</filename> and <filename>&fhs-pdf;</filename>.)
ja: <systemitem role="package">debian-policy</systemitem> - <ulink url="&debian-policy;">Debian Policy Manual</ulink> (Debian ポリシーマニュアル)は、Debian アーカイブの構造と内容、OS の設計に関するいくつかの案件、<ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS、個々のファイルやディレクトリーがどこにあるべきかを規定した文書)  が含まれています。さしあたって重要なのは、ディストリビューションに含まれるためにそれぞれのパッケージが満たすべき必要条件の説明です (ローカルコピーの<ulink url="&policy-pdf;">policy.pdf</ulink> と <filename>&fhs-pdf;</filename> を参照。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">developers-reference</systemitem> - the <ulink url="&developers-reference;">Debian Developer's Reference</ulink> describes all matters not specifically about the technical details of packaging, like the structure of the archive, how to rename, orphan, or adopt packages, how to do NMUs, how to manage bugs, best packaging practices, when and where to upload, etc.  (See the local copy of <filename>&developers-refpdf;</filename>.)
ja: <systemitem role="package">developers-reference</systemitem> - <ulink url="&developers-reference;">Debian Developer's Reference</ulink> (Debian デベロッパーリファレンス)には、例えばアーカイブの構造、パッケージ名の変更方法、パッケージの選び方、メンテナーを降りるにはどうしたらよいか、どうやって NMU をするか、バグとのつき合い方、パッケージ作成のベストプラクティス、いつどこにアップロードすればよいかなどなど、特に技術的な事柄以外のパッケージ化についてのありとあらゆる情報がここにあります。(ローカルコピーの <filename>&developers-refpdf;</filename> を参照。)

note: type: Content of: <book><chapter><section><para>
en: The following is the <emphasis>important</emphasis> documentation which you should read along with this document:
ja: 以下は、この文書と合わせて読むべき<emphasis>とても重要な</emphasis>文書です:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> provides a very good tutorial for <ulink url="&gnu-build-system;">the GNU Build System known as the GNU Autotools</ulink>, whose most important components are Autoconf, Automake, Libtool, and gettext.
ja: <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> は、Autoconf、Automake、Libtool や gettext を最も重要な構成要素としてもつ <ulink url="&gnu-build-system;">GNU Autotools として知られる GNU ビルドシステム</ulink> の非常に好適な入門書です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">gnu-standards</systemitem> - this package contains two pieces of documentation from the GNU project: <ulink url="&gnu-standard;">GNU Coding Standards</ulink>, and <ulink url="&gnu-maintainer;">Information for Maintainers of GNU Software</ulink>.  Although Debian does not require these to be followed, these are still helpful as guidelines and common sense.  (See the local copies of <filename>&gnu-standard-pdf;</filename> and <filename>&gnu-maintainer-pdf;</filename>.)
ja: <systemitem role="package">gnu-standards</systemitem> - このパッケージには、GNU プロジェクトからの文書が 2 つ含まれています。<ulink url="&gnu-standard;">GNU コーディング標準</ulink>と、<ulink url="&gnu-maintainer;">GNU ソフトウェアのメンテナー向け情報</ulink>です。Debian ではこれらに従うことは求められませんが、ガイドラインまたは常識としても有用です(ローカルコピーの <filename>&gnu-standard-pdf;</filename> と <filename>&gnu-maintainer-pdf;</filename> を参照。)

note: type: Content of: <book><chapter><section><para>
en: If this document contradicts any of the documents mentioned above, they are correct.  Please file a bug report on the <systemitem role="package">maint-guide</systemitem> package using <command>reportbug</command>.
ja: この文書が、上記文書の記述と矛盾している場合は、そちらが正解です。<command>reportbug</command> を使って<systemitem role="package">maint-guide</systemitem> パッケージにバグレポートをしてください。

note: type: Content of: <book><chapter><section><para>
en: The following is an alternative tutorial document that you may read along with this document:
ja: 以下は、この文書と合わせて読める同様の入門書です:

note: type: Content of: <book><chapter><section><title>
en: Where to ask for help
ja: 相談するには

note: type: Content of: <book><chapter><section><para>
en: Before you decide to ask your question in some public place, please read this fine documentation:
ja: 公開の場で質問をすると決心する前に、以下に示す良くできた文書を読みましょう:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: files in <filename>/usr/share/doc/<replaceable>package</replaceable></filename> for all pertinent packages
ja: 全ての関与するパッケージの <filename>/usr/share/doc/<replaceable>package</replaceable></filename> 中のファイル

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>man</command> <replaceable>command</replaceable></literal> for all pertinent commands
ja: 全ての関与するコマンドの <literal><command>man</command> <replaceable>command</replaceable></literal> の内容

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <literal><command>info</command> <replaceable>command</replaceable></literal> for all pertinent commands
ja: 全ての関与するコマンドの <literal><command>info</command> <replaceable>command</replaceable></literal> の内容

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list archive</ulink>
ja: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org メーリングリストのアーカイブ</ulink> の内容

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: contents of <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list archive</ulink>
ja: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org メーリングリストのアーカイブ</ulink> の内容

note: type: Content of: <book><chapter><section><para>
en: You can use web search engines more effectively by including search strings such as <literal>site:lists.debian.org</literal> to limit the domain.
ja: <literal>site:lists.debian.org</literal> のような検索文字列を含めてドメインを制約するようなことでウェブ検索エンジンをより効率的に利用することを考えましょう。

note: type: Content of: <book><chapter><section><para>
en: Making a small test package is a good way to learn details of packaging.  Inspecting existing well maintained packages is the best way to learn how other people make packages.
ja: 小さなテストパッケージを作ることは、パッケージ作成の詳細を学ぶよい方法です。他の人がどのようにパッケージを作成しているか学ぶには、既存のよく保守されているパッケージを調べるのが一番です。

note: type: Content of: <book><chapter><section><para>
en: If you still have questions about packaging that you couldn't find answers to in the available documentation and web resources, you can ask them interactively:
ja: 入手可能な文書やウェブのリソースからは答えを見つけられない疑問が残った場合には、インタラクティブに疑問を聞く事が出来ます:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org mailing list</ulink>. (This mailing list is for the novice.)
ja: <ulink url="&debian-mentors-ldo;">debian-mentors@lists.debian.org メーリングリスト</ulink>。 (初心者向けメーリングリストです。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org mailing list</ulink>. (This mailing list is for the expert.)
ja: <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org メーリングリスト</ulink>。 (上級者向けメーリングリストです。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <ulink url="&irc-debian;">IRC</ulink> such as <literal>#debian-mentors</literal>.
ja: <literal>#debian-mentors</literal> の様な <ulink url="&irc-debian;">IRC</ulink>。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Teams focusing on a specific set of packages. (Full list at <ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>)
ja: 特定群のパッケージにフォーカスしたチーム (全リストは<ulink url="&wikiteams;">https://wiki.debian.org/Teams</ulink>を参照下さい)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Language-specific mailing lists such as debian-devel-{french,italian,portuguese,spanish}@lists.debian.org or debian-devel@debian.or.jp. (Full listing at <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> and <ulink url="&listusers;">https://lists.debian.org/users.html</ulink>)
ja: debian-devel-{french,italian,portuguese,spanish}@lists.debian.org や debian-devel@debian.or.jp 等の特定言語のメーリングリスト(全リストは <ulink url="&listdevel;">https://lists.debian.org/devel.html</ulink> と <ulink url="&listusers;">https://lists.debian.org/users.html</ulink> を参照下さい)

note: type: Content of: <book><chapter><section><para>
en: The more experienced Debian developers will gladly help you, if you ask properly after making your required efforts.
ja: あなたがするべき努力をした後に適切に質問すれば、より経験を持った Debian デベロッパーは喜んで助けてくれるでしょう。

note: type: Content of: <book><chapter><section><para>
en: When you receive a bug report (yes, actual bug reports!), you will know that it is time for you to dig into the <ulink url="&bts;">Debian Bug Tracking System</ulink> and read the documentation there, to be able to deal with the reports efficiently.  I highly recommend reading the <ulink url="&devref-bug-handling;">Debian Developer's Reference, 5.8.  "Handling bugs"</ulink>.
ja: バグレポート (そう、本物のバグレポートです！)  を受けとったら、レポートを効率的に処理するために、<ulink url="&bts;">Debian バグ追跡システム</ulink> に入り込み、その説明文書を読む時だということがわかるでしょう。<ulink url="&devref-bug-handling;">Debian デベロッパーリファレンスの 5.8.  'Handling bugs'</ulink> を読むよう、強くおすすめします。

note: type: Content of: <book><chapter><section><para>
en: Even if it all worked well, it's time to start praying.  Why? Because in just a few hours (or days) users from all around the world will start to use your package, and if you made some critical error you'll get mailbombed by numerous angry Debian users&#x2026; Just kidding.  :-)
ja: すべてうまくやったとしても、これからはお祈りの時間です。なぜか？ それは、ほんの数時間 (あるいは数日)  で、世界中のユーザーがそのパッケージを使いはじめるからです。もし何か致命的なエラーをやらかしていたら、膨大な数の怒った Debian ユーザーからメール爆弾を受けとることになります……なんて冗談ですが :-)

note: type: Content of: <book><chapter><section><para>
en: Relax and be ready for bug reports, because there is a lot more work to be done before your package will be fully in line with Debian policies and its best practice guidelines (once again, read the <emphasis>real documentation</emphasis> for details).  Good luck!
ja: リラックスしてバグ報告に備えてください。なにしろ、そのパッケージが Debian ポリシーやそのベストプラクティスに完全に沿うようになるまでには、やらなくてはいけないことは沢山あるのですから (繰り返しますが、詳細は<emphasis>正式の文書</emphasis>を読んでください)。頑張ってください！

note: type: Content of: <book><chapter><title>
en: First steps
ja: はじめの一歩

note: type: Content of: <book><chapter><para>
en: Let's start by creating a package of your own (or, even better, adopting an existing one).
ja: (できれば既存パッケージを引き取り) 自分のパッケージを作成しましょう。

note: type: Content of: <book><chapter><section><title>
en: Debian package building workflow
ja: Debian パッケージビルドのワークフロー

note: type: Content of: <book><chapter><section><para>
en: If you are making a Debian package with an upstream program, the typical workflow of Debian package building involves generating several specifically named files for each step as follows:
ja: アップストリームのプログラムを使って Debian パッケージを作成する場合、Debian パッケージビルドは以下の各ステップでいくつかの特定の命名をされたファイルを生成することからなります:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Get a copy of the upstream software, usually in a compressed tar format.
ja: 通常圧縮された tar フォーマットのアップストリームソフトウェアのコピーを入手します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add Debian-specific packaging modifications to the upstream program under the <filename>debian</filename> directory, and create a non-native source package (that is, the set of input files used for Debian package building) in <literal>3.0 (quilt)</literal> format.
ja: <filename>debian</filename> ディレクトリー下へ Debian 固有のパッケージ用の変更をアップストリームプログラムへ追加し、<literal>3.0 (quilt)</literal> フォーマットでノンネイティブのソースパッケージを作成します。(ソースパッケージとは、Debian パッケージビルドのために用いる入力ファイルセットのこと。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><footnote><para>
en: For the older style of non-native Debian source packages in <literal>1.0</literal> format, <literal><replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.diff.gz</literal> is used instead.
ja: <literal>1.0</literal> フォーマットの古いノンネイティブの Debian パッケージに関しては、上記の代わりに <literal><replaceable>package</replaceable>_<replaceable>version</replaceable>-<replaceable>revision</replaceable>.diff.gz</literal> が使われます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Build Debian binary packages, which are ordinary installable package files in <literal>.deb</literal> format (or <literal>.udeb</literal> format, used by the Debian Installer) from the Debian source package.
ja: Debian ソースパッケージから <literal>.deb</literal> フォーマット (または Debian のインストーラーが使う <literal>.udeb</literal> フォーマット)で提供される通常のインストール可能な Debian のバイナリーパッケージをビルドします。

note: type: Content of: <book><chapter><section><para>
en: Please note that the character separating <literal><replaceable>package</replaceable></literal> and <literal><replaceable>version</replaceable></literal> was changed from <literal>-</literal> (hyphen) in the tarball name to <literal>_</literal> (underscore) in the Debian package filenames.
ja: <literal><replaceable>package</replaceable></literal> と <literal><replaceable>version</replaceable></literal> の間の文字が tar アーカイブの名前の <literal>-</literal> (ハイフン)が Debian パッケージファイルの名前では <literal>_</literal> (下線)に変更されていることに注目して下さい。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink>, and <ulink url="&policy-version;">5.6.12 "Version"</ulink>.  The <emphasis role="strong">package architecture</emphasis> follows the <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> and is automatically assigned by the package build process.
ja: <ulink url="&policy-source;">5.6.1 "Source"</ulink>, <ulink url="&policy-package;">5.6.7 "Package"</ulink>, and <ulink url="&policy-version;">5.6.12 "Version"</ulink> を参照下さい。<emphasis role="strong">パッケージアーキテクチャー</emphasis> は <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> に従い、パッケージビルドプロセスにより自動的に付与されます。

note: type: Content of: <book><chapter><section><para>
en: In the file names above, replace the <literal><replaceable>package</replaceable></literal> part with the <emphasis role="strong">package name</emphasis>, the <literal><replaceable>version</replaceable></literal> part with the <emphasis role="strong">upstream version</emphasis>, the <literal><replaceable>revision</replaceable></literal> part with the <emphasis role="strong">Debian revision</emphasis>, and the <literal><replaceable>arch</replaceable></literal> part with the <emphasis role="strong">package architecture</emphasis>, as defined in the Debian Policy Manual.  <placeholder type="footnote" id="0"/>
ja: Debian Policy Manual に従い、上記のファイル名中の、<literal><replaceable>package</replaceable></literal> 部分は<emphasis role="strong">パッケージ名</emphasis>に置き換え、<literal><replaceable>version</replaceable></literal> 部分は<emphasis role="strong">アップストリームバージョン</emphasis>に置き換え、<literal><replaceable>revision</replaceable></literal> 部分は <emphasis role="strong">Debian リビジョン</emphasis>に置き換え、<literal><replaceable>arch</replaceable></literal> 部分は<emphasis role="strong">パッケージアーキテクチャー</emphasis>に置き換えます。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Each step of this outline is explained with detailed examples in later sections.
ja: 以下で、このアウトラインの各ステップは後述のセクションで詳細に説明します。

note: type: Content of: <book><chapter><section><title>
en: Choose your program
ja: プログラムの選定

note: type: Content of: <book><chapter><section><para>
en: You have probably chosen the package you want to create.  The first thing you need to do is check if the package is in the distribution archive already by using the following:
ja: おそらく、作成したいパッケージを選んだことと思います。まず最初にしなければならないことは、ディストリビューションのアーカイブにそのパッケージがすでにあるかどうかを以下を使って確認することです:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <command>aptitude</command> command
ja: <command>aptitude</command> コマンド

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&packages-do;">Debian packages</ulink> web page
ja: <ulink url="&packages-do;">Debian パッケージ</ulink> ウェブページ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <ulink url="&debtrack;">Debian Package Tracker</ulink> web page
ja: <ulink url="&debtrack;">Debian Package Tracker</ulink> ウェブページ

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-adopt;">Debian Developer's Reference 5.9.5 "Adopting a package"</ulink>.
ja: <ulink url="&devref-adopt;">Debian Developer's Reference 5.9.5 "Adopting a package"</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: If the package already exists, well, install it! :-) If it happens to be <emphasis role="strong">orphaned</emphasis> (that is, if its maintainer is set to <ulink url="&qa-do;">Debian QA Group</ulink>), you may be able to pick it up if it's still available.  You may also adopt a package whose maintainer has filed a Request for Adoption (<emphasis role="strong">RFA</emphasis>).<placeholder type="footnote" id="0"/>
ja: もしパッケージが既に存在していたら、インストールしましょう! :-) もしそのパッケージが<emphasis role="strong">みなし子</emphasis>状態 (メンテナーが <ulink url="&qa-do;">Debian QA Group</ulink> に設定されていること)なら、そのパッケージを他人にとられていなければ、そのパッケージを引き取ることができるかもしれません。パッケージのメンテナーが引き取り依頼 (<emphasis role="strong">RFA</emphasis>)  を出しているパッケージも引きとれます。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: There are several package ownership status resources:
ja: パッケージの所有状態の情報源がいくつかあります:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <command>wnpp-alert</command> command from the <systemitem role="package">devscripts</systemitem> package
ja: <systemitem role="package">devscripts</systemitem> パッケージ中にある <command>wnpp-alert</command> コマンド

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Having said that, there will of course always be new programs that are worth packaging.
ja: とはいっても、パッケージ化する価値のある新しいプログラムはいつだって存在するでしょう。

note: type: Content of: <book><chapter><section><para>
en: As a side note, it's important to point out that Debian already has packages for most kinds of programs, and the number of packages already in the Debian archive is much larger than that of contributors with upload rights.  Thus, contributions to packages already in the archive are far more appreciated (and more likely to receive sponsorship) by other developers <placeholder type="footnote" id="0"/>.  You can contribute in various ways:
ja: 注釈ですが、Debian にはすでにほとんどの種類のプログラムが含まれていることと、Debian アーカイブにすでに含まれているパッケージの数はアップロード権限をもつユーザーの数よりもはるかに多いことに注意しておくのは重要です。従って、すでにアーカイブに含まれているパッケージへの作業は、他のデベロッパーからはるかに喜ばれ (よりスポンサーしてもらえる見込みがあり)ます<placeholder type="footnote" id="0"/>。貢献の仕方はいろいろあります:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: taking over orphaned, yet actively used, packages
ja: まだよく使われている、みなしごのパッケージを引き取る

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: joining <ulink url="&teams;">packaging teams</ulink>
ja: <ulink url="&teams;">パッケージ化チーム</ulink>に参加する

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: triaging bugs of very popular packages
ja: よく使われているパッケージのバグに対処する

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: preparing <ulink url="&devref-nmu;">QA or NMU uploads</ulink>
ja: <ulink url="&devref-nmu;">QA もしくは NMU アップロード</ulink> を準備する

note: type: Content of: <book><chapter><section><para>
en: If you are able to adopt the package, get the sources (with something like <literal>apt-get source <replaceable>packagename</replaceable></literal>) and examine them.  This document unfortunately doesn't include comprehensive information about adopting packages.  Thankfully you shouldn't have a hard time figuring out how the package works since someone has already done the initial setup for you.  Keep reading, though; a lot of the advice below will still be applicable to your case.
ja: もしパッケージを引き取ることができるなら、(<literal>apt-get source <replaceable>packagename</replaceable></literal> などの方法で)  ソースを入手して、調べてみてください。残念ながらこの文書では、パッケージを引き取ることについて、わかりやすく説明してはいません。ありがたいことに、既に誰かがあなたのためにパッケージを準備してくれたわけですから、そのパッケージがどのように動作するのか理解することは、それほど難しくはないでしょう。とはいえ、そうした場合でもこの文書に書かれた多くのアドバイスはそのまま通用しますから、このまま読み進めていってください。

note: type: Content of: <book><chapter><section><para>
en: If the package is new, and you decide you'd like to see it in Debian, proceed as follows:
ja: もしあなたの選んだプログラムがまだパッケージ化されていないもので、それを Debian に入れたいと決めたなら、以下のチェック項目について確認してください:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: First, you must know that the program works, and have tried it for some time to confirm its usefulness.
ja: まず、そのプログラムが機能することを理解し、ある程度の期間使用してその有用性について確認するべきです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: You must check that no one else is already working on the package on the <ulink url="&wnpp-do;">Work-Needing and Prospective Packages</ulink> site.  If no one else is working on it, file an ITP (Intent To Package) bug report to the <systemitem role="package">wnpp</systemitem> pseudo-package using <command>reportbug</command>.  If someone's already on it, contact them if you feel you need to.  If not &#x2014; find another interesting program that nobody is maintaining.
ja: <ulink url="&wnpp-do;">作業中のパッケージ</ulink>サイトを確認し、他の誰も同じパッケージに関して作業していないことを確かめてください。誰も作業していなければ、<command>reportbug</command> を使って ITP (Intent To Package) のバグレポートを、<systemitem role="package">wnpp</systemitem> 疑似パッケージに送ってください。もし既に誰かが作業していたら、連絡を取りたいならそうしてください。もしその気が無いなら、まだ誰も手をつけていない他の面白いプログラムを探しましょう。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The software <emphasis role="strong">must have a license</emphasis>.
ja: プログラムには、<emphasis role="strong">ライセンスが必須</emphasis>です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>main</literal> section, Debian Policy requires it <emphasis role="strong">to be fully compliant with the Debian Free Software Guidelines</emphasis> (<ulink url="&dfsg;">DFSG</ulink>)  and <emphasis role="strong">not to require a package outside of <literal>main</literal></emphasis> for compilation or execution.  This is the desired case.
ja: <literal>main</literal> セクションは、Debian ポリシーにより <emphasis role="strong">Debian フリーソフトウェアガイドライン</emphasis> (<ulink url="&dfsg;">DFSG</ulink>) に完全に準拠しなければなりませんし 、またコンパイル・実行時に <emphasis role="strong"><literal>main</literal> 以外のパッケージに依存してはなりません</emphasis>。これが望ましいケースです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>contrib</literal> section, it must comply with the DFSG but it may require a package outside of <literal>main</literal> for compilation or execution.
ja: <literal>contrib</literal> セクションは、DFSG に完全に準拠していなければなりませんが、コンパイル・実行時に <literal>main</literal> にあるもの以外のパッケージに依存していても構いません。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: For the <literal>non-free</literal> section, it may be non-compliant with the DFSG but it <emphasis role="strong">must be distributable</emphasis>.
ja: <literal>non-free</literal> セクションは、DFSG に準拠していない部分があるかもしれませんが、<emphasis role="strong">配布可能でなければなりません</emphasis>。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If you are unsure about where it should go, post the license text on <ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> and ask for advice.
ja: どうするべきかよくわからなければ、<ulink url="&debian-legal-ldo;">debian-legal@lists.debian.org</ulink> にライセンス文を送り、アドバイスを求めてください。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The program should <emphasis role="strong">not</emphasis> introduce security and maintenance concerns into the Debian system.
ja: プログラムは、Debian システムにセキュリティーやメンテナンス上の懸念を招いては<emphasis role="strong">いけません</emphasis>。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should be well documented and its code needs to be understandable (i.e., not obfuscated).
ja: ちゃんとした説明書きのあるプログラムで、ソースコードが理解可能なもの (つまり、難読化されていないこと)。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: You should contact the program's author(s) to check if they agree with packaging it and are amicable to Debian.  It is important to be able to consult with the author(s)  in case of any problems with the program, so don't try to package unmaintained software.
ja: プログラムの作者に連絡をとって、パッケージ化の承諾と Debian に友好的かどうかを確認しておきましょう。何かプログラムそのものに起因する問題が発生した際に、作者にいろいろ聞けるということは重要なので、メンテナンスされていないソフトウェアをパッケージ化するのはやめておきましょう。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program certainly should <emphasis role="strong">not</emphasis> run setuid root, or even better, it shouldn't need to be setuid or setgid to anything.
ja: プログラムは root に setuid で実行されるべきでは<emphasis role="strong">ありません</emphasis>。もっと言えば、どのユーザーへの setuid や setgid もするべきではありません。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The program should not be a daemon, or go in an <filename>*/sbin</filename> directory, or open a port as root.
ja: デーモンとして動作するプログラムや、<filename>*/sbin</filename> ディレクトリーに配置するプログラム、また root 特権を使ってポートを開くプログラムで無いほうが良いでしょう。

note: type: Content of: <book><chapter><section><para>
en: Of course, the last one is just a safety measure, and is intended to save you from enraging users if you do something wrong in some setuid daemon&#x2026; When you gain more experience in packaging, you'll be able to package such software.
ja: もちろんこの最後の件は単なる安全策で、setuid デーモン等で何かミスして怒り狂ったユーザーから抗議殺到という事態を招くことを回避するためです。パッケージ化についてもっと経験を積めば、こうしたパッケージも作れるようになるでしょう。

note: type: Content of: <book><chapter><section><para>
en: As a new maintainer, you are encouraged to get some experience in packaging with easier packages and discouraged from creating complicated packages.
ja: 新規メンテナーであるあなたには、比較的簡単なパッケージで経験を積むことをお勧めし、複雑なパッケージを作成することお勧めはできません。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Simple packages
ja: 単純なパッケージ、

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (collection of data such as wallpaper graphics)
ja: 単一のバイナリーパッケージ、arch = all (壁紙グラフィクスのようなデータのコレクション)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = all (executables written in an interpreted language such as POSIX shell)
ja: 単一のバイナリーパッケージ、arch = all (POSIX のようなインタープリタ言語で書かれた実行可能プログラム)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Intermediate complexity packages
ja: ほどほど複雑なパッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: single binary package, arch = any (ELF binary executables compiled from languages such as C and C++)
ja: 単一のバイナリーパッケージ、arch = all (C や C++ のような言語からコンパイルされた ELF バイナリーの実行可能プログラム)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages, arch = any + all (packages for ELF binary executables + documentation)
ja: 複数のバイナリーパッケージ、arch = all + any (ELF バイナリーの実行可能プログラム + 文書のパッケージ)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source in a format other than <filename>tar.gz</filename> or <filename>tar.bz2</filename>
ja: ソースファイルの形式が、<filename>tar.gz.</filename> や <filename>tar.bz2</filename> でないもの

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: upstream source containing undistributable contents
ja: 配布できない内容が含まれるアップストリームソース

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: High complexity packages
ja: 高度に複雑なパッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: interpreter module package used by other packages
ja: 他のパッケージにより利用される、インタープリタのモジュールパッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: generic ELF library package used by other packages
ja: 他のパッケージにより利用される汎用 ELF ライブラリーパッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: multiple binary packages including an ELF library package
ja: ELF ライブラリーパッケージを含む複数バイナリーパッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: source package with multiple upstream sources
ja: 複数のアップストリームソースからなるソースパッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel module packages
ja: カーネルモジュールパッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: kernel patch packages
ja: カーネルパッチパッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: any package with non-trivial maintainer scripts
ja: 非自明なメンテナースクリプトを含むあらゆるパッケージ

note: type: Content of: <book><chapter><section><para>
en: Packaging high complexity packages is not too hard, but it requires a bit more knowledge. You should seek specific guidance for every complex feature. For example, some languages have their own sub-policy documents:
ja: 高度に複雑なパッケージをパッケージすることはそれほど難しいことではありませんが、少々知識が必要です。それぞれの複雑な特徴には固有のガイダンスを探すべきです。例えば、いくつかの言語にはそれぞれのサブポリシー文書があります:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Do not worry about the missing <filename>Makefile</filename>.  You can install the <command>hello</command> command by simply using <command>debhelper</command> as in <xref linkend="install"/>, or by modifying the upstream source to add a new <filename>Makefile</filename> with the <literal>install</literal> target as in <xref linkend="modify"/>.
ja: <filename>Makefile</filename>がないことを心配しないで下さい。<command>hello</command> コマンドは <xref linkend="install"/> にあるようにして <command>debhelper</command> を単純に使用したり、<xref linkend="modify"/> にあるようにして <literal>install</literal> ターゲットがある新規の <filename>Makefile</filename> をアップストリームソースに追加してインストールできます。

note: type: Content of: <book><chapter><section><para>
en: There is another old Latin saying: <emphasis>fabricando fit faber</emphasis> (practice makes perfect).  It is <emphasis>highly</emphasis> recommended to practice and experiment with all the steps of Debian packaging with simple packages while reading this tutorial.  A trivial upstream tarball, <filename>hello-sh-1.0.tar.gz</filename>, created as follows may offer a good starting point:<placeholder type="footnote" id="0"/>
ja: もう一つの古いラテンの諺にもあるように、<emphasis>fabricando fit faber</emphasis> (習うより慣れろ)です。本入門書を読みながら単純なパッケージを用いて Debian パッケージングの全ステップを練習したり色々試したりすることを<emphasis>非常に</emphasis>推薦します。以下のようにして作った <filename>hello-sh-1.0.tar.gz</filename> という他愛ないアップストリームは良好なスタートポイントとなるでしょう。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Get the program, and try it out
ja: プログラムの入手と検証

note: type: Content of: <book><chapter><section><para>
en: So the first thing to do is to find and download the original source code.  Presumably you already have the source file that you picked up at the author's homepage.  Sources for free Unix programs usually come in <command>tar</command>+<command>gzip</command> format with the extension <filename>.tar.gz</filename>, <command>tar</command>+<command>bzip2</command> format with the extension <filename>.tar.bz2</filename>, or <command>tar</command>+<command>xz</command> format with the extension <filename>.tar.xz</filename>.  These usually contain a directory called <filename><replaceable>package</replaceable>-<replaceable>version</replaceable></filename> with all the sources inside.
ja: さて、最初にすべきことは、オリジナルのソースコードを探してダウンロードすることです。ここでは作者のホームページから、すでにソースファイルを入手したとして話を進めます。フリーな Unix 用プログラムのソースは、ふつう <filename>.tar.gz</filename> 拡張子が付いた <command>tar</command>+<command>gzip</command> フォーマットや、<filename>.tar.bz2</filename> 拡張子が付いた <command>tar</command>+<command>bzip2</command> フォーマットで提供されています。この中にはたいてい、すべてのソースが入った <filename><replaceable>package</replaceable>-<replaceable>version</replaceable></filename> というディレクトリーがあります。

note: type: Content of: <book><chapter><section><para>
en: If the latest version of the source is available through a Version Control System (VCS) such as Git, Subversion, or CVS, you need to get it with <literal>git clone</literal>, <literal>svn co</literal>, or <literal>cvs co</literal> and repack it into <command>tar</command>+<command>gzip</command> format yourself by using the <literal>--exclude-vcs</literal> option.
ja: 該当ソースの最新版が Git や Subversion、CVS リポジトリのような VCS で提供されているなら、<literal>git clone</literal>、<literal>svn co</literal> や <literal>cvs co</literal> としてソースを取得してから、<literal>--exclude-vcs</literal> オプションを使って自分で <command>tar</command>+<command>gzip</command> フォーマットに再パックする必要があります。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can identify the archive format using the <command>file</command> command when the file extension is not enough.
ja: ファイルの拡張子で足りなければ、<command>file</command> コマンドを使ってアーカイブ形式を判別することができます。

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes as some other sort of archive (for instance, the filename ends in <filename>.Z</filename> or <filename>.zip</filename><placeholder type="footnote" id="0"/>), you should also unpack it with the appropriate tools and repack it.
ja: プログラムのソースが、他の種類のアーカイブ (例えば、<filename>.Z</filename>で終わるファイル名や、<filename>.zip</filename><placeholder type="footnote" id="0"/>) の場合は、適切なツールでアンパックしてから再パックしてください。

note: type: Content of: <book><chapter><section><para>
en: If your program's source comes with some contents which do not comply with DFSG, you should also unpack it to remove such contents and repack it with a modified upstream version containing <literal>dfsg</literal>.
ja: DFSGに準拠しない内容とともにあなたのプログラムのソースが提供されている場合、それをアンパックし、そのような内容を削除し、<literal>dfsg</literal> を含むアップストリームバージョンに変更してリパックしましょう。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This program is already packaged. The <ulink url="&gentoo-package;">current version</ulink> uses Autotools as its build structure and is substantially different from the following examples, which were based on version 0.9.12.
ja: このプログラムはすでにパッケージ化されています。 その<ulink url="&gentoo-package;">最新のバージョン</ulink>は Autotools をそのビルド構造としており、バージョン 0.9.12 に基づく以下の例から大きく異なります。

note: type: Content of: <book><chapter><section><para>
en: As an example, I'll use a program called <command>gentoo</command>, a GTK+ file manager.  <placeholder type="footnote" id="0"/>
ja: さて、<command>gentoo</command> という X GTK+ ファイルマネージャを例に使い説明します。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Create a subdirectory under your home directory named <filename>debian</filename> or <filename>deb</filename> or anything you find appropriate (e.g.  just <filename>~/gentoo</filename> would do fine in this case).  Place the downloaded archive in it, and extract it (with <literal>tar xzf gentoo-0.9.12.tar.gz</literal>).  Make sure there are no warning messages, even <emphasis>irrelevant</emphasis> ones, because other people's unpacking tools may or may not ignore these anomalies, so they may have problems unpacking them.  Your shell command line may look something like this:
ja: 自分のホームディレクトリー以下に <filename>debian</filename> や <filename>deb</filename>、または何か適当な名前のサブディレクトリーを作りましょう (今回の場合には <filename>~/gentoo/</filename> としても良いでしょう)。ダウンロードしたアーカイブをここにコピーし、<literal>tar xzf gentoo-0.9.12.tar.gz</literal> を実行して展開してください。この時、一見<emphasis>無関係</emphasis>に思えるようなものも含めて、警告メッセージが一切発生しないことを確認してください。アンパックする際に問題に出会わないように、他の人々のシステム上で展開する際に、彼らが使っているツールがこの様な異常を無視したりしなかったりするので、警告メッセージがなくなるように確実にしましょう。あなたのシェルのコマンドラインは、以下のように見えているでしょうか:

note: type: Content of: <book><chapter><section><para>
en: Now you have another subdirectory, called <filename>gentoo-0.9.12</filename>.  Change to that directory and <emphasis>thoroughly</emphasis> read the provided documentation.  Usually there are files named <filename>README*</filename>, <filename>INSTALL*</filename>, <filename>*.lsm</filename> or <filename>*.html</filename>.  You must find instructions on how to compile and install the program (most probably they'll assume you want to install to the <filename>/usr/local/bin</filename> directory; you won't be doing that, but more on that later in <xref linkend="destdir"/>).
ja: さて、<filename>gentoo-0.9.12</filename> という別のサブディレクトリーができました。そのディレクトリーに移動し、提供されているドキュメントを<emphasis>徹底的に</emphasis>読みましょう。通常は <filename>README*</filename> や <filename>INSTALL*</filename> や <filename>*.lsm</filename> や <filename>*.html</filename> といった名前のファイルがあります。それらの文書の中に、どうやったら正しくコンパイルできるのか、どうインストールすればよいのかといった情報が見つかるはずです (おそらく <filename>/usr/local/bin</filename> にインストールするものとして説明されていますが、そうはしません。これについては <xref linkend="destdir"/> を参照してください)。

note: type: Content of: <book><chapter><section><para>
en: You should start packaging with a completely clean (pristine) source directory, or simply with freshly unpacked sources.
ja: パッケージ化の作業は完全にクリーンな (オリジナルのままの)  ソースディレクトリー、簡単に言えば新しく展開したソースから始めるべきです。

note: type: Content of: <book><chapter><section><title>
en: Simple build systems
ja: 単純なビルドシステム

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Many modern programs come with a script named <filename>configure</filename>, which when executed creates a <filename>Makefile</filename> customized for your system.
ja: 多くの現代的なプログラムには 実行するとあなたのシステム用にカスタム化した <filename>Makefile</filename> ファイルを作成する <filename>configure</filename> スクリプトが同梱されています。

note: type: Content of: <book><chapter><section><para>
en: Simple programs usually come with a <filename>Makefile</filename> and can be compiled just by invoking <literal>make</literal>.<placeholder type="footnote" id="0"/> Some of them support <literal>make check</literal>, which runs included self-tests.  Installation to the destination directories is usually done with <literal>make install</literal>.
ja: 単純なプログラムは普通 <filename>Makefile</filename> ファイルが付属していて、単純に <literal>make</literal> でコンパイルできます。<placeholder type="footnote" id="0"/> それらの中には同梱のセルフテストを実行する <literal>make check</literal> をサポートするプログラムもあります。インストール先ディレクトリーへのインストールは一般に <literal>make install</literal> によって実行されます。

note: type: Content of: <book><chapter><section><para>
en: Now try to compile and run your program, to make sure it works properly and doesn't break something else while it's installing or running.
ja: さあ、試しにプログラムをコンパイルし、実行してみましょう。 インストールや実行の際にちゃんと動作するかどうか、そして他の何かを壊してしまっていないかを確認してください。

note: type: Content of: <book><chapter><section><para>
en: Also, you can usually run <literal>make clean</literal> (or better <literal>make distclean</literal>) to clean up the build directory.  Sometimes there's even a <literal>make uninstall</literal> which can be used to remove all the installed files.
ja: それから、たいていの場合は <literal>make clean</literal> ( <literal>make distclean</literal> を使えるならそのほうが良いです)  を実行すると、ビルド用のディレクトリーをきれいにしてくれます。さらに <literal>make uninstall</literal> を実行すると、インストールされたファイルをすべて削除できることさえもあります。

note: type: Content of: <book><chapter><section><title>
en: Popular portable build systems
ja: ポピュラーなポータブルなビルドシステム

note: type: Content of: <book><chapter><section><para>
en: A lot of free software programs are written in the <ulink url="&c-program;">C</ulink> and <ulink url="&cxx;">C++</ulink> languages.  Many of these use Autotools or CMake to make them portable across different platforms.  These build tools need to be used to generate the <filename>Makefile</filename> and other required source files first.  Then, such programs are built using the usual <literal>make; make install</literal>.
ja: 多数の自由なプログラムは、<ulink url="&c-program;">C</ulink> や <ulink url="&cxx;">C++</ulink> 言語で書かれています。これらの多くは、異なるプラットフォーム間で移植を可能とするために Autotools や CMake を使っています。こういったツールは、<filename>Makefile</filename> やその他必要なソースファイルを生成するのに使われます。その後、このようなプログラムは通常どおり <literal>make; make install</literal> でビルドされます。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Autotools is too big to deal with in this small tutorial. This section is meant to provide keywords and references only.  Please make sure to read the <ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> and the local copy of <filename>&autotools-readme;</filename>, if you need to use it.
ja: Autotools は本入門書で扱うには大きすぎます。本セクションはキーワードや参照文献を提供するだけです。必要な際には、<ulink url="&autotools-tutorial;">Autotools Tutorial</ulink> と <filename>&autotools-readme;</filename> のローカルコピーをしっかり読んで下さい。

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&gnu-build-system;">Autotools</ulink> is the GNU build system comprising <ulink url="&autoconf;">Autoconf</ulink>, <ulink url="&automake;">Automake</ulink>, <ulink url="&libtool;">Libtool</ulink>, and <ulink url="&gettext;">gettext</ulink>.  You can recognize such sources by the <filename>configure.ac</filename>, <filename>Makefile.am</filename>, and <filename>Makefile.in</filename> files.  <placeholder type="footnote" id="0"/>
ja: <ulink url="&gnu-build-system;">Autotools</ulink> は <ulink url="&autoconf;">Autoconf</ulink>、<ulink url="&automake;">Automake</ulink>、<ulink url="&libtool;">Libtool</ulink> と <ulink url="&gettext;">gettext</ulink> から成る GNU のビルドシステムです。<filename>configure.ac</filename>、<filename>Makefile.am</filename> や <filename>Makefile.in</filename> ファイルがあれば、そういうソースであることがわかります。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: The first step of the Autotools workflow is usually that upstream runs <literal>autoreconf -i -f</literal> in the source directory and distributes the generated files along with the source.
ja: Autotools を使ったワークフローの最初の一歩は、アップストリームの作者がソースディレクトリーで <literal>autoreconf -i -f</literal> を実行し、生成されたファイルと一緒にこのソースを配布することです。

note: type: Content of: <book><chapter><section><para>
en: Editing <filename>configure.ac</filename> and <filename>Makefile.am</filename> files requires some knowledge of <command>autoconf</command> and <command>automake</command>.  See <literal>info autoconf</literal> and <literal>info automake</literal>.
ja: <filename>configure.ac</filename> や <filename>Makefile.am</filename> ファイルを編集するには、<command>autoconf</command> と <command>automake</command> についての知識が少々必要になります。<literal>info autoconf</literal> と <literal>info automake</literal> を参照してください。

note: type: Content of: <book><chapter><section><para>
en: The second step of the Autotools workflow is usually that the user obtains this distributed source and runs <literal>./configure &amp;&amp; make</literal> in the source directory to compile the program into an executable command <command><replaceable>binary</replaceable></command>.
ja: Autotools のワークフローの通常の次のステップは、この配布されているソースをユーザーが入手し、ソースディレクトリーで <literal>./configure &amp;&amp; make</literal> を実行することで、プログラムを <command><replaceable>binary</replaceable></command> という実行可能コマンドにコンパイルします。

note: type: Content of: <book><chapter><section><para>
en: You can change many things in the <filename>Makefile</filename>; for instance you can change the default location for file installation using the option <literal>./configure --prefix=/usr</literal>.
ja: <filename>Makefile</filename> ファイルにある内容の多くは変更することができます。例えばデフォルトでファイルがインストールされる場所などは、<literal>./configure --prefix=/usr</literal> とコマンドオプションを使って変更することができます。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You can automate this by using <systemitem role="package">dh-autoreconf</systemitem> package.  See <xref linkend="customrules"/>.
ja: <systemitem role="package">dh-autoreconf</systemitem> パッケージを用いるとこれが自動化出来ます。<xref linkend="customrules"/> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: Although it is not required, updating the <filename>configure</filename> and other files with <literal>autoreconf -i -f</literal> may improve the compatibility of the source.  <placeholder type="footnote" id="0"/>
ja: 必須ではありませんが、<literal>autoreconf -i -f</literal> をユーザーとして実行することで <filename>configure</filename> や他のファイルを更新すると、ソースの互換性が改善される場合があります。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: <ulink url="&cmake;">CMake</ulink> is an alternative build system.  You can recognize such sources by the <filename>CMakeLists.txt</filename> file.
ja: <ulink url="&cmake;">CMake</ulink> は代替のビルドシステムです。<filename>CMakeLists.txt</filename> ファイルがあれば、そういうソースだとわかります。

note: type: Content of: <book><chapter><section><title>
en: Package name and version
ja: パッケージ名とバージョン

note: type: Content of: <book><chapter><section><para>
en: If the upstream source comes as <filename>gentoo-0.9.12.tar.gz</filename>, you can take <literal>gentoo</literal> as the (source) <emphasis role="strong">package name</emphasis> and <literal>0.9.12</literal> as the <emphasis role="strong">upstream version</emphasis>.  These are used in the <filename>debian/changelog</filename> file described later in <xref linkend="changelog"/>, too.
ja: <filename>gentoo-0.9.12.tar.gz</filename> としてアップストリームソースが提供される場合、<emphasis role="strong">パッケージ名</emphasis>は <literal>gentoo</literal> で <emphasis role="strong">アップストリームバージョン</emphasis>は <literal>0.9.12</literal> となります。<xref linkend="changelog"/> で後述する <filename>debian/changelog</filename> ファイル中でも使われます。

note: type: Content of: <book><chapter><section><para>
en: Although this simple approach works most of the time, you may need to adjust <emphasis role="strong">package name</emphasis> and <emphasis role="strong">upstream version</emphasis> by renaming the upstream source to follow Debian Policy and existing convention.
ja: この単純なアプローチは大体うまくいくのですが、Debian Policy や従来の慣習に従うようにアップストリームソースをリネームすることで<emphasis role="strong">パッケージ名</emphasis> と <emphasis role="strong">アップストリームバージョン</emphasis>を調整する必要があるかもしれません。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default package name field length of <command>aptitude</command> is 30.  For more than 90% of packages, the package name is less than 24 characters.
ja: <command>aptitude</command> のデフォルトのパッケージ名フィールド長は 30 です。90% を越えるパッケージに関し、パッケージ名は 24 文字より短いです。

note: type: Content of: <book><chapter><section><para>
en: You must choose the <emphasis role="strong">package name</emphasis> to consist only of lower case letters (<literal>a-z</literal>), digits (<literal>0-9</literal>), plus (<literal>+</literal>) and minus (<literal>-</literal>) signs, and periods (<literal>.</literal>). It must be at least two characters long, must start with an alphanumeric character, and must not be the same as existing packages.  It is a good idea to keep its length within 30 characters.  <placeholder type="footnote" id="0"/>
ja: <emphasis role="strong">パッケージ名</emphasis> は、英小文字 (<literal>a-z</literal>)と数字 (<literal>0-9</literal>) と、プラス (<literal>+</literal>) やマイナス (<literal>-</literal>) 記号と、ピリオド (<literal>.</literal>) だけからなるように選ばなければいけません。少なくとも 2 文字以上で、英数字で始まり、既存のパッケージと同じではいけません。30 文字以内の長さにするのが望ましいです。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If you follow the <ulink url="&devref-newpackage;">Debian Developer's Reference 5.1. "New packages"</ulink>, the ITP process will usually catch this kind of issue.
ja: <ulink url="&devref-newpackage;">Debian Developer's Reference 5.1. "New packages"</ulink> の通りにすれば、ITP プロセスが普通この様な間違いを洗い出します。

note: type: Content of: <book><chapter><section><para>
en: If upstream uses some generic term such as <literal>test-suite</literal> for its name, it is a good idea to rename it to identify its contents explicitly and avoid namespace pollution.  <placeholder type="footnote" id="0"/>
ja: アップストリームのソースが <literal>test-suite</literal> のような一般的な単語をその名称として使う場合は、その内容を明示するようにリネームしネームスペース汚染を引き起こさないのが良い考えです。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This stricter rule should help you avoid confusing file names.
ja: この厳しい目のルールは混乱を招くファイル名を避けるのに役立ちます。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The default version field length of <command>aptitude</command> is 10.  The Debian revision with preceding hyphen usually consumes 2.  For more than 80% of packages, the upstream version is less than 8 characters and the Debian revision is less than 2 characters.  For more than 90% of packages, the upstream version is less than 10 characters and the Debian revision is less than 3 characters.
ja: <command>aptitude</command> のデフォルトのバージョンフィールド長は 10 です。Debian リビジョンとその前のハイフンが通常 2 つを消費します。80% 以上のパッケージはアップストリームバージョンが 8 文字より少なく、Debian リビジョンが 2 文字より少ないです。90% 上のパッケージはアップストリームバージョンが 10 文字より少なく、Debian リビジョンが 3 文字より少ないです。

note: type: Content of: <book><chapter><section><para>
en: You should choose the <emphasis role="strong">upstream version</emphasis> to consist only of alphanumerics (<literal>0-9A-Za-z</literal>), plus signs (<literal>+</literal>), tildes (<literal>~</literal>), and periods (<literal>.</literal>). It must start with a digit (<literal>0-9</literal>).  <placeholder type="footnote" id="0"/> It is good idea to keep its length within 8 characters if possible.  <placeholder type="footnote" id="1"/>
ja: <emphasis role="strong">アップストリームバージョン</emphasis> は、英数字 (<literal>0-9A-Za-z</literal>) と プラス (<literal>+</literal>) と 波線 (<literal>~</literal>) と ピリオド (<literal>.</literal>) からのみから選びます。それは数字 (<literal>0-9</literal>) で始まらなければいけません。<placeholder type="footnote" id="0"/> できることならその長さを 8 文字以内とするのがいいです。<placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: If upstream does not use a normal versioning scheme such as <literal>2.30.32</literal> but uses some kind of date such as <literal>11Apr29</literal>, a random codename string, or a VCS hash value as part of the version, make sure to remove them from the <emphasis role="strong">upstream version</emphasis>.  Such information can be recorded in the <filename>debian/changelog</filename> file.  If you need to invent a version string, use the <literal>YYYYMMDD</literal> format such as <literal>20110429</literal> as upstream version.  This ensures that <command>dpkg</command> interprets later versions correctly as upgrades.  If you need to ensure smooth transition to the normal version scheme such as <literal>0.1</literal> in the future, use the <literal>0~YYMMDD</literal> format such as <literal>0~110429</literal> as the upstream version.
ja: アップストリームが <literal>2.30.32</literal> のような通常のバージョンスキームを使わずに、<literal>11Apr29</literal> 等のような日時の類や、ランダムなコードネーム文字列や、バージョンの一部にVCS のハッシュ値等を使う場合、<emphasis role="strong">アップストリームバージョン</emphasis>から削除するようにしましょう。そのような情報は、<filename>debian/changelog</filename> ファイルに記録できます。バージョン文字列を作り上げる必要のある際には、<literal>20110429</literal> 等のような <literal>YYYYMMDD</literal> フォーマットをアップストリームバージョンとして使用します。こうすると後のバージョンが正しくアップグレードと <command>dpkg</command> により解釈されます。将来、<literal>0.1</literal> 等の通常のバージョンスキームへスムーズに移行する必要のある際には、<literal>0~110429</literal> 等のような <literal>0~YYMMDD</literal> フォーマットをアップストリームバージョンとしてこの代わりに使用します。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Version strings may be <emphasis role="strong">upstream version</emphasis> (<literal><replaceable>version</replaceable></literal>), <emphasis role="strong">Debian revision</emphasis> (<literal><replaceable>revision</replaceable></literal>), or <emphasis role="strong">version</emphasis> (<literal><replaceable>version</replaceable>-<replaceable>revision</replaceable></literal>).  See <xref linkend="newrevision"/> for how the <emphasis role="strong">Debian revision</emphasis> is incremented.
ja: バージョン文字列は、<emphasis role="strong">アップストリームバージョン</emphasis> (<literal><replaceable>version</replaceable></literal>) か、<emphasis role="strong">Debian リビジョン</emphasis> (<literal><replaceable>revision</replaceable></literal>) か、<emphasis role="strong">バージョン</emphasis> (<literal><replaceable>version</replaceable>-<replaceable>revision</replaceable></literal>) かもしれません。<emphasis role="strong">Debian リビジョン</emphasis> がどのように増やされるかは <xref linkend="newrevision"/> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: Version strings <placeholder type="footnote" id="0"/> can be compared using <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
ja: バージョン文字列<placeholder type="footnote" id="0"/>は <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドを以下のように使うことで比較できます:

note: type: Content of: <book><chapter><section><para>
en: The version comparison rule can be summarized as:
ja: バージョンの比較ルールは以下のようにまとめられます:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Strings are compared from the head to the tail.
ja: 文字列は頭から尾へと比較されます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are larger than digits.
ja: 英文字は数字よりも大きいです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Numbers are compared as integers.
ja: 数字は整数として比較されます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Letters are compared in ASCII code order.
ja: 英文字は ASCII コード順で比較されます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: There are special rules for period (<literal>.</literal>), plus (<literal>+</literal>), and tilde (<literal>~</literal>) characters, as follows:
ja: ピリオド (<literal>.</literal>) と、プラス (<literal>+</literal>) と 波線 (<literal>~</literal>) には以下のような特殊なルールがあります:

note: type: Content of: <book><chapter><section><para>
en: One tricky case occurs when upstream releases <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> as the pre-release of <filename>gentoo-0.9.12.tar.gz</filename>.  You need to make sure that the upgrade works properly by renaming the upstream source to <filename>gentoo-0.9.12~rc99.tar.gz</filename>.
ja: アップストリームが <filename>gentoo-0.9.12.tar.gz</filename> のプリリリースとして <filename>gentoo-0.9.12-ReleaseCandidate-99.tar.gz</filename> をリリースする時には要注意です。アップストリームソースを <filename>gentoo-0.9.12~rc99.tar.gz</filename> と名称変更してアップグレードがうまく機能するように確実にする必要があります。

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>dh_make</command>
ja: <command>dh_make</command> のセットアップ

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The following text assumes you are using Bash as your login shell.  If you use some other login shell such as Z shell, use their corresponding configuration files instead of <filename>~/.bashrc</filename>.
ja: 以下の文章はあなたが Bash をログインシェルとして使っていると仮定しています。Z シェルのような他のログインシェルを用いている場合 <filename>~/.bashrc</filename>と代えてそれに対応する設定ファイルを使って下さい。

note: type: Content of: <book><chapter><section><para>
en: Set up the shell environment variables <literal>$DEBEMAIL</literal> and <literal>$DEBFULLNAME</literal> so that various Debian maintenance tools recognize your email address and name to use for packages. <placeholder type="footnote" id="0"/>
ja: 次のようにして、シェルの環境変数 <literal>$DEBEMAIL</literal> と <literal>$DEBFULLNAME</literal> を設定して、パッケージに使うあなたの email アドレスと名前を、多くの Debian メンテナンスツールに認識させましょう。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Initial non-native Debian package
ja: 最初のノンネイティブ Debian パッケージ

note: type: Content of: <book><chapter><section><para>
en: Normal Debian packages are non-native Debian packages made from upstream programs.  If you wish to create a non-native Debian package of an upstream source <filename>gentoo-0.9.12.tar.gz</filename>, you can create an initial non-native Debian package for it by issuing the <command>dh_make</command> command as follows:
ja: 標準的な Debian パッケージはアップストリームプログラムから作成されたノンネイティブ Debian パッケージです。アップストリームソース <filename>gentoo-0.9.12.tar.gz</filename> からノンネイティブ Debian パッケージを作りたい場合、<command>dh_make</command> コマンドを以下のように実行すると作成できます:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If the upstream source provides the <filename>debian</filename> directory and its contents, run the <command>dh_make</command> command with the extra option <literal>--addmissing</literal>.  The new source <literal>3.0 (quilt)</literal> format is robust enough not to break even for these packages.  You may need to update the contents provided by the upstream version for your Debian package.
ja: アップストリームのソースが <filename>debian</filename> ディレクトリーとその中身を提供している場合は、かわりに <command>dh_make</command> コマンドを <literal>--addmissing</literal> オプションをつけて実行してください。新しい <literal>3.0 (quilt)</literal> 形式のソースはとても堅牢なので、こういったパッケージでも壊すことはありません。自分の Debian パッケージ用に、アップストリームバージョンが提供した内容を更新する必要があるかもしれません。

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of your original source archive.  <placeholder type="footnote" id="0"/> See <citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> for details.
ja: 当然ですが、ファイル名はあなたのオリジナルのソースアーカイブの名前と置き換えてください。<placeholder type="footnote" id="0"/> 詳細は、<citerefentry> <refentrytitle>dh_make</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> を参照してください。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are several choices here: <literal>s</literal> for Single binary package, <literal>i</literal> for arch-Independent package, <literal>m</literal> for Multiple binary packages, <literal>l</literal> for Library package, <literal>k</literal> for Kernel module package, <literal>n</literal> for kernel patch package, and <literal>b</literal> for <systemitem role="package">cdbs</systemitem> package.  This document focuses on the use of the <command>dh</command> command (from the package <systemitem role="package">debhelper</systemitem>) to create a single binary package, but also touches on how to use it for arch-independent or multiple binary packages.  The package <systemitem role="package">cdbs</systemitem> offers an alternative packaging script infrastructure to the <command>dh</command> command and is outside the scope of this document.
ja: ここでの選択肢はわずかです。<literal>s</literal> は Single binary package (単一バイナリーパッケージ)、<literal>i</literal> は Arch-Independent package (アーキテクチャー非依存パッケージ)、<literal>m</literal> は Multiple binary package (複数バイナリーパッケージ)、<literal>l</literal> は Library package (ライブラリーパッケージ)、<literal>k</literal> は Kernel module package (カーネルモジュールパッケージ)、<literal>n</literal> は Kernel patch package (カーネルパッチパッケージ)、<literal>b</literal> は <systemitem role="package">cdbs</systemitem> です。本文書は <systemitem role="package">debhelper</systemitem> パッケージを <command>dh</command> コマンドとともに使うことに使うことに重点を置きます。このドキュメントでは、単一バイナリーパッケージのために <command>dh</command> コマンドを使うことに重点を置き、アーキテクチャー非依存や複数バイナリーのパッケージに関する同様の事にも触れます。<systemitem role="package">cdbs</systemitem> パッケージは <command>dh</command> コマンドに代わるパッケージスクリプトのインフラを提供し、本文書では対象外です。

note: type: Content of: <book><chapter><section><para>
en: You should see some output asking you what sort of package you want to create.  Gentoo is a single binary package &#x2014; it creates only one binary package, i.e., one <filename>.deb</filename> file &#x2014; so we will select the first option (with the <literal>s</literal> key), check the information on the screen, and confirm by pressing <literal><replaceable>ENTER</replaceable></literal>.  <placeholder type="footnote" id="0"/>
ja: 情報がいくつか表示されるでしょう。どんな種類のパッケージを作ろうとしているのかを尋ねられます。Gentoo は単一バイナリーパッケージ &#x2014; バイナリーを一つだけ生成するので、一個の <filename>.deb</filename> ファイルです &#x2014; なので、<literal>s</literal> キーで最初の選択肢を選びましょう。表示された情報をチェックして、<literal><replaceable>ENTER</replaceable></literal> を押して確認してください。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: This execution of <command>dh_make</command> creates a copy of the upstream tarball as <filename>gentoo_0.9.12.orig.tar.gz</filename> in the parent directory to accommodate the creation of the non-native Debian source package with the name <filename>debian.tar.gz</filename> later:
ja: <command>dh_make</command> を実行した後、アップストリームの tarball のコピーを、親ディレクトリーに <filename>gentoo_0.9.12.orig.tar.gz</filename> として作成します。次に、それに伴ってノンネイティブ Debian ソースパッケージを <filename>debian.tar.gz</filename> として作成します:

note: type: Content of: <book><chapter><section><para>
en: Please note two key features of this filename <filename>gentoo_0.9.12.orig.tar.gz</filename>:
ja: この <filename>gentoo_0.9.12.orig.tar.gz</filename> ファイル名がもっている 2 つの特徴に注意してください:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Package name and version are separated by the character <literal>_</literal> (underscore).
ja: パッケージ名とバージョンは <literal>_</literal> (アンダースコア) で区切られています。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The string <filename>.orig</filename> is inserted before the <filename>.tar.gz</filename>.
ja: <filename>.tar.gz</filename> の前に <filename>.orig</filename> と言う文字列があります。

note: type: Content of: <book><chapter><section><para>
en: You should also notice that many template files are created in the source under the <filename>debian</filename> directory.  These will be explained in <xref linkend="dreq"/> and <xref linkend="dother"/>.  You should also understand that packaging cannot be a fully automated process.  You will need to modify the upstream source for Debian (see <xref linkend="modify"/>).  After this, you need to use the proper methods for building Debian packages (<xref linkend="build"/>), testing them (<xref linkend="checkit"/>), and uploading them (<xref linkend="upload"/>).  All the steps will be explained.
ja: ソース中の<filename>debian</filename>ディレクトリーにたくさんのテンプレートファイルが作成されていることにも注意が必要です。これらについては、<xref linkend="dreq"/> と <xref linkend="dother"/> で説明します。パッケージ作成が自動的な過程ではないことも理解しておかねばなりません。<xref linkend="modify"/> のように、アップストリームソースを Debian 向けに変更する必要があります。こういった作業の後で、<xref linkend="build"/> のように正しいやり方で Debian パッケージをビルドし、<xref linkend="checkit"/> のようにチェックし、そして <xref linkend="upload"/> のようにしてアップロードする必要があります。これらすべてのステップについてこれから説明します。

note: type: Content of: <book><chapter><section><para>
en: If you accidentally erased some template files while working on them, you can recover them by running <command>dh_make</command> with the <literal>--addmissing</literal> option again in a Debian package source tree.
ja: 作業中にテンプレートファイルを間違って消した場合は、Debian パッケージのソースツリーで <command>dh_make</command> を <literal>--addmissing</literal> オプションつきで再度実行することで修復できます。

note: type: Content of: <book><chapter><section><para>
en: Updating an existing package may get complicated since it may be using older techniques.  While learning the basics, please stick to creating a fresh package; further explanations are given in <xref linkend="update"/>.
ja: 既存のパッケージの更新は、古いテクニックが使われていたりして、やっかいな場合があります。基本を学習中は、新規パッケージの作成にとどめてください。<xref linkend="update"/> にて、追加で説明します。

note: type: Content of: <book><chapter><section><para>
en: Please note that the source file does not need to contain any build system discussed in <xref linkend="simplemake"/> and <xref linkend="portable"/>.  It could be just a collection of graphical data, etc.  Installation of files may be carried out using only <systemitem role="package">debhelper</systemitem> configuration files such as <filename>debian/install</filename> (see <xref linkend="install"/>).
ja: ソースファイルには <xref linkend="simplemake"/> や <xref linkend="portable"/> で述べたようないかなるビルドシステムを含んでいる必要は無いことに注意して下さい。それは単なる画像データ集等かもしれません。ファイルのインストールは <filename>debian/install</filename> (<xref linkend="install"/>参照) のような <systemitem role="package">debhelper</systemitem> コンフィギュレーションファイルだけを使っても行えます。

note: type: Content of: <book><chapter><title>
en: Modifying the source
ja: ソースコードの変更

note: type: Content of: <book><chapter><para>
en: Please note that there isn't space here to go into <emphasis>all</emphasis> the details of fixing upstream sources, but here are some basic steps and problems people often run across.
ja: アップストリームのソースを修正する具体的なやり方について、<emphasis>何から何まで</emphasis>説明するにはとても紙面が足りませんが、よくあるパターンとしては大体以下のようなものでしょう。

note: type: Content of: <book><chapter><section><title>
en: Setting up <command>quilt</command>
ja: <command>quilt</command> のセットアップ

note: type: Content of: <book><chapter><section><para>
en: The program <command>quilt</command> offers a basic method for recording modifications to the upstream source for Debian packaging.  It's useful to have a slightly customized default, so let's create an alias <command>dquilt</command> for Debian packaging by adding the following lines to <filename>~/.bashrc</filename>.  The second line provides the same shell completion feature of the <command>quilt</command> command to the <command>dquilt</command> command:
ja: <command>quilt</command> プログラムはアップストリームソースに対する Debian パッケージ向け修正を記録する、基本的な方法を提供します。Debian パッケージで使うには、多少カスタマイズしたデフォルトを使うのが望ましいので、以下の行を <filename>~/.bashrc</filename> に追加し Debian パッケージ作成用のエリアス <command>dquilt</command> を作りましょう。第 2 行目は <command>quilt</command> コマンドのシェル入力完了機能と同様の機能を <command>dquilt</command> コマンドに与えます:

note: type: Content of: <book><chapter><section><para>
en: Then let's create <filename>~/.quiltrc-dpkg</filename> as follows:
ja: <filename>~/.quiltrc-dpkg</filename> ファイルを次のように作成しましょう:

note: type: Content of: <book><chapter><section><para>
en: See <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <filename>&quilt-pdf;</filename> on how to use <command>quilt</command>.
ja: <command>quilt</command> の使い方については、<citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> と <filename>&quilt-pdf;</filename> を参照してください。

note: type: Content of: <book><chapter><section><title>
en: Fixing upstream bugs
ja: アップストリームのバグを修正する

note: type: Content of: <book><chapter><section><para>
en: Let's assume you find an error in the upstream <filename>Makefile</filename> as follows, where <literal>install: gentoo</literal> should have been <literal>install: gentoo-target</literal>.
ja: 以下のようなアップストリームの <filename>Makefile</filename> にエラーを見つけて、<literal>install: gentoo</literal> の部分が <literal>install: gentoo-target</literal> となっているべきだったとします。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <filename>debian/patches</filename> directory should exist now if you ran <command>dh_make</command> as described before.  This example operation creates it just in case you are updating an existing package.
ja: 前に説明したように <command>dh_make</command> を実行していれば、<filename>debian/patches</filename>ディレクトリーはもう存在しているはずです。この操作例では、既存のパッケージを更新している場合に合わせて作成しています。

note: type: Content of: <book><chapter><section><para>
en: Let's fix this and record it with the <command>dquilt</command> command as <filename>fix-gentoo-target.patch</filename>: <placeholder type="footnote" id="0"/>
ja: これを修正して、<command>dquilt</command> コマンドを使って <filename>fix-gentoo-target.patch</filename> として登録しましょう: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You change the <filename>Makefile</filename> file as follows:
ja: <filename>Makefile</filename> ファイルを次のように変更します:

note: type: Content of: <book><chapter><section><para>
en: Ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/fix-gentoo-target.patch</filename> and add its description following <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink>:
ja: パッチを更新して <filename>debian/patches/fix-gentoo-target.patch</filename> を作成するように <command>dquilt</command> に要求し、それから説明を <ulink url="&dep3;">DEP-3: Patch Tagging Guidelines</ulink> に準拠して追記します:

note: type: Content of: <book><chapter><section><screen>
en: $ dquilt refresh
    $ dquilt header -e
    ... describe patch
ja: $ dquilt refresh
    $ dquilt header -e
    ... パッチの詳細

note: type: Content of: <book><chapter><section><title>
en: Installation of files to their destination
ja: 指定場所へのファイルのインストール

note: type: Content of: <book><chapter><section><para>
en: Most third-party software installs itself in the <filename>/usr/local</filename> directory hierarchy.  On Debian this is reserved for private use by the system administrator, so packages must not use directories such as <filename>/usr/local/bin</filename> but should instead use system directories such as <filename>/usr/bin</filename>, obeying the <ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS).
ja: 通常、サードパーティーソフトウェアは自分自身を <filename>/usr/local</filename> サブディレクトリーにインストールします。Debian 上ではこれはシステム管理者 (もしくはユーザー) の個人用に予約されているため、パッケージャーは <filename>/usr/local</filename> のようなディレクトリーを使わず、<ulink url="&fhs;">Filesystem Hierarchy Standard</ulink> (FHS)  に従って <filename>/usr/bin</filename> サブディレクトリーのようなシステムディレクトリーを使わなくてはなりません。

note: type: Content of: <book><chapter><section><para>
en: Normally, <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> is used to automate building the program, and executing <literal>make install</literal> installs programs directly to the desired destination (following the <literal>install</literal> target in the <filename>Makefile</filename>).  In order for Debian to provide pre-built installable packages, it modifies the build system to install programs into a file tree image created under a temporary directory instead of the actual destination.
ja: プログラムのビルドを自動化するには、通常 <citerefentry> <refentrytitle>make</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> が使われており、<literal>make install</literal> を実行すると、(<filename>Makefile</filename> の<literal>install</literal> ターゲットに従い) 希望する場所へ直接インストールされます。Debian ではビルド済みのインストール可能なパッケージを提供するために、実際のインストール先のかわりに、一時ディレクトリーの下に作成されたファイルツリーのイメージへプログラムをインストールするようにビルドシステムを変更します。

note: type: Content of: <book><chapter><section><para>
en: These two differences between normal program installation on one hand and the Debian packaging system on the other can be transparently addressed by the <systemitem role="package">debhelper</systemitem> package through the <command>dh_auto_configure</command> and <command>dh_auto_install</command> commands if the following conditions are met:
ja:  普通のプログラムインストールとDebian パッケージ作成というこれら二つの違いには、<systemitem role="package">debhelper</systemitem> パッケージの <command>dh_auto_configure</command> と <command>dh_auto_install</command> のコマンドを使うことで特に意識せずに対応できます:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink>.
ja: <ulink url="&gnu-destdir;">GNU Coding Standards: 7.2.4 DESTDIR: Support for Staged Installs</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <filename>Makefile</filename> must follow GNU conventions and support the <literal>$(DESTDIR)</literal> variable.  <placeholder type="footnote" id="0"/>
ja: <filename>Makefile</filename> ファイルが GNU の慣例に準拠し、<literal>$(DESTDIR)</literal> 変数をサポートしていること。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The source must follow the Filesystem Hierarchy Standard (FHS).
ja: ソースは Filesystem Hierarchy Standard (FHS)  に準拠している必要があります。

note: type: Content of: <book><chapter><section><para>
en: Programs that use GNU <command>autoconf</command> follow the GNU conventions automatically, so they can be trivial to package.  On the basis of this and other heuristics, it is estimated that the <systemitem role="package">debhelper</systemitem> package will work for about 90% of packages without making any intrusive changes to their build system.  So packaging is not as complicated as it may seem.
ja: GNU <command>autoconf</command> を使っているプログラムは、自動的に GNU 規約に準拠するので、そのパッケージ作成はいとも簡単にできます。こういう事実や他から類推すると、<systemitem role="package">debhelper</systemitem> パッケージはビルドシステムに立ち入った変更を加えることなく、約 90% のパッケージで使えると推定されます。そのため、パッケージ作成は見かけほど複雑ではありません。

note: type: Content of: <book><chapter><section><para>
en: If you need to make changes in the <filename>Makefile</filename>, you should be careful to support the <literal>$(DESTDIR)</literal> variable.  Although it is unset by default, the <literal>$(DESTDIR)</literal> variable is prepended to each file path used for the program installation.  The packaging script will set <literal>$(DESTDIR)</literal> to the temporary directory.
ja: もし <filename>Makefile</filename> ファイルを変更する必要があるなら、これら <literal>$(DESTDIR)</literal> 変数をサポートするように注意しましょう。デフォルトではアンセットされているとはいえ、プログラムのインストールに使われる各ファイルパスの前に<literal>$(DESTDIR)</literal> 変数は付与されます。パッケージ作成スクリプトは <literal>$(DESTDIR)</literal> を一時ディレクトリーにセットします。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: For a source package generating multiple binary packages, the <command>dh_auto_install</command> command uses <filename>debian/tmp</filename> as the temporary directory while the <command>dh_install</command> command with the help of <filename>debian/<replaceable>package-1</replaceable>.install</filename> and <filename>debian/<replaceable>package-2</replaceable>.install</filename> files will split the contents of <filename>debian/tmp</filename> into <filename>debian/<replaceable>package-1</replaceable></filename> and <filename>debian/<replaceable>package-2</replaceable></filename> temporary directories, to create <filename><replaceable>package-1</replaceable>_*.deb</filename> and <filename><replaceable>package-2</replaceable>_*.deb</filename> binary packages.
ja: 複数バイナリーパッケージを生成するソースパッケージでは、<filename>debian/tmp</filename> を <command>dh_auto_install</command> コマンドが使う一時ディレクトリーとしますが、<filename>debian/tmp</filename> の中身を <filename>debian/<replaceable>package-1</replaceable></filename> や <filename>debian/<replaceable>package-2</replaceable></filename> 一時ディレクトリーへと、<filename>debian/<replaceable>package-1</replaceable>.install</filename> や <filename>debian/<replaceable>package-2</replaceable>.install</filename> ファイルによる指定に従い <command>dh_install</command> コマンドが分配することで複数バイナリー <filename>*.deb</filename> パッケージを作成されます。

note: type: Content of: <book><chapter><section><para>
en: For a source package generating a single binary package, the temporary directory used by the <command>dh_auto_install</command> command will be set to <filename>debian/<replaceable>package</replaceable></filename>.  <placeholder type="footnote" id="0"/> Everything that is contained in the temporary directory will be installed on users' systems when they install your package; the only difference is that <command>dpkg</command> will be installing the files to paths relative to the root directory rather than your working directory.
ja: 単一バイナリーパッケージを生成するソースパッケージでは、<filename>debian/<replaceable>package</replaceable></filename> が <command>dh_auto_install</command> コマンドが使う一時ディレクトリーとして指定されます。<placeholder type="footnote" id="0"/> 一時ディレクトリーに含まれているものはすべて、ユーザーがあなたのパッケージをインストールする時に、ユーザーのシステムにインストールされます。唯一の違いは、<command>dpkg</command> はファイルをあなたの作業ディレクトリーではなくルートディレクトリーからの相対パスにインストールするということです。

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that even though your program installs in <filename>debian/<replaceable>package</replaceable></filename>, it still needs to behave correctly when installed from the <filename>.deb</filename> package under the root directory.  So you must not allow the build system to hardcode strings like <literal>/home/me/deb/<replaceable>package</replaceable>-<replaceable>version</replaceable>/usr/share/<replaceable>package</replaceable></literal> into files in the package.
ja: パッケージの作成時は、あなたのプログラムは <filename>debian/<replaceable>package</replaceable></filename> にインストールされますが、<filename>.deb</filename> パッケージからルートディレクトリー下にインストールされた場合も正しく動作する必要があることを覚えておいてください。こうするためには、ビルドシステムがパッケージファイルの中のファイル中に <literal>/home/me/deb/<replaceable>package</replaceable>-<replaceable>version</replaceable>/usr/share/<replaceable>package</replaceable></literal> といった文字列をハードコードしないようにしなければなりません。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This is just an example to show what a <filename>Makefile</filename> should look like.  If the <filename>Makefile</filename> is created by the <command>./configure</command> command, the correct way to fix this kind of <filename>Makefile</filename> is to execute <command>./configure</command> from the <command>dh_auto_configure</command> command with default options including <literal>--prefix=/usr</literal>.
ja: これは <filename>Makefile</filename> ファイルがこうなっているべきである、ということを示すための例にすぎません。<filename>Makefile</filename> ファイルが <command>./configure</command> コマンドで作成されているなら、この手の <filename>Makefile</filename> を修正する正しい方法は、<command>dh_auto_configure</command> コマンドに <literal>--prefix=/usr</literal> を含むデフォルトのオプションを与えて、<command>./configure</command> コマンドを実行させることです。

note: type: Content of: <book><chapter><section><para>
en: Here's the relevant part of <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename><placeholder type="footnote" id="0"/>:
ja: <systemitem role="package">gentoo</systemitem> の <filename>Makefile</filename> で該当する部分はこれです<placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: We see that the files are set to install under <filename>/usr/local</filename>.  As explained above, that directory hierarchy is reserved for local use on Debian, so change those paths as follows:
ja: ファイルが <filename>/usr/local</filename> 以下にインストールされるようになっていることがわかります。 上記説明にあるように、そのディレクトリーヒエラルキーは Debian 上のローカルユーザー向けに予約されているので、これらのパスを以下のように変更してください:

note: type: Content of: <book><chapter><section><para>
en: The exact locations that should be used for binaries, icons, documentation, etc. are specified in the Filesystem Hierarchy Standard (FHS).  You should browse through it and read the sections relevant to your package.
ja: バイナリー、アイコン、文書など、それぞれのファイルを保存すべき正確な場所については、Filesystem Hierarchy Standard (FHS) 中に規定されています。全体に目を通して、あなたのパッケージに該当する箇所を読むことをお勧めします。

note: type: Content of: <book><chapter><section><para>
en: So, we should install executable commands in <filename>/usr/bin</filename> instead of <filename>/usr/local/bin</filename>, the manual page in <filename>/usr/share/man/man1</filename> instead of <filename>/usr/local/man/man1</filename>, and so on.  Notice how there's no manual page mentioned in <systemitem role="package">gentoo</systemitem>'s <filename>Makefile</filename>, but since Debian Policy requires that every program has one, we'll make one later and install it in <filename>/usr/share/man/man1</filename>.
ja: そういうわけで、実行可能バイナリーは <filename>/usr/local/bin</filename> ではなく <filename>/usr/bin</filename> へインストールしなければなりませんし、マニュアルページは <filename>/usr/local/man/man1</filename> の代わりに <filename>/usr/share/man/man1</filename> へインストールする必要があります。ここで <systemitem role="package">gentoo</systemitem> の <filename>Makefile</filename> には、マニュアルページに関する記述がまったく無いことに注意してください。Debian ポリシーでは、すべてのプログラムがそれぞれマニュアルを用意しなければならないと定めていますから、後で gentoo のマニュアルを作成して、それを <filename>/usr/share/man/man1</filename> 以下へインストールすることにします。

note: type: Content of: <book><chapter><section><para>
en: Some programs don't use <filename>Makefile</filename> variables to define paths such as these.  This means you might have to edit some real C sources in order to fix them to use the right locations.  But where to search, and exactly what for? You can find this out by issuing:
ja: プログラムの中には、このようなパスを定義するための <filename>Makefile</filename> 変数を使っていないものもあります。このような場合、C のソースそのものをいじって、指定された場所を使うように修正しなければなりません。でもどこを探し、何を確認すればよいのでしょうか? 以下のコマンドを実行すれば該当箇所を見つけることができます:

note: type: Content of: <book><chapter><section><para>
en: <command>grep</command> will run recursively through the source tree and tell you the filename and the line number for all matches.
ja: <command>grep</command> がソースツリーを再帰的に検索し、該当箇所を見つけたらそのファイルの名前と検索対象の文字列が含まれる行番号とを表示します。

note: type: Content of: <book><chapter><section><para>
en: Edit those files and in those lines replace <literal>usr/local/lib</literal> with <literal>usr/lib</literal>.  This can be done automatically as follows:
ja: それらのファイルを編集し、該当行の <literal>usr/local/lib</literal> を <literal>usr/lib</literal> に置き換えてください。これは以下の様にすると自動化出来ます:

note: type: Content of: <book><chapter><section><para>
en: If you want to confirm each substitution instead, this can be done interactively as follows:
ja: こうする代わりに、各置換を確認したい場合は、これは以下のようにインタラクティブにできます:

note: type: Content of: <book><chapter><section><para>
en: Next you should find the <literal>install</literal> target (searching for the line that starts with <literal>install:</literal> will usually work) and rename all references to directories other than ones defined at the top of the <filename>Makefile</filename>.
ja: 修正が終ったら、 <literal>install</literal> ターゲットを探しましょう(<literal>install:</literal> で始まる行を探してください。この方法でたいていうまくいきます)。<filename>Makefile</filename> の先頭で定義されているものを除いて、ディレクトリーへの参照をすべて変更してください。

note: type: Content of: <book><chapter><section><para>
en: Originally, <systemitem role="package">gentoo</systemitem>'s <literal>install</literal> target said:
ja: 修正前は、<systemitem role="package">gentoo</systemitem> の <literal>install</literal> ターゲットはこうなっています:

note: type: Content of: <book><chapter><section><para>
en: Let's fix this upstream bug and record it with the <command>dquilt</command> command as <filename>debian/patches/install.patch</filename>.
ja: <command>dquilt</command> コマンドを使って、<filename>debian/patches/install.patch</filename> としてアップストリームバグを修正して記録しましょう。

note: type: Content of: <book><chapter><section><para>
en: In your editor, change this for the Debian package as follows:
ja: Debian パッケージ用に、これをエディタで次のように変更します:

note: type: Content of: <book><chapter><section><para>
en: You'll have noticed that there's now an <literal>install -d</literal> command before the other commands in the rule.  The original <filename>Makefile</filename> didn't have it because usually <literal>/usr/local/bin</literal> and other directories already exist on the system where you are running <literal>make install</literal>.  However, since we will be installing into a newly created private directory tree, we will have to create each and every one of those directories.
ja: お気づきになったでしょうが、変更後はこのルールの他のコマンドより前に <literal>install -d</literal> コマンドが追加されています。<literal>make install</literal> を実行するようなシステムなら <literal>/usr/local/bin</literal> やその他のディレクトリーはたいがい既に存在しているでしょうから、もともとの <filename>Makefile</filename> ではこのコマンドは使われていませんでした。しかし、私たちは独自に空っぽの（あるいはまだ存在さえしていない）ディレクトリーにインストールするわけですから、これらの各ディレクトリーを毎回作成する必要があります。

note: type: Content of: <book><chapter><section><para>
en: We can also add in other things at the end of the rule, like the installation of additional documentation that the upstream authors sometimes omit:
ja: ルールの最後には、アップストリームの作者が省略することの多い付加的な資料のインストールなど、他の作業を追加することもできます:

note: type: Content of: <book><chapter><section><para>
en: Check carefully, and if everything is okay, ask <command>dquilt</command> to generate the patch to create <filename>debian/patches/install.patch</filename> and add its description:
ja: しっかりチェックをして、何も問題がないようであれば、<command>dquilt</command> でパッチを更新して <filename>debian/patches/install.patch</filename> を作成し、パッチの説明を追記してください:

note: type: Content of: <book><chapter><section><para>
en: Now you have a series of patches.
ja: これで、一連のパッチができました。

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Upstream bug fix: <filename>debian/patches/fix-gentoo-target.patch</filename>
ja: アップストリームのバグ修正： <filename>debian/patches/fix-gentoo-target.patch</filename>

note: type: Content of: <book><chapter><section><orderedlist><listitem><para>
en: Debian specific packaging modification: <filename>debian/patches/install.patch</filename>
ja: Debian 固有のパッケージ上の変更： <filename>debian/patches/install.patch</filename>

note: type: Content of: <book><chapter><section><para>
en: Whenever you make changes that are not specific to the Debian package such as <filename>debian/patches/fix-gentoo-target.patch</filename>, be sure to send them to the upstream maintainer so they can be included in the next version of the program and be useful to everyone else.  Also remember to avoid making your fixes specific to Debian or Linux &#x2014; or even Unix! Make them portable.  This will make your fixes much easier to apply.
ja: <filename>debian/patches/fix-gentoo-target.patch</filename> のような、特に Debian パッケージだけに限定されない変更を行った場合、その内容をアップストリームのメンテナーに報告するようにしてください。そうすれば、プログラムの次版に反映してもらうことができ、他のすべての利用者にとっても有益な結果をもたらすことになります。また、あなたの修正を送る前に、Debian や Linux &#x2014; あるいは Unix でさえも! &#x2014; に特化した修正にせず、移植性をもたせることも忘れないでください。そうすれば、あなたの変更はずっと採用されやすくなります。

note: type: Content of: <book><chapter><section><para>
en: Note that you don't have to send the <filename>debian/*</filename> files upstream.
ja: アップストリームの作者へ <filename>debian/*</filename> ファイルを送らなくてもよいことに注意してください。

note: type: Content of: <book><chapter><section><title>
en: Differing libraries
ja: ライブラリーの相違

note: type: Content of: <book><chapter><section><para>
en: There is one other common problem: libraries are often different from platform to platform.  For example, a <filename>Makefile</filename> can contain a reference to a library that doesn't exist on the Debian system.  In that case, we need to change it to a library that does exist in Debian, and serves the same purpose.
ja: よくある問題がもう一つあります。ライブラリーはしばしばプラットフォームごとに異なります。例えば、<filename>Makefile</filename> は Debian システム上に存在しないライブラリーへの参照を含んでいるかもしれません。その場合には、Debian 上に存在する互換ライブラリーを指すように変更し、同じ目的を果たすようにしてやらなければなりません。

note: type: Content of: <book><chapter><section><para>
en: Let's assume a line in your program's <filename>Makefile</filename> (or <filename>Makefile.in</filename>) as the following.
ja: あなたのプログラムの <filename>Makefile</filename> (もしくは <filename>Makefile.in</filename>)  が以下のようになっていると仮定しましょう。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If there are API changes from the <literal>foo</literal> library to the <literal>foo2</literal> library, required changes to the source code need to be made to match the new API.
ja: <literal>foo</literal> ライブラリーから <literal>foo2</literal> ライブラリーへの API 変更があった場合、新しい API に合わせてソースコードへの必要な変更を加える必要があります。

note: type: Content of: <book><chapter><section><para>
en: If your program doesn't compile since the <literal>foo</literal> library doesn't exist and its equivalent is provided by the <literal>foo2</literal> library on the Debian system, you can fix this build problem as <filename>debian/patches/foo2.patch</filename> by changing <literal>foo</literal> into <literal>foo2</literal>:<placeholder type="footnote" id="0"/>
ja:  <literal>foo</literal> ライブラリーが存在しないためにあなたのプログラムがコンパイルしないで、<literal>foo2</literal> ライブラリーがその等価を Debian システム上で提供する場合、<literal>foo</literal> を <literal>foo2</literal> に変更する <filename>debian/patches/foo2.patch</filename> としてこのビルド問題を解決できます:<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><title>
en: Required files under the <filename>debian</filename> directory
ja: <filename>debian/</filename> ディレクトリー以下に無くてはならないファイル

note: type: Content of: <book><chapter><para>
en: In this chapter, files in the <filename>debian</filename> directory are referred to without the leading <filename>debian/</filename> for simplicity whenever the meaning is obvious.
ja: 自明な場合、本章では <filename>debian</filename> ディレクトリー中のファイルは、前に付く <filename>debian/</filename> を省略し簡明に表記しています。

note: type: Content of: <book><chapter><para>
en: There is a new subdirectory under the program's source directory, called <filename>debian</filename>.  There are a number of files in this directory that we should edit in order to customize the behavior of the package.  The most important of them are <filename>control</filename>, <filename>changelog</filename>, <filename>copyright</filename>, and <filename>rules</filename>, which are required for all packages.  <placeholder type="footnote" id="0"/>
ja: プログラムのソースディレクトリーの中に <filename>debian</filename>という名前の新しいディレクトリーがつくられています。このディレクトリー内には、パッケージの挙動をカスタマイズするため編集するべき多くのファイルがあります。特に、 <filename>control</filename>  と <filename>changelog</filename>  と <filename>copyright</filename>  と <filename>rules</filename> は、すべてのパッケージになくてはならないファイルです。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: This file contains various values which <command>dpkg</command>, <command>dselect</command>, <command>apt-get</command>, <command>apt-cache</command>, <command>aptitude</command>, and other package management tools will use to manage the package.  It is defined by the <ulink url="&policy-control;">Debian Policy Manual, 5 "Control files and their fields"</ulink>.
ja: <command>dpkg</command> や <command>dselect</command> や <command>apt-get</command> や <command>apt-cache</command> や <command>aptitude</command> 等のパッケージ管理ツールが利用する情報は、このファイルに記載されています。このファイルは、<ulink url="&policy-control;">Debian Policy Manual, 5 'Control files and their fields'</ulink>に定義されています。

note: type: Content of: <book><chapter><section><para>
en: Here is the <filename>control</filename> file <command>dh_make</command> created for us:
ja: 以下は、<command>dh_make</command> が生成した <filename>control</filename> ファイルの雛型です:

note: type: Content of: <book><chapter><section><para>
en: (I've added the line numbers.)
ja: (行番号は筆者による)

note: type: Content of: <book><chapter><section><para>
en: Lines 1&#x2013;7 are the control information for the source package.  Lines 9&#x2013;13 are the control information for the binary package.
ja: 1&#x2013;7 行目は、ソースパッケージの管理情報です。9&#x2013;13 行目は、バイナリーパッケージの管理情報です。

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the name of the source package.
ja: 1 行目は、ソースパッケージ名です。

note: type: Content of: <book><chapter><section><para>
en: Line 2 is the section of the distribution the source package goes into.
ja: 2 行目は、パッケージが所属するディストリビューション内のセクションです。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-subsections;">Debian Policy Manual, 2.4 "Sections"</ulink> and <ulink url="&sections-unstable;">List of sections in <literal>sid</literal></ulink>.
ja: <ulink url="&policy-subsections;">Debian Policy Manual, 2.4 "Sections"</ulink> と <ulink url="&sections-unstable;">List of sections in <literal>sid</literal></ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: As you may have noticed, the Debian archive is divided into multiple areas: <literal>main</literal> (the free software), <literal>non-free</literal> (the not really free software) and <literal>contrib</literal> (free software that depends on non-free software).  Each of these is divided into sections that classify packages into rough categories.  So we have <literal>admin</literal> for administrator-only programs, <literal>devel</literal> for programmer tools, <literal>doc</literal> for documentation, <literal>libs</literal> for libraries, <literal>mail</literal> for email readers and daemons, <literal>net</literal> for network apps and daemons, <literal>x11</literal> for X11 programs that don't fit anywhere else, and many more.  <placeholder type="footnote" id="0"/>
ja: ご存知のように、Debianアーカイブは <literal>main</literal> (完全にフリーなソフトウェア)、<literal>non-free</literal> (本当にフリーではないソフトウェア)、<literal>contrib</literal> (フリーだが non-free ソフトウェアに依存するソフトウェア)という複数エリアに分かれています。さらにそれらは、大まかなカテゴリー毎のセクションに分類されています。例えば、管理者専用のプログラムは<literal>admin</literal> 、プログラムツールは <literal>devel</literal>、文書作成関連は <literal>doc</literal>、ライブラリーは <literal>libs</literal>、メールリーダやメールデーモンは <literal>mail</literal>、ネットワーク関連のアプリケーションやデーモンは <literal>net</literal>、分類ができないX11用のプログラムは <literal>x11</literal>に分類され、他にも様々なセクションがあります。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Let's change it then to x11.  (A <literal>main/</literal> prefix is implied so we can omit it.)
ja: ここではx11に変更してみましょう。(省略時は<literal>main/</literal>がデフォルトとして設定されます)

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 "Priorities"</ulink>.
ja: <ulink url="&policy-priorities;">Debian Policy Manual, 2.5 "Priorities"</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: Line 3 describes how important it is that the user installs this package.  <placeholder type="footnote" id="0"/>
ja: 3行目は、ユーザーが当パッケージをインストールする重要度を示しています。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The <literal>optional</literal> priority will usually work for new packages that do not conflict with others claiming <literal>required</literal>, <literal>important</literal>, or <literal>standard</literal> priority.
ja: <literal>required</literal>、 <literal>important</literal>、<literal>standard</literal>のパッケージと競合しない新規のパッケージの場合は、<literal>optional</literal>で問題ないでしょう。

note: type: Content of: <book><chapter><section><para>
en: Section and priority are used by front-ends like <command>aptitude</command> when they sort packages and select defaults.  Once you upload the package to Debian, the value of these two fields can be overridden by the archive maintainers, in which case you will be notified by email.
ja: セクション (Section) と優先度 (Priority) は<command>aptitude</command>のようなフロントエンドがパッケージをソートする際と、デフォルトを選択する際に利用されます。Debian にアップロードしたパッケージのこれらの値は、アーカイブメンテナーによってオーバーライドされることがありますが、その場合は電子メールによって通知されます。

note: type: Content of: <book><chapter><section><para>
en: As this is a normal priority package and doesn't conflict with anything else, we will change the priority to <literal>optional</literal>.
ja: このパッケージは通常の優先度で、競合もないので、 <literal>optional</literal>にしましょう。

note: type: Content of: <book><chapter><section><para>
en: Line 4 is the name and email address of the maintainer.  Make sure that this field includes a valid <literal>To</literal> header for email, because after you upload it, the bug tracking system will use it to deliver bug emails to you.  Avoid using commas, ampersands, or parentheses.
ja: 4行目は、メンテナーの名前と電子メールアドレスです。バグ追跡システムは、このフィールドに記載された宛先へユーザーからのバグ報告を送信するので、このフィールドは有効な電子メールの <literal>To</literal> ヘッダーを含むようにしましょう。コンマ「<literal>,</literal>」、アンド記号「<literal>&amp;</literal>」、丸括弧「<literal>()</literal>」は使用しないでください。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;#s-sourcebinarydeps">Debian Policy Manual, 7.7 "Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep"</ulink>.
ja: <ulink url="&policy-relationships;#s-sourcebinarydeps">Debian Policy Manual, 7.7 "Relationships between source and binary packages - Build-Depends, Build-Depends-Indep, Build-Conflicts, Build-Conflicts-Indep"</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: Line 5 includes the list of packages required to build your package as the <literal>Build-Depends</literal> field.  You can also have the <literal>Build-Depends-Indep</literal> field as an additional line here.  <placeholder type="footnote" id="0"/> Some packages like <systemitem role="package">gcc</systemitem> and <systemitem role="package">make</systemitem> which are required by the <systemitem role="package">build-essential</systemitem> package are implied.  If you need to have other tools to build your package, you should add them to these fields.  Multiple entries are separated with commas; read on for the explanation of binary package dependencies to find out more about the syntax of these lines.
ja: 5行目の<literal>Build-Depends</literal>フィールドは、新規パッケージのビルドに必要なパッケージのリストです。必要であれば、<literal>Build-Depends-Indep</literal>フィールドをここに追加できます。<placeholder type="footnote" id="0"/> <systemitem role="package">gcc</systemitem>や<systemitem role="package">make</systemitem>のような<systemitem role="package">build-essential</systemitem>に含まれるパッケージは明示無くとも含まれています。他のツールがパッケージをビルドするのに必要な場合は、このフィールドに追加しましょう。複数記載する場合は、コンマで区切ります。このフィールドの書式については、後述のバイナリーパッケージ依存関係でこれらの行のシンタクスに関してもう少し詳しく説明します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For all packages packaged with the <command>dh</command> command in the <filename>debian/rules</filename> file, you must have <literal>debhelper (&gt;=9)</literal> in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
ja: <filename>debian/rules</filename>を使用し、<command>dh</command>コマンドでパッケージングされたパッケージは、<literal>clean</literal>ターゲットに関するDebian ポリシーを満たすために、<literal>Build-Depends</literal>フィールドに<literal>debhelper (&gt;=9)</literal> を記載しなければなりません。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Source packages which have binary packages with <literal>Architecture: any</literal> are rebuilt by the autobuilder.  Since this autobuilder procedure installs only the packages listed in the <literal>Build-Depends</literal> field before running <literal>debian/rules build</literal> (see <xref linkend="autobuilder"/>), the <literal>Build-Depends</literal> field needs to list practically all the required packages, and <literal>Build-Depends-Indep</literal> is rarely used.
ja: <literal>Architecture: any</literal> のバイナリーパッケージを含むソースパッケージはオートビルダーによってリビルトされます。オートビルダーは <literal>debian/rules build</literal> を実行します。その際に、<literal>Build-Depends</literal> フィールド (<xref linkend="autobuilder"/> を参照)に列挙されたパッケージしかインストールしないので、<literal>Build-Depends</literal> フィールドには事実上必要なパッケージ全てを列挙しなければなりません。 <literal>Build-Depends-indep</literal> はあまり使われません。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For source packages with binary packages all of which are <literal>Architecture: all</literal>, the <literal>Build-Depends-Indep</literal> field may list all the required packages unless they are already listed in the <literal>Build-Depends</literal> field to satisfy the Debian Policy requirement for the <literal>clean</literal> target.
ja: バイナリーパッケージが全て <literal>Architecture: all</literal> のソースパッケージでは、<literal>clean</literal> ターゲットに関する Debian ポリシーを満たすために <literal>Build-Depends</literal> フィールドにすでに記載したパッケージ以外で必要なパッケージは、<literal>Build-Depends-Indep</literal>フィールドに記載することもできます。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This somewhat strange situation is a feature well documented in the <ulink url="&policy-build-depends-indep;">Debian Policy Manual, Footnotes 55</ulink>.  This is not due to the use of the <command>dh</command> command in the <filename>debian/rules</filename> file but due to how the <command>dpkg-buildpackage</command> works.  The same situation applies to the <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">auto build system for Ubuntu</ulink>.
ja: この少し変な状況は<ulink url="&policy-build-depends-indep;">Debian Policy Manual, Footnotes 55</ulink>で詳しく説明されている特徴です。これは、<filename>debian/rules</filename> ファイル内の <command>dh</command> コマンドではなく、<command>dpkg-buildpackage</command> に起因します。同様の状況は <ulink url="https://bugs.launchpad.net/launchpad-buildd/+bug/238141">auto build system for Ubuntu</ulink> にも当てはまります。

note: type: Content of: <book><chapter><section><para>
en: If you are not sure which one should be used, use the <literal>Build-Depends</literal> field to be on the safe side.  <placeholder type="footnote" id="0"/>
ja: どちらのフィールドを使えうべきかわからなければ、<literal>Build-Depends</literal>にしておきましょう。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: To find out what packages your package needs to be built run the command:
ja: 以下のコマンドを使えば、新規のパッケージをビルドするためにどのパッケージが必要かを調べることができます:

note: type: Content of: <book><chapter><section><para>
en: To manually find exact build dependencies for <command><replaceable>/usr/bin/foo</replaceable></command>, execute
ja: <command><replaceable>/usr/bin/foo</replaceable></command>の正確なビルド依存パッケージを手動でみつけるには、

note: type: Content of: <book><chapter><section><para>
en: and for each library listed (e.g., <command>libfoo.so.6</command>), execute
ja: を実行し、表示された各ライブラリー（例えば<command>libfoo.so.6</command>の場合）について、

note: type: Content of: <book><chapter><section><para>
en: Then just take the <literal>-dev</literal> version of every package as a <literal>Build-Depends</literal> entry.  If you use <command>ldd</command> for this purpose, it will report indirect lib dependencies as well, resulting in the problem of excessive build dependencies.
ja: を実行します。<literal>Build-Depends</literal> の項目に、各ライブラリーの<literal>-dev</literal>バージョンを採用します。このために <command>ldd</command> を使用すると、間接的な依存も報告し、過度のビルド依存問題を引き起こします。

note: type: Content of: <book><chapter><section><para>
en: <systemitem role="package">gentoo</systemitem> also happens to require <systemitem role="package">xlibs-dev</systemitem>, <systemitem role="package">libgtk1.2-dev</systemitem> and <systemitem role="package">libglib1.2-dev</systemitem> to build, so we'll add them here next to <systemitem role="package">debhelper</systemitem>.
ja: <systemitem role="package">gentoo</systemitem>パッケージをビルドするには<systemitem role="package">xlibs-dev</systemitem>、<systemitem role="package">libgtk1.2-dev</systemitem>、 <systemitem role="package">libglib1.2-dev</systemitem>が必要なので、<systemitem role="package">debhelper</systemitem>の後に記述しましょう。

note: type: Content of: <book><chapter><section><para>
en: Line 6 is the version of the <ulink url="&debian-policy;">Debian Policy Manual</ulink> standards this package follows, the one you read while making your package.
ja: 6行目は、パッケージが準拠する<ulink url="&debian-policy;">Debian Policy Manual</ulink> のバージョンです。これは、あなたがパッケージ作成の際に参照したポリシーマニュアルのバージョンです。

note: type: Content of: <book><chapter><section><para>
en: On line 7 you can put the URL of the software's upstream homepage.
ja: 7行目にはソフトウェアのアップストリームホームページ URL を記載できます。

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the name of the binary package.  This is usually the same as the name of the source package, but it doesn't necessarily have to be that way.
ja: 9行目はバイナリーパッケージの名前です。ソースパッケージと同名にするのが通例ですが、そうでなくてもかまいません。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink> for exact details.
ja: 詳細は <ulink url="&policy-architecture;">Debian Policy Manual, 5.6.8 "Architecture"</ulink>  を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: Line 10 describes the architectures the binary package can be compiled for.  This value is usually one of the following depending on the type of the binary package: <placeholder type="footnote" id="0"/>
ja: 10 行目にはバイナリーパッケージがコンパイルされる対象のアーキテクチャーを記載します。この値はバイナリーパッケージのタイプによって通常以下の 2 つのどちらかです: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture dependent one usually in a compiled language.
ja: 生成されるバイナリーパッケージが通常コンパイルされたマシンコードからなるアーキテクチャー依存パッケージである。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: The generated binary package is an architecture independent one usually consisting of text, images, or scripts in an interpreted language.
ja: 生成されたバイナリーパッケージは、通常テキストやイメージやインタープリター言語のスクリプトからなる、アーキテクチャー依存の無いパッケージである。

note: type: Content of: <book><chapter><section><para>
en: We leave line 10 as is since this is written in C.  <citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> will fill in the appropriate architecture value for any machine this source package gets compiled on.
ja: 10行目はこれが C で書かれているのでこのままにしておきます。<citerefentry><refentrytitle>dpkg-gencontrol</refentrytitle><manvolnum>1</manvolnum></citerefentry> がソースパッケージがコンパイルされたマシンに合わせた適正なアーキテクチャーの値で埋めてくれます。

note: type: Content of: <book><chapter><section><para>
en: If your package is architecture independent (for example, a shell or Perl script, or a document), change this to <literal>all</literal>, and read later in <xref linkend="rules"/> about using the <literal>binary-indep</literal> rule instead of <literal>binary-arch</literal> for building the package.
ja: 特定のアーキテクチャーに依存しない(例えば、シェルやPerlスクリプト、文書)パッケージであれば、パッケージをビルドする際に、これを <literal>all</literal> に変更し、<literal>binary-arch</literal> に代え <literal>binary-indep</literal> を使って後述の <xref linkend="rules"/> を読んでください。

note: type: Content of: <book><chapter><section><para>
en: Line 11 shows one of the most powerful features of the Debian packaging system.  Packages can relate to each other in various ways.  Apart from <literal>Depends</literal>, other relationship fields are <literal>Recommends</literal>, <literal>Suggests</literal>, <literal>Pre-Depends</literal>, <literal>Breaks</literal>, <literal>Conflicts</literal>, <literal>Provides</literal>, and <literal>Replaces</literal>.
ja: 11行目からはDebianのパッケージシステムが強力なことがわかります。パッケージは様々な形で相互に関係することができます。<literal>Depends</literal>の他には、<literal>Recommends</literal>、 <literal>Suggests</literal>、<literal>Pre-Depends</literal>、<literal>Breaks</literal>、 <literal>Conflicts</literal>、<literal>Provides</literal>、<literal>Replaces</literal>などがあります。

note: type: Content of: <book><chapter><section><para>
en: The package management tools usually behave the same way when dealing with these relations; if not, it will be explained.  (See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dselect</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>aptitude</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, etc.)
ja: パッケージ管理ツールは通常このような関係を処理するとき同様の動作をします。そうでない場合については、後から説明します。(<citerefentry><refentrytitle>dpkg</refentrytitle><manvolnum>8</manvolnum></citerefentry>、<citerefentry><refentrytitle>dselect</refentrytitle><manvolnum>8</manvolnum></citerefentry>、<citerefentry><refentrytitle>apt</refentrytitle> <manvolnum>8</manvolnum></citerefentry>、<citerefentry><refentrytitle>aptitude</refentrytitle><manvolnum>1</manvolnum></citerefentry> 等を参照してください。)

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&policy-relationships;">Debian Policy Manual, 7 "Declaring relationships between packages"</ulink>.
ja: <ulink url="&policy-relationships;">Debian Policy Manual, 7 "Declaring relationships between packages"</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: Here is a simplified description of package relationships: <placeholder type="footnote" id="0"/>
ja: パッケージの依存関係を単純化し以下に説明します: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Depends</literal>
ja: <literal>Depends (依存)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed unless the packages it depends on are installed.  Use this if your program absolutely will not run (or will cause severe breakage) unless a particular package is present.
ja: 依存しているパッケージがインストールされない限り、パッケージはインストールされません。あなたのプログラムが特定のパッケージ無しでは動かない(または深刻な破損を引き起こす)場合はこれを使います。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Recommends</literal>
ja: <literal>Recommends (推奨)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages that are not strictly necessary but are typically used with your program.  When a user installs your program, all front-ends will probably prompt them to install the recommended packages.  <command>aptitude</command> and <command>apt-get</command> install recommended packages along with your package by default (but the user can disable this behavior).  <command>dpkg</command> will ignore this field.
ja: 厳密には必須ではないけれど通常一緒に使われるようなパッケージの指定にこれを用います。あなたのプログラムをユーザーがインストールする時、全てのフロントエンドは推奨パッケージも一緒にインストールするかをきっと確認します。<command>aptitude</command> や <command>apt-get</command> の場合は、推奨パッケージもデフォルトで一緒にインストールします。(ユーザーはこの挙動を無効化できます。) <command>dpkg</command>はこのフィールドを無視します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Suggests</literal>
ja: <literal>Suggests (提案)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this for packages which will work nicely with your program but are not at all necessary.  When a user installs your program, they will probably not be prompted to install suggested packages.  <command>aptitude</command> can be configured to install suggested packages along with your package but this is not its default.  <command>dpkg</command> and <command>apt-get</command> will ignore this field.
ja: 必須ではないが、一緒に使用すると便利なパッケージの指定にこれを用います。あなたのプログラムをユーザーがインストールする時、フロントエンドが提案パッケージも一緒にインストールするかきっと確認します。<command>aptitude</command> は提案パッケージを一緒にインストールするように変更することが可能ですが、デフォルトではありません。<command>dpkg</command> と <command>apt-get</command> はこのフィールドを無視します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Pre-Depends</literal>
ja: <literal>Pre-Depends (事前依存)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is stronger than <literal>Depends</literal>.  The package will not be installed unless the packages it pre-depends on are installed and <emphasis>correctly configured</emphasis>.  Use this <emphasis>very</emphasis> sparingly and only after discussing it on the <ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink> mailing list.  Read: don't use it at all.  :-)
ja: これは <literal>Depends</literal> よりも強い関係を示します。パッケージは先行依存のパッケージがあらかじめインストールされ、かつ<emphasis>適切に設定</emphasis>されていない限りインストールされません。これは、メーリングリスト<ulink url="&debian-devel-ldo;">debian-devel@lists.debian.org</ulink>で議論を尽くした上で、<emphasis>とても</emphasis>慎重に扱うべきです。つまり、使わないでください。:-)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Conflicts</literal>
ja: <literal>Conflicts (競合)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: The package will not be installed until all the packages it conflicts with have been removed.  Use this if your program absolutely will not run or will cause severe problems if a particular package is present.
ja: 競合しているパッケージが削除されない限り、パッケージはインストールされません。あなたのプログラムが特定のパッケージと一緒だと動かない（または深刻な破壊の原因になる恐れがある）場合はこれを使います。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Breaks</literal>
ja: <literal>Breaks (破壊)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: When installed the package will break all the listed packages.  Normally a <literal>Breaks</literal> entry specifies that it applies to versions earlier than a certain value.  The resolution is generally to use higher-level package management tools to upgrade the listed packages.
ja: パッケージがインストールされると、全てのリストされたパッケージを破壊します。通常、<literal>Breaks</literal> の項目は特定の値より旧いバージョンに対して規定します。通常、上位パッケージマネジメントツールを用い、記載されたパッケージをアップグレードし解決します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Provides</literal>
ja: <literal>Provides (提供)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: For some types of packages where there are multiple alternatives, virtual names have been defined.  You can get the full list in the <ulink url="&virtual-package;">virtual-package-names-list.txt.gz</ulink> file.  Use this if your program provides a function of an existing virtual package.
ja: パッケージによっては、選択の余地があるために、仮想パッケージ名が定義されています。仮想パッケージ名の一覧は <ulink url="&virtual-package;">virtual-package-names-list.txt.gz</ulink> にあります。あなたのプログラムが既存の仮想パッケージの機能を提供する場合には、これを使います。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>Replaces</literal>
ja: <literal>Replaces (置換)</literal>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use this when your program replaces files from another package, or completely replaces another package (used in conjunction with <literal>Conflicts</literal>).  Files from the named packages will be overwritten with the files from your package.
ja: あなたのプログラムが別パッケージのファイルを置き換えたり、パッケージ全体を完全に置き換えてしまう場合（この場合は <literal>Conflicts</literal> も一緒に指定してください）この指定を使います。ここで指定されたパッケージに含まれるファイルはあなたのパッケージのファイルによって上書きされます。

note: type: Content of: <book><chapter><section><para>
en: All these fields have uniform syntax.  They are a list of package names separated by commas.  These package names may also be lists of alternative package names, separated by vertical bar symbols <literal>|</literal> (pipe symbols).
ja: これらのフィールドは共通の書式で記述します。指定したいパッケージ名をコンマで区切って並べます。もし選択肢があれば、それらのパッケージ名を縦棒<literal>|</literal> (パイプ記号)で区切って並べます。

note: type: Content of: <book><chapter><section><para>
en: The fields may restrict their applicability to particular versions of each named package.  The restriction of each individual package is listed in parentheses after its name, and should contain a relation from the list below followed by a version number value.  The relations allowed are: <literal>&lt;&lt;</literal>, <literal>&lt;=</literal>, <literal>=</literal>, <literal>&gt;=</literal>, and <literal>&gt;&gt;</literal> for strictly lower, lower or equal, exactly equal, greater or equal, and strictly greater, respectively.  For example,
ja: これらフィールドは、各指定パッケージの特定バージョン番号に適用対象を制限できます。各個別パッケージへの制約はパッケージ名の後に丸カッコの中に以下の関係式に続けバージョン番号を指定しリストします。使用できる関係式は、<literal>&lt;&lt;</literal> と <literal>&lt;=</literal> と <literal>=</literal> と <literal>&gt;=</literal> と <literal>&gt;&gt;</literal> で、それぞれ 「指定されたものより古いバージョンのみ」、 「指定されたバージョン以前」(指定のバージョンも当然含まれます)、 「指定のバージョンのみ」、「指定されたバージョン以降」(指定のバージョンも当然含まれます)、「指定されたものより新しいバージョンのみ」を意味します。例えば、

note: type: Content of: <book><chapter><section><para>
en: The last feature you need to know about is <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
ja: 知っておくべき最後の特徴は <literal>${shlibs:Depends}</literal> や <literal>${perl:Depends}</literal> や <literal>${misc:Depends}</literal> 等です。

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates shared library dependencies for binary packages.  It generates a list of <ulink url="&elf;">ELF</ulink> executables and shared libraries it has found for each binary package.  This list is used for substituting <literal>${shlibs:Depends}</literal>.
ja: <citerefentry> <refentrytitle>dh_shlibdeps</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>は、バイナリーパッケージのライブラリー依存関係を計算します。それは各バイナリーパッケージ毎に、<ulink url="&elf;">ELF</ulink> 実行可能ファイルや共有ライブラリーのリストを生成します。このようなリストは <literal>${shlibs:Depends}</literal> の置換に利用されます。

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> calculates Perl dependencies.  It generates a list of a dependencies on <literal>perl</literal> or <literal>perlapi</literal> for each binary package.  This list is used for substituting <literal>${perl:Depends}</literal>.
ja: <citerefentry> <refentrytitle>dh_perl</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>は、Perl依存関係を計算します。それは各バイナリーパッケージ毎に、<literal>perl</literal> や <literal>perlapi</literal> の依存関係リストを生成します。このようなリストは <literal>${perl:Depends}</literal> の置換に利用されます。

note: type: Content of: <book><chapter><section><para>
en: Some <systemitem role="package">debhelper</systemitem> commands may cause the generated package to depend on some additional packages.  All such commands generate a list of required packages for each binary package.  This list is used for substituting <literal>${misc:Depends}</literal>.
ja: 一部の <systemitem role="package">debhelper</systemitem> コマンドは、生成するパッケージが他追加パッケージに依存するようにパッケージを生成します。このようなコマンド全ては、各バイナリーパッケージが必要とするパッケージのリストを生成します。このようなリストは <literal>${misc:Depends}</literal> の置換に利用されます。

note: type: Content of: <book><chapter><section><para>
en: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> generates <filename>DEBIAN/control</filename> for each binary package while substituting <literal>${shlibs:Depends}</literal>, <literal>${perl:Depends}</literal>, <literal>${misc:Depends}</literal>, etc.
ja: <citerefentry> <refentrytitle>dh_gencontrol</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> が <literal>${shlibs:Depends}</literal>、<literal>${perl:Depends}</literal>、<literal>${misc:Depends}</literal> 等を置換しながら各バイナリーパッケージ毎に <filename>DEBIAN/control</filename> を生成します。

note: type: Content of: <book><chapter><section><para>
en: Having said all that, we can leave the <literal>Depends</literal> field exactly as it is now, and insert another line after it saying <literal>Suggests: file</literal>, because <systemitem role="package">gentoo</systemitem> can use some features provided by the <systemitem role="package">file</systemitem> package.
ja: とは言っても、今のところ <literal>Depends</literal> フィールドはそのままにして、その下に <literal>Suggests: file</literal> という新たな行を追加しましょう。<systemitem role="package">gentoo</systemitem> は <systemitem role="package">file</systemitem> パッケージによって提供される機能を利用することができるからです。

note: type: Content of: <book><chapter><section><para>
en: Line 9 is the Homepage URL.  Let's assume this to be at <ulink url="&gentoo;"/>.
ja: 9 行目はホームページの URLです。これが <ulink url="&gentoo;"/> と仮定しましょう。

note: type: Content of: <book><chapter><section><para>
en: Line 12 is the short description.  Terminals are conventionally 80 columns wide so this shouldn't be longer than about 60 characters.  I'll change it to <literal>fully GUI-configurable, two-pane X file manager</literal>.
ja: 12行目は手短な説明です。従来ターミナルは 1 行（半角）80 文字幅なので、(半角)60字以上にならないようにしましょう。<literal>fully GUI-configurable, two-pane X file manager</literal> に変更します。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: These descriptions are in English.  Translations of these descriptions are provided by <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink>.
ja: これらの説明は英語です。これらの説明の翻訳は <ulink url="&ddtp;">The Debian Description Translation Project - DDTP</ulink> によって提供されています。

note: type: Content of: <book><chapter><section><para>
en: Line 13 is where the long description goes.  This should be a paragraph which gives more details about the package.  Column 1 of each line should be empty.  There must be no blank lines, but you can put a single <literal>.</literal> (dot) in a column to simulate that.  Also, there must be no more than one blank line after the long description. <placeholder type="footnote" id="0"/>
ja: 13行目は詳細な説明です。これはパッケージについてより詳しく説明する1つの段落であるべきです。各行の先頭は空白（スペース文字）で始めます。空白行を入れてはいけませんが、 <literal>.</literal> (半角ピリオド) を1つ書くことで、空白行のように見せることができます。説明文の後にも１行以上の空白行を入れてはいけません。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-bpp-vcs;">Debian Developer's Reference, 6.2.5. "Version Control System location"</ulink>.
ja: <ulink url="&devref-bpp-vcs;">Developer's Reference, 6.2.5. "Version Control System location"</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: We can insert <literal>Vcs-*</literal> fields to document the Version Control System (VCS) location between lines 6 and 7.  <placeholder type="footnote" id="0"/> Let's assume that the <systemitem role="package">gentoo</systemitem> package has its VCS located in the Debian Alioth Git Service at <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal>.
ja: 6行目と7行目の間に <literal>Vcs-*</literal>フィールドを追加しバージョン管理システム (VCS) の場所を記録しましょう。<placeholder type="footnote" id="0"/> <systemitem role="package">gentoo</systemitem>パッケージがその VCS アーカイブを <literal>git://git.debian.org/git/collab-maint/gentoo.git</literal> の Debian Alioth Git Service に置いていると仮定しましょう。

note: type: Content of: <book><chapter><section><para>
en: Finally, here is the updated <filename>control</filename> file:
ja: 以下が修正後の<filename>control</filename> ファイルです:

note: type: Content of: <book><chapter><section><para>
en: This file contains information about the copyright and license of the upstream sources.  <ulink url="&policy-copyright;">Debian Policy Manual, 12.5 "Copyright information"</ulink> dictates its content and <ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> provides guidelines for its format.
ja: このファイルにパッケージのアップストリームソースに関する著作権やライセンスなどの情報を記載します。その内容は <ulink url="&policy-copyright;">Debian Policy Manual, 12.5 "Copyright information"</ulink> に規定され、<ulink url="&dep5;">DEP-5: Machine-parseable <filename>debian/copyright</filename></ulink> がそのフォーマットのガイドラインを提供しています。

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> can give you a template <filename>copyright</filename> file.  Let's use the <literal>--copyright gpl2</literal> option here to get a template file for the <systemitem role="package">gentoo</systemitem> package released under GPL-2.
ja: <command>dh_make</command>は<filename>copyright</filename>ファイルのテンプレートを作成します。GPL-2でリリースされた<systemitem role="package">gentoo</systemitem>パッケージのテンプレートを入手するには、<literal>--copyright gpl2</literal>オプションを使用します。

note: type: Content of: <book><chapter><section><para>
en: In short, here's what <systemitem role="package">gentoo</systemitem>'s <filename>copyright</filename> file should look like:
ja: つまり、<systemitem role="package">gentoo</systemitem> パッケージの <filename>copyright</filename> ファイルは以下のようになります:

note: type: Content of: <book><chapter><section><para>
en: Please follow the HOWTO provided by the ftpmasters and sent to debian-devel-announce: <ulink url="&howto-copyright;"/>.
ja: ftpmasterにより提供され debian-devel-announce に投稿された手順書 <ulink url="&howto-copyright;"/> に従って下さい。

note: type: Content of: <book><chapter><section><para>
en: This is a required file, which has a special format described in <ulink url="&policy-dpkgchangelog;">Debian Policy Manual, 4.4 "debian/changelog"</ulink>.  This format is used by <command>dpkg</command> and other programs to obtain the version number, revision, distribution, and urgency of your package.
ja: これは必須のファイルで、<ulink url="&policy-dpkgchangelog;">Debian Policy Manual, 4.4 "debian/changelog"</ulink>で既定された特別な書式となっています。この書式は、<command>dpkg</command> やその他のプログラムが、パッケージの バージョン番号、リビジョン、ディストリビューション、緊急度 (urgency) を識別するために利用します。

note: type: Content of: <book><chapter><section><para>
en: For you, it is also important, since it is good to have documented all changes you have done.  It will help people downloading your package to see whether there are issues with the package that they should know about.  It will be saved as <filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename> in the binary package.
ja: あなたが行なったすべての変更をきちんと記載しておくことは良いことであり、その意味でこのファイルはまた、パッケージメンテナーであるあなたにとっても重要なものです。パッケージをダウンロードした人は、 このファイルを見ることで、このパッケージに関する未解決の問題があるかどうかを知ることができます。このファイルはバイナリーパッケージ中に<filename>/usr/share/doc/gentoo/changelog.Debian.gz</filename>として保存されます。

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one, and this is what it looks like:
ja: <command>dh_make</command>がデフォルトを生成し、以下のようになっています:

note: type: Content of: <book><chapter><section><para>
en: Line 1 is the package name, version, distribution, and urgency.  The name must match the source package name; distribution should be <literal>unstable</literal>, and urgency should be set to medium unless there is any particular reason for other values.
ja: 1 行目はパッケージ名、バージョン、ディストリビューション、 そして緊急度です。ここに書くパッケージ名はソースパッケージの名前と一致していなければ なりません。 またディストリビューションは <literal>unstable</literal> で、緊急度は<literal>low</literal>より高くしてはいけません。:-)

note: type: Content of: <book><chapter><section><para>
en: Lines 3-5 are a log entry, where you document changes made in this package revision (not the upstream changes &#x2014; there is a special file for that purpose, created by the upstream authors, which you will later install as <filename>/usr/share/doc/gentoo/changelog.gz</filename>).  Let's assume your ITP (Intent To Package) bug report number was <literal>12345</literal>.  New lines must be inserted just below the uppermost line that begins with <literal>*</literal> (asterisk).  You can do it with <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  You can edit this manually with a text editor as long as you follow the formatting convention used by the <citerefentry> <refentrytitle>dch</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ja: 3-5 行目はログ項目で、このパッケージのリビジョンで行われた変更を記述します (アップストリームプログラムそのものの変更点では ありません - その目的のためには、アップストリーム作者によって作成され、 <filename>/usr/share/doc/gentoo/changelog.gz</filename>としてインストールされる 専用のファイルが存在しています)。ITP (Intent To Package) バグレポート番号を <literal>12345</literal> と仮定しましょう。新しい行は <literal>*</literal> (アスタリスク)で始まる最初の行の直前に挿入します。この操作は <citerefentry><refentrytitle>dch</refentrytitle><manvolnum>1</manvolnum></citerefentry> を使うと便利ですが、 テキストエディタを使って実行してももちろん構いません。

note: type: Content of: <book><chapter><section><para>
en: In order to prevent a package being accidentally uploaded before completing the package, it is a good idea to change the distribution value to an invalid distribution value of <literal>UNRELEASED</literal>.
ja: パッケージの完成前にパッケージが間違ってアップロードされることを防ぐために、ディストリビューションの値を無効な値 <literal>UNRELEASED</literal> に変更するよう推奨します。

note: type: Content of: <book><chapter><section><para>
en: You will end up with something like this:
ja: 最終的にこんなふうになります:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: If you use the <literal>dch -r</literal> command to make this last change, please make sure to save the <filename>changelog</filename> file explicitly by the editor.
ja: もし <literal>dch -r</literal> コマンドを使ってこの最終変更をする場合には、エディターにより <filename>changelog</filename> ファイルを明示的に保存して下さい。

note: type: Content of: <book><chapter><section><para>
en: Once you are satisfied with all the changes and documented them in <filename>changelog</filename>, you should change the distribution value from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).  <placeholder type="footnote" id="0"/>
ja: すべての変更に満足しそれらを <filename>changelog</filename> 記録した時点で、ディストリビューションの値を <literal>UNRELEASED</literal> からターゲットディストリビューションの値 <literal>unstable</literal> (もしくは 場合に依っては <literal>experimental</literal>) へと変更すべきです。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You can read more about updating the <filename>changelog</filename> file later in <xref linkend="update"/>.
ja: <filename>changelog</filename>の更新については、<xref linkend="update"/> で詳しく説明します。

note: type: Content of: <book><chapter><section><para>
en: Now we need to take a look at the exact rules that <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> will use to actually create the package.  This file is in fact another <filename>Makefile</filename>, but different from the one(s) in the upstream source.  Unlike other files in <filename>debian</filename>, this one is marked as executable.
ja: さて、今度は <citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> が実際にパッケージを作成するために使うルールについて見ていきましょう。このファイルは、もうひとつの <filename>Makefile</filename> といった存在ですが、アップストリームソースに含まれるそれとは違います。<filename>debian</filename> ディレクトリーに含まれる他のファイルとは異なり、 このファイルには実行可能属性が付与されています。

note: type: Content of: <book><chapter><section><section><title>
en: Targets of the <filename>rules</filename> file
ja: <filename>rules</filename> ファイルのターゲット

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: You can start learning how to write a <filename>Makefile</filename> from <ulink url="&debref-make;">Debian Reference, 12.2. "Make"</ulink>.  The full documentation is available as <ulink url="&gnu-make;"></ulink> or as the <systemitem role="package">make-doc</systemitem> package in the <literal>non-free</literal> archive area.
ja: <ulink url="&debref-make;">Debian Reference, 12.2 "Make"</ulink> から <filename>Makefile</filename> の書き方を学び始められます。<ulink url="&gnu-make;"></ulink> もしくは <literal>non-free</literal> のアーカイブエリアにある <systemitem role="package">make-doc</systemitem> パッケージに完全な説明書があります。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <ulink url="&policy-debianrules;">Debian Policy Manual, 4.9 "Main building script: debian/rules"</ulink> explains the details.
ja: <ulink url="&policy-debianrules;">Debian Policy Manual, 4.9 "Main building script: debian/rules"</ulink> に詳細に説明されています。

note: type: Content of: <book><chapter><section><section><para>
en: Every <filename>rules</filename> file, like any other <filename>Makefile</filename>, consists of several rules, each of which defines a target and how it is carried out.  <placeholder type="footnote" id="0"/> A new rule begins with its target declaration in the first column.  The following lines beginning with the TAB code (ASCII 9) specify the recipe for carrying out that target.  Empty lines and lines beginning with <literal>#</literal> (hash) are treated as comments and ignored.  <placeholder type="footnote" id="1"/>
ja: 他の <filename>Makefile</filename> 同様、全ての <filename>rules</filename> ファイルはいくつかのルールから成り立っていて、そのそれぞれにターゲットと実行方法が規定されます。<placeholder type="footnote" id="0"/> 新規のルールは最初のカラムにそのターゲット宣言をすることで始まります。それに続く TAB コード (ASCII 9) で始まる数行はそのレシピを規定します。空行と <literal>#</literal> (ハッシュ) で始まる行はコメント行として扱われ無視されます。<placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><para>
en: A rule that you want to execute is invoked by its target name as a command line argument.  For example, <literal>debian/rules <replaceable>build</replaceable></literal> and <literal>fakeroot make -f debian/rules <replaceable>binary</replaceable></literal> execute rules for <literal><replaceable>build</replaceable></literal> and <literal><replaceable>binary</replaceable></literal> targets, respectively.
ja: 実行したいルールは、そのターゲット名をコマンドラインの引数として実行します。例えば、 <literal>debian/rules <replaceable>build</replaceable></literal> や <literal>fakeroot make -f debian/rules <replaceable>binary</replaceable></literal> は、それぞれ <literal><replaceable>build</replaceable></literal> や <literal><replaceable>binary</replaceable></literal> ターゲットのルールを実行します。

note: type: Content of: <book><chapter><section><section><para>
en: Here is a simplified explanation of the targets:
ja: ターゲットについて簡単に説明します:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>clean</literal> target: to clean all compiled, generated, and useless files in the build-tree.  (Required)
ja: <literal>clean</literal> ターゲット: ビルドツリー内にある、生成されたりコンパイルされたり役に立たなかったりする全てのファイルをクリーンします。(必須)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build</literal> target: to build the source into compiled programs and formatted documents in the build-tree.  (Required)
ja: <literal>build</literal> ターゲット: ソースをビルドして、ビルドツリー内にコンパイルしたプログラムと書式に落とし込んだドキュメントをビルドします。(必須)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-arch</literal> target: to build the source into arch-dependent compiled programs in the build-tree.  (Required)
ja: <literal>build-arch</literal> ターゲット: ソースをビルドして、ビルドツリー内にアーキテクチャーに依存したコンパイルしたプログラムをビルドします。(必須)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>build-indep</literal> target: to build the source into arch-independent formatted documents in the build-tree.  (Required)
ja: <literal>build-indep</literal> ターゲット: ソースをビルドして、ビルドツリー内にアーキテクチャーに依存しない書式に落とし込んだドキュメントをビルドします。(必須)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>install</literal> target: to install files into a file tree for each binary package under the <filename>debian</filename> directory.  If defined, <literal>binary*</literal> targets effectively depend on this target.  (Optional)
ja: <literal>install</literal> ターゲット: <filename>debian</filename>ディレクトリー以下にある各バイナリーパッケージのファイルツリーにファイルをインストールします。定義されている場合は、<literal>binary*</literal>ターゲットは実質的にこのターゲットに依存します。(任意)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage</literal> as in <xref linkend="completebuild"/>.
ja: このターゲットは例えば、<xref linkend="completebuild"/> などで、<literal>dpkg-buildpackage</literal>が使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary</literal> target: to create all binary packages (effectively a combination of <literal>binary-arch</literal> and <literal>binary-indep</literal> targets).  (Required)<placeholder type="footnote" id="0"/>
ja: <literal>binary</literal> ターゲット: 全てのバイナリーパッケージを作ります。(実質的には <literal>binary-arch</literal> と <literal>binary-indep</literal> の組み合わせ)(必須)<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -B</literal> as in <xref linkend="autobuilder"/>.
ja: このターゲットは例えば、<xref linkend="autobuilder"/> などで、<literal>dpkg-buildpackage -B</literal>が使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-arch</literal> target: to create arch-dependent (<literal>Architecture: any</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
ja: <literal>binary-arch</literal> ターゲット: 親ディレクトリーにアーキテクチャーに依存したバイナリーパッケージ (<literal>Architecture: any</literal>)を作ります。(必須)<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: This target is used by <literal>dpkg-buildpackage -A</literal>.
ja: このターゲットは、 <literal>dpkg-buildpackage -A</literal>が使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>binary-indep</literal> target: to create arch-independent (<literal>Architecture: all</literal>) binary packages in the parent directory.  (Required)<placeholder type="footnote" id="0"/>
ja: <literal>binary-indep</literal> ターゲット: 親ディレクトリーにアーキテクチャーに依存しないパッケージ (<literal>Architecture: all</literal>)  を作ります。(必須)<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>get-orig-source</literal> target: to obtain the most recent version of the original source package from an upstream archive.  (Optional)
ja: <literal>get-orig-source</literal> ターゲット: アップストリームアーカイブのサイトから最新のバージョンのオリジナルソースパッケージを取得します。(任意)

note: type: Content of: <book><chapter><section><section><para>
en: You are probably overwhelmed by now, but things are much simpler upon examination of the <filename>rules</filename> file that <command>dh_make</command> gives us as a default.
ja: 今は少々圧倒されているかもしれませんが、<command>dh_make</command> がデフォルトとして作成する <filename>rules</filename> ファイルを調べると、状況はとても簡単です。

note: type: Content of: <book><chapter><section><section><title>
en: Default <filename>rules</filename> file
ja: デフォルトの<filename>rules</filename>ファイル

note: type: Content of: <book><chapter><section><section><para>
en: Newer <command>dh_make</command> generates a very simple but powerful default <filename>rules</filename> file using the <command>dh</command> command:
ja: 最新の<command>dh_make</command>は<command>dh</command> コマンドでシンプルかつパワフルな<filename>rules</filename>ファイルを作ってくれます:

note: type: Content of: <book><chapter><section><section><para>
en: (I've added the line numbers and trimmed some comments.  In the actual <filename>rules</filename> file, the leading spaces are a TAB code.)
ja: (筆者が行番号を追加しコメントは一部削除した。実際の<filename>rules</filename>ファイルでは、行頭の空白はTABコードです。)

note: type: Content of: <book><chapter><section><section><para>
en: You are probably familiar with lines like line 1 from shell and Perl scripts.  It tells the operating system that this file is to be processed with <filename>/usr/bin/make</filename>.
ja: 1行目はシェルやパールスクリプトでお馴染みの表現です。オペレーティングシステムに<filename>/usr/bin/make</filename>で処理するように指示しています。

note: type: Content of: <book><chapter><section><section><para>
en: Line 4 can be uncommented to set the <literal>DH_VERBOSE</literal> variable to 1, so that the <command>dh</command> command outputs which <command>dh_*</command> commands it is executing.  You can also add a line <literal>export DH_OPTIONS=-v</literal> here, so that each <command>dh_*</command> command outputs which commands it is executing.  This helps you to understand exactly what is going on behind this simple <filename>rules</filename> file and to debug its problems.  This new <command>dh</command> is designed to form a core part of the <systemitem role="package">debhelper</systemitem> tools, and not to hide anything from you.
ja: 4 行目のコメントを外し　<literal>DH_VERBOSE</literal> 変数を 1 に設定すれば、<command>dh</command> コマンドがどの <command>dh_*</command> コマンドを実行しているかを出力するようにできます。必要であればここに、<literal>export DH_OPTIONS=-v</literal>という行を追加すれば、<command>dh_*</command>コマンドが、<command>dh_*</command>によって実行されたコマンドを出力します。この単純な <filename>rules</filename> ファイルが影で何をしているのかを理解し、その問題デバッグの際の助けとなるでしょう。この新しい <command>dh</command> が<systemitem role="package">debhelper</systemitem> ツールの中核から設計され、あなたに対して一切隠し事をしません。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: This uses the new <systemitem role="package">debhelper</systemitem> v7+ features.  Its design concepts are explained in <ulink url="&debhelper-slides;">Not Your Grandpa's Debhelper</ulink> presented at DebConf9 by the <systemitem role="package">debhelper</systemitem> upstream.  Under <literal>lenny</literal>, <command>dh_make</command> created a much more complicated <filename>rules</filename> file with explicit rules and many <command>dh_*</command> scripts listed for each one, most of which are now unnecessary (and show the package's age). The new <command>dh</command> command is simpler and frees us from doing the routine work "manually". You still have full power to customize the process with <literal>override_dh_*</literal> targets. See <xref linkend="customrules"/>.  It is based only on the <systemitem role="package">debhelper</systemitem> package and does not obfuscate the package building process as the <systemitem role="package">cdbs</systemitem> package tends to do.
ja: これは新しい <systemitem role="package">debhelper</systemitem> v7+ の機能です。このデザインコンセプトはDebConf9で <systemitem role="package">debhelper</systemitem> アップストリームによって <ulink url="&debhelper-slides;">Not Your Grandpa's Debhelper</ulink> として提示されました。<literal>lenny</literal> の <command>dh_make</command> は、必須となる明示されたターゲットごとに、もっと複雑な <filename>rules</filename> ファイルと <command>dh_*</command> スクリプトを量産し、最初にパッケージ化した際の状態に凍結していました。新しい <command>dh</command> コマンドは、もっとシンプルで、旧来の「手動」の雑用から開放してくれます。その上、<literal>override_dh_*</literal> ターゲットがあるのでカスタマイズする利便性は失われていません。詳しくは <xref linkend="customrules"/> を参照してください。これは、<systemitem role="package">debhelper</systemitem> パッケージがもとになっており、<systemitem role="package">cdbs</systemitem> のようにパッケージのビルドプロセスを難読化することはありません。

note: type: Content of: <book><chapter><section><section><para>
en: Lines 16 and 17 are where all the work is done with an implicit rule using the pattern rule.  The percent sign means "any targets", which then call a single program, <command>dh</command>, with the target name.  <placeholder type="footnote" id="0"/> The <command>dh</command> command is a wrapper script that runs appropriate sequences of <command>dh_*</command> programs depending on its argument.  <placeholder type="footnote" id="1"/>
ja: 16 と 17 行目は、パターンルールを用いて非明示的ルールで全てが行われる場所です。パーセント記号「<literal>%</literal>」は「いかなるターゲット」を意味し、ターゲットの名前を引数に <command>dh</command> という単一プログラムを実行します。<placeholder type="footnote" id="0"/> <command>dh</command> コマンドは、引数によって、適切なシーケンスで <command>dh_*</command> プログラムを走らせるラッパースクリプトです。<placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>debian/rules clean</literal> runs <literal>dh clean</literal>, which in turn runs the following:
ja: <literal>debian/rules clean</literal> は <literal>dh clean</literal>を実行し、そしてそれは以下を実行します:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>debian/rules build</literal> runs <literal>dh build</literal>, which in turn runs the following:
ja: <literal>debian/rules build</literal> は <literal>dh build</literal> を実行します。実行する順番は以下の通りです:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: The following example assumes your <filename>debian/compat</filename> has a value equal or more than 9 to avoid invoking any python support commands automatically.
ja: 以下の例は、自動的に python サポートコマンドが起動するのを避けるために、あなたの <filename>debian/compat</filename> には 9 以下の値が入っていると仮定しています。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary</literal> runs <literal>fakeroot dh binary</literal>, which in turn runs the following<placeholder type="footnote" id="0"/>:
ja: <literal>fakeroot debian/rules binary</literal> は<placeholder type="footnote" id="0"/>、<literal>fakeroot dh binary</literal>を実行します。実行する順番は以下の通りです:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary-arch</literal> runs <literal>fakeroot dh binary-arch</literal>, which in turn runs the same sequence as <literal>fakeroot dh binary</literal> but with the <literal>-a</literal> option appended for each command.
ja: <literal>fakeroot debian/rules binary-arch</literal> は <literal>fakeroot dh binary-arch</literal> を実行します。<literal>fakeroot dh binary</literal> の全てのコマンドに <literal>-a</literal> オプションをつけた場合と同じことを行います。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <literal>fakeroot debian/rules binary-indep</literal> runs <literal>fakeroot dh binary-indep</literal>, which in turn runs almost the same sequence as <literal>fakeroot dh binary</literal> but excluding <command>dh_strip</command>, <command>dh_makeshlibs</command>, and <command>dh_shlibdeps</command> with the <literal>-i</literal> option appended for each remaining command.
ja: <literal>fakeroot debian/rules binary-indep</literal> は <literal>fakeroot dh binary-indep</literal> を実行します。同様のコマンドは<literal>fakeroot dh binary</literal>ですが、<command>dh_strip</command>、<command>dh_makeshlibs</command>、<command>dh_shlibdeps</command> は実行せず、残りのコマンドには<literal>-i</literal> オプションを付加して実行します。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: For complete information on what all these <command>dh_*</command> scripts do exactly, and what their other options are, please read their respective manual pages and the <systemitem role="package">debhelper</systemitem> documentation.
ja: <command>dh_*</command>スクリプトが、実際に何をして、どのようなオプションがあるのかを知りたい場合は、<systemitem role="package">debhelper</systemitem> のマニュアルにある該当ページを参照してください。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: These commands support other build environments, such as <filename>setup.py</filename>, which can be listed by executing <literal>dh_auto_build --list</literal> in a package source directory.
ja: これらのコマンドは、<literal>dh_auto_build --list</literal>を実行するとリストされる <filename>setup.py</filename> のような他のビルド環境もサポートします。

note: type: Content of: <book><chapter><section><section><para>
en: The functions of <command>dh_*</command> commands are largely self-evident from their names.  <placeholder type="footnote" id="0"/> There are a few notable ones that are worth giving (over)simplified explanations here assuming a typical build environment based on a <filename>Makefile</filename>: <placeholder type="footnote" id="1"/>
ja: <command>dh_*</command>は、名前からその機能がわかるようなものばかりです。<placeholder type="footnote" id="0"/>　ここでは、<filename>Makefile</filename>をもとに作られたビルド環境を前提にして、(超)簡単な説明を行う価値がある特筆すべき項目いくつかについて述べます: <placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>distclean</literal>, <literal>realclean</literal>, or <literal>clean</literal>, and executes that.
ja: 実際には、<filename>Makefile</filename> 中の <literal>distclean</literal>、<literal>realclean</literal>、 <literal>clean</literal> のうち、最初に利用可能なものを探し実行します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_clean</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>distclean</literal> target.  <placeholder type="footnote" id="0"/>
ja: <command>dh_auto_clean</command>は、<filename>Makefile</filename> に <literal>distclean</literal> ターゲットがあれば以下のコマンドを通常実行します。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_configure</command> usually executes the following if <filename>./configure</filename> exists (arguments abbreviated for readability).
ja: <command>dh_auto_configure</command>は、<filename>./configure</filename>があれば以下のコマンドを通常実行します。 (読みやすくするために引数は省略しました)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_build</command> usually executes the following to execute the first target of <filename>Makefile</filename> if it exists.
ja: <command>dh_auto_build</command>は、 <filename>Makefile</filename>があれば、その最初のターゲットをビルドするために、以下のコマンドを通常実行します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: It actually looks for the first available target in the <filename>Makefile</filename> out of <literal>test</literal> or <literal>check</literal>, and executes that.
ja: <filename>Makefile</filename> 中の <literal>test</literal> か <literal>check</literal> のうち、最初に利用可能なものを見つけ実行します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_test</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>test</literal> target.  <placeholder type="footnote" id="0"/>
ja: <command>dh_auto_test</command> は、<filename>Makefile</filename> 中に <literal>test</literal> ターゲットがあれば、以下を通常実行します。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: <command>dh_auto_install</command> usually executes the following if a <filename>Makefile</filename> exists with the <literal>install</literal> target (line folded for readability).
ja: <command>dh_auto_install</command> は、<filename>Makefile</filename> 中に <literal>install</literal> ターゲットがあれば、以下のコマンドを通常実行します。 (読みやすくするために畳み込みました)。

note: type: Content of: <book><chapter><section><section><para>
en: All targets which require the <command>fakeroot</command> command will contain <command>dh_testroot</command>, which exits with an error if you are not using this command to pretend to be root.
ja: <command>fakeroot</command> コマンドを必要とするターゲットは <command>dh_testroot</command> を含みます。このコマンドは、ルートのふりをしなければエラーで終了します。

note: type: Content of: <book><chapter><section><section><para>
en: The important part to know about the <filename>rules</filename> file created by <command>dh_make</command> is that it is just a suggestion.  It will work for most packages but for more complicated ones, don't be afraid to customize it to fit your needs.
ja: <command>dh_make</command> によって作成された <filename>rules</filename> ファイルについて理解すべきことは、これは単なる提案ということです。もっと複雑なパッケージ以外のほぼ全てに有効ですが、必要に応じてカスタマイズをすることを遠慮してはいけません。

note: type: Content of: <book><chapter><section><section><para>
en: Although <literal>install</literal> is not a required target, it is supported.  <literal>fakeroot dh install</literal> behaves like <literal>fakeroot dh binary</literal> but stops after <command>dh_fixperms</command>.
ja: <literal>install</literal> は、必須ターゲットではありませんがサポートはされています。<literal>fakeroot dh install</literal> は <literal>fakeroot dh binary</literal> のように振る舞いますが、<command>dh_fixperms</command> の後で停止します。

note: type: Content of: <book><chapter><section><section><title>
en: Customization of <filename>rules</filename> file
ja: <filename>rules</filename> ファイルのカスタマイズ

note: type: Content of: <book><chapter><section><section><para>
en: There are many ways to customize the <filename>rules</filename> file created with the new <command>dh</command> command.
ja: 新しい<command>dh</command>コマンドで作成された<filename>rules</filename>ファイルをカスタマイズする方法は何通りもあります。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: If a package installs the <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>custom_name</replaceable>.pm</filename> file, you should activate its customization function by <literal>dh $@ --with <replaceable>custom-name</replaceable></literal>.
ja: もし、パッケージが <filename>/usr/share/perl5/Debian/Debhelper/Sequence/<replaceable>custom_name</replaceable>.pm</filename>ファイルをインストールする場合、そのカスタマイズの機能を <literal>dh $@ --with <replaceable>custom-name</replaceable></literal>で有効にしなければなりません。

note: type: Content of: <book><chapter><section><section><para>
en: The <literal>dh $@</literal> command can be customized as follows: <placeholder type="footnote" id="0"/>
ja: <literal>dh $@</literal> コマンドは以下の方法でカスタマイズできます: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para><footnote><para>
en: Use of the <command>dh_python2</command> command is preferred over use of <command>dh_pysupport</command> or <command>dh_pycentral</command> commands.  Do not use the <command>dh_python</command> command.
ja: <command>dh_pysupport</command> や <command>dh_pycentral</command> コマンドよりも<command>dh_python2</command>コマンドが好まれます。<command>dh_python</command>コマンドは使用しないでください。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_python2</command> command.  (The best choice for Python.) <placeholder type="footnote" id="0"/>
ja: <command>dh_python2</command> コマンドのサポートを追加します。(Pythonに最適の選択。)<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python</systemitem> package in <literal>Build-Depends</literal>.
ja: <systemitem role="package">python</systemitem> パッケージを <literal>Build-Depends</literal> に含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python2</literal>.
ja: <literal>dh $@ --with python2</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python</systemitem> framework.
ja: これは <systemitem role="package">python</systemitem>フレームワークを使用してPythonモジュールを取り扱います。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pysupport</command> command. (deprecated)
ja: <command>dh_pysupport</command> コマンドのサポートを追加します。(非推奨)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-support</systemitem> package in <literal>Build-Depends</literal>.
ja: <systemitem role="package">python-support</systemitem> を <literal>Build-Depends</literal> に含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with pysupport</literal>.
ja: <literal>dh $@ --with pysupport</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-support</systemitem> framework.
ja: これで<systemitem role="package">python-support</systemitem>フレームワークを使用してPythonモジュールを利用できます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_pycentral</command> command. (deprecated)
ja: <command>dh_pycentral</command> コマンドのサポートを追加します。(非推奨)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">python-central</systemitem> package in <literal>Build-Depends</literal>.
ja: <literal>Build-Depends</literal> に、<systemitem role="package">python-central</systemitem> パッケージを含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with python-central</literal> instead.
ja: 代わりに<literal>dh $@ --with python-central</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This also deactivates the <command>dh_pysupport</command> command.
ja: これで<command>dh_pysupport</command>コマンドも無効化されます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This handles Python modules using the <systemitem role="package">python-central</systemitem> framework.
ja: これで<systemitem role="package">python-central</systemitem>フレームワークを使用してPythonモジュールを利用できます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_installtex</command> command.
ja: <command>dh_installtex</command> コマンドのサポートを追加します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">tex-common</systemitem> package in <literal>Build-Depends</literal>.
ja: <literal>Build-Depends</literal> に、<systemitem role="package">tex-common</systemitem>パッケージを含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with tex</literal> instead.
ja: 代わりに<literal>dh $@ --with tex</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This registers Type 1 fonts, hyphenation patterns, and formats with TeX.
ja: これで、TeXによるType1フォント、ハイフネーションパターン、またはフォーマットが登録されます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands.
ja: <command>dh_quilt_patch</command> と <command>dh_quilt_unpatch</command> コマンドのサポートを追加します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">quilt</systemitem> package in <literal>Build-Depends</literal>.
ja: <literal>Build-Depends</literal> に、<systemitem role="package">quilt</systemitem> パッケージを含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with quilt</literal> instead.
ja: 代わりに<literal>dh $@ --with quilt</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This applies and un-applies patches to the upstream source from files in the <filename>debian/patches</filename> directory for a source package in the <literal>1.0</literal> format.
ja: <literal>1.0</literal> フォーマットのソースパッケージの <filename>debian/patches</filename> ディレクトリー内にあるファイルを用いて、アップストリームソースにパッチを当てたり外したりできます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This is not needed if you use the new <literal>3.0 (quilt)</literal> source package format.
ja: もし新規の <literal>3.0 (quilt)</literal> ソースパッケージフォーマットを使用している場合、これは不要です。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_dkms</command> command.
ja: <command>dh_dkms</command> コマンドのサポートを追加します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dkms</systemitem> package in <literal>Build-Depends</literal>.
ja: <literal>Build-Depends</literal> に、<systemitem role="package">dkms</systemitem> パッケージを含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with dkms</literal> instead.
ja: 代わりに<literal>dh $@ --with dkms</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This correctly handles DKMS usage by kernel module packages.
ja: カーネルモジュールパッケージによる DKMS の使用を正しく処理します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autotools-dev_updateconfig</command> and <command>dh_autotools-dev_restoreconfig</command> commands.
ja: <command>dh_autotools-dev_updateconfig</command> と <command>dh_autotools-dev_restoreconfig</command> コマンドのサポートを追加します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">autotools-dev</systemitem> package in <literal>Build-Depends</literal>.
ja: <literal>Build-Depends</literal> に、<systemitem role="package">autotools-dev</systemitem> パッケージを含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autotools-dev</literal> instead.
ja: 代わりに <literal>dh $@ --with autotools-dev</literal> を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates and restores <filename>config.sub</filename> and <filename>config.guess</filename>.
ja: これで<filename>config.sub</filename>と<filename>config.guess</filename>をアップデートおよびレストアします。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_autoreconf</command> and <command>dh_autoreconf_clean</command> commands.
ja: <command>dh_autoreconf</command> と <command>dh_autoreconf_clean</command> コマンドのサポートを追加します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Include the <systemitem role="package">dh-autoreconf</systemitem> package in <literal>Build-Depends</literal>.
ja: <literal>Build-Depends</literal> に、<systemitem role="package">dh-autoreconf</systemitem> パッケージを含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with autoreconf</literal> instead.
ja: 代わりに<literal>dh $@ --with autoreconf</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This updates the GNU Build System files and restores them after the build.
ja: これは、ビルド後にGNUビルドシステムのファイルのアップデートおよびレストアを行います。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>dh_girepository</command> command.
ja: <command>dh_girepository</command> コマンドのサポートを追加します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">gobject-introspection</systemitem> package in <literal>Build-Depends</literal>.
ja: <literal>Build-Depends</literal> に、<systemitem role="package">gobject-introspection</systemitem> パッケージを含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with gir</literal> instead.
ja: 代わりに<literal>dh $@ --with gir</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This computes dependencies for packages shipping GObject introspection data and generates the <literal>${gir:Depends}</literal> substitution variable for the package dependency.
ja: これは GObject イントロスペクションデータを提供しているパッケージの依存関係を計算し、パッケージ依存関係用に <literal>${gir:Depends}</literal> 代替変数を生成します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: Add support for the <command>bash</command> completion feature.
ja: <command>bash</command> 補完機能のサポートを追加します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Includes the <systemitem role="package">bash-completion</systemitem> package in <literal>Build-Depends</literal>.
ja: <literal>Build-Depends</literal> に、<systemitem role="package">bash-completion</systemitem> パッケージを含めます。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Use <literal>dh $@ --with bash-completion</literal> instead.
ja: 代わりに<literal>dh $@ --with bash-completion</literal>を使用します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: This installs <command>bash</command> completions using a configuration file at <filename>debian/<replaceable>package</replaceable>.bash-completion</filename>.
ja: このコマンドを使用すると、<command>bash</command> 補完機能から、 <filename>debian/<replaceable>package</replaceable>.bash-completion</filename> の設定を使うことができるようになります。

note: type: Content of: <book><chapter><section><section><para>
en: Many <command>dh_*</command> commands invoked by the new <command>dh</command> command can be customized by the corresponding configuration files in the <filename>debian</filename> directory.  See <xref linkend="dother"/> and the manpage of each command for the customization of such features.
ja: 新しい <command>dh</command> コマンドにより起動される多くの <command>dh_*</command> コマンドは、<filename>debian</filename> ディレクトリー内にある対応する設定ファイルによりカスタマイズすることが可能です。そのような機能のカスタマイズ方法については、 <xref linkend="dother"/> とコマンドごとの manpage を参照してください。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Under <literal>lenny</literal>, if you wanted to change the behavior of a <command>dh_*</command> script you found the relevant line in the <filename>rules</filename> file and adjusted it.
ja: <literal>lenny</literal>では、<command>dh_*</command>スクリプトの挙動を変えたい場合、<filename>rules</filename>ファイル内の該当する行を見つけ出し、調整していました。

note: type: Content of: <book><chapter><section><section><para>
en: You may need to run <command>dh_*</command> commands invoked via the new <command>dh</command> with added arguments, or to run additional commands with them, or to skip them.  For such cases, you create an <literal>override_dh_<replaceable>foo</replaceable></literal> target with its rule in the <filename>rules</filename> file defining an <literal>override_dh_<replaceable>foo</replaceable></literal> target for the <command>dh_<replaceable>foo</replaceable></command> command you want to change.  It basically says <emphasis>run me instead</emphasis>.  <placeholder type="footnote" id="0"/>
ja: <command>dh</command>コマンドによって呼び出される<command>dh_*</command>コマンドの中には、特定の引数で実行したり、それらを追加のコマンドとともに実行したり、スキップしたりする必要があることがあります。そのような場合は、変更したい<command>dh_<replaceable>foo</replaceable></command>コマンドについて、<literal>override_dh_<replaceable>foo</replaceable></literal> ターゲットを <filename>rules</filename> ファイルに追記してください。簡単に説明すると、このターゲットは<emphasis>かわりにこのコマンドを使用する</emphasis>という意味です。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: Please note that the <command>dh_auto_*</command> commands tend to do more than what has been discussed in this (over)simplified explanation to take care of all the corner cases.  It is a bad idea to use <literal>override_dh_*</literal> targets to substitute simplified equivalent commands (except for the <literal>override_dh_auto_clean</literal> target) since it may bypass such smart <systemitem role="package">debhelper</systemitem> features.
ja: ここでは簡単に説明を行いましたが、通常以外のケースを処理するため、<command>dh_auto_*</command>コマンドは、もっと複雑なことを実行することを覚えておいてください。そのため、<literal>override_dh_auto_clean</literal>ターゲット以外は、<literal>override_dh_*</literal> ターゲットを使用して、簡素化された別のコマンドで代用するのは感心しません。<systemitem role="package">debhelper</systemitem> の賢い機能を骨抜きにしてしまうからです。

note: type: Content of: <book><chapter><section><section><para>
en: So, for instance, if you want to store system configuration data in the <filename>/etc/gentoo</filename> directory instead of the usual <filename>/etc</filename> directory for the recent <systemitem role="package">gentoo</systemitem> package using Autotools, you can override the default <literal>--sysconfig=/etc</literal> argument given by the <command>dh_auto_configure</command> command to the <command>./configure</command> command by the following:
ja: 例えば、最近の Autotools を用いた <systemitem role="package">gentoo</systemitem>パッケージに関して、その設定情報を通常の <filename>/etc</filename> ディレクトリーではなく、<filename>/etc/gentoo</filename> ディレクトリーに置きたい場合には、<command>dh_auto_configure</command> コマンドが <command>./configure</command> コマンドに与えるデフォルトの引数 <literal>--sysconfig=/etc</literal> を以下のようにしてオーバーライドできます:

note: type: Content of: <book><chapter><section><section><para>
en: The arguments given after <literal>--</literal> are appended to the default arguments of the auto-executed program to override them.  Using the <command>dh_auto_configure</command> command is better than directly invoking the <command>./configure</command> command here since it will only override the <literal>--sysconfig</literal> argument and retain any other, benign arguments to the <command>./configure</command> command.
ja: <literal>--</literal>以下の引数は、自動実行されるプログラムの引数に付け足されます。<command>dh_auto_configure</command> コマンドは、引数<literal>--sysconfig</literal>のみをオーバーライドしその他の良く配慮された <command>./configure</command> 引数には触れないため、<command>./configure</command> コマンドをここに使うより優れています。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: <command>dh_auto_build</command> without any arguments will execute the first target in the <filename>Makefile</filename>.
ja: 引数なしの <command>dh_auto_build</command>は、<filename>Makefile</filename> の最初のターゲットを実行します。

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify <literal>build</literal> as its target to build it <placeholder type="footnote" id="0"/>, you create an <literal>override_dh_auto_build</literal> target to enable this.
ja: もしも <systemitem role="package">gentoo</systemitem> のソースをビルドするためにその <filename>Makefile</filename> に <literal>build</literal> ターゲットを指定する必要がある場合、これを有効とするため、<placeholder type="footnote" id="0"/><literal>override_dh_auto_build</literal> ターゲットを作らなければなりません。

note: type: Content of: <book><chapter><section><section><para>
en: This ensures <literal>$(MAKE)</literal> is run with all the default arguments given by the <command>dh_auto_build</command> command plus the <literal>build</literal> argument.
ja: <command>dh_auto_build</command>コマンドのデフォルトで与えられた引数すべてに <literal>build</literal> 引数を加えたものとともに、<literal>$(MAKE)</literal> を確実に実行します。

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> requires you to specify the <literal>packageclean</literal> target to clean it for the Debian package instead of using <literal>distclean</literal> or <literal>clean</literal> targets, you can create an <literal>override_dh_auto_clean</literal> target to enable it.
ja: もし、Debianパッケージのためにソースをクリーンするのに <systemitem role="package">gentoo</systemitem> のソースの <filename>Makefile</filename> が、<filename>Makefile</filename> 中の <literal>distclean</literal> や <literal>clean</literal> ターゲットの代わりに <literal>packageclean</literal> ターゲットを指定する必要がある場合には、<literal>override_dh_auto_clean</literal> ターゲットを作るとそれが可能になります。

note: type: Content of: <book><chapter><section><section><para>
en: If the <filename>Makefile</filename> in the source for <systemitem role="package">gentoo</systemitem> contains a <literal>test</literal> target which you do not want to run for the Debian package building process, you can use an empty <literal>override_dh_auto_test</literal> target to skip it.
ja: もし、<systemitem role="package">gentoo</systemitem>のソースの<filename>Makefile</filename>が、<literal>test</literal>ターゲットを含み、Debianパッケージをビルドする過程で実行されたくない場合は、空の<literal>override_dh_auto_test</literal>ターゲットを作ることで、スキップできます。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: The <filename>debian/changelog</filename> and <filename>debian/NEWS</filename> files are always automatically installed.  The upstream changelog is found by converting filenames to lower case and matching them against <filename>changelog</filename>, <filename>changes</filename>, <filename>changelog.txt</filename>, and <filename>changes.txt</filename>.
ja: <filename>debian/changelog</filename> と <filename>debian/NEWS</filename> は常に自動でインストールされます。アップストリームの変更履歴は、ファイル名を小文字に変換し、<filename>changelog</filename>、<filename>changes</filename>、<filename>changelog.txt</filename>、<filename>changes.txt</filename>のいずれかと一致するものを見つけます。

note: type: Content of: <book><chapter><section><section><para>
en: If <systemitem role="package">gentoo</systemitem> has an unusual upstream changelog file called <filename>FIXES</filename>, <command>dh_installchangelogs</command> will not install that file by default.  The <command>dh_installchangelogs</command> command requires <filename>FIXES</filename> as its argument to install it.  <placeholder type="footnote" id="0"/>
ja: もし、<systemitem role="package">gentoo</systemitem>パッケージに、普通ではない<filename>FIXES</filename>というアップストリームのチェンジログファイルがある場合、 <command>dh_installchangelogs</command>はデフォルトではそのファイルをインストールしません。このファイルをインストールするには、<filename>FIXES</filename>を引数として、<command>dh_installchangelogs</command>に渡してやる必要があります。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: When you use the new <command>dh</command> command, use of explicit targets such as the ones listed in <xref linkend="targets"/>, other than the <literal>get-orig-source</literal> target, may make it difficult to understand their exact effects.  Please limit explicit targets to <literal>override_dh_*</literal> targets and completely independent ones, if possible.
ja: この新しい <command>dh</command> コマンドを使う際には、<literal>get-orig-source</literal> ターゲットを除き、<xref linkend="targets"/> にあるような明示ターゲット指定の正確な影響が把握するのが難しいかもしれません。明示ターゲットは、<literal>override_dh_*</literal> ターゲットおよび完全に独立したターゲットに限定して下さい。

note: type: Content of: <book><chapter><title>
en: Other files under the <filename>debian</filename> directory
ja: <filename>debian</filename>ディレクトリーにあるその他のファイル

note: type: Content of: <book><chapter><para>
en: To control most of what <systemitem role="package">debhelper</systemitem> does while building the package, you put optional configuration files under the <filename>debian</filename> directory.  This chapter will provide an overview of what each of these does and its format.  Please read the <ulink url="&debian-policy;">Debian Policy Manual</ulink> and <ulink url="&developers-reference;">Debian Developer's Reference</ulink> for guidelines for packaging.
ja: <systemitem role="package">debhelper</systemitem>がパッケージのビルド中に行うことは、オプションの設定ファイルを <filename>debian</filename> ディレクトリーに置けばコントロールできます。この章では、設定ファイルの機能と書式を概説します。パッケージングのガイドラインについての詳細は <ulink url="&debian-policy;">Debian Policy Manual</ulink> と <ulink url="&developers-reference;">Debian Developer's Reference</ulink> を参照してください。

note: type: Content of: <book><chapter><para>
en: Some template configuration files for <systemitem role="package">debhelper</systemitem> may not be created by the <command>dh_make</command> command.  In such cases, you need to create them with an editor.
ja: <command>dh_make</command>コマンドは、一部の <systemitem role="package">debhelper</systemitem>用の設定テンプレートファイルを作らないことがあります。その場合、自分でエディターを使いそれらを作成しなければなりません。

note: type: Content of: <book><chapter><para>
en: If you wish or need to activate any of these, please do the following:
ja: 設定ファイルを有効にしたい際は、以下を実行して下さい:

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: rename the configuration files to use the actual binary package name in place of <literal><replaceable>package</replaceable></literal>;
ja: <literal><replaceable>package</replaceable></literal>の代わりに、実際のバイナリーパッケージの名前に設定ファイルをリネームしてください。

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify template file contents to suit your needs;
ja: 必要に応じて、テンプレートファイルの中身を書き換えます。

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: remove template files which you do not need;
ja: 不要なテンプレートファイルは削除してください。

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>control</filename> file (see <xref linkend="control"/>), if necessary;
ja: 必要であれば、<filename>control</filename> ファイル(参照 <xref linkend="control"/>)を変更します。

note: type: Content of: <book><chapter><itemizedlist><listitem><para>
en: modify the <filename>rules</filename> file (see <xref linkend="rules"/>), if necessary.
ja: 必要なら<filename>rules</filename>ファイル(参照 <xref linkend="rules"/>)を編集してください。

note: type: Content of: <book><chapter><para>
en: Any <systemitem role="package">debhelper</systemitem> configuration files without a <filename><replaceable>package</replaceable></filename> prefix, such as <filename>install</filename>, apply to the first binary package.  When there are many binary packages, their configurations can be specified by prefixing their name to their configuration filenames such as <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
ja: <filename><replaceable>package</replaceable></filename> をプリフィックスとして持たない、例えば <filename>install</filename> のような<systemitem role="package">debhelper</systemitem> の設定ファイルは、最初のバイナリーパッケージへ適用されます。 バイナリーパッケージが多数ある場合、<filename><replaceable>package-1</replaceable>.install</filename>、<filename><replaceable>package-2</replaceable>.install</filename>、等のように、パッケージ名を設定ファイルのプリフィックスとすることで指定できます。

note: type: Content of: <book><chapter><section><para>
en: Any extra details or discrepancies between the original package and your Debian version should be documented here.
ja: パッケージに関して、何か特別にユーザーに知らせなければならない情報や、オリジナルのソフトウェアと作成したDebianパッケージとの相違点があればここに記述します。

note: type: Content of: <book><chapter><section><para>
en: <command>dh_make</command> created a default one; this is what it looks like:
ja: 以下は<command>dh_make</command>がデフォルトとして生成するものです:

note: type: Content of: <book><chapter><section><para>
en: If you have nothing to be documented, remove this file.  See <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ja: もし、ドキュメントがなければこのファイルを削除してください。詳しくは <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>を参照してください。

note: type: Content of: <book><chapter><section><para>
en: The <filename>compat</filename> file defines the <systemitem role="package">debhelper</systemitem> compatibility level.  Currently, you should set it to the <systemitem role="package">debhelper</systemitem> v10 as follows:
ja: <filename>compat</filename> ファイルは、<systemitem role="package">debhelper</systemitem> の互換性レベルを規定します。現段階では、以下のように <systemitem role="package">debhelper</systemitem> v10 に設定しましょう:

note: type: Content of: <book><chapter><section><para>
en: You may use compat level v9 in certain circumstances for compatibility with older systems. However, using any level below v9 is not recommended and should be avoided for new packages.
ja: 一定の環境下では旧システムとのコンパチビリティーのためにcompat レベル v9 を使ってよろしい。しかし、v9 以下の如何なるレベルを使うことは勧められないし、新規パッケージに用いることは避けるべきです。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <ulink url="&policy-conffiles;">Debian Policy Manual, "D.2.5 Conffiles"</ulink>.
ja: <citerefentry> <refentrytitle>dpkg</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and <ulink url="&policy-conffiles;">Debian Policy Manual, "D.2.5 Conffiles"</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: One of the most annoying things about software is when you spend a great deal of time and effort customizing a program, only to have an upgrade stomp all over your changes.  Debian solves this problem by marking such configuration files as conffiles.  <placeholder type="footnote" id="0"/> When you upgrade a package, you'll be asked whether you want to keep your old configuration files or not.
ja: 大変な時間と労力を費やしてプログラムをカスタマイズしても、一回のアップグレードであなたの変更をあちこち上書きされてしまうとうんざりします。このような設定ファイルを conffile と記録しておくことで、Debianはこの問題を解決しました。<placeholder type="footnote" id="0"/> パッケージをアップグレードする際に、あなたは古い設定ファイルをキープしたいかかどうかを尋ねられます。

note: type: Content of: <book><chapter><section><para>
en: <citerefentry><refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> <emphasis>automatically</emphasis> flags any files under the <filename>/etc</filename> directory as conffiles, so if your program only has conffiles there you do not need to specify them in this file.  For most package types, the only place conffiles should ever be is under <filename>/etc</filename>, and so this file doesn't need to exist.
ja: <citerefentry> <refentrytitle>dh_installdeb</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> は<emphasis>自動的に </emphasis><filename>/etc</filename> ディレクトリー以下のファイルを全て conffiles とみなすので、あなたのプログラムが他のディレクトリーに conffiles を持たない場合は特に指定する必要はありません。ほとんどのパッケージの場合、<filename>/etc</filename> 以下にのみ conffiles がある（そうあるべきです）ので、このファイルの存在は不要です。

note: type: Content of: <book><chapter><section><para>
en: If your program uses configuration files but also rewrites them on its own, it's best not to make them conffiles because <command>dpkg</command> will then prompt users to verify the changes all the time.
ja: あなたのプログラムが設定ファイルを利用する場合であっても、 その設定ファイルがプログラム自身によって頻繁に上書きされるような場合には、パッケージをアップグレードするたびに <command>dpkg</command> によって設定ファイルの変更について確認を求められることになるので、その設定ファイルを conffiles に登録しないほうが良いでしょう。

note: type: Content of: <book><chapter><section><para>
en: If the program you're packaging requires every user to modify the configuration files in the <filename>/etc</filename> directory, there are two popular ways to arrange for them to not be conffiles, keeping <command>dpkg</command> quiet:
ja: あなたのパッケージングするプログラムが、ユーザーに <filename>/etc</filename> ディレクトリーの中にある設定ファイルを編集することを要求する場合、<command>dpkg</command> を黙らせるために conffiles として登録しない良く使われる方法が 2 つあります:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a symlink under the <filename>/etc</filename> directory pointing to a file under the <filename>/var</filename> directory generated by the maintainer scripts.
ja: <filename>/etc</filename> ディレクトリー中に、メンテナースクリプトによって生成された <filename>/var</filename> ディレクトリー以下のファイルにシンボリックリンクを張る。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a file generated by the maintainer scripts under the <filename>/etc</filename> directory.
ja: <filename>/etc</filename> ディレクトリーの中にメンテナースクリプトによってファイルを生成する。

note: type: Content of: <book><chapter><section><para>
en: For information on maintainer scripts, see <xref linkend="maintscripts"/>.
ja: メンテナースクリプトについての詳細は、<xref linkend="maintscripts"/> を参照してください。

note: type: Content of: <book><chapter><section><para>
en: If your package requires regularly scheduled tasks to operate properly, you can use these files to set that up.  You can set up regular tasks that either happen hourly, daily, weekly, or monthly, or alternatively happen at any other time that you wish.  The filenames are:
ja: パッケージが正しく動作するために、定期的にあるタスクを実行する必要がある場合は、これらのファイルで設定します。毎時間、毎日、毎週、または指定した時間に定期的タスクを実行するように指定することができます。ファイル名は以下です:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.hourly</filename> - Installed as <filename>/etc/cron.hourly/<replaceable>package</replaceable></filename>; run once an hour.
ja: <filename>cron.hourly</filename> - <filename>/etc/cron.hourly/<replaceable>package</replaceable></filename>としてインストール: 1時間ごとに実行する。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.daily</filename> - Installed as <filename>/etc/cron.daily/<replaceable>package</replaceable></filename>; run once a day.
ja: <filename>cron.daily</filename> - <filename>/etc/cron.daily/<replaceable>package</replaceable></filename>としてインストール: 1日に1度実行。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.weekly</filename> - Installed as <filename>/etc/cron.weekly/<replaceable>package</replaceable></filename>; run once a week.
ja: <filename>cron.weekly</filename> - <filename>/etc/cron.weekly/<replaceable>package</replaceable></filename>としてインストール: 1週間に1度実行。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.monthly</filename> - Installed as <filename>/etc/cron.monthly/<replaceable>package</replaceable></filename>: run once a month.
ja: <filename><replaceable>package</replaceable>.cron.monthly</filename> - <filename>/etc/cron.monthly/<replaceable>package</replaceable></filename>:としてインストール: 1ヶ月に1度実行。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename><replaceable>package</replaceable>.cron.d</filename> - Installed as <filename>/etc/cron.d/<replaceable>package</replaceable></filename>: for any other time.
ja: <filename><replaceable>package</replaceable>.cron.d</filename> - <filename>/etc/cron.d/<replaceable>package</replaceable></filename>としてインストール: どの時間でも指定可能。

note: type: Content of: <book><chapter><section><para>
en: Most of these files are shell scripts, with the exception of <filename><replaceable>package</replaceable>.cron.d</filename> which follows the format of <citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.
ja: 上記のファイルの書式はシェルスクリプトです。<filename><replaceable>package</replaceable>.cron.d</filename> は違い、<citerefentry> <refentrytitle>crontab</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>の書式になります。

note: type: Content of: <book><chapter><section><para>
en: No explicit <filename>cron.*</filename> file is needed to set up log rotation; for that, see <citerefentry><refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum></citerefentry> and <citerefentry><refentrytitle>logrotate</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
ja: ログローテーションの設定には明示的な <filename>cron.*</filename> は必要ありません。これについては<citerefentry> <refentrytitle>dh_installlogrotate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> および <citerefentry> <refentrytitle>logrotate</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>を参照してください。

note: type: Content of: <book><chapter><section><para>
en: This file specifies any directories which we need but which are not created by the normal installation procedure (<literal>make install DESTDIR=...</literal> invoked by <literal>dh_auto_install</literal>).  This generally means there is a problem with the <filename>Makefile</filename>.
ja: このファイルにはパッケージが必要としているのに、なぜか通常のインストール手順 (<literal>dh_auto_install</literal> によって呼び出される <literal>make install DESTDIR=...</literal>) では作成されないディレクトリーを指定します。通常、これは <filename>Makefile</filename> に問題があることを示唆しています。

note: type: Content of: <book><chapter><section><para>
en: Files listed in an <filename>install</filename> file don't need their directories created first.  See <xref linkend="install"/>.
ja: <filename>install</filename>ファイルに書かれてるファイルは最初にディレクトリーを作成する必要はありません。<xref linkend="install"/> を参照してください。

note: type: Content of: <book><chapter><section><para>
en: It is best to try to run the installation first and only use this if you run into trouble.  There is no preceding slash on the directory names listed in the <filename>dirs</filename> file.
ja: まずは試しにインストールしてみて、なにか問題が起きた場合にのみ使うべきでしょう。 <filename>dirs</filename> ファイル中のディレクトリー名の頭にスラッシュが付かない事に注意してください。

note: type: Content of: <book><chapter><section><para>
en: If your package has documentation other than manual and info pages, you should use the <systemitem role="package">doc-base</systemitem> file to register it, so the user can find it with e.g.  <citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, or <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ja: もしあなたのパッケージがマニュアルページや info 形式の文書以外に付属文書を含む場合、 <systemitem role="package">doc-base</systemitem> ファイルを使ってそれらを登録し、ユーザーがそれらの付属文書を、例えば<citerefentry> <refentrytitle>dhelp</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> や <citerefentry> <refentrytitle>dwww</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>、あるいは <citerefentry> <refentrytitle>doccentral</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドなどで参照できるようにしましょう。

note: type: Content of: <book><chapter><section><para>
en: This usually includes HTML, PS and PDF files, shipped in <filename>/usr/share/doc/<replaceable>packagename</replaceable>/</filename>.
ja: これには通常、<filename>/usr/share/doc/<replaceable>packagename</replaceable>/</filename>の中に収められるようなHTML、PS、およびPDFなどの形式の付属文書が含まれます。

note: type: Content of: <book><chapter><section><para>
en: This is what <systemitem role="package">gentoo</systemitem>'s doc-base file <filename>gentoo.doc-base</filename> looks like:
ja: 例えば、<systemitem role="package">gentoo</systemitem> の <filename>gentoo.doc-base</filename> ファイルは次のようになります:

note: type: Content of: <book><chapter><section><para>
en: For information on the file format, see <citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> and the Debian <systemitem role="package">doc-base</systemitem> manual at the local copy <filename>&doc-base;</filename> provided by the <systemitem role="package">doc-base</systemitem> package.
ja: このファイルの書式については<citerefentry> <refentrytitle>install-docs</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>および  <systemitem role="package">doc-base</systemitem> パッケージが提供するローカルコピー　<filename>&doc-base;</filename> にある <systemitem role="package">doc-base</systemitem> のマニュアルを参照してください。

note: type: Content of: <book><chapter><section><para>
en: For more details on installing additional documentation, look in <xref linkend="destdir"/>.
ja: 追加ドキュメントのインストールについて、詳細は<xref linkend="destdir"/> を見てください。

note: type: Content of: <book><chapter><section><para>
en: This file specifies the file names of documentation files we can have <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> install into the temporary directory for us.
ja: このファイルには、<citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>を使ってパッケージ生成用の一時的なディレクトリーにインストールするために、パッケージに付属する資料のファイル名を指定してください。

note: type: Content of: <book><chapter><section><para>
en: By default, it will include all existing files in the top-level source directory that are called <filename>BUGS</filename>, <filename>README*</filename>, <filename>TODO</filename> etc.
ja: デフォルトでは、ソースディレクトリーのトップレベルに存在する <filename>BUGS</filename>、 <filename>README*</filename>、 <filename>TODO</filename> などの名前を持つファイル全てを含みます。

note: type: Content of: <book><chapter><section><para>
en: For <systemitem role="package">gentoo</systemitem>, some other files are also included:
ja: <systemitem role="package">gentoo</systemitem> に関していくつか他のファイルが含まれます:

note: type: Content of: <book><chapter><section><para>
en: If your package supplies Emacs files that can be bytecompiled at package installation time, you can use these files to set it up.
ja: パッケージをインストールする際にバイトコンパイル可能な Emacs ファイルがあなたのパッケージに含まれている場合、これらの emacsen-* ファイルを利用してそれを設定することができます。

note: type: Content of: <book><chapter><section><para>
en: They are installed into the temporary directory by <citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ja: これらのファイルは<citerefentry> <refentrytitle>dh_installemacsen</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>によってパッケージ作成用の一時的なディレクトリーにインストールされます。

note: type: Content of: <book><chapter><section><para>
en: If you don't need these, remove them.
ja: 不要ならこのファイルを削除してください。

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs files and directories listed in this file as example files.
ja: <citerefentry> <refentrytitle>dh_installexamples</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>コマンドはこのディレクトリーに列挙されたファイルを例としてインストールします。

note: type: Content of: <book><chapter><section><title>
en: <filename><replaceable>package</replaceable>.init</filename> and <filename><replaceable>package</replaceable>.default</filename>
ja: <filename><replaceable>package</replaceable>.init</filename> と <filename><replaceable>package</replaceable>.default</filename>

note: type: Content of: <book><chapter><section><para>
en: If your package is a daemon that needs to be run at system start-up, you've obviously disregarded my initial recommendation, haven't you? :-)
ja: もしあなたのパッケージがデーモンであり、システムの起動時に 自動的に動作させる必要があるとしたら、私が最初に勧めたことを あなたはまるっきり無視してしまったわけですよね。そうでしょ ?:-)

note: type: Content of: <book><chapter><section><para>
en: If your upstream program provides a file for the init script, you can either use it or not.  If you don't use their init script then create a new one in <filename><replaceable>package</replaceable>.init</filename>.  However if the upstream init script looks fine and installs in the right place you still need to set up the <filename>rc*</filename> symlinks.  To do this you will need to override <command>dh_installinit</command> in the <filename>rules</filename> file with the following lines:
ja: アップストリームプログラムが init スクリプト用ファイルを提供する場合、それを使用するかしないかは自由です。もしアップストリームからの init スクリプトを使わないのであれば <filename><replaceable>package</replaceable>.init</filename> に新しいのを作成しましょう。アップストリームのinit スクリプトが問題なく正しい場所にインストールされるとしても、<filename>rc*</filename> シンボリックリンクの設定は必要です。そのためには、<filename>rules</filename> ファイルに以下を追加して、<command>dh_installinit</command> をオーバーライドしましょう:

note: type: Content of: <book><chapter><section><para>
en: If you don't need this, remove the files.
ja: 不要なら、このファイルを削除してください。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This replaces the deprecated <citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command which is configured by the <filename>files</filename> file.
ja: <filename>files</filename>ファイルによって、<citerefentry> <refentrytitle>dh_movefiles</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>コマンドが設定され、置換されます。

note: type: Content of: <book><chapter><section><para>
en: If there are files that need to be installed into your package but your standard <literal>make install</literal> won't do it, put the filenames and destinations into this <filename>install</filename> file.  They are installed by <citerefentry> <refentrytitle>dh_install</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.<placeholder type="footnote" id="0"/> You should first check that there is not a more specific tool to use.  For example, documents should be in the <filename>docs</filename> file and not in this one.
ja: パッケージにとってインストールが必要なファイルがあるにも関わらず、 <literal>make install</literal> ではインストールされない場合、そのファイル名とファイルを置く目的地を <filename>install</filename> ファイルに記述します。そうすると、<citerefentry><refentrytitle>dh_install</refentrytitle><manvolnum>1</manvolnum></citerefentry> によってそれらのファイルがインストールされます。<placeholder type="footnote" id="0"/> まずは使えそうな別のツールがないかどうかを調べましょう。例えば、ドキュメントはこのファイルではなく<filename>docs</filename>ファイルにあるべきです。

note: type: Content of: <book><chapter><section><para>
en: This <filename>install</filename> file has one line per file installed, with the name of the file (relative to the top build directory) then a space then the installation directory (relative to the install directory).  One example of where this is used is if a binary <filename>src/<replaceable>bar</replaceable></filename> is left uninstalled; the <filename>install</filename> file might look like:
ja: <filename>install</filename> ファイルはインストールされるファイルごとに 1 行必要とします。ファイル名（ビルドディレクトリーのトップを基点とした相対パス）、スペース、インストールするディレクトリー名（インストールディレクトリーを基点とした相対パス）という書式です。例えば、バイナリー <filename>src/<replaceable>bar</replaceable></filename> のインストールを忘れた場合などに、 <filename>install</filename> ファイルの項目は以下のように記述します:

note: type: Content of: <book><chapter><section><para>
en: This means when this package is installed, there will be an executable command <filename>/usr/bin/<replaceable>bar</replaceable></filename>.
ja: 上記によって、パッケージがインストールされたときに、<filename>/usr/bin/<replaceable>bar</replaceable></filename>というバイナリーファイルが存在することになります。

note: type: Content of: <book><chapter><section><para>
en: Alternatively, this <filename>install</filename> can have the name of the file only without the installation directory when the relative directory path does not change.  This format is usually used for a large package that splits the output of its build into multiple binary packages using <filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename>, etc.
ja: また、この <filename>install</filename> ファイルは相対パスが変わらない場合、インストールディレクトリーの指定を省略することもできます。この書式はビルドした結果を、<filename><replaceable>package-1</replaceable>.install</filename>, <filename><replaceable>package-2</replaceable>.install</filename> などを使用し、複数のバイナリーパッケージに分割するような、大規模なパッケージで使われます。

note: type: Content of: <book><chapter><section><para>
en: The <command>dh_install</command> command will fall back to looking in <filename>debian/tmp</filename> for files, if it doesn't find them in the current directory (or wherever you've told it to look using <literal>--sourcedir</literal>).
ja: <command>dh_install</command> コマンドはもし、カレントディレクトリーでファイルが見つからなかった場合は、(または、<literal>--sourcedir</literal> で探すように指示したディレクトリー内で見つからなかった場合は)フォールバックして <filename>debian/tmp</filename>内を検索します。

note: type: Content of: <book><chapter><section><para>
en: If your package has info pages, you should install them using <citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.info</filename> file.
ja: パッケージにinfoページがある場合、<filename><replaceable>package</replaceable>.info</filename> にそれらを挙げて、<citerefentry> <refentrytitle>dh_installinfo</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を使用してインストールします。

note: type: Content of: <book><chapter><section><para>
en: If you need to create additional symlinks in package build directories as package maintainer, you should install them using <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing their full paths of source and destination files in a <filename><replaceable>package</replaceable>.links</filename> file.
ja: パッケージメンテナーとしてパッケージビルドディレクトリー中に追加のシンボリックリンクを作成する必要がある場合、リンク元とリンク先の両方のフルパスを <filename><replaceable>package</replaceable>.links</filename> ファイル中にリストすることで <citerefentry> <refentrytitle>dh_link</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドでそれらをインストールするべきです。

note: type: Content of: <book><chapter><section><para>
en: If <systemitem role="package">lintian</systemitem> reports an erroneous diagnostic for a case where Debian policy allows exceptions to some rule, you can use <filename><replaceable>package</replaceable>.lintian-overrides</filename> or <filename>source/lintian-overrides</filename> to quieten it.  Please read the Lintian User's Manual (<filename>&lintian-doc;</filename>) and refrain from abusing this.
ja: ポリシーが例外を認めているにも関わらず、<systemitem role="package">lintian</systemitem> が誤診断を報告してきた場合、<filename><replaceable>package</replaceable>.lintian-overrides</filename>か<filename>source/lintian-overrides</filename> を使って黙らせることができます。Lintian User's Manual (<filename>&lintian-doc;</filename>) を読み、濫用は控えてください。

note: type: Content of: <book><chapter><section><para>
en: <filename><replaceable>package</replaceable>.lintian-overrides</filename> is for the binary package named <systemitem role="package"><replaceable>package</replaceable></systemitem> and is installed into <filename>usr/share/lintian/overrides/<replaceable>package</replaceable></filename> by the <command>dh_lintian</command> command.
ja: <filename><replaceable>package</replaceable>.lintian-overrides</filename> は <systemitem role="package"><replaceable>package</replaceable></systemitem> と名づけられたパッケージのためのファイルで、<command>dh_lintian</command> コマンドによって <filename>usr/share/lintian/overrides/<replaceable>package</replaceable></filename> にインストールされます。

note: type: Content of: <book><chapter><section><para>
en: <filename>source/lintian-overrides</filename> is for the source package.  This is not installed.
ja: <filename>source/lintian-overrides</filename>はソースパッケージのためのファイルです。これはインストールされません。

note: type: Content of: <book><chapter><section><para>
en: Your program(s) should have a manual page.  If they don't, you should create them.  The <command>dh_make</command> command creates some template files for manual pages.  These need to be copied and edited for each command missing its manual page.  Please make sure to remove unused templates.
ja: プログラムはマニュアルページが必ず必要です。もし無いなら作らなければなりません。<command>dh_make</command> コマンドはマニュアルページのテンプレートを作成します。マニュアルページがないコマンドのために、コピー、編集する必要があります。不要なテンプレートファイルを削除するのを忘れないようにしてください。

note: type: Content of: <book><chapter><section><section><para>
en: Manual pages are normally written in <citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  The <filename>manpage.1.ex</filename> template is written in <command>nroff</command>, too.  See the <citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry> manual page for a brief description of how to edit such a file.
ja: マニュアルページは通常、<citerefentry> <refentrytitle>nroff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>で書かれています。<filename>manpage.1.ex</filename>のテンプレートも<command>nroff</command>で書かれています。これらのファイルをどう編集するのかについて、簡単な説明が<citerefentry> <refentrytitle>man</refentrytitle> <manvolnum>7</manvolnum> </citerefentry>にあります。

note: type: Content of: <book><chapter><section><section><para>
en: The final manual page file name should give the name of the program it is documenting, so we will rename it from <literal>manpage</literal> to <literal>gentoo</literal>.  The file name also includes <literal>.1</literal> as the first suffix, which means it's a manual page for a user command.  Be sure to verify that this section is indeed the correct one.  Here's a short list of manual page sections:
ja: 最終的なマニュアルページのファイル名は、解説されているプログラム名を含めなければなりません。ここでは、ファイル名を <literal>manpage</literal> から <literal>gentoo</literal> に変更しましょう。ファイル名は、<literal>.1</literal> というサフィックスも含みます。これは、このマニュアルページはユーザーコマンドのものだ、という意味です。この部分を間違わないように気をつけてください。以下はマニュアルページのリストです:

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Section
ja: セクション

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Description
ja: 内容

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><thead><row><entry>
en: Notes
ja: ノート

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: User commands
ja: ユーザーコマンド

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Executable commands or scripts
ja: 実行可能なコマンドやスクリプト

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System calls
ja: システムコール

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions provided by the kernel
ja: カーネルが提供するファンクション

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Library calls
ja: ライブラリーコール

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Functions within system libraries
ja: システムライブラリーが提供するファンクション

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Special files
ja: 特殊ファイル

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Usually found in <filename>/dev</filename>
ja: 通常 <filename>/dev</filename> にある

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: File formats
ja: ファイルフォーマット

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: E.g. <filename>/etc/passwd</filename>'s format
ja: 例えば、<filename>/etc/passwd</filename>のフォーマット

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games
ja: ゲーム

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Games or other frivolous programs
ja: ゲームや他の他愛ないプログラム

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Macro packages
ja: マクロパッケージ

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Such as <command>man</command> macros
ja: <command>man</command>のマクロ等

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: System administration
ja: システム管理

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Programs typically only run by root
ja: 普通rootが実行するプログラム

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Kernel routines
ja: カーネルルーチン

note: type: Content of: <book><chapter><section><section><informaltable><tgroup><tbody><row><entry>
en: Non-standard calls and internals
ja: 非標準のコールや内部コール

note: type: Content of: <book><chapter><section><section><para>
en: So <systemitem role="package">gentoo</systemitem>'s man page should be called <filename>gentoo.1</filename>.  If there was no <filename>gentoo.1</filename> man page in the original source, you should create it by renaming the <filename>manpage.1.ex</filename> template to <filename>gentoo.1</filename> and editing it using information from the example and from the upstream docs.
ja: つまり、<systemitem role="package">gentoo</systemitem> のマニュアルページは <filename>gentoo.1</filename> となります。オリジナルのソースファイルに <filename>gentoo.1</filename> というマニュアルページがなければ、アップストリームのドキュメントと例を元にして、<filename>manpage.1.ex</filename> というテンプレートファイルを編集し <filename>gentoo.1</filename> というマニュアルページを作らなければなりません。

note: type: Content of: <book><chapter><section><section><para><footnote><para>
en: Note that <command>help2man</command>'s placeholder man page will claim that more detailed documentation is available in the info system. If the command is missing an <command>info</command> page, you should manually edit the man page created by the <command>help2man</command> command.
ja: <command>help2man</command> が作成する仮のマニュアルページに、詳細なドキュメントが info システムにあると記載されることに注意して下さい。<command>info</command> ページ中にコマンドが無い場合は、<command>help2man</command> コマンドが生成したページを手動で修正するべきです。

note: type: Content of: <book><chapter><section><section><para>
en: You can use the <command>help2man</command> command to generate a man page out of the <literal>--help</literal> and <literal>--version</literal> output of each program, too.  <placeholder type="footnote" id="0"/>
ja: 各コマンドの <literal>--help</literal>と<literal>--version</literal> 出力から <command>help2man</command>コマンドを用いてマニュアルページを作成することも可能です。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><section><para>
en: If on the other hand you prefer writing SGML instead of <command>nroff</command>, you can use the <filename>manpage.sgml.ex</filename> template.  If you do this, you have to:
ja: もし、<command>nroff</command>よりSGMLのほうが好みであれば、<filename>manpage.sgml.ex</filename> のほうをひな型として使うこともできます。こちらの場合には、以下の手順が必要です:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the file to something like <filename>gentoo.sgml</filename>.
ja: ファイル名を<filename>gentoo.sgml</filename>のような名前に変更します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-to-man</systemitem> package
ja: <systemitem role="package">docbook-to-man</systemitem> パッケージのインストール

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add <literal>docbook-to-man</literal> to the <literal>Build-Depends</literal> line in the <filename>control</filename> file
ja: <filename>control</filename> ファイルの <literal>Build-Depends</literal> 行へ <literal>docbook-to-man</literal> を追加

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add an <literal>override_dh_auto_build</literal> target to your <filename>rules</filename> file:
ja: <filename>rules</filename> ファイルに <literal>override_dh_auto_build</literal> ターゲットを追加します:

note: type: Content of: <book><chapter><section><section><para>
en: If you prefer XML over SGML, you can use the <literal>manpage.xml.ex</literal> template.  If you do this, you have to:
ja: SGMLよりもXMLが好みであれば、<literal>manpage.xml.ex</literal>をひな形として使うこともできます。こちらの場合には、以下の手順が必要です:

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: rename the source file to something like <literal>gentoo.1.xml</literal>
ja: ソースファイルの名前を、<literal>gentoo.1.xml</literal>のような名前に変更します。

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: install the <systemitem role="package">docbook-xsl</systemitem> package and an XSLT processor like <systemitem role="package">xsltproc</systemitem> (recommended)
ja: <systemitem role="package">docbook-xsl</systemitem> パッケージと <systemitem role="package">xsltproc</systemitem> のような XSLT プロセッサのインストール (推奨)

note: type: Content of: <book><chapter><section><section><itemizedlist><listitem><para>
en: add the <literal>docbook-xsl</literal>, <literal>docbook-xml</literal>, and <literal>xsltproc</literal> packages to the <literal>Build-Depends</literal> line in the <literal>control</literal> file
ja: <literal>control</literal> ファイルの <literal>Build-Depends</literal> 行へ、<literal>docbook-xsl</literal>、<literal>docbook-xml</literal>、<literal>xsltproc</literal> の各パッケージを追加します。

note: type: Content of: <book><chapter><section><para>
en: If your package has manual pages, you should install them using <citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> by listing them in a <filename><replaceable>package</replaceable>.manpages</filename> file.
ja: パッケージにマニュアルページがある場合、<filename><replaceable>package</replaceable>.manpages</filename> ファイルにそれらをリストして、<citerefentry> <refentrytitle>dh_installman</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を使用してインストールします。

note: type: Content of: <book><chapter><section><para>
en: To install <filename>docs/gentoo.1</filename> as a manpage for the <systemitem role="package">gentoo</systemitem> package, create a <filename>gentoo.manpages</filename> file as follows:
ja: <systemitem role="package">gentoo</systemitem> パッケージのマニュアルページとして <filename>docs/gentoo.1</filename> をインストールするには、以下のように <filename>gentoo.manpages</filename> ファイルを作成します:

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
ja: <citerefentry> <refentrytitle>dh_installchangelogs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>コマンドでインストールします。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Despite this use of the <command>bash</command> shorthand expression <filename>{pre,post}{inst,rm}</filename> to indicate these filenames, you should use pure POSIX syntax for these maintainer scripts for compatibility with <command>dash</command> as the system shell.
ja: <filename>{pre,post}{inst,rm}</filename> という <command>bash</command> 独自の短縮形をこれらのファイル名の表記としていますが、システムシェルである <command>dash</command> との互換性のために、これらのメンテナースクリプトでは純粋な POSIX シンタックスを使うべきです。

note: type: Content of: <book><chapter><section><para>
en: These <filename>postinst</filename>, <filename>preinst</filename>, <filename>postrm</filename>, and <filename>prerm</filename> files <placeholder type="footnote" id="0"/> are called <emphasis>maintainer scripts</emphasis>.  They are scripts which are put in the control area of the package and run by <command>dpkg</command> when your package is installed, upgraded, or removed.
ja: <filename>postinst</filename> や <filename>preinst</filename> や <filename>postrm</filename> や <filename>prerm</filename> ファイルは<placeholder type="footnote" id="0"/><emphasis>メンテナースクリプト</emphasis> と呼ばれています。これらのスクリプトは、パッケージを管理するエリアに置かれ、インストール、アップグレード、削除される際に<command>dpkg</command>によって実行されます。

note: type: Content of: <book><chapter><section><para>
en: As a novice maintainer, you should avoid any manual editing of maintainer scripts because they are problematic.  For more information refer to the <ulink url="&policy-mantainerscripts;">Debian Policy Manual, 6 "Package maintainer scripts and installation procedure"</ulink>, and take a look at the example files provided by <command>dh_make</command>.
ja: 新米メンテナーのうちは、問題になることが多いので<emphasis>メンテナースクリプト</emphasis>を直接編集しないようにしましょう。詳しくは <ulink url="&policy-mantainerscripts;">Debian Policy Manual, 6 "Package maintainer scripts and installation procedure"</ulink> を参照し、<command>dh_make</command> によって生成されるサンプルファイルに目を通してください。

note: type: Content of: <book><chapter><section><para>
en: If you did not listen to me and have created custom maintainer scripts for a package, you should make sure to test them not only for <emphasis role="strong">install</emphasis> and <emphasis role="strong">upgrade</emphasis> but also for <emphasis role="strong">remove</emphasis> and <emphasis role="strong">purge</emphasis>.
ja: もし私の忠告を無視して、<emphasis>メンテナースクリプト</emphasis>を直接編集した場合は、 <emphasis role="strong">インストール</emphasis>、<emphasis role="strong">アップグレード</emphasis>だけでなく、 <emphasis role="strong">削除</emphasis>と<emphasis role="strong">パージ</emphasis>のテストもしっかり行ってください。

note: type: Content of: <book><chapter><section><para>
en: Upgrades to the new version should be silent and non-intrusive (existing users should not notice the upgrade except by discovering that old bugs have been fixed and perhaps that there are new features).
ja: 新バージョンへのアップグレードは静かであるべきで、押し付けがましくてはいけません。（現行ユーザーは、バグが直されたことや新機能が追加されたことで気づかない限りアップグレードに気づかないのが理想です。)

note: type: Content of: <book><chapter><section><para>
en: When the upgrade is necessarily intrusive (eg., config files scattered through various home directories with totally different structure), you may consider as the last resort switching the package to a safe fallback state (e.g., disabling a service) and providing the proper documentation required by policy (<filename>README.Debian</filename> and <filename>NEWS.Debian</filename>).  Don't bother the user with <command>debconf</command> notes invoked from these maintainer scripts for upgrades.
ja: アップグレードが出しゃばる必要がある場合 (例えば、構造がまったく異なる設定ファイルがホームディレクトリーに散在する場合など)、パッケージのデフォルトを(例えばサービスを停止する等の)安全側に設定したり、最後の手段としてはポリシーに要求されるきちんとしたドキュメント (<filename>README.Debian</filename>と<filename>NEWS.Debian</filename>) を提供するなどの対策を考えるべきです。アップグレード際に <emphasis>メンテナースクリプト</emphasis> で <command>debconf</command> ノートを呼び出したりしてユーザーに迷惑を掛けないでください。

note: type: Content of: <book><chapter><section><para>
en: The <systemitem role="package">ucf</systemitem> package provides a <emphasis>conffile-like</emphasis> handling infrastructure to preserve user changes for files that may not be labeled as <emphasis>conffiles</emphasis> such as those managed by the maintainer scripts.  This should minimize issues associated with them.
ja: <systemitem role="package">ucf</systemitem> パッケージは、メンテナースクリプトによって管理されているような <emphasis>conffiles</emphasis> とラベルされていないファイルに関して、ユーザーによって変更されたファイルを保存する <emphasis>conffileのような</emphasis>処理をする仕組みを提供します。この仕組みを使うとこれらに関する問題を最小化できます。

note: type: Content of: <book><chapter><section><para>
en: These maintainer scripts are among the Debian enhancements that explain <emphasis role="strong">why people choose Debian</emphasis>.  You must be very careful not to turn them into a source of annoyance.
ja: これら、メンテナースクリプトは<emphasis role="strong">なぜ Debian を選ぶのか</emphasis>という理由の 1 つでもあります。これらの仕組みで、ユーザーが迷惑がる原因とならないよう細心の注意をはらいましょう。

note: type: Content of: <book><chapter><section><para>
en: Packaging of a library is not easy for a novice maintainer and should be avoided.  Having said it, if your package has libraries, you should have <filename>debian/<replaceable>package</replaceable>.symbols</filename> files. See <xref linkend="librarysymbols"/>.
ja: 新米メンテナーにとってはライブラリーのパッケージは容易ではないし、避けるべき行為です。このように言いましたが、もしあなたのパッケージがライブラリーを含む場合には、<filename>debian/<replaceable>package</replaceable>.symbols</filename> ファイルを作成すべきです。<xref linkend="librarysymbols"/> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: The <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command installs this.
ja: <citerefentry> <refentrytitle>dh_installdocs</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>コマンドでインストールします。

note: type: Content of: <book><chapter><section><para>
en: The <filename>watch</filename> file format is documented in the <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> manpage.  The <filename>watch</filename> file configures the <command>uscan</command> program (in the <systemitem role="package">devscripts</systemitem> package) to watch the site where you originally got the source.  This is also used by the <ulink url="&debtrack;">Debian Package Tracker</ulink> service.
ja: <filename>watch</filename> ファイルの書式は <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を参照してください。<filename>watch</filename> ファイルは、<command>uscan</command>  ( <systemitem role="package">devscripts</systemitem>パッケージに含まれます) を設定し、最初ソースを入手したサイトを監視します。これは <ulink url="&debtrack;">Debian パッケージ トラッカー</ulink> サービスによっても使用されています。

note: type: Content of: <book><chapter><section><para>
en: Here are its contents:
ja: 以下がその内容です:

note: type: Content of: <book><chapter><section><para>
en: Normally with a <filename>watch</filename> file, the URL at <literal>&sf-net;/gentoo</literal> is downloaded and searched for links of the form <literal>&lt;a href=...&gt;</literal>.  The basename (just the part after the final <literal>/</literal>) of each linked URL is compared against the Perl regular expression pattern (see <citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>)  <literal>gentoo-(.+)\.tar\.gz</literal>.  Out of the files that match, the one with the greatest version number is downloaded and the <command>uupdate</command> program is run to create an updated source tree.
ja: 通常、この<filename>watch</filename>ファイルでは、<literal>&sf-net;/gentoo</literal> の URL がダウンロードされ、<literal>&lt;a href=...&gt;</literal> フォームへのリンクを検索します。リンクされた URL のベースネーム(最後の <literal>/</literal> から後の部分のみ)は Perl の正規表現 (<citerefentry> <refentrytitle>perlre</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 参照)パターン <literal>gentoo-(.+)\.tar\.gz</literal> に照らし合わされます。一致したファイルの中から、バージョンの番号が一番大きいものがダウンロードされ、その後アップデートされたソースツリーを作成するために <command>uupdate</command> プログラムを実行します。

note: type: Content of: <book><chapter><section><para>
en: Although this is true for other sites, the SourceForge download service at <ulink url="&sf-net;"/> is an exception.  When the <filename>watch</filename> file has a URL matching the Perl regexp <literal>^http://sf\.net/</literal>, the <command>uscan</command> program replaces it with <literal>&qa-do;watch/sf.php/</literal> and then applies this rule.  The URL redirector service at <ulink url="&qa-do;"/> is designed to offer a stable redirect service to the desired file for any <filename>watch</filename> pattern of the form <literal>&sf-net;/<replaceable>project</replaceable>/<replaceable>tar-name</replaceable>-(.+)\.tar\.gz</literal>.  This solves issues related to periodically changing SourceForge URLs.
ja: 他のサイトでは上記の通りですが、<ulink url="&sf-net;"/> の SourceForge のダウンロードサービスは例外です。<filename>watch</filename>ファイルが Perl の正規表現 <literal>^http://sf\.net/</literal> に一致する URL を含む場合、<command>uscan</command> プログラムが代わり に<literal>&qa-do;watch/sf.php/</literal> を使い、このルールを当てはめます。<ulink url="&qa-do;">&qa-do;</ulink> の URL リダイレクトは <literal>&sf-net;/<replaceable>project</replaceable>/<replaceable>tar-name</replaceable>-(.+)\.tar\.gz</literal>を含む<filename>watch</filename> ファイルを対象に安定したリダイレクトを提供するよう設計されています。これにより、そこで周期的に変化する URL に関する問題を解決しています。

note: type: Content of: <book><chapter><section><para>
en: If the upstream offers the cryptographic signature of the tarball, it is recommended to verify its authenticity using the <literal>pgpsigurlmangle</literal> option as described in <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry>.
ja: ターボールの公開鍵電子署名をアップストリームが提供している際には、 <citerefentry> <refentrytitle>uscan</refentrytitle><manvolnum>1</manvolnum> </citerefentry> 中に記載された <literal>pgpsigurlmangle</literal> オプションを用いてその正統性を検証することが望ましい。

note: type: Content of: <book><chapter><section><para>
en: In the <filename>debian/source/format</filename> file, there should be a single line indicating the desired format for the source package (check <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> for an exhaustive list).  After <literal>squeeze</literal>, it should say either:
ja: <filename>debian/source/format</filename>ファイルでは、ソースパッケージのための理想の書式を示すための行があります。 (完全なリストは、<citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>を参照してください。)<literal>squeeze</literal>以降は、以下のどちらかになっているべきです:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (native)</literal> for native Debian packages or
ja: <literal>3.0 (native)</literal>： ネイティブ Debian パッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>3.0 (quilt)</literal> for everything else.
ja: <literal>3.0 (quilt)</literal>：　それ以外の全て。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debsrc3;">DebSrc3.0</ulink> for a summary on the switch to the new <literal>3.0 (quilt)</literal> and <literal>3.0 (native)</literal> source formats.
ja: ソースの書式を <literal>3.0 (quilt)</literal> や <literal>3.0 (native)</literal> に移行する際の注意点などは、<ulink url="&debsrc3;">DebSrc3.0</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Actually, this new format also supports multiple upstream tarballs and more compression methods.  These are beyond the scope of this document.
ja: この新しいフォーマットは、複数のアップストリームの tar アーカイブやこの他の圧縮方法もサポートしています。詳細は本稿の範疇を超えるため割愛します。

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format records modifications in a <command>quilt</command> patch series within <filename>debian/patches</filename>.  Those changes are then automatically applied during extraction of the source package.  <placeholder type="footnote" id="0"/> The Debian modifications are simply stored in a <filename>debian.tar.gz</filename> archive containing all files under the <filename>debian</filename> directory.  This new format supports inclusion of binary files such as PNG icons by the package maintainer without requiring tricks.  <placeholder type="footnote" id="1"/>
ja: 新しい<literal>3.0 (quilt)</literal>の書式は<command>quilt</command>パッチによる変更を <filename>debian/patches</filename>に記録します。そして、その変更は自動的にソースパッケージを展開するときに適用されます。<placeholder type="footnote" id="0"/>Debianの変更は、<filename>debian</filename>ディレクトリー以下のファイル全てを含め、<filename>debian.tar.gz</filename>アーカイブに保存されています。この新しい書式は、特殊な方法を用いることなく、PGNアイコンなどのパッケージメンテナーによるバイナリーファイルを含めることが可能です。<placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: When <command>dpkg-source</command> extracts a source package in <literal>3.0 (quilt)</literal> source format, it automatically applies all patches listed in <filename>debian/patches/series</filename>.  You can avoid applying patches at the end of the extraction with the <literal>--skip-patches</literal> option.
ja: <command>dpkg-source</command>が<literal>3.0 (quilt)</literal>の書式でソースパッケージを展開する際、<filename>debian/patches/series</filename>に列挙されたパッチを自動的に適用します。<literal>--skip-patches</literal>オプションで、展開時にパッチを適用しないようにできます。

note: type: Content of: <book><chapter><section><para>
en: When you want to manage Debian packaging activities under a VCS, you typically create one branch (e.g., <literal>upstream</literal>) tracking the upstream source and another branch (e.g., typically <literal>master</literal> for Git)  tracking the Debian package.  For the latter, you usually want to have unpatched upstream source with your <filename>debian/*</filename> files for the Debian packaging to ease merging of the new upstream source.
ja: Debianをパッケージングする活動をVCSで管理したい場合、アップストリームのソースをトラックするためのブランチ(例: <literal>upstream</literal>)とDebianパッケージをトラックするための別のブランチ(Gitでの典型例: <literal>master</literal>)を作成します。後者の場合、新しいアップストリームのソースとマージするのを簡単にするために、通常パッチの当てていないアップストリームのソースを<filename>debian/*</filename>ファイルと一緒に持っておきます。

note: type: Content of: <book><chapter><section><para>
en: After you build a package, the source is normally left patched.  You need to unpatch it manually by running <literal>dquilt pop -a</literal> before committing to the <literal>master</literal> branch.  You can automate this by adding the optional <filename>debian/source/local-options</filename> file containing <literal>unapply-patches</literal>.  This file is not included in the generated source package and changes the local build behavior only.  This file may contain <literal>abort-on-upstream-changes</literal>, too (see <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>).
ja: パッケージをビルドした後は、ソースのパッチは通常当てたままにされます。<literal>master</literal>ブランチにコミットする前に手動で <literal>quilt pop -a</literal> を実行してパッチを外す必要があります。<filename>debian/source/local-options</filename>ファイルに<literal>unapply-patches</literal>を書いておけば、自動的にパッチを外せます。このファイルは生成されたソースパッケージには含まれず、ローカルビルドでの挙動のみを変更します。このファイルは<literal>abort-on-upstream-changes</literal>も含むかもしれません (<citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 参照)。

note: type: Content of: <book><chapter><section><para>
en: The autogenerated files in the source tree can be quite annoying for packaging since they generate meaningless large patch files.  There are custom modules such as <command>dh_autoreconf</command> to ease this problem as described in <xref linkend="customrules"/>.
ja: ソースツリーの中の自動生成されるファイルはパッケージングする際に無意味で大きなパッチファイルを生成するのでとても厄介です。<xref linkend="customrules"/> で説明したように<command>dh_autoreconf</command> のようなカスタムモジュールが本問題を解消するために存在します。

note: type: Content of: <book><chapter><section><para>
en: You can provide a Perl regular expression to the <literal>--extend-diff-ignore</literal> option argument of <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> to ignore changes made to the autogenerated files while creating the source package.
ja: <citerefentry> <refentrytitle>dpkg-source</refentrytitle><manvolnum>1</manvolnum> </citerefentry> の <literal>--extend-diff-ignore</literal> オプション引数に Perl 正規表現を提供すると、ソースパッケージ生成時に自動生成ファイルへの変更を無視できます。

note: type: Content of: <book><chapter><section><para>
en: As a general solution to address this problem of the autogenerated files, you can store such a <command>dpkg-source</command> option argument in the <filename>source/options</filename> file of the source package.  The following will skip creating patch files for <filename>config.sub</filename>, <filename>config.guess</filename>, and <filename>Makefile</filename>.
ja: この自動生成ファイルの問題の一般的解決策としてソースパッケージの <filename>source/options</filename> ファイル中に <command>dpkg-source</command> オプション引数を保存する事が出来ます。以下の例では、<filename>config.sub</filename> と <filename>config.guess</filename> と <filename>Makefile</filename> に関してパッチファイルの生成をスキップします。

note: type: Content of: <book><chapter><section><para>
en: The old <literal>1.0</literal> source format created a single large <filename>diff.gz</filename> file containing package maintenance files in <filename>debian</filename> and patch files for the source.  Such a package is a bit cumbersome to inspect and understand for each source tree modification later.  This is not so nice.
ja: 古い　<literal>1.0</literal>　のソースフォーマットは、<filename>debian</filename>　内にパッケージメンテナンスファイルと、パッチファイルを含む単一の大きな　<filename>diff.gz</filename>　ファイルを作っていました。そのようなファイルは、ソースツリーの変更を後から調べたり、理解するのが非常に厄介でした。これはあまりいただけません。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Several methods of patch set maintenance have been proposed and are in use for Debian packages.  The <command>quilt</command> system is the preferred maintenance system in use.  Others include <command>dpatch</command>, <command>dbs</command>, and <command>cdbs</command>.  Many of these keep such patches as <filename>debian/patches/*</filename> files.
ja: パッチセットをメンテナンスするためのいくつかの方法が提案され、Debian パッケージで使われていますが、<command>quilt</command> が推奨されています。他には、<command>dpatch</command>、<command>dbs</command>、<command>cdbs</command>、などがあります。これらの方法は、大抵 <filename>debian/patches/*</filename> ファイルでパッチを管理しています。

note: type: Content of: <book><chapter><section><para>
en: The newer <literal>3.0 (quilt)</literal> source format stores patches in <filename>debian/patches/*</filename> files using the <command>quilt</command> command.  These patches and other package data which are all contained under the <filename>debian</filename> directory are packaged as the <filename>debian.tar.gz</filename> file.  Since the <command>dpkg-source</command> command can handle <command>quilt</command> formatted patch data in the <literal>3.0 (quilt)</literal> source without the <systemitem role="package">quilt</systemitem> package, it does not need a <literal>Build-Depends</literal> on <systemitem role="package">quilt</systemitem>.  <placeholder type="footnote" id="0"/>
ja: 新しい <literal>3.0 (quilt)</literal> は、<command>quilt</command> コマンドを使って、パッチを <filename>debian/patches/*</filename> に置きます。<filename>debian</filename> ディレクトリー以下に含まれているパッチやその他のパッケージデータは、<filename>debian.tar.gz</filename> ファイルとしてパッケージングされます。<command>dpkg-source</command> コマンドは、<command>quilt</command> 形式のパッチデータを <systemitem role="package">quilt</systemitem> パッケージなしで <literal>3.0 (quilt)</literal> として扱えるので、<systemitem role="package">quilt</systemitem> パッケージを <literal>Build-Depends</literal> に記載する必要はありません。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If you are asking a sponsor to upload your package, this kind of clear separation and documentation of your changes is very important to expedite the package review by your sponsor.
ja: スポンサーにパッケージのアップロードを頼む時にも、あなたが加えた変更に対するこのような明確な分離とドキュメントは、スポンサーによるパッケージのレビューを促進させるためにも、非常に重要です。

note: type: Content of: <book><chapter><section><para>
en: The <command>quilt</command> command is explained in <citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  It records modifications to the source as a stack of <literal>-p1</literal> patch files in the <filename>debian/patches</filename> directory and the source tree is untouched outside of the <filename>debian</filename> directory.  The order of these patches is recorded in the <filename>debian/patches/series</filename> file.  You can apply (=push), un-apply (=pop), and refresh patches easily.  <placeholder type="footnote" id="0"/>
ja: <command>quilt</command> コマンドについては<citerefentry> <refentrytitle>quilt</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> で説明されています。ソースへの変更は、<filename>debian/patches</filename> ディレクトリー内 <literal>-p1</literal> パッチファイルのスタックとして記録され、<filename>debian</filename> ディレクトリーの外のソースツリーには触れません。それらのパッチの順番は <filename>debian/patches/series</filename> ファイルに記録されます。パッチの適用 (=push)も、外す (=pop)のも、更新(=refresh)も、簡単にできます。 <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For <xref linkend="modify"/>, we created three patches in <filename>debian/patches</filename>.
ja: <xref linkend="modify"/> では、<filename>debian/patches</filename>に 3 つのパッチを作りました。

note: type: Content of: <book><chapter><section><para>
en: Since Debian patches are located in <filename>debian/patches</filename>, please make sure to set up the <command>dquilt</command> command properly as described in <xref linkend="quiltrc"/>.
ja: Debian のパッチは <filename>debian/patches</filename> にあるので、<xref linkend="quiltrc"/> の説明に従い、<command>dquilt</command> コマンドを正しく設定してください。

note: type: Content of: <book><chapter><section><para>
en: When anyone (including yourself) provides a patch <filename><replaceable>foo</replaceable>.patch</filename> to the source later, modifying a <literal>3.0 (quilt)</literal> source package is quite simple:
ja: 誰かが(あなた自身も含みます) <filename><replaceable>foo</replaceable>.patch</filename> というパッチを後から提供した際の、<literal>3.0 (quilt)</literal> ソースパッケージの変更はとてもシンプルです:

note: type: Content of: <book><chapter><section><para>
en: The patches stored in the newer <literal>3.0 (quilt)</literal> source format must be <emphasis>fuzz</emphasis> free.  You can ensure this with <literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal>.
ja: 新しい <literal>3.0 (quilt)</literal> 形式で保存されるパッチには <emphasis>曖昧さ</emphasis>があってはいけません。それを保証するために、<literal>dquilt pop -a; while dquilt push; do dquilt refresh; done</literal> としてください。

note: type: Content of: <book><chapter><title>
en: Building the package
ja: パッケージのビルド

note: type: Content of: <book><chapter><para>
en: We should now be ready to build the package.
ja: これでパッケージをビルドする準備が整いました。

note: type: Content of: <book><chapter><section><title>
en: Complete (re)build
ja: 完全な（再）ビルド

note: type: Content of: <book><chapter><section><para>
en: In order to perform a complete (re)build of a package properly, you need to make sure you have installed
ja: 完全なパッケージの（再）ビルドを行うには、以下を確実にインストールして下さい。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package,
ja: <systemitem role="package">build-essential</systemitem>パッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>), and
ja: <literal>Build-Depends</literal>に挙げられているパッケージ(参照<xref linkend="control"/>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends-indep</literal> field (see <xref linkend="control"/>).
ja: <literal>Build-Depends-indep</literal>に挙げられているパッケージ(参照 <xref linkend="control"/>)

note: type: Content of: <book><chapter><section><para>
en: Then you issue the following command in the source directory:
ja: ソースディレクトリーで以下のコマンドを実行してください:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make full binary and source packages for you.  It will:
ja: このコマンドはバイナリーパッケージとソースパッケージをビルドする作業をすべて行ってくれます。これには以下の作業が含まれます:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: clean the source tree (<literal>debian/rules clean</literal>)
ja: ソースツリーのクリーン (<literal>debian/rules clean</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the source package (<literal>dpkg-source -b</literal>)
ja: ソースパッケージのビルド (<literal>dpkg-source -b</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build the program (<literal>debian/rules build</literal>)
ja: プログラムのビルド (<literal>debian/rules build</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build binary packages (<literal>fakeroot debian/rules binary</literal>)
ja: バイナリーパッケージのビルド (<literal>fakeroot debian/rules binary</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.dsc</filename> file
ja: <filename>.dsc</filename> ファイルの作成

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: make the <filename>.changes</filename> file, using <command>dpkg-genchanges</command>
ja: <command>dpkg-genchanges</command> を使用し <filename>.changes</filename>ファイルを作成

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This GPG key must be signed by a Debian developer to get connected to the web of trust and must be registered to <ulink url="&keyring;">the Debian keyring</ulink>.  This enables your uploaded packages to be accepted to the Debian archives.  See <ulink url="&keycreate;">Creating a new GPG key</ulink> and <ulink url="&keysigning; ">Debian Wiki on Keysigning</ulink>.
ja: GPG キーは信頼の網に連結するように Debian デベロッパーによって署名され、<ulink url="&keyring;">the Debian keyring</ulink> に登録されていなければいけません。こうすることで Debian アーカイブにパッケージをアップロードして受け付けられるようになります。<ulink url="&keycreate;">Creating a new GPG key</ulink> と <ulink url="&keysigning; ">Debian Wiki on Keysigning</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: If the build result is satisfactory, sign the <filename>.dsc</filename> and <filename>.changes</filename> files with your private GPG key using the <command>debsign</command> command.  You need to enter your secret pass phrase, twice.  <placeholder type="footnote" id="0"/>
ja: 満足なビルド結果の場合には、<command>debsign</command> コマンドを用いてあなたの秘密 GPG 鍵で <filename>.dsc</filename> と <filename>.changes</filename> ファイルを署名します。秘密フレーズを２回入力する必要があります。  <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For a non-native Debian package, e.g., <systemitem role="package">gentoo</systemitem>, you will see the following files in the parent directory (<filename>~/gentoo</filename>) after building packages:
ja: ノンネイティブパッケージの場合、パッケージビルド後の親ディレクトリー (<filename>~/gentoo</filename>) に以下のファイルが生成されているはずです:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is the original upstream source code tarball, merely renamed to the above so that it adheres to the Debian standard.  Note that this was created initially by the command <literal>dh_make -f ../gentoo-0.9.12.tar.gz</literal>.
ja: これは単に Debian 標準に合わせるために名前を変更しただけで、中身はオリジナルなソースコードの tar アーカイブです。これは元来、<literal>dh_make -f ../gentoo-0.9.12.tar.gz</literal> で作成されたということを覚えておいてください。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is a summary of the contents of the source code.  The file is generated from your <filename>control</filename> file, and is used when unpacking the source with <citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ja: これはソースコードの内容の概要です。このファイルはあなたの<filename>control</filename>ファイルから生成され、<citerefentry> <refentrytitle>dpkg-source</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>によってソースを展開する際に使われます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This compressed tarball contains your <filename>debian</filename> directory contents.  Each and every addition you made to the original source code is stored as a <command>quilt</command> patch in <filename>debian/patches</filename>.
ja: この圧縮された tar アーカイブには、あなたの<filename>debian</filename>ディレクトリーの中身が含まれています。オリジナルのソースコードに行った変更や追加などの情報は全て <filename>debian/patches</filename> 内に、<command>quilt</command> パッチとして保存されます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can avoid applying <command>quilt</command> patches in the <literal>3.0 (quilt)</literal> source format at the end of the extraction with the <literal>--skip-patches</literal> option.  Alternatively, you can run <literal>dquilt pop -a</literal> after normal operation.
ja: <literal>3.0 (quilt)</literal>ソースフォーマットで<command>quilt</command>パッチを当てないようにするには、上記コマンドに<literal>--skip-patches</literal>オプションをつけて実行します。または、通常の操作の後に、<literal>quilt pop -a</literal>を実行する方法もあります。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If someone else wants to re-create your package from scratch, they can easily do so using the above three files.  The extraction procedure is trivial: just copy the three files somewhere else and run <literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal>.  <placeholder type="footnote" id="0"/>
ja: 上記 3 つのファイルを使えば誰でも簡単にあなたのパッケージをスクラッチからビルドすることができます。3 つのファイルを任意の場所にコピーし、<literal>dpkg-source -x gentoo_0.9.12-1.dsc</literal>を実行するだけです。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This is your completed binary package.  You can use <command>dpkg</command> to install and remove this just like any other package.
ja: これは、あなたが生成した完全なバイナリーパッケージです。他の全てのパッケージと同じく、<command>dpkg</command>を使ってインストールしたり削除したりできます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package revision; it is used by the Debian FTP archive maintenance programs to install the binary and source packages.  It is partly generated from the <filename>changelog</filename> file and the <filename>.dsc</filename> file.
ja: このファイルは現在のリビジョンパッケージにおける変更点をすべて記載したもので、Debian FTP アーカイブ管理プログラムによって、バイナリーおよびソースパッケージを FTP アーカイブにインストールするために利用されます。このファイルの一部は、<filename>changelog</filename> ファイルと <filename>.dsc</filename> をもとに生成されます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: As you keep working on the package, its behavior will change and new features will be added.  People downloading your package can look at this file and quickly see what has changed.  Debian archive maintenance programs will also post the contents of this file to the <ulink url="&debian-devel-changes-ldo;">debian-devel-changes@lists.debian.org</ulink> mailing list.
ja: パッケージの保守管理を続けていくと、挙動の変更や新機能の追加をすることがあります。あなたのパッケージをダウンロードする人は、このファイルを見れば何が変わったのか、一目でわかります。また、このファイルの中身は Debian アーカイブ管理プログラムによって、<ulink url="&debian-devel-changes-ldo;">debian-devel-changes@lists.debian.org</ulink> メーリングリストへ流されます。

note: type: Content of: <book><chapter><section><para>
en: The <filename>gentoo_0.9.12-1.dsc</filename> and <filename>gentoo_0.9.12-1_i386.changes</filename> files must be signed using the <command>debsign</command> command with your private GPG key in the <filename>~/.gnupg/</filename> directory, before uploading them to the Debian FTP archive. The GPG signature provides the proof that these files are really yours, using your public GPG key.
ja: Debain FTP アーカイブ にアップロードする前に、<filename>~/.gnupg/</filename> ディレクトリー中にあるあなたの秘密 GPG 鍵で <command>debsign</command> コマンドを用いて<filename>gentoo_0.9.12-1.dsc</filename> と <filename>gentoo_0.9.12-1_i386.changes</filename> ファイルを署名しなければいけません。

note: type: Content of: <book><chapter><section><para>
en: The <command>debsign</command> command can be made to sign with your specified secret GPG key ID (good for sponsoring packages) with the following in the <filename>~/.devscripts</filename> file:
ja: 以下の <filename>~/.devscripts</filename> ファイルを用いると、<command>debsign</command> コマンドはあなたが指定した秘密  GPG キー ID (パッケージをスポンサーする際に便利) で署名できます:

note: type: Content of: <book><chapter><section><para>
en: The long strings of numbers in the <filename>.dsc</filename> and <filename>.changes</filename> files are SHA1/SHA256 checksums for the files mentioned.  Anyone downloading your files can test them with <citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> and if the numbers don't match, they'll know the file is corrupt or has been tampered with.
ja: <filename>.dsc</filename> と <filename>.changes</filename> ファイルに記載されている長い数字の羅列は各ファイルの MD5/SHA1/SHA256 チェックサムです。パッケージをダウンロードした人は、<citerefentry> <refentrytitle>sha1sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>、<citerefentry> <refentrytitle>sha256sum</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>を使って整合性をテストすることができます。もし、数字が一致しない場合には、ファイルが壊れているか、あるいは何者かによって改ざんされていると分かるわけです。

note: type: Content of: <book><chapter><section><title>
en: Autobuilder
ja: オートビルダー

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The actual autobuilder system involves much more complicated schemes than the one documented here.  Such details are beyond the scope of this document.
ja: 実際のオートビルダーシステムは、本稿の説明よりもかなり複雑なスキームによって実現しています。それらの詳細は、本稿の範囲を超えるため割愛します。

note: type: Content of: <book><chapter><section><para>
en: Debian supports many <ulink url="&ports;">ports</ulink> with the <ulink url="&buildd;">autobuilder network</ulink> running <command>buildd</command> daemons on computers of many different architectures.  Although you do not need to do this yourself, you should be aware of what will happen to your packages.  Let's look into roughly how they rebuild your packages for multiple architectures.  <placeholder type="footnote" id="0"/>
ja: Debian は、様々なアーキテクチャー上で <command>buildd</command> デーモンを走らせている<ulink url="&buildd;">オートビルダーネットワーク</ulink>によって、色々な <ulink url="&ports;">移植版</ulink> をサポートしています。あなたがそれらを明示的に使う必要はありませんが、パッケージがどうなるのかを知っておくと良いでしょう。それでは、あなたのパッケージがどのように異なるアーキテクチャー向けに再ビルドされるのかを見ていきましょう。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: For <literal>Architecture: any</literal> packages, the autobuilder system performs a rebuild.  It ensures the installation of
ja: <literal>Architecture: any</literal> のパッケージは、オートビルダーシステムによって再ビルドされます。それは、以下を確実にインストールします。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: the <systemitem role="package">build-essential</systemitem> package, and
ja: <systemitem role="package">build-essential</systemitem>パッケージ

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: packages listed in the <literal>Build-Depends</literal> field (see <xref linkend="control"/>).
ja: <literal>Build-Depends</literal>に挙げられているパッケージ (参照 <xref linkend="control"/>)

note: type: Content of: <book><chapter><section><para>
en: Then it issues the following command in the source directory:
ja: そして、ソースディレクトリーで次のコマンドを実行します:

note: type: Content of: <book><chapter><section><para>
en: This will do everything to make architecture dependent binary packages on another architecture.  It will:
ja: これは、別のアーキテクチャー上で、アーキテクチャー依存のバイナリーパッケージを生成する作業をすべて行ってくれます。これには以下の作業が含まれます:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: build architecture dependent binary packages (<literal>fakeroot debian/rules binary-arch</literal>)
ja: アーキテクチャー依存のバイナリーパッケージをビルド(<literal>fakeroot debian/rules binary-arch</literal>)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: sign the source <filename>.dsc</filename> file, using <command>gpg</command>
ja: <command>gpg</command> を使用したソース<filename>.dsc</filename>ファイルへの署名

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: create and sign the upload <filename>.changes</filename> file, using <command>dpkg-genchanges</command> and <command>gpg</command>
ja: <command>dpkg-genchanges</command>および<command>gpg</command>を使用したアップロード用<filename>.changes</filename>ファイルの生成と署名

note: type: Content of: <book><chapter><section><para>
en: This is why you see your package for other architectures.
ja: あなたのパッケージが他のアーキテクチャー用にも存在するのは、このためです。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Unlike under the <systemitem role="package">pbuilder</systemitem> package, the <command>chroot</command> environment under the <systemitem role="package">sbuild</systemitem> package used by the autobuilder system does not enforce the use of a minimal system and may have many leftover packages installed.
ja: <systemitem role="package">pbuilder</systemitem>パッケージとは違い、オートビルダーによって使用される<systemitem role="package">sbuild</systemitem>パッケージ下での<command>chroot</command>環境では、最小システムを強制しないので、多くのパッケージがインストールされたままになるかもしれません。

note: type: Content of: <book><chapter><section><para>
en: Although packages listed in the <literal>Build-Depends-Indep</literal> field are required to be installed for our normal packaging work (see <xref linkend="completebuild"/>), they are not required to be installed for the autobuilder system since it builds only architecture dependent binary packages.  <placeholder type="footnote" id="0"/> This distinction between normal packaging and autobuilding procedures is what dictates whether you should record such required packages in the <literal>Build-Depends</literal> or <literal>Build-Depends-Indep</literal> fields of the <filename>debian/control</filename> file (see <xref linkend="control"/>).
ja: <literal>Build-Depends-indep</literal>フィールドのパッケージは、通常のパッケージの場合はインストールを要求されますが (参照 <xref linkend="completebuild"/>)、オートビルダーシステムでは、アーキテクチャー依存のパッケージのみをビルドするのでこれらのインストールは必須ではありません。<placeholder type="footnote" id="0"/> オートビルダーを使用した場合と普通のパッケージングとのこの違いにより、<filename>debian/control</filename> ファイルの <literal>Build-Depends</literal> か <literal>Build-Depends-indep</literal> のどちらにパッケージを記載するかが決定されます。(参照 <xref linkend="control"/>)

note: type: Content of: <book><chapter><section><title>
en: <command>debuild</command> command
ja: <command>debuild</command>コマンド

note: type: Content of: <book><chapter><section><para>
en: You can automate the build activity around executing the <command>dpkg-buildpackage</command> command package further with the <command>debuild</command> command.  See <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ja: <command>dpkg-buildpackage</command>によるビルドプロセス周辺は、<command>debuild</command>によりさらに自動化できます。<citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>を参照してください。

note: type: Content of: <book><chapter><section><para>
en: The <command>debuild</command> command executes the <command>lintian</command> command to make a static check after building the Debian package.  The <command>lintian</command> command can be customized with the following in the <filename>~/.devscripts</filename> file:
ja: <command>debuild</command> コマンドは、Debian パッケージをビルドのあと静的チェックをする <command>lintian</command> コマンドを実行します。<command>lintian</command> コマンドは <filename>~/.devscripts</filename> を用いて以下のようにカスタマイズできます:

note: type: Content of: <book><chapter><section><para>
en: Cleaning the source and rebuilding the package from your user account is as simple as:
ja: 以下のようにすれば一般ユーザーアカウントから、簡単にソースをクリーンしパッケージを再ビルドできます:

note: type: Content of: <book><chapter><section><para>
en: You can clean the source tree as simply as:
ja: ソースツリーのクリーンも簡単です:

note: type: Content of: <book><chapter><section><title>
en: <systemitem role="package">pbuilder</systemitem> package
ja: <systemitem role="package">pbuilder</systemitem>パッケージ

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Since the <systemitem role="package">pbuilder</systemitem> package is still evolving, you should check the actual configuration situation by consulting the latest official documentation.
ja: <systemitem role="package">pbuilder</systemitem>パッケージはまだ進化の過程なので、実際の構成は、最新の公式ドキュメントで確認して下さい。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&buildd-do;"/> for more on Debian package auto-building.
ja: Debian パッケージのオートビルドに関しては <ulink url="&buildd-do;"/> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: For a clean room (<command>chroot</command>) build environment to verify the build dependencies, the <systemitem role="package">pbuilder</systemitem> package is very useful.  <placeholder type="footnote" id="0"/> This ensures a clean build from the source under the <literal>sid</literal> auto-builder for different architectures and avoids a severity serious FTBFS (Fails To Build From Source) bug which is always in the RC (release critical) category.  <placeholder type="footnote" id="1"/>
ja: ビルド依存を確認するためのクリーンルーム (<command>chroot</command>) ビルド環境として、<systemitem role="package">pbuilder</systemitem> パッケージが非常に便利です。<placeholder type="footnote" id="0"/> これを使うことで、異なるアーキテクチャー向けに <literal>sid</literal> 環境オートビルダーの下でのソースからのクリーンなビルドが保証され、常に RC (リリースクリティカル)  に分類される重要度が serious (深刻)の FTBFS (Fails To Build From Source、ソースからのビルド失敗) バグを防ぎます。<placeholder type="footnote" id="1"/>

note: type: Content of: <book><chapter><section><para>
en: Let's customize the <systemitem role="package">pbuilder</systemitem> package as follows:
ja: それでは、<systemitem role="package">pbuilder</systemitem> をカスタマイズしてみましょう:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: setting the <filename>/var/cache/pbuilder/result</filename> directory writable by your user account.
ja: <filename>/var/cache/pbuilder/result</filename>ディレクトリーを、ユーザーアカウントから書き込めるように設定してください。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: creating a directory, e.g.  <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>, writable by the user, to place hook scripts in.
ja: フックスクリプトを置くために、ユーザーからの書き込みが可能なディレクトリーを作成してください。例） <filename><replaceable>/var/cache/pbuilder/hooks</replaceable></filename>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: configuring <filename>~/.pbuilderrc</filename> or <filename>/etc/pbuilderrc</filename> to include the following.
ja: <filename>~/.pbuilderrc</filename> か <filename>/etc/pbuilderrc</filename> に以下のように設定します。

note: type: Content of: <book><chapter><section><para>
en: First let's initialize the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system as follows:
ja: それでは、ローカル<systemitem role="package">pbuilder</systemitem> の <command>chroot</command> システムを以下のようにして初期化しましょう:

note: type: Content of: <book><chapter><section><para>
en: If you already have a completed source package, issue the following commands in the directory where the <filename><replaceable>foo</replaceable>.orig.tar.gz</filename>, <filename><replaceable>foo</replaceable>.debian.tar.gz</filename>, and <filename><replaceable>foo</replaceable>.dsc</filename> files exist to update the local <systemitem role="package">pbuilder</systemitem> <command>chroot</command> system and to build binary packages in it:
ja: 既に完全なソースパッケージがあれば、<filename><replaceable>foo</replaceable>.orig.tar.gz</filename>ファイル、<filename><replaceable>foo</replaceable>.debian.tar.gz</filename>ファイル、<filename><replaceable>foo</replaceable>.dsc</filename>ファイルが存在するディレクトリーで、ローカルの <systemitem role="package">pbuilder</systemitem> の <command>chroot</command>システムをアップデートし、バイナリーパッケージをその中でビルドしましょう:

note: type: Content of: <book><chapter><section><para>
en: The newly built packages without the GPG signatures will be located in <filename>/var/cache/pbuilder/result/</filename> with non-root ownership.
ja: 新しくビルドした GPG 署名の無いパッケージは非ルート所有権で <filename>/var/cache/pbuilder/result/</filename> に置かれます。

note: type: Content of: <book><chapter><section><para>
en: The GPG signatures on the <filename>.dsc</filename> file and the <filename>.changes</filename> file can be generated as:
ja: <filename>.dsc</filename> ファイルや <filename>.changes</filename> ファイルへのGPG 署名は次のようにするとできます:

note: type: Content of: <book><chapter><section><para>
en: If you have an updated source tree but have not generated the matching source package, issue the following commands in the source directory where the <filename>debian</filename> directory exists, instead:
ja: 更新されたソースツリーが既にあるが一致するソースパッケージを生成していない場合は、この代わりに、<filename>debian</filename> ディレクトリーが存在するディレクトリーで、以下のコマンドを発行します:

note: type: Content of: <book><chapter><section><para>
en: You can log into its <command>chroot</command> environment with the <literal>pbuilder --login --save-after-login</literal> command and configure it as you wish.  This environment can be saved by leaving its shell prompt with <literal>^D</literal> (Control-D).
ja: <literal>pbuilder --login --save-after-login</literal>コマンドで、<command>chroot</command>環境にログインし、好きに設定することができます。シェルプロンプトから<literal>^D</literal> (Control-D)で抜けると、その環境を保存しておくことができます。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: This assumes <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal>.  You can find many examples of hook scripts in the <filename>/usr/share/doc/pbuilder/examples</filename> directory.
ja: <literal>HOOKDIR=/var/cache/pbuilder/hooks</literal> をここで仮定しています。フックスクリプトのサンプルは <filename>/usr/share/doc/pbuilder/examples</filename> ディレクトリーににあります。

note: type: Content of: <book><chapter><section><para>
en: The latest version of the <command>lintian</command> command can be executed in the <literal>chroot</literal> environment using the hook script <filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename> configured as follows: <placeholder type="footnote" id="0"/>
ja: 最新の<command>lintian</command>コマンドは<literal>chroot</literal>環境から次のように設定されたフックスクリプト<filename><replaceable>/var/cache/pbuilder/hooks</replaceable>/B90lintian</filename>を使用して実行することができます: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You need to have access to the latest <literal>sid</literal> environment to build packages properly for <literal>sid</literal>.  In practice, <literal>sid</literal> may be experiencing issues which makes it undesirable for you to migrate your whole system.  The <systemitem role="package">pbuilder</systemitem> package can help you to cope with this kind of situation.
ja: <literal>sid</literal> 環境向けのパッケージを正しくビルドするには最新の <literal>sid</literal> 環境が必要です。<literal>sid</literal> にはあなたの環境全てを移行するには望ましくない問題を抱えていることが少なくありません。<systemitem role="package">pbuilder</systemitem> パッケージはそのような状況への対処の助けとなります。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are some restrictions for such updates of your <literal>stable</literal> package.
ja: <literal>stable</literal> パッケージのそのようなアップデートには制限が課せられます。

note: type: Content of: <book><chapter><section><para>
en: You may need to update your <literal>stable</literal> packages after their release for <literal>stable-proposed-updates</literal>, <literal>stable/updates</literal>, etc.  <placeholder type="footnote" id="0"/> For such occasions, the fact that you may be running a <literal>sid</literal> system is not a good enough excuse for failing to update them promptly.  The <systemitem role="package">pbuilder</systemitem> package can help you to access environments of almost any Debian derivative distribution of the same architecture.
ja: <literal>stable/updates</literal>や<literal>stable-proposed-updates</literal>がリリースされた後、<literal>stable</literal>パッケージのアップデートが必要な場合があります。<placeholder type="footnote" id="0"/>そのような場合に、即座にアップデートしない言い訳として <literal>sid</literal> を使っているからというのは不十分です。<systemitem role="package">pbuilder</systemitem>パッケージは、同じアーキテクチャーのほぼ全ての Debian 派生であるディストリビューションへのアクセスを手助けします。

note: type: Content of: <book><chapter><section><para>
en: See <ulink url="&pbuilder;"/>, <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>, <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>, and <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry>.
ja: <ulink url="&pbuilder;"/> と <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> と <citerefentry> <refentrytitle>pbuilderrc</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> と <citerefentry> <refentrytitle>pbuilder</refentrytitle> <manvolnum>8</manvolnum> </citerefentry> を参照下さい。

note: type: Content of: <book><chapter><section><title>
en: <command>git-buildpackage</command> command and similar
ja: <command>git-buildpackage</command>コマンドとその仲間

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&debref-vcs;">Version control systems</ulink> for more.
ja: 詳しくは <ulink url="&debref-vcs;">Version control systems</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: If your upstream uses a source code management system (VCS)  <placeholder type="footnote" id="0"/> to maintain their code, you should consider using it as well.  This makes merging and cherry-picking upstream patches much easier.  There are several specialized wrapper script packages for Debian package building for each VCS.
ja: アップストリームがソースコード管理システム (VCS) <placeholder type="footnote" id="0"/> を使っているのであれば、同様に使用することを考えるべきです。それによって、マージとアップストリームパッチの取捨選択がより簡単になります。各 VCS 毎に Debian パッケージをビルドするための特別なラッパースクリプトのパッケージもいくつかあります。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">git-buildpackage</systemitem>: a suite to help with Debian packages in Git repositories.
ja: <systemitem role="package">git-buildpackage</systemitem>: Git リポジトリ内の Debian パッケージの支援プログラム群です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">svn-buildpackage</systemitem>: helper programs to maintain Debian packages with Subversion.
ja: <systemitem role="package">svn-buildpackage</systemitem>: Debian パッケージを Subversion で管理するための支援プログラム群です。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <systemitem role="package">cvs-buildpackage</systemitem>: a set of Debian package scripts for CVS source trees.
ja: <systemitem role="package">cvs-buildpackage</systemitem>: CVS ソースツリーのための Debian パッケージスクリプト群です。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: <ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> documents how to use the <ulink url="&debian-alioth;">alioth.debian.org</ulink> service.
ja: <ulink url="&debian-alioth;">alioth.debian.org</ulink> サービスの使い方は、<ulink url="&debian-alioth-wiki;">Debian wiki Alioth</ulink> に記載されています。

note: type: Content of: <book><chapter><section><para>
en: Use of <systemitem role="package">git-buildpackage</systemitem> is becoming quite popular for Debian Developers to manage Debian packages with the Git server on <ulink url="&debian-alioth;">alioth.debian.org</ulink>. <placeholder type="footnote" id="0"/> This package offers many commands to <emphasis>automate</emphasis> packaging activities:
ja: Debian デベロッパーが <ulink url="&debian-alioth;">alioth.debian.org</ulink> 上の Git サーバーを用い Debian パッケージを管理するのに <systemitem role="package">git-buildpackage</systemitem> を使うことがよくあります。<placeholder type="footnote" id="0"/> このパッケージはパッケージ活動を<emphasis>自動化</emphasis>する多くのコマンドを提供します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository.
ja: <citerefentry> <refentrytitle>git-buildpackage</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: Debian パッケージを Git レポジトリーからビルドします。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: build Debian packages from a Git repository using <command>pbuilder</command>/<command>cowbuilder</command>.
ja: <citerefentry> <refentrytitle>git-pbuilder</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>: Debian パッケージを Git レポジトリーから <command>pbuilder</command>/<command>cowbuilder</command> を持ちいてビルドします。

note: type: Content of: <book><chapter><section><para>
en: These commands use 3 branches to track packaging activity:
ja: これらのコマンドはパッケージング活動を追跡する 3 つのブランチを使用します:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>main</literal> for Debian package source tree.
ja: Debian パッケージのソースツリーは、<literal>main</literal> 。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>upstream</literal> for upstream source tree.
ja: アップストリームのソースツリーは、<literal>upstream</literal>。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: The <literal>--pristine-tar</literal> option invokes the <command>pristine-tar</command> command, which can regenerate an exact copy of a pristine upstream tarball using only a small binary delta file and the contents of the tarball that are typically kept in an <literal>upstream</literal> branch in the VCS.
ja: <literal>--pristine-tar</literal> オプションは、小さなバイナリデルタと通常 VCS の <literal>upstream</literal> ブランチ中に保存された tar アーカイブの内容のみを用い完全に元通りの手付かずの tar アーカイブを再生成する <command>pristine-tar</command> コマンドを起動します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>pristine-tar</literal> for upstream tarball generated by the <literal>--pristine-tar</literal> option.<placeholder type="footnote" id="0"/>
ja: <literal>--pristine-tar</literal> オプションにより生成されるアップストリームtar アーカイブは、<literal>pristine-tar</literal>。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Here are some web resources available for advanced audiences.
ja: 以下は、上級者のみなさんの参考になるウェブ上で閲覧できる資料です。

note: type: Content of: <book><chapter><section><para><footnote><itemizedlist><listitem><para>
en: Building Debian Packages with git-buildpackage (<filename>&git-buildpackage-doc;</filename>)
ja: git-buildpackage を使っての Debian パッケージ作成 (<filename>&git-buildpackage-doc;</filename>)

note: type: Content of: <book><chapter><section><para>
en: You can configure <systemitem role="package">git-buildpackage</systemitem> with <filename>~/.gbp.conf</filename>. See <citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry>.  <placeholder type="footnote" id="0"/>
ja: <systemitem role="package">git-buildpackage</systemitem> は <filename>~/.gbp.conf</filename> で設定できます。<citerefentry> <refentrytitle>gbp.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> を参照下さい。 <placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><title>
en: Quick rebuild
ja: 部分的な再ビルド

note: type: Content of: <book><chapter><section><para><footnote><para>
en: Environment variables that are normally configured to proper values are not set by this method.  Never create real packages to be uploaded using this <emphasis role="strong">quick</emphasis> method.
ja: その場合は、通常だと正しく設定される環境変数は設定されません。アップロード用のパッケージはこの<emphasis role="strong">簡易</emphasis>メソッドで生成しないでください。

note: type: Content of: <book><chapter><section><para>
en: With a large package, you may not want to rebuild from scratch every time while you're tuning details in <filename>debian/rules</filename>.  For testing purposes, you can make a <filename>.deb</filename> file without rebuilding the upstream sources like this<placeholder type="footnote" id="0"/>:
ja: 大規模なパッケージの場合には、<filename>debian/rules</filename> をちょっといじるたびに、毎回最初からパッケージの再ビルドをやりなおすのは手間です。テスト目的であれば、以下の方法でアップストリームソースを再ビルドをせずに <filename>.deb</filename> ファイルを生成することができます。 <placeholder type="footnote" id="0"/>:

note: type: Content of: <book><chapter><section><para>
en: Or simply do the following to see if it builds or not:
ja: また、以下の方法を使えば生成可能かどうかをチェックすることができます:

note: type: Content of: <book><chapter><section><para>
en: Once you are finished with your tuning, remember to rebuild following the proper procedure.  You may not be able to upload correctly if you try to upload <filename>.deb</filename> files built this way.
ja: 最終的にきちんとテストが完了したら、正しい手順に従ってパッケージを最初から再ビルドすることを忘れないでください。この方法でビルドした <filename>.deb</filename> ファイルをアップロードしようとしても、おそらくうまくアップロードできないでしょう。

note: type: Content of: <book><chapter><section><title>
en: Command hierarchy
ja: コマンド階層

note: type: Content of: <book><chapter><section><para>
en: Here is a quick summary of how many commands to build packages fit together in the command hierarchy. There are many ways to do the same thing.
ja: パッケージ作成に用いる多くのコマンドが、コマンド階層の中でお互いいかなる関係にあるかの簡単なまとめを以下に記します。同じ事をするのに多くの方法があります。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <filename>debian/rules</filename> = maintainer script for the package building
ja: <filename>debian/rules</filename> = パッケージビルド用のメンテナースクリプト

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>dpkg-buildpackage</command> = core of the package building tool
ja: <command>dpkg-buildpackage</command> = パッケージビルドツールの核

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (build under the sanitized environment variables)
ja: <command>debuild</command> = <command>dpkg-buildpackage</command> + <command>lintian</command> (サニタイズした環境変数下でのビルド)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pbuilder</command> = core of the Debian chroot environment tool
ja: <command>pbuilder</command> = Debian の chroot 環境ツールの核

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (build in the chroot)
ja: <command>pdebuild</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> (chroot 中でビルド)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>cowbuilder</command> = speed up the <command>pbuilder</command> execution
ja: <command>cowbuilder</command> = <command>pbuilder</command> 実行の加速

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>git-pbuilder</command> = the easy-to-use commandline syntax for <command>pdebuild</command> (used by <command>gbp buildpackage</command>)
ja: <command>git-pbuilder</command> = <command>pdebuild</command> の使いやすいコマンドラインシンタックス (<command>gbp buildpackge</command> が使用)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp</command> = manage the Debian source under the git repo
ja: <command>gbp</command> = Debian ソースを git レポ下で管理

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <command>gbp buildpackage</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> + <command>gbp</command>
ja: <command>gbp buildpackge</command> = <command>pbuilder</command> + <command>dpkg-buildpackage</command> + <command>gbp</command>

note: type: Content of: <book><chapter><section><para>
en: Although use of higher level commands such as <command>gbp buildpackage</command> and <command>pbuilder</command> ensures the perfect package building environment, it is essential to understand how lower level commands such as <filename>debian/rules</filename> and <command>dpkg-buildpackage</command> are executed under them.
ja: <command>gbp buildpackge</command> や <command>pbuilder</command> 等のよりハイレベルなコマンドを用いることは完全なパッケージビルド環境を保証しますが、<filename>debian/rules</filename> や <command>dpkg-buildpackage</command> 等のよりローレベルのコマンドがそれらの下で実行されるかを理解することは必須です。

note: type: Content of: <book><chapter><title>
en: Checking the package for errors
ja: パッケージのエラーの検証

note: type: Content of: <book><chapter><para>
en: There are some techniques you should know for checking a package for errors before uploading it to the public archives.
ja: ここでは, 公式アーカイブにパッケージをアップロードする前に、作成したパッケージのエラーをあなた自身で確認するために知っておかなければならない方法について、幾つか述べます。

note: type: Content of: <book><chapter><para>
en: It's also a good idea to carry out testing on a machine other than your own.  You must watch closely for any warnings or errors for all the tests described here.
ja: あなたのマシン以外でのテストもまた良いアイデアです。以下に述べるすべてのテストにおける、どんな警告とエラーについてでもしっかりと確認しておかなければなりません。

note: type: Content of: <book><chapter><section><title>
en: Suspicious changes
ja: 怪しげな変更

note: type: Content of: <book><chapter><section><para>
en: If you find a new autogenerated patch file such as <filename>debian-changes-*</filename> in the <filename>debian/patches</filename> directory after building your non-native Debian package in <literal>3.0 (quilt)</literal> format, chances are you changed some files by accident or the build script modified the upstream source.  If it is your mistake, fix it.  If it is caused by the build script, fix the root cause with <command>dh-autoreconf</command> as in <xref linkend="customrules"/> or work around it with <filename>source/options</filename> as in <xref linkend="sourceopt"/>.
ja: あなたの <literal>3.0 (quilt)</literal> フォーマットのノンネイティブ Debian パッケージ をビルドした後で、<filename>debian/patches</filename> ディレクトリー内に <filename>debian-changes-*</filename> のような新規の自動生成されたパッチファイルを見つけた場合。何かの間違いで何らかのファイルを変更したか、ビルドスクリプトがアップストリームソースに変更を加えた可能性が大いにあります。あなたの間違いなら、それを修正しましょう。ビルドスクリプトが引き起こした場合は、<xref linkend="customrules"/> にあるように <command>dh-autoreconf</command> を使って根本原因を修正するか、<xref linkend="sourceopt"/> にあるように <filename>source/options</filename> を使って回避策をとります。

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's installation
ja: インストールに対するパッケージの検証

note: type: Content of: <book><chapter><section><para>
en: You must test your package for whether it installs without problems.  The <citerefentry> <refentrytitle>debi</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command helps you to test installing all the generated binary packages.
ja: あなたのパッケージが問題なくインストールできるかどうかをテストしなければなりません。<citerefentry> <refentrytitle>debi</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドはあなたが作成した全てのバイナリーパッケージのインストールテストに役立ちます。

note: type: Content of: <book><chapter><section><para>
en: To prevent installation problems on different systems, you must make sure that there are no filenames conflicting with other existing packages, using the <filename>Contents-<replaceable>i386</replaceable></filename> file downloaded from the Debian archive.  The <command>apt-file</command> command may be handy for this task.  If there are collisions, please take action to avoid this real problem, whether by renaming the file, moving a common file to a separate package that multiple packages can depend on, using the alternatives mechanism (see <citerefentry><refentrytitle>update-alternatives</refentrytitle> <manvolnum>1</manvolnum></citerefentry>) in coordination with the maintainers of other affected packages, or declaring a <literal>Conflicts</literal> relationship in the <filename>debian/control</filename> file.
ja: 別のシステムでインストール時に問題が起きるのを防ぐために、Debian アーカイブよりダウンロードした <filename>Contents-<replaceable>i386</replaceable></filename> ファイルを用いて、他の既存のパッケージと重複するファイルがないことを確認しておかなければなりません。<command>apt-file</command> コマンドはこの作業において恐らく役に立つでしょう。重複するファイルが存在するならば、実際に問題になることを回避するために、ファイルをリネームするか、複数のパッケージが依存する独立のパッケージに共通ファイルを移動するか、他の影響のあるパッケージと調整しながら alternatives (<citerefentry> <refentrytitle>update-alternatives</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 参照)を用いるか、<filename>debian/control</filename>に <literal>Conflicts</literal> 項目を宣言して下さい。

note: type: Content of: <book><chapter><section><title>
en: Verifying a package's maintainer scripts
ja: パッケージのメンテナースクリプトの検証

note: type: Content of: <book><chapter><section><para>
en: All maintainer scripts (that is, <filename>preinst</filename>, <filename>prerm</filename>, <filename>postinst</filename>, and <filename>postrm</filename> files) are hard to write correctly unless they are auto-generated by the <systemitem role="package">debhelper</systemitem> programs.  So do not use them if you are a novice maintainer (see <xref linkend="maintscripts"/>).
ja: 全てのメンテナースクリプト (<filename>preinst</filename>、<filename>prerm</filename>、<filename>postinst</filename> そして <filename>postrm</filename> ファイルのこと) は、それが <systemitem role="package">debhelper</systemitem>プログラムで自動生成されたのでない場合は、正しく書くことが非常に困難です。だからあなたが新米メンテナーならばこれらは使わないで下さい (<xref linkend="maintscripts"/> 参照)。

note: type: Content of: <book><chapter><section><para>
en: If the package makes use of these non-trivial maintainer scripts, be sure to test not only for install but also for remove, purge, and upgrade processes.  Many maintainer script bugs show up when packages are removed or purged.  Use the <command>dpkg</command> command as follows to test them:
ja: パッケージがこれらの重要なメンテナースクリプトを使用するならば、インストールだけではなく、削除、完全削除 (purge)、そしてアップグレードについても確実にテストしましょう。多くのメンテナースクリプトのバグは削除もしくは完全削除の場合に発生します。これらのテストのためには、以下の様に <command>dpkg</command> コマンドを実行します:

note: type: Content of: <book><chapter><section><para>
en: This should be done with sequences such as the following:
ja: 以下のような順番で実行すべきでしょう:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the previous version (if needed).
ja: (可能な場合は)前回バージョンをインストールします。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: upgrade it from the previous version.
ja: 旧バージョンからアップグレードします。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: downgrade it back to the previous version (optional).
ja: 旧バージョンになるよう、ダウングレードします (オプション)。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: purge it.
ja: 完全削除 (purge) します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install the new package.
ja: 新しいパッケージとしてインストールします。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: remove it.
ja: 削除します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: install it again.
ja: もう一度インストールします。

note: type: Content of: <book><chapter><section><para>
en: If this is your first package, you should create dummy packages with different versions to test your package in advance to prevent future problems.
ja: これが最初に作成したパッケージならば、将来発生するかもしれない問題を防ぐために、異なるバージョンのダミーパッケージを作成すべきです。

note: type: Content of: <book><chapter><section><para>
en: Bear in mind that if your package has previously been released in Debian, people will often be upgrading to your package from the version that was in the last Debian release.  Remember to test upgrades from that version too.
ja: あなたのパッケージが過去の Debian にてリリースされていた場合には、人々は大抵最新の Debian のリリース版に含まれているバージョンからパッケージのアップグレードをするであろう、ということに配慮しましょう。上記の手順で、そのバージョンからきちんとアップグレードできることを、忘れずに確認しておいてください。

note: type: Content of: <book><chapter><section><para>
en: Although downgrading is not officially supported, supporting it is a friendly gesture.
ja: ダウングレードは公式にはサポートされていませんが、これをサポートするのは友好的な態度です。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: You do not need to provide the <command>lintian</command> option <literal>-i -I --show-overrides</literal> if you customized <filename>/etc/devscripts.conf</filename> or <filename>~/.devscripts</filename> as described in <xref linkend="debuild"/>.
ja: <filename>/etc/devscripts.conf</filename> や <filename>~/.devscripts</filename> において <xref linkend="debuild"/> で述べた設定をしている場合には、<command>lintian</command> に <literal>-i -I --show-overrides</literal> オプションを指定する必要はありません。

note: type: Content of: <book><chapter><section><para>
en: Run <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> on your <filename>.changes</filename> file.  The <command>lintian</command> command runs many test scripts to check for many common packaging errors.  <placeholder type="footnote" id="0"/>
ja: <citerefentry> <refentrytitle>lintian</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を <filename>.changes</filename> に対して実行しましょう。<command>lintian</command> コマンドはパッケージ作成時のよくある間違いをチェックするために多くのテストスクリプトを実行します。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: Of course, replace the filename with the name of the <filename>.changes</filename> file generated for your package.  The output of the <command>lintian</command> command uses the following flags:
ja: もちろん、<filename>.changes</filename> のファイル名はあなたが作成したパッケージに置き換えて下さい。<command>lintian</command> コマンドの出力は以下のようにマークされています:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>E:</literal> for error; a sure policy violation or packaging error.
ja: <literal>E:</literal> はエラーです。 確実にポリシー違反もしくはパッケージエラーです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>W:</literal> for warning; a possible policy violation or packaging error.
ja: <literal>W:</literal> は警告です。 ポリシー違反もしくはパッケージングエラーである可能性があります。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>I:</literal> for info; information on certain aspects of packaging.
ja: <literal>I:</literal> は参考情報です。パッケージのとある性質について参考となる情報を提供します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>N:</literal> for note; a detailed message to help your debugging.
ja: <literal>N:</literal> は覚書です。 デバッグに有用な情報を詳述します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>O:</literal> for overridden; a message overridden by the <filename>lintian-overrides</filename> files but displayed by the <literal>--show-overrides</literal> option.
ja: <literal>O:</literal> はオーバーライド通知です。 <filename>lintian-overrides</filename> ファイルによりメッセージがオーバーライドされたメッセージです。これは <literal>--show-overrides</literal> オプションを指定した際に表示されます。

note: type: Content of: <book><chapter><section><para>
en: When you see warnings, tune the package to avoid them or verify that the warnings are spurious.  If spurious, set up <filename>lintian-overrides</filename> files as described in <xref linkend="lintian"/>.
ja: 警告が出た場合には、パッケージを調整するか、その警告が不当であることを確認して下さい。もし警告が不当である場合には <xref linkend="lintian"/> で述べた <filename>lintian-overrides</filename> を作成して下さい。

note: type: Content of: <book><chapter><section><para>
en: Note that you can build the package with <command>dpkg-buildpackage</command> and run <command>lintian</command> on it in one command, if you use <citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.
ja: <command>dpkg-buildpackage</command> によるパッケージの生成と <command>lintian</command> の実行は、<citerefentry> <refentrytitle>debuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンド、もしくは <citerefentry> <refentrytitle>pdebuild</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドを用いれば一気に実行することができます。

note: type: Content of: <book><chapter><section><title>
en: The <command>debc</command> command
ja: <command>debc</command> コマンド

note: type: Content of: <book><chapter><section><para>
en: You can list files in the binary Debian package with the <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
ja: <citerefentry> <refentrytitle>debc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドを用いるとバイナリーパッケージに含まれるファイルの一覧が得られます。

note: type: Content of: <book><chapter><section><title>
en: The <command>debdiff</command> command
ja: <command>debdiff</command> コマンド

note: type: Content of: <book><chapter><section><para>
en: You can compare file contents in two source Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
ja: <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドを用いると、二つのソースパッケージに含まれているファイルを比較することができます。

note: type: Content of: <book><chapter><section><para>
en: You can also compare file lists in two sets of binary Debian packages with the <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.
ja: <citerefentry> <refentrytitle>debdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドは二つのバイナリーパッケージに含まれるファイルの一覧を比較することもできます。

note: type: Content of: <book><chapter><section><para>
en: These are useful to identify what has been changed in the source packages and to check for inadvertent changes made when updating binary packages, such as unintentionally misplacing or removing files.
ja: これらのコマンドは、ソースパッケージ中でどんな変更をしたのか、バイナリーパッケージの中で意図せず削除したり配置を間違えたりしていないか、そしてバイナリーパッケージの更新時に不用意な変更をしていないかどうか、といった事柄を確認するのに便利です。

note: type: Content of: <book><chapter><section><title>
en: The <command>interdiff</command> command
ja: <command>interdiff</command> コマンド

note: type: Content of: <book><chapter><section><para>
en: You can compare two <filename>diff.gz</filename> files with the <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command.  This is useful for verifying that no inadvertent changes were made to the source by the maintainer when updating packages in the old <literal>1.0</literal> source format.
ja: <citerefentry> <refentrytitle>interdiff</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドを用いると、二つの <filename>.diff.gz</filename> ファイルを比較することができます。旧来の <literal>1.0</literal> ソース形式でパッケージを更新している場合には、メンテナーがソースに意図しない変更をしていないことを確認するのに便利です。

note: type: Content of: <book><chapter><section><para>
en: The new <literal>3.0</literal> source format stores changes in multiple patch files as described in <xref linkend="patches"/>.  You can trace changes of each <filename>debian/patches/*</filename> file using <command>interdiff</command>, too.
ja: 新規の <literal>3.0</literal> ソースフォーマットは <xref linkend="patches"/> で説明したように複数のパッチファイル中に変更を保存します。各々の <filename>debian/patches/*</filename> ファイルの変化も <command>interdiff</command> を使って追いかけられます。

note: type: Content of: <book><chapter><section><title>
en: The <command>mc</command> command
ja: <command>mc</command> コマンド

note: type: Content of: <book><chapter><section><para>
en: Many of these file inspection operations can be made into an intuitive process by using a file manager like <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> which will let you browse not only the contents of <filename>*.deb</filename> package files but also <filename>*.udeb</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename>, and <filename>*.orig.tar.gz</filename> files.
ja: <citerefentry> <refentrytitle>mc</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> の様に、<filename>*.deb</filename>パッケージファイルだけではなく、<filename>*.udev</filename>, <filename>*.debian.tar.gz</filename>, <filename>*.diff.gz</filename>, <filename>*.orig.tar.gz</filename> の中身を閲覧することができるファイルマネージャを用いると、多くのファイルの検査が直感的に行なえます。

note: type: Content of: <book><chapter><section><para>
en: Be on the lookout for extra unneeded files or zero length files, both in the binary and source package.  Often cruft doesn't get cleaned up properly; adjust your <filename>rules</filename> file to compensate for this.
ja: 不要なファイルやサイズがゼロのファイルがバイナリーパッケージとソースパッケージに含まれていないことをよく確認して下さい。 大抵は不要なファイルが正しく削除されずに残ってしまっています。<filename>rules</filename> を調整しこれを修正して下さい。

note: type: Content of: <book><chapter><title>
en: Updating the package
ja: パッケージの更新

note: type: Content of: <book><chapter><para>
en: After you release a package, you will soon need to update it.
ja: パッケージをリリースしたなら、すぐにそれを更新する必要があります。

note: type: Content of: <book><chapter><section><title>
en: New Debian revision
ja: Debian リビジョンの更新

note: type: Content of: <book><chapter><section><para>
en: Let's say that a bug report was filed against your package as <literal>#654321</literal>, and it describes a problem that you can solve.  Here's what you need to do to create a new Debian revision of the package:
ja: 例えば仮に、<literal>#654321</literal> という番号のバグレポートがあなたのパッケージ に対してファイルされ、解決可能な問題が記述されていたとしましょう。 パッケージの新しい Debian リビジョンを作成するには、以下を実行する 必要があります:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to be recorded as a new patch, do the following:
ja: もしこれが新規のパッチとして記録される場合には、以下のようにします:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt new <replaceable>bugname.patch</replaceable></literal> to set the patch name;
ja: <literal>dquilt new <replaceable>bugname.patch</replaceable></literal> としてパッチ名を設定します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt add <replaceable>buggy-file</replaceable></literal> to declare the file to be modified;
ja: <literal>dquilt add <replaceable>buggy-file</replaceable></literal> として変更されるファイルを宣言します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the package source for the upstream bug;
ja: アップストリームバグに関してパッケージソース中の問題を修正します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to record it to <filename><replaceable>bugname.patch</replaceable></filename>;
ja: <literal>dquilt refresh</literal> として <filename><replaceable>bugname.patch</replaceable></filename> に記録します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to add its description;
ja: <literal>dquilt header -e</literal> としてその内容記述を追加します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If this is to update an existing patch, do the following:
ja: もし既存のパッチをアップデートする場合には、以下のようにします:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt pop <replaceable>foo.patch</replaceable></literal> to recall the existing <filename><replaceable>foo.patch</replaceable></filename>;
ja: <literal>dquilt pop <replaceable>foo.patch</replaceable></literal> として既存の <filename><replaceable>foo.patch</replaceable></filename> を呼び出します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Correct the problem in the old <filename><replaceable>foo.patch</replaceable></filename>;
ja: 古い <filename><replaceable>foo.patch</replaceable></filename> 中の問題を修正します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update <filename><replaceable>foo.patch</replaceable></filename>;
ja: <literal>dquilt refresh</literal> として <filename><replaceable>foo.patch</replaceable></filename> を更新します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt header -e</literal> to update its description;
ja: <literal>dquilt header -e</literal> としてその内容記述を更新します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>;
ja: <literal>while dquilt push; do dquilt refresh; done</literal> として <emphasis>fuzz</emphasis> を削除しながら全てのパッチを適用します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: To get the date in the required format, use <literal>LANG=C date -R</literal>.
ja: 日付を要求されるフォーマットで入力するには、<literal>LANG=C date -R</literal>を使います。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Add a new revision at the top of the Debian <filename>changelog</filename> file, for example with <literal>dch -i</literal>, or explicitly with <literal>dch -v <replaceable>version</replaceable>-<replaceable>revision</replaceable></literal> and then insert the comments using your preferred editor.  <placeholder type="footnote" id="0"/>
ja: 次に Debian <filename>changelog</filename> ファイルの先頭に新しいリビジョンを 追加します。例えば<literal>dch -i</literal>を実行するか、またはバージョンを 明示したい場合なら<literal>dch -v <replaceable>version</replaceable>-<replaceable>revision</replaceable></literal> を実行してあなたの好きなエディタで説明を記入すると楽にできます。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Include a short description of the bug and the solution in the changelog entry, followed by <literal>Closes: #654321</literal>.  That way, the bug report will be <emphasis>automagically</emphasis> closed by the archive maintenance software the moment your package gets accepted into the Debian archive.
ja: changelog の説明行に、このリビジョンで解決されたバグと、その解決方法についての簡単な説明を記載し、<literal>Closes: #54321</literal> と続けておきます。これによってあなたのパッケージが Debian アーカイブ中に受け入れられた時、アーカイブ管理ソフトウェアによって該当するバグレポートが<emphasis>魔法のように自動的に</emphasis>閉じられます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in the above to fix more bugs while updating the Debian <filename>changelog</filename> file with <literal>dch</literal> as needed.
ja: 上記であなたがしたことを繰り返し、必要に応じて Debian <filename>changelog</filename> ファイルを <literal>dch</literal> で更新しながら、更なるバグ修正を行います。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Repeat what you did in <xref linkend="completebuild"/> and <xref linkend="checkit"/>.
ja:  <xref linkend="completebuild"/> と <xref linkend="checkit"/> で行ったことを繰り返して下さい。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Once you are satisfied, you should change the distribution value in <filename>changelog</filename> from <literal>UNRELEASED</literal> to the target distribution value <literal>unstable</literal> (or even <literal>experimental</literal>).<placeholder type="footnote" id="0"/>
ja: 一旦満足した時点で、<filename>changelog</filename> 中のディストリビューション値を <literal>UNRELEASED</literal> からターゲットディストリビューション値 <literal>unstable</literal> (もしくは場合に依っては <literal>experimental</literal>) へと変更すべきです。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Upload the package as in <xref linkend="upload"/>.  The difference is that this time, the original source archive won't be included, as it hasn't been changed and it already exists in the Debian archive.
ja: <xref linkend="upload"/> と同様にパッケージをアップロードします。 今までと違うのは、今回の場合オリジナルソースアーカイブには 変更が無く、同じものが既に Debian アーカイブ中に存在しているため、 アップロードするファイルにはオリジナルのソースアーカイブが含まれないという点だけです。

note: type: Content of: <book><chapter><section><para>
en: One tricky case can occur when you make a local package, to experiment with the packaging before uploading the normal version to the official archive, e.g., <literal><replaceable>1.0.1</replaceable>-<replaceable>1</replaceable></literal>.  For smoother upgrades, it is a good idea to create a <filename>changelog</filename> entry with a version string such as <literal><replaceable>1.0.1</replaceable>-<replaceable>1~rc1</replaceable></literal>.  You may unclutter <filename>changelog</filename> by consolidating such local change entries into a single entry for the official package.  See <xref linkend="namever"/> for the order of version strings.
ja: 例えばオフィシャルのアーカイブへ <literal><replaceable>1.0.1</replaceable>-<replaceable>1</replaceable></literal> のようなノーマルのバージョンをアップロードする前にパッケージングを色々試すべくローカルパッケージを作る時には要注意です。スムースなアップグレードのためには、<literal><replaceable>1.0.1</replaceable>-<replaceable>1~rc1</replaceable></literal> のような文字列のバージョンの項目を<filename>changelog</filename> に作るのがいい考えです。オフィシャルパッケージのためには、そのようなローカル変更の複数項目を単一の項目にまとめて <filename>changelog</filename> をすっきりさせてもいいです。バージョン文字列の順序に関しては <xref linkend="namever"/> を参照下さい。

note: type: Content of: <book><chapter><section><title>
en: Inspection of the new upstream release
ja: 新規のアップストリームリリースの検査

note: type: Content of: <book><chapter><section><para>
en: When preparing packages of a new upstream release for the Debian archive, you must check the new upstream release first.
ja: Debian アーカイブ用の新しいアップストリームリリースパッケージの準備をする際は、まず、新アップストリームリリースをチェックしなければなりません。

note: type: Content of: <book><chapter><section><para>
en: Start by reading the upstream <filename>changelog</filename>, <filename>NEWS</filename>, and whatever other documentation they may have released with the new version.
ja: アップストリームの <filename>changelog</filename> や <filename>NEWS</filename>、その他の新しいバージョンでリリースされたドキュメントを読むことから始めてください

note: type: Content of: <book><chapter><section><para>
en: You can then inspect changes between the old and new upstream sources as follows, watching out for anything suspicious:
ja: 以下のようにすれば何かおかしな事が無いかに注意を払いつつ新旧のアップストリームソース間の変更検査ができます:

note: type: Content of: <book><chapter><section><para>
en: Changes to some auto-generated files by Autotools such as <filename>missing</filename>, <filename>aclocal.m4</filename>, <filename>config.guess</filename>, <filename>config.h.in</filename>, <filename>config.sub</filename>, <filename>configure</filename>, <filename>depcomp</filename>, <filename>install-sh</filename>, <filename>ltmain.sh</filename>, and <filename>Makefile.in</filename> may be ignored.  You may delete them before running <command>diff</command> on the source for inspection.
ja: <filename>missing</filename> や <filename>aclocal.m4</filename> や <filename>config.guess</filename> や <filename>config.h.in</filename> や <filename>config.sub</filename> や <filename>configure</filename> や <filename>depcomp</filename> や <filename>install-sh</filename> や <filename>ltmain.sh</filename> や <filename>Makefile.in</filename> 等の Autotools によって自動生成されるファイルへの変更は無視していい場合があります。ソースを検査するための <command>diff</command> を実行する前に消去してもいいです。

note: type: Content of: <book><chapter><section><title>
en: New upstream release
ja: アップストリームソフトウェアの新版更新

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is packaged in the old <literal>1.0</literal> format, this can be done by running <literal>zcat /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.diff.gz|patch -p1</literal> in the new extracted source, instead.
ja: もしパッケージ <systemitem role="package"><replaceable>foo</replaceable></systemitem> が旧 <literal>1.0</literal> フォーマットでパッケージされている場合は、新規に展開されたソース中で <literal>zcat /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.diff.gz|patch -p1</literal> を実行すれば出来ます。

note: type: Content of: <book><chapter><section><para>
en: If a package <systemitem role="package"><replaceable>foo</replaceable></systemitem> is properly packaged in the newer <literal>3.0 (native)</literal> or <literal>3.0 (quilt)</literal> formats, packaging a new upstream version is essentially moving the old <filename>debian</filename> directory to the new source.  This can be done by running <literal>tar xvzf /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.debian.tar.gz</literal> in the new extracted source.  <placeholder type="footnote" id="0"/> Of course, you need to do some obvious chores:
ja: もし <systemitem role="package"><replaceable>foo</replaceable></systemitem> パッケージが新規の <literal>3.0 (native)</literal> や <literal>3.0 (quilt)</literal> フォーマットで適正にパッケージされていれば、新規のアップストリームバージョンをパッケージするのは基本的に旧 <filename>debian</filename> ディレクトリーを新規ソースへと移動するのみです。これは新規に展開されたソース中で <literal>tar xvzf /<replaceable>path</replaceable>/<replaceable>to</replaceable>/<replaceable>foo</replaceable>_<replaceable>oldversion</replaceable>.debian.tar.gz</literal> を実行すれば出来ます。<placeholder type="footnote" id="0"/> もちろん当然するべき細々としたことをする必要はあります:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Create a copy of the upstream source as the <filename>foo_<replaceable>newversion</replaceable>.orig.tar.gz</filename> file.
ja: アップストリームソースのコピーを <filename>foo_<replaceable>newversion</replaceable>.orig.tar.gz</filename> ファイルとして作成します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Update the Debian <filename>changelog</filename> file with <literal>dch -v <replaceable>newversion</replaceable>-<replaceable>1</replaceable></literal>.
ja: Debian の <filename>changelog</filename> ファイルを <literal>dch -v <replaceable>newversion</replaceable>-<replaceable>1</replaceable></literal> を使って更新します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add an entry with <literal>New upstream release</literal>.
ja: <literal>New upstream release</literal> という項目を追加します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>in the new upstream release</emphasis> that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
ja: 報告のあったバグを修正する<emphasis>新規アップストリームリリース中の</emphasis>変更点に関して簡潔に記載しバグを <literal>Closes: #<replaceable>バグ番号</replaceable></literal> と追記してクローズします。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Describe concisely the changes <emphasis>to the new upstream release</emphasis> by the maintainer that fix reported bugs and close those bugs by adding <literal>Closes: #<replaceable>bug_number</replaceable></literal>.
ja: 報告のあったバグを修正する、メンテナーによる<emphasis>新規アップストリームリリースへの</emphasis>変更点に関して簡潔に記載しバグを <literal>Closes: #<replaceable>バグ番号</replaceable></literal> と追記しクローズします。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: <literal>while dquilt push; do dquilt refresh; done</literal> to apply all patches while removing <emphasis>fuzz</emphasis>.
ja: <literal>while dquilt push; do dquilt refresh; done</literal> として <emphasis>fuzz</emphasis> を削除しながら全てのパッチを適用します。

note: type: Content of: <book><chapter><section><para>
en: If the patch/merge did not apply cleanly, inspect the situation (clues are left in <filename>.rej</filename> files).
ja: もしパッチやマージがクリーンに適用できない場合は、状況を精査します (<filename>.rej</filename> ファイル中にヒントがあります)。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source was integrated into the upstream source,
ja: もしソースにあなたが適用していたパッチがアップストリームソースに統合された場合は、

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt delete</literal> to remove it.
ja: <literal>dquilt delete</literal> として削除します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If a patch you applied to the source conflicted with new changes in the upstream source,
ja: もしソースにあなたが適用していたパッチが新規アップストリームソースとぶつかる場合は、

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt push -f</literal> to apply old patches while forcing rejects as <filename><replaceable>baz</replaceable>.rej</filename>.
ja: <literal>dquilt push -f</literal> として <filename><replaceable>baz</replaceable>.rej</filename> としてリジェクトを強制しながら古いパッチを適用します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Edit the <filename><replaceable>baz</replaceable></filename> file manually to bring about the intended effect of <filename><replaceable>baz</replaceable>.rej</filename>.
ja: <filename><replaceable>baz</replaceable>.rej</filename> の本来目指した効果を実現するように、<filename><replaceable>baz</replaceable></filename> ファイルを手動で編集します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: <literal>dquilt refresh</literal> to update the patch.
ja: <literal>dquilt refresh</literal> としてパッチを更新します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Continue as usual with <literal>while dquilt push; do dquilt refresh; done</literal>.
ja: <literal>while dquilt push; do dquilt refresh; done</literal> まで戻り継続します。

note: type: Content of: <book><chapter><section><para>
en: This process can be automated using the <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> command as follows:
ja: このプロセスは <citerefentry> <refentrytitle>uupdate</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドを以下のように使うことで自動化できます:

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If the <command>uscan</command> command downloads the updated source but it does not run the <command>uupdate</command> command, you should correct the <filename>debian/watch</filename> file to have <literal>debian uupdate</literal> at the end of the URL.
ja: もし <command>uscan</command> コマンドが更新されたソースはダウンロードするが <command>uupdate</command> コマンドを実行しない場合には、URLの最後に <literal>debian uupdate</literal> となるように <filename>debian/watch</filename> ファイルを修正するべきです。

note: type: Content of: <book><chapter><section><para>
en: If you set up a <filename>debian/watch</filename> file as described in <xref linkend="watch"/>, you can skip the <command>wget</command> command.  You simply run <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> in the <filename><replaceable>foo</replaceable>-<replaceable>oldversion</replaceable></filename> directory instead of the <command>uupdate</command> command.  This will <emphasis>automagically</emphasis> look for the updated source, download it, and run the <command>uupdate</command> command.  <placeholder type="footnote" id="0"/>
ja: <filename>debian/watch</filename> ファイルを<xref linkend="watch"/> に記載されたように設定していれば、 <command>wget</command> コマンドをスキップすることが出来ます。<filename><replaceable>foo</replaceable>-<replaceable>oldversion</replaceable></filename> ディレクトリー中で <command>uupdate</command> コマンドを実行する代わりに、単に <citerefentry> <refentrytitle>uscan</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> コマンドを実行します。こうすると<emphasis>魔法のように</emphasis>更新されたソースを見つけ、それをダウンロードし、<command>uupdate</command> コマンドを実行します。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: You can release this updated source by repeating what you did in <xref linkend="completebuild"/>, <xref linkend="checkit"/>, and <xref linkend="upload"/>.
ja: 今まで <xref linkend="completebuild"/> 、 <xref linkend="checkit"/> 、<xref linkend="upload"/> の中で実行してきたことを繰り返し、更新したソースをリリースできます。

note: type: Content of: <book><chapter><section><title>
en: Updating the packaging style
ja: パッケージ化スタイルの更新

note: type: Content of: <book><chapter><section><para><footnote><para>
en: If your sponsor or other maintainers object to updating the existing packaging style, don't bother arguing.  There are more important things to do.
ja: もしあなたのスポンサーや他のメンテナーが既存のパッケージスタイル更新に異存がある場合には、更新することもまたその議論することは意味がありません。他にするべきより重要なことがあります。

note: type: Content of: <book><chapter><section><para>
en: Updating the package style is not a required activity for the update of a package.  However, doing so lets you use the full capabilities of the modern <systemitem role="package">debhelper</systemitem> system and the <literal>3.0</literal> source format.  <placeholder type="footnote" id="0"/>
ja: パッケージスタイルの更新はパッケージ更新のために必須活動ではありません。しかし、こうすることで最新の <systemitem role="package">debhelper</systemitem> システムと <literal>3.0</literal> ソースフォーマットの全能力を活用できます。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you need to recreate deleted template files for any reason, you can run <command>dh_make</command> again in the same Debian package source tree with the <literal>--addmissing</literal> option.  Then edit them appropriately.
ja: もし何らかの理由で消去されたテンプレートファイルを追加する必要がある場合には、同一の Debian ソースツリーの中で <literal>--addmissing</literal> オプションとともに <command>dh_make</command> をもう一度実行してもいいです。そして、それらを適正に編集しましょう。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If the package has not been updated to use the <systemitem role="package">debhelper</systemitem> v7+ <command>dh</command> syntax for the <filename>debian/rules</filename> file, update it to use <command>dh</command>.  Update the <filename>debian/control</filename> file accordingly.
ja: <filename>debian/rules</filename> ファイルに関して <systemitem role="package">debhelper</systemitem> v7+ <command>dh</command> シンタックスへとパッケージが更新されていない場合は <command>dh</command> を使うように更新しましょう。<filename>debian/control</filename> ファイルもそれに合わせて変更しましょう。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you want to update the <filename>rules</filename> file created with the <filename>Makefile</filename> inclusion mechanism of the Common Debian Build System (<systemitem role="package">cdbs</systemitem>) to the <command>dh</command> syntax, see the following to understand its <literal>DEB_*</literal> configuration variables.
ja: コモン Debian ビルドシステム (<systemitem role="package">cdbs</systemitem>) による <filename>Makefile</filename> 包含メカニズムで生成された <filename>rules</filename> ファイルを <command>dh</command> シンタックスに更新しようとする場合には、以下を参照し <literal>DEB_*</literal> 設定変数を理解して下さい。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: local copy of <filename>&cdbs-doc;</filename>
ja: <filename>&cdbs-doc;</filename> のローカルコピー

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package without the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (native)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (native)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.
ja: <filename><replaceable>foo</replaceable>.diff.gz</filename> ファイル無しの <literal>1.0</literal> ソースパッケージの場合、<literal>3.0 (native)</literal> と言う内容の <filename>debian/source/format</filename> を作成することで新規の <literal>3.0 (native)</literal> ソースフォーマットに更新できます。残りの <filename>debian/*</filename> ファイルは単にコピーするだけです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para><footnote><para>
en: You can split <filename>big.diff</filename> into many small incremental patches using the <command>splitdiff</command> command.
ja: <command>splitdiff</command> コマンドを用いると <filename>big.diff</filename> は多くの小さな増分パッチに分割できます。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If you have a <literal>1.0</literal> source package with the <filename><replaceable>foo</replaceable>.diff.gz</filename> file, you can update it to the newer <literal>3.0 (quilt)</literal> source format by creating <filename>debian/source/format</filename> with <literal>3.0 (quilt)</literal>.  The rest of the <filename>debian/*</filename> files can just be copied.  Import the <filename>big.diff</filename> file generated by the command <literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; big.diff</literal> to your <command>quilt</command> system, if needed.  <placeholder type="footnote" id="0"/>
ja: <filename><replaceable>foo</replaceable>.diff.gz</filename> ファイルありの <literal>1.0</literal> ソースパッケージの場合、<literal>3.0 (quilt)</literal> と言う内容の <filename>debian/source/format</filename> を作成することで新規の <literal>3.0 (quilt)</literal> ソースフォーマットに更新できます。残りの <filename>debian/*</filename> ファイルは単にコピーするだけです。必要な場合、<literal>filterdiff -z -x '*/debian/*' <replaceable>foo</replaceable>.diff.gz &gt; big.diff</literal> コマンドにより生成される <filename>big.diff</filename> ファイルをあなたの <command>quilt</command> システムにインポートします。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged using another patch system such as <systemitem role="package">dpatch</systemitem>, <systemitem role="package">dbs</systemitem>, or <systemitem role="package">cdbs</systemitem> with <literal>-p0</literal>, <literal>-p1</literal>, or <literal>-p2</literal>, convert it to <systemitem role="package">quilt</systemitem> using <filename>deb3</filename> at <ulink url="&deb3;"/>.
ja: <literal>-p0</literal> や <literal>-p1</literal> や <literal>-p2</literal> を使う <systemitem role="package">dpatch</systemitem> や <systemitem role="package">dbs</systemitem> や <systemitem role="package">cdbs</systemitem> のような他のパッチシステムを用いてパッケージされ得ている場合には、<ulink url="&deb3;">&deb3;</ulink>にある <filename>deb3</filename> を用いて <systemitem role="package">quilt</systemitem> コマンドに変換します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If it was packaged with the <command>dh</command> command with the <literal>--with quilt</literal> option or with the <command>dh_quilt_patch</command> and <command>dh_quilt_unpatch</command> commands, remove these and make it use the newer <literal>3.0 (quilt)</literal> source format.
ja: もし <literal>--with quilt</literal> オプション付きの <command>dh</command> コマンドとか、<command>dh_quilt_patch</command> と <command>dh_quilt_unpatch</command> コマンドを用いてパッケージされている場合には、これらを削除し新規の <literal>3.0 (quilt)</literal> ソースフォーマットを使うようにします。

note: type: Content of: <book><chapter><section><para>
en: You should check <ulink url="&dep;">DEP - Debian Enhancement Proposals</ulink> and adopt ACCEPTED proposals.
ja: <ulink url="&dep;">DEP - Debian エンハンスメント提案</ulink> を確認し、ACCEPTED (採用) となった提案を取り入れるべきです。

note: type: Content of: <book><chapter><section><para>
en: You need to do the other tasks described in <xref linkend="newupstream"/>, too.
ja: <xref linkend="newupstream"/> に記載された他の作業も行う必要があります。

note: type: Content of: <book><chapter><section><title>
en: UTF-8 conversion
ja: UTF-8 変換

note: type: Content of: <book><chapter><section><para>
en: If upstream documents are encoded in old encoding schemes, converting them to <ulink url="&utf8;">UTF-8</ulink> is a good idea.
ja: アップストリームの文書が旧来のエンコーディング法にてエンコードされている場合には、それらを <ulink url="&utf8;">UTF-8</ulink> に変換するのはいいことです。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert encodings of plain text files.
ja: <citerefentry> <refentrytitle>iconv</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を使いプレインテキストのエンコーディングを変換します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Use <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to convert from HTML files to UTF-8 plain text files.  When you do this, make sure to execute it under UTF-8 locale.
ja: <citerefentry> <refentrytitle>w3m</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を使用して HTML ファイルを UTF-8 のプレインテキストファイルに変換します。これを行う際には、必ず UTF-8 ロケールで実行して下さい。

note: type: Content of: <book><chapter><section><title>
en: Reminders for updating packages
ja: パッケージをアップグレードする際の注意点

note: type: Content of: <book><chapter><section><para>
en: Here are a few reminders for updating packages:
ja: パッケージをアップグレードする際の注意点は以下です:

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Preserve old <filename>changelog</filename> entries (sounds obvious, but there have been cases of people typing <literal>dch</literal> when they should have typed <literal>dch -i</literal>.)
ja: <filename>changelog</filename> の旧項目を保全します (自明ですが、<literal>dch -i</literal> とするべき時に <literal>dch</literal> とした過去事例があります。)

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Existing Debian changes need to be reevaluated; throw away stuff that upstream has incorporated (in one form or another) and remember to keep stuff that hasn't been incorporated by upstream, unless there is a compelling reason not to.
ja: 現存の Debian による変更は再評価する必要があります。(何らかの形で)アップストリームが組み込んだことは捨て、アップストリームが組み込まなかったことは残しましょう。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: If any changes were made to the build system (hopefully you'd know from inspecting upstream changes) then update the <filename>debian/rules</filename> and <filename>debian/control</filename> build dependencies if necessary.
ja: ビルドシステムに変更が加えられた場合には (アップストリームの変更を精査した際に分かっているはずですよね)、 必要に応じて <filename>debian/rules</filename> と <filename>debian/control</filename> のビルド依存関係を更新します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the <ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink> to see if someone has provided patches to bugs that are currently open.
ja: 現存もオープンのバグへのパッチを誰かが提供していないかを、<ulink url="&bts;">Debian Bug Tracking System (BTS)</ulink> で確認します。

note: type: Content of: <book><chapter><section><itemizedlist><listitem><para>
en: Check the contents of the <filename>.changes</filename> file to make sure you are uploading to the correct distribution, the proper bug closures are listed in the <literal>Closes</literal> field, the <literal>Maintainer</literal> and <literal>Changed-By</literal> fields match, the file is GPG-signed, etc.
ja: 正しいディストリビューションへアップロードすること、 <literal>Closes</literal> フィールドに適切なバグのクローズがリストされていること、<literal>Maintainer</literal> と <literal>Changed-By</literal> フィールドがマッチしていること、ファイルが GPG 署名されていること等を確実にするように、<filename>.changes</filename> ファイルの内容を確認します。

note: type: Content of: <book><chapter><title>
en: Uploading the package
ja: パッケージをアップロードする

note: type: Content of: <book><chapter><para>
en: Now that you have tested your new package thoroughly, you want to release it to a public archive to share it.
ja: あなたの新しいパッケージは徹底的にテストできたので、あなたはそれを共有すべく公開アーカイブにリリースしたいでしょう。

note: type: Content of: <book><chapter><section><title>
en: Uploading to the Debian archive
ja: Debian アーカイブへアップロードする

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <xref linkend="socialdynamics"/>.
ja: <xref linkend="socialdynamics"/>を参照下さい。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: There are publicly accessible archives such as <ulink url="&mentors-dn;"/> which work almost the same way as the Debian archive and provide an upload area for non-DDs.  You can set up an equivalent archive by yourself using the tools listed at <ulink url="&deb-archive;"/>.  So this section is useful for non-DDs, too.
ja: Debian アーカイブとほぼ同様に機能し、非-DD に対してアップロードエリアを提供する <ulink url="&mentors-dn;"/> のような公開アーカイブがあります。<ulink url="&deb-archive;"/> に列記されているツールを使い自分自身で同様のアーカイブを設定することも出来ます。だからこのセクションは非-DD にも有用です。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: The <systemitem role="package">dput</systemitem> package seems to come with more features and to be becoming more popular than the <systemitem role="package">dupload</systemitem> package.  It uses the file <filename>/etc/dput</filename> for its global configuration and the file <filename>~/.dput.cf</filename> for per-user configuration.  It supports Ubuntu-related services out-of-the-box, too.
ja: <systemitem role="package">dput</systemitem> パッケージは、より多くの機能があり <systemitem role="package">dupload</systemitem> パッケージより人気が出てきています。それは、<filename>/etc/dput</filename> ファイルをグローバル設定に用い、 <filename>~/.dput.cf</filename> ファイルをユーザー毎の設定に用います。更にそれは、そのままUbuntu関連のサービスもサポートします。

note: type: Content of: <book><chapter><section><para>
en: Once you become an official developer, <placeholder type="footnote" id="0"/> you can upload the package to the Debian archive.  <placeholder type="footnote" id="1"/> You can do this manually, but it's easier to use the existing automated tools, like <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> or <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry>.  We'll describe how it's done with <command>dupload</command>.  <placeholder type="footnote" id="2"/>
ja: 正規デベロッパー<placeholder type="footnote" id="0"/>になると、パッケージを Debian アーカイブにアップロードできます。<placeholder type="footnote" id="1"/> 手動でもできますが、 <citerefentry> <refentrytitle>dupload</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> や <citerefentry> <refentrytitle>dput</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> 等の既存の自動化ツールを用いる方が楽です。ここでは <command>dupload</command> を使ってどうするかを説明します。<placeholder type="footnote" id="2"/>

note: type: Content of: <book><chapter><section><para>
en: First you have to set up <command>dupload</command>'s config file.  You can either edit the system-wide <filename>/etc/dupload.conf</filename> file, or have your own <filename>~/.dupload.conf</filename> file override the few things you want to change.
ja: まず <command>dupload</command> の設定ファイルを調整しなければいけません。 システム全体の設定ファイルである <filename>/etc/dupload.conf</filename> を編集するか、あるいはあなた専用の設定ファイルである <filename>~/.dupload.conf</filename> を使って変更したい項目だけをオーバーライドさせてもかまいません。

note: type: Content of: <book><chapter><section><para>
en: You can read the <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> manual page to understand what each of these options means.
ja: またそれぞれのオプションが持つ意味を理解するため <citerefentry> <refentrytitle>dupload.conf</refentrytitle> <manvolnum>5</manvolnum> </citerefentry> マニュアルページを読むことができます。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&devref-upload;">Debian Developer's Reference 5.6, "Uploading a package"</ulink>.
ja: <ulink url="&devref-upload;">Debian Developer's Reference 5.6, "Uploading a package"</ulink> を参照下さい。

note: type: Content of: <book><chapter><section><para>
en: The <literal>$default_host</literal> option determines which of the upload queues will be used by default.  <literal>anonymous-ftp-master</literal> is the primary one, but it's possible that you will want to use another one.  <placeholder type="footnote" id="0"/>
ja: <literal>$default_host</literal> オプションはデフォルトで利用されるアップロードキューを指定します。<literal>anonymous-ftp-master</literal>がメインのアップロードキューですが、別のアップロードキューを利用したいこともあるでしょう。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><chapter><section><para>
en: While connected to the Internet, you can upload your package as follows:
ja: インターネットにつながった状態で、以下のようにすればあなたのパッケージをアップロード出来ます:

note: type: Content of: <book><chapter><section><para>
en: <command>dupload</command> checks that the SHA1/SHA256 file checksums match those listed in the <filename>.changes</filename> file.  If they do not match, it will warn you to rebuild it as described in <xref linkend="completebuild"/> so it can be properly uploaded.
ja: <command>dupload</command> は各ファイルの SHA1/SHA256 チェックサムを計算し、 <filename>.changes</filename> ファイルの中の情報と照合します。 もしそれらが一致しない場合には、適正にアップロードされるように<xref linkend="completebuild"/> の説明に従って最初から再ビルドをするよう警告します。

note: type: Content of: <book><chapter><section><para><footnote><para>
en: See <ulink url="&uploadqueue-readme;"/>.  Alternatively, you can use the <command>dcut</command> command from the <systemitem role="package">dput</systemitem> package.
ja: <ulink url="&uploadqueue;README">&uploadqueue;README</ulink> を参照下さい。<systemitem role="package">dput</systemitem> パッケージ中にある <command>dcut</command> コマンドをこれに代わる方法として用いることもできます。

note: type: Content of: <book><chapter><section><para>
en: If you encounter an upload problem at <ulink url="&uploadqueue;"/>, you can fix this by manually uploading a GPG-signed <filename>*.commands</filename> file to there with <command>ftp</command>.  <placeholder type="footnote" id="0"/> For example, using <filename>hello.commands</filename>:
ja: <ulink url="&uploadqueue;">&uploadqueue;</ulink>へのアップロードで問題があった場合には、GPG 署名した <filename>*.commands</filename> ファイルを <command>ftp</command> を用いて<command>ftp</command>で手動アップロードすることで修正出来ます。 <placeholder type="footnote" id="0"/> 例えば、<filename>hello.commands</filename> を使います:

note: type: Content of: <book><chapter><section><title>
en: Including <filename>orig.tar.gz</filename> for upload
ja: アップロード用<filename>orig.tar.gz</filename>の内容

note: type: Content of: <book><chapter><section><para>
en: When you first upload the package to the archive, you need to include the original <filename>orig.tar.gz</filename> source, too.  If the Debian revision number of this package is neither <literal>1</literal> nor <literal>0</literal>, you must provide the <command>dpkg-buildpackage</command> option <literal>-sa</literal>.
ja: はじめてパッケージをアーカイブにアップロードする際は、オリジナルの<filename>orig.tar.gz</filename> ソースファイルを含めなければなりません。当該パッケージの Debian リビジョン番号が <literal>1</literal> でも <literal>0</literal> でも無い場合には、<command>dpkg-buildpackage</command> に <literal>-sa</literal> オプションを付けなければなりません。

note: type: Content of: <book><chapter><section><para>
en: For the <command>dpkg-buildpackage</command> command:
ja: <command>dpkg-buildpackage</command> コマンドの場合:

note: type: Content of: <book><chapter><section><para>
en: For the <command>debuild</command> command:
ja: <command>debuild</command>コマンドの場合:

note: type: Content of: <book><chapter><section><para>
en: For the <command>pdebuild</command> command:
ja: <command>debuild</command>コマンドの場合:

note: type: Content of: <book><chapter><section><para>
en: On the other hand, the <literal>-sd</literal> option will force the exclusion of the original <filename>orig.tar.gz</filename> source.
ja: 逆に、<literal>-sd</literal>オプションを付けると、オリジナルの<filename>orig.tar.gz</filename> ソースファイルを強制的に除外します。

note: type: Content of: <book><chapter><section><title>
en: Skipped uploads
ja: スキップされたアップロード

note: type: Content of: <book><chapter><section><para>
en: If you created multiple entries in <filename>debian/changelog</filename> by skipping uploads, you must create a proper <filename>*_.changes</filename> file that includes all changes since the last upload.  This can be done by specifying the <command>dpkg-buildpackage</command> option <literal>-v</literal> with the version, e.g., <literal><replaceable>1.2</replaceable></literal>.
ja: アップロードをスキップすることで <filename>debian/changelog</filename> 中に複数の項目を作成した場合は、前回アップロード以来の全ての変更を含む適切な <filename>*_.changes</filename> ファイルを作成しなければいけません。 <command>dpkg-buildpackage</command> オプションの <literal>-v</literal> を、例えば <literal><replaceable>1.2</replaceable></literal> と言うバージョンに関して指定すると可能です。

note: type: Content of: <book><appendix><title>
en: Advanced packaging
ja: 上級パッケージング

note: type: Content of: <book><appendix><para>
en: Here are some hints and pointers for advanced packaging topics that you are most likely to deal with.  You are strongly advised to read all the references suggested here.
ja: あなたが出会いそうな上級パッケージング課題に関するヒントや外部参照をいくつか記します。ここに提案されたレファレンス全てに目を通すことを切にお薦めします。

note: type: Content of: <book><appendix><para>
en: You may need to manually edit the packaging template files generated by the <command>dh_make</command> command to address topics covered in this chapter.  The newer <command>debmake</command> command should address these topics better.
ja: 本章で取り上げたトピックをカバーするには <command>dh_make</command> コマンドで生成されたパッケージ用テンプレートファイルではマニュアル編集する必要があるかもしれません。より新しい <command>debmake</command> コマンドはこのようなトピックへの対応が優れています。

note: type: Content of: <book><appendix><section><title>
en: Shared libraries
ja: 共有ライブラリー

note: type: Content of: <book><appendix><section><para>
en: Before packaging shared <ulink url="&library;">libraries</ulink>, you should read the following primary references in detail:
ja: 共有 <ulink url="&library;">ライブラリー</ulink> をパッケージングする前に、以下の 一次レファレンスを詳細に読むべきです:

note: type: Content of: <book><appendix><section><para>
en: Here are some oversimplified hints for you to get started:
ja: 以下はあなたが手を付け始めるための少々簡略化しすぎたヒントです:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are <ulink url="&elf;">ELF</ulink> object files containing compiled code.
ja: 共有ライブラリーとはコンパイルされたコードを含む <ulink url="&elf;">ELF</ulink> オブジェクトファイルです。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are distributed as <filename>*.so</filename> files. (Neither <filename>*.a</filename> files nor <filename>*.la</filename> files)
ja: 共有ライブラリーは <filename>*.so</filename> ファイルとして頒布されます。(<filename>*.a</filename> ファイルでも <filename>*.la</filename> ファイルでもありません)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are mainly used to share common codes among multiple executables with the <command>ld</command> mechanism.
ja: 主に、共有ライブラリーは <command>ld</command> メカニズムを用い複数の実行プログラム間でコードを共有するのに使用されます。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries are sometimes used to provide multiple plugins to an executable with the <command>dlopen</command> mechanism.
ja: 時々、共有ライブラリーは <command>dlopen</command> メカニズムを用いある実行プログラムに複数のプラグインを提供するのに使用されます。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Shared libraries export <ulink url="&symbol;">symbols</ulink>, which represent compiled objects such as variables, functions, and classes; and enable access to them from the linked executables.
ja: 共有ライブラリーは変数や関数やクラスのようなコンパイルされたオブジェクトを表す <ulink url="&symbol;">シンボル</ulink> をエキスポートし、リンクされた実行プログラムからそれらへのアクセスを可能とします。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>
ja: もしくは: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The <ulink url="&soname;">SONAME</ulink> of a shared library <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>
ja: 共有ライブラリー <filename>lib<replaceable>foo</replaceable>.so</filename>.<replaceable>1</replaceable> の <ulink url="&soname;">SONAME</ulink>: <literal>objdump -p lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep SONAME</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of a shared library usually matches the library file name (but not always).
ja: 共有ライブラリーの SONAME は通常ライブラリーのファイル名と一致します(例外もあります)。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: Alternatively: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>
ja: もしくは: <literal>readelf -d lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable> | grep NEEDED</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The SONAME of shared libraries linked to <filename><replaceable>/usr/bin/foo</replaceable></filename>: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>
ja: <filename><replaceable>/usr/bin/foo</replaceable></filename> にリンクされた共有ライブラリーの SONAME: <literal>objdump -p <replaceable>/usr/bin/foo</replaceable> | grep NEEDED</literal> <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink>.
ja: <ulink url="&policy-runtime;">Debian Policy Manual, 8.1 "Run-time shared libraries"</ulink> を参照下さい。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: the library package for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> with the SONAME ABI version <replaceable>1</replaceable>.<placeholder type="footnote" id="0"/>
ja: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>: 共有ライブラリー <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> で SONAME ABI バージョンが <replaceable>1</replaceable> のライブラリーパッケージ。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-ldconfig;">Debian Policy Manual, 8.1.1 "ldconfig"</ulink>.
ja: <ulink url="&policy-ldconfig;">Debian Policy Manual, 8.1.1 "ldconfig"</ulink> を参照下さい。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: The package maintainer scripts of the library package must call <command>ldconfig</command> under the specific circumstances to create the necessary symbolic links for the SONAME.<placeholder type="footnote" id="0"/>
ja: ライブラリーパッケージのパッケージメンテナースクリプトは SONAME に必要なシンボリックリンクを作成するために特定の環境下で <command>ldconfig</command> を呼ばなければいけません。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable>-dbg</systemitem>: the debugging symbols package that contains the debugging symbols for the shared library package <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem>.
ja: <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable>-dbg</systemitem>: 共有ライブラリー <systemitem role="package">lib<replaceable>foo</replaceable><replaceable>1</replaceable></systemitem> のデバッグシンボルを含むデバッグシンボルパッケージ。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&policy-static;">Debian Policy Manual, 8.3 "Static libraries"</ulink> and <ulink url="&policy-dev;">Debian Policy Manual, 8.4 "Development files"</ulink>.
ja: See <ulink url="&policy-static;">Debian Policy Manual, 8.3 "Static libraries"</ulink> and <ulink url="&policy-dev;">Debian Policy Manual, 8.4 "Development files"</ulink> を参照下さい。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <systemitem role="package">lib<replaceable>foo</replaceable>-dev</systemitem>: the development package that contains the header files etc. for the shared library <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename>.<placeholder type="footnote" id="0"/>
ja: <systemitem role="package">lib<replaceable>foo</replaceable>-dev</systemitem>: 共有ライブラリー <filename>lib<replaceable>foo</replaceable>.so.<replaceable>1</replaceable></filename> 用のヘッダーファイル他を含む開発用パッケージ 。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink>.
ja: <ulink url="&removela;">Debian wiki ReleaseGoals/LAFileRemoval</ulink> を参照下さい。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Debian packages should not contain <filename>*.la</filename> Libtool archive files in general.<placeholder type="footnote" id="0"/>
ja: Debian パッケージは一般的に <filename>*.la</filename> Libtool アーカイブファイルを含んではいけません。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: See <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink>.
ja: <ulink url="&rpathissues;">Debian wiki RpathIssue</ulink> を参照下さい。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Debian packages should not use RPATH in general.<placeholder type="footnote" id="0"/>
ja: Debian パッケージは一般的に RPATH を使うべきではありません。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Although it is somewhat outdated and is only a secondary reference, <ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> may still be useful.
ja: 少々内容が古くなった二次的なレファレンスですが、<ulink url="&debianlibrarypackagingguide;">Debian Library Packaging Guide</ulink> はまだ有用かもしれません。

note: type: Content of: <book><appendix><section><title>
en: Managing <filename>debian/<replaceable>package</replaceable>.symbols</filename>
ja: <filename>debian/<replaceable>package</replaceable>.symbols</filename> の管理

note: type: Content of: <book><appendix><section><para><footnote><para>
en: Backward-incompatible ABI changes normally require you to update the SONAME of the library and the shared library package name to new ones.
ja: 後方非互換な ABI 変更をした場合、通常、ライブラリーの SONAME と共有ライブラリーパッケージ名を新規なものにそれぞれアップデートしないといけません。

note: type: Content of: <book><appendix><section><para>
en: When you package a shared library, you should create a <filename>debian/<replaceable>package</replaceable>.symbols</filename> file to manage the minimal version associated with each symbol for backward-compatible ABI changes under the same SONAME of the library for the same shared library package name.<placeholder type="footnote" id="0"/> You should read the following primary references in detail:
ja: 共有ライブラリーをパッケージする際には、同一共有ライブラリーパッケージ名のライブラリーの同一 SONAME の下での後方互換性のある変更に関して、各シンボルと関連付けられる最小のバージョンが記された <filename>debian/<replaceable>package</replaceable>.symbols</filename> ファイルを作成すべきです。<placeholder type="footnote" id="0"/> 以下の一次的レファレンスを詳細に読むべきです:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: For C++ libraries and other cases where tracking individual symbols is too difficult, follow <ulink url="&policy-library-shlibs;">Debian Policy Manual, 8.6.4 "The shlibs system"</ulink>, instead.
ja: C++ ライブラリーや個別シンボルを追跡するのが非常に困難な他の場合には、これに代えて <ulink url="&policy-library-shlibs;">Debian Policy Manual, 8.6.4 "The shlibs system"</ulink> に従いましょう。

note: type: Content of: <book><appendix><section><para>
en: Here is a rough example of how to create the <systemitem role="package">libfoo1</systemitem> package from the upstream version <literal>1.3</literal> with the proper <filename>debian/libfoo1.symbols</filename> file:
ja: 過去バージョン <literal>1.3</literal> のアップストリームバージョンから適切な <filename>debian/libfoo1.symbols</filename> ファイルを用いて <systemitem role="package">libfoo1</systemitem> パッケージを作成する概略例は以下です:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Prepare the skeleton debianized source tree using the upstream <filename>libfoo-1.3.tar.gz</filename> file.
ja: アップストリームの <filename>libfoo-1.3.tar.gz</filename> ファイルを用いてDebian 化したソースツリーの骨子を準備します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If this is the first packaging of the <systemitem role="package">libfoo1</systemitem> package, create the <filename>debian/libfoo1.symbols</filename> file with empty content.
ja: もし <systemitem role="package">libfoo1</systemitem> パッケージの最初のパッケージングの場合は、内容が空の <filename>debian/libfoo1.symbols</filename> ファイルを作成します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If the previous upstream version <literal>1.2</literal> was packaged as the <systemitem role="package">libfoo1</systemitem> package with the proper <filename>debian/libfoo1.symbols</filename> in its source package, use it again.
ja: もし以前のアップストリームバージョン <literal>1.2</literal> が <systemitem role="package">libfoo1</systemitem> パッケージとして適切な <filename>debian/libfoo1.symbols</filename> を用いてパッケージされていた場合には、それを再び使いましょう。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: All previous versions of Debian packages are available at <ulink url="&snapshot;">http://snapshot.debian.org/</ulink>.  The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> and <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>
ja: Debian パッケージの過去全てのバージョンは <ulink url="&snapshot;">http://snapshot.debian.org/</ulink> から得られます。 パッケージのバックポートが楽にできるように Debian リビジョンはバージョンから取り除きます。: <literal>1.1</literal> &lt;&lt; <literal>1.1-1~bpo70+1</literal> &lt;&lt; <literal>1.1-1</literal> と <literal>1.2</literal> &lt;&lt; <literal>1.2-1~bpo70+1</literal> &lt;&lt; <literal>1.2-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If the previous upstream version <literal>1.2</literal> was not packaged with <filename>debian/libfoo1.symbols</filename>, create it as the <filename>symbols</filename> file from all available binary packages of the same shared library package name containing the same SONAME of the library, for example, versions <literal>1.1-1</literal> and <literal>1.2-1</literal>.  <placeholder type="footnote" id="0"/>
ja: もし過去のアップストリームバージョン <literal>1.2</literal> が <filename>debian/libfoo1.symbols</filename> を用いてパッケージされていない場合には、そのライブラリーの同一 SONAME を含む同一共有ライブラリーパッケージ名 の全ての手に入るバイナリーパッケージ、例えば <literal>1.1-1</literal> と <literal>1.2-1</literal> バージョンから、それを <filename>symbols</filename> として生成できます。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Make trial builds of the source tree with tools such as <command>debuild</command> and <command>pdebuild</command>.  (If this fails due to missing symbols etc., there were some backward-incompatible ABI changes that require you to bump the shared library package name to something like <systemitem role="package">libfoo1a</systemitem> and you should start over again.)
ja: <command>debuild</command> や <command>pdebuild</command> 等のツールを使ってソースツリーのテストビルドをします。 (もしシンボルの欠如等でビルドがうまく行かない場合には、共有ライブラリーパッケージ名を <systemitem role="package">libfoo1a</systemitem> 等と繰り上げる必要のある何らかの後方非互換な ABI 変更があったので、最初からやり直す必要があります。)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para><footnote><para>
en: The Debian revision is dropped from the version to make it easier to backport the package: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>
ja: Debian リビジョンはパッケージのバックポートを容易にすべく外します: <literal>1.3</literal> &lt;&lt; <literal>1.3-1~bpo70+1</literal> &lt;&lt; <literal>1.3-1</literal>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: If you see the diff printed by the <command>dpkg-gensymbols</command> as above, extract the proper updated <filename>symbols</filename> file from the generated binary package of the shared library.  <placeholder type="footnote" id="0"/>
ja: もし上記のように <command>dpkg-gensymbols</command> によって diff がプリントされるのを発見した場合には、生成された共有ライブラリーのバイナリーパッケージから適切な <filename>symbols</filename> ファイルを抽出しましょう。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build release packages with tools such as <command>debuild</command> and <command>pdebuild</command>.
ja: <command>debuild</command> や <command>pdebuild</command> のようなツールでリリースパッケージをビルドします。

note: type: Content of: <book><appendix><section><para><footnote><para>
en: See <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink>.
ja: <ulink url="&policy-library-abi;">Debian Policy Manual, 8.6.2 "Shared library ABI changes"</ulink> を参照下さい。

note: type: Content of: <book><appendix><section><para>
en: In addition to the above examples, we need to check the ABI compatibility further and bump versions for some symbols manually as needed.  <placeholder type="footnote" id="0"/>
ja: 上記の例に加えて、更に ABI 互換性を確認し、必要に応じていくつかのシンボルのバージョンを手作業で繰り上げる必要があります。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><para>
en: Although it is only a secondary reference, <ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> and its linked web pages may be useful.
ja: 二次的なレファレンスではありますが、<ulink url="&usingsymbolsfiles;">Debian wiki UsingSymbolsFiles</ulink> とそこからリンクされているウェブページは有用かもしれません。

note: type: Content of: <book><appendix><section><title>
en: Multiarch
ja: マルチアーチ

note: type: Content of: <book><appendix><section><para>
en: The multiarch feature introduced to Debian wheezy integrates support for cross-architecture installation of binary packages (particularly <literal>i386</literal>&lt;-&gt;<literal>amd64</literal>, but also other combinations) in <systemitem role="package">dpkg</systemitem> and <systemitem role="package">apt</systemitem>. You should read the following references in detail:
ja: Debian wheezy で導入されたマルチアーチ機能は <systemitem role="package">dpkg</systemitem> と <systemitem role="package">apt</systemitem> の中でのバイナリーパッケージのアーキテクチャー間サポート (他の組み合わせもありますが、特に<literal>i386</literal>&lt;-&gt;<literal>amd64</literal>) を統合します。 以下のレファレンスを詳細に読んで下さい:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (upstream)
ja: <ulink url="&multiarchspec;">Ubuntu wiki MultiarchSpec</ulink> (アップストリーム)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (Debian situation)
ja: <ulink url="&multiarchimplementation;">Debian wiki Multiarch/Implementation</ulink> (Debian の状況)

note: type: Content of: <book><appendix><section><para><footnote><para>
en: Old special purpose library paths such as <filename>/lib32/</filename> and <filename>/lib64/</filename> are not used anymore.
ja: 旧来の <filename>/lib32/</filename> や <filename>/lib64/</filename> 等の特定目的のライブラリーパスは使われなくなっています。

note: type: Content of: <book><appendix><section><para>
en: It uses the triplet such as <literal>i386-linux-gnu</literal> and <literal>x86_64-linux-gnu</literal> for the install path of shared libraries. The actual triplet path is dynamically set into the <literal>$(DEB_HOST_MULTIARCH)</literal> variable using the <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle><manvolnum>1</manvolnum></citerefentry> command for each binary package build. For example, the path to install multiarch libraries are changed as follows:<placeholder type="footnote" id="0"/>
ja: マルチアーチは共有ライブラリーのインストールパスに <literal>i386-linux-gnu</literal> や <literal>x86_64-linux-gnu</literal> 等のトリプレットを使います。実際のトリプレットパスは、ビルドごとに <citerefentry> <refentrytitle>dpkg-architecture</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> によって動的に <literal>$(DEB_HOST_MULTIARCH)</literal> 値として設定されます。例えば、マルチアーチライブラリーをインストールするパスは以下のように変更されます: <placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Old path
ja: 旧パス

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: i386 multiarch path
ja: i386 マルチアーチパス

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: amd64 multiarch path
ja: amd64 マルチアーチパス

note: type: Content of: <book><appendix><section><para>
en: Here are some typical multiarch package split scenario examples for the following:
ja: 以下の場合に関する典型的なパッケージ分割シナリオの例を示します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a library source <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>
ja: ライブラリーソース <filename>lib<replaceable>foo</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>bar</replaceable>-1.tar.gz</filename> written in a compiled language
ja: コンパイラー用の言語で書かれたツールのソース <filename><replaceable>bar</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: a tool source <filename><replaceable>baz</replaceable>-1.tar.gz</filename> written in an interpreted language
ja: インタープリター用言語で書かれたツールのソース <filename><replaceable>baz</replaceable>-1.tar.gz</filename>

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package
ja: パッケージ

note: type: Content of: <book><appendix><section><informaltable><tgroup><thead><row><entry>
en: Package content
ja: パッケージ内容

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library, co-installable
ja: 共有ライブラリー、同時インストール可能

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library debug symbols, co-installable
ja: 共有ライブラリーデバッグシンボル、同時インストール可能

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library header files etc., co-installable
ja: 共有ライブラリーヘッダーファイル他、同時インストール可能

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the run-time support programs, not co-installable
ja: 実行時サポートプログラム、同時インストール不可

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the shared library documentation files
ja: 共有ライブラリーのドキュメンテーションファイル

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the compiled program files, not co-installable
ja: コンパイルされ実行されるプログラムファイル、同時インストール不可

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the documentation files for the program
ja: プログラムのドキュメンテーションファイル

note: type: Content of: <book><appendix><section><informaltable><tgroup><tbody><row><entry>
en: the interpreted program files
ja: インタープリターで実行されるプログラムファイル

note: type: Content of: <book><appendix><section><para>
en: Please note that the development package should contain a symlink for the associated shared library <emphasis role="strong">without a version number</emphasis>.  E.g.: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>
ja: 開発パッケージは関連した共有ライブラリーへの<emphasis role="strong">バージョン番号無しの</emphasis>シンボリックリンクを含んでいるべきです。例えば: <filename>/usr/lib/x86_64-linux-gnu/libfoo.so</filename> -&gt; <filename>libfoo.so.1</filename>

note: type: Content of: <book><appendix><section><title>
en: Building a shared library package
ja: 共有ライブラリーパッケージのビルド

note: type: Content of: <book><appendix><section><para>
en: You can build a Debian library package enabling multiarch support using <citerefentry> <refentrytitle>dh</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> as follows:
ja: <citerefentry> <refentrytitle>dh</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> を以下のように使えばマルチアーチをサポートするようにして Debian のライブラリーパッケージをビルドできます:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Update <filename>debian/control</filename>.
ja: <filename>debian/control</filename> を更新します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Build-Depends: debhelper (>=10)</literal> for the source package section.
ja: ソースパッケージセクションに <literal>Build-Depends: debhelper (>=10)</literal> を追加します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Pre-Depends: ${misc:Pre-Depends}</literal> for each shared library binary package.
ja: 共有ライブラリーのバイナリーパッケージごとに <literal>Pre-Depends: ${misc:Pre-Depends}</literal> を追加します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Add <literal>Multi-Arch:</literal> stanza for each binary package section.
ja: <literal>Multi-Arch:</literal> スタンザを各バイナリーパッケージセクション毎に追加します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Set <filename>debian/compat</filename> to "10".
ja: <filename>debian/compat</filename> を "10" と設定します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Adjust the path from the normal <literal>/usr/lib/</literal> to the multiarch <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> for all packaging scripts.
ja: すべてのパッケージングスクリプトに関して、通常の <literal>/usr/lib/</literal> から、マルチアーチの <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> へとパスを調整します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Call <literal>DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)</literal> in <filename>debian/rules</filename> to set the <literal>DEB_HOST_MULTIARCH</literal> variable first.
ja: 最初に <filename>debian/rules</filename> 中で <literal>DEB_HOST_MULTIARCH ?= $(shell dpkg-architecture -qDEB_HOST_MULTIARCH)</literal> を呼び <literal>DEB_HOST_MULTIARCH</literal> 変数を設定します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace <literal>/usr/lib/</literal> with <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> in <filename>debian/rules</filename>.
ja: <filename>debian/rules</filename> 中の <literal>/usr/lib/</literal> を <literal>/usr/lib/$(DEB_HOST_MULTIARCH)/</literal> で置き換えます。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para><footnote><para>
en: Alternatively, you can add <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> and <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> arguments to <literal>./configure</literal>.  Please note that <literal>--libexecdir</literal> specifies the default path to install executable programs run by other programs rather than by users.  Its Autotools default is <filename>/usr/libexec/</filename> but its Debian default is <filename>/usr/lib/</filename>.
ja: これに代えて、<literal>./configure</literal> に <literal>--libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> と <literal>--libexecdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)</literal> 引数を追加することもできます。注意いただきたいのは、ユーザーではなく他のプログラムによりのみ実行される実行プログラムをインストールするデフォルトパスを <literal>--libexecdir</literal> は設定します。その Autotools のデフォルトは <filename>/usr/libexec/</filename> ですが、Debian デフォルトは <filename>/usr/lib/</filename> です。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: If <literal>./configure</literal> is used in part of the <literal>override_dh_auto_configure</literal> target in <filename>debian/rules</filename>, make sure to replace it with <literal>dh_auto_configure -- </literal>.  <placeholder type="footnote" id="0"/>
ja: もし <filename>debian/rules</filename> 中の <literal>override_dh_auto_configure</literal> ターゲットの一部分として <literal>./configure</literal> が用いられている場合には、それを <literal>dh_auto_configure -- </literal> と置き換えるようにしましょう。<placeholder type="footnote" id="0"/>

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Replace all occurrences of <literal>/usr/lib/</literal> with <literal>/usr/lib/*/</literal> in <filename>debian/<replaceable>foo</replaceable>.install</filename> files.
ja: <filename>debian/<replaceable>foo</replaceable>.install</filename> ファイル中にある全ての <literal>/usr/lib/</literal> を <literal>/usr/lib/*/</literal> で置き換えます。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><itemizedlist><listitem><para>
en: Generate files like <filename>debian/<replaceable>foo</replaceable>.links</filename> from <filename>debian/<replaceable>foo</replaceable>.links.in</filename> dynamically by adding a script to the <literal>override_dh_auto_configure</literal> target in <filename>debian/rules</filename>.
ja: <filename>debian/rules</filename> 中の <literal>override_dh_auto_configure</literal> ターゲットにスクリプトを追加し <filename>debian/<replaceable>foo</replaceable>.links.in</filename> から <filename>debian/<replaceable>foo</replaceable>.links</filename> を動的に生成します。

note: type: Content of: <book><appendix><section><para>
en: Please make sure to verify that the shared library package contains only the expected files, and that your -dev package still works.
ja: 共有ライブラリーパッケージが期待されるファイルのみを含み、-dev パッケージも依然として動作することを確認しましょう。

note: type: Content of: <book><appendix><section><para>
en: All files installed simultaneously as the multiarch package to the same file path should have exactly the same file content.  You must be careful of differences generated by the data byte order and by the compression algorithm.
ja: マルチアーチパッケージとして同時に同一パスにインストールされる全てのファイルはファイルの内容が完全に同じあるべきです。データのバイトオーダーや圧縮アルゴリズムにより生成される相違に注意すべきです。

note: type: Content of: <book><appendix><section><title>
en: Native Debian package
ja: ネイティブ Debian パッケージ

note: type: Content of: <book><appendix><section><para>
en: If a package is maintained only for Debian or possibly only for local use, its source may contain all the <filename>debian/*</filename> files in it.  There are 2 ways to package it.
ja: もしパッケージが Debian のためだけとか、またローカル使用のために保守されている場合、そのソースファイルは <filename>debian/*</filename> ファイルすべてをその中に含まれます。それをパッケージするのには2つの方法があります。

note: type: Content of: <book><appendix><section><para>
en: You can make the upstream tarball by excluding the <filename>debian/*</filename> files and package it as a non-native Debian package as in <xref linkend="workflow"/>.  This is the normal way, which some people encourage using.
ja: <filename>debian/*</filename> ファイルを除外したアップストリームターボールを作成し、<xref linkend="workflow"/> にあるようにしてノンネイティブ Debian パッケージできます。これが一部の人に推奨される通常の方法です。

note: type: Content of: <book><appendix><section><para>
en: The alternative is the workflow of the native Debian package.
ja: この代わりの方法は、ネイティブ Debian パッケージのワークフローです。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Create a native Debian source package in the <literal>3.0 (native)</literal> format using a single compressed tar file in which all files are included.
ja: 全てのファイルが含まれる単一の圧縮された tar ファイルを用いる <literal>3.0 (native)</literal> フォーマットでネイティブの Debian ソースパッケージを作成します。

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: Build Debian binary packages from the native Debian source package.
ja: ネイティブ Debian ソースパッケージから、Debian バイナリーパッケージをビルドします。

note: type: Content of: <book><appendix><section><para>
en: For example, if you have source files in <filename>~/mypackage-1.0</filename> without the <filename>debian/*</filename> files, you can create a native Debian package by issuing the <command>dh_make</command> command as follows:
ja: 例えば <filename>debian/*</filename> ファイルを含まない <filename>~/mypackage-1.0</filename> ソースファイルがあれば、以下のように  <command>dh_make</command> コマンドを用いてネイティブ Debian パッケージが作れます:

note: type: Content of: <book><appendix><section><para>
en: Then the <filename>debian</filename> directory and its contents are created just like in <xref linkend="non-native-dh-make"/>.  This does not create a tarball, since this is a native Debian package.  But that is the only difference.  The rest of the packaging activities are practically the same.
ja: すると、<filename>debian</filename> ディレクトリーとその内容は <xref linkend="non-native-dh-make"/> とちょうど同じように作成されます。これはネイティブ Debian パッケージなので tar アーカイブを作りません。しかし相違点はこれだけです。他のパッケージング操作は実質的にまったく同じです。

note: type: Content of: <book><appendix><section><para>
en: After execution of the <command>dpkg-buildpackage</command> command, you will see the following files in the parent directory:
ja: <command>dpkg-buildpackage</command> コマンドを実行した後、親ディレクトリーに以下のファイルが生成します:

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is the source code tarball created from the <filename>mypackage-1.0</filename> directory by the <command>dpkg-source</command> command.  (Its suffix is not <filename>orig.tar.gz</filename>.)
ja: これは、<command>dpkg-source</command> コマンドにより <filename>mypackage-1.0</filename> ディレクトリーから作られたソースコードのターボールです。(そのサフィックスは <filename>orig.tar.gz</filename> ではありません。)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is a summary of the contents of the source code, as in the non-native Debian package. (There is no Debian revision.)
ja: これは、ノンネイティブ Debian パッケージと同様でソースコード内容の要約です。(Debian リビジョンはありません。)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This is your completed binary package, as in the non-native Debian package.  (There is no Debian revision.)
ja: これは、ノンネイティブ Debian パッケージと同様で完成したバイナリーパッケージです。(Debian リビジョンはありません。)

note: type: Content of: <book><appendix><section><itemizedlist><listitem><para>
en: This file describes all the changes made in the current package version as in the non-native Debian package. (There is no Debian revision.)
ja: これは、ノンネイティブ Debian パッケージと同様で現パッケージバージョンでの全変更を記述します。(Debian リビジョンはありません。)
