dpkg-man 1.17.0 - en to ja translation catalogue (716 entries)

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

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

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

note: type: textblock
en: The name of the distribution this package is originating from.
ja: パッケージの起源となったディストリビューション名。

note: type: =head1
en: SEE ALSO
ja: 関連項目

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

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

note: type: =item
en: B<Maintainer:> I<fullname-email> (required)
ja: B<Maintainer:> I<fullname-email> (必須)

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

note: type: =head1
en: EXAMPLE
ja: 例

note: type: textblock
en: The value of this field determines the package name, and is used to generate file names by most installation tools.
ja: このフィールドの値によってパッケージ名が決まる。またインストールを行うツールの大半によって、ファイル名を生成するために使用される。

note: type: =item
en: S< >I<long-description>
ja: S< >I<長い説明>

note: type: =item
en: B<Section:> I<section>
ja: B<Section:> I<セクション>

note: type: =item
en: B<Origin:> I<name>
ja: B<Origin:> I<ディストリビューション名>

note: type: textblock
en: The I<url> of the bug tracking system for this package.  The current used format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>.
ja: パッケージのバグトラッキングシステムの I<url>。現在使われている形式は、B<debbugs://bugs.debian.org> のような I<bts-type>B<://>I<bts_address> 形式である。

note: type: textblock
en: The upstream project home page I<url>.
ja: アップストリームのプロジェクトのホームページ I<url>。

note: type: =item
en: B<Tag:> I<tag-list>
ja: B<Tag:> I<タグのリスト>

note: type: textblock
en: List of tags describing the qualities of the package.  The description and list of supported tags can be found in the B<debtags> package.
ja: パッケージの品質を示すタグのリスト。サポートされているタグの一覧と説明は、B<debtags> パッケージを参照のこと。

note: type: =item
en: B<Depends:> I<package-list>
ja: B<Depends:> I<パッケージのリスト>

note: type: =item
en: B<Pre-Depends:> I<package-list>
ja: B<Pre-Depends:> I<パッケージのリスト>

note: type: textblock
en: List of packages that must be installed B<and> configured before this one can be installed.  This is usually used in the case where this package requires another package for running its preinst script.
ja: パッケージのインストール前にインストールされ、B<かつ>設定済でなければならないパッケージのリスト。このフィールドは、通常あるパッケージが他のパッケージをpreinst スクリプトで必要とする際に用いられる。

note: type: =item
en: B<Recommends:> I<package-list>
ja: B<Recommends:> I<パッケージのリスト>

note: type: textblock
en: Lists packages that would be found together with this one in all but unusual installations.  The package maintenance software will warn the user if they install a package without those listed in its B<Recommends> field.
ja: 例外的な場合を除き、このパッケージと共にインストールした方がよいパッケージのリスト。B<Recommends> フィールドに列挙されているパッケージ抜きでパッケージをインストールしようとすると、パッケージ管理ソフトウェアは警告を発する。

note: type: =item
en: B<Suggests:> I<package-list>
ja: B<Suggests:> I<パッケージのリスト>

note: type: textblock
en: Lists packages that are related to this one and can perhaps enhance its usefulness, but without which installing this package is perfectly reasonable.
ja: このパッケージと関係があり、利便性を向上させることができるが、インストールしなくても構わないパッケージのリスト。

note: type: =item
en: B<Breaks:> I<package-list>
ja: B<Breaks:> I<パッケージのリスト>

note: type: textblock
en: Lists packages that this one breaks, for example by exposing bugs when the named packages rely on this one.  The package maintenance software will not allow broken packages to be configured; generally the resolution is to upgrade the packages named in a B<Breaks> field.
ja: パッケージが依存している機能のバグを顕在化させてしまうなどで、パッケージを機能不全に陥れてしまうパッケージのリスト。パッケージ管理ソフトウェアは、こうしたパッケージを設定できないようにしている。一般的には、B<Breaks> フィールドに設定されているパッケージのアップグレードが解決策となる。

note: type: =item
en: B<Conflicts:> I<package-list>
ja: B<Conflicts:> I<パッケージのリスト>

note: type: textblock
en: Lists packages that conflict with this one, for example by containing files with the same names.  The package maintenance software will not allow conflicting packages to be installed at the same time.  Two conflicting packages should each include a B<Conflicts> line mentioning the other.
ja: 同じ名前のファイルが存在しているなどで、このパッケージと競合するパッケージのリスト。パッケージ管理ソフトウェアは、競合しているパッケージを同時にインストールできないようにしている。競合しているパッケージ同士は、互いに相手を B<Conflicts> 行に設定しておくべきである。

note: type: =item
en: B<Replaces:> I<package-list>
ja: B<Replaces:> I<パッケージのリスト>

note: type: textblock
en: List of packages files from which this one replaces.  This is used for allowing this package to overwrite the files of another package and is usually used with the B<Conflicts> field to force removal of the other package, if this one also has the same files as the conflicted package.
ja: このパッケージによって置き換えられるファイルを含むパッケージのリスト。このパッケージと競合するパッケージに同じ名前のファイルが含まれている際に、他のパッケージのファイルを上書きできるようにするために用いられる。通常、他のパッケージを強制的に削除するため B<Conflicts> フィールドも併せて設定される。

note: type: =item
en: B<Enhances:> I<package-list>
ja: B<Enhances:> I<パッケージのリスト>

note: type: =item
en: B<Provides:> I<package-list>
ja: B<Provides:> I<パッケージのリスト>

note: type: =item
en: B<Built-Using:> I<package-list>
ja: B<Built-Using:> I<パッケージのリスト>

note: type: textblock
en: deb-extra-override - Debian archive extra override file
ja: deb-extra-override - Debian アーカイブ拡張 override ファイル

note: type: textblock
en: While most information about a binary/source package can be found in the control/.dsc file, all of it can be overridden when it's exported to Packages/Sources files.  The extra override file contains those overrides.
ja: binary/source パッケージの大半の情報は control/.dsc ファイルにあるが、これらは Packages/Sources ファイルを作成する段階ですべて上書きすることができる。そうした情報が拡張 override ファイルに格納される。

note: type: textblock
en: The extra override file has a simple whitespace-delimited format.  Comments are allowed (denoted with a B<#>).
ja: 拡張 override ファイルは、空白文字をディリミタとした簡単な形式になっている。コメントも可能である (B<#> 以降がコメント)。

note: type: textblock
en: I<package> is the name of the binary/source package.
ja: I<package> は binary/source パッケージ名である。

note: type: textblock
en: The extra override files used to make the official Packages lists may be found in the I<indices> directory on any Debian mirror.
ja: 公式の Packages 一覧を作成するために使われている拡張 override ファイルは、 Debian ミラーの I<indices> ディレクトリにある。

note: type: textblock
en: deb-old - old style Debian binary package format
ja: deb-old - 旧 Debian バイナリパッケージ形式

note: type: =head1
en: FORMAT
ja: フォーマット

note: type: textblock
en: The file is two lines of format information as ASCII text, followed by two concatenated gzipped ustar files.
ja: ファイルには 2 行の ASCII テキストによる形式情報があり、それに 2 つの gzip 圧縮された ustar ファイルが続く。

note: type: textblock
en: The first line is the format version number padded to 8 digits, and is B<0.939000> for all old-format archives.
ja: 1 行目は 8 桁にそろえた形式のバージョン番号であり、旧形式のアーカイブはすべて B<0.939000> である。

note: type: textblock
en: The second line is a decimal string (without leading zeroes) giving the length of the first gzipped tarfile.
ja: 2 行目はひとつ目の gzip 圧縮 tar ファイルの大きさを意味する (0 から始まらない) 十進数の数値文字列である。

note: type: textblock
en: Each of these lines is terminated with a single newline character.
ja: それぞれの行の終わりには改行文字がひとつ置かれる。

note: type: textblock
en: The first tarfile contains the control information, as a series of ordinary files.  The file B<control> must be present, as it contains the core control information.
ja: 1 番目の tar ファイルは、制御情報を含む幾つかの平文ファイルからなる。中核となる制御情報を含む B<control> ファイルは必須である。

note: type: textblock
en: The second gzipped tarfile is the filesystem archive, containing pathnames relative to the root directory of the system to be installed on.  The pathnames do not have leading slashes.
ja: 2 番目の gzip 圧縮 tar ファイルはインストールされるファイルのアーカイブであり、インストールされるシステムのルートディレクトリからの相対パス名が格納されている。パス名の先頭にスラッシュ(/)はない。

note: type: textblock
en: deb-origin - Vendor-specific information files
ja: deb-origin - ベンダ固有情報ファイル

note: type: textblock
en: The value of this field determines the vendor name.
ja: このフィールドの値によってベンダ名が決まる。

note: type: textblock
en: The value of this field determines the vendor URL.
ja: このフィールドの値によってベンダの URL が決まる。

note: type: textblock
en: The value of this field determines the type and address of the bug tracking system used by this vendor.  It can be a mailto URL or a debbugs URL (e.g., debbugs://bugs.debian.org/).
ja: このフィールドの値によって、このベンダが使用しているバグトラッキングシステムの種類やアドレスが決まる。これは、mailto URL や debbugs URL (例えば debbugs://bugs.debian.org/ など) といった値をとる。

note: type: textblock
en: The value of this field determines the vendor name of the vendor that this vendor derives from.
ja: このフィールドの値によって、このベンダの由来となるベンダ名が決まる。

note: type: textblock
en: deb-override - Debian archive override file
ja: deb-override - Debian アーカイブ override ファイル

note: type: textblock
en: While most information about a package can be found in the control file, some is managed centrally by the distribution czars rather than by the maintainer in order to offer some global consistency.  This information is found in the override file.
ja: パッケージに関する大半の情報は control ファイルにあるが、システム全体の整合性を保つために、メンテナではなく、ディストリビューション側の管理者によって一元管理されている情報もある。そうした情報が override ファイルに存在する。

note: type: textblock
en: The override file has a simple whitespace-delimited format.  Comments are allowed (denoted with a B<#>).
ja: override ファイルは、空白文字を区切り文字とした簡単な形式になっている。コメントも可能である (B<#> 以降がコメント)。

note: type: textblock
en: I<package> is the name of the package.  Entries in the override file for packages not found in the tree of binary packages are ignored.
ja: I<package> はパッケージ名である。override ファイルにあるがバイナリパッケージのツリーにはないパッケージ名のエントリは無視される。

note: type: textblock
en: The override files used to make the official Packages lists may be found in the I<indices> directory on any Debian mirror.
ja: 公式の Packages 一覧を作成するために使われている override ファイルが、 Debian ミラーの I<indices> ディレクトリに存在する。

note: type: textblock
en: deb-shlibs - Debian shared library information file
ja: deb-shlibs - Debian 共有ライブラリ情報ファイル

note: type: textblock
en: The I<library> and I<version> fields are whitespace-delimited, but the I<dependencies> field extends to the end of the line.  The I<type> field is optional and normally not needed.
ja: I<library> と I<version> フィールドは空白文字で区切られるが、I<dependencies> フィールドは行末までの範囲がすべて含まれる。I<type> フィールドはオプションで、通常不要である。

note: type: textblock
en: deb-split - Debian multi-part binary package format
ja: deb-split - Debian マルチパートのバイナリパッケージ形式

note: type: textblock
en: The multi-part B<.deb> format is used to split big packages into smaller pieces to ease transport in small media.
ja: マルチパート B<.deb> 形式は、巨大なパッケージを小さく分割することで、小容量メディアでの転送を容易にするために用いられる。

note: type: textblock
en: The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  The file names might contain a trailing slash (since dpkg 1.15.6).
ja: このファイルはマジックナンバー B<!E<lt>archE<gt>> を持つ B<ar> アーカイブである。ファイル名はスラッシュで終わる場合がある (dpkg 1.15.6 以降)。

note: type: textblock
en: The first member is named B<debian-split> and contains a series of lines, separated by newlines.  Currently eight lines are present:
ja: アーカイブ先頭のファイルは B<debian-split> である。このファイルは、改行で区切られた数行からなる。現在のところ 8 行が存在する:

note: type: textblock
en: The format version number, B<2.1> at the time this manual page was written.
ja: 本マニュアルページが書かれた時点での形式のバージョン番号は、B<2.1> である。

note: type: textblock
en: The package name.
ja: パッケージ名

note: type: textblock
en: The package version.
ja: パッケージのバージョン

note: type: textblock
en: The md5sum of the package.
ja: パッケージの md5sum

note: type: textblock
en: The total size of the package.
ja: パッケージ全体のサイズ

note: type: textblock
en: The maximum part size.
ja: 単一パートの最大サイズ

note: type: textblock
en: The current part number, followed by a slash and the total amount of parts (as in ‘1/10’).
ja: 現在のパート番号。スラッシュに続いてパートの総数を記載する形態 (‘1/10’) で表記される。

note: type: textblock
en: The package architecture (since dpkg 1.16.1).
ja: パッケージのアーキテクチャ (dpkg 1.16.1 以降)

note: type: textblock
en: Programs which read multi-part archives should be prepared for the minor format version number to be increased and additional lines to be present, and should ignore these if this is the case.
ja: マルチパート形式のアーカイブを読み込むプログラムは、マイナーバージョン番号の増加や、新しい行の追加に対応すべきである。その際には、これらを無視すること。

note: type: textblock
en: If the major format version number has changed, an incompatible change has been made and the program should stop.  If it has not, then the program should be able to safely continue, unless it encounters an unexpected member in the archive (except at the end), as described below.
ja: メジャーバージョン番号が変更されている場合は、互換性のない変更がされているとみなし、プログラムは停止すべきである。メジャーバージョンが変更されていない場合は、以下で説明するように、アーカイブに予期しないファイルが含まれていない限り(アーカイブ末尾に含まれる場合を除く)、プログラムは安全に実行を継続できる必要がある。

note: type: textblock
en: The second, last required member is named B<data.>I<N>, where I<N> denotes the part number.  It contains the raw part data.
ja: 2 番目となる最後の必須ファイルは B<data.>I<N> である。I<N> はパート番号を示す。これにはパートのデータそのものが格納されている。

note: type: textblock
en: These members must occur in this exact order.  Current implementations should ignore any additional members after B<data.>I<N>.  Further members may be defined in the future, and (if possible) will be placed after these two.
ja: これらのファイルはこの通りの順序でアーカイブされていなければならない。現在の実装では B<data.>I<N> より後に追加されているファイルを無視すべきである。将来的に追加のファイルが定義された場合は、(やむを得ない場合を除き) これら 2 つのファイルの後にアーカイブされることになるだろう。

note: type: =head1
en: SOURCE FIELDS
ja: SOURCE フィールド

note: type: =item
en: B<Source:> I<source-package-name> (required)
ja: B<Source:> I<ソースパッケージ名> (必須)

note: type: =item
en: B<Standards-Version:> I<version-string>
ja: B<Standards-Version:> I<バージョン文字列>

note: type: textblock
en: The upstream project home page URL.
ja: アップストリームのプロジェクトのホームページ URL。

note: type: textblock
en: The I<url> of the bug tracking system for this package.  The current used format is I<bts-type>B<://>I<bts-address>, like B<debbugs://bugs.debian.org>.  This field is usually not needed.
ja: パッケージのバグトラッキングシステムの I<url>。現在使われている形式は、B<debbugs://bugs.debian.org> のような I<bts-type>B<://>I<bts_address> 形式である。このフィールドは一般的に必要とされない。

note: type: textblock
en: The I<url> of the Version Control System repository used to maintain this package.  Currently supported are B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg> (Mercurial), B<Mtn> (Monotone) and B<Svn> (Subversion).  Usually this field points to the latest version of the package, such as the main branch or the trunk.
ja: このパッケージの管理に用いられているバージョン管理システムのリポジトリ I<url>。現在サポートされているのは、B<Arch>, B<Bzr> (Bazaar), B<Cvs>, B<Darcs>, B<Git>, B<Hg>(Mercurial), B<Mtn> (Monotone), B<Svn> (Subversion) である。通常、このフィールドは、main ブランチや trunk といった最新版のパッケージを示している。

note: type: textblock
en: The name of the distribution this package is originating from.  This field is usually not needed.
ja: パッケージの起源となったディストリビューション名。このフィールドは、通常不要である。

note: type: =item
en: B<Build-Depends:> I<package-list>
ja: B<Build-Depends:> I<パッケージのリスト>

note: type: =item
en: B<Build-Depends-Indep:> I<package-list>
ja: B<Build-Depends-Indep:> I<パッケージのリスト>

note: type: textblock
en: Same as B<Build-Depends>, but they are only needed when building the architecture independent packages.  The B<Build-Depends> are also installed in this case.
ja: B<Build-Depends> と同様だが、アーキテクチャ非依存なパッケージをビルドする場合にのみ必要とされるもの。B<Build-Depends> もインストールされる。

note: type: textblock
en: A list of packages that should not be installed when the package is built, for example because they interfere with the build system used.  Including a dependency in this list has the same effect as including it in both B<Build-Conflicts-Arch> and B<Build-Conflicts-Indep>, with the additional effect of being used for source-only builds.
ja: ビルドシステムの動作に影響するなど、パッケージがビルドされる時にインストールされていることが好ましくないパッケージのリスト。このリストで定義した依存関係は、B<Build-Conflicts-Arch> と B<Build-Conflicts-Indep> の両方で行った定義と同じ効力を持つだけでなく、ソースのみのビルドにおいても効力を持つ。

note: type: =item
en: B<Build-Conflicts-Indep:> I<package-list>
ja: B<Build-Conflicts-Indep:> I<パッケージのリスト>

note: type: textblock
en: Same as B<Build-Conflicts>, but only when building the architecture independent packages.
ja: Build-Conflicts と同様だが、アーキテクチャ非依存なパッケージをビルドする場合にのみ影響するもの。

note: type: textblock
en: Note that dependencies on packages in the B<build-essential> set can be omitted and that declaring build conflicts against them is impossible.  A list of these packages is in the build-essential package.
ja: B<build-essential> に含まれるパッケージとの依存関係は省略できること、これらのパッケージと競合するようなビルド設定は禁止されている点に留意すること。該当するパッケージの一覧は、build-essential パッケージに含まれている。

note: type: =head1
en: BINARY FIELDS
ja: BINARY フィールド

note: type: =item
en: B<Package:> I<binary-package-name> (required)
ja: B<Package:> I<バイナリパッケージ名> (必須)

note: type: textblock
en: This field is used to name the binary package name.  The same restrictions as to a source package name apply.
ja: このフィールドはバイナリパッケージ名の指定に用いられる。ソースパッケージ名と同様の制約が適用される。

note: type: =item
en: B<Architecture:> I<arch>|B<all>|B<any> (required)
ja: B<Architecture:> I<arch>|B<all>|B<any> (必須)

note: type: =head1
en: USER-DEFINED FIELDS
ja: ユーザ定義フィールド

note: type: =head1
en: NOTES
ja: 参考

note: type: =head2
en: Using #PACKAGE# substitution
ja: #PACKAGE# 置換の使用

note: type: textblock
en: In some rare cases, the name of the library varies between architectures.  To avoid hardcoding the name of the package in the symbols file, you can use the marker I<#PACKAGE#>.  It will be replaced by the real package name during installation of the symbols files.  Contrary to the I<#MINVER#> marker, I<#PACKAGE#> will never appear in a symbols file inside a binary package.
ja: 稀ではあるが、アーキテクチャによってライブラリ名が異なる場合がある。シンボルファイルにパッケージ名をハードコードすることを避けるため、I<#PACKAGE#> マークを使用することができる。これはシンボルファイルのインストール時に実際のパッケージ名に置換される。I<#MINVER#> マークと異なり、I<#PACKAGE#> がバイナリパッケージ内のシンボルファイルに現れることは決してない。

note: type: =head2
en: Using symbol tags
ja: シンボルタグの使用

note: type: textblock
en: Tag specification comes right before the symbol name (no whitespace is allowed in between).  It always starts with an opening bracket B<(>, ends with a closing bracket B<)> and must contain at least one tag.  Multiple tags are separated by the B<|> character.  Each tag can optionally have a value which is separated form the tag name by the B<=> character.  Tag names and values can be arbitrary strings except they cannot contain any of the special B<)> B<|> B<=> characters.  Symbol names following a tag specification can optionally be quoted with either B<'> or B<"> characters to allow whitespaces in them.  However, if there are no tags specified for the symbol, quotes are treated as part of the symbol name which continues up until the first space.
ja: タグはシンボル名の前に設置され (空白文字を間にいれることはできない)、B<(> から始まりB<)> で終わり、間に最低 1 つのタグを記載する必要がある。複数のタグは B<|> 文字で区切る。各タグには、タグ名との間を B<=> 文字で区切った形式で値を設定することもできる。タグ名と値には、特別な文字 B<)> B<|> B<=> を除き、任意の文字を含めることができる。タグに続くシンボル名には、B<'> もしくは B<"> 文字でクオートすることで、空白文字を含めることができる。ただし、シンボルにタグが設定されていなかった場合、クオートはシンボル名の一部と見なされ、最初のスペースまでがシンボル名と認識される。

note: type: textblock
en: The first symbol in the example is named I<tagged quoted symbol> and has two tags: I<tag1> with value I<i am marked> and I<tag name with space> that has no value.  The second symbol named I<tagged_unquoted_symbol> is only tagged with the tag named I<optional>.  The last symbol is an example of the normal untagged symbol.
ja: 設定例の 1 番目のシンボルは I<tagged quoted symbol> という名前であり、I<i am marked> という値を持つ I<tag1> というタグと I<tag name with space> という値を持たないタグの 2 つが設定されている。2 番目のシンボルは I<tagged_unquoted_symbol> という名前で I<optional> という名前のタグが設定されている。最後のシンボルは一般的なタグのないシンボルの例である。

note: type: =head2
en: Standard symbol tags
ja: 標準シンボルタグ

note: type: textblock
en: This tag is useful for symbols which are private where their disappearance do not cause ABI breakage.  For example, most of C++ template instantiations fall into this category.  Like any other tag, this one may also have an arbitrary value: it could be used to indicate why the symbol is considered optional.
ja: このタグはシンボルの削除が ABI の互換性を損なわないようなプライベートなシンボルに有用である。例えば、C++ テンプレートのインスタンス化の多くがこれに分類される。その他のタグと同様、このタグには任意の値を設定することができる。これはシンボルが optional と見なされる理由を示すために使用することができる。

note: type: textblock
en: When operating in the default non-template mode, among arch-specific symbols only those that match the current host architecture are written to the symbols file.  On the contrary, all arch-specific symbols (including those from foreign arches) are always written to the symbol file when operating in template mode.
ja: デフォルトの非テンプレートモードで動作する際には、アーキテクチャ固有のシンボルの中で、現在のホストのアーキテクチャに合致するもののみがシンボルファイルに書き込まれる。一方、テンプレートモードで動作している場合は、アーキテクチャ固有のシンボルのすべて (異なるアーキテクチャのものも含む) がシンボルファイルに書き込まれる。

note: type: =head2
en: Using symbol patterns
ja: シンボルパターンの使用

note: type: textblock
en: Unlike a standard symbol specification, a pattern may cover multiple real symbols from the library.  B<dpkg-gensymbols> will attempt to match each pattern against each real symbol that does I<not> have a specific symbol counterpart defined in the symbol file.  Whenever the first matching pattern is found, all its tags and properties will be used as a basis specification of the symbol.  If none of the patterns matches, the symbol will be considered as new.
ja: 標準シンボルと異なり、パターンにはライブラリがエクスポートする複数の実シンボルが含まれうる。B<dpkg-gensymbols> は、シンボルファイルによって特定のシンボルと関連付けられてI<いない>各実シンボルについて、パターンとのマッチングを行う。最初にパターンにマッチした時点で、シンボルの基本的な機能として、パターンのタグおよび属性が用いられる。パターンにマッチしなかった場合、そのシンボルは新しいシンボルと見なされる。

note: type: textblock
en: At the moment, B<dpkg-gensymbols> supports three basic pattern types:
ja: 現在のところ、B<dpkg-gensymbols> は 3 つの基本的なパターンタイプをサポートしている:

note: type: textblock
en: The demangled name above can be obtained by executing the following command:
ja: 上記のデコードされた名前は、以下のコマンドを実行することで取得できる:

note: type: textblock
en: Please note that while mangled name is unique in the library by definition, this is not necessarily true for demangled names.  A couple of distinct real symbols may have the same demangled name.  For example, that's the case with non-virtual thunk symbols in complex inheritance configurations or with most constructors and destructors (since g++ typically generates two real symbols for them).  However, as these collisions happen on the ABI level, they should not degrade quality of the symbol file.
ja: エンコードされた名前がライブラリ内で一意に定義されていた場合であっても、デコードされた名前が一位である必要はない。幾つかの実シンボルのデコードされた名前が同じである場合もある。これは、例えば仮想継承でないサンクシンボルに複雑な継承の設定が行われている場合や、大半のコンストラクタとデストラクタについて言える (ただし、g++ は、これらに対して通常 2 つの実シンボルを生成する)。ただし、こうした衝突は ABI レベルで発生しているものであり、シンボルファイルの品質を低下させるものではない。

note: type: textblock
en: This pattern is denoted by the I<symver> tag.  Well maintained libraries have versioned symbols where each version corresponds to the upstream version where the symbol got added.  If that's the case, you can use a I<symver> pattern to match any symbol associated to the specific version.  For example:
ja: このパターンは、I<symver> タグを示す。きちんとメンテナンスされているライブラリでは、シンボルがバージョン管理されており、各バージョンがシンボルの追加されたアップストリームのバージョンに対応付けられている。この場合、I<symver> パターンを使用することで、特定のバージョンに対応付けられた任意のシンボルにマッチさせることが可能である。以下に例を示す:

note: type: textblock
en: All symbols associated with versions GLIBC_2.0 and GLIBC_2.7 will lead to minimal version of 2.0 and 2.7 respectively with the exception of the symbol access@GLIBC_2.0.  The latter will lead to a minimal dependency on libc6 version 2.2 despite being in the scope of the "(symver)GLIBC_2.0" pattern because specific symbols take precedence over patterns.
ja: GLIBC_2.0 および GLIBC_2.7 のバージョンに対応付けられたすべてのシンボルは、access@GLIBC_2.0 シンボルを除き、最低バージョンが各々 2.0 および 2.7 となる。後者は、"(symver)GLIBC_2.0" パターンにマッチするが、libc6 バージョン 2.2 が最低限の依存関係となる。これは、シンボルの指定がパターンによるマッチより優先されるためである。

note: type: textblock
en: Regular expression patterns are denoted by the I<regex> tag.  They match by the perl regular expression specified in the symbol name field.  A regular expression is matched as it is, therefore do not forget to start it with the I<^> character or it may match any part of the real symbol I<name@version> string.  For example:
ja: 正規表現パターンは I<regex> タグで指定される。これは、シンボル名フィールドで指定された perl 形式の正規表現にマッチする。正規表現であるため、I<^> 文字から始めることを忘れないこと、さもなくば、実シンボル I<name@version> の任意の部分にマッチする可能性がある。以下に例を示す:

note: type: textblock
en: will match symbols "_ZN3NSA6ClassA7Private11privmethod1Ei@Base" and "_ZN3NSA6ClassA7Private11privmethod2Ei@Base".  When matching the first pattern, the raw symbol is first demangled as C++ symbol, then the demangled name is matched against the regular expression.  On the other hand, when matching the second pattern, regular expression is matched against the raw symbol name, then the symbol is tested if it is C++ one by attempting to demangle it.  A failure of any basic pattern will result in the failure of the whole pattern.  Therefore, for example, "__N3NSA6ClassA7Private11privmethod\dEi@Base" will not match either of the patterns because it is not a valid C++ symbol.
ja: 両方のパターンとも、"_ZN3NSA6ClassA7Private11privmethod1Ei@Base" シンボルと "_ZN3NSA6ClassA7Private11privmethod2Ei@Base" シンボルにマッチする。1 番目のパターンでは、本来のシンボル名が 1 番目に C++ シンボルにデコードされ、デコードされたシンボル名を用いて正規表現によりマッチが行われる。一方、2 番目のパターンにマッチした場合、正規表現が本来のシンボル名にマッチし、その後そのシンボル名がデコードされた上で、C++ シンボル名として評価される。いずれかの基本パターンのマッチングに失敗すると、全体が失敗と見なされる。そのため、例えば "__N3NSA6ClassA7Private11privmethod\dEi@Base" は、正しい C++ シンボルでないため、どちらのパターンにもマッチしないと見なされる。

note: type: textblock
en: In general, all patterns are divided into two groups: aliases (basic I<c++> and I<symver>) and generic patterns (I<regex>, all combinations of multiple basic patterns).  Matching of basic alias-based patterns is fast (O(1))  while generic patterns are O(N) (N - generic pattern count) for each symbol.  Therefore, it is recommended not to overuse generic patterns.
ja: 一般的に、すべてのパターンはエイリアス (基本的な I<c++> と I<symver>) と汎用パターン (I<regex> および任意の基本パターンの組み合わせ) という 2 つのグループに大別される。基本的なエイリアスベースのパターンに対するマッチングは (O(1)) であるため高速であるが、汎用パターンは各シンボルに対して O(N) (N - 汎用的なパターンの数) となる。そのため、汎用パターンを多用しすぎないことを推奨する。

note: type: textblock
en: When multiple patterns match the same real symbol, aliases (first I<c++>, then I<symver>) are preferred over generic patterns.  Generic patterns are matched in the order they are found in the symbol file template until the first success.  Please note, however, that manual reordering of template file entries is not recommended because B<dpkg-gensymbols> generates diffs based on the alphanumerical order of their names.
ja: 組み合わせのパターンが同じ実シンボルにマッチした場合、エイリアス (I<c++>、I<symver> の順) が汎用パターンよりも優先される。汎用パターンは、マッチングに成功するまで、シンボルファイルのテンプレートに記載された順にマッチングを試みる。ただし、テンプレートファイルのエントリに記載された順序を手作業で修正することは推奨されない。これは、B<dpkg-gensymbols> が差分を生成する際に、名前が英数字順になっていることを前提としているためである。

note: type: =head2
en: Using includes
ja: include の使用

note: type: textblock
en: When the set of exported symbols differ between architectures, it may become inefficient to use a single symbol file.  In those cases, an include directive may prove to be useful in a couple of ways:
ja: エクスポートされた一連のシンボルがアーキテクチャにより異なっている場合、単一のシンボルファイルでは不便な場合がある。その場合、include ディレクティブにより、以下のような方法で、利便性を向上させることができる場合もある:

note: type: textblock
en: You can factorize the common part in some external file and include that file in your I<package>.symbols.I<arch> file by using an include directive like this:
ja: 外出ししたファイルの共通部分を取り出した上で、include ディレクティブを次にように用いて、該当ファイルを I<package>.symbols.I<arch> ファイルに挿入する:

note: type: textblock
en: The include directive may also be tagged like any symbol:
ja: include ディレクティブには、他のシンボル同様タグを付加してもよい:

note: type: textblock
en: As a result, all symbols included from I<file-to-include> will be considered to be tagged with I<tag> ... I<tagN> by default.  You can use this feature to create a common I<package>.symbols file which includes architecture specific symbol files:
ja: 結果として、I<file-to-include> から挿入されるすべてのシンボルが I<tag> ... I<tagN> にデフォルトでタグづけされたと見なされる。この機能を用いて、以下のように共通の I<package>.symbols ファイルを作成した上で、それをアーキテクチャ固有のシンボルファイルに挿入することもできる:

note: type: textblock
en: The symbols files are read line by line, and include directives are processed as soon as they are encountered.  This means that the content of the included file can override any content that appeared before the include directive and that any content after the directive can override anything contained in the included file.  Any symbol (or even another #include directive) in the included file can specify additional tags or override values of the inherited tags in its tag specification.  However, there is no way for the symbol to remove any of the inherited tags.
ja: シンボルファイルは 1 行ずつ読み取られ、include ディレクティブがあれば、都度処理される。つまり、挿入されるファイルの設定で include ディレクティブの前に存在していた設定が上書きされる可能性もあり、include ディレクティブの後に存在している設定により、挿入されたファイルの設定が上書きされることもある。挿入されるファイルに存在する任意のシンボル (別の #include ディレクティブを含む) では、新しいタグを追加することも、継承されたタグの値を上書きすることもできるが、シンボルから継承されたタグを削除することはできない。

note: type: textblock
en: An included file can repeat the header line containing the SONAME of the library.  In that case, it overrides any header line previously read.  However, in general it's best to avoid duplicating header lines.  One way to do it is the following:
ja: 挿入されたファイルで、ライブラリの SONAME を含むヘッダ行を繰り返すことも可能である。その場合、そこまで読み込んだヘッダ行はすべて上書きされる。ただし、一般的に、ヘッダ行の重複は避けるべきである。これを避ける方法の一つを以下に示す:

note: type: textblock
en: deb-substvars - Debian source substitution variables
ja: deb-substvars - Debian ソースにおける変数

note: type: textblock
en: Before B<dpkg-source>, B<dpkg-gencontrol> and B<dpkg-genchanges> write their control information (to the source control file B<.dsc> for B<dpkg-source> and to standard output for B<dpkg-gencontrol> and B<dpkg-genchanges>)  they perform some variable substitutions on the output file.
ja: B<dpkg-source>, B<dpkg-gencontrol>, B<dpkg-genchanges> が制御情報を (B<dpkg-source> 用のソース制御ファイル B<.dsc> 、B<dpkg-gencontrol> や B<dpkg-genchanges> の標準出力に) 書き出す際に、変数の置換が行われる。

note: type: textblock
en: If a variable is referred to but not defined it generates a warning and an empty value is assumed.
ja: 変数が定義されていないにもかかわらず参照されている場合は、値として空文字列が想定されるとともに、警告が生成される。

note: type: textblock
en: While variable substitution is done on all control fields, some of those fields are used and needed during the build when the substitution did not yet occur.  That's why you can't use variables in the B<Package>, B<Source> and B<Architecture> fields.
ja: 変数の置換は、すべての制御フィールドに対して行われるが、フィールドによっては変数が置換される前のビルド段階で用いられるものがある。そのため、B<Package>, B<Source>, B<Architecture> フィールドで変数を用いてはならない。

note: type: textblock
en: Variable substitution happens on the content of the fields after they have been parsed, thus if you want a variable to expand over multiple lines you do not have to include a space after the newline.  This is done implicitly when the field is output.  For example, if the variable B<${Description}> is set to "foo is bar.${Newline}foo is great." and if you have the following field:
ja: 変数の置換は、各フィールドが解析され、切り出された後の内容に対して行われる。そのため、置換した結果が複数行にわたる場合も、改行の後にスペースを含めておく必要はない。これは、置換された変数の内容がフィールドに展開される際に暗黙的に行われる。例えば "foo is bar.${Newline}foo is great." という内容が B<${Description}> という変数に格納されており、フィールドの内容が以下のようになっていた場合、

note: type: textblock
en: It will result in:
ja: 置換後の結果は次のようになる:

note: type: textblock
en: Additional disk space used when the package is installed.  If this variable is set its value is added to that of the B<Installed-Size> variable (whether set explicitly or using the default value) before it is copied into the B<Installed-Size> control file field.
ja: パッケージのインストール時に追加で用いられるディスク領域。この変数が設定されていると、B<Installed-Size> 変数の値 (明示的に設定されたものか、デフォルト値かは問わない) に本変数の値を足した値が control ファイルの B<Installed-Size>フィールドに適用される。

note: type: textblock
en: The B<.changes> file format version generated by this version of the source packaging scripts.  If you set this variable the contents of the B<Format> field in the B<.changes> file will change too.
ja: ソースパッケージングスクリプトによって生成される B<.changes> ファイルのフォーマットのバージョン。この変数を設定すると、B<.changes> ファイルの B<Format> フィールドの内容も変更される。

note: type: textblock
en: These variables each hold the corresponding character.
ja: これらの変数は、各々対応する文字を示す。

note: type: textblock
en: Variable settings with names of this form are generated by B<dpkg-shlibdeps>.
ja: この形式の名前のついた変数は、B<dpkg-shlibdeps> により生成される。

note: type: textblock
en: List of substitution variables and values.
ja: 変数およびその値のリスト。

note: type: textblock
en: deb-symbols - Debian's extended shared library information file
ja: deb-symbols - Debian の拡張された共有ライブラリ情報ファイル

note: type: textblock
en: The format for an extended shared library dependency information entry in these files is:
ja: これらのファイルに設定可能な拡張された共有ライブラリの依存関係情報のフォーマットは以下のとおりである:

note: type: =head2
en: Simple symbols file
ja: 簡単な symbol ファイル

note: type: =head2
en: Advanced symbols file
ja: 複雑な symbol ファイル

note: type: textblock
en: deb-triggers - package triggers
ja: deb-triggers - パッケージトリガ

note: type: textblock
en: A package declares its relationship to some trigger(s) by including a I<triggers> file in its control archive (i.e. I<DEBIAN/triggers> during package creation).
ja: パッケージは、 control アーカイブ内に I<triggers> ファイル (つまりはパッケージ生成の際の I<DEBIAN/triggers> など) を含めることで、トリガに対する関連付けを定義する。

note: type: textblock
en: This file contains directives, one per line.  Leading and trailing whitespace and everything after the first B<#> on any line will be trimmed, and empty lines will be ignored.
ja: このファイルには、各行ごとに 1 つのディレクティブが含まれる。行頭及び行末の空白文字と、B<#> 以降の記載および空行は無視される。

note: type: textblock
en: The trigger control directives currently supported are:
ja: 現在サポートされているトリガ制御ディレクティブを以下に示す:

note: type: textblock
en: If this package disappears during the unpacking of another package the trigger will be activated when the disappearance is noted towards the end of the unpack.  Trigger processing, and transition from triggers-awaited to installed, does not cause activations.  In the case of unpack, triggers mentioned in both the old and new versions of the package will be activated.
ja: 他のパッケージを unpack している最中に本パッケージが削除された場合、unpack終了時に削除が確認された際に、トリガが有効化される。トリガ処理自体やtriggers-awaited から installed への状態変化により、トリガが有効化されることはない。unpack の場合、パッケージの旧バージョンと新バージョンの両方で定義されているトリガが有効化される。

note: type: textblock
en: Unknown directives are an error which will prevent installation of the package.
ja: 不明なディレクティブがあるとエラーが発生し、パッケージのインストールが失敗する。

note: type: textblock
en: deb-version - Debian package version number format
ja: deb-version - Debian パッケージのバージョン番号の形式

note: type: textblock
en: Version numbers as used for Debian binary and source packages consist of three components.  These are:
ja: Debian バイナリおよびソースパッケージで用いられているバージョン番号は、以下の 3 つの要素からなっている:

note: type: textblock
en: This is a single (generally small) unsigned integer.  It may be omitted, in which case zero is assumed.  If it is omitted then the I<upstream-version> may not contain any colons.
ja: これは一桁の (通常小さい) 符号なし整数であり、0 の場合は省略してよい。省略した時には、I<upstream-version> にコロンを含めてはならない。

note: type: textblock
en: It is provided to allow mistakes in the version numbers of older versions of a package, and also a package's previous version numbering schemes, to be left behind.
ja: I<epoch> は、パッケージの古いバージョンにおけるバージョン番号の誤りを許容すると共に、パッケージの以前のバージョンにおける番号体系をそのまま残しておくために提供されている。

note: type: textblock
en: The comparison behavior of the package management system with respect to the I<upstream-version> is described below.  The I<upstream-version> portion of the version number is mandatory.
ja: パッケージ管理システムが I<upstream-version> 間で比較を行う際の挙動については後述する。バージョン番号には、必ず I<upstream-version> 部分がなければならない。

note: type: textblock
en: This part of the version number specifies the version of the Debian package based on the upstream version.  It may contain only alphanumerics and the characters B<+> B<.> B<~> (plus, full stop, tilde) and is compared in the same way as the I<upstream-version> is.
ja: バージョン番号のこの部分では、upstream-version に基づく Debian パッケージとしてのバージョン (リビジョン) を指定する。これには英数字と文字 B<+> B<.> B<~> (プラス、ピリオド、チルダ) のみが許容される。比較については、I<upstream-version> と同様に行われる。

note: type: textblock
en: Dpkg will break the version number apart at the last hyphen in the string (if there is one) to determine the I<upstream-version> and I<debian-revision>.  The absence of a I<debian-revision> compares earlier than the presence of one (but note that the I<debian-revision> is the least significant part of the version number).
ja: dpkg はバージョン番号文字列を、最後のハイフンの前後で I<upstream-version> とI<debian-revision> とに分割する (ハイフンがある場合)。I<debian-revision> が存在しない場合は、存在する場合よりも小さいとみなされる (ただし、debian-revisionは、バージョン番号を構成する要素のうち、もっとも右の部分であることに留意)。

note: type: textblock
en: The I<upstream-version> and I<debian-revision> parts are compared by the package management system using the same algorithm:
ja: パッケージ管理システムは、同じアルゴリズムを用いて I<upstream-version> や I<debian-revision> 同士を比較する。

note: type: textblock
en: The strings are compared from left to right.
ja: 文字列は左から右に順に比較される。

note: type: textblock
en: Then the initial part of the remainder of each string which consists entirely of digit characters is determined.  The numerical values of these two parts are compared, and any difference found is returned as the result of the comparison.  For these purposes an empty string (which can only occur at the end of one or both version strings being compared) counts as zero.
ja: 次に、双方の文字列の残りの部分の先頭から数字の部分が切り出され、数値として比較される。相違点が検出された場合は、それが比較結果として返却される。空文字列 (比較されるバージョン文字列の末尾以外に存在することはない) は、比較時には 0 として扱われる。

note: type: textblock
en: These two steps (comparing and removing initial non-digit strings and initial digit strings) are repeated until a difference is found or both strings are exhausted.
ja: このステップ (先頭の数字以外の文字列と数字を順に切り出して比較していく) を、相違点が確認されるか、双方の文字列の終端に達するまで繰り返す。

note: type: textblock
en: deb - Debian binary package format
ja: deb - Debian バイナリパッケージ形式

note: type: textblock
en: The file is an B<ar> archive with a magic value of B<!E<lt>archE<gt>>.  Only the common B<ar> archive format is supported, with no long file name extensions, but with file names containing an optional trailing slash, which limits their length to 15 characters (from the 16 allowed).  File sizes are limited to 10 ASCII decimal digits, allowing for up to approximately 9536.74 MiB member files.
ja: このファイルは B<!E<lt>archE<gt>> というマジックナンバーを持つ B<ar> アーカイブである。一般的な B<ar> アーカイブ形式のみがサポートされているため長いファイル名はサポートされていないが、ファイル名が (本来許可されている 16 文字のうち) 15 文字以内の場合、末尾にスラッシュを付けることができる。ファイルサイズは、ASCII の 10 進数で 10 桁以内となっており、約 9536.74 MiB のメンバファイルを扱うことができる。

note: type: textblock
en: The first member is named B<debian-binary> and contains a series of lines, separated by newlines.  Currently only one line is present, the format version number, B<2.0> at the time this manual page was written.  Programs which read new-format archives should be prepared for the minor number to be increased and new lines to be present, and should ignore these if this is the case.
ja: アーカイブの 1 番目のファイルは B<debian-binary> である。このファイルは、改行で区切られた何行かからなるが、本マニュアルページが書かれた時点では、形式のバージョン番号である B<2.0> が書かれた 1 行のみが存在している。新しい形式のアーカイブを読み込むプログラムは、マイナーバージョン番号の増加や、新しい行の追加に対応すべきである。その際には、これらを無視すること。

note: type: textblock
en: If the major number has changed, an incompatible change has been made and the program should stop.  If it has not, then the program should be able to safely continue, unless it encounters an unexpected member in the archive (except at the end), as described below.
ja: メジャーバージョン番号が変更されている場合は、互換性のない変更がされているとみなし、プログラムは停止すべきである。メジャーバージョンが変更されていない場合は、以下で説明するように、アーカイブに予期しないファイルが含まれていない限り (アーカイブ末尾に含まれる場合を除く)、プログラムは安全に実行を継続できる必要がある。

note: type: textblock
en: Those new members which won't be able to be safely ignored will be inserted before B<data.tar> with names starting with something other than underscores, or will (more likely) cause the major version number to be increased.
ja: 安全に無視させることのできない、アンダースコア以外の文字で始まる名前のファイルが B<data.tar> の前に追加されるかも知れないが、その場合は、(おそらく) メジャーバージョンアップとなるだろう。

note: type: textblock
en: dpkg-architecture - set and determine the architecture for package building
ja: dpkg-architecture - パッケージのビルドに用いられたアーキテクチャの設定と判別

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

note: type: textblock
en: Print the environment variables, one each line, in the format I<VARIABLE=value>.  This is the default action.
ja: 環境変数の値を 1 行に 1 つずつ、I<VARIABLE=value> 形式で表示する。これは、デフォルトの動作である。

note: type: textblock
en: Print the value of a single variable.
ja: 指定した単一の変数の値を表示する。

note: type: textblock
en: Show the usage message and exit.
ja: 利用方法を表示して終了する。

note: type: textblock
en: Show the version and exit.
ja: バージョン情報を表示して終了する。

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

note: type: =head1
en: TERMS
ja: 用語

note: type: =item
en: build machine
ja: ビルド (build) マシン

note: type: textblock
en: The machine the package is built on.
ja: パッケージのビルドが実行されるマシン

note: type: =item
en: host machine
ja: ホスト (host) マシン

note: type: textblock
en: The machine the package is built for.
ja: パッケージのビルドの対象となるマシン

note: type: =item
en: Debian architecture
ja: Debian アーキテクチャ

note: type: =head1
en: VARIABLES
ja: 変数

note: type: textblock
en: The Debian architecture of the build machine.
ja: ビルドマシンの Debian アーキテクチャ

note: type: textblock
en: The Debian architecture of the host machine.
ja: ホストマシンの Debian アーキテクチャ

note: type: textblock
en: B<dpkg-buildpackage> accepts the B<-a> option and passes it to B<dpkg-architecture>.  Other examples:
ja: B<dpkg-buildpackage> は B<-a> オプションを認識して、これをB<dpkg-architecture> に引き渡す。以下に実行例を幾つか示す:

note: type: textblock
en: Retrieving the GNU system type and forwarding it to ./configure:
ja: GNU システムタイプを取得し、それを ./configure に引き渡す:

note: type: textblock
en: Doing something only for a specific architecture:
ja: 特定のアーキテクチャに特化した処理を行う:

note: type: textblock
en: Note that you can also rely on an external Makefile snippet to properly set all the variables that B<dpkg-architecture> can provide:
ja: B<dpkg-architecture> が提供可能なすべての変数を適切に設定する目的で、外部の Makefile スニペットに依存することも可能である:

note: type: textblock
en: In any case, you should never use B<dpkg --print-architecture> to get architecture information during a package build.
ja: いかなる場合も、パッケージのビルド中にアーキテクチャ情報を取得する目的で、B<dpkg --print-architecture> を使用すべきではない。

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

note: type: textblock
en: dpkg-buildflags - returns build flags to use during package build
ja: パッケージのビルドの際に用いられるビルドフラグを返却する

note: type: textblock
en: B<dpkg-buildflags> is a tool to retrieve compilation flags to use during build of Debian packages.
ja: B<dpkg-buildflags> は、Debian パッケージのビルドの際に用いられるコンパイルオプションを示すツールである。

note: type: textblock
en: The default flags are defined by the vendor but they can be extended/overridden in several ways:
ja: デフォルトのフラグはベンダによって定義されるが、いくつかの方法によって上書きすることができる。

note: type: textblock
en: system-wide with B<%PKGCONFDIR%/buildflags.conf>;
ja: システムワイドな B<%PKGCONFDIR%/buildflags.conf>

note: type: textblock
en: for the current user with B<$XDG_CONFIG_HOME/dpkg/buildflags.conf> where B<$XDG_CONFIG_HOME> defaults to B<$HOME/.config>;
ja: 現在のユーザの B<$XDG_CONFIG_HOME/dpkg/buildflags.conf>。B<$XDG_CONFIG_HOME>のデフォルトは B<$HOME/.config> である。

note: type: textblock
en: Override the flag named I<flag> to have the value I<value>.
ja: I<flag> という名前のフラグの値を I<value> で上書きする。

note: type: textblock
en: Extend the flag named I<flag> by appending the options given in I<value>.  A space is prepended to the appended value if the flag's current value is non-empty.
ja: I<flag> という名前のフラグに対して、I<value> で指定されたオプションを追加する。対象のフラグに値が設定されている場合は、追加する値の前にスペースを付加すること。

note: type: textblock
en: The configuration files can contain comments on lines starting with a hash (#).  Empty lines are also ignored.
ja: 設定ファイルには、ハッシュ (#) から始まるコメント行を含めてもよい。空行は無視される。

note: type: textblock
en: This is intended to be run from B<debian/rules>, so that the build log keeps a clear trace of the build flags used.  This can be useful to diagnose problems related to them.
ja: これは B<debian/rules> から実行されることを想定されており、結果として、ビルドのログを用いた、使用されているビルドフラグの明確なトレースが実現する。ビルドフラグに関連した問題を調査するのに有用である。

note: type: textblock
en: Print the value of the flag on standard output.  Exits with 0 if the flag is known otherwise exits with 1.
ja: 指定されたフラグの値を標準出力に出力する。フラグが存在している場合は 0、それ以外の場合は 1 が返却される。

note: type: textblock
en: Print the origin of the value that is returned by B<--get>.  Exits with 0 if the flag is known otherwise exits with 1.  The origin can be one of the following values:
ja: B<--get> によって返却された値の提供元を表示する。フラグが存在している場合は 0、それ以外の場合は 1 が返却される。origin は、以下の値のいずれかとなる:

note: type: textblock
en: the original flag set by the vendor is returned;
ja: ベンダによって設定された本来のフラグ

note: type: textblock
en: the flag is set/modified by a system-wide configuration;
ja: システムワイドな設定ファイルにより設定、変更されたフラグ

note: type: textblock
en: the flag is set/modified by a user-specific configuration;
ja: ユーザ毎の設定により設定、変更されたフラグ

note: type: textblock
en: the flag is set/modified by an environment-specific configuration.
ja: 環境固有の設定により設定、変更されたフラグ

note: type: textblock
en: The output is in RFC822 format, with one section per feature.  For example:
ja: 出力は、機能ごとに、1つのセクションが存在する RFC822 形式となる。以下に例を示す:

note: type: =head1
en: SUPPORTED FLAGS
ja: サポートされるフラグ

note: type: textblock
en: This feature requires linking against glibc (or another provider of B<__stack_chk_fail>), so needs to be disabled when building with B<-nostdlib> or B<-ffreestanding> or similar.
ja: この機能は、glibc (もしくは B<__stack_chk_fail> を提供する他の実装) へのリンクが必要であるため、B<-nostdlib> や B<-ffreestanding> といったオプションでビルドする際には、無効にする必要がある。

note: type: textblock
en: There are 2 sets of environment variables doing the same operations, the first one (DEB_I<flag>_I<op>) should never be used within B<debian/rules>.  It's meant for any user that wants to rebuild the source package with different build flags.  The second set (DEB_I<flag>_MAINT_I<op>) should only be used in B<debian/rules> by package maintainers to change the resulting build flags.
ja: 同じ動作を行う環境変数が 2 組存在する。1 つ目の (DEB_I<flag>_I<op>) を B<debian/rules> 内で用いてはならない。これは、デフォルトのフラグとは異なる設定でソースパッケージをリビルドしたいユーザ向けの設定である。2 つ目の方法 (DEB_I<flag>_MAINT_I<op>) は B<debian/rules> 内でのみ使用すべきである。これは、パッケージのメンテナがビルドフラグを変更する際に使用すること。

note: type: textblock
en: This variable can be used to force the value returned for the given I<flag>.
ja: この変数は、I<flag> の値を強制的に設定したい場合に使用すること

note: type: textblock
en: This variable can be used to provide a space separated list of options that will be stripped from the set of flags returned for the given I<flag>.
ja: この変数は、I<flag> の値から削除したいオプションがある場合に使用すること。削除したいオプションは、スペースで区切ったリスト形式で指定する。

note: type: textblock
en: This variable can be used to append supplementary options to the value returned for the given I<flag>.
ja: この変数は、I<flag> の値に追加したいオプションがある場合に使用すること。

note: type: textblock
en: This variable can be used to prepend supplementary options to the value returned for the given I<flag>.
ja: この変数は、I<flag> の値の先頭部分に追加したいオプションがある場合に使用すること。

note: type: textblock
en: System wide configuration file.
ja: システムワイドな設定ファイル

note: type: textblock
en: User configuration file.
ja: ユーザ毎の設定ファイル

note: type: textblock
en: dpkg-buildpackage - build binary or source packages from sources
ja: dpkg-buildpackage - バイナリパッケージおよびソースパッケージのビルド

note: type: textblock
en: B<dpkg-buildpackage> is a program that automates the process of building a Debian package.  It consists of the following steps:
ja: B<dpkg-buildpackage> は、Debian パッケージのビルドを自動化するプログラムである。これには以下のステップが含まれる:

note: type: textblock
en: Passed unchanged to B<dpkg-genchanges>.  See its manual page.
ja: B<dpkg-genchanges> にそのまま引き渡される。そちらのマニュアルページを参照のこと。

note: type: textblock
en: The source package version.
ja: ソースパッケージのバージョン

note: type: textblock
en: Passed unchanged to B<dpkg-source>.  See its manual page.
ja: B<dpkg-source> にそのまま引き渡される。そちらのマニュアルページを参照のこと。

note: type: textblock
en: B<dpkg-architecture> is called with the B<-a> and B<-t> parameters forwarded.  Any variable that is output by its B<-s> option is integrated in the build environment.
ja: B<dpkg-architecture> は B<-a> および B<-t> を引数として呼び出される。このコマンドの B<-s> オプションによって設定された変数はビルド環境にマージされる。

note: type: =head2
en: Compiler flags are no longer exported
ja: コンパイラフラグのエクスポート停止

note: type: textblock
en: dpkg-checkbuilddeps - check build dependencies and conflicts
ja: dpkg-checkbuilddeps - ビルド時の依存と競合のチェック

note: type: textblock
en: This program checks the installed packages in the system against the build dependencies and build conflicts listed in the control file.  If any are not met, it displays them and exits with a nonzero return code.
ja: このプログラムは、制御ファイルに列挙されているビルド時の依存関係と競合に関して、システムにインストールされているパッケージをチェックする。問題があった場合はそれらを表示し、0 以外の返り値で終了する。

note: type: textblock
en: By default, B<debian/control> is read, but an alternate control filename may be specified on the command line.
ja: デフォルトでは、I<debian/control> が読みこまれるが、別のコントロールファイル名をコマンドラインで指定することもできる。

note: type: textblock
en: dpkg-deb - Debian package archive (.deb) manipulation tool
ja: dpkg-deb - Debian パッケージアーカイブ (.deb) 操作ツール

note: type: textblock
en: B<dpkg-deb> packs, unpacks and provides information about Debian archives.
ja: B<dpkg-deb> は、Debian アーカイブの作成、展開、情報の表示を行う。

note: type: textblock
en: Use B<dpkg> to install and remove packages from your system.
ja: パッケージをシステムにインストールしたり削除したりするには B<dpkg> を使うこと。

note: type: textblock
en: You can also invoke B<dpkg-deb> by calling B<dpkg> with whatever options you want to pass to B<dpkg-deb>.  B<dpkg> will spot that you wanted B<dpkg-deb> and run it for you.
ja: また、B<dpkg-deb> に引き渡したいオプションを指定して B<dpkg> を実行することで、B<dpkg-deb> を実行することもできる。B<dpkg> は、B<dpkg-deb> 用のオプションであると判断すると、 B<dpkg-deb> を起動する。

note: type: textblock
en: If the archive to be created already exists it will be overwritten.
ja: 作成するアーカイブが既に存在している場合は、上書きする。

note: type: textblock
en: Provides information about a binary package archive.
ja: バイナリパッケージアーカイブの情報を表示する。

note: type: textblock
en: If no I<control-file-name>s are specified then it will print a summary of the contents of the package as well as its control file.
ja: I<control-file-name> が指定されていない場合は、制御ファイルの一覧と、パッケージの概要を表示する。

note: type: textblock
en: If any I<control-file-name>s are specified then B<dpkg-deb> will print them in the order they were specified; if any of the components weren't present it will print an error message to stderr about each one and exit with status 2.
ja: I<control-file-name> が指定された場合、 B<dpkg-deb> は指定された順でファイルの内容を表示する。指定したファイルの一部が存在しない場合、存在しないファイル各々について、標準エラー出力にエラーメッセージを表示し、そして終了ステータス 2 で終了する。

note: type: textblock
en: Provides information about a binary package archive in the format specified by the B<--showformat> argument.  The default format displays the package's name and version on one line, separated by a tabulator.
ja: バイナリパッケージアーカイブの情報を B<--showformat> 引数で指定した形式で表示する。デフォルトの形式では、パッケージ名とバージョンがタブで区切られて 1 行に表示される。

note: type: textblock
en: Extracts control file information from a binary package archive.
ja: バイナリパッケージアーカイブから制御ファイル情報を取り出す。

note: type: textblock
en: No errors are reported for fields requested but not found.
ja: 指定したフィールドがみつからない場合でもエラーにはならない。

note: type: textblock
en: Lists the contents of the filesystem tree archive portion of the package archive.  It is currently produced in the format generated by B<tar>'s verbose listing.
ja: パッケージアーカイブに含まれるファイルシステムツリーの内容を表示する。現在は、B<tar> の冗長表示 (-v オプション) の形式で表示する。

note: type: textblock
en: Extracts the filesystem tree from a package archive into the specified directory.
ja: パッケージアーカイブから、ファイルシステムツリーを指定したディレクトリに展開する。

note: type: textblock
en: Note that extracting a package to the root directory will I<not> result in a correct installation! Use B<dpkg> to install packages.
ja: ルートディレクトリにパッケージを展開しても、正しいインストールにはI<ならない>ことに注意 ! パッケージのインストールには B<dpkg> を使うこと。

note: type: textblock
en: I<directory> (but not its parents) will be created if necessary, and its permissions modified to match the contents of the package.
ja: I<directory> (親ディレクトリは含まない) は必要に応じて作成される。

note: type: textblock
en: Is like B<--extract> (B<-x>)  with B<--verbose> (B<-v>)  which prints a listing of the files extracted as it goes.
ja: B<--extract> (B<-x>) に B<--verbose> (B<-v>) を付加したオプションと同様だが、実際にファイルを展開して一覧を表示する。

note: type: textblock
en: The target directory (but not its parents) will be created if necessary.
ja: 指定したディレクトリ (親ディレクトリは含まない) は必要に応じて作成される。

note: type: textblock
en: Extracts the control information files from a package archive into the specified directory.
ja: パッケージアーカイブから制御情報ファイルを指定したディレクトリに展開する。

note: type: textblock
en: If no directory is specified then a subdirectory B<DEBIAN> in the current directory is used.
ja: ディレクトリが指定されない場合、カレントディレクトリの B<DEBIAN> サブディレクトリに展開する。

note: type: textblock
en: This option is used to specify the format of the output B<--show> will produce.  The format is a string that will be output for each package listed.
ja: このオプションは、B<--show> の出力の書式を指定するものである。書式は、一覧表示される各パッケージの出力を制御する文字列である。

note: type: textblock
en: Inhibits B<dpkg-deb --build>'s usual checks on the proposed contents of an archive.  You can build any archive you want, no matter how broken, this way.
ja: B<dpkg-deb --build> の際に通常実施される、アーカイブの内容のチェックを実施しない。これにより、アーカイブの内容に問題があっても、アーカイブをビルドすることができる。

note: type: textblock
en: Enables debugging output.  This is not very interesting.
ja: デバッグ出力を有効にする。これはあまり面白いものではない。

note: type: =head1
en: EXIT STATUS
ja: 終了ステータス

note: type: textblock
en: The requested action was successfully performed.
ja: 指定したアクションが正しく実行された。

note: type: textblock
en: If set, B<dpkg-deb> will use it as the directory in which to create temporary files and directories.
ja: B<TMPDIR> が設定されている場合、B<dpkg-deb> は、一時的なファイルやディレクトリを作成するディレクトリとして使用する。

note: type: textblock
en: Do not attempt to use just B<dpkg-deb> to install software! You must use B<dpkg> proper to ensure that all the files are correctly placed and the package's scripts run and its status and contents recorded.
ja: B<dpkg-deb> でソフトウェアをインストールしようとしてはいけない!すべてのファイルの適切なパスへインストール、パッケージのスクリプトの実行、ステータスや内容の記録を確実に実行するために、必ず B<dpkg> を使うこと。

note: type: textblock
en: B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> does the wrong thing.
ja: B<dpkg-deb -I> I<package1>B<.deb> I<package2>B<.deb> は適切に動作しない。

note: type: textblock
en: There is no authentication on B<.deb> files; in fact, there isn't even a straightforward checksum.  (Higher level tools like APT support authenticating B<.deb> packages retrieved from a given repository, and most packages nowadays provide an md5sum control file generated by debian/rules.  Though this is not directly supported by the lower level tools.)
ja: B<.deb> ファイルには認証という概念がなく、単純なチェックサムすらもない (APT のような高レイヤのツールは、指定されたリポジトリから情報を収集することで B<.deb> パッケージの認証をサポートしている。また大半のパッケージは近年debian/rules によって生成される md5sum 制御ファイルを提供している。しかし、これらは低レイヤのツールが直接的にサポートしているものではない。

note: type: textblock
en: dpkg-distaddfile - add entries to debian/files
ja: dpkg-distaddfile - debian/files にエントリを追加する

note: type: textblock
en: B<dpkg-distaddfile> adds an entry for a named file to B<debian/files>.
ja: B<dpkg-distaddfile> は B<debian/files> にファイル名のエントリを追加する。

note: type: textblock
en: It takes three non-option arguments, the filename and the section and priority for the B<.changes> file.
ja: このコマンドは、B<.changes> ファイル用に、オプション以外の引数として filename, section, priority という 3 つの引数をとる。

note: type: textblock
en: The filename should be specified relative to the directory where B<dpkg-genchanges> will expect to find the files, usually B<..>, rather than being a pathname relative to the current directory when B<dpkg-distaddfile> is run.
ja: filename は B<dpkg-genchanges> が想定するディレクトリ、通常 B<..> からの相対パスで指定する。B<dpkg-distaddfile> 実行時のカレントディレクトリからの相対パスではない。

note: type: textblock
en: Read or write the list of files to be uploaded here, rather than using B<debian/files>.
ja: B<debian/files> の代わりにこのファイルに記載されたファイルのリストを読み書きする。

note: type: textblock
en: The list of generated files which are part of the upload being prepared.  B<dpkg-distaddfile> can be used to add additional files.
ja: アップロードの準備の一部をなす、生成されたファイルのリスト。B<dpkg-distaddfile> により、ファイルを追加することができる。

note: type: textblock
en: dpkg-divert - override a package's version of a file
ja: dpkg-divert - パッケージの提供するファイルの上書き

note: type: textblock
en: B<dpkg-divert> is the utility used to set up and update the list of diversions.
ja: B<dpkg-divert> は、退避ファイルの一覧を設定、更新するためのユーティリティである。

note: type: textblock
en: Print the real name for a diverted file.
ja: 退避されたファイルの実際のファイル名を表示する。

note: type: textblock
en: I<divert-to> is the location where the versions of I<file>, as provided by other packages, will be diverted.
ja: I<divert-to> は、他のパッケージによって提供された I<file> の退避場所である。

note: type: textblock
en: Specifies that all packages' versions of this file are diverted.  This means, that there are no exceptions, and whatever package is installed, the file is diverted.  This can be used by an admin to install a locally modified version.
ja: パッケージが提供する該当ファイルについてはすべて退避の対象とする。これは、いかなるパッケージがインストールされても、該当のファイルは退避されることを意味する。これにより、管理者が修正したファイルをローカルにインストールすることが可能となる。

note: type: textblock
en: I<package> is the name of a package whose copy of I<file> will not be diverted.  i.e. I<file> will be diverted for all packages except I<package>.
ja: I<package> は、I<file> の退避が発生しないパッケージ名である。つまり、I<package> 以外のすべてのパッケージの提供する I<file> は、退避される。

note: type: textblock
en: Quiet mode, i.e. no verbose output.
ja: 非表示モード。冗長な出力をしない。

note: type: textblock
en: Test mode, i.e. don't actually perform any changes, just demonstrate.
ja: テストモード。実際にはなにも実行せず、なにを実行するかを表示するだけである。

note: type: textblock
en: If set and the B<--local> and B<--package> options have not been specified, B<dpkg-divert> will use it as the package name.
ja: B<--local> および B<--package> オプションが設定されておらず、この変数が設定されている場合、B<dpkg-divert> は、この変数の値をパッケージ名として使用する。

note: type: textblock
en: When adding, default is B<--local> and B<--divert> I<original>B<.distrib>.  When removing, B<--package> or B<--local> and B<--divert> must match if specified.
ja: ファイルを追加する時のデフォルトは、B<--local> および B<--divert> I<original>B<.distrib> である。削除する時に、B<--package> もしくは B<--local> と B<--divert> が指定されていた場合は、これらの整合性がとれている必要がある。

note: type: textblock
en: Directories can't be diverted with B<dpkg-divert>.
ja: B<dpkg-divert> でディレクトリを退避させることはできない。

note: type: textblock
en: To divert all copies of a I</usr/bin/example> to I</usr/bin/example.foo>, i.e. directs all packages providing I</usr/bin/example> to install it as I</usr/bin/example.foo>, performing the rename if required:
ja: I</usr/bin/example> となるファイルすべてを I</usr/bin/example.foo> に退避させる、つまり、I</usr/bin/example> を提供するすべてのパッケージが、該当ファイルを I</usr/bin/example.foo> にリネームしてインストールするようにさせる:

note: type: textblock
en: To remove that diversion:
ja: 該当の退避ファイルを削除する。

note: type: textblock
en: To divert any package trying to install I</usr/bin/example> to I</usr/bin/example.foo>, except your own I<wibble> package:
ja: I</usr/bin/example> をインストールしようとするすべてのパッケージを I</usr/bin/example.foo> に退避させる。ただし、自作の I<wibble> パッケージを除く:

note: type: textblock
en: Specifies the main source control file to read information from.  The default is B<debian/control>.
ja: 情報の読み取り元となる主なソース制御ファイルを指定する。デフォルトは B<debian/control>。

note: type: textblock
en: Specifies the changelog file to read information from.  The default is B<debian/changelog>.
ja: 情報の読み取り元となる changelog ファイルを指定する。デフォルトは B<debian/changelog>。

note: type: textblock
en: Change the location of the B<dpkg> database.  The default location is I</var/lib/dpkg>.
ja: B<dpkg> データベースの位置を変更する。デフォルトの位置は I<%ADMINDIR%> である。

note: type: textblock
en: dpkg-genchanges - generate Debian .changes files
ja: dpkg-genchanges - Debian .changes ファイルの生成

note: type: textblock
en: B<dpkg-genchanges> reads information from an unpacked and built Debian source tree and from the files it has generated and generates a Debian upload control file (B<.changes> file).
ja: B<dpkg-genchanges> は展開されてビルドされた Debian ソースツリーおよび生成されたファイルから情報を読み取り、Debian アップロード制御ファイル (B<.changes> ファイル) を生成する。

note: type: textblock
en: The B<-s>I<x> options control whether the original source archive is included in the upload if any source is being generated (i.e.  B<-b> or B<-B> haven't been used).
ja: B<-s>I<x> オプションは、(B<-b>, B<-B> が使われておらず) 何らかのソースが生成された場合に、オリジナルのソースアーカイブがアップロードに含まれるかどうかを決定する。

note: type: textblock
en: By default, or if specified, the original source will be included only if the upstream version number (the version without epoch and without Debian revision) differs from the upstream version number of the previous changelog entry.
ja: デフォルト、もしくは明示的にこのオプションが指定された場合は、アップストリームのバージョン番号 (epoch および Debian リビジョンを含まない) が以前の changelog エントリに記録されたアップストリームのバージョン番号と異なる場合にのみ、オリジナルのソースが含まれる。

note: type: textblock
en: Forces the inclusion of the original source.
ja: 強制的にオリジナルのソースを含める。

note: type: textblock
en: Forces the exclusion of the original source and includes only the diff.
ja: 強制的にオリジナルのソースを除外し、差分情報のみを含める。

note: type: textblock
en: Causes changelog information from all versions strictly later than I<version> to be used.
ja: I<version> 以降のバージョンすべてから changelog 情報を生成する。

note: type: textblock
en: Read the description of the changes from the file I<changes-description> rather than using the information from the source tree's changelog file.
ja: ソースツリーの changelog ファイルからの情報ではなく、I<changes-description> ファイルにある変更点の情報を使用する。

note: type: textblock
en: Use I<maintainer-address> as the name and email address of the maintainer for this package, rather than using the information from the source tree's control file.
ja: ソースツリーの control ファイルからの情報ではなく、I<maintainer-address> で指定した情報を、このパッケージのメンテナの名前とメールアドレスとして使用する。

note: type: textblock
en: Use I<maintainer-address> as the name and email address of the maintainer for this upload, rather than using the information from the source tree's changelog.
ja: ソースツリーの changelog ファイルからの情報ではなく、I<maintainer-address> で指定した情報を、今回のアップロードのメンテナの名前とメールアドレスとして使用する。

note: type: textblock
en: Override or add an output control file field.
ja: 出力制御ファイルのフィールドを上書きもしくは追加する。

note: type: textblock
en: Remove an output control file field.
ja: 出力制御ファイルのフィールドを削除する。

note: type: textblock
en: Read the list of files to be uploaded here, rather than using B<debian/files>.
ja: B<debian/files> の代わりに、アップロードされるファイルの一覧を読み取るファイルを指定する。

note: type: textblock
en: Look for the files to be uploaded in I<upload-files-dir> rather than B<..> (B<dpkg-genchanges> needs to find these files so that it can include their sizes and checksums in the B<.changes> file).
ja: アップロード対象となるファイルを、B<..> ではなく I<upload-files-dir> から探し出す (B<dpkg-genchanges> は B<.changes> ファイルにファイルサイズとチェックサムを含めるため、対象となるファイルを確認する必要がある)。

note: type: textblock
en: Usually B<dpkg-genchanges> will produce informative messages on standard error, for example about how many of the package's source files are being uploaded.  B<-q> suppresses these messages.
ja: 通常、B<dpkg-genchanges> は標準エラー出力に対して、アップロードされたパッケージに含まれるソースファイルの数といった有用なメッセージを出力する。B<-q> により、こうしたメッセージの出力が抑止される。

note: type: textblock
en: The list of generated files which are part of the upload being prepared.  B<dpkg-genchanges> reads the data here when producing a B<.changes> file.
ja: アップロードの準備の一部をなす、生成されたファイルのリスト。B<dpkg-genchanges> は B<.changes> ファイルを生成する際の情報をここから読み取る。

note: type: textblock
en: dpkg-gencontrol - generate Debian control files
ja: dpkg-gencontrol - Debian 制御ファイルの生成

note: type: textblock
en: B<dpkg-gencontrol> reads information from an unpacked Debian source tree and generates a binary package control file (which defaults to debian/tmp/DEBIAN/control); during this process it will simplify the relation fields.
ja: B<dpkg-gencontrol> は展開された Debian ソースツリーから情報を読み取り、バイナリパッケージの control ファイル (デフォルトでは debian/tmp/DEBIAN/control) を生成する。生成の過程で、関連するフィールドの単純化も行う。

note: type: textblock
en: B<dpkg-gencontrol> also adds an entry for the binary package to B<debian/files>.
ja: B<dpkg-gencontrol> は B<debian/files> へのバイナリパッケージのエントリ追加も行う。

note: type: textblock
en: Sets the version number of the binary package which will be generated.
ja: 生成されるバイナリパッケージのバージョン番号を設定する。

note: type: textblock
en: Generate information for the binary package I<package>.  If the source control file lists only one binary package then this option may be omitted; otherwise it is essential to select which binary package's information to generate.
ja: バイナリパッケージ I<package> の情報を生成する。ソース制御ファイルに単一のバイナリパッケージだけが記載されていた場合、このオプションは省略してもよい。それ以外の場合は、どのバイナリパッケージの情報を生成するかを選択する上で、このオプションが不可欠である。

note: type: textblock
en: Assume the filename of the package will be I<filename> instead of the normal package_version_arch.deb filename.
ja: 通常の package_version_arch.deb というファイル名ではなく、パッケージのファイル名を I<filename> とする。

note: type: textblock
en: The main source control information file, giving version-independent information about the source package and the binary packages it can produce.
ja: 主たるソース制御情報ファイルであり、生成可能なソースパッケージおよびバイナリパッケージに関するバージョン非依存の情報を提供する。

note: type: textblock
en: The list of generated files which are part of the upload being prepared.  B<dpkg-gencontrol> adds the presumed filenames of binary packages whose control files it generates here.
ja: アップロードの準備の一部をなす、生成されたファイルのリスト。B<dpkg-gencontrol> は、制御ファイルを生成したバイナリパッケージのファイル名を追加する。

note: type: textblock
en: dpkg-gensymbols - generate symbols files (shared library dependency information)
ja: dpkg-gensymbols - シンボルファイル (共有ライブラリの依存情報) の生成

note: type: textblock
en: B<dpkg-gensymbols> scans a temporary build tree (debian/tmp by default) looking for libraries and generates a I<symbols> file describing them.  This file, if non-empty, is then installed in the DEBIAN subdirectory of the build tree so that it ends up included in the control information of the package.
ja: B<dpkg-gensymbols> は一時的なビルドツリー (デフォルトでは debian/tmp) 以下にあるライブラリを探しだし、それらの情報を記載した I<symbols> ファイルを生成する。このファイルが空でない場合、ファイルはビルドツリーの DEBIAN サブディレクトリにインストールされ、最終的にパッケージの制御情報ファイルに含まれる。

note: type: textblock
en: When generating those files, it uses as input some symbols files provided by the maintainer.  It looks for the following files (and uses the first that is found):
ja: これらのファイルの生成の際には、入力情報として、メンテナによって提供されるシンボルファイルが用いられる。シンボルファイルとして、以下のファイルが確認される (最初に見つかったファイルが用いられる):

note: type: textblock
en: When the generated symbols files differ from the maintainer supplied one, B<dpkg-gensymbols> will print a diff between the two versions.  Furthermore if the difference is too significant, it will even fail (you can customize how much difference you can tolerate, see the B<-c> option).
ja: 生成されたシンボルファイルがメンテナが提供するものと異なっていた場合、B<dpkg-gensymbols> は双方の差分を表示する。相違点が大量の場合は、処理を失敗させる (どの程度の量を大量と見なすかについては調整可能である。B<-c> オプションを参照のこと)。

note: type: =head1
en: MAINTAINING SYMBOLS FILES
ja: シンボルファイルのメンテナンス

note: type: textblock
en: Before applying any patch to the symbols file, the maintainer should double-check that it's sane.  Public symbols are not supposed to disappear, so the patch should ideally only add new lines.
ja: シンボルファイルに何らかのパッチを適用する前に、メンテナは本当にそれが必要かどうかを再度確認すること。公開シンボルが削除されることは想定されていないため、パッチは新しい行を追加するだけに留めるのが理想である。

note: type: =head2
en: Good library management
ja: 推奨されるライブラリ管理

note: type: textblock
en: A well-maintained library has the following features:
ja: 適切に維持されているライブラリの特徴を以下に示す:

note: type: textblock
en: its API is stable (public symbols are never dropped, only new public symbols are added) and changes in incompatible ways only when the SONAME changes;
ja: API の変更がなく (公開シンボルの消失は一切なく、新しい公開シンボルが追加されるのみである)、SONAME の変更以外に互換性を損なう API の変更が行われない。

note: type: textblock
en: ideally, it uses symbol versioning to achieve ABI stability despite internal changes and API extension;
ja: 理想的には、ABI の安定性を維持するため、内部的な変更と API の拡張を除いてシンボルのバージョン管理が行われている。

note: type: textblock
en: it doesn't export private symbols (such symbols can be tagged optional as workaround).
ja: 非公開シンボルをエクスポートしない (そうしたシンボルは暫定で optional のタグづけをしておくこともできる)。

note: type: textblock
en: While maintaining the symbols file, it's easy to notice appearance and disappearance of symbols.  But it's more difficult to catch incompatible API and ABI change.  Thus the maintainer should read thoroughly the upstream changelog looking for cases where the rules of good library management have been broken.  If potential problems are discovered, the upstream author should be notified as an upstream fix is always better than a Debian specific work-around.
ja: シンボルファイルをメンテナンスする上で、追加されたり削除されたりしたシンボルを把握することは難しくないが、互換性のない API や ABI の変更を把握するのは難しい。メンテナにはアップストリームの changelog を読み込んで、推奨されるライブラリ管理のルールが守られていない点を探しだすことが求められる。潜在的な問題が発見されたら、アップストリームの開発者に通知すること。Debian 独自の暫定対処よりも、アップストリーム側での修正が常に望ましい。

note: type: textblock
en: Scan I<package-build-dir> instead of debian/tmp.
ja: debian/tmp の代わりに I<package-build-dir> 内を確認する。

note: type: textblock
en: Define the package name.  Required if more than one binary package is listed in debian/control (or if there's no debian/control file).
ja: パッケージ名を定義する。debian/control ファイルに複数のバイナリパッケージが記載されている (もしくは debian/control ファイルが存在しない) 場合は必須である。

note: type: textblock
en: Define the package version.  Defaults to the version extracted from debian/changelog.  Required if called outside of a source package tree.
ja: パッケージのバージョンを定義する。デフォルトは debian/changelog から取得されたバージョンが用いられる。ソースパッケージツリー以外で呼び出された際は必須である。

note: type: textblock
en: Use I<filename> as reference file to generate the symbols file that is integrated in the package itself.
ja: I<filename> を、パッケージに同梱するシンボルファイルを生成する際のリファレンスファイルとして使用する。

note: type: textblock
en: Assume I<arch> as host architecture when processing symbol files.  Use this option to generate a symbol file or diff for any architecture provided its binaries are already available.
ja: シンボルファイルの処理の際に、I<arch> をホストのアーキテクチャと見なす。このオプションは、バイナリファイルが既に利用可能な場合に、シンボルファイルや差分情報を生成する際に使用する。

note: type: textblock
en: Enable debug mode.  Numerous messages are displayed to explain what B<dpkg-gensymbols> does.
ja: デバッグモードを有効化する。B<dpkg-gensymbols> の動作を示す大量のメッセージが表示される。

note: type: textblock
en: Enable verbose mode.  The generated symbols file contains deprecated symbols as comments.  Furthermore in template mode, pattern symbols are followed by comments listing real symbols that have matched the pattern.
ja: 冗長モードを有効化する。生成されたシンボルファイルには、廃止されたシンボルがコメントとして残される。さらにテンプレートモードの場合、パターンシンボルについて、パターンとマッチした実シンボルの一覧もコメントとして残される。

note: type: textblock
en: dpkg-maintscript-helper - works around known dpkg limitations in maintainer scripts
ja: dpkg-maintscript-helper - メンテナスクリプトにおける既知の dpkg の制約に対する暫定対応

note: type: =head1
en: COMMANDS AND PARAMETERS
ja: コマンドおよびパラメータ

note: type: =head1
en: CONFFILE RELATED TASKS
ja: conffile 関連の作業

note: type: textblock
en: This means that if a package is intended to rename or remove a conffile, it must explicitly do so and B<dpkg-maintscript-helper> can be used to implement graceful deletion and moving of conffiles within maintainer scripts.
ja: これは、パッケージが conffile のリネームや削除を意図していた場合は、明示的に行う必要があり、B<dpkg-maintscript-helper> が既定を遵守した削除の実装と、conffile をメンテナスクリプトにより移動するために用いられることを意味する。

note: type: textblock
en: All of this is implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
ja: これらのすべてがメンテナスクリプト B<preinst>, B<postinst>, B<postrm> 内で以下のようなシェルスクリプトによって行われる。

note: type: textblock
en: I<conffile> is the filename of the conffile to remove.
ja: I<conffile> は削除する conffile のファイル名である。

note: type: textblock
en: Current implementation: in the B<preinst>, it checks if the conffile was modified and renames it either to I<conffile>B<.dpkg-remove> (if not modified) or to I<conffile>B<.dpkg-backup> (if modified).  In the B<postinst>, the latter file is renamed to I<conffile>B<.dpkg-bak> and kept for reference as it contains user modifications but the former will be removed.  If the package upgrade aborts, the B<postrm> reinstalls the original conffile.  During purge, the B<postrm> will also delete the B<.dpkg-bak> file kept up to now.
ja: 現在の実装では、B<preinst> は conffile が変更されたかをチェックし、I<conffile>B<.dpkg-remove> (変更されていない場合) もしくは I<conffile>.B<dpkg-backup> (変更されている場合) にリネームする。B<postinst> は後者のファイルを I<conffile>B<.dpkg-bak> にリネームし、ユーザが変更内容を参照できるように保持するが、前者は削除する。パッケージのアップグレードが中止となった場合、B<postrm> は以前の conffile を再インストールする。完全削除の際に、B<postrm> はここまで保持されていた B<.dpkg-bak> ファイルも削除する。

note: type: textblock
en: Graceful renaming can be implemented by putting the following shell snippet in the B<preinst>, B<postinst> and B<postrm> maintainer scripts:
ja: 以下に示すシェルスクリプトを B<preinst>, B<postinst>, B<postrm> のメンテナスクリプトに入れることで、適切なリネーム処理が実行される:

note: type: textblock
en: I<old-conffile> and I<new-conffile> are the old and new name of the conffile to rename.
ja: I<old-conffile> と I<new-conffile> は、リネームする conffile の変更前、変更後の名前である。

note: type: textblock
en: Current implementation: the B<preinst> checks if the conffile has been modified, if yes it's left on place otherwise it's renamed to I<old-conffile>B<.dpkg-remove>.  On configuration, the B<postinst> removes I<old-conffile>B<.dpkg-remove> and renames I<old-conffile> to I<new-conffile> if I<old-conffile> is still available.  On abort-upgrade/abort-install, the B<postrm> renames I<old-conffile>B<.dpkg-remove> back to I<old-conffile> if required.
ja: 現在の実装では、B<preinst> は conffile が変更されたかをチェックし、変更されている場合はそのままに、変更されていない場合は I<old-conffile>B<.dpkg-remove> にリネームする。設定の際に、B<postinst> は I<old-conffile>B<.dpkg-remove> を削除し、I<old-conffile> が存在している場合は、それを I<new-conffile> にリネームする。abort-upgrade や abort-install が行われた場合、B<postrm> は、必要に応じて I<old-conffile>B<.dpkg-remove> をリネームして I<old-conffile> に戻す。

note: type: =head1
en: INTEGRATION IN PACKAGES
ja: パッケージとの連携

note: type: textblock
en: dpkg-mergechangelogs - 3-way merge of debian/changelog files
ja: dpkg-mergechangelogs - debian/changelogs ファイルの 3-way マージ

note: type: textblock
en: This program will use the 3 provided versions of the Debian changelog to generate a merged changelog file.  The resulting changelog is stored in the file I<out> or output to the standard output if that parameter is not given.
ja: このプログラムは、3 つの Debian changelog のバージョンから、マージされたchangelog ファイルを生成する。生成された changelog は I<out> ファイルに保存されるが、パラメータが指定されなかった場合は 標準出力に出力される。

note: type: textblock
en: Each entry is identified by its version number and they are assumed to be not conflicting, they are simply merged in the right order (by decreasing version number).  When B<--merge-prereleases> is used, the part of the version number after the last tilde is dropped so that 1.0-1~exp1 and 1.0-1~exp5 are considered to be the same entry.  When the same version is available in both I<new-a> and I<new-b>, a standard line-based 3-way merge is attempted (provided that the module Algorithm::Merge is available — it's part of the package libalgorithm-merge-perl — otherwise you get a global conflict on the content of the entry).
ja: 各エントリはバージョン番号によって区別され、競合が発生していないことが前提となる。これらは右から順番に (バージョン番号を減らすことで) 単純にマージされる。B<--merge-prereleases> が指定された場合、バージョン番号の最後のチルダより後の部分が除外されるため、1.0-1~exp1 と 1.0-1~exp5 は同じエントリだと見なされる。I<new-a> と I<new-b> とに同じバージョンがある場合、標準的な行ベースの 3-way マージが試行される (Algorithm::Merge モジュールが利用可能な場合。— これは、libalgorithm-merge-perl パッケージの一部である。 — 利用できない場合は、該当のエントリにおいて競合が発生する)。

note: type: textblock
en: Drop the part after the last tilde in the version number when doing version comparison to identify if two entries are supposed to be the same or not.
ja: 2 つのエントリが同一と見なされるかどうかを確認するバージョン比較の際に、バージョン番号の最後のチルダより後の部分を除外する。

note: type: textblock
en: This is useful when you keep using the same changelog entry but you increase its version number regularly.  For instance, you might have 2.3-1~exp1, 2.3-1~exp2, ... until the official release 2.3-1 and they are all the same changelog entry that has evolved over time.
ja: これは、バージョン番号を常に増加させているものの、同一の changelog エントリの使用を継続したい場合に有用である。一例として、2.3-1~exp1, 2.3-1~exp2 というバージョンが公式なリリースである 2.3-1 まで続くような場合に、これらを時系列順に並べて同一の changelog エントリにしたい場合などが挙げられる。

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

note: type: =head1
en: INTEGRATION WITH GIT
ja: GIT との連携

note: type: textblock
en: If you want to use this program to merge Debian changelog files in a git repository, you have first to register a new merge driver in B<.git/config> or B<~/.gitconfig>:
ja: このプログラムを git リポジトリにある Debian changelog ファイルのマージに用いる場合は、最初に B<.git/config> もしくは B<~/.gitconfig> に新しいマージドライバを登録しておく必要がある:

note: type: textblock
en: Then you have to setup the merge attribute for the debian/changelog file either in B<.gitattributes> in the repository itself, or in B<.git/info/attributes>:
ja: ついで、debian/changelog ファイルの merge 属性をリポジトリ内の B<.gitattributes> もしくは B<.git/info/attributes> 中に設定する必要がある:

note: type: textblock
en: dpkg-name - rename Debian packages to full package names
ja: dpkg-name - Debian パッケージを完全パッケージ名にリネーム

note: type: textblock
en: This manual page documents the B<dpkg-name> program which provides an easy way to rename B<Debian> packages into their full package names.  A full package name consists of I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> as specified in the control file of the package.  The I<version> part of the filename consists of the upstream version information optionally followed by a hyphen and the revision information.  The I<package-type> part comes from that field if present or fallbacks to B<deb>.
ja: このマニュアルページでは、B<dpkg-name> シェルスクリプトについて説明する。これは、B<Debian> パッケージを完全パッケージ名に、簡単に変更する方法を提供する。完全パッケージ名とは、パッケージの control ファイルで指定された I<package>B<_>I<version>B<_>I<architecture>B<.>I<package-type> という形式である。ファイル名の I<version> 部分は、アップストリームのバージョン情報に続き、オプションでハイフンおよびリビジョン情報が続いたものである。I<package-type> 部分は、Package-Type フィールドが設定されていればその内容が用いられる。デフォルトは B<deb> である。

note: type: textblock
en: The destination filename will not have the architecture information.
ja: リネーム後のファイル名にアーキテクチャ情報を含めない。

note: type: textblock
en: Create a symlink, instead of moving.
ja: ファイル名のリネーム処理として、ファイルを移動する代わりにシンボリックリンクを作成する。

note: type: textblock
en: Existing files will be overwritten if they have the same name as the destination filename.
ja: リネーム後のファイル名と同名のファイルがあれば、上書きする。

note: type: textblock
en: B<Don't do this.> Your archive will be messed up completely because a lot of packages don't come with section information.  B<Don't do this.>
ja: B<やってはいけない!> 多くのパッケージはセクション情報をもっていないので、アーカイブがぐちゃぐちゃになってしまうだろう。B<やってはいけない!>

note: type: textblock
en: This can be used when building new packages.
ja: これは新しいパッケージを作る時に使うことができる。

note: type: textblock
en: dpkg-parsechangelog - parse Debian changelog files
ja: dpkg-parsechangelog - Debian changelog ファイルの解析

note: type: textblock
en: B<dpkg-parsechangelog> reads and parses the changelog of an unpacked Debian source tree and outputs the information in it to standard output in a machine-readable form.
ja: B<dpkg-parsechangelog> は、展開された Debian ソースツリーにある changelog ファイルを読み取って解析し、その情報をコンピュータに適した形式で標準出力に出力する。

note: type: =head2
en: Parser Options
ja: パーサ用オプション

note: type: textblock
en: The highest urgency of all included entries is used, followed by the concatenated (space-separated) comments from all the versions requested.
ja: 含まれているエントリの中で、最も高い urgency の値が用いられ、要求されたバージョンすべてのコメントを (スペースで区切って) 結合した文字列が続く。

note: type: textblock
en: The Closes fields of all included entries are merged.
ja: Closes フィールドに含まれるすべてのエントリはマージされる。

note: type: textblock
en: The text of all changelog entries is concatenated.  To make this field a valid Debian control format multiline field empty lines are replaced with a single full stop and all lines is intended by one space character.  The exact content depends on the changelog format.
ja: changelog のエントリにあるすべてのテキストは結合される。このフィールドを Debian 制御情報形式に従った形式とするために、複数行のフィールドにおける空行は、ピリオドに置き換えられ、すべての行の先頭に空白文字が 1 つ挿入される。内容は changelog の形式に依存する。

note: type: textblock
en: The B<Version>, B<Distribution>, B<Urgency>, B<Maintainer> and B<Changes> fields are mandatory.
ja: B<Version>, B<Distribution>, B<Urgency>, B<Maintainer>, B<Changes> フィールドは必須である。

note: type: textblock
en: There might be additional user-defined fields present.
ja: この他、ユーザ定義のフィールドが存在してもよい。

note: type: =head1
en: CHANGELOG FORMATS
ja: changelog のフォーマット

note: type: textblock
en: It is possible to use a different format to the standard one, by providing a parser for that alternative format.
ja: 標準的なフォーマットとは異なるフォーマットに対応したパーサがあれば、非標準のフォーマットを用いることもできる。

note: type: textblock
en: In order to have B<dpkg-parsechangelog> run the new parser, a line must be included within the last 40 lines of the changelog file, matching the Perl regular expression: “B<\schangelog-format:\s+([0-9a-z]+)\W>”.  The part in parentheses should be the name of the format.  For example:
ja: B<dpkg-parsechangelog> に新しいパーサを使用させるには、changelog ファイルの末尾 40 行以内に、次のような Perl の正規表現: “B<\schangelog-format:\s+([0-9a-z]+)\W>” にマッチする行が含まれている必要がある。括弧内にフォーマットの名称を記載すること。以下に一例を示す:

note: type: textblock
en: If the changelog format which is being parsed always or almost always leaves a blank line between individual change notes, these blank lines should be stripped out, so as to make the resulting output compact.
ja: 解析されている changelog フォーマットにおいて、個々の変更点の記述の間の大半、もしくはすべてが空行となる場合、それらの空行は省略されるため、結果として出力がコンパクトになる。

note: type: textblock
en: If the changelog format does not contain date or package name information this information should be omitted from the output.  The parser should not attempt to synthesize it or find it from other sources.
ja: changelog フォーマットに日付やパッケージ名の情報が含まれていない場合、これらの情報は出力から省かれる。パーサは、これらを生成したり、別の情報源から探してきたりしてはならない。

note: type: textblock
en: A changelog parser may not interact with the user at all.
ja: changelog パーサは、ユーザと対話を行わなくともよい。

note: type: textblock
en: The changelog file, used to obtain version-dependent information about the source package, such as the urgency and distribution of an upload, the changes made since a particular release, and the source version number itself.
ja: changelog ファイル、urgency やアップロードの distribution、あるリリース以降に行われた変更点、ソースのバージョン番号自体といった、ソースパッケージに関するバージョン固有の情報を取得するために用いられる。

note: type: textblock
en: dpkg-query - a tool to query the dpkg database
ja: dpkg-query - dpkg データベースクエリツール

note: type: textblock
en: B<dpkg-query> is a tool to show information about packages listed in the B<dpkg> database.
ja: B<dpkg-query> は、B<dpkg> データベースに格納されたパッケージの情報を表示するツールである。

note: type: textblock
en: The first three columns of the output show the desired action, the package status, and errors, in that order.
ja: 出力の先頭から 3 つのカラムは、順に期待される動作 (desired action)、パッケージの状況、エラー状態を示す。

note: type: textblock
en: Desired action:
ja: 期待される動作

note: type: textblock
en: Package status:
ja: パッケージの状況:

note: type: textblock
en: Error flags:
ja: エラーフラグ:

note: type: textblock
en: The output format of this option is not configurable, but varies automatically to fit the terminal width.  It is intended for human readers, and is not easily machine-readable.  See B<-W> (B<--show>)  and B<--showformat> for a way to configure the output format.
ja: この出力形式は変更できないが、端末の横幅に合わせて自動的に調整される。これは人間が目視することを想定したものであり、コンピュータに適した形式ではない。出力形式の設定方法については、B<-W> (B<--show>) および B<--showformat> を参照のこと。

note: type: textblock
en: In the format string, “B<\>” introduces escapes:
ja: フォーマット文字列中の “B<\>” はエスケープ文字である:

note: type: textblock
en: “B<\>” before any other character suppresses any special meaning of the following character, which is useful for “B<\>” and “B<$>”.
ja: 任意の文字の前に “B<\>” を配置することで、これに続く文字の特殊な意味を抑制できる。これは “B<\>” や “B<$>” に有用である。

note: type: textblock
en: Package information can be included by inserting variable references to package fields using the syntax “B<${>I<field>[B<;>I<width>]B<}>”.  Fields are printed right-aligned unless the width is negative in which case left alignment will be used.  The following I<field>s are recognized but they are not necessarily available in the status file (only internal fields or fields stored in the binary package end up in it):
ja: パッケージ情報には、“B<${>I<field>[B<;>I<width>]B<}>” という構文で、パッケージフィールドを参照する変数を含めることができる。各フィールドは右寄せで表示されるが、width に負の値を指定すると左寄せになる。以下の I<field> が認識されるが、これらはステータスファイルに存在している必要はない (内部フィールドやバイナリパッケージに格納されたフィールドの形で最終的に存在していればよい)。

note: type: textblock
en: The following are virtual fields, generated by B<dpkg-query> from values from other fields (note that these do not use valid names for fields in control files):
ja: 以下は B<dpkg-query> が別のフィールドの値から生成した仮想的なフィールドである (これらのフィールド名は、制御ファイルにおける適切な命名規則に従っていない点に留意)。

note: type: textblock
en: The requested query was successfully performed.
ja: リクエストされたクエリが正しく実行された。

note: type: textblock
en: dpkg-scanpackages - create Packages index files
ja: dpkg-scanpackages - Packages インデックスファイルの作成

note: type: textblock
en: I<path-prefix> is an optional string to be prepended to the Filename fields.
ja: I<path-prefix> は Filename フィールドにおいて、パスの前に追加できるオプションの文字列である。

note: type: textblock
en: If more than one version of a package is found only the newest one is included in the output.  If they have the same version and only differ in architecture only the first one found is used.
ja: パッケージに複数のバージョンがある場合、最新のものだけが出力される。同一のバージョンでアーキテクチャだけが異なる場合は、最初のものだけが使用される。

note: type: textblock
en: Scan for *.I<type> packages, instead of *.deb.
ja: *.deb の代わりに *.I<type> パッケージを検索の対象とする。

note: type: textblock
en: Use a pattern consisting of I<*_all.deb> and I<*_arch.deb> instead of scanning for all debs.
ja: すべての deb ファイルを検索する代わりに、I<*_all.deb> および I<*_arch.deb> といったパターンを検索する。

note: type: textblock
en: Include all found packages in the output.
ja: みつかったパッケージすべてを出力する。

note: type: =head1
en: DIAGNOSTICS
ja: 診断メッセージ

note: type: textblock
en: B<dpkg-scanpackages> outputs the usual self-explanatory errors.  It also warns about packages that are in the wrong subdirectory, are duplicated, have a Filename field in their control file, are missing from the override file, or have maintainer substitutions which do not take effect.
ja: B<dpkg-scanpackages> のエラーメッセージは通常自明である。また、不適切なディレクトリにある、重複している、control ファイルに Filename フィールドがある、override ファイルに存在しない、無効なメンテナの置換があるといったパッケージに対する警告も行う。

note: type: textblock
en: dpkg-scansources - create Sources index files
ja: dpkg-scansources - ソースインデックスファイルの作成

note: type: textblock
en: B<dpkg-scansources> scans the given I<binary-dir> for I<.dsc> files.  These are used to create a Debian source index, which is output to stdout.
ja: B<dpkg-scansources> は、I<.dsc> ファイルのために、指定された I<binary-dir> を検索する。これは Debian ソースインデックスを生成し、標準出力に出力するために用いられる。

note: type: textblock
en: The I<path-prefix>, if given, is prepended to the directory field in the generated source index.  You generally use this to make the directory fields contain the path from the top of the Debian archive hierarchy.
ja: I<path-prefix> が指定された場合、生成されたソースインデックスにおける directory フィールドの先頭に挿入される。これは通常 directory フィールドにDebian アーカイブ階層トップからのパスを含めたい場合に使用する。

note: type: textblock
en: The source override file is in a different format from the binary override file.  It contains only two whitespace separated fields, the first is the source package name and the second is the section.  Blank lines and comment lines are ignored in the normal manner.  If a package appears in both files the source override takes precedence for setting the section.
ja: ソース override ファイルの形式はバイナリ override ファイルとは異なり、空白文字で区切られた 2 つのフィールドのみからなる。1 番目のフィールドはソースパッケージ名であり、2 番目はセクション名である。慣習に従い、空白行とコメント行は無視される。あるパッケージが両方のファイルに現れた場合、セクションの設定においては、ソース override ファイルが優先される。

note: type: textblock
en: Turn debugging on.
ja: デバッグを有効にする

note: type: textblock
en: dpkg-shlibdeps - generate shared library substvar dependencies
ja: dpkg-shlibdeps - 共有ライブラリの substvar 依存関係を生成する

note: type: textblock
en: B<dpkg-shlibdeps> calculates shared library dependencies for executables named in its arguments.  The dependencies are added to the substitution variables file B<debian/substvars> as variable names B<shlibs:>I<dependency-field> where I<dependency-field> is a dependency field name.  Any other variables starting with B<shlibs:> are removed from the file.
ja: B<dpkg-shlibdeps> は、引数として与えられた実行バイナリと共有ライブラリとの依存関係を算出する。依存関係は変数ファイル B<debian/substvars> に B<shlibs:>I<dependency-field> という名前の変数として追加される。I<dependency-field> は依存関係にあるフィールド名であり、それ以外のB<shlibs:> からはじまる変数はファイルから削除される。

note: type: textblock
en: B<dpkg-shlibdeps> has two possible sources of information to generate dependency information.  Either I<symbols> files or I<shlibs> files.  For each binary that B<dpkg-shlibdeps> analyzes, it finds out the list of libraries that it's linked with.  Then, for each library, it looks up either the I<symbols> file, or the I<shlibs> file (if the former doesn't exist or if debian/shlibs.local contains the relevant dependency).  Both files are supposed to be provided by the library package and should thus be available as %ADMINDIR%/info/I<package>.I<symbols> or %ADMINDIR%/info/I<package>.I<shlibs>.  The package name is identified in two steps: find the library file on the system (looking in the same directories that B<ld.so> would use), then use B<dpkg -S> I<library-file> to lookup the package providing the library.
ja: B<dpkg-shlibdeps> には依存関係情報を生成する情報源として I<symbols> ファイルおよび I<shlibs> ファイルの 2 つを使用する。B<dpkg-shlibdeps> は、解析する各バイナリについてリンクするライブラリの一覧を確認した上で、各ライブラリを、I<symbols> ファイルもしくは I<shlibs> ファイル (前者が存在しないか、debian/shlibs.local に適切な依存関係が含まれている場合) から検索する。両ファイルともに、ライブラリのパッケージによって提供され、各々 %ADMINDIR%/info/I<package>.I<symbols> および %ADMINDIR%/info/I<package>.I<shlibs> に存在する。パッケージ名は 2 段階で識別される。最初にシステムにあるライブラリが検索され (B<ld.so> が使用するのと同じディレクトリが検索される)、ついで B<dpkg -S> I<library-file> を用いてライブラリを提供するパッケージが検索される。

note: type: =head2
en: Symbols files
ja: シンボルファイル

note: type: textblock
en: Symbols files contain finer-grained dependency information by providing the minimum dependency for each symbol that the library exports.  The script tries to find a symbols file associated to a library package in the following places (first match is used):
ja: シンボルファイルにはライブラリがエクスポートしている各シンボルに関する最小の依存関係を提供するための詳細な依存関係情報が含まれる。スクリプトは、ライブラリパッケージに関連付けられたシンボルファイルを検索する際に、ファイルを確認する (最初にマッチしたものが使われる):

note: type: textblock
en: Per-system overriding shared library dependency information.  I<arch> is the architecture of the current system (obtained by B<dpkg-architecture -qDEB_HOST_ARCH>).
ja: システム全体に上書き適用される共有ライブラリの依存関係情報。I<arch> は現在のシステムのアーキテクチャを示す (B<dpkg-architecture -qDEB_HOST_ARCH> により取得される)。

note: type: =item
en: Output from “B<dpkg-query --control-path> I<package> symbols”
ja: “B<dpkg-query --control-path> I<package> symbols” の出力

note: type: textblock
en: While scanning the symbols used by all binaries, B<dpkg-shlibdeps> remembers the (biggest) minimal version needed for each library.  At the end of the process, it is able to write out the minimal dependency for every library used (provided that the information of the I<symbols> files are accurate).
ja: バイナリが使用するシンボルをスキャンしている際、B<dpkg-shlibdeps> は、各ライブラリが必要としている (最大の) 最小バージョンを記憶する。これにより、処理が完了した際に、使用する各ライブラリ毎に最小の依存関係を書き出すことが可能となる (I<symbols> ファイルの情報が適切である場合)。

note: type: =head2
en: Shlibs files
ja: shlibs ファイル

note: type: textblock
en: Shlibs files associate directly a library to a dependency (without looking at the symbols).  It's thus often stronger than really needed but very safe and easy to handle.
ja: shlibs ファイルは、ライブラリに直接 (シンボルを参照することなしに) 依存関係を設定する。これは時として必要以上に強力な場合もあるが、非常に安全かつ簡単に扱うことができる。

note: type: textblock
en: The dependencies for a library are looked up in several places.  The first file providing information for the library of interest is used:
ja: ライブラリの依存関係は、幾つかのパスから検索される。対象のライブラリに対して最初に情報を提供したファイルの情報が用いられる。

note: type: textblock
en: Package-local overriding shared library dependency information.
ja: パッケージのみに上書き適用される共有ライブラリの依存関係情報

note: type: textblock
en: Per-system overriding shared library dependency information.
ja: システム全体に上書き適用される共有ライブラリの依存関係情報

note: type: textblock
en: Shared library information generated by the current build process that also invoked B<dpkg-shlibdeps>.  They are only used if the library is found in a package's build tree.  The shlibs file in that build tree takes precedence over shlibs files from other binary packages.
ja: B<dpkg-shlibdeps> を起動した現在のビルド処理によって生成された共有ライブラリの情報。これらはライブラリがパッケージのビルドツリー内で見つかった場合のみ使われる。ビルドツリー内の shlibs ファイルはその他のバイナリパッケージの shlibs ファイルに優先する。

note: type: =item
en: Output from “B<dpkg-query --control-path> I<package> shlibs”
ja: “B<dpkg-query --control-path> I<package> shlibs” の出力

note: type: textblock
en: Per-system default shared library dependency information.
ja: システム全体に影響するデフォルトの共有ライブラリの依存関係情報

note: type: textblock
en: The extracted dependencies are then directly used (except if they are filtered out because they have been identified as duplicate, or as weaker than another dependency).
ja: 展開された依存関係は直接適用される (重複が確認されたり、別のより強い依存関係が確認されたりしたためフィルタされる場合を除く)。

note: type: textblock
en: B<dpkg-shlibdeps> interprets non-option arguments as executable names, just as if they'd been supplied as B<-e>I<executable>.
ja: B<dpkg-shlibdeps> は、オプションでない引数を、B<-e>I<executable> で指定された場合と同じく実行ファイル名として解釈する。

note: type: textblock
en: Add dependencies to be added to the control file dependency field I<dependency-field>.  (The dependencies for this field are placed in the variable B<shlibs:>I<dependency-field>.)
ja: 制御ファイルの依存関係のためのフィールド I<dependency-field> に依存関係を追加する (このフィールドに記載した依存関係は B<shlibs:>I<dependency-field> 変数に設定される。

note: type: textblock
en: The B<-d>I<dependency-field> option takes effect for all executables after the option, until the next B<-d>I<dependency-field>.  The default I<dependency-field> is B<Depends>.
ja: B<-d>I<dependency-field> オプションは、次の B<-d>I<dependency-field> が現れるまで、このオプションに続くすべての実行ファイルに適用される。I<dependency-field> のデフォルトは B<Depends> である。

note: type: textblock
en: If the same dependency entry (or set of alternatives) appears in more than one of the recognized dependency field names B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances> or B<Suggests> then B<dpkg-shlibdeps> will automatically remove the dependency from all fields except the one representing the most important dependencies.
ja: B<Pre-Depends>, B<Depends>, B<Recommends>, B<Enhances>, B<Suggests> といった依存関係に関連するフィールドに、同一の (代替パッケージを含む) 依存関係のエントリが現れた場合、B<dpkg-shlibdeps> は自動的にもっとも重要な依存関係を示すもの以外、すべてのフィールドから該当する依存関係を自動的に削除する。

note: type: textblock
en: Start substitution variables with I<varname-prefix>B<:> instead of B<shlibs:>.  Likewise, any existing substitution variables starting with I<varname-prefix>B<:> (rather than B<shlibs:>)  are removed from the substitution variables file.
ja: 変数名を B<shlibs:> から始まる代わりに I<varname-prefix>B<:> から始める。同様に、(B<shlibs:>ではなく) I<varname-prefix>B<:> から始まる既存の変数が変数ファイルから削除される。

note: type: textblock
en: Read overriding shared library dependency information from I<local-shlibs-file> instead of B<debian/shlibs.local>.
ja: B<debian/shlibs.local> の代わりに I<local-shlibs-file> から上書きする共有ライブラリの依存関係情報を読み取る。

note: type: textblock
en: Write substitution variables in I<substvars-file>; the default is B<debian/substvars>.
ja: 変数を I<substvars-file> に書き込む。デフォルトは B<debian/substvars> である。

note: type: textblock
en: Since B<dpkg-shlibdeps> analyzes the set of symbols used by each binary of the generated package, it is able to emit warnings in several cases.  They inform you of things that can be improved in the package.  In most cases, those improvements concern the upstream sources directly.  By order of decreasing importance, here are the various warnings that you can encounter:
ja: B<dpkg-shlibdeps> が生成されたパッケージの各バイナリが使用する一連のシンボルを解析する際に、様々なケースで警告が発生する。これにより、パッケージの改良につながるヒントを得ることができる。多くの場合、こうした改良はアップストリームのソースに直接影響する。重要度の高いものから順に、発生しうる様々な警告を以下に示す:

note: type: textblock
en: The indicated symbol has not been found in the libraries linked with the binary.  The I<binary> is most likely a library and it needs to be linked with an additional library during the build process (option B<-l>I<library> of the linker).
ja: これは、シンボルがバイナリにリンクされたライブラリ内で見つからなかったことを示す。I<binary> はほとんどの場合ライブラリであり、ビルド処理の中で別のライブラリにリンクされる必要がある (リンカの B<-l>I<library> オプション)。

note: type: textblock
en: The indicated symbol has not been found in the libraries linked with the binary.  The I<binary> is most likely a plugin and the symbol is probably provided by the program that loads this plugin.  In theory a plugin doesn't have any SONAME but this binary does have one and as such it could not be clearly identified as such.  However the fact that the binary is stored in a non-public directory is a strong indication that's it's not a normal shared library.  If the binary is really a plugin, then disregard this warning.  But there's always the possibility that it's a real library and that programs linking to it are using an RPATH so that the dynamic loader finds it.  In that case, the library is broken and needs to be fixed.
ja: これは、シンボルがバイナリにリンクされたライブラリ内で見つからなかったことを示す。I<binary> はほとんどの場合プラグインであり、シンボルは恐らくプラグインをロードするプログラムによって提供される。プラグインには SONAME を持たせないのがセオリーだが、このバイナリはそれを持っているため、プラグインかどうかを明確に判別することができていない。ただし、このバイナリは一般的なディレクトリに配置されていないため、通常の共有ライブラリではないことがほぼ断定できている。バイナリが実際にプラグインであった場合は、この警告は無視すればよい。ただし、バイナリが実際にはライブラリである可能性もある。その場合、リンクするプログラムは RPATH を用いて、動的ローダにライブラリを発見させる。後者の場合、このライブラリは機能不全であり、修正が必要である。

note: type: textblock
en: None of the I<binaries> that are linked with I<library> use any of the symbols provided by the library.  By fixing all the binaries, you would avoid the dependency associated to this library (unless the same dependency is also generated by another library that is really used).
ja: I<library> にリンクされた I<binaries> は、ライブラリによって提供されているシンボルをまったく使用していない。I<binaries> に列挙されたすべてのバイナリを修正することで、このライブラリへの依存関係を外すことができる可能性がある (実際に使用される別のライブラリによって、同じ依存関係が生成されている場合を除く)。

note: type: textblock
en: Exactly the same as the above warning, but for multiple binaries.
ja: 前述の警告と同一であるが、複数のバイナリが対象となっている。

note: type: textblock
en: B<dpkg-shlibdeps> will fail if it can't find a public library used by a binary or if this library has no associated dependency information (either shlibs file or symbols file).  A public library has a SONAME and is versioned (libsomething.so.I<X>).  A private library (like a plugin) should not have a SONAME and doesn't need to be versioned.
ja: B<dpkg-shlibdeps> は、バイナリによって使用される公開ライブラリを発見できない場合や、ライブラリに依存関係の情報 (shlibs ファイルやシンボルファイル) が存在しない場合エラーとなる。公開ライブラリは SONAME があり、(libsomething.so.I<X> という形態で) バージョン管理されている。(プラグインのような) 非公開ライブラリは SONAME を持つべきではなく、バージョン管理も不要である。

note: type: textblock
en: dpkg-source - Debian source package (.dsc) manipulation tool
ja: dpkg-source - Debian ソースパッケージ (.dsc) 操作ツール

note: type: textblock
en: B<dpkg-source> packs and unpacks Debian source archives.
ja: B<dpkg-source> は、Debian ソースアーカイブの作成、展開を行う。

note: type: textblock
en: None of these commands allow multiple options to be combined into one, and they do not allow the value for an option to be specified in a separate argument.
ja: これらの I<command> では複数のオプションを 1 つに結合することはできず、オプションの値をオプション名から分離した引数として指定することもできない。

note: type: textblock
en: B<dpkg-source> will read the names of the other file(s) making up the source package from the control file; they are assumed to be in the same directory as the B<.dsc>.
ja: B<dpkg-source> は制御ファイルからソースパッケージの設定を行うためのファイル名を取得する。これらは B<.dsc> ファイルと同じディレクトリに配置されているものとみなされる。

note: type: textblock
en: The files in the extracted package will have their permissions and ownerships set to those which would have been expected if the files and directories had simply been created - directories and executable files will be 0777 and plain files will be 0666, both modified by the extractors' umask; if the parent directory is setgid then the extracted directories will be too, and all the files and directories will inherit its group ownership.
ja: 展開されたパッケージのファイルには、ファイルやディレクトリを単に作成したときに設定されるであろうものと同様のパーミッションや所有者が設定される。ディレクトリ及び実行ファイルのパーミッションは 0777 に、普通のファイルは 0666 に設定されるが、展開したユーザの umask の影響を受ける。親ディレクトリが setgid されていた場合、展開されたディレクトリもそれに従い、ファイルやディレクトリには、グループの所有者情報が引き継がれる。

note: type: textblock
en: Specifies the main source control file to read information from.  The default is B<debian/control>.  If given with relative pathname this is interpreted starting at the source tree's top level directory.
ja: 情報の読み取り元となるメインのソース制御ファイルを指定する。デフォルトは B<debian/control> である。相対パス名で指定された場合は、ソースツリーのトップのディレクトリを起点として解釈される。

note: type: textblock
en: Specifies the changelog file to read information from.  The default is B<debian/changelog>.  If given with relative pathname this is interpreted starting at the source tree's top level directory.
ja: 情報の読み取り元となる changelog ファイルを指定する。デフォルトは B<debian/changelog> である。相対パス名で指定された場合は、ソースツリーのトップのディレクトリを起点として解釈される。

note: type: =head1
en: SOURCE PACKAGE FORMATS
ja: ソースパッケージ形式

note: type: =head2
en: Format: 1.0
ja: 1.0 形式

note: type: textblock
en: B<Extracting>
ja: B<展開>

note: type: textblock
en: B<Building>
ja: B<ビルド>

note: type: textblock
en: B<-sa>, B<-sp>, B<-sk>, B<-su> and B<-sr> will not overwrite existing tarfiles or directories.  If this is desired then B<-sA>, B<-sP>, B<-sK>, B<-sU> and B<-sR> should be used instead.
ja: B<-sa>, B<-sp>, B<-sk>, B<-su>, B<-sr> は、既存の tar ファイルやディレクトリを上書きしない。上書きさせたい場合は、代わりに B<-sA>, B<-sP>, B<-sK>, B<-sU>, B<-sR> を使用すること。

note: type: textblock
en: Specifies to expect the original source as a tarfile, by default I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension>.  It will leave this original source in place as a tarfile, or copy it to the current directory if it isn't already there.  The tarball will be unpacked into I<directory>B<.orig> for the generation of the diff.
ja: オリジナルのソースが、デフォルトでは I<package>B<_>I<upstream-version>B<.orig.tar.>I<extension> という名前の tar ファイルであることを指示する。このオリジナルのソースは適切な場所にtar ファイルのまま残され、カレントディレクトリに存在していない場合はそこにコピーされる。tar ファイルは diff を生成するために、I<directory>B<.orig> に展開される。

note: type: textblock
en: Like B<-sk> but will remove the directory again afterwards.
ja: B<-sk> と同様だが、最後にディレクトリを削除する。

note: type: textblock
en: Specifies that the original source is expected as a directory, by default I<package>B<->I<upstream-version>B<.orig> and B<dpkg-source> will create a new original source archive from it.
ja: オリジナルのソースが、デフォルトでは I<package>B<->I<upstream-version>B<.orig> という名前のディレクトリにあることを指示する。B<dpkg-source> は、ここから新しいソースアーカイブを作成する。

note: type: textblock
en: Like B<-su> but will remove that directory after it has been used.
ja: B<-su> と同様だが、使用後にディレクトリを削除する。

note: type: textblock
en: Specifies to not look for any original source, and to not generate a diff.  The second argument, if supplied, must be the empty string.  This is used for Debian-specific packages which do not have a separate upstream source and therefore have no debianization diffs.
ja: オリジナルのソースを参照せず、diff も生成しないことを指示する。2 番目の引数が存在する場合、それは空文字列である必要がある。これは、アップストリームのソースが存在せず、Debian 化するための差分が存在しない Debian 固有のパッケージに用いられる。

note: type: =item
en: B<-sa> or B<-sA>
ja: B<-sa> もしくは B<-sA>

note: type: textblock
en: In all cases any existing original source tree will be removed.
ja: いずれの場合も、既存のオリジナルのソースツリーはすべて削除される。

note: type: textblock
en: Used when extracting then the original source (if any) will be left as a tarfile.  If it is not already located in the current directory or if an existing but different file is there it will be copied there.  (B<This is the default>).
ja: オリジナルのソースを tar ファイルとして残す (存在する場合)。カレントディレクトリに配置されていない場合や、存在しているが異なるファイルである場合は、オリジナルのソースがコピーされる (B<これはデフォルトの挙動である>)。

note: type: textblock
en: Unpacks the original source tree.
ja: オリジナルのソースツリーを展開する。

note: type: textblock
en: Ensures that the original source is neither copied to the current directory nor unpacked.  Any original source tree that was in the current directory is still removed.
ja: オリジナルのソースをカレントディレクトリにコピーさせず、展開もさせない。カレントディレクトリに存在するオリジナルのソースツリーは削除される。

note: type: textblock
en: All the B<-s>I<X> options are mutually exclusive.  If you specify more than one only the last one will be used.
ja: B<-s>I<X> オプションは相互排他である。複数回指定された場合、最後に指定されたものが使用される。

note: type: =head2
en: Format: 2.0
ja: 2.0 形式

note: type: textblock
en: When building a new source package, any change to the upstream source is stored in a patch named B<zz_debian-diff-auto>.
ja: 新しいソースパッケージをビルドする際にアップストリームのソースに対する変更が発生した場合、B<zz_debian-diff-auto> という名前のパッチとして保存する。

note: type: =head2
en: Format: 3.0 (native)
ja: 3.0 (native) 形式

note: type: =head2
en: Format: 3.0 (quilt)
ja: 3.0 (quilt) 形式

note: type: textblock
en: The main original tarball is extracted first, then all additional original tarballs are extracted in subdirectories named after the I<component> part of their filename (any pre-existing directory is replaced).  The debian tarball is extracted on top of the source directory after prior removal of any pre-existing B<debian> directory.  Note that the debian tarball must contain a B<debian> sub-directory but it can also contain binary files outside of that directory (see B<--include-binaries> option).
ja: 主たるオリジナルの tar アーカイブが最初に展開され、ついで追加のオリジナル tar アーカイブが、ファイル名の I<component> からとった名前のサブディレクトリに展開される (既存のディレクトリがあった場合、上書きされる)。debian tar アーカイブは、既存の B<debian> ディレクトリの削除後、ソースディレクトリのトップに展開される。debian tar アーカイブには、B<debian> サブディレクトリが必要だが、ディレクトリ外にバイナリファイルを含めることもできる (B<--include-binaries)> オプションを参照のこと)。

note: type: textblock
en: The file B<.pc/applied-patches> is created if some patches have been applied during the extraction.
ja: 展開の際にパッチが適用された場合、B<.pc/applied-patches> ファイルが作成される。

note: type: textblock
en: The updated debian directory and the list of modified binaries is then used to generate the debian tarball.
ja: 設定を行うことで、debian tar アーカイブを生成する際に、更新された debian ディレクトリと修正されたバイナリのリストが使用される。

note: type: textblock
en: B<Recording changes>
ja: B<変更の記録>

note: type: textblock
en: Passing I<patch-file> is mainly useful after a build failure that pre-generated this file, and on this ground the given file is removed after integration.  Note also that the changes contained in the patch file must already be applied on the tree and that the files modified by the patch must not have supplementary unrecorded changes.
ja: I<patch-file> の指定は、予め生成されたパッチファイルを用いたビルドに失敗した際に有用であり、そのため、指定されたファイルは統合後に削除される。パッチファイルに含まれている変更点は、ツリーに予め適用されている必要があり、パッチによって修正されるファイルは、その他の記録されていない変更が行われていてはならない点にも留意すること。

note: type: textblock
en: B<Build options>
ja: B<ビルドオプション>

note: type: textblock
en: Do not ignore removed files and include them in the automatically generated patch.
ja: 削除されたファイルを無視せず、それらを自動生成されたパッチに含める。

note: type: textblock
en: Include timestamp in the automatically generated patch.
ja: タイムスタンプを自動生成されたパッチに含める。

note: type: textblock
en: Add all modified binaries in the debian tarball.  Also add them to B<debian/source/include-binaries>: they will be added by default in subsequent builds and this option is thus no more needed.
ja: debian tar アーカイブに修正されたバイナリをすべて追加し、併せて B<debian/source/include-binaries> にも追加する。これらはその後のビルドの際にデフォルトで追加されるため、このオプションは不要である。

note: type: textblock
en: B<Extract options>
ja: B<展開オプション>

note: type: =head2
en: Format: 3.0 (custom)
ja: 3.0 (custom) 形式

note: type: textblock
en: All non-option arguments are taken as files to integrate in the generated source package.  They must exist and are preferably in the current directory.  At least one file must be given.
ja: すべてのオプション形式ではない引数は、生成されたソースパッケージに統合するファイルとみなされる。ファイルはあらかじめ存在している必要があり、カレントディレクトリに存在していることが望ましい。最低 1 つのファイルを指定すること。

note: type: =head2
en: Format: 3.0 (git)
ja: 3.0 (git) 形式

note: type: textblock
en: A source package in this format consists of a single bundle of a git repository B<.git> to hold the source of a package.  There may also be a B<.gitshallow> file listing revisions for a shallow git clone.
ja: この形式のソースパッケージは、パッケージのソースを保持する単一の git bundle である、git リポジトリ B<.git> から構成される。shallow git clone がリビジョン保持に使用する B<.gitshallow> ファイルも含まれる場合がある。

note: type: textblock
en: Before going any further, some checks are done to ensure that we don't have any non-ignored uncommitted changes.
ja: 先に進む前に、無視すべきもの以外でコミットされていない変更がないことを担保するためのチェックが行われる。

note: type: textblock
en: Creates a shallow clone with a history truncated to the specified number of revisions.
ja: shallow clone を作成する。作成の際、ヒストリを指定したリビジョン数に切り詰める。

note: type: =head2
en: Format: 3.0 (bzr)
ja: 3.0 (bzr) 形式

note: type: textblock
en: The tarball is unpacked and then bzr is used to checkout the current branch.
ja: tar アーカイブを展開した上で、現在のブランチをチェックアウトするために bzr が使用される。

note: type: textblock
en: Then the VCS specific part of the source directory is copied over to a temporary directory.  Before this temporary directory is packed in a tarball, various cleanup are done to save space.
ja: その後、ソースディレクトリ内のバージョン管理システム固有のファイルが一時ディレクトリにコピーされる。一時ディレクトリが tar アーカイブにされる前に、領域を節約するために、様々なクリーンアップ処理が行われる。

note: type: textblock
en: Changes to upstream sources are usually stored with patch files, but not all changes can be represented with patches: they can only alter the content of plain text files.  If you try replacing a file with something of a different type (for example replacing a plain file with a symlink or a directory), you will get this error message.
ja: アップストリームのソースに対する変更は、通常パッチファイルに保存されるが、パッチでは、すべての変更を保持できるわけではない。パッチは平文テキストファイルの内容しか変更できない。これ以外の形式のファイルの内容を変更しようとすると (例えば普通のファイルをシンボリックリンクやディレクトリに変更するなど) 、このエラーメッセージが表示される。

note: type: textblock
en: Empty files can't be created with patch files.  Thus this change is not recorded in the source package and you are warned about it.
ja: パッチファイルでは空ファイルを作成することができないため、この変更はソースパッケージに保持されない。そのため警告が表示される。

note: type: textblock
en: Patch files do not record permissions of files and thus modified permissions are not stored in the source package.  This warning reminds you of that fact.
ja: パッチファイルにファイルのパーミッション情報は保存されないため、パーミッションの変更はソースパッケージに保持されない。そのため警告が表示される。

note: type: textblock
en: This file contains on a single line the format that should be used to build the source package (possible formats are described above).  No leading or trailing spaces are allowed.
ja: このファイルはソースパッケージのビルドの際に使用される形式を記載した 1 行からなる (指定可能な形式は前述のとおり)。前後に空白を入れてはならない。

note: type: textblock
en: Exactly like B<debian/source/options> except that the file is not included in the generated source package.  It can be useful to store a preference tied to the maintainer or to the VCS repository where the source package is maintained.
ja: ファイルが生成されたソースパッケージに含まれない点を除き、B<debian/source/options> とまったく同等である。これはメンテナ固有の設定や、ソースパッケージを管理しているバージョン管理システム固有の設定を保持する際に有用である。

note: type: textblock
en: The point at which field overriding occurs compared to certain standard output field settings is rather confused.
ja: 標準の出力フィールドの設定と比較すると、フィールドの上書きが発生する箇所は混乱を引き起こす。

note: type: textblock
en: dpkg-split - Debian package archive split/join tool
ja: dpkg-split - Debian パッケージアーカイブの分割/統合ツール

note: type: textblock
en: B<dpkg-split> splits Debian binary package files into smaller parts and reassembles them again, to support the storage of large package files on small media such as floppy disks.
ja: B<dpkg-split> は Debian バイナリパッケージのファイルを小さいパートに分割したり、それらを再度統合したりするツールであり、フロッピーディスクのような容量の小さい媒体上に、サイズの大きいパッケージファイルを保管できるようにする。

note: type: textblock
en: It can be operated manually using the B<--split>, B<--join> and B<--info> options.
ja: これは、B<--split>, B<--join>, B<--info> オプションを手動で指定することにより行われる。

note: type: textblock
en: It also has an automatic mode, invoked using the B<--auto> option, where it maintains a queue of parts seen but not yet reassembled and reassembles a package file when it has seen all of its parts.  The B<--listq> and B<--discard> options allow the management of the queue.
ja: B<dpkg-split> には B<--auto> オプションにより実行される自動モードも備わっている。自動モードでは、存在しているがまだ統合されていないパートのキューを管理することで、すべてのパートが確認できた時点でそれらを統合する。キューの管理は、B<--listq> および B<--discard> オプションで行うことができる。

note: type: textblock
en: All splitting, joining and queueing operations produce informative messages on standard output; these may safely be ignored.
ja: 分割、統合、キューイング処理のいずれも、標準出力に有用なメッセージを出力する。これらは無視しても問題ない。

note: type: textblock
en: Splits a single Debian binary package into several parts.
ja: 単一の Debian バイナリパッケージを幾つかのパートに分割する。

note: type: textblock
en: The parts are named I<prefix>B<.>I<N>B<of>I<M>B<.deb> where I<N> is the part number, starting at 1, and I<M> is the total number of parts (both in decimal).
ja: 各パートは、I<prefix>B<.>I<N>B<of>I<M>B<.deb> のように名づけられる。ここで、I<N> は 1 から始まるパート番号であり、I<M> はパートの総数である (いずれも 10 進数である)。

note: type: textblock
en: If no I<prefix> is supplied then the I<complete-archive> filename is taken, including directory, with any trailing B<.deb> removed.
ja: I<prefix> が指定されていない場合は、I<complete-archive> ファイル名が、ディレクトリ部分も含めて用いられるが、末尾の B<.deb> 部分は削除される。

note: type: textblock
en: Joins the parts of a package file together, reassembling the original file as it was before it was split.
ja: パッケージファイルのパート群を集約して、分割前のオリジナルファイルに統合する。

note: type: textblock
en: The part files given as arguments must be all the parts of exactly the same original binary file.  Each part must occur exactly once in the argument list, though the parts to not need to be listed in order.
ja: 引数として指定された各パートのファイルは、オリジナルのバイナリファイルのすべてのパートを含んでいること。パートを順番に並べて指定する必要はないが、同じパートのファイルを複数回指定することはできない。

note: type: textblock
en: The parts must of course all have been generated with the same part size specified at split time, which means that they must usually have been generated by the same invocation of B<dpkg-split --split>.
ja: 各パートは分割時に指定されたサイズが同一である必要がある。これは、通常各パートが単一の B<dpkg-split --split> の実行から生成されることを意味する。

note: type: textblock
en: The parts' filenames are not significant for the reassembly process.
ja: パートのファイル名は、統合処理において重要ではない。

note: type: textblock
en: By default the output file is called I<package>B<_>I<version>B<_>I<arch>B<.deb>.
ja: 生成されたファイルは、デフォルトで I<package>B<_>I<version>B<_>I<arch>B<.deb> というファイル名になる。

note: type: textblock
en: Prints information, in a human-readable format, about the part file(s)  specified.  Arguments which are not binary package parts produce a message saying so instead (but still on standard output).
ja: パートのファイルに関する情報を人が読みやすい形式で表示する。バイナリパッケージのパート以外のファイルが引数で指定された場合は、それを指摘するメッセージを (標準出力に) 代わりに表示する。

note: type: textblock
en: Automatically queue parts and reassemble a package if possible.
ja: 自動的にパートをキューイングして、可能であればパッケージを再統合する。

note: type: textblock
en: The I<part> specified is examined, and compared with other parts of the same package (if any) in the queue of packages file parts.
ja: I<part> で指定されたパートが検査され、同じパッケージファイルのパートのキューにあるパッケージの別のパート (もしあれば) と比較される。

note: type: textblock
en: If all parts of the package file of which I<part> is a part are available then the package is reassembled and written to I<complete-output> (which should not usually already exist, though this is not an error).
ja: I<part> が属するパッケージファイルのすべてのパートが利用可能な場合、パッケージは統合され、I<complete-output> に書き出される (ファイルが既存の場合もエラーとはならないが、通常は推奨されない)。

note: type: textblock
en: If not then the I<part> is copied into the queue and I<complete-output> is not created.
ja: それ以外の場合、I<part> がキューにコピーされ、I<complete-output> は作成されない。

note: type: textblock
en: If I<part> is not a split binary package part then B<dpkg-split> will exit with status B<1>; if some other trouble occurs then it will exit with status B<2>.
ja: I<part> が分割されたバイナリパッケージのパート以外の場合、B<dpkg-split> は戻り値 B<1> で終了する。何らかのトラブルが発生した場合、戻り値 B<2> で終了する。

note: type: textblock
en: The B<--output> or B<-o> option must be supplied when using B<--auto>.  (If this were not mandatory the calling program would not know what output file to expect.)
ja: B<--auto> を使用する場合、B<--output> もしくは B<-o> オプションも指定すること (これを必須にしないと、呼び出したプログラムが出力ファイル名を知る術がなくなってしまう)。

note: type: textblock
en: Lists the contents of the queue of packages to be reassembled.
ja: 統合されるパッケージのキューの内容を一覧表示する。

note: type: textblock
en: For each package file of which parts are in the queue the output gives the name of the package, the parts in the queue, and the total number of bytes stored in the queue.
ja: キューにパートが存在している各パッケージファイルについて、パッケージ名とキューにあるパート、キューに格納されているバイト数が出力される。

note: type: textblock
en: This discards parts from the queue of those waiting for the remaining parts of their packages.
ja: パッケージの残りのパートが揃うまでキューに格納されているパートをキューから削除する。

note: type: textblock
en: If no I<package> is specified then the queue is cleared completely; if any are specified then only parts of the relevant package(s) are deleted.
ja: I<package> が指定されなかった場合、キューは完全に消去される。何らかのパッケージが指定された場合、そのパッケージのパートのみが削除される。

note: type: textblock
en: Specifies the maximum part size when splitting, in kibibytes (1024 bytes).  The default is 450 KiB.
ja: ファイル分割の際のパートの最大サイズを kibibyte (1024 byte) 単位で指定する。デフォルトは 450 KiB である。

note: type: textblock
en: Specifies the output file name for a reassembly.
ja: 統合の際の出力ファイル名を指定する。

note: type: textblock
en: This overrides the default for a manual reassembly (B<--join>)  and is mandatory for an automatic queue-or-reassemble (B<--auto>).
ja: これは、(B<--join> による) 手動統合の際のデフォルトのファイル名に優先する。また、(B<--auto> による) 自動でのキューイングおよび統合の際には必須である。

note: type: textblock
en: When doing automatic queue-or-reassembly B<dpkg-split> usually prints a message if it is given a I<part> that is not a binary package part.  This option suppresses this message, to allow programs such as B<dpkg> to cope with both split and unsplit packages without producing spurious messages.
ja: 自動でのキューイングおよび統合が行われる際、B<dpkg-split> は通常バイナリパッケージのパートでない I<part> が指定されるとメッセージを出力するが、このオプションによりメッセージが抑止され、B<dpkg> のようなプログラムがパッケージの分割や統合を扱う際に、余計なメッセージを出力することが避けられる。

note: type: textblock
en: This mangles the prefix - either the default derived from the input filename or the one supplied as an argument: alphanumerics are lowercased, plus signs are replaced by B<x>'s and all other characters are discarded.
ja: これにより、入力ファイル名から生成されたデフォルト値の prefix、引数として指定された prefix いずれもが切り詰められる。英数字は小文字にされ、プラス記号は B<x> に置き換えられ、その他の文字は破棄される。

note: type: textblock
en: The result is then truncated as much as is necessary, and filenames of the form I<prefixN>B<of>I<M>B<.deb> are generated.
ja: 必要な切り詰めが行われた結果として、I<prefixN>B<of>I<M>B<.deb> 形式のファイル名が生成される。

note: type: textblock
en: The requested split, merge, or other command succeeded.  B<--info> commands count as successful even if the files are not binary package parts.
ja: 要求された分割、統合、その他のコマンドは成功した。B<--info> コマンドはファイルがバイナリパッケージのパートでなかった場合も含め、成功としてカウントする。

note: type: textblock
en: Only occurs with B<--auto> and indicates that the I<part> file was not a binary package part.
ja: B<--auto> の場合のみ発生し、I<part> ファイルがバイナリパッケージのパートではなかったことを示す。

note: type: textblock
en: The default queue directory for part files awaiting automatic reassembly.
ja: パートを構成するファイルが自動統合を待機するデフォルトのキューディレクトリ。

note: type: textblock
en: The filenames used in this directory are in a format internal to B<dpkg-split> and are unlikely to be useful to other programs, and in any case the filename format should not be relied upon.
ja: このディレクトリ内のファイル名は B<dpkg-split> の内部形式となっており、その他のプログラムから参照されることを想定していない。いかなる場合もファイル名の形式に依存すべきではない。

note: type: textblock
en: Full details of the packages in the queue are impossible to get without digging into the queue directory yourself.
ja: キューにあるパッケージの詳細は、キューディレクトリを自分で調べない限り確認することができない。

note: type: textblock
en: There is no easy way to test whether a file that may be a binary package part is one.
ja: ファイルがバイナリパッケージのパートかどうかを簡単に確認する手段が存在しない。

note: type: textblock
en: dpkg-statoverride - override ownership and mode of files
ja: dpkg-statoverride - ファイルの所有権やモードを変更する

note: type: textblock
en: B<dpkg-statoverride> is a utility to manage the list of stat overrides.  It has three basic functions: adding, removing and listing overrides.
ja: B<dpkg-statoverride> は stat override のリストを管理するユーティリティである。これには override を追加、削除、表示するという 3 つの基本機能がある。

note: type: textblock
en: Be less verbose about what we do.
ja: 動作に関して多くの出力を行わない。

note: type: textblock
en: dpkg-trigger - a package trigger utility
ja: dpkg-trigger - パッケージトリガユーティリティ

note: type: textblock
en: B<dpkg-trigger> is a tool to explicitly activate triggers and check for its support on the running B<dpkg>.
ja: B<dpkg-trigger> は、トリガを明示的に有効化したり、B<dpkg> の実行時に、トリガのサポートをチェックしたりするツールである。

note: type: textblock
en: This can be used by maintainer scripts in complex and conditional situations where the file triggers, or the declarative B<activate> triggers control file directive, are insufficiently rich.  It can also be used for testing and by system administrators (but note that the triggers won't actually be run by B<dpkg-trigger>).
ja: これは、ファイルトリガや宣言された B<有効化した>トリガ制御ファイルのディレクティブが不十分であるような、複雑で条件付きの判定を行うような場合に、メンテナスクリプトによって使用される。また、これはテスト時やシステム管理者からも使用できる (ただし、B<dpkg-trigger> はトリガ自体を実行するものではないことに注意)。

note: type: textblock
en: Unrecognized trigger name syntaxes are an error for B<dpkg-trigger>.
ja: トリガ名の文法が認識されなかった場合、B<dpkg-trigger> はエラーとなる。

note: type: textblock
en: Check if the running B<dpkg> supports triggers (usually called from a postinst).  Will exit B<0> if a triggers-capable B<dpkg> has run, or B<1> with an error message to stderr if not.  Normally, however, it is better just to activate the desired trigger with B<dpkg-trigger>.
ja: 実行中の B<dpkg> がトリガをサポートしているかをチェックする (通常これはpostinst から呼び出される)。トリガを実行可能な B<dpkg> が実行中の場合は、 B<0> が返却され、それ以外の場合は B<1> が返却されるとともに、標準エラー出力にエラーメッセージが出力される。ただし、普通の使い方としては、単にB<dpkg-trigger> を用いて使用したいトリガを有効化することが望ましい。

note: type: textblock
en: Override trigger awaiter (normally set by B<dpkg> through the B<DPKG_MAINTSCRIPT_PACKAGE> environment variable of the maintainer scripts, naming the package to which the script belongs, and this will be used by default).
ja: トリガを待機するパッケージ名 (通常メンテナスクリプトの B<DPKG_MAINTSCRIPT_PACKAGE> 環境変数を通じて B<dpkg> によってスクリプトが含まれるパッケージ名に設定され、デフォルトでこの名前が用いられる) を上書きする。

note: type: textblock
en: Just test, do not actually change anything.
ja: テスト用、実際にはいかなる変更も行わない。

note: type: textblock
en: dpkg-vendor - queries information about distribution vendors
ja: dpkg-vendor - 配布ベンダに関する情報をクエリする

note: type: textblock
en: Print on standard output the value of the vendor-specific I<field> for the current vendor.
ja: 標準出力に、現在のベンダのベンダ固有の I<field> の値を出力する。

note: type: textblock
en: Assumes the current vendor is I<vendor> instead of discovering it with the B<DEB_VENDOR> environment variable or B<%PKGCONFDIR%/origins/default>.
ja: 現在のベンダが、B<DEB_VENDOR> 環境変数や B<%PKGCONFDIR%/origins/default> から確認された値ではなく、I<vendor> であると見なす。

note: type: textblock
en: dpkg.cfg - dpkg configuration file
ja: dpkg.conf - dpkg の設定ファイル

note: type: textblock
en: dpkg - package manager for Debian
ja: dpkg - Debian パッケージマネージャ

note: type: =head1
en: WARNING
ja: 警告

note: type: textblock
en: This manual is intended for users wishing to understand B<dpkg>'s command line options and package states in more detail than that provided by B<dpkg --help>.
ja: このマニュアルは、B<dpkg> のコマンドラインオプションやパッケージ状態について、B<dpkg --help> よりも、さらに詳細に理解したいユーザを対象としている。

note: type: textblock
en: It should I<not> be used by package maintainers wishing to understand how B<dpkg> will install their packages.  The descriptions of what B<dpkg> does when installing and removing packages are particularly inadequate.
ja: B<dpkg> がパッケージをどのようにインストールするかを理解したいというパッケージのメンテナを対象としたものではない。特に、パッケージのインストールや削除の際の B<dpkg> の挙動に関する説明が不足している。

note: type: =head1
en: INFORMATION ABOUT PACKAGES
ja: パッケージに関する情報

note: type: textblock
en: B<dpkg> maintains some usable information about available packages.  The information is divided in three classes: B<states>, B<selection states> and B<flags>.  These values are intended to be changed mainly with B<dselect>.
ja: B<dpkg> は利用可能なパッケージに関して、いくばくかの有用な情報を管理している。情報は、B<ステータス>、B<パッケージ選択状態>、B<フラグ>の 3 つに分類でき、主にB<dselect> によって変更されることが想定されている。

note: type: textblock
en: The package is not installed on your system.
ja: パッケージはシステムにインストールされていない。

note: type: textblock
en: The installation of the package has been started, but not completed for some reason.
ja: パッケージのインストールは開始しているが、何らかの理由で完了していない。

note: type: textblock
en: The package is unpacked, but not configured.
ja: パッケージは展開されたが、まだ設定されていない。

note: type: textblock
en: The package is unpacked and configuration has been started, but not yet completed for some reason.
ja: パッケージは展開されて設定も開始しているが、何らかの理由によって完了していない。

note: type: textblock
en: The package awaits trigger processing by another package.
ja: パッケージは別のパッケージによるトリガ処理を待機している。

note: type: textblock
en: The package has been triggered.
ja: パッケージはトリガされている。

note: type: textblock
en: The package is selected for installation.
ja: パッケージはインストールするように選択されている。

note: type: textblock
en: The package is selected for deinstallation (i.e. we want to remove all files, except configuration files).
ja: パッケージは deinstallation (設定ファイルを除くすべてのファイルを削除) するように選択されている

note: type: textblock
en: The package is selected to be purged (i.e. we want to remove everything from system directories, even configuration files).
ja: パッケージは完全削除 (設定ファイルも含めたすべてのファイルを削除) するように選択されている。

note: type: =head1
en: ACTIONS
ja: アクション

note: type: textblock
en: Install the package.  If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
ja: パッケージをインストールする。B<--recursive> または B<-R> オプションが指定されていた場合、I<package-file> としてファイルではなくディレクトリを指定すること。

note: type: textblock
en: Installation consists of the following steps:
ja: インストールは、以下のステップで構成されている。

note: type: textblock
en: Unpack the package, but don't configure it.  If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
ja: パッケージを展開するが、設定はしない。B<--recursive> または B<-R> オプションが指定されていた場合、I<package-file> としてファイルではなくディレクトリを指定すること。

note: type: textblock
en: Configure a package which has been unpacked but not yet configured.  If B<-a> or B<--pending> is given instead of I<package>, all unpacked but unconfigured packages are configured.
ja: 展開済だが未設定のパッケージを設定する。package の代わりに B<-a> もしくはB<--pending> を指定した場合は、展開済だが未設定のパッケージすべてを設定する。

note: type: textblock
en: Configuring consists of the following steps:
ja: 設定は、以下のステップで構成されている。

note: type: textblock
en: Removing of a package consists of the following steps:
ja: パッケージの削除は以下のステップで構成されている:

note: type: textblock
en: A simpler one-shot command to retrieve and update the I<available> file is B<dselect update>.  Note that this file is mostly useless if you don't use B<dselect> but an APT-based frontend: APT has its own system to keep track of available packages.
ja: I<available> ファイルを取得し更新する簡便なコマンドが B<dselect update> である。このファイルは B<dselect> の代わりに APT ベースのフロントエンドを使用する場合はほとんど無意味である。APT は利用可能なパッケージを管理するシステムを独自に保持しているためである。

note: type: textblock
en: Update B<dpkg> and B<dselect>'s idea of which packages are available with information from the package I<package-file>.  If B<--recursive> or B<-R> option is specified, I<package-file> must refer to a directory instead.
ja: B<dpkg> や B<dselect> が管理する利用可能なパッケージの情報を、I<package-file> で指定したパッケージの情報で更新する。B<--recursive> または B<-R> オプションが指定されていた場合、I<package-file> としてファイルではなくディレクトリを指定すること。

note: type: textblock
en: Erase the existing information about what packages are available.
ja: 利用可能なパッケージについての情報を消去する。

note: type: textblock
en: Searches for packages selected for installation, but which for some reason still haven't been installed.
ja: インストールするために選択されたが、何らかの理由でまだインストールされていないパッケージを検索する。

note: type: textblock
en: Display a brief help message.
ja: オプションに関する簡単なヘルプを表示する。

note: type: textblock
en: Give help about the B<--force->I<thing> options.
ja: B<--force->I<thing> オプションに関するヘルプを表示する。

note: type: textblock
en: Give help about debugging options.
ja: デバッグ用オプションに関するヘルプを表示する。

note: type: textblock
en: Display B<dpkg> version information.
ja: B<dpkg> のバージョン情報を表示する。

note: type: textblock
en: Change after how many errors B<dpkg> will abort.  The default is 50.
ja: B<dpkg> の処理を中断させるエラー数を変更する。デフォルトは 50 である。

note: type: textblock
en: When a package is removed, there is a possibility that another installed package depended on the removed package.  Specifying this option will cause automatic deconfiguration of the package which depended on the removed package.
ja: パッケージを削除するとき、削除するパッケージに依存した別のパッケージがインストールされている場合がある。このオプションを指定すると、削除するパッケージに依存しているパッケージの設定を自動的に取り消す。

note: type: textblock
en: Force or refuse (B<no-force> and B<refuse> mean the same thing)  to do some things.  I<things> is a comma separated list of things specified below.  B<--force-help> displays a message describing them.  Things marked with (*) are forced by default.
ja: 指定した I<things> を強制実行 (force) もしくは拒否 (refuse) する (B<no-force>と B<refuse> は同じ意味) 。I<things> には、以下の項目をコンマで区切って列挙する。これらの項目は B<--force-help> オプションで表示される。(*) マークのあるものは、デフォルトで強制実行される。

note: type: textblock
en: I<Note>: For ext4, the main offender, consider using instead the mount option B<nodelalloc>, which will fix both the performance degradation and the data safety issues, the latter by making the file system not produce zero-length files on abrupt system crashes with any software not doing syncs before atomic renames.
ja: I<注記>: この事象の主たる発生元である ext4 では、本オプションの代わりにマウントオプション B<nodelalloc> の使用を検討してほしい。これはパフォーマンスの低下を抑えつつ、データを安全に扱うことができる。後者は、ファイルシステム上において、アトミックな rename 処理の前に同期を行わないソフトウェアが、突然のシステム停止の際に 0 バイト長のファイルを作成できないようにすることで実現している。

note: type: textblock
en: Do everything which is supposed to be done, but don't write any changes.  This is used to see what would happen with the specified action, without actually modifying anything.
ja: 実行されるべき処理をすべて行うが、いかなる変更も書き込まない。これは、一切変更を行わずに、指定したアクションによって何が起こるかを確認する際に用いられる。

note: type: textblock
en: Don't install a package if a newer version of the same package is already installed.  This is an alias of B<--refuse-downgrade>.
ja: インストール済のパッケージのバージョンの方が新しければ、パッケージをインストールしない。これは B<--refuse-downgrade> の別名である。

note: type: textblock
en: Only process the packages that are selected for installation.  The actual marking is done with B<dselect> or by B<dpkg>, when it handles packages.  For example, when a package is removed, it will be marked selected for deinstallation.
ja: インストール対象として選択されたパッケージのみを処理する。選択のマーク付けそのものは、B<dselect> や B<dpkg> を使って行なう。例えば、パッケージ削除の際には、パッケージは削除対象としてマーク付けがされる。

note: type: textblock
en: This can be used to remove all paths except some particular ones; a typical case is:
ja: これは、特定のパス以外のパスをすべて除外するために使用することができる。典型的な例を以下に示す:

note: type: textblock
en: to remove all documentation files except the copyright files.
ja: これは、copyright ファイル以外のすべてのドキュメントファイルを削除する。

note: type: textblock
en: These two options can be specified multiple times, and interleaved with each other.  Both are processed in the given order, with the last rule that matches a file name making the decision.
ja: この 2 つのオプションは複数回指定することができ、交互に指定していくことも可能である。その場合は指定された順番どおりに処理が行われ、ファイル名に対して最後にマッチしたルールによって、処理が決定する。

note: type: textblock
en: Send machine-readable package status and progress information to file descriptor I<n>.  This option can be specified multiple times.  The information is generally one record per line, in one of the following forms:
ja: コンピュータが解釈可能な形式のパッケージの状態と処理の進行状況に関する情報とをファイルディスクリプタ I<n> に引き渡す。このオプションは複数回指定することができる。情報は通常 1 行に 1 レコードずつ、以下のいずれかの形式で記載される:

note: type: textblock
en: Package status changed; I<status> is as in the status file.
ja: パッケージのステータスが変更された。I<status> が新しいステータスである。

note: type: textblock
en: An error occurred.  Any possible newlines in I<extended-error-message> will be converted to spaces before output.
ja: エラーが発生した。I<extended-error-message> 中の改行は、出力の前に空白文字に置き換えられる。

note: type: textblock
en: User is being asked a conffile question.
ja: ユーザは設定ファイルの処理に関する確認をされている。

note: type: textblock
en: Sent just before a processing stage starts.  I<stage> is one of B<upgrade>, B<install> (both sent before unpacking), B<configure>, B<trigproc>, B<disappear>, B<remove>, B<purge>.
ja: stage に関する処理が開始される前に送信される。I<stage> は、B<upgrade>, B<install> (いずれも展開が開始される前に送信される), B<configure>, B<trigproc>, B<disappear>, B<remove>, B<purge> のいずれかになる。

note: type: textblock
en: Do not try to verify package signatures.
ja: パッケージの署名を確認しない。

note: type: textblock
en: If set, B<dpkg> will use it as the directory from which to read the user specific configuration file.
ja: 設定されていた場合、B<dpkg> は、変数の値をユーザ固有の設定ファイルの参照先のディレクトリとして使用する。

note: type: textblock
en: If set, B<dpkg> will use it as the directory in which to create temporary files and directories.
ja: 設定されていた場合、B<dpkg> は、変数の値を一時ファイルおよびディレクトリを作成するディレクトリとして使用する。

note: type: textblock
en: Configuration file with default options.
ja: オプションのデフォルト値を記述する設定ファイル。

note: type: textblock
en: The other files listed below are in their default directories, see option B<--admindir> to see how to change locations of these files.
ja: 以下のファイルのパスは、デフォルトのディレクトリ配下に存在している場合である。ファイルの位置を変更する方法については、B<--admindir> オプションを参照すること。

note: type: textblock
en: List of available packages.
ja: 使用できるパッケージの一覧。

note: type: textblock
en: B<--no-act> usually gives less information than might be helpful.
ja: B<--no-act> の提供する情報はたいていの場合、不充分である。

note: type: textblock
en: To see the entries in I<%ADMINDIR%/available> of two packages:
ja: 2 つのパッケージに関して、I<%ADMINDIR%/available> にある項目を表示する。

note: type: textblock
en: To search the listing of packages yourself:
ja: パッケージの一覧を自分で検索する。

note: type: textblock
en: To make a local copy of the package selection states:
ja: パッケージ選択状況のコピーを作成する。

note: type: textblock
en: Note that this will not actually install or remove anything, but just set the selection state on the requested packages.  You will need some other application to actually download and install the requested packages.  For example, run B<apt-get dselect-upgrade>.
ja: これは実際にはインストールも削除もせずに、単に要求しているパッケージの選択状態を設定するだけであることに注意。要求しているパッケージを実際にダウンロード、インストールするには別のアプリケーションが必要である。例えば、B<apt-get dselect-upgrade> を実行する。

note: type: =head1
en: ADDITIONAL FUNCTIONALITY
ja: 追加機能

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

note: type: textblock
en: See I<%PKGDOCDIR%/THANKS> for the list of people who have contributed to B<dpkg>.
ja: B<dpkg> に貢献した人の一覧については、I<%PKGDOCDIR%/THANKS> を参照のこと。

note: type: textblock
en: dselect.cfg - dselect configuration file
ja: dselect.cfg - dselect の設定ファイル

note: type: textblock
en: dselect - Debian package management frontend
ja: dselect - Debian パッケージ管理フロントエンド

note: type: textblock
en: Turn on debugging.  Debugging information is sent to I<file>.
ja: デバッグを有効にする。デバッグ情報は I<file> に送られる。

note: type: textblock
en: Turns on expert mode, i.e. doesn't display possibly annoying help messages.
ja: エキスパートモードを有効にする。つまり、煩雑なヘルプを表示しない。

note: type: textblock
en: Configures screen colors.  This works only if your display supports colors.  This option may be used multiple times (and is best used in I<dselect.cfg>).  Each use changes the color (and optionally, other attributes) of one part of the screen.  The parts of the screen (from top to bottom) are:
ja: 表示色を設定する。ディスプレイがカラー表示をサポートしている場合に有効である。このオプションは、複数回指定できる ( I<dselect.cfg> での使用が推奨されている)。各設定ごとに、画面のある部位の色 (や他の属性) が変更される。画面の部位の名称は (上から順に) 次のとおり:

note: type: textblock
en: The screen title.
ja: 画面タイトル

note: type: textblock
en: The header line above the list of packages.
ja: パッケージリストの上部にあるヘッダライン

note: type: textblock
en: The scrolling list of packages (and also some help text).
ja: パッケージリストのスクロール領域 (ヘルプも表示される)

note: type: textblock
en: The selected item in the list.
ja: リスト内の選択行

note: type: textblock
en: In the list of packages, the text indicating the current state of each package.
ja: パッケージリスト内で、各パッケージの状況を示すテキスト

note: type: textblock
en: In the list of packages, the text indicating the current state of the currently selected package.
ja: パッケージリスト内で、選択したパッケージの状況を示すテキスト

note: type: textblock
en: The header line that displays the state of the currently selected package.
ja: 現在選択しているパッケージの状況を表示するヘッダ行

note: type: textblock
en: The package's short description.
ja: パッケージの短い説明文

note: type: textblock
en: Used to display package info such as the package's description.
ja: パッケージの説明などパッケージの情報を表示するために用いられる

note: type: textblock
en: The last line of the screen when selecting packages.
ja: パッケージ選択時の画面最下行

note: type: textblock
en: Used to display query lines
ja: クエリ行を表示するために用いられる

note: type: textblock
en: Color of help screens.
ja: ヘルプ画面の色

note: type: textblock
en: After the part of the screen comes a colon and the color specification.  You can specify either the foreground color, the background color, or both, overriding the compiled-in colors.  Use standard curses color names.
ja: 画面の部位を示すキーワードの後に、コロンに続き色設定を記述する。前景色、背景色、あるいは両方を指定でき、コンパイル時に指定した色設定に優先する。標準の curses 色名称を使用すること。

note: type: textblock
en: Print a brief help text and exit successfully.
ja: 簡単なヘルプを表示し、正常終了する。

note: type: textblock
en: Print version information and exit successfully.
ja: バージョン情報を表示し、正常終了する。

note: type: =head2
en: access
ja: アクセス (access)

note: type: textblock
en: Choose and configure an access method to access package repositories.
ja: パッケージリポジトリにアクセスするアクセス方式を選択、設定する。

note: type: textblock
en: The use of the I<apt> access method is strongly recommended.
ja: I<apt> アクセス方式の使用を、強く推奨する。

note: type: =head2
en: update
ja: 更新 (update)

note: type: textblock
en: Refresh the available packages database.
ja: 取得可能パッケージのデータベースを更新する。

note: type: =head2
en: select
ja: 選択 (select)

note: type: textblock
en: View or manage package selections and dependencies.
ja: パッケージの選択や依存関係の表示、管理を行う。

note: type: textblock
en: This is the main function of B<dselect>.  In the select screen, the user can review a list of all available and installed packages.  When run with administrator privileges, it is also possible to interactively change packages selection state.  B<dselect> tracks the implications of these changes to other depending or conflicting packages.
ja: これは B<dselect> の主たる機能である。この画面で取得可能なパッケージやインストール済パッケージリストを確認できる。管理者権限で実行すると、対話的にパッケージの選択状況を変更することもできる。 B<dselect> は、変更に伴って発生する依存、競合パッケージについても検出する。

note: type: textblock
en: When a conflict or failed depends is detected, a dependency resolution subscreen is prompted to the user.  In this screen, a list of conflicting or depending packages is shown, and for each package listed, the reason for its listing is shown.  The user may apply the suggestions proposed by B<dselect>, override them, or back out all the changes, including the ones that created the unresolved depends or conflicts.
ja: 競合や解決できない依存関係を検出すると、依存関係解決サブ画面をユーザに提示する。この画面では、競合パッケージや依存パッケージのリストが、その理由とともに表示される。ユーザは、B<dselect> が提案した変更案を適用してもよいし、その案を修正してもよい。また、解決できない依存関係や競合を発生させた変更を含む、すべての変更を元に戻すこともできる。

note: type: textblock
en: The use of the interactive package selections management screen is explained in more detail below.
ja: 対話的なパッケージ選択管理画面の詳細な使い方については後述する。

note: type: =head2
en: install
ja: 導入 (install)

note: type: textblock
en: Installs selected packages.
ja: 選択したパッケージをインストールする。

note: type: textblock
en: The configured access method will fetch installable or upgradable packages from the relevant repositories and install these using B<dpkg>.  Depending on the implementation of the access method, all packages can be prefetched before installation, or fetched when needed.  Some access methods may also remove packages that were marked for removal.
ja: 新規インストール、更新が可能なパッケージを、設定したアクセス方式で適切なリポジトリより取得し、 B<dpkg> を用いてインストールを行う。インストール前にパッケージをすべて取得するか、必要な時に取得するかは、アクセス方式の実装によって異なる。アクセス方式によって、削除マークをつけたパッケージの削除を行う場合もある。

note: type: =head2
en: config
ja: 設定 (config)

note: type: textblock
en: Configures any previously installed, but not fully configured packages.
ja: すでにインストール済みだが、設定が完了していないパッケージの設定を行う。

note: type: =head2
en: remove
ja: 削除 (remove)

note: type: textblock
en: Removes or purges installed packages, that are marked for removal.
ja: 削除マークをつけたインストール済パッケージの削除や完全削除を行う。

note: type: =head2
en: quit
ja: 終了 (quit)

note: type: =head2
en: Introduction
ja: 概要

note: type: =head2
en: Screen layout
ja: 画面レイアウト

note: type: textblock
en: The select screen is by default split in a top and a bottom half.  The top half shows a list of packages.  A cursor bar can select an individual package, or a group of packages, if applicable, by selecting the group header.  The bottom half of the screen shows some details about the package currently selected in the top half of the screen.  The type of detail that is displayed can be varied.
ja: 選択画面は、デフォルトで上下 2 分割されている。上半分はパッケージのリストを表示している。カーソルバーで個々のパッケージを選択したり、グループヘッダ (存在していれば) を選択して、パッケージグループを選択したりできる。画面の下半分は、画面の上半分で現在選択しているパッケージの詳細が表示される。表示される詳細の形式は変更できる。

note: type: =head2
en: Package details view
ja: パッケージ詳細表示

note: type: textblock
en: In a dependency resolution screen, there is also the possibility of viewing the specific unresolved depends or conflicts related to the package and causing it to be listed.
ja: 依存関係解決画面で、特定のパッケージに関連する未解決な依存関係、競合関係が、その原因とともに表示される場合もある。

note: type: =head2
en: Packages status list
ja: パッケージ状況リスト

note: type: textblock
en: The shorthand status indication consists of four parts: an error flag, which should normally be clear, the current status, the last selection state and the current selection state.  The first two relate to the actual state of the package, the second pair are about the selections set by the user.
ja: 簡略表示における状況は、エラーフラグ (通常クリアされている)、現在の状況、現在の選択状況、新規の選択状況の 4 パートからなる。始めの 2 つはパッケージの現在の状況を表し、後の 2 つはユーザが設定した選択状況を示している。

note: type: =head2
en: Cursor and screen movement
ja: カーソルおよび画面移動

note: type: textblock
en: The package selection list and the dependency conflict resolution screens can be navigated using motion commands mapped to the following keys:
ja: パッケージ選択リストや依存、競合関係解決画面では、以下のキーに割当てられた移動コマンドで操作することができる。

note: type: =head2
en: Searching and sorting
ja: 検索とソート

note: type: textblock
en: Where not listed above explicitly, alphabetic order is used as the final subordering sort key.
ja: 上記リストには明記されていないが、最終的にアルファベット順でのソートが行われる。

note: type: =head2
en: Altering selections
ja: 選択の変更

note: type: textblock
en: When the change request results in one or more unsatisfied depends or conflicts, B<dselect> prompts the user with a dependency resolution screen.  This will be further explained below.
ja: 変更の結果、依存関係を充足できなかったり競合したりした場合、 B<dselect> は依存関係解決画面を表示する。これは後ほど説明する。

note: type: textblock
en: It is also possible to apply these commands to groups of package selections, by pointing the cursor bar onto a group header.  The exact grouping of packages is dependent on the current list ordering settings.
ja: グループヘッダ上にカーソルバーを移動して、パッケージ選択のグループにコマンドを適用することもできる。現在のリストのソート順設定によっては、パッケージのグループ化が適切に行われない場合がある。

note: type: textblock
en: Proper care should be taken when altering large groups of selections, because this can instantaneously create large numbers of unresolved depends or conflicts, all of which will be listed in one dependency resolution screen, making them very hard to handle.  In practice, only hold and unhold operations are useful when applied to groups.
ja: 大規模なグループの選択状況を変更する場合は、大量の未解決な依存、競合関係が一度に発生するため、十分注意すべきである。 これらは 1 つの依存関係解決画面にリストされることとなるため、これを操作するのは非常に難しい。グループに対する変更が実用的なのは、保留や保留解除の時ぐらいである。

note: type: =head2
en: Resolving depends and conflicts
ja: 依存・競合関係の解決

note: type: textblock
en: When the change request results in one or more unsatisfied depends or conflicts, B<dselect> prompts the user with a dependency resolution screen.  First however, an informative help screen is displayed.
ja: 選択状況の変更により未解決の依存・競合関係が発生した場合、 B<dselect> は依存関係解決画面を表示する。なお、表示の前にヘルプ画面が表示される。

note: type: textblock
en: The top half of this screen lists all the packages that will have unresolved depends or conflicts, as a result of the requested change, and all the packages whose installation can resolve any of these depends or whose removal can resolve any of the conflicts.  The bottom half defaults to show the depends or conflicts that cause the currently selected package to be listed.
ja: この画面の上半分には、選択された変更の結果として発生した未解決の依存、競合関係があるパッケージに加え、インストールすることで依存関係を解決するパッケージ、削除することで競合を解決するパッケージがすべて表示される。下半分には、現在選択されているパッケージが原因となっている依存や競合関係がデフォルトで表示される。

note: type: textblock
en: When the sublist of packages is displayed initially, B<dselect> may have already set the requested selection status of some of the listed packages, in order to resolve the depends or conflicts that caused the dependency resolution screen to be displayed.  Usually, it is best to follow up the suggestions made by B<dselect>.
ja: パッケージのサブリストの初期表示の時点で、B<dselect> は、依存関係解決画面の表示を引き起こしている依存や競合関係を解決するよう、リストしたパッケージの選択状況の一部をあらかじめ変更している場合がある。通常、B<dselect> による提案を採用するのが最良である。

note: type: =head2
en: Establishing the requested selections
ja: 選択された変更の確定

note: type: textblock
en: By pressing B<enter>, the currently displayed set of selections is accepted.  If B<dselect> detects no unresolved depends as a result of the requested selections, the new selections will be set.  However, if there are any unresolved depends, B<dselect> will again prompt the user with a dependency resolution screen.
ja: B<enter> を押すことで、現在表示されている選択を確定する。選択された変更に起因する未解決の依存関係が検出されない限り、B<dselect> は新しい選択を設定する。未解決の依存関係が存在する場合、 B<dselect> は依存関係解決画面を改めて表示する。

note: type: textblock
en: If set, B<dselect> will use it as the directory from which to read the user specific configuration file.
ja: 設定されていると、B<dselect> はその値をユーザ固有の設定ファイルを読み込むディレクトリとして使用する。

note: type: textblock
en: The B<dselect> package selection interface is confusing to some new users.  Reportedly, it even makes seasoned kernel developers cry.
ja: 始めて B<dselect> を使うユーザの中には、このパッケージ選択インタフェースに混乱する者もいる。聞くところによると、経験を積んだカーネル開発者ですら、これに悩まされている。

note: type: textblock
en: The documentation is lacking.
ja: ドキュメントが不足している。

note: type: textblock
en: There is no help option in the main menu.
ja: メインメニューにヘルプオプションがない。

note: type: textblock
en: The visible list of available packages cannot be reduced.
ja: 取得可能パッケージのリスト表示を減らせない。

note: type: textblock
en: start-stop-daemon - start and stop system daemon programs
ja: start-stop-daemon - システムデーモンプログラムの起動、停止

note: type: textblock
en: B<start-stop-daemon> is used to control the creation and termination of system-level processes.  Using one of the matching options, B<start-stop-daemon> can be configured to find existing instances of a running process.
ja: B<start-stop-daemon> はシステムレベルのプロセスの生成や停止を制御するために使用される。また、 適切なオプションを指定することで、実行中のプロセスを確認することができる。

note: type: textblock
en: Check for the existence of a specified process.  If such a process exists, B<start-stop-daemon> does nothing, and exits with error status 1 (0 if B<--oknodo> is specified).  If such a process does not exist, it starts an instance, using either the executable specified by B<--exec> or, if specified, by B<--startas>.  Any arguments given after B<--> on the command line are passed unmodified to the program being started.
ja: 指定されたプロセスの存在を確認する。該当するプロセスが存在する場合、 B<start-stop-daemon> は何もせず、エラーステータス 1 を返して終了する (B<--oknodo> が指定された場合は、0 を返す)。該当するプロセスが存在しない場合、 B<--exec> により、もしくは B<--startas> が指定された場合はこれにより指定される実行ファイルを起動する。コマンドライン上で B<--> 以降に与えられた任意の引数は起動されるプログラムにそのまま引き渡される。

note: type: textblock
en: Checks for the existence of a specified process.  If such a process exists, B<start-stop-daemon> sends it the signal specified by B<--signal>, and exits with error status 0.  If such a process does not exist, B<start-stop-daemon> exits with error status 1 (0 if B<--oknodo> is specified).  If B<--retry> is specified, then B<start-stop-daemon> will check that the process(es) have terminated.
ja: 指定されたプロセスの存在を確認する。該当するプロセスが存在する場合、 B<start-stop-daemon> は B<--signal> により指定されたシグナルをそのプロセスに送り、エラーステータス 0 を返して終了する。該当するプロセスが存在しない場合、 B<start-stop-daemon> はエラーステータス 1 を返して終了する( B<--oknodo> が指定された場合は 0 を返す)。B<--retry> を指定した場合、B<start-stop-daemon> はそのプロセスが終了したことを確認する。

note: type: textblock
en: Show usage information and exit.
ja: 使用方法に関する情報を表示し、終了する。

note: type: textblock
en: Show the program version and exit.
ja: バージョンと著作権に関する情報を表示し、終了する。

note: type: textblock
en: Change to I<group> or I<gid> when starting the process.
ja: プロセスを開始する時点で、I<group> や I<gid> を変更する。

note: type: textblock
en: With B<--stop>, specifies the signal to send to processes being stopped (default TERM).
ja: B<--stop> と同時に指定することで、プロセスを停止するために送信するシグナルを指定する (デフォルトは TERM)。

note: type: textblock
en: With B<--stop>, specifies that B<start-stop-daemon> is to check whether the process(es)  do finish.  It will check repeatedly whether any matching processes are running, until none are.  If the processes do not exit it will then take further action as determined by the schedule.
ja: B<--stop> と同時に指定することで、B<start-stop-daemon> にプロセスの終了を確認させる。これにより、マッチした実行中のプロセスが全て終了するまで繰り返し確認が行われる。プロセスが終了しなければ、スケジュールにより指定されたアクションが実行される。

note: type: textblock
en: If I<timeout> is specified instead of I<schedule>, then the schedule I<signal>B</>I<timeout>B</KILL/>I<timeout> is used, where I<signal> is the signal specified with B<--signal>.
ja: I<schedule> のかわりに I<timeout> が指定されている場合、 I<signal>B</>I<timeout>B</KILL/>I<timeout> スケジュールが使われる。ここで I<signal> は B<--signal> で指定されるシグナルである。

note: type: textblock
en: I<schedule> is a list of at least two items separated by slashes (B</>); each item may be B<->I<signal-number> or [B<->]I<signal-name>, which means to send that signal, or I<timeout>, which means to wait that many seconds for processes to exit, or B<forever>, which means to repeat the rest of the schedule forever if necessary.
ja: スケジュール I<schedule> は、スラッシュ (B</>) で区切られた少なくとも 2 つの要素からなるリストである。それぞれの要素は、B<->I<signal-number> もしくは [B<->]I<signal-name> の場合は送るべきシグナル、 I<timeout> の場合はプロセスが終了するのを待つ秒数、 B<forever> の場合は必要な限り、残りの I<schedule> を繰り返し適用することを意味する。

note: type: textblock
en: If the end of the schedule is reached and B<forever> is not specified, then B<start-stop-daemon> exits with error status 2.  If a schedule is specified, then any signal specified with B<--signal> is ignored.
ja: I<schedule> が終了し、B<forever> が指定されていない場合、 B<start-stop-daemon> はエラー状態 2 で終了する。schedule が指定されている場合、B<--signal> で指定したシグナルは無視される。

note: type: textblock
en: With B<--start>, start the process specified by I<pathname>.  If not specified, defaults to the argument given to B<--exec>.
ja: B<--start> と同時に指定することで、I<pathname> により指定されるプロセスを起動する。このオプションが指定されない場合、 B<--exec> に与えられる引数がデフォルトになる。

note: type: textblock
en: Print actions that would be taken and set appropriate return value, but take no action.
ja: 実行しようとする処理内容を出力し，それに伴い適切な返り値が設定されるが、実際の処理は行わない。

note: type: textblock
en: Return exit status 0 instead of 1 if no actions are (would be) taken.
ja: 処理が何も行われない (又は、行なわれないと想定される) 場合、終了ステータス 1 のかわりに 0 を返す。

note: type: textblock
en: Do not print informational messages; only display error messages.
ja: 情報メッセージを出力しない。エラーメッセージのみ出力する。

note: type: textblock
en: This alters the priority of the process before starting it.
ja: プロセスを起動する前にプロセスのプライオリティを変更する。

note: type: textblock
en: Print verbose informational messages.
ja: 詳細な情報を出力する。

note: type: textblock
en: The requested action was performed.  If B<--oknodo> was specified, it's also possible that nothing had to be done.  This can happen when B<--start> was specified and a matching process was already running, or when B<--stop> was specified and there were no matching processes.
ja: 指定されたアクションが実行された。B<--oknodo> が指定された場合、何も行われなかった場合も意味する。これは、B<--start> が指定されたがマッチするプロセスが実行されていた場合、B<--stop> が指定されたがマッチするプロセスが存在しなかった場合に発生しうる。

note: type: textblock
en: If B<--oknodo> was not specified and nothing was done.
ja: B<--oknodo> が指定されなかった場合に、何も行われなかった。

note: type: textblock
en: If B<--stop> and B<--retry> were specified, but the end of the schedule was reached and the processes were still running.
ja: B<--stop> および B<--retry> が指定されたが、規定時間の最後まで到達したにも関わらず、プロセスがまだ実行されている。

note: type: textblock
en: Any other error.
ja: その他のエラー。

note: type: textblock
en: When using the B<--status> command, the following status codes are returned:
ja: B<--status> コマンドを実行した際には、以下の戻り値が返される:

note: type: textblock
en: Program is running.
ja: プログラムは実行中である。

note: type: textblock
en: Program is not running and the pid file exists.
ja: プログラムは実行中でないが、pid ファイルが存在している。

note: type: textblock
en: Program is not running.
ja: プログラムは実行中でない。

note: type: textblock
en: Unable to determine program status.
ja: プログラムの状況を確認できない。

note: type: textblock
en: Start the B<food> daemon, unless one is already running (a process named food, running as user food, with pid in food.pid):
ja: 既に実行中でない場合に、B<food> デーモンを (プロセス名 food、実行ユーザ food 、PID 情報を food.pid に格納で) 起動する。

note: type: textblock
en: Send B<SIGTERM> to B<food> and wait up to 5 seconds for it to stop:
ja: B<food> に B<SIGTERM> を送信し、停止するまで 5 秒間待機する:

note: type: textblock
en: Demonstration of a custom schedule for stopping B<food>:
ja: B<food> 停止のためのカスタムスケジュールのデモ:

note: type: textblock
en: update-alternatives - maintain symbolic links determining default commands
ja: update-alternatives - シンボリックリンクを管理してデフォルトのコマンドを決定する

note: type: textblock
en: It is possible for several programs fulfilling the same or similar functions to be installed on a single system at the same time.  For example, many systems have several text editors installed at once.  This gives choice to the users of a system, allowing each to use a different editor, if desired, but makes it difficult for a program to make a good choice for an editor to invoke if the user has not specified a particular preference.
ja: 同一の、あるいは類似の機能を持つ複数のプログラムを一つのシステムに同時にインストールし、共存させることができる。例えば多くのシステムでは、複数のテキストエディタを共存させている。これにより、システムのユーザは好みに応じて別々のエディタを使うことができるようになる。しかしプログラムからすると、特に指定がなかったときにどのエディタを起動すれば良いのかという、なかなか難しい問題を抱えることになる。

note: type: textblock
en: The generic name is not a direct symbolic link to the selected alternative.  Instead, it is a symbolic link to a name in the I<alternatives> I<directory>, which in turn is a symbolic link to the actual file referenced.  This is done so that the system administrator's changes can be confined within the I<%CONFDIR%> directory: the FHS (q.v.) gives reasons why this is a Good Thing.
ja: 一般名は、選ばれた「選択肢 (alternative)」への直接のシンボリックリンクではなく、 I<alternatives> I<ディレクトリ> にある名前へのシンボリックリンクになっており、その名前が実際に参照されるファイルへのシンボリックリンクになっている。こうなっている理由は、システム管理者による変更を I<%CONFDIR%> ディレクトリ以下で完結させるためである。なぜこうするのが良いかについては FHS に説明がある。

note: type: textblock
en: Each link group is, at any given time, in one of two modes: automatic or manual.  When a group is in automatic mode, the alternatives system will automatically decide, as packages are installed and removed, whether and how to update the links.  In manual mode, the alternatives system will retain the choice of the administrator and avoid changing the links (except when something is broken).
ja: 各リンクグループは、いかなる時点においても、 automatic または manual の 2 つのモードのいずれかにある。グループが automatic モードにある場合は、パッケージのインストール・削除の際にリンクを更新するか、どのように更新するかは、 alternatives システムが自動的に決定する。 manual モードでは、 alternatives システムは (何らかの問題が発生した場合を除き) リンクを変更せず、システム管理者の行った設定が保持される。

note: type: textblock
en: Link groups are in automatic mode when they are first introduced to the system.  If the system administrator makes changes to the system's automatic settings, this will be noticed the next time B<update-alternatives> is run on the changed link's group, and the group will automatically be switched to manual mode.
ja: リンクグループがシステムに導入されると、まず automatic モードとして機能する。システム管理者がその設定を変更すると、次に B<update-alternatives> がリンクグループに対して実行されたときに変更が認識され、そのリンクグループは自動的に manual モードに切り換わる。

note: type: textblock
en: Each alternative has a I<priority> associated with it.  When a link group is in automatic mode, the alternatives pointed to by members of the group will be those which have the highest priority.
ja: 各選択肢は I<priority> 属性を持っている。リンクグループが automatic モードにあるときは、 I<priority> のもっとも高いものが、そのグループのメンバーが参照する選択肢になる。

note: type: textblock
en: If you want to configure non-interactively you can use the B<--set> option instead (see below).
ja: 非対話的に設定をしたい場合は B<--set> オプションを代わりに使用する (以下を参照)。

note: type: textblock
en: Different packages providing the same file need to do so B<cooperatively>.  In other words, the usage of B<update-alternatives> is B<mandatory> for all involved packages in such case.  It is not possible to override some file in a package that does not employ the B<update-alternatives> mechanism.
ja: 同一のファイルを提供する異なるパッケージは、これを B<協調して> 行う必要がある。言い換えると、こうした場合、関連するパッケージのすべてで B<update-alternatives> の使用が必須となる。B<update-alternatives> 機構を使用していないパッケージのファイルを上書きすることはできない。

note: type: =head1
en: TERMINOLOGY
ja: 用語

note: type: textblock
en: Since the activities of B<update-alternatives> are quite involved, some specific terms will help to explain its operation.
ja: B<update-alternatives> の動作は極めて複雑なので、ここでいくつかの固有の用語を説明し、動作の理解の助けとしたい。

note: type: =item
en: generic name (or alternative link)
ja: 一般名 (generic name / alternative link)

note: type: textblock
en: A name, like I</usr/bin/editor>, which refers, via the alternatives system, to one of a number of files of similar function.
ja: I</usr/bin/editor> のような名前。 alternatives システムによって、類似の機能を持つ複数のファイルのいずれかを参照する。

note: type: =item
en: alternative name
ja: 選択肢名 (alternative name)

note: type: textblock
en: The name of a symbolic link in the alternatives directory.
ja: alternatives ディレクトリに存在するシンボリックリンク名

note: type: =item
en: alternative (or alternative path)
ja: 選択肢 (alternative / alternative path)

note: type: textblock
en: The name of a specific file in the filesystem, which may be made accessible via a generic name using the alternatives system.
ja: ファイルシステム中の特定ファイルの名称、alternatives システムによって、一般名からのアクセスが可能となる。

note: type: =item
en: alternatives directory
ja: alternatives ディレクトリ

note: type: textblock
en: A directory, by default I<%CONFDIR%/alternatives>, containing the symlinks.
ja: シンボリックリンクを保持するディレクトリ。デフォルトは I<%CONFDIR%/alternatives>。

note: type: =item
en: administrative directory
ja: administrative ディレクトリ

note: type: textblock
en: A directory, by default I<%ADMINDIR%/alternatives>, containing B<update-alternatives>' state information.
ja: B<update-alternatives> の状態情報を保持するディレクトリ。デフォルトは I</var/lib/dpkg/alternatives>。

note: type: =item
en: link group
ja: リンクグループ

note: type: textblock
en: A set of related symlinks, intended to be updated as a group.
ja: 関連するシンボリックリンクのセットで、グループ単位での更新を行うためのもの。

note: type: =item
en: master link
ja: master リンク

note: type: textblock
en: The alternative link in a link group which determines how the other links in the group are configured.
ja: リンクグループに属する選択肢のリンクで、グループ内の他のリンクの設定を決定するもの。

note: type: =item
en: slave link
ja: slave リンク

note: type: textblock
en: An alternative link in a link group which is controlled by the setting of the master link.
ja: リンクグループに属する選択肢のリンクで、 master リンクの設定によって設定されるもの。

note: type: =item
en: automatic mode
ja: automatic モード

note: type: textblock
en: When a link group is in automatic mode, the alternatives system ensures that the links in the group point to the highest priority alternative appropriate for the group.
ja: リンクグループが automatic モードにある場合、alternatives システムは、グループ内の各リンクが priority のもっとも高い選択肢を参照することを担保する。

note: type: =item
en: manual mode
ja: manual モード

note: type: textblock
en: When a link group is in manual mode, the alternatives system will not make any changes to the system administrator's settings.
ja: リンクグループが manual モードにある場合、alternatives システムはシステム管理者の行った設定を一切変更しない。

note: type: textblock
en: Add a group of alternatives to the system.  I<link> is the generic name for the master link, I<name> is the name of its symlink in the alternatives directory, and I<path> is the alternative being introduced for the master link.  The arguments after B<--slave> are the generic name, symlink name in the alternatives directory and the alternative path for a slave link.  Zero or more B<--slave> options, each followed by three arguments, may be specified.  Note that the master alternative must exist or the call will fail.  However if a slave alternative doesn't exist, the corresponding slave alternative link will simply not be installed (a warning will still be displayed).  If some real file is installed where an alternative link has to be installed, it is kept unless B<--force> is used.
ja: 選択肢のグループをシステムに追加する。I<link> は master リンクの一般名、I<name> は alternatives ディレクトリにおけるシンボリックリンクの名前、 I<path> は master リンクとなる選択肢の名前となる。B<--slave> オプションに続く引数は、alternatives ディレクトリでの一般名およびシンボリックリンクの名前と slave リンクとなる選択肢のパスの順となる。B<--slave> オプションと、それにに続く 3 つの引数のセットは、いくつ設定してもよく、まったく設定しないこともできる。master となる選択肢は必ず存在している必要があり、存在していない場合は失敗となるが、slave の選択肢がインストールされていない場合は、(依然として警告が表示されるものの) 対応する slave の選択肢のリンクが単にインストールされないだけである。選択肢のリンクがインストールされるパスに、何らかの実ファイルがインストールされている場合、B<--force> が指定されない限り、それらのファイルは保持される。

note: type: textblock
en: If the alternative name specified exists already in the alternatives system's records, the information supplied will be added as a new set of alternatives for the group.  Otherwise, a new group, set to automatic mode, will be added with this information.  If the group is in automatic mode, and the newly added alternatives' priority is higher than any other installed alternatives for this group, the symlinks will be updated to point to the newly added alternatives.
ja: 指定された選択肢の名前が既に alternatives システム内に存在している場合、与えられた情報は、グループに対する新たな選択肢として追加される。それ以外の場合は、与えられた情報を用いて、新しいグループが automatic モードで追加される。グループが automatic モードにあり、新たに追加された選択肢の priority がそのグループに対してインストールされている他の選択肢のものより高い場合、シンボリックリンクは新たに追加された選択肢を参照するように更新される。

note: type: textblock
en: Remove an alternative and all of its associated slave links.  I<name> is a name in the alternatives directory, and I<path> is an absolute filename to which I<name> could be linked.  If I<name> is indeed linked to I<path>, I<name> will be updated to point to another appropriate alternative (and the group is put back in automatic mode), or removed if there is no such alternative left.  Associated slave links will be updated or removed, correspondingly.  If the link is not currently pointing to I<path>, no links are changed; only the information about the alternative is removed.
ja: (master の) 選択肢とそれに関連する全ての slave リンクを削除する。 I<name> は alternatives ディレクトリ内の名前であり、 I<path> は I<name> のリンク先に指定されうるファイル名の絶対パスである。 I<name> が実際に I<path> にリンクされている場合には、 I<name> は他の適切な選択肢を参照するよう更新される (グループは automatic モードに戻される) が、そのような選択肢が残っていなければ削除される。関連する slave リンクも対応して更新 (削除) される。 I<name> が現在その I<path> を参照していなければ、リンクの変更は行われない。その選択肢の情報が削除されるだけである。

note: type: textblock
en: Remove all alternatives and all of their associated slave links.  I<name> is a name in the alternatives directory.
ja: すべての選択肢と、それに関連するすべての slave リンクを削除する。 I<name> は、alternatives ディレクトリ内の名前である。

note: type: textblock
en: Call B<--config> on all alternatives.  It can be usefully combined with B<--skip-auto> to review and configure all alternatives which are not configured in automatic mode.  Broken alternatives are also displayed.  Thus a simple way to fix all broken alternatives is to call B<yes '' | update-alternatives --force --all>.
ja: すべての選択肢に対して B<--config> を呼び出す。これは B<--skip-auto> と組み合わせることで、automatic モードで設定されていないすべての選択肢を確認、設定する際に有用である。問題のある選択肢も表示される。問題のある選択肢をすべて修正するためには B<yes '' | update-alternatives --force --all> を実行すればよい。

note: type: textblock
en: Switch the link group behind the alternative for I<name> to automatic mode.  In the process, the master symlink and its slaves are updated to point to the highest priority installed alternatives.
ja: I<name> で指定される選択肢のリンクグループを、automatic モードに変更する。この処理を行う際に、master のシンボリックリンクと対応する各 slave は、現在インストールされている選択肢のうち、もっとも priority の高いものを参照するように更新される。

note: type: textblock
en: Display all targets of the link group.
ja: リンクグループのすべての対象を表示する。

note: type: textblock
en: Show available alternatives for a link group and allow the user to interactively select which one to use.  The link group is updated.
ja: リンクグループで利用可能なすべての選択肢を表示し、対話的に選択肢の 1 つを選択できるようにする。これにより、リンクグループが更新される。

note: type: textblock
en: Skip configuration prompt for alternatives which are properly configured in automatic mode.  This option is only relevant with B<--config> or B<--all>.
ja: automatic モードで適切に設定されている選択肢について、設定の確認を行わない。このオプションは B<--config> および B<--all> とともに指定した場合のみ有効である。

note: type: textblock
en: Problems were encountered whilst parsing the command line or performing the action.
ja: コマンドラインの解釈か、アクションの実行時に問題が発生した。

note: type: textblock
en: If set and the B<--admindir> option has not been specified, it will be used as the base administrative directory.
ja: B<--admindir> オプションが指定されていない場合に、この変数が設定されていると、この値が administrative ディレクトリの起点として使用される。

note: type: textblock
en: The default alternatives directory.  Can be overridden by the B<--altdir> option.
ja: デフォルトの alternatives ディレクトリ。 B<--altdir> オプションによって変更できる。

note: type: textblock
en: The default administration directory.  Can be overridden by the B<--admindir> option.
ja: デフォルトの administration ディレクトリ。 B<--admindir> オプションによって変更できる。

note: type: textblock
en: The alternative name in the alternative directory.
ja: alternative ディレクトリに存在する選択肢の名前

note: type: textblock
en: The generic name of the alternative.
ja: 選択肢の一般名

note: type: textblock
en: When this field is present, the B<next> lines hold all slave links associated to the master link of the alternative.  There is one slave per line.  Each line contains one space, the generic name of the slave alternative, another space, and the path to the slave link.
ja: このヘッダが存在している場合、B<以降の> 行には、この選択肢の master リンクに対応するすべての slave リンクが記述される。これは、slave 毎に 1 行ずつ記述され、各行は、1 文字のスペースに続き、slave の選択肢の一般名、スペース、slave リンクのパスが記述される。

note: type: textblock
en: The status of the alternative (B<auto> or B<manual>).
ja: 選択肢の状況 (B<auto> もしくは B<manual>)

note: type: textblock
en: The path of the best alternative for this link group.  Not present if there is no alternatives available.
ja: このリンクグループで最適な選択肢のパス。利用可能な選択肢が存在しない場合、存在しない。

note: type: textblock
en: The path of the currently selected alternative.  It can also take the magic value B<none>.  It is used if the link doesn't exist.
ja: 現在選択されている選択肢のパス。リンクが存在しない場合、B<none> という特別な値が設定される場合がある。

note: type: textblock
en: Value of the priority of this alternative.
ja: この選択肢の priority の値。

note: type: textblock
en: When this field is present, the B<next> lines hold all slave alternatives associated to the master link of the alternative.  There is one slave per line.  Each line contains one space, the generic name of the slave alternative, another space, and the path to the slave alternative.
ja: このヘッダが存在している場合、B<以降の> 行には、この選択肢の master リンクに対応するすべての slave の選択肢が記述される。これは、slave 毎に 1 行ずつ記述され、各行は、1 文字のスペースに続き、slave の選択肢の一般名、スペース、slave の選択肢のパスが記述される。

note: type: textblock
en: With B<--verbose> B<update-alternatives> chatters incessantly about its activities on its standard output channel.  If problems occur, B<update-alternatives> outputs error messages on its standard error channel and returns an exit status of 2.  These diagnostics should be self-explanatory; if you do not find them so, please report this as a bug.
ja: B<--verbose> を指定した場合、B<update-alternatives> は、実行中の処理内容を逐一標準出力に出力する。問題が起きると、 B<update-alternatives> はエラーメッセージを標準エラー出力に出力し、終了ステータス 2 を返す。これらの診断メッセージは、読めばわかるはずである。もしわからなければ、バグとして報告して欲しい。

note: type: textblock
en: To display the available packages which provide B<vi> and the current setting for it, use the B<--display> action:
ja: B<vi> を提供するパッケージとその現在の設定を表示するには、B<--display> アクションを使用する:

note: type: textblock
en: To choose a particular B<vi> implementation, use this command as root and then select a number from the list:
ja: 特定の B<vi> の実装を選ぶには、root としてこのコマンドを実行し、一覧から数字を選ぶ:

note: type: textblock
en: To go back to having the B<vi> implementation chosen automatically, do this as root:
ja: B<vi> 実装の選択を自動的に行なうように戻すには、root としてこのコマンドを実行する:
