debhelper 9.20141107 - en to ja translation catalogue (520 entries)

note: type: =head1
en: NAME
ja: 名前

note: type: textblock
en: debhelper - the debhelper tool suite
ja: debhelper - debhelper 関連ツール群

note: type: =head1
en: SYNOPSIS
ja: 書式

note: type: =head1
en: DESCRIPTION
ja: 説明

note: type: textblock
en: Debhelper is used to help you build a Debian package. The philosophy behind debhelper is to provide a collection of small, simple, and easily understood tools that are used in F<debian/rules> to automate various common aspects of building a package. This means less work for you, the packager.  It also, to some degree means that these tools can be changed if Debian policy changes, and packages that use them will require only a rebuild to comply with the new policy.
ja: debhelper は、Debian パッケージのビルドを容易にするために使われます。debhelper の根底にある考えは「パッケージビルド時の各種の共通的な作業を自動化するために F<debian/rules> で用いられている、小さく単純で、容易に理解可能なツールをまとめて提供すること」です。つまり、あなた＝パッケージを作成する人の負担を減らします。さらに、Debian ポリシーが変わった場合にはこのツール群を多少変更さえすれば、debhelper を使っているパッケージが新しいポリシーに適合するのに必要になるのは、再ビルドだけになります。

note: type: textblock
en: A typical F<debian/rules> file that uses debhelper will call several debhelper commands in sequence, or use L<dh(1)> to automate this process. Examples of rules files that use debhelper are in F</usr/share/doc/debhelper/examples/>
ja: debhelper を利用している典型的な F<debian/rules> ファイルは、複数の debhelper コマンドを順番に呼び出しているか、L<dh(1)> を使って一連の処理を自動化しています。debhelper を使った rules ファイルの例は F</usr/share/doc/debhelper/examples/> にあります。

note: type: textblock
en: To create a new Debian package using debhelper, you can just copy one of the sample rules files and edit it by hand. Or you can try the B<dh-make> package, which contains a L<dh_make|dh_make(1)> command that partially automates the process. For a more gentle introduction, the B<maint-guide> Debian package contains a tutorial about making your first package using debhelper.
ja: debhelper を使って Debian パッケージを作成するには、サンプルの rules ファイルのどれかをコピーして手で修正するだけです。あるいは B<dh-make> パッケージを利用してみてください。このパッケージには部分的に作業を自動化してくれる L<dh_make|dh_make(1)> コマンドが含まれています。よりやさしい案内については、B<maint-guide-ja> パッケージに debhelper を使って初めてパッケージを作る人向けのチュートリアルが含まれています。

note: type: =head1
en: DEBHELPER COMMANDS
ja: DEBHELPER コマンド

note: type: textblock
en: Here is the list of debhelper commands you can use. See their man pages for additional documentation.
ja: 以下が利用可能な debhelper コマンドの一覧です。詳細は、各コマンド付属の man ページを参照してください。

note: type: =head2
en: Deprecated Commands
ja: 廃止されたコマンド一覧

note: type: textblock
en: A few debhelper commands are deprecated and should not be used.
ja: 廃止されており、使うべきでない debhelper コマンド一覧

note: type: =head2
en: Other Commands
ja: 他のコマンド

note: type: textblock
en: If a program's name starts with B<dh_>, and the program is not on the above lists, then it is not part of the debhelper package, but it should still work like the other programs described on this page.
ja: プログラムの名前が B<dh_> で始まり、先のリストにないものは、debhelper パッケージ付属のプログラムではありません。しかし、このような名前を持つコマンドは、このページに記述されている他のプログラムのように動作するべきです。

note: type: =head1
en: DEBHELPER CONFIG FILES
ja: DEBHELPER 設定ファイル

note: type: textblock
en: Many debhelper commands make use of files in F<debian/> to control what they do. Besides the common F<debian/changelog> and F<debian/control>, which are in all packages, not just those using debhelper, some additional files can be used to configure the behavior of specific debhelper commands. These files are typically named debian/I<package>.foo (where I<package> of course, is replaced with the package that is being acted on).
ja: debhelper のコマンドの多くは、どのように動作するかについて F<debian/> ディレクトリ以下にあるファイルを用います。共通の F<debian/changelog> や F<debian/control> はすべてのパッケージに存在していますが、これに加えて特定の debhelper コマンドの動作を制御できる追加ファイルがあります。これらのファイルは、大抵 debian/I<package>.foo というファイル名です (もちろん、I<package> は処理しようとしているパッケージ名に変えてください)。

note: type: textblock
en: For example, B<dh_installdocs> uses files named F<debian/package.docs> to list the documentation files it will install. See the man pages of individual commands for details about the names and formats of the files they use.  Generally, these files will list files to act on, one file per line. Some programs in debhelper use pairs of files and destinations or slightly more complicated formats.
ja: 例えば、B<dh_installdocs> では、インストールするドキュメントの一覧を得るのに F<debian/package.docs> という名前のファイルを利用します。各コマンドが使うファイルの名前とフォーマットについては、詳細はコマンドの man ページを参照してください。大抵、これらのファイルでは１行ごとに処理するファイルを１つずつ列挙します。いくつかの debhelper プログラムでは、ファイルと宛先の組み合わせや、もう少々複雑なフォーマットなどを使います。

note: type: textblock
en: In some rare cases, you may want to have different versions of these files for different architectures or OSes. If files named debian/I<package>.foo.I<ARCH> or debian/I<package>.foo.I<OS> exist, where I<ARCH> and I<OS> are the same as the output of "B<dpkg-architecture -qDEB_HOST_ARCH>" / "B<dpkg-architecture -qDEB_HOST_ARCH_OS>", then they will be used in preference to other, more general files.
ja: 稀ではありますが、これらのファイルを、異なるアーキテクチャ／異なる OS 用にそれぞれ用意したい場合があります。ファイル名が debian/I<package>.foo.I<ARCH> や、debian/I<package>.foo.I<OS> のものが存在すると、"B<dpkg-architecture -qDEB_HOST_ARCH>" / "B<dpkg-architecture -qDEB_HOST_ARCH_OS>" でそれぞれ指定した I<ARCH> と I<OS> を含むものが、通常のファイルよりも優先的に使われます。

note: type: textblock
en: Mostly, these config files are used to specify lists of various types of files. Documentation or example files to install, files to move, and so on.  When appropriate, in cases like these, you can use standard shell wildcard characters (B<?> and B<*> and B<[>I<..>B<]> character classes) in the files.  You can also put comments in these files; lines beginning with B<#> are ignored.
ja: 多くの場合、これらの設定ファイルは、いろいろな種類のファイルを列挙して指定するのに使われます。例えばインストールすべきドキュメントやサンプルファイルであったり、移動すべきファイルだったり等となります。シェルのワイルドカード文字列 (B<?>, B<*> 及び B<[>I<..>B<]> 文字クラス) をファイルに含める事ができ、状況次第ではこちらが望ましい事もあります。また、行頭がB <#> で始まる行は無視される事を利用して、コメントを記載できます。

note: type: =head1
en: SHARED DEBHELPER OPTIONS
ja: DEBHELPER 間で共有されるオプション

note: type: textblock
en: The following command line options are supported by all debhelper programs.
ja: 以下のコマンドラインオプションは、全ての debhelper プログラムでサポートされています。

note: type: textblock
en: Do not really do anything. If used with -v, the result is that the command will output what it would have done.
ja: 実際の処理を行いません。-v オプションと併用すると、コマンドがどのような処理を行うかが出力されます。

note: type: textblock
en: Act on architecture dependent packages that should be built for the B<DEB_HOST_ARCH> architecture.
ja: アーキテクチャ依存パッケージを、B<DEB_HOST_ARCH> アーテキクチャ向けにビルドするように動作します。

note: type: textblock
en: Act on all architecture independent packages.
ja: 全てのアーキテクチャ非依存パッケージに対して処理を行います。

note: type: textblock
en: Act on the package named I<package>. This option may be specified multiple times to make debhelper operate on a given set of packages.
ja: I<package> で指定されたパッケージに対して処理を行います。複数のパッケージを debhelper に処理させる際には、繰り返し列挙して指定してください。

note: type: textblock
en: Deprecated alias of B<-a>.
ja: 廃止された B<-a> のエイリアスです。

note: type: textblock
en: Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option lists the package as one that should be acted on.
ja: B<-a>, B<-i>, B<-p> オプションで処理すべきパッケージとして対象としていても、指定されているパッケージについては処理を行わないようにします。

note: type: textblock
en: Do not act on the packages which have already been acted on by this debhelper command earlier (i.e. if the command is present in the package debhelper log).  For example, if you need to call the command with special options only for a couple of binary packages, pass this option to the last call of the command to process the rest of packages with default settings.
ja: この debhelper コマンドにより、すでに処理済のパッケージについては処理をしないようにします (つまり、debhelper のログにコマンドの記録があるものは処理しない)。例えば、いくつかのバイナリパッケージだけに対して特別なオプション付きでコマンドを呼び出し、残りのパッケージに対しては本オプションをつけてコマンドを呼び出し、デフォルト設定による処理を行うという事ができます。

note: type: textblock
en: Use I<tmpdir> for package build directory. The default is debian/I<package>
ja: I<tmpdir> をパッケージビルドディレクトリとして利用します。デフォルトでは debian/I<package> ディレクトリが使われます。

note: type: textblock
en: This little-used option changes the package which debhelper considers the "main package", that is, the first one listed in F<debian/control>, and the one for which F<debian/foo> files can be used instead of the usual F<debian/package.foo> files.
ja: このあまり使われないオプションは、debhelper コマンドが "main package" とみなすパッケージ、つまり、F<debian/control> の最初に記載されたパッケージを変更するものです。これにより、通常の F<debian/package.foo> ファイルではなく F<debian/foo> ファイルが使われるようになります。

note: type: textblock
en: This is used by L<dh(1)> when passing user-specified options to all the commands it runs. If the command supports the specified option or option bundle, it will take effect. If the command does not support the option (or any part of an option bundle), it will be ignored.
ja: これは、実行するすべてのコマンドへユーザー指定のオプションを渡す際に L<dh(1)> が利用します。コマンドが指定のオプションをサポートしている、あるいは内蔵している場合は、オプションは効果を発揮します。コマンドが指定されたオプションをサポートしていない場合 (あるいは、内蔵しているオプションにない場合)、オプションは無視されます。

note: type: =head1
en: COMMON DEBHELPER OPTIONS
ja: DEBHELPER の共通オプション

note: type: textblock
en: The following command line options are supported by some debhelper programs.  See the man page of each program for a complete explanation of what each option does.
ja: 以下のコマンドラインオプションが、debhelper プログラムのうち複数でサポートされています。「オプションが何を意味するか」という完全な説明は、各コマンドの man ページを参照してください。

note: type: textblock
en: Do not modify F<postinst>, F<postrm>, etc. scripts.
ja: F<postinst>, F<postrm> 等のスクリプトに変更を加えません。

note: type: textblock
en: Makes files or other items that are specified on the command line take effect in ALL packages acted on, not just the first.
ja: コマンドラインで指定したファイル、あるいは他の item について、最初のパッケージだけでなく全パッケージに対して処理を行います。

note: type: =head1
en: BUILD SYSTEM OPTIONS
ja: ビルドシステム用オプション

note: type: textblock
en: The following command line options are supported by all of the B<dh_auto_>I<*> debhelper programs. These programs support a variety of build systems, and normally heuristically determine which to use, and how to use them.  You can use these command line options to override the default behavior.  Typically these are passed to L<dh(1)>, which then passes them to all the B<dh_auto_>I<*> programs.
ja: 以下のコマンドラインオプションが、すべての B<dh_auto_>I<*> の debhelper プログラムによってサポートされています。これらのプログラム群は様々なビルドシステムをサポートしており、通常の場合は推定によって、どのビルドシステムがどのように使われるかを決定します。これらのコマンドラインオプションを使って、デフォルトの動作を override することが可能です。大抵の場合は、これらのオプションはまず L<dh(1)> に渡され、それからすべての B<dh_auto_>I<*> プログラムへと渡されます。

note: type: textblock
en: Force use of the specified I<buildsystem>, instead of trying to auto-select one which might be applicable for the package.
ja: パッケージに合わせて自動的に選択されたビルドシステムではなく、I<buildsystem> で指定したビルドシステムを強制的に使用します。

note: type: textblock
en: Assume that the original package source tree is at the specified I<directory> rather than the top level directory of the Debian source package tree.
ja: オリジナルのソースツリーが、Debian ソースパッケージツリーの最上位のディレクトリではなく、I<directory> で指定した場所にあると仮定します。

note: type: textblock
en: Enable out of source building and use the specified I<directory> as the build directory. If I<directory> parameter is omitted, a default build directory will be chosen.
ja: ソースのビルドディレクトリ外にある、指定した I<directory> をビルドディレクトリとしてソースのビルドを有効にします。I<directory> パラメータが省略された場合はデフォルトのビルドディレクトリが利用されます。

note: type: textblock
en: If this option is not specified, building will be done in source by default unless the build system requires or prefers out of source tree building.  In such a case, the default build directory will be used even if B<--builddirectory> is not specified.
ja: このオプションが指定されない場合は、ビルドシステムがソースツリー外でのビルドを必要とする、あるいはそちらが望ましいと判断されない限り、デフォルトではソースディレクトリ内部でビルドが行われます。その場合、B<--builddirectory> が指定されていなくてもデフォルトのビルドディレクトリが使用されます。

note: type: textblock
en: If the build system prefers out of source tree building but still allows in source building, the latter can be re-enabled by passing a build directory path that is the same as the source directory path.
ja: ビルドシステムが、ソースディレクトリ以外の場所でビルドを選択してしまうけれどもソースディレクトリでのビルドが可能な場合には、ソースディレクトリのパスと同じものとしてビルドディレクトリのパスを指定すれば、ソースディレクトリ内でビルドを行うようにできます。

note: type: textblock
en: Control whether parallel builds should be used if underlying build system supports them.  The number of parallel jobs is controlled by the B<DEB_BUILD_OPTIONS> environment variable (L<Debian Policy, section 4.9.1>) at build time. It might also be subject to a build system specific limit.
ja: ビルドシステムがサポートしている場合、並列ビルドを有効にするかどうかを管理します。どれだけの数でジョブを並列にするかは、ビルドが行われる際に B<DEB_BUILD_OPTIONS> 環境変数によって決定されます (L<Debian ポリシーマニュアル、4.9.1章>)。ビルドシステム固有の制限に影響を受ける場合もあります。

note: type: textblock
en: If neither option is specified, debhelper currently defaults to B<--parallel> in compat 10 (or later) and B<--no-parallel> otherwise.
ja: どちらのオプションも指定されていない場合、debhelper は現在では互換性レベル 10 (以降) の場合は B<--parallel> をデフォルトに、そうでない場合は B<--no-parallel> が指定されます。

note: type: textblock
en: As an optimization, B<dh> will try to avoid passing these options to subprocesses, if they are unnecessary and the only options passed.  Notably this happens when B<DEB_BUILD_OPTIONS> does not have a I<parallel> parameter (or its value is 1).
ja: これらのオプションが不要である場合、あるいはこのオプションだけが渡された場合には、B<dh> はこれらのオプションをサブプロセスに渡すのを最適化のため避けようとします。特に、これは B<DEB_BUILD_OPTIONS> が I<parallel> パラメーターを持たない (またはこの値が 1 である) 場合に起こります。

note: type: textblock
en: This option implies B<--parallel> and allows further limiting the number of jobs that can be used in a parallel build. If the package build is known to only work with certain levels of concurrency, you can set this to the maximum level that is known to work, or that you wish to support.
ja: このオプションは B<--parallel> とともに利用し、並列ビルドにおける並列数の上限を引き上げます。もしパッケージが、とある並列数まででしかビルドできないことがわかっている場合、このオプションを使って最大限の並列数または利用したい並列数を指定できます。

note: type: textblock
en: Notably, setting the maximum to 1 is effectively the same as using B<--no-parallel>.
ja: 特に、最大値を 1 に設定するのは B<--no-parallel> を使うのと同じ効果があります。

note: type: textblock
en: List all build systems supported by debhelper on this system. The list includes both default and third party build systems (marked as such). Also shows which build system would be automatically selected, or which one is manually specified with the B<--buildsystem> option.
ja: このシステム上で、debhelper がサポートしているビルドシステム一覧を表示します。この一覧にはデフォルトのビルドシステム、そしてサードパーティー製 (であると明記されている) ビルドシステムの双方を含みます。また、どれが自動的に選択されたか、あるいは手動で B<--buildsystem> オプションにて何が指定されたのかも表示します。

note: type: =head1
en: COMPATIBILITY LEVELS
ja: 互換性レベル

note: type: textblock
en: Unless otherwise indicated, all debhelper documentation assumes that you are using the most recent compatibility level, and in most cases does not indicate if the behavior is different in an earlier compatibility level, so if you are not using the most recent compatibility level, you're advised to read below for notes about what is different in earlier compatibility levels.
ja: 特に指定が無い場合、debhelper のドキュメントは最新の互換性レベルを利用している事を前提とおり、多くの場合では以前の互換性レベルではどう動作が異なるかについては言及していません。最新の互換性レベルを使っていない場合には、それ以前の互換性レベルとはどう動作が違うのか、以下の説明を参照しておく事をおすすめします。

note: type: =head1
en: NOTES
ja: 付記

note: type: =head2
en: Multiple binary package support
ja: 複数のバイナリパッケージのサポート

note: type: textblock
en: If your source package generates more than one binary package, debhelper programs will default to acting on all binary packages when run. If your source package happens to generate one architecture dependent package, and another architecture independent package, this is not the correct behavior, because you need to generate the architecture dependent packages in the binary-arch F<debian/rules> target, and the architecture independent packages in the binary-indep F<debian/rules> target.
ja: ソースパッケージが複数のバイナリパッケージを生成する場合、デフォルトでは debhelper は実行時にすべてのバイナリパッケージを生成します。この場合ソースパッケージが、アーキテクチャ依存パッケージとアーキテクチャ非依存パッケージを同時に生成するとしたら、この振る舞いは正しくありません。というのも、F<debian/rules> では、アーキテクチャ依存パッケージを生成するなら binary-arch ターゲット内で生成する必要があり、アーキテクチャ非依存のパッケージならば、binary-indep ターゲットで生成する必要がある為です。

note: type: textblock
en: To facilitate this, as well as give you more control over which packages are acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative.  If none are given, debhelper programs default to acting on all packages listed in the control file, with the exceptions below.
ja: これを容易にする為、どのパッケージが debhelper プログラムによって処理されるかをよりコントロールするのと同様、すべての debhelper プログラムは B<-a>, B<-i>, B<-p>, B<-s> パラメータを解釈できます。これらのパラメータは重複可能です。何も指定しない場合、debhelper プログラムは、以下の例外を除いて control ファイルに列挙されたすべてのパッケージに対して処理を行います。

note: type: textblock
en: First, any package whose B<Architecture> field in B<debian/control> does not match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, section 5.6.8>).
ja: まず、B<debian/control> 中の B<Architecture> フィールドが B<DEB_HOST_ARCH> アーキテクチャに一致しない全てのパッケージが除外されます (L<Debian ポリシー 5.6.8 章>)。

note: type: textblock
en: Also, some additional packages may be excluded based on the contents of the B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in binary package stanzas in B<debian/control>, according to the draft policy at L<https://wiki.debian.org/BuildProfileSpec>.
ja: また、L<https://wiki.debian.org/BuildProfileSpec> にあるドラフトのポリシーによると、B<DEB_BUILD_PROFILES> 環境変数と B<debian/control> 中のバイナリパッケージ節の B<Build-Profiles> フィールドの内容を元に追加でパッケージが除外されます。

note: type: =head2
en: Automatic generation of Debian install scripts
ja: メンテナスクリプトの自動生成

note: type: textblock
en: Some debhelper commands will automatically generate parts of Debian maintainer scripts. If you want these automatically generated things included in your existing Debian maintainer scripts, then you need to add B<#DEBHELPER#> to your scripts, in the place the code should be added.  B<#DEBHELPER#> will be replaced by any auto-generated code when you run B<dh_installdeb>.
ja: debhelper コマンドには、Debian メンテナスクリプトの一部を自動的に生成するものがあります。もし、既存の Debian メンテナスクリプトに自動生成された部分を含むようにしたければ、コードを追加したい場所に B<#DEBHELPER#> と追記してください。B<#DEBHELPER#> は B<dh_installdeb> が実行される際に、自動生成されたコードへ置換されます。

note: type: textblock
en: If a script does not exist at all and debhelper needs to add something to it, then debhelper will create the complete script.
ja: スクリプトがまったく存在しないが debhelper が何かをスクリプトに追加する必要がある場合、debhelper はスクリプトを一式生成します。

note: type: textblock
en: All debhelper commands that automatically generate code in this way let it be disabled by the -n parameter (see above).
ja: -n パラメーターを指定すると、このような debhelper プログラムによるスクリプトの自動生成を行わないようにできます (上記参照)。

note: type: textblock
en: Note that the inserted code will be shell code, so you cannot directly use it in a Perl script. If you would like to embed it into a Perl script, here is one way to do that (note that I made sure that $1, $2, etc are set with the set command):
ja: 挿入されるコードはシェルスクリプトなので、Perl スクリプトには直接埋め込めない事に注意してください。もし何かを Perl スクリプトに埋め込みたい場合、以下に一例を挙げます ($1, $2 等は set コマンドにより設定される事に注意):

note: type: verbatim
en:   my $temp="set -e\nset -- @ARGV\n" . << 'EOF';
      #DEBHELPER#
      EOF
      if (system($temp)) {
         my $exit_code = ($? >> 8) & 0xff;
         my $signal = $? & 0x7f;
         if ($exit_code) {
             die("The debhelper script failed with error code: ${exit_code}");
         } else {
             die("The debhelper script was killed by signal: ${signal}");
         }
      }
ja:   my $temp="set -e\nset -- @ARGV\n" . << 'EOF';
      #DEBHELPER#
      EOF
      if (system($temp)) {
         my $exit_code = ($? >> 8) & 0xff;
         my $signal = $? & 0x7f;
         if ($exit_code) {
             die("debhelper スクリプトは失敗しました。エラーコード: ${exit_code}");
         } else {
             die("debhelper スクリプトは以下のシグナルで終了されました: ${signal}");
         }
      }

note: type: =head2
en: Automatic generation of miscellaneous dependencies.
ja: 様々な依存関係の自動生成

note: type: textblock
en: Some debhelper commands may make the generated package need to depend on some other packages. For example, if you use L<dh_installdebconf(1)>, your package will generally need to depend on debconf. Or if you use L<dh_installxfonts(1)>, your package will generally need to depend on a particular version of xutils. Keeping track of these miscellaneous dependencies can be annoying since they are dependent on how debhelper does things, so debhelper offers a way to automate it.
ja: debhelper は他のパッケージに依存するようなパッケージを作成することがあります。例えば、L<dh_installdebconf(1)> を使うと、ビルドしたパッケージは debconf パッケージにも依存するようになります。あるいは L<dh_installxfonts(1)> を使うと、特定のバージョンの xutils に依存することになります。これらの様々な依存関係を追いかけるのは、debhelper がどのような処理を行うかによるために面倒なことになりがちです。そのため、debhelper は 自動的に依存関係を解決する機能を提供します。

note: type: =head2
en: Package build directories
ja: パッケージビルドディレクトリ

note: type: textblock
en: By default, all debhelper programs assume that the temporary directory used for assembling the tree of files in a package is debian/I<package>.
ja: デフォルトでは、すべての debhelper プログラムはパッケージに含めるファイル群をまとめる一時ディレクトリとして debian/I<package> ディレクトリを使用します。

note: type: textblock
en: Sometimes, you might want to use some other temporary directory. This is supported by the B<-P> flag. For example, "B<dh_installdocs -Pdebian/tmp>", will use B<debian/tmp> as the temporary directory. Note that if you use B<-P>, the debhelper programs can only be acting on a single package at a time. So if you have a package that builds many binary packages, you will need to also use the B<-p> flag to specify which binary package the debhelper program will act on.
ja: 時折、別の一時ディレクトリを利用したくなる場合があるでしょう。この場合は、B<-P> フラグを利用してください。例えば、"B<dh_installdocs　-Pdebian/tmp>" では B<debian/tmp> を一時ディレクトリとして利用できます。ただし、B<-P> を使うと、debhelper プログラムは一度に 1 つのパッケージの処理しかできません。その為、複数のバイナリパッケージを生成するような場合、どのバイナリパッケージに対して debhelper が作用するかを指定するために B<-p> フラグを併用する必要があります。

note: type: =head2
en: udebs
ja: udeb パッケージについて

note: type: textblock
en: Debhelper includes support for udebs. To create a udeb with debhelper, add "B<Package-Type: udeb>" to the package's stanza in F<debian/control>.  Debhelper will try to create udebs that comply with debian-installer policy, by making the generated package files end in F<.udeb>, not installing any documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, and F<config> scripts, etc.
ja: debhelper は udeb もサポートしています。debhelper で udeb パッケージを作成するには、"B<Package-Type: udeb>" を F<debian/control> のパッケージ定義に加えてください。debhelper は udeb ファイルを debian-installer ポリシーにあわせてビルドします。これは、パッケージの拡張子が F<.udeb> となるファイルで、いかなるドキュメントや、F<preinst>, F<postrm>, F<prerm>, F<config> スクリプト等も省いたものです。

note: type: =head1
en: ENVIRONMENT
ja: 環境変数

note: type: textblock
en: Set to B<1> to enable no-act mode.
ja: B<1> に設定すると、何もしない (no-act) モードになります。

note: type: textblock
en: When using L<dh(1)>, it can be passed options that will be passed on to each debhelper command, which is generally better than using DH_OPTIONS.
ja: L<dh(1)> を使えば、続いて呼び出される debhelper コマンドに指定したオプションを渡すことができます。大抵の場合、こちらの方が DH_OPTIONS を使うよりも良い方法です。

note: type: textblock
en: If set, this adds the value the variable is set to to the B<-X> options of all commands that support the B<-X> option. Moreover, B<dh_builddeb> will B<rm -rf> anything that matches the value in your package build tree.
ja: こちらが設定されていると、B<-X> オプションをサポートするすべてのコマンドに対し、B<-X> オプションの値として環境変数の値を指定します。さらに、B<dh_builddeb> コマンドはビルドツリーの元で環境変数の値に基づくパターンにマッチするもの全部を B<rm -rf> するようになります。

note: type: textblock
en: This can be useful if you are doing a build from a CVS source tree, in which case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from sneaking into the package you build. Or, if a package has a source tarball that (unwisely) includes CVS directories, you might want to export B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever your package is built.
ja: これは CVS ソースツリーからパッケージビルドをする場合に便利な場合があります。例えば、B<DH_ALWAYS_EXCLUDE=CVS> を指定すれば、CVS ディレクトリがビルドの際に検索されるのを防ぐことができます。あるいは、ソースの tarball にすでに CVS ディレクトリが (愚かにも) 含まれている場合、F<debian/rules> で B<DH_ALWAYS_EXCLUDE=CVS> 環境変数を export すれば、どこでパッケージをビルドしようとも効果を発揮するようになります。

note: type: textblock
en: Multiple things to exclude can be separated with colons, as in B<DH_ALWAYS_EXCLUDE=CVS:.svn>
ja: 除外したいものを複数指定したい場合は、B<DH_ALWAYS_EXCLUDE=CVS:.svn> のようにコロンで区切ってください。

note: type: =head1
en: SEE ALSO
ja: 参照

note: type: textblock
en: A set of example F<debian/rules> files that use debhelper.
ja: debhelper を使うときの F<debian/rules> ファイルの例が格納されています。

note: type: textblock
en: Debhelper web site.
ja: Debhelper の Web サイトです。

note: type: =head1
en: AUTHOR
ja: 作者

note: type: textblock
en: These are the available compatibility levels:
ja: 利用可能な互換性レベルは以下の通りです:

note: type: textblock
en: This compatibility level is still open for development; use with caution.
ja: この互換性レベルは未だ開発中の状態です。使う場合は注意して使ってください。

note: type: textblock
en: This is the recommended mode of operation.
ja: これが動作推奨モードです。

note: type: textblock
en: Invoking B<dh_clean -k> now causes an error instead of a deprecation warning.
ja: B<dh_clean -k> の起動は deprecate 警告ではなくエラーを起こすようになりました。

note: type: textblock
en: Changes from v10 are:
ja: v10 からの変更点:

note: type: textblock
en: Changes from v9 are:
ja: v9 からの変更点:

note: type: textblock
en: B<dh_installinit> will no longer installs a file named debian/I<package> as an init script.
ja: B<dh_installinit> は、init スクリプトとして debian/I<package> という名前でファイルをインストールしなくなりました。

note: type: textblock
en: B<dh_installdocs> will error out if it detects links created with --link-doc between packages of architecture "all" and non-"all" as it breaks binNMUs.
ja: B<dh_installdocs> は、アーキテクチャ "all" と 非 "all" のパッケージ間で --link-doc で作られたリンクが binNMU を壊すのを検知してエラーを吐き出すようになります。

note: type: textblock
en: B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>.shlibs file.  This is now done by B<dh_makeshlibs> instead.
ja: B<dh_installdeb>は、メンテナが提供した debian/I<package>.shlibs ファイルをインストールしなくなりました。現在これは、B<dh_makeshlibs> によって代わりに行われます。

note: type: textblock
en: B<dh_installwm> refuses to create a broken package if no man page can be found (required to register for the x-window-manager alternative).
ja: B<dh_installwm> は、man ページが見つからない場合に壊れたパッケージを作成するのを拒否するようになりました (x-window-manager の alternative 登録に必要)。

note: type: textblock
en: Debhelper will default to B<--parallel> for all buildsystems that support parallel building.  This can be disabled by using either B<--no-parallel> or passing B<--max-parallel> with a value of 1.
ja: debhelper は、並列ビルドをサポートしている全てのビルドシステムで、デフォルトで B<--parallel> を使用します。これは、B<--no-parallel> を使うか B<--max-parallel> へ 1 の値を渡すことで無効にできます。

note: type: textblock
en: The B<dh> command will not accept any of the deprecated "manual sequence control" parameters (B<--before>, B<--after>, etc.).  Please use override targets instead.
ja: B<dh> コマンドは、使われなくなった "手動シーケンスコントロール" パラメーター(B<--before>, B<--after> など)を受け付けなくなります。代わりに override ターゲットを使ってください。

note: type: textblock
en: The B<dh> command will no longer use log files to track which commands have been run.  The B<dh> command I<still> keeps track of whether it already ran the "build" sequence and skip it if it did.
ja: B<dh> コマンドはどのコマンドが実行されたのかを追跡するのにログファイルを使わなくなります。B<dh> コマンドは I<依然として> 既に "build" シーケンスを実行したかどうかを記録し、もし実行されていたらスキップします。

note: type: textblock
en: The main effects of this are:
ja: これの主な影響:

note: type: textblock
en: With this, it is now easier to debug the I<install> or/and I<binary> sequences because they can now trivially be re-run (without having to do a full "clean and rebuild" cycle)
ja: これにより、I<install> 及び I<binary> シーケンスを ("clean 及び rebuild" のサイクルを全て実施する必要が無くなり) 気軽に再実行可能になったため、デバッグがより簡単になっています。

note: type: textblock
en: Example of where it can go wrong:
ja: 動かなくなる可能性がある例:

note: type: textblock
en: In this case, the call to B<dh_foo --remaining> will I<also> include I<my-pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target.  This issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc.
ja: この場合、B<dh_foo --remaining> の呼び出しは、B<dh_foo -pmy-pkg> が分かれている override ターゲット内にあるため、I<my-pkg> I<も>含みます。この問題は B<--remaining> に限らず B<-a>, B<-i> なども含みます。

note: type: textblock
en: The B<dh_installdeb> command now shell-escapes the lines in the F<maintscript> config file.  This was the original intent but it did not work properly and packages have begun to rely on the incomplete shell escaping (e.g. quoting file names).
ja: B<dh_installdeb> コマンドは F<maintscript> 設定ファイル内の行をシェルエスケープするようになりました。これは元々意図していた動作でしたが正しく動作しておらず、パッケージが不完全なシェルエスケープ (例: ファイル名のクォート) に依存するようになっていました。

note: type: textblock
en: The B<dh_installinit> command now defaults to B<--restart-after-upgrade>.  For packages needing the previous behaviour, please use B<--no-restart-after-upgrade>.
ja: B<dh_installinit> コマンドは標準で B<--restart-after-upgrade> を利用するようになりました。以前の動作が必要なパッケージには B<--no-restart-after-upgrade> を利用してください。

note: type: textblock
en: The B<autoreconf> sequence is now enabled by default.  Please pass B<--without autoreconf> to B<dh> if this is not desirable for a given package
ja: B<autoreconf> シーケンスが標準で有効になりました。指定のパッケージでこの動作を望まない場合は、B<dh> に B<--without autoreconf> を指定してください。

note: type: textblock
en: The B<systemd> sequence is now enabled by default.  Please pass B<--without systemd> to B<dh> if this is not desirable for a given package.
ja: B<systemd> シーケンスが標準で有効になりました。指定のパッケージでこの動作を望まない場合は、B<dh> に B<--without systemd> を指定してください。

note: type: textblock
en: Changes from v8 are:
ja: v8 からの変更点:

note: type: textblock
en: dh is aware of the usual dependencies between targets in debian/rules.  So, "dh binary" will run any build, build-arch, build-indep, install, etc targets that exist in the rules file. There's no need to define an explicit binary target with explicit dependencies on the other targets.
ja: dh コマンドは debian/rules に記載されているターゲット間の一般的な依存性を考慮します。そのため、"dh binary" は rules ファイルに存在する build, build-arch, build-indep, install 等のターゲットを実行していきます。つまり、他のターゲットに関する依存関係をいちいち細かく明示した binary ターゲットを用意する必要はありません。

note: type: textblock
en: B<dh_strip> compresses debugging symbol files to reduce the installed size of -dbg packages.
ja: B<dh_strip> はデバッグシンボルファイルを圧縮し、-dbg パッケージのインストール時に必要とする容量を削減します。

note: type: textblock
en: B<dh> does not default to enabling --with=python-support
ja: B<dh> は --with=python-support オプションを、デフォルトでは無効にするようになりました。

note: type: textblock
en: All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment variables listed by B<dpkg-buildflags>, unless they are already set.
ja: すべての B<dh_auto_>I<*> debhelper プログラムと B<dh> コマンドは、B<dpkg-buildflags> で指定される環境変数を設定します。すでに該当する環境変数が設定されている場合は設定を行いません。

note: type: textblock
en: B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS to perl F<Makefile.PL> and F<Build.PL>
ja: B<dh_auto_configure> は、B<dpkg-buildflags> によって設定されるCFLAGS、CPPFLAGS, LDFLAGS パラメータを F<Makefile.PL> や F<Build.PL> へ引き渡します。

note: type: textblock
en: B<dh_strip> puts separated debug symbols in a location based on their build-id.
ja: B<dh_strip> は build-id に基づく場所に、分離したデバッグシンボルを配置します。

note: type: textblock
en: Executable debhelper config files are run and their output used as the configuration.
ja: 実行可能権限を付与した debhelper 用の設定ファイルは、実行され出力が設定として扱われます。

note: type: textblock
en: This mode is deprecated.
ja: このモードは廃止されました。

note: type: textblock
en: Changes from v7 are:
ja: v7 からの変更点:

note: type: textblock
en: Commands will fail rather than warning when they are passed unknown options.
ja: 未定義のオプションを渡そうとすると、警告文を出して処理続行するのではなく、エラーにして処理を失敗させるようになりました。

note: type: textblock
en: B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it generates shlibs files for. So B<-X> can be used to exclude libraries.  Also, libraries in unusual locations that B<dpkg-gensymbols> would not have processed before will be passed to it, a behavior change that can cause some packages to fail to build.
ja: B<dh_makeshlibs> は、shlibs ファイルを作成する為に、B<dpkg-gensymbols> をすべての共有ライブラリに対して実行するようになりました。B<-X> を指定すると実行を除外するライブラリを指定できます。また、通常ではない場所にライブラリがある為 B<dh_makeshlibs> へ渡す前に B<dpkg-gensymbols> が処理できないような場合、パッケージのビルドが失敗に終わるようになりました。

note: type: textblock
en: B<dh> requires the sequence to run be specified as the first parameter, and any switches come after it. Ie, use "B<dh $@ --foo>", not "B<dh --foo $@>".
ja: B<dh> は最初のパラメータとして、一連の処理の名前を指定し、その次にオプションを記載しなければならなくなりました。つまり、"B<dh $@ --foo>" が正しく、"B<dh --foo $@>" は間違いとなります。

note: type: textblock
en: B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to F<Makefile.PL>.
ja: B<dh_auto_>I<*> は F<Makefile.PL> ファイルよりも、Perl の B<Module::Build> モジュールを優先して利用するようになりました。

note: type: textblock
en: This is the lowest supported compatibility level.
ja: これはサポートされている最低限の互換性レベルです。

note: type: textblock
en: If you are upgrading from an earlier compatibility level, please review L<debhelper-obsolete-compat(7)>.
ja: これ以前の互換性レベルからアップグレードしようとしている場合、L<debhelper-obsolete-compat(7)> を確認して下さい。

note: type: =head1
en: AUTHORS
ja: 作者

note: type: textblock
en: debhelper-obsolete-compat - List of no longer supported compat levels
ja: debhelper-obsolete-compat - サポートされなくなった互換性レベル一覧

note: type: textblock
en: This document contains the upgrade guidelines from all compat levels which are no longer supported.  Accordingly it is mostly for historical purposes and to assist people upgrading from a non-supported compat level to a supported level.
ja: このドキュメントには、もはやサポートされていない全ての互換性レベルからのアップグレードに対するガイドラインが含まれています。従って、殆どが当時の目的についての説明と、サポートされていない互換性レベルからサポートされているレベルへのアップグレードを支援するためのものになります。

note: type: textblock
en: For upgrades from supported compat levels, please see L<debhelper(7)>.
ja: サポートされている互換性レベルからのアップグレードについては、L<debhelper(7)> を参照して下さい。

note: type: =head1
en: UPGRADE LIST FOR COMPAT LEVELS
ja: 互換性レベルの更新一覧

note: type: textblock
en: The following is the list of now obsolete compat levels and their changes.
ja: 以下は過去のものとなった互換性レベルとその変更の一覧です。

note: type: textblock
en: Changes from v6 are:
ja: v6 からの変更点:

note: type: textblock
en: B<dh_install>, will fall back to looking for files in F<debian/tmp> if it doesn't find them in the current directory (or wherever you tell it look using B<--sourcedir>). This allows B<dh_install> to interoperate with B<dh_auto_install>, which installs to F<debian/tmp>, without needing any special parameters.
ja: もし、F<debian/tmp> 以下にあるようなファイルが、カレントディレクトリにない場合 (もしくは、B<--sourcedir> で指定したディレクトリにない場合) 、B<dh_install> は F<debian/tmp> を探しにいくようになりました。この振る舞いの変更により、B<dh_install> に特に何か引数を指定しなくても、F<debian/tmp> にインストールしようとする B<dh_auto_install> と協調して動作できるようになりました。

note: type: textblock
en: B<dh_clean> will read F<debian/clean> and delete files listed there.
ja: B<dh_clean> は F<debian/clean> を読み、そこに記載されているファイルを消すようになりました。

note: type: textblock
en: B<dh_clean> will delete toplevel F<*-stamp> files.
ja: B<dh_clean> はビルドディレクトリの最上位の階層にある F<*-stamp> ファイルを消すようになりました。

note: type: textblock
en: B<dh_installchangelogs> will guess at what file is the upstream changelog if none is specified.
ja: B<dh_installchangelogs> は、何も指定しなくてもどのファイルが upstream の changelog であるかを推定するようになりました。

note: type: textblock
en: Changes from v5 are:
ja: v5 からの変更点:

note: type: textblock
en: Commands that generate maintainer script fragments will order the fragments in reverse order for the F<prerm> and F<postrm> scripts.
ja: メンテナンス用スクリプトの一部を生成するコマンドは、F<prerm> と F<postrm> スクリプト用にこれらを逆順に並び替えるようになりました。

note: type: textblock
en: B<dh_installwm> will install a slave manpage link for F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> in the package build directory.
ja: B<dh_installwm> は F<x-window-manager.1.gz> という slave な man ページへリンクを作るようになりました。これはパッケージビルドディレクトリ内の F<usr/share/man/man1> ディレクトリに man ページがある場合に行われます。

note: type: textblock
en: B<dh_builddeb> did not previously delete everything matching B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as B<CVS:.svn:.git>. Now it does.
ja: B<dh_builddeb> は、B<CVS:.svn:.git> のように除外する対象を B<DH_ALWAYS_EXCLUDE> に指定しても該当するファイルを削除していませんでした。本互換性レベルでは削除するようになっています。

note: type: textblock
en: B<dh_installman> allows overwriting existing man pages in the package build directory. In previous compatibility levels it silently refuses to do this.
ja: B<dh_installman> は、パッケージビルドディレクトリにすでに存在する man ページを上書きしても良くなりました。これより以前の互換性レベルの元では、このような動作は何の警告もなく拒絶されていました。

note: type: textblock
en: Changes from v4 are:
ja: v4 からの変更点:

note: type: textblock
en: Comments are ignored in debhelper config files.
ja: debhelper 設定ファイルでのコメントは無視されるようになりました。

note: type: textblock
en: B<dh_strip --dbg-package> now specifies the name of a package to put debugging symbols in, not the packages to take the symbols from.
ja: B<dh_strip --dbg-package> により、デバッグ用シンボルテーブルに対してパッケージの名前を指定できるようになりました。以前はデバッグ用シンボルテーブルからパッケージの名前を取り出していました。

note: type: textblock
en: B<dh_installdocs> skips installing empty files.
ja: B<dh_installdocs> は空ファイルのインストールを飛ばします。

note: type: textblock
en: B<dh_install> errors out if wildcards expand to nothing.
ja: B<dh_install> は、ワイルドカードに該当するファイルが無い時はエラーを出力するようになりました。

note: type: textblock
en: Changes from v3 are:
ja: v3 からの変更点:

note: type: textblock
en: B<dh_makeshlibs -V> will not include the Debian part of the version number in the generated dependency line in the shlibs file.
ja: B<dh_makeshlibs -V> は、shlibs ファイル内の生成された依存関係を示す行のバージョン番号について、debian リビジョンを含めないようになりました。

note: type: textblock
en: You are encouraged to put the new B<${misc:Depends}> into F<debian/control> to supplement the B<${shlibs:Depends}> field.
ja: F<debian/control> へ、B<${shlibs:Depends}> の他に B<${misc:Depends}> を新たに指定するのが推奨されるようになりました。

note: type: textblock
en: B<dh_fixperms> will make all files in F<bin/> directories and in F<etc/init.d> executable.
ja: B<dh_fixperms> により、F<bin/> ディレクトリ及び F <etc/init.d> 以下にあるすべてのファイルに実行権限が付与されるようになりました。

note: type: textblock
en: B<dh_link> will correct existing links to conform with policy.
ja: B<dh_link>は、既存のリンクであってもポリシーに合わせ、リンクを修正するようになりました。

note: type: textblock
en: This mode works like v2, with the following additions:
ja: このモードは v2 のモードと同じ動作をしますが、以下の追加機能があります:

note: type: textblock
en: Debhelper config files support globbing via B<*> and B<?>, when appropriate. To turn this off and use those characters raw, just prefix with a backslash.
ja: debhelper の設定ファイルは、B<*> や B<?> のワイルドカードによるファイル名指定が利用できます。この機能を無効にし、これらワイルドカード文字をそのままの文字として扱うには、バックスラッシュを文字の前に置いてください。

note: type: textblock
en: B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call B<ldconfig>.
ja: B<dh_makeshlibs> により、F<postinst> や F<postrm> スクリプトが B<ldconfig> を呼び出すようになっています。

note: type: textblock
en: Every file in F<etc/> is automatically flagged as a conffile by B<dh_installdeb>.
ja: B<dh_installdeb> は、F<etc/> 以下のすべてのファイルを自動的に conffile として扱います。

note: type: textblock
en: In this mode, debhelper will consistently use debian/I<package> as the package tree directory for every package that is built.
ja: このモードを指定すると、常に debian/I<package> を全パッケージのビルドディレクトリとして利用するようになります。

note: type: textblock
en: This is the original debhelper compatibility level, and so it is the default one. In this mode, debhelper will use F<debian/tmp> as the package tree directory for the first binary package listed in the control file, while using debian/I<package> for all other packages listed in the F<control> file.
ja: これは debhelper が元来持つ互換性レベルで、これがデフォルトです。このモードでは、debhelper はF<debian/tmp> を、control ファイルの最初に記載されているバイナリパッケージのビルドディレクトリとして利用しようとします。また、debian/I<package> を F<control> 内に指定されている全パッケージに対して適用します。

note: type: textblock
en: dh - debhelper command sequencer
ja: dh - debhelper コマンドシーケンサー

note: type: textblock
en: B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] [S<I<debhelper options>>]
ja: B<dh> I<sequence> [B<--with> I<addon>[B<,>I<addon> ...]] [B<--list>] [S<I<debhelper オプション>>]

note: type: textblock
en: B<dh> runs a sequence of debhelper commands. The supported I<sequence>s correspond to the targets of a F<debian/rules> file: B<build-arch>, B<build-indep>, B<build>, B<clean>, B<install-indep>, B<install-arch>, B<install>, B<binary-arch>, B<binary-indep>, and B<binary>.
ja: B<dh> は一連の debhelper コマンドを実行します。F<debian/rules> ファイルに記載されたターゲットに対応する I<sequence>をサポートします。サポートするターゲット: B<build-arch>, B<build-indep>, B<build>, B<clean>, B<install-indep>, B<install-arch>, B<install>, B<binary-arch>, B<binary-indep>, B<binary> です。

note: type: textblock
en: To override I<dh_command>, add a target named B<override_>I<dh_command> to the rules file. When it would normally run I<dh_command>, B<dh> will instead call that target. The override target can then run the command with additional options, or run entirely different commands instead. See examples below.
ja: ターゲット I<dh_command> を変更するためには、B<override_>I<dh_command> というターゲットを rule ファイルに記載します。こちらが指定されていると、I<dh_command> が動作する代わりに B<override_>I<dh_command> ターゲットを呼び出します。override ターゲットでは、コマンドにオプションを追加したり、コマンド全てを置き換えたりできます。後に例を挙げます。

note: type: =head1
en: OPTIONS
ja: オプション

note: type: textblock
en: Add the debhelper commands specified by the given addon to appropriate places in the sequence of commands that is run. This option can be repeated more than once, or multiple addons can be listed, separated by commas.  This is used when there is a third-party package that provides debhelper commands. See the F<PROGRAMMING> file for documentation about the sequence addon interface.
ja: 一連のコマンド中の適切な位置で実行するアドオンを、debhelper コマンドへ指定します。このオプションは繰り返し指定することもできますし、複数のアドオンをカンマ区切りで列挙して指定できます。このオプションは debhelper コマンドを提供するサードパーティ製パッケージと共に利用する時に使います。F<PROGRAMMING> ファイルに、一連のアドオン用インターフェースについてのドキュメントがあります。

note: type: textblock
en: The inverse of B<--with>, disables using the given addon. This option can be repeated more than once, or multiple addons to disable can be listed, separated by commas.
ja: B<--with> とは逆に、指定されたアドオンを無効にします。このオプションは繰り返し指定することもできますし、アドオン名をカンマ区切りで指定もできます。

note: type: textblock
en: List all available addons.
ja: 利用可能なアドオン一覧を表示する。

note: type: textblock
en: Prints commands that would run for a given sequence, but does not run them.
ja: 指定された一連の処理でのコマンドを表示しますが、表示だけして実際にはコマンドは実行しません。

note: type: textblock
en: Note that dh normally skips running commands that it knows will do nothing.  With --no-act, the full list of commands in a sequence is printed.
ja: 通常、dh は何も実行しないであろうとわかっている動作コマンドをスキップすることに注意してください。--no-act を指定すると、一連の動作内でのコマンド一覧をすべて出力します。

note: type: textblock
en: Other options passed to B<dh> are passed on to each command it runs. This can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for more specialised options.
ja: B<dh> に渡された他のオプションは、実行される各コマンドにも渡されます。これは、B<-v>, B<-X>, B<-N> のようなオプションをセットするのに利用できます。また、他の特別なオプションについても同様となります。

note: type: =head1
en: EXAMPLES
ja: 使用例

note: type: textblock
en: To see what commands are included in a sequence, without actually doing anything:
ja: コマンドを実際には動作させず、一連の動作でどのコマンドが実行されるかを見る:

note: type: textblock
en: This is a very simple rules file, for packages where the default sequences of commands work with no additional options.
ja: 以下は非常にシンプルな rules ファイルです。ここではパッケージに対して追加オプション無しでデフォルトのコマンド群が呼び出されます。

note: type: textblock
en: Often you'll want to pass an option to a specific debhelper command. The easy way to do with is by adding an override target for that command.
ja: 特定の debhelper コマンドへオプションを渡したい事がよくあります。これを簡単に行う方法は、そのコマンドへ override を追加することです。

note: type: textblock
en: Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> can't guess what to do for a strange package. Here's how to avoid running either and instead run your own commands.
ja: L<dh_auto_configure(1)> や L<dh_auto_build(1)> が処理をする際、何を処理すればよいか判断できないような変わったパッケージがたまに存在します。ここでは、L<dh_auto_configure(1)> や L<dh_auto_build(1)> を実行せずに、代わりのコマンドを実行させる方法を示します。

note: type: textblock
en: Another common case is wanting to do something manually before or after a particular debhelper command is run.
ja: 別のよくある例として、特定の debhelper コマンドが実行される前後で手動で何かをしたい場合があります。

note: type: textblock
en: Here is how to force use of Perl's B<Module::Build> build system, which can be necessary if debhelper wrongly detects that the package uses MakeMaker.
ja: こちらは Perl による B<Module::Build> ビルドシステムを強制的に使う方法です。これは、debhelper が誤ってパッケージが MakeMaker を使っていると認識する場合に必要となります。

note: type: textblock
en: Here is an example of overriding where the B<dh_auto_>I<*> commands find the package's source, for a package where the source is located in a subdirectory.
ja: 以下に B<dh_auto_>I<*> コマンドがどこにパッケージソースがあるかを変更する例を載せます。これはサブディレクトリにソースが存在するようなパッケージで使います。

note: type: textblock
en: And here is an example of how to tell the B<dh_auto_>I<*> commands to build in a subdirectory, which will be removed on B<clean>.
ja: B<dh_auto_>I<*> にサブディレクトリでビルドするように指定する方法を以下に示します。こちらを指定すると、B<clean> 処理でこれらディレクトリが取り除かれるようになります:

note: type: textblock
en: If your package can be built in parallel, please either use compat 10 or pass B<--parallel> to dh. Then B<dpkg-buildpackage -j> will work.
ja: パッケージが並列ビルド可能であれば、互換性レベル 10 を使うか dh に B<--parallel> を指定して下さい。すると B<dpkg-buildpackage -j> が有効になります。

note: type: textblock
en: If your package cannot be built reliably while using multiple threads, please pass B<--no-parallel> to dh (or the relevant B<dh_auto_>I<*> command):
ja: パッケージが複数スレッドを使うと安定してビルド出来ない場合は、dh (あるいは関連する B<dh_auto_>I<*> コマンド)に B<--no-parallel> を指定して下さい。

note: type: textblock
en: Here is a way to prevent B<dh> from running several commands that you don't want it to run, by defining empty override targets for each command.
ja: ここでは、B<dh> に、実行してほしくないコマンドを実行させないようにする方法を示します。その場合、それらのコマンドに対する override ターゲットを空にすることにより行います。

note: type: verbatim
en: 	# Commands not to run:
    	override_dh_auto_test override_dh_compress override_dh_fixperms:
ja: 	# 実行させたくないコマンド:
    	override_dh_auto_test override_dh_compress override_dh_fixperms:

note: type: textblock
en: A long build process for a separate documentation package can be separated out using architecture independent overrides.  These will be skipped when running build-arch and binary-arch sequences.
ja: ドキュメントパッケージを作成するのに時間がかかる場合があります。この場合、アーキテクチャ非依存用の override ターゲットを使ってビルドを分離することができます。こうすると、build-arch や binary-arch を実行するとき、ドキュメントパッケージのビルドが省略されます。

note: type: verbatim
en: 	# No tests needed for docs
    	override_dh_auto_test-indep:
ja: 	# doc ターゲット実行時はテストは不要
    	override_dh_auto_test-indep:

note: type: textblock
en: Adding to the example above, suppose you need to chmod a file, but only when building the architecture dependent package, as it's not present when building only documentation.
ja: 上の例に加え、ファイルに chmod を実行しなければならないがそれはアーキテクチャ依存パッケージをビルドする際のみ必要で、ドキュメントのみをビルドする時には実行しないとしたらどうなるでしょうか。

note: type: =head1
en: INTERNALS
ja: 内部動作

note: type: textblock
en: If you're curious about B<dh>'s internals, here's how it works under the hood.
ja: B<dh> の内部動作に興味がある人向けに、以下に内部でどのように動作しているのかを記載します。

note: type: textblock
en: In compat 9 or earlier, each debhelper command will record when it's successfully run in F<debian/package.debhelper.log>. (Which B<dh_clean> deletes.) So B<dh> can tell which commands have already been run, for which packages, and skip running those commands again.
ja: 互換性レベル 9 とそれ以前では、各 debhelper コマンドは F<debian/package.debhelper.log> に実行がうまく行ったものを記録します (これは B<dh_clean> が消去します)。これにより、B<dh> は既にどのコマンドが実行されたか、あるいはどのパッケージに対して実行されたか、何のコマンドを再びスキップすればよいのかがわかります。

note: type: textblock
en: A sequence can also run dependent targets in debian/rules.  For example, the "binary" sequence runs the "install" target.
ja: dh に処理の流れの名前を指定することにより、debian/rules に記載した依存関係にあるターゲットも実行されます。例えば、"binary" という処理の流れを指定すると、"install" ターゲットも実行されます。

note: type: textblock
en: B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass information through to debhelper commands that are run inside override targets. The contents (and indeed, existence) of this environment variable, as the name might suggest, is subject to change at any time.
ja: B<dh> は、B<DH_INTERNAL_OPTIONS> 環境変数をチェックし、override ターゲットの中で実行される debhelper コマンドに情報を渡します。この環境変数に記載されている内容は (実際には環境変数が存在していると) 、その環境変数の名前が示唆するとおり、どの時点でも debhelper コマンドの動作に影響を与えます。

note: type: textblock
en: Commands in the B<build-indep>, B<install-indep> and B<binary-indep> sequences are passed the B<-i> option to ensure they only work on architecture independent packages, and commands in the B<build-arch>, B<install-arch> and B<binary-arch> sequences are passed the B<-a> option to ensure they only work on architecture dependent packages.
ja: B<build-indep>, B<install-indep>, B<binary-indep> の一連の処理に記載されているコマンドには、アーキテクチャ非依存パッケージをビルドする時にだけ確実に作用するように B<-i> オプションを使って情報が引き渡されます。B<build-arch>, B<install-arch>, B<binary-arch> の一連の処理に対しては、B<-a> にて引き渡され、アーキテクチャ依存パッケージにのみ確実に作用するように動作します。

note: type: textblock
en: This program is a part of debhelper.
ja: このプログラムは debhelper の一部です。

note: type: textblock
en: dh_auto_build - automatically builds a package
ja: dh_auto_build - 自動的にパッケージをビルドする

note: type: textblock
en: B<dh_auto_build> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
ja: B<dh_auto_build> [S<I<build system オプション>>] [S<I<debhelper オプション>>] [S<B<--> I<パラメータ>>]

note: type: textblock
en: B<dh_auto_build> is a debhelper program that tries to automatically build a package. It does so by running the appropriate command for the build system it detects the package uses. For example, if a F<Makefile> is found, this is done by running B<make> (or B<MAKE>, if the environment variable is set). If there's a F<setup.py>, or F<Build.PL>, it is run to build the package.
ja: B<dh_auto_build> は、パッケージを自動的にビルドしようとする debhelper プログラムです。パッケージが利用していると検知したビルドシステムについて、適切なコマンドを実行してビルドを行います。例えばもし F<Makefile> が見つかれば、B<make> を実行して処理を行います (あるいは B<MAKE> 環境変数が設定されている場合です)。F<setup.py> または F<Build.PL> が存在すれば、これを実行してパッケージをビルドします。

note: type: textblock
en: This is intended to work for about 90% of packages. If it doesn't work, you're encouraged to skip using B<dh_auto_build> at all, and just run the build process manually.
ja: このコマンドは約 90% のパッケージについて処理が行えるようにしています。もしうまく動作しないようなパッケージに遭遇した場合は、B<dh_auto_build> を完全に省略して、ビルド作業を手動で実行してください。

note: type: textblock
en: See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build system selection and control options.
ja: L<debhelper(7)/B<ビルドシステム用オプション>> には、よく使われるビルドシステムと、制御オプションが列挙されています。

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_build> usually passes.
ja: I<params> を B<dh_autobuild> にて実行しようとしているプログラムへ渡します。この B<--> の後に指定したパラメータが渡されます。

note: type: textblock
en: dh_auto_clean - automatically cleans up after a build
ja: dh_auto_clean - ビルド後、自動的にビルドディレクトリを消去する

note: type: textblock
en: B<dh_auto_clean> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
ja: B<dh_auto_clean> [S<I<build system オプション>>] [S<I<debhelper オプション>>] [S<B<--> I<パラメータ>>]

note: type: textblock
en: B<dh_auto_clean> is a debhelper program that tries to automatically clean up after a package build. It does so by running the appropriate command for the build system it detects the package uses. For example, if there's a F<Makefile> and it contains a B<distclean>, B<realclean>, or B<clean> target, then this is done by running B<make> (or B<MAKE>, if the environment variable is set). If there is a F<setup.py> or F<Build.PL>, it is run to clean the package.
ja: B<dh_auto_clean> はパッケージビルド完了後に自動的にディレクトリを消去しようとする debhelpr プログラムです。このプログラムはパッケージのビルドに必要なビルドシステムを割り出し、それに適したコマンドを実行する事で消去を行います。例えば、F<Makefile> が存在し、かつ、そのファイルの中に B<distclean>, B<realclean>, B<clean> ターゲットが存在する場合、B<make> を実行することにより消去を行います (あるいは、B<MAKE> 環境変数が設定されている時も同様です)。もし F<setup.py> や F<Build.PL> が存在するのであれば、これらを実行してパッケージビルドディレクトリを消去します。

note: type: textblock
en: This is intended to work for about 90% of packages. If it doesn't work, or tries to use the wrong clean target, you're encouraged to skip using B<dh_auto_clean> at all, and just run B<make clean> manually.
ja: このコマンドは約 90 %のパッケージにて動作するように作られています。もし、うまく動作しないようなパッケージに遭遇した場合、間違った clean ターゲットを使おうとしてしまうような場合、B<dh_auto_clean> をまったく使わずに、手動で B<makeclean> を実行するのをお勧めします。

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_clean> usually passes.
ja: I<params> を実行するプログラムに渡すには、B<dh_auto_clean> に通常指定するパラメータの後に、I<params> を指定してください。

note: type: textblock
en: dh_auto_configure - automatically configure a package prior to building
ja: dh_auto_configure - パッケージビルド前に自動的に configure を行う

note: type: textblock
en: B<dh_auto_configure> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
ja: B<dh_auto_configure> [S<I<build system オプション>>] [S<I<debhelper オプション>>] [S<B<--> I<パラメータ>>]

note: type: textblock
en: B<dh_auto_configure> is a debhelper program that tries to automatically configure a package prior to building. It does so by running the appropriate command for the build system it detects the package uses.  For example, it looks for and runs a F<./configure> script, F<Makefile.PL>, F<Build.PL>, or F<cmake>. A standard set of parameters is determined and passed to the program that is run. Some build systems, such as make, do not need a configure step; for these B<dh_auto_configure> will exit without doing anything.
ja: B<dh_auto_configure> はパッケージをビルドする前に自動的に configure を実行する debhelper プログラムです。このプログラムはパッケージのビルドに必要なビルドシステムを割り出し、それに適したコマンドを実行して設定を行います。例えば、F<./configure> スクリプト、F<Makefile.PL>、F<Build.PL>、F<cmake> を探して実行します。一連の標準パラメータが指定され、実行するプログラムに引き渡されます。なお、make のようなビルドシステムの場合、事前に configure の実行が不要な場合があります。この場合 B<dh_auto_configure> は何もせずに終了します。

note: type: textblock
en: This is intended to work for about 90% of packages. If it doesn't work, you're encouraged to skip using B<dh_auto_configure> at all, and just run F<./configure> or its equivalent manually.
ja: このコマンドは 90% のパッケージで動作するように作られています。もし、動作しないようなパッケージがあった場合は、B<dh_auto_configure> を全く使わないようにして、代わりに F<./configure> や、同等の動作を行うコマンドを手動で実行してください。

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_configure> usually passes. For example:
ja: I<params> を実行するプログラムに渡すには、B<dh_auto_configure> に通常指定するパラメータの後に、B<--> を、次に I<params> を指定してください。例:

note: type: textblock
en: dh_auto_install - automatically runs make install or similar
ja: dh_auto_install - make install や類似コマンドを自動的に実行する

note: type: textblock
en: B<dh_auto_install> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
ja: B<dh_auto_install> [S<I<build system オプション>>] [S<I<debhelper オプション>>] [S<B<--> I<params>>]

note: type: textblock
en: B<dh_auto_install> is a debhelper program that tries to automatically install built files. It does so by running the appropriate command for the build system it detects the package uses. For example, if there's a F<Makefile> and it contains a B<install> target, then this is done by running B<make> (or B<MAKE>, if the environment variable is set). If there is a F<setup.py> or F<Build.PL>, it is used. Note that the Ant build system does not support installation, so B<dh_auto_install> will not install files built using Ant.
ja: B<dh_auto_install> プログラムは、ビルドしたファイルを自動的にインストールしようとする debhelper プログラムです。パッケージが利用するビルドシステムを判定し、そのビルドシステムに対して適切なコマンドを実行することでインストールを行います。例えば、F<Makefile> が存在し、中に B<install> ターゲットが存在する場合 (あるいは、B<MAKE> 環境変数が設定されている場合)、B<make> を実行します)。もし、F<setup.py> や F<Build.PL> が存在すれば、こちらが利用されます。なお、Ant ビルドシステムはインストールをサポートしていません。そのため、B<dh_auto_install> は Ant を使ってビルドしたファイルをインストールしないことに注意してください。

note: type: textblock
en: B<DESTDIR> is used to tell make where to install the files.  If the Makefile was generated by MakeMaker from a F<Makefile.PL>, it will automatically set B<PREFIX=/usr> too, since such Makefiles need that.
ja: B<DESTDIR> は生成したファイルをどこに置くべきかを指定する時に利用します。もし Makefileが F<Makefile.PL> を使って MakeMaker から生成される場合、生成された Makefile の為に、さらに自動的に B<PREFIX=/usr> がインストールディレクトリとして指定されます。

note: type: textblock
en: This is intended to work for about 90% of packages. If it doesn't work, or tries to use the wrong install target, you're encouraged to skip using B<dh_auto_install> at all, and just run make install manually.
ja: このコマンドはほぼ 90 %のパッケージに対してうまく動作するように設計されています。うまく動かない場合、あるいは、間違ったインストールターゲットを使ってしまうような場合には、B<dh_auto_install> を完全に省略して make install を手動で実行することを推奨します。

note: type: textblock
en: Install files into the specified I<directory>. If this option is not specified, destination directory is determined automatically as described in the L</B<DESCRIPTION>> section.
ja: 指定した I<directory> 以下にファイルをインストールします。このオプションを指定しない場合、インストール先は L</B<説明>> 章で説明するディレクトリになるように自動的に指定されます。

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_install> usually passes.
ja: I<params> を実行するプログラムに渡すには、B<dh_auto_install> に通常指定するパラメータの後に I<param> を指定してください。

note: type: textblock
en: dh_auto_test - automatically runs a package's test suites
ja: dh_auto_test - パッケージのテストスイートを自動的に実行する

note: type: textblock
en: B<dh_auto_test> [S<I<build system options>>] [S<I<debhelper options>>] [S<B<--> I<params>>]
ja: B<dh_auto_test> [S<I<build system オプション>>] [S<I<debhelper オプション>>] [S<B<--> I<params>>]

note: type: textblock
en: B<dh_auto_test> is a debhelper program that tries to automatically run a package's test suite. It does so by running the appropriate command for the build system it detects the package uses. For example, if there's a Makefile and it contains a B<test> or B<check> target, then this is done by running B<make> (or B<MAKE>, if the environment variable is set). If the test suite fails, the command will exit nonzero. If there's no test suite, it will exit zero without doing anything.
ja: B<dh_auto_test> は、パッケージ付属のテストスイートを自動的に実行しようとするプログラムです。パッケージがどのようなビルドシステムを必要とするかを判定し、適切なコマンドを実行する事でこれを行います。例えば、もし Makefile が存在し、B<test> や B<check> ターゲットが存在する (あるいは環境変数 B<MAKE> が設定されている) 場合、B<make> を実行します もし、テストスイートが失敗に終わった場合、このコマンドは OS へのコマンドのステータスとして、0 以外を返して終了します。もし、テスト用のターゲットが全く存在しなければ、何もせず 0 を返して終了します。

note: type: textblock
en: This is intended to work for about 90% of packages with a test suite. If it doesn't work, you're encouraged to skip using B<dh_auto_test> at all, and just run the test suite manually.
ja: このコマンドは、テストスイートを含む 90 %のパッケージに対して動作するように作られています。もしうまく動作しないようであれば、B<dh_auto_test> を完全に省略し、テストスイートを手動で実行するようにしてください。

note: type: textblock
en: Pass I<params> to the program that is run, after the parameters that B<dh_auto_test> usually passes.
ja: I<params> を動作するプログラムに渡したければ、B<dh_auto_test> へ通常指定するパラメータの後に I<params> を指定してください。

note: type: textblock
en: If the B<DEB_BUILD_OPTIONS> environment variable contains B<nocheck>, no tests will be performed.
ja: B<DEB_BUILD_OPTIONS> 環境変数に B<nocheck> が含まれていれば、テストは実行されません。

note: type: textblock
en: dh_bugfiles - install bug reporting customization files into package build directories
ja: dh_bugfiles - カスタマイズされたバグレポート用ファイルをインストールする

note: type: textblock
en: B<dh_bugfiles> [B<-A>] [S<I<debhelper options>>]
ja: B<dh_bugfiles> [B<-A>] [S<I<debhelper オプション>>]

note: type: textblock
en: B<dh_bugfiles> is a debhelper program that is responsible for installing bug reporting customization files (bug scripts and/or bug control files and/or presubj files) into package build directories.
ja: B<dh_bugfiles> は、バグレポートのカスタマイズ用ファイル (バグスクリプト、バグコントロールファイル、指定済み subject 用ファイル) をパッケージビルドディレクトリへインストールする debhelper プログラムです。

note: type: =head1
en: FILES
ja: ファイル

note: type: textblock
en: This is the script to be run by the bug reporting program for generating a bug report template. This file is installed as F<usr/share/bug/package> in the package build directory if no other types of bug reporting customization files are going to be installed for the package in question. Otherwise, this file is installed as F<usr/share/bug/package/script>. Finally, the installed script is given execute permissions.
ja: このファイルは、バグレポートの雛形を生成するバグ報告用プログラムによって実行されるスクリプトです。処理対象のパッケージについて、他にバグレポートのカスタマイズ用ファイルがインストールされない場合、このファイルがパッケージビルドディレクトリ以下に F<usr/share/bug/package> としてインストールされます。カスタマイズ用ファイルがインストールされる場合は、このスクリプトファイルは F<usr/share/bug/package/script> としてインストールされます。そして、インストールされたファイルには実行権限が付与されます。

note: type: textblock
en: It is the bug control file containing some directions for the bug reporting tool. This file is installed as F<usr/share/bug/package/control> in the package build directory.
ja: バグレポート用ツールのディレクトリ群の名前が記載されるバグコントロールファイルとなります。このファイルは、パッケージビルドディレクトリへ F<usr/share/bug/package/control> としてインストールされます。

note: type: textblock
en: The contents of this file are displayed to the user by the bug reporting tool before allowing the user to write a bug report on the package to the Debian Bug Tracking System. This file is installed as F<usr/share/bug/package/presubj> in the package build directory.
ja: ユーザに Debian Bug Tracking System へバグレポートを記入させる前に、本ファイルの中身がバグレポートツールにて表示されます。このファイルはF<usr/share/bug/package/presubj> としてパッケージビルドディレクトリ以下にインストールされます。

note: type: textblock
en: Install F<debian/bug-*> files to ALL packages acted on when respective F<debian/package.bug-*> files do not exist. Normally, F<debian/bug-*> will be installed to the first package only.
ja: F<debian/package.bug-*> が存在しない場合、ビルドされる全パッケージに F<debian/bug-*> がインストールされます。通常なら、F<debian/bug-*> は F<debian/control> に記載されている、最初のパッケージへのみインストールされるものです。

note: type: textblock
en: dh_builddeb - build Debian binary packages
ja: dh_builddeb - Debianバイナリパッケージのビルドを行う

note: type: textblock
en: B<dh_builddeb> simply calls L<dpkg-deb(1)> to build a Debian package or packages.  It will also build dbgsym packages when L<dh_strip(1)> and L<dh_gencontrol(1)> have prepared them.
ja: B<dh_builddeb> は、Debian パッケージもしくはパッケージ群をビルドするため L<dpkg-deb(1)> を単に呼びだすコマンドです。L<dh_strip(1)> と L<dh_gencontrol(1)> が準備されている場合には dbgsym パッケージもビルドします。

note: type: textblock
en: It supports building multiple binary packages in parallel, when enabled by DEB_BUILD_OPTIONS.
ja: このコマンドは、DEB_BUILD_OPTIONS 環境変数に並列実行のオプションを設定することで、複数のバイナリを並行してビルドできます。

note: type: textblock
en: Use this if you want the generated F<.deb> files to be put in a directory other than the default of "F<..>".
ja: デフォルトの "F<..>" 以外のディレクトリに生成された F<.deb> ファイル群を置きたい場合に本オプションを使ってください。

note: type: textblock
en: Use this if you want to force the generated .deb file to have a particular file name. Does not work well if more than one .deb is generated!
ja: 生成する .deb ファイルに特定のファイル名を強制的に指定したい場合にこのオプションを利用してください。複数の .deb ファイルが生成される場合にはうまく動作しません!

note: type: textblock
en: Pass I<params> to L<dpkg-deb(1)> when it is used to build the package.
ja: パッケージをビルドする時に、I<params> を L<dpkg-deb(1)> へ渡します。

note: type: textblock
en: This is another way to pass I<params> to L<dpkg-deb(1)>.  It is deprecated; use B<--> instead.
ja: これは I<params> を L<dpkg-deb(1)> へ渡す為の別の手段となります。本オプションは廃止されています、代わりに B<--> を使ってください。

note: type: textblock
en: dh_clean - clean up package build directories
ja: dh_clean - パッケージビルドディレクトリを消去する

note: type: textblock
en: B<dh_clean> [S<I<debhelper options>>] [B<-k>] [B<-d>] [B<-X>I<item>] [S<I<path> ...>]
ja: B<dh_clean> [S<I<debhelper オプション>>] [B<-k>] [B<-d>] [B<-X>I<item>] [S<I<path> ...>]

note: type: textblock
en: It does not run "make clean" to clean up after the build process. Use L<dh_auto_clean(1)> to do things like that.
ja: このコマンドはビルドが完了後、掃除をするために "make clean" を実行しません。"make clean" を実行するような事がしたければ、L<dh_auto_clean(1)> を利用してください。

note: type: textblock
en: Can list other paths to be removed.
ja: 消去されるパスの一覧を出力できます。

note: type: textblock
en: Note that directories listed in this file B<must> end with a trailing slash.  Any content in these directories will be removed as well.
ja: このファイル内で記載されているディレクトリは最後がスラッシュで終わるB<必要があります>。これらのディレクトリ内の内容は同様に削除されます。

note: type: textblock
en: This is deprecated, use L<dh_prep(1)> instead.
ja: これは廃止されています。代わりに L<dh_prep(1)> を利用してください。

note: type: textblock
en: Only clean the package build directories, do not clean up any other files at all.
ja: パッケージビルドディレクトリを削除するだけで、他のファイルには一切手をつけません。

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being deleted, even if they would normally be deleted. You may use this option multiple times to build up a list of things to exclude.
ja: 通常は消されるはずのファイルであっても、I<item> をファイル名の一部として含むもの全部を消去候補から除外します。本オプションを何度も指定することで、除外候補を複数指定することが可能です。

note: type: textblock
en: Delete these I<path>s too.
ja: これらの I<path> も消去します。

note: type: textblock
en: dh_compress - compress files and fix symlinks in package build directories
ja: dh_compress - ビルドディレクトリでファイル圧縮とシンボリックリンクの修正を行う

note: type: textblock
en: B<dh_compress> [S<I<debhelper options>>] [B<-X>I<item>] [B<-A>] [S<I<file> ...>]
ja: B<dh_compress> [S<I<debhelper オプション>>] [B<-X>I<項目>] [B<-A>] [S<I<ファイル> ...>]

note: type: textblock
en: B<dh_compress> is a debhelper program that is responsible for compressing the files in package build directories, and makes sure that any symlinks that pointed to the files before they were compressed are updated to point to the new files.
ja: B<dh_compress> はパッケージビルドディレクトリにあるファイルを圧縮する役割を担う debhelper プログラムです。また、圧縮されるファイルをシンボリックリンクが指し示していた場合、圧縮後も正しく指すようにシンボリックリンクを更新します。

note: type: textblock
en: By default, B<dh_compress> compresses files that Debian policy mandates should be compressed, namely all files in F<usr/share/info>, F<usr/share/man>, files in F<usr/share/doc> that are larger than 4k in size, (except the F<copyright> file, F<.html> and other web files, image files, and files that appear to be already compressed based on their extensions), and all F<changelog> files. Plus PCF fonts underneath F<usr/share/fonts/X11/>
ja: デフォルトでは、B<dh_compress> は Debian ポリシーマニュアルの規則に従い圧縮すべきとされるファイルを圧縮します。この場合の圧縮対象のファイルの例としては、F<usr/share/info>、F<usr/share/man> の以下の全ファイル、F<usr/share/doc> 以下にある 4k を 越えるサイズの全ファイル (但し、F<copyright>、F<.html> ファイル、画像ファイル、また拡張子からすでに圧縮されていることがすでに明らかなファイルは対象から除外されます) 、全 F<changelog> ファイルとなります。加えて F<usr/share/fonts/X11/> 以下の PCF フォントファイルも圧縮対象となります。

note: type: textblock
en: These files are deprecated.
ja: これらのファイルは廃止されました。

note: type: textblock
en: Exclude files that contain F<item> anywhere in their filename from being compressed. For example, B<-X.tiff> will exclude TIFF files from compression.  You may use this option multiple times to build up a list of things to exclude.
ja: ファイル名に F<item> が含まれると、このファイルは圧縮対象から除外されます。たとえば、B<-X.tiff> を指定すると、TIFF ファイルは圧縮されなくなります。また除外するものを複数指定するには、このオプションを複数並べることにより指定できます。

note: type: textblock
en: Compress all files specified by command line parameters in ALL packages acted on.
ja: 処理対象となる全パッケージを対象に、コマンドラインパラメータで指定したファイル全てを圧縮します。

note: type: textblock
en: Add these files to the list of files to compress.
ja: これらファイルを圧縮対象のファイルとして追加します。

note: type: =head1
en: CONFORMS TO
ja: 確認すべき事

note: type: textblock
en: Debian policy, version 3.0
ja: Debian ポリシー バージョン 3.0

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being stripped. You may use this option multiple times to build up a list of things to exclude.
ja: I<item> を名前に含むようなファイルを、デバッグ情報除去の対象から外します。もし、複数のファイルを処理させないように指定したければ、本オプションを複数回指定することによって行えます。

note: type: textblock
en: dh_fixperms - fix permissions of files in package build directories
ja: dh_fixperms - パッケージビルドディレクトリ内のファイル権限を修正する

note: type: textblock
en: B<dh_fixperms> is a debhelper program that is responsible for setting the permissions of files and directories in package build directories to a sane state -- a state that complies with Debian policy.
ja: B<dh_fixperms> はパッケージビルドディレクトリ配下でファイルとディレクトリの権限を設定する役割の debhelper プログラムです。また、設定される権限は正しいもの、つまり Debian ポリシーに従って設定されます。

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from having their permissions changed. You may use this option multiple times to build up a list of things to exclude.
ja: パーミッションの変更対象のファイルから、I<item> をファイル名の一部に持つものを除外します。除外対象を列挙したい場合は、このオプションを複数回指定します。

note: type: textblock
en: dh_gencontrol - generate and install control file
ja: dh_gencontrol - control ファイルを生成し、インストールする

note: type: textblock
en: B<dh_gencontrol> is a debhelper program that is responsible for generating control files, and installing them into the I<DEBIAN> directory with the proper permissions.
ja: B<dh_gencontrol> は I<DEBIAN> ディレクトリ以下に control ファイルを生成し、適切な権限を持つようにインストールする役目を持つ debhelper プログラムです。

note: type: textblock
en: This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls it once for each package being acted on (plus related dbgsym packages), and passes in some additional useful flags.
ja: このプログラムは単に L<dpkg-gencontrol(1)> のラッパーです。処理を行うべきそれぞれのパッケージ (関連する dbgsym パッケージも含む) に対し L<dpkg-gencontrol(1)> を都度呼び出し、同時にいくつかの便利なフラグも渡します。

note: type: textblock
en: Pass I<params> to L<dpkg-gencontrol(1)>.
ja: I<params> を L<dpkg-gencontrol(1)> へ渡します。

note: type: textblock
en: This is another way to pass I<params> to L<dpkg-gencontrol(1)>.  It is deprecated; use B<--> instead.
ja: これは、I<params> を L<dpkg-gencontrol(1)> へ渡す別のやり方です。このオプションは廃止されたので、代わりに　B<--> を使ってください。

note: type: textblock
en: dh_icons - Update caches of Freedesktop icons
ja: dh_icons - Freedesktop 規格のアイコンキャッシュを更新する

note: type: textblock
en: B<dh_icons> is a debhelper program that updates caches of Freedesktop icons when needed, using the B<update-icon-caches> program provided by GTK+2.12.  Currently this program does not handle installation of the files, though it may do so at a later date, so should be run after icons are installed in the package build directories.
ja: B<dh_icons> は、GTK+2.12 が提供する B<update-icon-caches> プログラムを使い、必要に応じて Freedesktop 規格のアイコンキャッシュを更新する debhelper プログラムです。現在のところ、このプログラムはアイコンキャッシュファイルをインストールしませんが、将来的は行うでしょう。ですから、アイコンがパッケージビルドディレクトリにインストールされた後で実行される必要があります。

note: type: textblock
en: It takes care of adding maintainer script fragments to call B<update-icon-caches> for icon directories. (This is not done for gnome and hicolor icons, as those are handled by triggers.)  These commands are inserted into the maintainer scripts by L<dh_installdeb(1)>.
ja: アイコンディレクトリに対して B<update-icon-caches> を呼び出すメンテナスクリプト部分の追加を行います (GNOME と hicolor アイコンについては行わず、これらはトリガーによって処理されます)。これらのコマンドは、L<dh_installdeb(1)> によりメンテナスクリプトへ組み込まれます。

note: type: textblock
en: Do not modify maintainer scripts.
ja: メンテナスクリプトの変更を行いません。

note: type: textblock
en: Ross Burton <ross@burtonini.com> Jordi Mallach <jordi@debian.org> Josselin Mouette <joss@debian.org>
ja: Ross Burton <ross@burtonini.com> Jordi Mallach <jordi@debian.org> JosselinMouette <joss@debian.org>

note: type: textblock
en: dh_install - install files into package build directories
ja: dh_install - パッケージビルドディレクトリにファイルをインストールする

note: type: textblock
en: B<dh_install> is a debhelper program that handles installing files into package build directories. There are many B<dh_install>I<*> commands that handle installing specific types of files such as documentation, examples, man pages, and so on, and they should be used when possible as they often have extra intelligence for those particular tasks. B<dh_install>, then, is useful for installing everything else, for which no particular intelligence is needed. It is a replacement for the old B<dh_movefiles> command.
ja: B<dh_install> はパッケージビルドディレクトリにファイルをインストールする debhelper プログラムです。なお、沢山の B<dh_install>I<*> コマンドは、文章や例、あるいは man ページ等のファイルの種類に応じたインストールを担います。こちらのコマンドは、特定の処理を行う為に各々専用の処理を持っていますので、可能な限り、これらのファイルをインストールするときには、B<dh_install>I<*> コマンドを使ってください。なお、B<dh_install> は、ファイルにあわせた特別な処理が不要なファイルをインストールする時に使うと良いでしょう。B<dh_install> は、以前存在した B<dh_movefiles> コマンドを置き換えるコマンドです。

note: type: textblock
en: This program may be used in one of two ways. If you just have a file or two that the upstream Makefile does not install for you, you can run B<dh_install> on them to move them into place. On the other hand, maybe you have a large package that builds multiple binary packages. You can use the upstream F<Makefile> to install it all into F<debian/tmp>, and then use B<dh_install> to copy directories and files from there into the proper package build directories.
ja: このプログラムは２つの用途で利用されます。１つ目は、単に１つ２つのファイルについて開発元 (upstream) の Makefile がインストールをしようとしない時、B<dh_install> を使ってこれらのファイルを目的の場所へ移動できます。２つ目としては、複数のバイナリパッケージをビルドするような大きなパッケージの元で利用する場合であり、開発元 (upstream) の Makefile により、F<debian/tmp> へ一旦インストールしてから、B<dh_install> を使って適切なパッケージビルドディレクトリへディレクトリとファイルをコピーするのに使うというものです。

note: type: textblock
en: Note that if you list exactly one filename or wildcard-pattern on a line by itself, with no explicit destination, then B<dh_install> will automatically guess the destination to use, the same as if the --autodest option were used.
ja: 明示的にインストール先を記述せず、ただ１つのファイル名もしくはワイルドカードパターンを指定した行を列挙した場合は、--autodest オプションが使われた時同様に B<dh_install> は自動的に利用されるインストール先を推測します。

note: type: textblock
en: Look in the specified directory for files to be installed.
ja: インストールするファイルを指定されたディレクトリ内で探します。

note: type: textblock
en: Note that this is not the same as the B<--sourcedirectory> option used by the B<dh_auto_>I<*> commands. You rarely need to use this option, since B<dh_install> automatically looks for files in F<debian/tmp> in debhelper compatibility level 7 and above.
ja: このオプションは、B<dh_auto_>I<*> にあるような B<--sourcedirectory> とは異なる事に注意が必要です。このコマンドではあまりこのオプションは利用する機会がありません。というのも B<dh_install> は互換性レベル v7 以上では自動的に F<debian/tmp> へファイルを探しに行く為です。

note: type: textblock
en: Strip off F<debian/tmp> (or the sourcedir if one is given) from the front of the filename, if it is present, and install into the dirname of the filename. So if the filename is F<debian/tmp/usr/bin>, then that directory will be copied to F<debian/package/usr/>. If the filename is F<debian/tmp/etc/passwd>, it will be copied to F<debian/package/etc/>.
ja: まず、インストール元のファイル名の先頭から F<debian/tmp> の文字列 (あるいは指定されていればソースディレクトリ名) を取り除きます。ファイル名が残っていれば、これをディレクトリ名としてその中にインストールします。つまり、ソースディレクトリとして F<debian/tmp/usr/bin> が与えられると、ファイルのコピー先のディレクトリは F<debian/package/usr/> となります。ファイル名が F<debian/tmp/etc/passwd> であれば、F<debian/package/etc/> へ行われます。

note: type: textblock
en: Lists files (or directories) to install and where to install them to.  The files will be installed into the first package F<dh_install> acts on.
ja: インストールするファイル (またはディレクトリ) と、どこへインストールするかについて列挙します。ファイルは F<dh_install> が処理する最初のパッケージへインストールされます。

note: type: =head1
en: LIMITATIONS
ja: 制限事項

note: type: textblock
en: B<dh_install> cannot rename files or directories, it can only install them with the names they already have into wherever you want in the package build tree.
ja: B<dh_install> はファイルやディレクトリをリネームできません。パッケージビルドツリー内のどこへでも望む場所へ、既に付けられた名前でそれらをインストールすることだけが可能です。

note: type: textblock
en: Please remember the following three things:
ja: 以下の 3 点に留意して下さい:

note: type: =item
en: * The package must be using compatibility level 9 or later (see L<debhelper(7)>)
ja: * パッケージは互換性レベル 9 以降を使う必要があります (L<debhelper(7)> 参照)

note: type: =item
en: * The package will need a build-dependency on dh-exec.
ja: * パッケージは dh-exec へのビルド依存が必要になります。

note: type: =item
en: * The install file must be marked as executable.
ja: * install ファイルは実行可能になっている必要があります。

note: type: textblock
en: dh_installcatalogs - install and register SGML Catalogs
ja: dh_installcatalogs - SGML カタログファイルをインストール・登録する

note: type: textblock
en: B<dh_installcatalogs> is a debhelper program that installs and registers SGML catalogs. It complies with the Debian XML/SGML policy.
ja: B<dh_installcatalogs> は SGML カタログをインストールし登録するプログラムです。この動作は Debian XML/SGML ポリシーに準拠します。

note: type: textblock
en: Catalogs will be registered in a supercatalog, in F</etc/sgml/I<package>.cat>.
ja: カタログは F</etc/sgml/I<package>.cat> にある上位カタログに登録されます。

note: type: textblock
en: A dependency on B<sgml-base> will be added to B<${misc:Depends}>, so be sure your package uses that variable in F<debian/control>.
ja: B<sgml-base> への依存関係に関する情報は B<${misc:Depends}> へ追加されるので、F<debian/control> で必ずこの変数を使ってください。

note: type: textblock
en: Lists the catalogs to be installed per package. Each line in that file should be of the form C<I<source> I<dest>>, where I<source> indicates where the catalog resides in the source tree, and I<dest> indicates the destination location for the catalog under the package build area. I<dest> should start with F</usr/share/sgml/>.
ja: パッケージ毎にインストールすべきカタログを列挙します。このファイルには、各々の行が C<I<source> I<dest>> の形式で指定されている必要があります。ここで、I<source> はインストール元のカタログがソースのどこに入っているかを示し、また、I<dest> にはビルド領域以下のどこにカタログをインストールすべきかを示します。I<dest> は F</usr/share/sgml/> から始まる必要があります。

note: type: textblock
en: Note that this command is not idempotent. L<dh_prep(1)> should be called between invocations of this command. Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.
ja: このコマンドは複数回実行しても安全なコマンドではありません。このコマンドを複数回呼び出す際には必ず間に L<dh_prep(1)> を挿入してください。さもないと、メンテナスクリプト中に同じ内容のコードを繰り返し挿入してしまいます。

note: type: textblock
en: dh_installchangelogs - install changelogs into package build directories
ja: dh_installchangelogs - ビルドディレクトリに changelog をインストールする

note: type: textblock
en: B<dh_installchangelogs> is a debhelper program that is responsible for installing changelogs into package build directories.
ja: B<dh_installchangelogs> はパッケージビルドディレクトリに changelog をインストールを担当する debhelper コマンドです。

note: type: textblock
en: Automatically installed into usr/share/doc/I<package>/ in the package build directory.
ja: これらのファイルは、パッケージビルドディレクトリ以下の usr/share/doc/I<package>/ 配下に自動的にインストールされます。

note: type: textblock
en: Use the package specific name if I<package> needs a different F<NEWS> or F<changelog> file.
ja: I<package> が異なる F<NEWS> や F<changelog> ファイル名を使う必要がある場合は、パッケージ固有の名前を指定してください。

note: type: textblock
en: The F<changelog> file is installed with a name of changelog for native packages, and F<changelog.Debian> for non-native packages.  The F<NEWS> file is always installed with a name of F<NEWS.Debian>.
ja:  F<changelog> ファイルは native パッケージ向けには changelog の名前でインストールされ、非 native パッケージ向けには F<changelog.Debian> としてインストールされます。F<NEWS> は必ず F<NEWS.Debian> の名前でインストールされます。

note: type: textblock
en: Exclude upstream F<changelog> files that contain I<item> anywhere in their filename from being installed.
ja: I<item> をファイル名に含む開発元 (upstream) の F<changelog> ファイルをインストール候補から除外します。

note: type: textblock
en: Install this file as the upstream changelog.
ja: このファイルを開発元 (upstream) の changelog としてインストールします。

note: type: textblock
en: dh_installcron - install cron scripts into etc/cron.*
ja: dh_installcron - cron スクリプトを etc/cron.* へインストールする

note: type: textblock
en: B<dh_installcron> is a debhelper program that is responsible for installing cron scripts.
ja: B<dh_installcron> は cron スクリプトをインストールする役目の debhelper プログラムです。

note: type: textblock
en: Installed into the appropriate F<etc/cron.*/> directory in the package build directory.
ja: これは、パッケージビルドディレクトリ以下にある適切な F<etc/cron.*/> にそれぞれインストールされます。

note: type: textblock
en: dh_installdeb - install files into the DEBIAN directory
ja: dh_installdeb - DEBIAN ディレクトリにファイルをインストールする

note: type: textblock
en: B<dh_installdeb> is a debhelper program that is responsible for installing files into the F<DEBIAN> directories in package build directories with the correct permissions.
ja: B<dh_installdeb> は、パッケージビルドディレクトリにある F<DEBIAN> ディレクトリ以下に、適切な権限を持った状態でファイルをインストールする役目の debhelper プログラムです。

note: type: textblock
en: These maintainer scripts are installed into the F<DEBIAN> directory.
ja: これらのメンテナスクリプトは F<DEBIAN> ディレクトリ以下にインストールされます。

note: type: textblock
en: These control files are installed into the F<DEBIAN> directory.
ja: これらのファイル群は F<DEBIAN> ディレクトリ以下にインストールされます。

note: type: textblock
en: Example:
ja: 例:

note: type: verbatim
en:     # Correct
        rm_conffile /etc/obsolete.conf 0.2~ foo
        # INCORRECT
        rm_conffile /etc/obsolete.conf 0.2~ foo -- "$@"
ja:     # 正解
        rm_conffile /etc/obsolete.conf 0.2~ foo
        # 不正解
        rm_conffile /etc/obsolete.conf 0.2~ foo -- "$@"

note: type: textblock
en: dh_installdebconf - install files used by debconf in package build directories
ja: dh_installdebconf - ビルドディレクトリの debconf が使うファイルをインストールする

note: type: textblock
en: B<dh_installdebconf> is a debhelper program that is responsible for installing files used by debconf into package build directories.
ja: B<dh_installdebconf> は、debconf により使われるファイルをパッケージビルドディレクトリへインストールする役割を持つ debhelper プログラムです。

note: type: textblock
en: Note that if you use debconf, your package probably needs to depend on it (it will be added to B<${misc:Depends}> by this program).
ja: debconf を使うと、パッケージは debconf に対して依存するという事に注意してください (本プログラムにより B<${misc:Depends}> へ依存関係の追加が行われます)。

note: type: textblock
en: Note that for your config script to be called by B<dpkg>, your F<postinst> needs to source debconf's confmodule. B<dh_installdebconf> does not install this statement into the F<postinst> automatically as it is too hard to do it right.
ja: B<dpkg> により設定用スクリプトが呼び出されることになりますが、F<postinst> ファイルには debconf の confmodule を含める必要があることに注意してください。B<dh_installdebconf> はこの作業を F<postinst> へ自動的に挿入しません。というのも、これを自動的に正しく行うのは非常に難しいからです。

note: type: textblock
en: This is the debconf F<config> script, and is installed into the F<DEBIAN> directory in the package build directory.
ja: これはdebconfの F<config> スクリプトです。パッケージビルドディレクトリ以下にある F<DEBIAN> ディレクトリにインストールされます。

note: type: textblock
en: Inside the script, the token B<#DEBHELPER#> is replaced with shell script snippets generated by other debhelper commands.
ja: 本スクリプト内に記載されている B<#DEBHELPER#> という文言は他の debhelper コマンドにより生成されたシェルスクリプトのスニペットによって置き換えられます。

note: type: textblock
en: This is the debconf F<templates> file, and is installed into the F<DEBIAN> directory in the package build directory.
ja: これは debconf の F<templates> ファイルです。パッケージビルドディレクトリの F<DEBIAN> ディレクトリ以下にインストールされます。

note: type: textblock
en: If this directory is present, this program will automatically use L<po2debconf(1)> to generate merged templates files that include the translations from there.
ja: もしこのディレクトリが存在すれば、このプログラムは自動的に L<po2debconf(1)> を呼び出し、このディレクトリ以下にある翻訳されたファイルを含む結合された debconf テンプレートファイルを生成します。

note: type: textblock
en: For this to work, your package should build-depend on F<po-debconf>.
ja: これが動作する為には、F<po-debconf> に関するビルド依存の指定がパッケージに必要です。

note: type: textblock
en: Do not modify F<postrm> script.
ja: F<postrm> ファイルの変更を行いません。

note: type: textblock
en: Pass the params to B<po2debconf>.
ja: B<po2debconf> へパラメータを引き渡します。

note: type: textblock
en: dh_installdirs - create subdirectories in package build directories
ja: dh_installdirs - パッケージビルドディレクトリ以下にサブディレクトリを作成する

note: type: textblock
en: B<dh_installdirs> is a debhelper program that is responsible for creating subdirectories in package build directories.
ja: B<dh_installdirs> はパッケージビルドディレクトリ以下にサブディレクトリを作成する役目を持つ debhelper プログラムです。

note: type: textblock
en: Lists directories to be created in I<package>.
ja: I<package> 以下に作るディレクトリを列挙します

note: type: textblock
en: Create any directories specified by command line parameters in ALL packages acted on, not just the first.
ja: コマンドラインパラメータに指定されたディレクトリを作成します。この場合、最初のパッケージのみならず全パッケージに作用します。

note: type: textblock
en: Create these directories in the package build directory of the first package acted on. (Or in all packages if B<-A> is specified.)
ja: 動作する最初のパッケージのパッケージビルドディレクトリ以下に指定されたディレクトリを作成します (あるいは、B<-A> が指定されれば、全パッケージのパッケージビルドディレクトリに対して行われます)。

note: type: textblock
en: dh_installdocs - install documentation into package build directories
ja: dh_installdocs - パッケージビルドディレクトリ以下にドキュメントをインストールする

note: type: textblock
en: B<dh_installdocs> is a debhelper program that is responsible for installing documentation into F<usr/share/doc/package> in package build directories.
ja: B<dh_installdocs> はパッケージビルドディレクトリ以下にある F<usr/share/doc/package> ディレクトリへドキュメントをインストールする役割を持つ debhelper プログラムです。

note: type: textblock
en: List documentation files to be installed into I<package>.
ja: I<package> にインストールすべきドキュメントファイルの一覧を列挙します。

note: type: textblock
en: These files are installed into the first binary package listed in debian/control.
ja: これらのファイルは debian/control に最初に記載されているバイナリパッケージへインストールされます。

note: type: textblock
en: Note that F<README.debian> files are also installed as F<README.Debian>, and F<TODO> files will be installed as F<TODO.Debian> in non-native packages.
ja: 非 native パッケージの元では、F<README.debian> ファイルは F<README.Debian> としてインストールされ、F<TODO> ファイルは F<TODO.Debian> としてインストールされます。

note: type: textblock
en: Install all files specified by command line parameters in ALL packages acted on.
ja: 全パッケージに対して、コマンドラインパラメータに指定されたファイルを全てインストールします。

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being installed. Note that this includes doc-base files.
ja: インストール対象のファイルから、I<item> をファイル名に含むものを除外します。これには doc-base のファイルも含む点に注意ください。

note: type: textblock
en: Make the documentation directory of all packages acted on be a symlink to the documentation directory of I<package>. This has no effect when acting on I<package> itself, or if the documentation directory to be created already exists when B<dh_installdocs> is run. To comply with policy, I<package> must be a binary package that comes from the same source package.
ja: 処理対象の全パッケージのドキュメンテーションディレクトリを、I<package> のドキュメンテーションディレクトリへのシンボリックリンクを張ることにより作成します。この動作は I<package> そのものには行われず、また、B<dh_installdocs> が動作する時に既に存在しているディレクトリに対しては行われません。ポリシーに準拠する為、I<package> は同じソースパッケージからビルドされるバイナリパッケージである必要があります。

note: type: textblock
en: debhelper will try to avoid installing files into linked documentation directories that would cause conflicts with the linked package. The B<-A> option will have no effect on packages with linked documentation directories, and F<copyright>, F<changelog>, F<README.Debian>, and F<TODO> files will not be installed.
ja: debhelper はファイルをインストール時にシンボリックリンク先のパッケージとの競合を避ける為、シンボリックリンクで作成されているドキュメンテーションディレクトリにはファイルをインストールしません。B<-A> オプションはシンボリックリンクで作成されたディレクトリには作用しません。さらに、この場合、F<copyright>, F<changelog>, F<README.Debian>, F<TODO> ファイルはインストールされません。

note: type: textblock
en: Install these files as documentation into the first package acted on. (Or in all packages if B<-A> is specified).
ja: 作業予定の最初のパッケージに、これらのファイルをドキュメントファイルとしてインストールします (あるいは B<-A> が指定されている場合は、ビルド予定の全てのパッケージに対してインストールします)

note: type: textblock
en: This is an example of a F<debian/package.docs> file:
ja: 以下が F<debian/package.docs> ファイルの例です:

note: type: textblock
en: dh_installemacsen - register an Emacs add on package
ja: dh_installemacsen - Emacsのアドオンパッケージを登録する

note: type: textblock
en: B<dh_installemacsen> is a debhelper program that is responsible for installing files used by the Debian B<emacsen-common> package into package build directories.
ja: B<dh_installemacsen> は、Debian B<emacsen-common> パッケージに利用されるファイルをパッケージビルドディレクトリへインストールする役目の debhelper プログラムです。

note: type: textblock
en: It also automatically generates the F<preinst> F<postinst> and F<prerm> commands needed to register a package as an Emacs add on package. The commands are added to the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how this works.
ja: パッケージを Emacs アドオンパッケージとして登録するのに必要な F<postinst>, F<prerm>, F<prerm> を自動的に生成します。B<dh_installdeb> によって、コマンドがメンテナスクリプトに追加されます。どのように動作するかについては、L<dh_installdeb(1)> を参照ください。

note: type: textblock
en: Installed into F<usr/lib/emacsen-common/packages/compat/package> in the package build directory.
ja: パッケージビルドディレクトリ内の F<usr/lib/emacsen-common/packages/compat/package> へインストールされます。

note: type: textblock
en: Installed into F<usr/lib/emacsen-common/packages/install/package> in the package build directory.
ja: パッケージビルドディレクトリ内の F<usr/lib/emacsen-common/packages/install/package> へインストールされます。

note: type: textblock
en: Installed into F<usr/lib/emacsen-common/packages/remove/package> in the package build directory.
ja: パッケージビルドディレクトリ内の F<usr/lib/emacsen-common/packages/remove/package> へインストールされます。

note: type: textblock
en: Installed into etc/emacs/site-start.d/50I<package>.el in the package build directory. Use B<--priority> to use a different priority than 50.
ja: パッケージビルドディレクトリの etc/emacs/site-start.d/50I<package>.el へインストールします。優先順位を 50 以外を指定するには B<--priority> を使います。

note: type: textblock
en: Do not modify F<postinst>/F<prerm> scripts.
ja: F<postinst>/F<prerm> を変更しません。

note: type: textblock
en: Sets the priority number of a F<site-start.d> file. Default is 50.
ja: F<site-start.d> ファイルに関して優先順位を指定します。デフォルトは 50 です。

note: type: textblock
en: Sets the flavor a F<site-start.d> file will be installed in. Default is B<emacs>, alternatives include B<xemacs> and B<emacs20>.
ja: インストール予定の F<site-start.d> ファイルの形式を設定します。デフォルトは B<emacs> で、他に B<xemacs> と B<emacs20> 形式が存在します。

note: type: textblock
en: dh_installexamples - install example files into package build directories
ja: dh_installexamples - 参考ファイルをビルドディレクトリへインストールする

note: type: textblock
en: B<dh_installexamples> is a debhelper program that is responsible for installing examples into F<usr/share/doc/package/examples> in package build directories.
ja: B<dh_installexamples> はパッケージビルドディレクトリにある F<usr/share/doc/package/examples> へ参考ファイルをインストールする役割の debhelper プログラムです。

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being installed.
ja: I<item> をファイル名の一部として含んでいるファイルをインストール候補から除外します。

note: type: textblock
en: Install these files (or directories) as examples into the first package acted on. (Or into all packages if B<-A> is specified.)
ja: 作業を行う最初のパッケージに、指定されたファイル (あるいはディレクトリ) を例を示す物としてインストールします (あるいは、B<-A>が指定された場合は、全てのパッケージに対してインストールを行います)。

note: type: textblock
en: Note that B<dh_installexamples> will happily copy entire directory hierarchies if you ask it to (similar to B<cp -a>). If it is asked to install a directory, it will install the complete contents of the directory.
ja: 特記すべき事として、もし指定されれば (B<cp -a> のように) 、ディレクトリ以下まるごとコピーするようにすると便利です。もし、インストールもとディレクトリを指定すれば、このコマンドはディレクトリ以下全部をインストールします。

note: type: textblock
en: dh_installifupdown - install if-up and if-down hooks
ja: dh_installifupdown - if-up と if-down フックをインストールします

note: type: textblock
en: B<dh_installifupdown> is a debhelper program that is responsible for installing F<if-up>, F<if-down>, F<if-pre-up>, and F<if-post-down> hook scripts into package build directories.
ja: B<dh_installifupdown> は F<if-up>, F<if-down>, F<if-pre-up>, F<if-post-down> フックをパッケージビルドディレクトリ以下にインストールする為の debhelper プログラムです。

note: type: textblock
en: These files are installed into etc/network/if-*.d/I<package> in the package build directory.
ja: これらファイルは、パッケージビルドディレクトリ以下にある、etc/network/if-*.d/I<package> 以下にインストールされます。

note: type: textblock
en: Look for files named F<debian/package.name.if-*> and install them as F<etc/network/if-*/name>, instead of using the usual files and installing them as the package name.
ja: F<debian/package.name.if-*> ファイルを見つけ出し、F<etc/network/if-*/name> へインストールします。この時、本オプションを指定しない時に行われるような、通常ファイルのインストールとは違い、ファイルがパッケージ名としてインストールされる事はありません。

note: type: textblock
en: dh_installinfo - install info files
ja: dh_installinfo - info ファイルをインストールする

note: type: textblock
en: B<dh_installinfo> is a debhelper program that is responsible for installing info files into F<usr/share/info> in the package build directory.
ja: B<dh_installinfo> は、パッケージビルドディレクトリ内の F<usr/share/info> ディレクトリ以下に info ファイルをインストールします。

note: type: textblock
en: List info files to be installed.
ja: インストールすべき info ファイルを列挙したものです。

note: type: textblock
en: Install these info files into the first package acted on. (Or in all packages if B<-A> is specified).
ja: こちらにて指定される info ファイルを、処理を行う最初のパッケージにインストールします (B<-A> が指定されていれば、全パッケージに対してインストールされます)

note: type: textblock
en: dh_installinit - install service init files into package build directories
ja: dh_installinit - ビルドディレクトリに service init ファイルをインストールする

note: type: textblock
en: It also automatically generates the F<postinst> and F<postrm> and F<prerm> commands needed to set up the symlinks in F</etc/rc*.d/> to start and stop the init scripts.
ja: このコマンドは、F</etc/rc*.d/> 以下にシンボリックリンクを張り、start と stop 手続きを持つような init スクリプトをセットアップするのに必要な F<postinst>, F<postrm>, F<prerm> コマンドを自動的に生成します。

note: type: textblock
en: If this exists, it is installed into etc/init.d/I<package> in the package build directory.
ja: もし本ファイルが存在すれば、パッケージビルドディレクトリ以下の etc/init/I<package> ディレクトリにインストールされます。

note: type: textblock
en: If this exists, it is installed into etc/default/I<package> in the package build directory.
ja: もしこちらが存在すれば、パッケージビルドディレクトリ内の etc/default/I<package> へこのファイルをインストールします。

note: type: textblock
en: Do not modify F<postinst>/F<postrm>/F<prerm> scripts.
ja: F<postinst>/F<postrm>/F<prerm> スクリプトは変更しないでください。

note: type: textblock
en: This can be useful for daemons that should not have a possibly long downtime during upgrade. But you should make sure that the daemon will not get confused by the package being upgraded while it's running before using this option.
ja: このオプションは、アップグレード中に長く動作が停止してはいけないような daemon を扱う際に便利です。しかしながら、このオプションを利用して dh_installinit が処理をしている間のアップグレード途中のパッケージを daemon が参照して混乱しないことを保証する必要があります。

note: type: textblock
en: Do not start the init script on install or upgrade, or stop it on removal.  Only call B<update-rc.d>. Useful for rcS scripts.
ja: インストール時、あるいはアップグレード時に init スクリプトを start させません。あるいは、パッケージを削除する時にも stop 手続きが呼ばれなくなります。その一方で、B<update-rc.d> のみ呼び出されます。本オプションは rcS スクリプトをインストールする際に便利です。

note: type: textblock
en: Install the init script (and default file) as well as upstart job file using the filename I<name> instead of the default filename, which is the package name. When this parameter is used, B<dh_installinit> looks for and installs files named F<debian/package.name.init>, F<debian/package.name.default> and F<debian/package.name.upstart> instead of the usual F<debian/package.init>, F<debian/package.default> and F<debian/package.upstart>.
ja: パッケージ名の代わりに、I<name> をファイル名とするファイルを、upstart 用 job ファイルや、init スクリプト (あるいはデフォルトのファイル) として利用します。このパラメータが利用されると、B<dh_installinit> は F<debian/package.name.upstart>、F<debian/package.name.init>、F<debian/package.name.default> を探し、インストールを行います。この場合、通常使われる F<debian/package.upstart>、F<debian/package.init>、F<debian/package.default> は利用されません。

note: type: textblock
en: Use I<scriptname> as the filename the init script is installed as in F<etc/init.d/> (and also use it as the filename for the defaults file, if it is installed). If you use this parameter, B<dh_installinit> will look to see if a file in the F<debian/> directory exists that looks like F<package.scriptname> and if so will install it as the init script in preference to the files it normally installs.
ja: I<scriptname> を F<etc/init.d/> 以下にインストールする init スクリプトのファイル名として利用します (デフォルトのファイルがインストールされるなら、その時の名前として利用する場合もあります) 。もしこのパラメータを利用すると、B<dh_installinit> は F<debian/> ディレクトリ以下に F<package.scriptname> のような名前のファイルがあるかどうかを探し、通常インストールするファイルよりも、優先してこのような名前を持つファイルを init スクリプトとして扱うようになります。

note: type: textblock
en: This parameter is deprecated, use the B<--name> parameter instead. This parameter is incompatible with the use of upstart jobs.
ja: このパラメータは廃止されています。代わりに B<--name> パラメータを利用ください。なお、B<--init-script=>I<scriptname> では upstart 用 job ファイルを扱うようには出来ていません。

note: type: textblock
en: Call the named shell I<function> if running the init script fails. The function should be provided in the F<prerm> and F<postinst> scripts, before the B<#DEBHELPER#> token.
ja: もしinitスクリプトの動作が失敗に終わった時、シェル関数の I<function> を呼び出すようにします。この関数は、F<prerm> や F<postinst> の中で定義されていなければならず、また、B<#DEBHELPER#> 句が現れるよりも前に定義されている必要があります。

note: type: textblock
en: dh_installlogcheck - install logcheck rulefiles into etc/logcheck/
ja: dh_installlogcheck - etc/logcheck/ に logcheck 用ルールファイルをインストールする

note: type: textblock
en: B<dh_installlogcheck> is a debhelper program that is responsible for installing logcheck rule files.
ja: B<dh_installlogcheck> は logcheck 用のルール定義ファイルをインストールする役目の debhelper プログラムです。

note: type: textblock
en: Each of these files, if present, are installed into corresponding subdirectories of F<etc/logcheck/> in package build directories.
ja: これらのファイルが存在する場合、パッケージビルドディレクトリ内の F<etc/logcheck/> サブディレクトリ以下にファイルに応じてインストールされます。

note: type: textblock
en: Look for files named F<debian/package.name.logcheck.*> and install them into the corresponding subdirectories of F<etc/logcheck/>, but use the specified name instead of that of the package.
ja: F<debian/package.name.logcheck.*> の名前を持つファイルを探し、これらを F<etc/logcheck/> 以下の各ファイルに応じた場所へインストールします。この時、パッケージの名前を使わず指定された名前を利用します。

note: type: verbatim
en: This program is a part of debhelper.
ja: このプログラムはdebhelperの一部です。

note: type: textblock
en: dh_installlogrotate - install logrotate config files
ja: dh_installlogrotate - logrotate用設定ファイルをインストールする

note: type: textblock
en: B<dh_installlogrotate> is a debhelper program that is responsible for installing logrotate config files into F<etc/logrotate.d> in package build directories.  Files named F<debian/package.logrotate> are installed.
ja: B<dh_installlogrotate> はパッケージビルドディレクトリ内にある F<etc/logrotate.d> へ logrotate 用設定ファイルをインストールする役目の debhelper プログラムとなります。F<debian/package.logrotate> という名前を持つファイル群がインストールされます。

note: type: textblock
en: Look for files named F<debian/package.name.logrotate> and install them as F<etc/logrotate.d/name>, instead of using the usual files and installing them as the package name.
ja: F<debian/package.name.logrotate> という名前を持つファイルを探し、F<etc/logrotate.d/name> としてインストールを行います。この場合、通常使うファイルを利用せず、パッケージ名を持つファイルとしてインストールは行いません。

note: type: textblock
en: dh_installman - install man pages into package build directories
ja: dh_installman - パッケージビルドディレクトリ以下に man ページをインストールする

note: type: textblock
en: It also supports translated man pages, by looking for extensions like F<.ll.8> and F<.ll_LL.8>, or by use of the B<--language> switch.
ja: このコマンドは翻訳された man ページについても、F<.ll.8> や F<.ll_LL.8> の拡張子に持つファイルを探す事により、あるいは、B<--language> を指定することによって扱います。

note: type: textblock
en: If B<dh_installman> seems to install a man page into the wrong section or with the wrong extension, this is because the man page has the wrong section listed in its B<.TH> or B<.Dt> line. Edit the man page and correct the section, and B<dh_installman> will follow suit. See L<man(7)> for details about the B<.TH> section, and L<mdoc(7)> for the B<.Dt> section. If B<dh_installman> seems to install a man page into a directory like F</usr/share/man/pl/man1/>, that is because your program has a name like F<foo.pl>, and B<dh_installman> assumes that means it is translated into Polish. Use B<--language=C> to avoid this.
ja: B<dh_installman> が間違った章番号や、間違った拡張子をつけて man ページをインストールするように見えるときがあります。これは、man ページが間違った章番号を B<.TH> や B<.Dt> 行に列挙しているのが原因です。この場合、man ページを編集して、章番号を正しくすれば、B<dh_installman> は意図どおりに動作するようになります。B<.TH> 章についての詳細は L<man(7)> を参照ください。さらに、B<.Dt> 章については、L<mdoc(7)> を参照ください。また、B<dh_installman> が F</usr/share/man/pl/man1/> のようなディレクトリへ man ページをインストールしてしまう場合があります。これは、パッケージにF <foo.pl> のような名前を持つファイルがあり、B<dh_installman> がこれをポーランド語への翻訳済み man ページと勘違いする時となります。この動作を避けるには、B<--language=C> を利用してください。

note: type: textblock
en: After the man page installation step, B<dh_installman> will check to see if any of the man pages in the temporary directories of any of the packages it is acting on contain F<.so> links. If so, it changes them to symlinks.
ja: B<dh_installman> は、man ページをインストールした後に、処理を行ったパッケージ内の一時ディレクトリ以下にある全 man ページを対象に、F<.so> リンクを含むかどうかを確認します。もし存在するようであれば、その man ページ本体をシンボリックリンクへ変更します。

note: type: textblock
en: Also, B<dh_installman> will use man to guess the character encoding of each manual page and convert it to UTF-8. If the guesswork fails for some reason, you can override it using an encoding declaration. See L<manconv(1)> for details.
ja: また、B<dh_installman> は man コマンドを使って、man ページの文字コードを推定し、UTF-8 に変換します。この推定作業は失敗に終わる事があるので、文字コード宣言文を使って検出されるべき文字コードの情報を上書きできます。詳細については L<manconv(1)> を参照ください。

note: type: textblock
en: Lists man pages to be installed.
ja: インストールされるべき man ページを列挙したものです。

note: type: textblock
en: Use this to specify that the man pages being acted on are written in the specified language.
ja: 処理予定の man ページがどんな言語で記載されているかをこちらのオプションを使って指定します。

note: type: textblock
en: Install these man pages into the first package acted on. (Or in all packages if B<-A> is specified).
ja: 最初に処理するパッケージにこれらの man ページをインストールします (あるいは、B<-A> が指定された場合は、全パッケージにインストールを行います)

note: type: textblock
en: An older version of this program, L<dh_installmanpages(1)>, is still used by some packages, and so is still included in debhelper.  It is, however, deprecated, due to its counterintuitive and inconsistent interface. Use this program instead.
ja: 本プログラムの昔のバージョンのプログラムである L<dh_installmanpages(1)> を未だに利用しているパッケージが存在します。また、L<dh_installmanpages(1)> は未だに debhelper に梱包されています。しかしながら、このプログラムは、非直感的で統一されていないインターフェースの為に、すでに廃止となっています。代わりに本プログラムを使ってください。

note: type: textblock
en: dh_installmanpages - old-style man page installer (deprecated)
ja: dh_installmanpages - 古いスタイルの man ページのインストール用プログラム (廃止)

note: type: textblock
en: B<dh_installmanpages> is a debhelper program that is responsible for automatically installing man pages into F<usr/share/man/> in package build directories.
ja: B<dh_installmanpages> はパッケージビルドディレクトリ以下にある F<usr/share/man/> ディレクトリへ man ページを自動的にインストールする役目の debhelper プログラムです。

note: type: textblock
en: This is a DWIM-style program, with an interface unlike the rest of debhelper. It is deprecated, and you are encouraged to use L<dh_installman(1)> instead.
ja: これは、いわゆる「良きに計らえ (DWIM)」スタイルのプログラムであり、他の debhelper とはインターフェース仕様が異なります。本プログラムは廃止されているので、代わりに L<dh_installman(1)> コマンドを使うようにしてください。

note: type: textblock
en: B<dh_installmanpages> scans the current directory and all subdirectories for filenames that look like man pages. (Note that only real files are looked at; symlinks are ignored.) It uses L<file(1)> to verify that the files are in the correct format. Then, based on the files' extensions, it installs them into the correct man directory.
ja: B<dh_installmanpages> は man ページらしき名前を持つファイルを、カレントディレクトリや、カレントディレクトリ以下の全てのサブディレクトリで探し回ります (ファイルの実体のみが対象となります。つまり、シンボリックリンクは無視されます)。本プログラムは、L<file(1)> コマンドを使ってファイルが正しいフォーマットであるかを検証します。その為、拡張子にしたがい、処理対象の man ページを正しい man ページ用ディレクトリへインストールします。

note: type: textblock
en: All filenames specified as parameters will be skipped by B<dh_installmanpages>.  This is useful if by default it installs some man pages that you do not want to be installed.
ja: パラメータとして指定されているファイルは、全て B<dh_installmanpages> により無視されます。これは、デフォルトでは意図しない場所に man ページがインストールされてしまう場合に便利です。

note: type: textblock
en: After the man page installation step, B<dh_installmanpages> will check to see if any of the man pages are F<.so> links. If so, it changes them to symlinks.
ja: manページのインストールが終わったあと、B<dh_installmanpages> は処理対象の man ページが F<.so> リンクの対象であるかどうかを調べます。もしそうであれば、こちらをシンボリックリンクへ変更します。

note: type: textblock
en: Do not install these files as man pages, even if they look like valid man pages.
ja: 有効な man ページのようにみえても、これらファイルを man ページとしてインストールしないようにします。

note: type: =head1
en: BUGS
ja: バグ

note: type: textblock
en: B<dh_installmanpages> will install the man pages it finds into B<all> packages you tell it to act on, since it can't tell what package the man pages belong in. This is almost never what you really want (use B<-p> to work around this, or use the much better L<dh_installman(1)> program instead).
ja: B<dh_installmanpages> は作業するように指定した B<全パッケージ> で発見した man ページをいっぺんにインストールしてしまいます。これは、どのパッケージにどの man ページが対応しているかについて指定する方法がない為です。この動作は多くのケースで必ずしも望ましくない動作となります (B<-p> を指定する事により、本問題を回避できますが、もっと良いのは、L<dh_installman(1)> を代わりに使う事です)。

note: type: textblock
en: Files ending in F<.man> will be ignored.
ja: F<.man> でファイル名が終わっているファイルは無視されます。

note: type: textblock
en: Files specified as parameters that contain spaces in their filenames will not be processed properly.
ja: スペースを含むファイル名を持つファイルをパラメータに指定すると、正しく扱われません。

note: type: textblock
en: dh_installmenu - install Debian menu files into package build directories
ja: dh_installmenu - ビルドディレクトリへ Debian メニューファイルをインストールする

note: type: textblock
en: B<dh_installmenu> is a debhelper program that is responsible for installing files used by the Debian B<menu> package into package build directories.
ja: B<dh_installmenu> は Debian B<menu> パッケージを使ってパッケージビルドディレクトリ以下にファイルをインストールする役目の debhelper プログラムです。

note: type: textblock
en: It also automatically generates the F<postinst> and F<postrm> commands needed to interface with the Debian B<menu> package. These commands are inserted into the maintainer scripts by L<dh_installdeb(1)>.
ja: このプログラムは、Debian B<menu> と連携するのに必要な内容を含む F<postinst> と F<postrm> コマンドを自動的に生成します。生成された F<postinst> と F<postrm> コマンドは L<dh_installdeb(1)> によりメンテナスクリプトへ組み込まれます。

note: type: textblock
en: Debian menu files, installed into usr/share/menu/I<package> in the package build directory. See L<menufile(5)> for its format.
ja: Debianメニューファイルです。パッケージビルドディレクトリ以下の usr/share/menu/I<package> へインストールされます。フォーマットについては L<menufile(5)> を参照ください。

note: type: textblock
en: Debian menu method files, installed into etc/menu-methods/I<package> in the package build directory.
ja: Debian メニューメソッドファイルです。こちらはパッケージビルドディレクトリ以下にある etc/menu-methods/I<package> へインストールされます。

note: type: textblock
en: Do not modify F<postinst>/F<postrm> scripts.
ja: F<postinst>/F<postrm> スクリプトを変更しません。

note: type: textblock
en: dh_installmime - install mime files into package build directories
ja: dh_installmime - mime ファイルをビルドディレクトリへインストールする

note: type: textblock
en: B<dh_installmime> is a debhelper program that is responsible for installing mime files into package build directories.
ja: B<dh_installmime> はパッケージビルドディレクトリ以下に mime ファイル群をインストールする役目の debhelper プログラムです。

note: type: textblock
en: Installed into usr/lib/mime/packages/I<package> in the package build directory.
ja: パッケージビルドディレクトリ内の usr/lib/mime/packages/I<package> へインストールされます。

note: type: textblock
en: Installed into /usr/share/mime/packages/I<package>.xml in the package build directory.
ja: パッケージビルドディレクトリ内の /usr/share/mime/packages/I<package>.xml へインストールされます。

note: type: textblock
en: dh_installmodules - register kernel modules
ja: dh_installmodules - カーネルモジュールを登録する

note: type: textblock
en: B<dh_installmodules> is a debhelper program that is responsible for registering kernel modules.
ja: B<dh_installmodules> は、カーネルモジュールを登録する役目の debhelper プログラムです。

note: type: textblock
en: Kernel modules are searched for in the package build directory and if found, F<preinst>, F<postinst> and F<postrm> commands are automatically generated to run B<depmod> and register the modules when the package is installed.  These commands are inserted into the maintainer scripts by L<dh_installdeb(1)>.
ja: パッケージビルドディレクトリ以下にて、カーネルモジュールを探し、見つけると、F<preinst>, F<postinst>, F<postrm> コマンドが自動的に生成されます。これらコマンドは、パッケージをインストールする際に、B<depmod> を実行し、カーネルモジュールを登録するような内容となっております。これらのコマンドは L<dh_installdeb(1)> によりメンテナスクリプトへ挿入されます。

note: type: textblock
en: Do not modify F<preinst>/F<postinst>/F<postrm> scripts.
ja: F<preinst>/F<postinst>/F<postrm> スクリプトを変更しません。

note: type: textblock
en: When this parameter is used, B<dh_installmodules> looks for and installs files named debian/I<package>.I<name>.modprobe instead of the usual debian/I<package>.modprobe
ja: このパラメータが利用されると、B<dh_installmodules> は通常利用する debian/I<package>.modprobe ファイルの代わりに debian/I<package>.I<name>.modprobe ファイルをインストールします。

note: type: textblock
en: dh_installpam - install pam support files
ja: dh_installpam - pam サポートファイルをインストールする

note: type: textblock
en: B<dh_installpam> is a debhelper program that is responsible for installing files used by PAM into package build directories.
ja: B<dh_installpam> はパッケージビルドディレクトリ以下に PAM で利用するファイルをインストールする役目の debhelper プログラムです。

note: type: textblock
en: dh_installppp - install ppp ip-up and ip-down files
ja: dh_installppp - ppp 用の ip-up, ip-down ファイルをインストールする

note: type: textblock
en: B<dh_installppp> is a debhelper program that is responsible for installing ppp ip-up and ip-down scripts into package build directories.
ja: B<dh_installppp> は ppp 用の ip-up, ip-down スクリプトをパッケージビルドディレクトリ以下にインストールする役目を持つ debhelper プログラムです。

note: type: textblock
en: Installed into etc/ppp/ip-up.d/I<package> in the package build directory.
ja: これらファイルはパッケージビルドディレクトリ以下に etc/ppp/ip-up.d/I<package> としてインストールされます。

note: type: textblock
en: Installed into etc/ppp/ip-down.d/I<package> in the package build directory.
ja: これらファイルは、パッケージビルドディレクトリ以下に etc/ppp/ip-down.d/I<package> としてインストールされます。

note: type: textblock
en: Look for files named F<debian/package.name.ppp.ip-*> and install them as F<etc/ppp/ip-*/name>, instead of using the usual files and installing them as the package name.
ja: F<debian/package.name.ppp.ip-*> と名前のつくファイルを探し、F<etc/ppp/ip-*/name> 以下にこれらをインストールします。こちらが指定されると、通常インストールされるファイルはインストール対象とならず、また、インストールの際にパッケージの名前としてインストールする動作を行いません。

note: type: textblock
en: dh_installudev - install udev rules files
ja: dh_installudev - udev 用ルールファイルをインストールする

note: type: textblock
en: B<dh_installudev> is a debhelper program that is responsible for installing B<udev> rules files.
ja: B<dh_installudev> は B<udev> 用ルールファイルをインストールする役目を持つ debhelper プログラムです。

note: type: textblock
en: When this parameter is used, B<dh_installudev> looks for and installs files named debian/I<package>.I<name>.udev instead of the usual debian/I<package>.udev.
ja: このパラメータを利用する時は、B<dh_installudev> は debian/I<package>.I<name>.udev と名前のあるファイルを探してインストールします。通常使われるはずの debian/I<package>.udev はこのパラメータが利用されている場合は利用されません。

note: type: textblock
en: Sets the priority the file. Default is 60.
ja: ファイルの優先順位を指定します。デフォルトは 60 です。

note: type: textblock
en: dh_installwm - register a window manager
ja: dh_installwm - ウィンドウマネージャを登録する

note: type: textblock
en: List window manager programs to register.
ja: 登録すべきウインドウマネージャを列挙します。

note: type: textblock
en: Set the priority of the window manager. Default is 20, which is too low for most window managers; see the Debian Policy document for instructions on calculating the correct value.
ja: ウインドウマネージャの優先順位を設定します。デフォルトは 20 で、こちらはほとんどのウインドウマネージャには低すぎる優先順位です。正しい値を算出する手順については、Debian ポリシーマニュアルを参照してください。

note: type: textblock
en: Do not modify F<postinst>/F<prerm> scripts. Turns this command into a no-op.
ja: F<postinst>/F<prerm> スクリプトを変更しません。このコマンドにより、スクリプトの動作については何も影響を与えないようにします。

note: type: textblock
en: Window manager programs to register.
ja: 登録されるウインドウマネージャ。

note: type: textblock
en: dh_installxfonts - register X fonts
ja: dh_installxfonts - X 用フォント群の登録を行う

note: type: textblock
en: B<dh_installxfonts> is a debhelper program that is responsible for registering X fonts, so their corresponding F<fonts.dir>, F<fonts.alias>, and F<fonts.scale> be rebuilt properly at install time.
ja: B<dh_installxfonts> は、X 用のフォントを登録し、フォントに関係する F<fonts.dir>, F<fonts.alias>, F<fonts.scale> を再ビルドして正しい内容になるようにします。

note: type: textblock
en: Before calling this program, you should have installed any X fonts provided by your package into the appropriate location in the package build directory, and if you have F<fonts.alias> or F<fonts.scale> files, you should install them into the correct location under F<etc/X11/fonts> in your package build directory.
ja: このプログラムを呼び出す前に、パッケージビルドディレクトリ内の適切な場所に、パッケージが提供しようとしているX用のフォント全部をインストールしておく必要があります。また、パッケージビルドディレクトリ以下の F<etc/X11/fonts> 以下の正しい場所に F<fonts.alias> や F<fonts.scale> ファイルをインストールしておく必要があります。

note: type: textblock
en: Your package should depend on B<xfonts-utils> so that the B<update-fonts->I<*> commands are available. (This program adds that dependency to B<${misc:Depends}>.)
ja: B<update-fonts->I<*> コマンドが利用可能なように B<xfonts-utils> に対しての依存関係を記載しておく必要があります (本プログラムは B<${misc:Depends}> へこの依存関係を付け加えます)。

note: type: textblock
en: This program automatically generates the F<postinst> and F<postrm> commands needed to register X fonts. These commands are inserted into the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of how this works.
ja: 本プログラムは X フォントを登録するのに必要な F<postinst> と F<postrm> コマンドを機械的に生成します。生成される F<postinst> と F<postrm> は B<dh_installdeb> により、メンテナスクリプトに挿入されます。こちらの動作については、L<dh_installdeb(1)> を参照してください。

note: type: textblock
en: See L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, and L<update-fonts-dir(8)> for more information about X font installation.
ja: X 用フォントのインストールについてさらに情報が必要な場合は、L<update-fonts-alias(8)>, L<update-fonts-scale(8)>, L<update-fonts-dir(8)> を参照してください。

note: type: textblock
en: See Debian policy, section 11.8.5. for details about doing fonts the Debian way.
ja: Debian 流でのフォントの取扱い詳細については、Debian ポリシーマニュアルの 11.8.5 章を参照してください。

note: type: textblock
en: dh_link - create symlinks in package build directories
ja: dh_link - パッケージビルドディレクトリ内でシンボリックリンクを作成する

note: type: textblock
en: B<dh_link> is a debhelper program that creates symlinks in package build directories.
ja: B<dh_link> はパッケージビルドディレクトリ内でシンボリックリンクを作成する debhelper プログラムです。

note: type: textblock
en: Any pre-existing destination files will be replaced with symlinks.
ja: もしシンボリックリンクを作成しようとしている場所に同名のファイルが存在した場合は、シンボリックリンクに置き換えられます。

note: type: textblock
en: B<dh_link> also scans the package build tree for existing symlinks which do not conform to Debian policy, and corrects them (v4 or later).
ja: B<dh_link> は、また、パッケージビルドツリー以下で、Debian ポリシーマニュアル違反であるようなすでに存在するシンボリックリンクを探し回り、そしてこれらを正しくなるように修正します (互換性レベル v4 以上)。

note: type: textblock
en: Lists pairs of source and destination files to be symlinked. Each pair should be put on its own line, with the source and destination separated by whitespace.
ja: これらファイルにはお互いシンボリックリンクされるような元ファイル名と先ファイル名のリストを列挙します。それぞれのペアは１つの行に記載されなければならず、さらに元ファイル名と先ファイル名は空白で区切られていなければなりません。

note: type: textblock
en: Create any links specified by command line parameters in ALL packages acted on, not just the first.
ja: コマンドラインパラメータとして指定されているリンクを、単に最初に処理するパッケージのみではなく、作業する予定の全パッケージ対して作成します。

note: type: textblock
en: Exclude symlinks that contain I<item> anywhere in their filename from being corrected to comply with Debian policy.
ja: ファイル名の一部に I<item> を含むシンボリックリンクを、Debian ポリシー準拠の為のリンク修正の対象から除外します。

note: type: textblock
en: Create a file named I<destination> as a link to a file named I<source>. Do this in the package build directory of the first package acted on.  (Or in all packages if B<-A> is specified.)
ja: I<source> という名前へのリンクファイルとして I<destination> という名前のファイルを作成します。最初にビルドされるパッケージビルドディレクトリ以下にてこの操作を行います (あるいは、B<-A> が指定されている場合は全パッケージに対して作業を行います)。

note: type: textblock
en: Make F<bar.1> be a symlink to F<foo.1>
ja: F<foo.1> へのシンボリックリンクとして F<bar.1> を作成します。

note: type: textblock
en: Make F</usr/lib/foo/> be a link to F</var/lib/foo/>, and F<bar.1> be a symlink to the F<foo.1>
ja: F</var/lib/foo/> へのシンボリックリンクとして F</usr/lib/foo/> を作成します。また、F<foo.1> へのシンボリックリンクとして、F<bar.1> を作成します。

note: type: textblock
en: dh_lintian - install lintian override files into package build directories
ja: dh_lintian - ビルドディレクトリに lintian への override ファイルをインストールする

note: type: textblock
en: Installed into usr/share/lintian/overrides/I<package> in the package build directory. This file is used to suppress erroneous lintian diagnostics.
ja: パッケージビルドディレクトリ以下の usr/share/lintian/overrides/I<package> へインストールを行います。このファイルは、lintian が誤った診断をするのを防ぐ為に利用されます。

note: type: textblock
en: These files are not installed, but will be scanned by lintian to provide overrides for the source package.
ja: これらファイルはインストールされません。しかしながら、ソースパッケージに対する診断結果を再定義する為、lintian にて本ファイルの中身がスキャンされます。

note: type: textblock
en: dh_listpackages - list binary packages debhelper will act on
ja: dh_listpackages - debhelper が処理するバイナリパッケージの一覧を列挙する

note: type: textblock
en: B<dh_listpackages> is a debhelper program that outputs a list of all binary packages debhelper commands will act on. If you pass it some options, it will change the list to match the packages other debhelper commands would act on if passed the same options.
ja: B<dh_listpackages> は、debhelper により処理を行う必要のある全てのバイナリパッケージの一覧を得る事が出来る debhelper プログラムです。このプログラムに、あるオプションを渡すと、同じオプションを引き渡された他の debhelper コマンドへ処理させる予定のパッケージ一覧を、変更できます。

note: type: textblock
en: dh_makeshlibs - automatically create shlibs file and call dpkg-gensymbols
ja: dh_makeshlibs - 自動的に shlibs ファイルを作成し、dpkg-gensymbols を呼び出す

note: type: textblock
en: B<dh_makeshlibs> is a debhelper program that automatically scans for shared libraries, and generates a shlibs file for the libraries it finds.
ja: B<dh_makeshlibs> は自動的に共有ライブラリをスキャンし、見つけたライブラリに対する shlibs ファイルを生成する debhelper プログラムです。

note: type: textblock
en: Note in compat levels 9 and earlier, this file was installed by L<dh_installdeb(1)> rather than B<dh_makeshlibs>.
ja: 互換性レベル 9 以前では、このファイルは B<dh_makeshlibs> ではなく L<dh_installdeb(1)> によってインストールされる点に注意して下さい。

note: type: textblock
en: These symbols files, if present, are passed to L<dpkg-gensymbols(1)> to be processed and installed. Use the I<arch> specific names if you need to provide different symbols files for different architectures.
ja: これらのシンボルファイルは、もし存在すれば、L<dpkg-gensymbols(1)> へ渡され、かかる処理とインストールが行われます。異なるアーキテクチャの元で異なるシンボルを利用するには、I<arch> を指定してください。

note: type: textblock
en: Instead of trying to guess the major number of the library with objdump, use the major number specified after the -m parameter. This is much less useful than it used to be, back in the bad old days when this program looked at library filenames rather than using objdump.
ja: objdump をつかってライブラリの主バージョン番号を推定する代わりに、-m パラメータのあとに主バージョン番号を設定できます。以前本プログラムはライブラリの主バージョン番号を求めるのに objdump を使わず、ライブラリのファイル名から判定していた為、このパラメータが便利だった事があります。

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename or directory from being treated as shared libraries.
ja: I<item> が対象のファイルや格納されているディレクトリの名前に含まれている場合、共有ファイルとして扱うのを止めます。

note: type: textblock
en: Create an additional line for udebs in the shlibs file and use I<udeb> as the package name for udebs to depend on instead of the regular library package.
ja: shlibs ファイルに udebs 用途の追加情報を作成し、通常のライブラリパッケージの名前を使う代わりに、I<udeb> を udebs のパッケージの名前として利用します。

note: type: textblock
en: Pass I<params> to L<dpkg-gensymbols(1)>.
ja: I<params> を L<dpkg-gensymbols(1)> へ引き渡します。

note: type: verbatim
en: Generates a shlibs file that looks something like:
      libfoobar 1 libfoobar1 (>= 1.0)
ja: 以下のような shlibs ファイルが生成されます:
      libfoobar 1 libfoobar1 (>= 1.0)

note: type: textblock
en: dh_md5sums - generate DEBIAN/md5sums file
ja: dh_md5sums - DEBIAN/md5sums ファイルを生成する

note: type: textblock
en: B<dh_md5sums> [S<I<debhelper options>>] [B<-x>] [B<-X>I<item>] [B<--include-conffiles>]
ja: B<dh_md5sums> [S<I<debhelper オプション>>] [B<-x>] [B<-X>I<item>] [B<--include-conffiles>]

note: type: textblock
en: B<dh_md5sums> is a debhelper program that is responsible for generating a F<DEBIAN/md5sums> file, which lists the md5sums of each file in the package.  These files are used by B<dpkg --verify> or the L<debsums(1)> program.
ja: B<dh_md5sums> は F<DEBIAN/md5sums> ファイルを生成する役目のプログラムです。なお、F<DEBIAN/md5sums> ファイルとはビルド対象のパッケージにあるファイルの md5sum 値を列挙したものです。これらファイルは B<dpkg --verify> または B<debsums> プログラムで利用されます。

note: type: textblock
en: All files in F<DEBIAN/> are omitted from the F<md5sums> file, as are all conffiles (unless you use the B<--include-conffiles> switch).
ja: F<DEBIAN/> 以下にある全ファイルは生成される F<md5sums> ファイルからは除外されます。また同様に全ての conffile も除外されます (B<--include-conffiles> を指定した場合は別です) 。

note: type: textblock
en: The md5sums file is installed with proper permissions and ownerships.
ja: md5sums ファイルは適切なパーミッションと所有者でインストールされます。

note: type: textblock
en: Exclude files that contain I<item> anywhere in their filename from being listed in the md5sums file.
ja: md5sums ファイルに列挙されているファイル群から、I<item> をファイル名に持つファイルを除外します。

note: type: textblock
en: dh_movefiles - move files out of debian/tmp into subpackages
ja: dh_movefiles - debian/tmp からサブパッケージへファイルを移動する

note: type: textblock
en: B<dh_movefiles> [S<I<debhelper options>>] [B<--sourcedir=>I<dir>] [B<-X>I<item>] [S<I<file> ...>]
ja: B<dh_movefiles> [S<I<debhelper オプション>>] [B<--sourcedir=>I<ディレクトリ>] [B<-X>I<item>] [S<I<ファイル> ...>]

note: type: textblock
en: B<dh_movefiles> is a debhelper program that is responsible for moving files out of F<debian/tmp> or some other directory and into other package build directories. This may be useful if your package has a F<Makefile> that installs everything into F<debian/tmp>, and you need to break that up into subpackages.
ja: B<dh_movefiles> は、F<debian/tmp> ディレクトリや他のディレクトリから、別のパッケージビルドディレクトリへファイルを移動する役割を持つ debhelper プログラムです。これはパッケージしようとするソフトウェアに含まれる F<Makefile>フ ァイルにより、インストールすべき物が F<debian/tmp> へインストールされてしまうような場合に、これらを別々のディレクトリに後から仕分けたいような場合に便利です。

note: type: textblock
en: Note: B<dh_install> is a much better program, and you are recommended to use it instead of B<dh_movefiles>.
ja: 注意：B<dh_install> は B<dh_movefiles> よりもはるかに良いプログラムなので、B<dh_install> を利用することを推奨します。

note: type: textblock
en: Lists the files to be moved into a package, separated by whitespace. The filenames listed should be relative to F<debian/tmp/>. You can also list directory names, and the whole directory will be moved.
ja: とあるパッケージへ移動したいファイルを、空白区切りで列挙します。ファイル名は必ず F<debian/tmp/> からの相対パスで指定しなければなりません。また、ディレクトリ名を指定することもでき、その場合は、ディレクトリをそのまま移動します。

note: type: textblock
en: Instead of moving files out of F<debian/tmp> (the default), this option makes it move files out of some other directory. Since the entire contents of the sourcedir is moved, specifying something like B<--sourcedir=/> is very unsafe, so to prevent mistakes, the sourcedir must be a relative filename; it cannot begin with a `B</>'.
ja: F<debian/tmp> (デフォルトの移動元) からファイルを移動する代わりに、別のディレクトリからファイルを移動するように指定します。なお、移動元ディレクトリにある全ファイルを移動する為、B<--sourcedir=/> のような指定は、非常に危険です。こういった間違いを防ぐ為、移動元ディレクトリは相対パスしか受け付けないようにしてあります。つまり、'B</>' で始まるディレクトリ指定は出来ません。

note: type: textblock
en: Exclude files that contain B<item> anywhere in their filename from being installed.
ja: B<item> をファイル名のどこかに含むファイルはインストール候補から除外します。

note: type: textblock
en: Lists files to move. The filenames listed should be relative to F<debian/tmp/>. You can also list directory names, and the whole directory will be moved. It is an error to list files here unless you use B<-p>, B<-i>, or B<-a> to tell B<dh_movefiles> which subpackage to put them in.
ja: 移動すべきファイルを列挙したファイルです。列挙されているファイルは F<debian/tmp/> からの相対パスである必要があります。ディレクトリ名を列挙することも出来、その場合は、各ディレクトリ全体を移動します。なお、B<-p>、B<-i>、B<-a> を使って B<dh_movefiles> にどのサブパッケージに移動すべきかを指定していない場合エラーが報告されます。

note: type: textblock
en: Note that files are always moved out of F<debian/tmp> by default (even if you have instructed debhelper to use a compatibility level higher than one, which does not otherwise use debian/tmp for anything at all). The idea behind this is that the package that is being built can be told to install into F<debian/tmp>, and then files can be moved by B<dh_movefiles> from that directory. Any files or directories that remain are ignored, and get deleted by B<dh_clean> later.
ja: デフォルト F<debian/tmp> からファイルを移動するという事になっています (もし debhelper が互換性レベル v1 以上で利用したとしても、debian/tmp 以外は利用されません)。この背景として、ビルドされたパッケージは F<debian/tmp> に一旦インストールし、後で B<dh_movefiles> コマンドにより F<debian/tmp> から移動するという考え方があります。なお移動されなかったファイルやディレクトリは無視され、後に B<dh_clean> によって消去されることとなります。

note: type: textblock
en: dh_perl - calculates Perl dependencies and cleans up after MakeMaker
ja: dh_perl - Perlへの依存関係を検討し、MakeMaker 実行後に生成したものを消去する

note: type: textblock
en: B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]
ja: B<dh_perl> [S<I<debhelper オプション>>] [B<-d>] [S<I<ライブラリディレクトリ> ...>]

note: type: textblock
en: B<dh_perl> is a debhelper program that is responsible for generating the B<${perl:Depends}> substitutions and adding them to substvars files.
ja: B<dh_perl> は B<${perl:Depends}> の内容を生成し、この依存情報に substvars ファイルの情報を付け加える役目の debhelper プログラムです。

note: type: textblock
en: The program will look at Perl scripts and modules in your package, and will use this information to generate a dependency on B<perl> or B<perlapi>. The dependency will be substituted into your package's F<control> file wherever you place the token B<${perl:Depends}>.
ja: このプログラムはビルド対象のパッケージにある Perl スクリプトや Perl モジュールを検査し、B<perl> や B<perlapi> の依存関係を生成します。B<${perl:Depends}> 句をビルド対象のパッケージの F<control> に記述すると、生成した依存関係の情報に置き換えられます。

note: type: textblock
en: B<dh_perl> also cleans up empty directories that MakeMaker can generate when installing Perl modules.
ja: B<dh_perl> は、さらに、MakeMaker が Perl モジュールをインストールする際に生成した空のディレクトリを削除します。

note: type: textblock
en: In some specific cases you may want to depend on B<perl-base> rather than the full B<perl> package. If so, you can pass the -d option to make B<dh_perl> generate a dependency on the correct base package. This is only necessary for some packages that are included in the base system.
ja: 完全な B<perl> パッケージよりも B<perl-base> に依存したいような場合があります。この場合、-d オプションにて B<dh_perl> に正しいベースパッケージに対しての依存情報を生成させるようなオプションを渡す箏ができます。これはベースシステムが含まれるようなパッケージのみで必要です。

note: type: textblock
en: Note that this flag may cause no dependency on B<perl-base> to be generated at all. B<perl-base> is Essential, so its dependency can be left out, unless a versioned dependency is needed.
ja: なお、このフラグを指定しても、B<perl-base> 本体に関する依存情報は、全く生成されません。というのも、B<perl-base> は非常に基礎的なパッケージなので、B<perl-base> に関する依存関係は通常特に指定しなくても問題が無い為です。ただ、B<perl-base> の特定のバージョンに依存が特に必要な場合はその限りではありません。

note: type: textblock
en: By default, scripts and architecture independent modules don't depend on any specific version of B<perl>. The B<-V> option causes the current version of the B<perl> (or B<perl-base> with B<-d>) package to be specified.
ja: デフォルト、スクリプト本体とアーキテクチャから独立しているモジュールについては、特定のバージョンの B<perl> に依存するような依存情報は生成されません。B<-V>オプションを指定すると、パッケージビルド中に使っているバージョンの B<perl> パッケージ (あるいは、B<-d> を指定していれば、現在の B<perl-base> のバージョン) を、パッケージの依存情報として設定します。

note: type: textblock
en: If your package installs Perl modules in non-standard directories, you can make B<dh_perl> check those directories by passing their names on the command line. It will only check the F<vendorlib> and F<vendorarch> directories by default.
ja: Perlモジュールを非標準のディレクトリにインストールするようなパッケージをビルドしているのであれば、コマンドラインからパッケージの名前を渡すことにより、B<dh_perl> に、これらのディレクトリを確認させる事が出来ます。デフォルトではこのコマンドは F<vendorlib> と F<vendorarch> ディレクトリのみを確認します。

note: type: textblock
en: Debian policy, version 3.8.3
ja: Debian ポリシー バージョン 3.8.3

note: type: textblock
en: Perl policy, version 1.20
ja: Perl ポリシー バージョン 1.20

note: type: textblock
en: dh_prep - perform cleanups in preparation for building a binary package
ja: dh_prep - バイナリパッケージビルドの事前準備として諸々の消去を行う

note: type: textblock
en: B<dh_prep> [S<I<debhelper options>>] [B<-X>I<item>]
ja: B<dh_prep> [S<I<debhelper オプション>>] [B<-X>I<item>]

note: type: textblock
en: B<dh_prep> is a debhelper program that performs some file cleanups in preparation for building a binary package. (This is what B<dh_clean -k> used to do.) It removes the package build directories, F<debian/tmp>, and some temp files that are generated when building a binary package.
ja: B<dh_prep> はバイナリパッケージビルドの下準備時として諸々のファイル消去を行う debhelper プログラムです (これは B<dh_clean -k> が昔行っていた作業となります)。本プログラムはパッケージビルドディレクトリ、F<debian/tmp>、あるいは、パッケージビルド中に生成した一時ファイルを取り除きます。

note: type: textblock
en: It is typically run at the top of the B<binary-arch> and B<binary-indep> targets, or at the top of a target such as install that they depend on.
ja: 本プログラムは通常、B<binary-arch> や、B<binary-indep> ターゲット、あるいは、これらが依存するインストール関連のターゲットの一番最初の作業にて実行されるようにします。

note: type: textblock
en: dh_shlibdeps - calculate shared library dependencies
ja: dh_shlibdeps - 共有ライブラリの依存関係を計算する

note: type: textblock
en: B<dh_shlibdeps> [S<I<debhelper options>>] [B<-L>I<package>] [B<-l>I<directory>] [B<-X>I<item>] [S<B<--> I<params>>]
ja: B<dh_shlibdeps> [S<I<debhelper オプション>>] [B<-L>I<パッケージ>] [B<-l>I<ディレクトリ>] [B<-X>I<item>] [S<B<--> I<パラメータ>>]

note: type: textblock
en: B<dh_shlibdeps> is a debhelper program that is responsible for calculating shared library dependencies for packages.
ja: B<dh_shlibdeps> は、ビルド中のパッケージに含まれる共有ライブラリの依存関係を計算する役目の debhelper プログラムです。

note: type: textblock
en: This program is merely a wrapper around L<dpkg-shlibdeps(1)> that calls it once for each package listed in the F<control> file, passing it a list of ELF executables and shared libraries it has found.
ja: このプログラムは L<dpkg-shlibdeps(1)> の単なるラッパープログラムであり、L<dpkg-shlibdeps(1)> を F<control> ファイルに列挙したパッケージ各々について１度呼び出すような動作をします。また、同時に L<dpkg-shlibdeps(1)> へ、動作中見つけた ELF 実行ファイルや、共有ライブラリの一覧を引き渡します。

note: type: textblock
en: Exclude files that contain F<item> anywhere in their filename from being passed to B<dpkg-shlibdeps>. This will make their dependencies be ignored.  This may be useful in some situations, but use it with caution. This option may be used more than once to exclude more than one thing.
ja: F<item> を名前に含むファイルを、B<dpkg-shlibdeps> へ渡さないようにします。このオプションにより、指定されたファイルの依存関係検査は無視されるようになります。これは特定の状況下で便利な場合がありますが、気をつけて使って下さい。このオプションを使って除外を複数指定する場合は、繰り返し指定する事により行います。

note: type: textblock
en: Pass I<params> to L<dpkg-shlibdeps(1)>.
ja: I<params> を L<dpkg-shlibdeps(1)> へ渡します。

note: type: textblock
en: This is another way to pass I<params> to L<dpkg-shlibdeps(1)>.  It is deprecated; use B<--> instead.
ja: このオプションは I<params> を L<dpkg-shlibdeps(1)> へ渡す別の方法となります。しかしながら、このオプションは廃止されました。代わりに B<--> を利用してください。

note: type: textblock
en: With recent versions of B<dpkg-shlibdeps>, this option is generally not needed.
ja: 最近のバージョンの B<dpkg-shlibdeps> では、このオプションは概ね不要になっています。

note: type: textblock
en: It tells B<dpkg-shlibdeps> (via its B<-S> parameter) to look first in the package build directory for the specified package, when searching for libraries, symbol files, and shlibs files.
ja: ライブラリ、シンボルファイル、shlibs ファイルを探索する際に、B<dpkg-shlibdeps> へ (B<-S> パラメータを使い) パッケージのパッケージビルドディレクトリ内にて、最初に探す場所を指定するものです。

note: type: textblock
en: Suppose that your source package produces libfoo1, libfoo-dev, and libfoo-bin binary packages. libfoo-bin links against libfoo1, and should depend on it. In your rules file, first run B<dh_makeshlibs>, then B<dh_shlibdeps>:
ja: ここで、ビルド中のパッケージが libfoo1、libfoo-dev、libfoo-bin のバイナリパッケージを生成すると仮定します。libfoo-bin は libfoo1 にリンクしており、つまりは依存関係になければならない状態です。この場合、パッケージの rules ファイルとして、最初に B<dh_makeshlibs> を呼び出し、次に B<dh_shlibdeps> を呼び出す記述をしなければなりません:

note: type: textblock
en: This will have the effect of generating automatically a shlibs file for libfoo1, and using that file and the libfoo1 library in the F<debian/libfoo1/usr/lib> directory to calculate shared library dependency information.
ja: こちらの記述を行うと、共有ライブラリの依存関係を検討する為に、libfoo1 に関する shlibs ファイルを自動的に生成し、生成された shlibs ファイル及び F<debian/libfoo1/usr/lib> 以下の libfoo1 ライブラリを使うようになります。

note: type: textblock
en: If a libbar1 package is also produced, that is an alternate build of libfoo, and is installed into F</usr/lib/bar/>, you can make libfoo-bin depend on libbar1 as follows:
ja: libbar1 パッケージを libfoo とは別にビルドし、F</usr/lib/bar/> へインストールしてあるとします。この場合、libfoo-bin について libbar1 を以下のようにして依存させる事ができます。

note: type: textblock
en: dh_strip - strip executables, shared libraries, and some static libraries
ja: dh_strip - 実行ファイル、共有ファイル、静的ライブラリのデバッグ情報を削る

note: type: textblock
en: B<dh_strip> [S<I<debhelper options>>] [B<-X>I<item>] [B<--dbg-package=>I<package>] [B<--keep-debug>]
ja: B<dh_strip> [S<I<debhelper オプション>>] [B<-X>I<item>] [B<--dbg-package=>I<パッケージ>] [B<--keep-debug>]

note: type: textblock
en: This program examines your package build directories and works out what to strip on its own. It uses L<file(1)> and file permissions and filenames to figure out what files are shared libraries (F<*.so>), executable binaries, and static (F<lib*.a>) and debugging libraries (F<lib*_g.a>, F<debug/*.so>), and strips each as much as is possible. (Which is not at all for debugging libraries.) In general it seems to make very good guesses, and will do the right thing in almost all cases.
ja: 本プログラムはパッケージビルドディレクトリ以下を探索し、どのファイルからデバッグ情報を取り除くべきかを見つけ出します。本プログラムは、L<file(1)> コマンドを利用し、ファイルパーミッション、ファイル名を利用して、どのファイルが共有ライブラリ (F<*.so>)、実行可能バイナリ、静的ライブラリ (F<lib*.a>)、デバッグ用ライブラリ (F<lib*_g.a>, F<debug/*.so>) であるかを判断し、該当する場合は、デバッグシンボルをできる限り取り除きます (デバッグ用ライブラリについては全く何もしません)。多くの場合で、本プログラムは非常に良い推定を行い、正しくデバッグシンボルの除去を行います。

note: type: textblock
en: Since it is very hard to automatically guess if a file is a module, and hard to determine how to strip a module, B<dh_strip> does not currently deal with stripping binary modules such as F<.o> files.
ja: 自動的にファイルがモジュールであるかどうかを見分けるのは難しく、また、どうやってモジュールからデバッグ情報を除外すれば良いかを決定するのも難しい為、B<dh_strip> は、F<.o> を拡張子に持つファイルのようなバイナリモジュールからデバッグ情報の除去を行う事について、未だサポートしていません。

note: type: textblock
en: B<This option is a now special purpose option that you normally do not need>.  In most cases, there should be little reason to use this option for new source packages as debhelper automatically generates debug packages ("dbgsym packages").  B<If you have a manual --dbg-package> that you want to replace with an automatically generated debug symbol package, please see the B<--dbgsym-migration> option.
ja: B<このオプションは、現在特別な目的のためのオプションであり、通常必要ありません>。ほとんどの場合、新しいソースパッケージでは debhelper が自動的にデバッグパッケージ ("dbgsym パッケージ") を生成するので、このオプションを使う理由は少ないはずです。B<手動で作られた --dbg-package> を自動生成されたデバッグシンボルパッケージで置き換えたい場合は B<--dbgsym-migration> オプションを参照して下さい。

note: type: textblock
en: Causes B<dh_strip> to save debug symbols stripped from the packages it acts on as independent files in the package build directory of the specified debugging package.
ja: B<dh_strip> を使ってパッケージからデバッグシンボルを取き、指定のデバッグ用パッケージのパッケージビルドディレクトリ内に独立したファイルとしてデバッグシンボルを保存します。

note: type: textblock
en: For example, if your packages are libfoo and foo and you want to include a I<foo-dbg> package with debugging symbols, use B<dh_strip --dbg-package=>I<foo-dbg>.
ja: 例えば、ビルド予定のパッケージとして、libfoo、foo があり、I<foo-dbg> パッケージにはデバッグシンボルを含めておきたい場合、B<dh_strip--dbg-package=>I<foo-dbg> を実行してください。

note: type: textblock
en: Debug symbols will be retained, but split into an independent file in F<usr/lib/debug/> in the package build directory. B<--dbg-package> is easier to use than this option, but this option is more flexible.
ja: デバッグシンボルが取り除かれる一方、パッケージビルドディレクトリ以下にある F<usr/lib/debug/> ディレクトリへ取り除いたデバッグシンボルを取り置きます。B<--dbg-package> オプションの方が本オプションよりも使うのは易しいのですが、本オプションは B<--dbg-package> オプションよりも柔軟な指定が可能です。

note: type: textblock
en: This option is used to migrate from a manual "-dbg" package (created with B<--dbg-package>) to an automatic generated debug symbol package. This option should describe a valid B<Replaces>- and B<Breaks>-relation, which will be added to the debug symbol package to avoid file conflicts with the (now obsolete) -dbg package.
ja: このオプションは、手動 (B<--dbg-package>) で作成した "-dbg" パッケージから自動生成されたデバッグシンボルパッケージへ移行するのに利用されます。このオプションでは、(現在では廃止となっている) -dbg パッケージとファイルが衝突するのを避けるためにデバッグシンボルパッケージに追加される正しい B<Replaces> 及び B<Breaks> の依存関係を記述する筈です。

note: type: textblock
en: Examples:
ja: 例:

note: type: textblock
en: Control whether B<dh_strip> should be creating debug symbol packages when possible.
ja: 可能な際に B<dh_strip> がデバッグシンボルパッケージを作るかどうかをコントロールします。

note: type: textblock
en: The default is to create debug symbol packages.
ja: デフォルトはデバッグシンボルパッケージを作成します。

note: type: textblock
en: Historical name for B<--automatic-dbgsym> and B<--no-automatic-dbgsym>.
ja: B<--automatic-dbgsym> と B<--no-automatic-dbgsym> の歴史的な名前です。

note: type: textblock
en: Historical name for B<--dbgsym-migration>.
ja: B<--dbgsym-migration> の歴史的な名前です。

note: type: textblock
en: Debian policy, version 3.0.1
ja: Debian ポリシー バージョン 3.0.1

note: type: textblock
en: dh_testdir - test directory before building Debian package
ja: dh_testdir - Debian パッケージをビルドする前にディレクトリの状態を検証する

note: type: textblock
en: B<dh_testdir> [S<I<debhelper options>>] [S<I<file> ...>]
ja: B<dh_testdir> [S<I<debhelper オプション>>] [S<I<ファイル> ...>]

note: type: textblock
en: B<dh_testdir> tries to make sure that you are in the correct directory when building a Debian package. It makes sure that the file F<debian/control> exists, as well as any other files you specify. If not, it exits with an error.
ja: B<dh_testdir> コマンドは、Debian パッケージをビルドする際に、カレントディレクトリが正しいディレクトリにあるかどうかを確認しようとします。また、同様に F<debian/control> ファイルや、指定されている他のファイルがきちんと存在するかどうかも確かめます。もし、そうでない場合、戻り値にエラー値を指定して処理を終わります。

note: type: textblock
en: Test for the existence of these files too.
ja: これらのファイルの存在もあわせて確認します。

note: type: textblock
en: B<dh_testroot> [S<I<debhelper options>>]
ja: B<dh_testroot> [S<I<debhelper オプション>>]

note: type: textblock
en: dh_usrlocal - migrate usr/local directories to maintainer scripts
ja: dh_usrlocal - usr/local ディレクトリをメンテナスクリプトへ移行する

note: type: textblock
en: B<dh_usrlocal> [S<I<debhelper options>>] [B<-n>]
ja: B<dh_usrlocal> [S<I<debhelper オプション>>] [B<-n>]

note: type: textblock
en: B<dh_usrlocal> is a debhelper program that can be used for building packages that will provide a subdirectory in F</usr/local> when installed.
ja: B<dh_usrlocal> コマンドはインストールの際に F</usr/local> 以下にサブディレクトリを作成するパッケージをビルドする時に使える debhelper プログラムです。

note: type: textblock
en: It finds subdirectories of F<usr/local> in the package build directory, and removes them, replacing them with maintainer script snippets (unless B<-n> is used) to create the directories at install time, and remove them when the package is removed, in a manner compliant with Debian policy. These snippets are inserted into the maintainer scripts by B<dh_installdeb>. See L<dh_installdeb(1)> for an explanation of debhelper maintainer script snippets.
ja: このコマンドは、パッケージビルドディレクトリにある F<usr/local> 以下のサブディレクトリを走査・削除し、Debian policy の内容に沿った形でインストール時に作成されたディレクトリを作成、及びパッケージ削除時に削除を実施するため、(B<-n> が使われてない限り) メンテナスクリプトのスニペットで置換します。これらのスニペットは B<dh_installdeb> により、メンテナスクリプトへ挿入されます。debhelper のメンテナスクリプトのスニペットに関する説明については、L<dh_installdeb(1)> を参照して下さい。

note: type: textblock
en: Debian policy, version 2.2
ja: Debian ポリシー バージョン 2.2

note: type: textblock
en: dh_systemd_enable - enable/disable systemd unit files
ja: dh_systemd_enable - systemd unit ファイルを有効／無効にする

note: type: textblock
en: B<dh_systemd_enable> [S<I<debhelper options>>] [B<--no-enable>] [B<--name=>I<name>] [S<I<unit file> ...>]
ja: B<dh_systemd_enable> [S<I<debhelper オプション>>] [B<--no-enable>] [B<--name=>I<name>] [S<I<unit ファイル> ...>]

note: type: textblock
en: B<dh_systemd_enable> is a debhelper program that is responsible for enabling and disabling systemd unit files.
ja: B<dh_systemd_enable> は systemd ユニットファイルの有効化・無効化を担当する debhelper プログラムです。

note: type: textblock
en: Note that this command is not idempotent. L<dh_prep(1)> should be called between invocations of this command (with the same arguments). Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.
ja: このコマンドには冪等性がありません。このコマンドを複数回呼び出す際には必ず間に L<dh_prep(1)> を (同じ引数を付けて) 挿入してください。さもないと、メンテナスクリプト中に同じ内容のコードを繰り返し挿入してしまいます。

note: type: textblock
en: dh_systemd_start - start/stop/restart systemd unit files
ja: dh_systemd_start - systemd ユニットファイルを start/stop/restart する

note: type: textblock
en: B<dh_systemd_start> [S<I<debhelper options>>] [B<--restart-after-upgrade>] [B<--no-stop-on-upgrade>] [S<I<unit file> ...>]
ja: B<dh_systemd_start> [S<I<debhelper オプション>>] [B<--restart-after-upgrade>] [B<--no-stop-on-upgrade>]  [S<I<unit ファイル> ...>]

note: type: textblock
en: Do not stop service on upgrade.
ja: サービスをアップグレード中に停止させません。

note: type: textblock
en: This compatibility level is open for beta testing; changes may occur.
ja: この互換性レベルはベータテスト中です。変更が加わります。
