Debian Policy Manual 4.1.6.0 - en to ja translation catalogue (54 entries)

en: Binary packages
ja: バイナリパッケージ

en: The Debian distribution is based on the Debian package management system, called ``dpkg``. Thus, all packages in the Debian distribution must be provided in the ``.deb`` file format.
ja: Debian ディストリビューションは ``dpkg`` と呼ばれる Debian パッケージ管理システムに基礎を置いています。このため、Debian ディストリビューションに含まれる全てのパッケージは ``.deb`` ファイル形式で提供されなければなりません。

en: The package name
ja: パッケージ名

en: Every package must have a name that's unique within the Debian archive.
ja: "全てのパッケージは Debian アーカイブ内において重複しない名前を持っていなければなりません。

en: The package name is included in the control field ``Package``, the format of which is described in :ref:`s-f-Package`. The package name is also included as a part of the file name of the ``.deb`` file.
ja: パッケージ名はコントロールフィールド ``Package`` に含まれます。また、そのフォーマットは :ref:`s-f-Package` で記載されています。パッケージ名は ``.deb`` ファイルのファイル名の一部としても含まれています。

en: The version of a package
ja: パッケージのバージョン

en: Every package has a version number recorded in its ``Version`` control file field, described in :ref:`s-f-Version`.
ja: 各パッケージはコントロールフィールド ``Version`` にバージョン番号を持ちます。また、そのフォーマットは :ref:`s-f-Version` で記載されています。

en: The package management system imposes an ordering on version numbers, so that it can tell whether packages are being up- or downgraded and so that package system front end applications can tell whether a package it finds available is newer than the one installed on the system. The version number format has the most significant parts (as far as comparison is concerned) at the beginning.
ja: これによってパッケージがアップグレードされるのか、あるいはダウングレードされるのかを知ることができます。さらにパッケージフロントエンドプログラムが、そしてその結果、あるパッケージがシステムにインストールされているものよりも新しいものかどうかを判断することができるようになります。バージョン番号の形式は (比較に関する限り) 重要なものが前にくる順となっています。

en: If an upstream package has problematic version numbers they should be converted to a sane form for use in the ``Version`` field.
ja: もし上流のパッケージが問題のあるバージョン番号形式になっているならば、``Version`` フィールドではまともな形式に変換すべきです。

en: Version numbers based on dates
ja: 日付に基づくバージョン番号

en: In general, Debian packages should use the same version numbers as the upstream sources. However, upstream version numbers based on some date formats (sometimes used for development or "snapshot" releases) will not be ordered correctly by the package management software. For example, ``dpkg`` will consider "96May01" to be greater than "96Dec24".
ja: 一般的に、Debian パッケージは上流ソースと同じバージョン番号を使うべきです。しかし、上流のバージョン番号が日付に基づくような場合 (例えば、開発中や "snapshot" リリースの場合) には、パッケージ管理システムはこのようなバージョン番号を正しく順序判断することができません。例えば、dpkg は "96May01" を" "96Dec24" よりも大きいと判断するでしょう。

en: To prevent having to use epochs for every new upstream version, the date-based portion of any upstream version number should be given in a way that sorts correctly: four-digit year first, followed by a two-digit numeric month, followed by a two-digit numeric date, possibly with punctuation between the components.
ja: そのような場合に、今後の新しい上流バージョンに対して epoch を使わなくて済むようにするためには、上流のバージョン番号を順序づけが正しく行われるような方法に変更すべきです。具体的には、日付を元にしたバージョン番号部を 4 桁の年、2 桁の月、2 桁の日で、各部の間に区切り文字を挿入可、と言うように直すべきです。

en: The maintainer of a package
ja: パッケージのメンテナ

en: Every package must have a maintainer, except for orphaned packages as described below. The maintainer may be one person or a group of people reachable from a common email address, such as a mailing list. The maintainer is responsible for maintaining the Debian packaging files, evaluating and responding appropriately to reported bugs, uploading new versions of the package (either directly or through a sponsor), ensuring that the package is placed in the appropriate archive area and included in Debian releases as appropriate for the stability and utility of the package, and requesting removal of the package from the Debian distribution if it is no longer useful or maintainable.
ja: 全てのパッケージには、以下で記載する ``orphaned`` パッケージを除いて、一人または一グループの Debian メンテナを持たなければなりません。メンテナは、個人であっても、メーリングリストなどの共通の一つのメールアドレスで連絡の取れるグループであってもかまいません。メンテナは、Debian パッケージファイルの保守、すなわち報告されたバグに対して適切に判断・応答すること、新しいバージョンのアップロード (直接あるいはスポンサー経由で) を行うこと、そのパッケージが適切なアーカイブエリアに置かれていること、パッケージの安定度や有用性にしたがって適切なディストリビューションに収録されていること、有用性が失われたか保守不能になった場合パッケージを Debian ディストリビューションから削除する要求を出すことについて、責任を持ちます。

en: The maintainer must be specified in the ``Maintainer`` control field with their correct name and a working email address. The email address given in the ``Maintainer`` control field must accept mail from those role accounts in Debian used to send automated mails regarding the package. This includes non-spam mail from the bug-tracking system, all mail from the Debian archive maintenance software, and other role accounts or automated processes that are commonly agreed on by the project.  [#]_ If one person or team maintains several packages, they should use the same form of their name and email address in the ``Maintainer`` fields of those packages.
ja: Debian パッケージのメンテナは各パッケージの ``Maintainer`` 制御フィールドに、正しい名前と有効な電子メールアドレスの両方により指定されていなければなりません。``Maintainer`` 制御フィールド内の電子メールアドレスは、Debian でパッケージに関して自動的にメールを送るのに使われる役割のアカウントからのメールを受け取らなければいけません。これは、バグトラッキングシステムからの SPAM でないメール、Debian アーカイブ管理ソフトウェアからのすべてのメール、およびそれ以外にもプロジェクトで合意されている決まった役割のアカウントと自動送信プロセスからのメールは、受け取らなければならないということです。 [#]_ もしその人がいくつかのパッケージを管理している場合、個々のパッケージの ``Maintainer`` フィールドに同じ形式の名前と電子メールアドレスを記入すべきです。

en: The format of the ``Maintainer`` control field is described in :ref:`s-f-Maintainer`.
ja: ``Maintainer`` フィールドの書式は、:ref:`s-f-Maintainer` で記載されています。

en: If the maintainer of the package is a team of people with a shared email address, the ``Uploaders`` control field must be present and must contain at least one human with their personal email address. See :ref:`s-f-Uploaders` for the syntax of that field.
ja: パッケージのメンテナがメールアドレスを共有するチームである場合、``Uploaders`` 制御フィールドが必ず存在し、個人の電子メールアドレスを付けてひとりの人物が指定されていなければいけません。このフィールドの書式は、:ref:`s-f-Uploaders` を参照ください。

en: An orphaned package is one with no current maintainer. Orphaned packages should have their ``Maintainer`` control field set to ``Debian QA Group <packages@qa.debian.org>``. These packages are considered maintained by the Debian project as a whole until someone else volunteers to take over maintenance.  [#]_
ja: orphaned パッケージとは、現在メンテナのいないパッケージのことです。orphaned パッケージでは、``Maintainer`` 制御フィールドに ``Debian QA Group <packages@qa.debian.org>`` を設定しなければいけません。このようなパッケージは、保守の志願者が現れない限り Debian プロジェクト全体で保守されているとみなされます。 [#]_

en: The description of a package
ja: パッケージの説明文

en: Every Debian package must have a ``Description`` control field which contains a synopsis and extended description of the package. Technical information about the format of the ``Description`` field is in :ref:`s-f-Description`.
ja: 全ての Debian パッケージは、パッケージの簡潔な説明文と、やや詳細な説明文を含む ``Description`` フィールドを持たなければなりません。``Description`` フィールドの書式の技術的詳細は :ref:`s-f-Description` に記載されています。

en: The description should describe the package (the program) to a user (system administrator) who has never met it before so that they have enough information to decide whether they want to install it. This description should not just be copied verbatim from the program's documentation.
ja: 説明文は、そのパッケージのことを知らないユーザ (システム管理者) が、そのパッケージ (プログラム) をインストールするかどうかを判断するにあたって十分な情報を伝えるように書かれているべきです。説明文はプログラムの説明文書をそのままコピーしただけのものとすべきではありません。

en: Put important information first, both in the synopsis and extended description. Sometimes only the first part of the synopsis or of the description will be displayed. You can assume that there will usually be a way to see the whole extended description.
ja: 概要と、長い説明のどちらについても重要な情報を最初に書いてください。概要や説明の最初の部分だけしか表示されない場合があるためです。ただし、詳しい説明の全体を見る手段が用意されていることを仮定してもかまわないでしょう。

en: The description should also give information about the significant dependencies and conflicts between this package and others, so that the user knows why these dependencies and conflicts have been declared.
ja: 説明文にはパッケージ間の重要な依存関係 (dependency) や競合関係 (conflict) の情報も示されているべきです。そうでないと、ユーザにはなぜ競合関係や依存関係の不具合が起きているのかが分かりません。

en: Instructions for configuring or using the package should not be included (that is what installation scripts, manual pages, info files, etc., are for). Copyright statements and other administrivia should not be included either (that is what the copyright file is for).
ja: また、そのパッケージを設定したり使ったりするための解説を含めるべきではありません (それはインストールスクリプト、マニュアルページ、Infoファイルなどで扱われるべきです)。著作権表示やその他管理に関係する種々のことも含まれるべきではありません。それら向けには copyright ファイルが用意されています。

en: The single line synopsis
ja: 一行要約・概説

en: The single line synopsis should be kept brief---certainly under 80 characters.
ja: 一行による要約は簡潔にすべきです。半角換算で 80 文字以下としてください。

en: Do not include the package name in the synopsis line. The display software knows how to display this already, and you do not need to state it. Remember that in many situations the user may only see the synopsis line - make it as informative as you can.
ja: パッケージ名を要約 (Synopsis) の行に入れないでください。入れなくても、表示ソフトウェアはパッケージ名を自動的に表示するようになっています。多くの場合、ユーザの目にふれるのはこの要約行だけなので、なるべく分かりやすい要約にするようにしてください。

en: The extended description
ja: 詳細の解説部分

en: Do not try to continue the single line synopsis into the extended description. This will not work correctly when the full description is displayed, and makes no sense where only the summary (the single line synopsis) is available.
ja: 上記の一行要約からそのまま引き続いて説明文に続ける形を取らないでください。これは説明文の全体が表示されている時にうまくいきませんし、また一行要約が表示されている場合のみでしか意味をなしません。

en: The extended description should describe what the package does and how it relates to the rest of the system (in terms of, for example, which subsystem it is which part of).
ja: 詳細の解説部分はそのパッケージ自体の説明 (例えば、このパッケージが Debian システム全体の中の、どの部分集合に属しているのか) について記します。

en: The description field needs to make sense to anyone, even people who have no idea about any of the things the package deals with.  [#]_
ja: 説明文は誰であっても、例えばそのパッケージが扱っている分野のことを何も知らない人でも理解できるように書かれなければなりません。 [#]_

en: Dependencies
ja: 依存関係

en: Every package must specify the dependency information about other packages that are required for the first to work correctly.
ja: 全てのパッケージには、それが正しく動作するためにまず必要となる他のパッケージについての依存情報が指定されていなければなりません。

en: For example, a dependency entry must be provided for any shared libraries required by a dynamically-linked executable binary in a package.
ja: 例えば、パッケージに含まれている、動的にリンクされた実行形式バイナリが必要とする共有ライブラリは、依存関係のエントリで明示していなければなりません。

en: Packages are not required to declare any dependencies they have on other packages which are marked ``Essential`` (see below), and should not do so unless they depend on a particular version of that package.  [#]_
ja: 但し、``Essential`` (下記参照) と指定されているパッケージに対して、それ以外のパッケージが依存関係を宣言する必要はありません。また、そのようなパッケージの特定のバージョンに依存しているのでなければ、依存関係を宣言すべきではありません。 [#]_

en: Sometimes, unpacking one package requires that another package be first unpacked *and* configured. In this case, the depending package must specify this dependency in the ``Pre-Depends`` control field.
ja: 時々、あるパッケージが、それを展開する前にもう一つのパッケージが展開され *かつ* 設定されていることを必要とすることがあります。この場合、そのパッケージには ``Pre-Depends`` エントリを指定しなければなりません。

en: You should not specify a ``Pre-Depends`` entry for a package before this has been discussed on the ``debian-devel`` mailing list and a consensus about doing that has been reached.
ja: ``debian-devel`` メーリングリストで議論して同意が得られる前に、パッケージに ``Pre-Depends`` エントリを指定するべきではありません。

en: The format of the package interrelationship control fields is described in :doc:`Declaring relationships between packages <ch-relationships>`.
ja: パッケージ相互関係を指定するコントロールフィールドの書式は :doc:`Declaring relationships between packages <ch-relationships>` に記載されています。

en: Virtual packages
ja: 仮想パッケージ

en: Sometimes, there are several packages which offer more-or-less the same functionality. In this case, it's useful to define a *virtual package* whose name describes that common functionality. (The virtual packages only exist logically, not physically; that's why they are called *virtual*.) The packages with this particular function will then *provide* the virtual package. Thus, any other package requiring that function can simply depend on the virtual package without having to specify all possible packages individually.
ja: 多かれ少なかれ同じような仕事をこなすパッケージがいくつか存在するということがあります。この場合、パッケージが持つ共通の機能を説明する名前の *仮想パッケージ* を定義するのが便利です (仮想パッケージは論理的に存在するだけで、物理的には存在しません。これがそれらが *仮想* と呼ばれる理由です)。特定の機能を持つこういったパッケージ群は皆仮想パッケージを *提供* します。そうしておけば、その機能を必要とする他のパッケージは単にその仮想パッケージに依存するようにすれば、可能性のある全てのパッケージをいちいち列挙しなくても良いわけです。

en: All packages should use virtual package names where appropriate, and arrange to create new ones if necessary. They should not use virtual package names (except privately, amongst a cooperating group of packages) unless they have been agreed upon and appear in the list of virtual package names. (See also :ref:`s-virtual`)
ja: 全てのパッケージはそうするのが適当なときには仮想パッケージ名を使うべきで、もし必要ならば新しい仮想パッケージ名を作るようにしなければなりません。但し、同意が得られ、仮想パッケージ名の一覧に掲載されるまで、新しい仮想パッケージ名を使うべきではありません (非公式に、互いに関連する一群のパッケージの間で使う場合は除く)。この項に関しては、:ref:`s-virtual` を参照下さい。

en: The latest version of the authoritative list of virtual package names can be found in the ``debian-policy`` package. It is also available from the Debian web mirrors at https://www.debian.org/doc/packaging-manuals/virtual-package-names-list.yaml.
ja: 正式な仮想パッケージ名の一覧の最新版は ``debian-policy`` パッケージに同封されています。また、Debian ウェブミラーサーバの https://www.debian.org/doc/packaging-manuals/virtual-package-names-list.yaml にあります。

en: The procedure for updating the list is described in the preface to the list.
ja: このリストを更新するための手続きについてはこの一覧ファイルのはじめに記述されています。

en: Base system
ja: Base システム

en: The ``base system`` is a minimum subset of the Debian system that is installed before everything else on a new system. Only very few packages are allowed to form part of the base system, in order to keep the required disk usage very small.
ja: ``base システム`` は、新しいシステムに於いて他の全てに先だってインストールされる、Debian システムの最小のサブセットを形成します。従って、必要となるディスク使用量を非常に小さく保つため、ごく少数のパッケージのみが base システムの一部となることを認められています。

en: The base system consists of all those packages with priority ``required`` or ``important``. Many of them will be tagged ``essential`` (see below).
ja: base システムはプライオリティ評価が ``required`` と ``important`` のパッケージ全体で構成されています。また、それらの大半には ``essential`` 指定 (下記参照) が付加されているでしょう。

en: Essential packages
ja: Essential パッケージ

en: Essential is defined as the minimal set of functionality that must be available and usable on the system at all times, even when packages are in the "Unpacked" state. Packages are tagged ``essential`` for a system using the ``Essential`` control field. The format of the ``Essential`` control field is described in :ref:`s-f-Essential`.
ja: Essential は、パッケージ群が展開状態 (Unpacked) でも、システム上で提供され使用できなければならない最小の機能の集合として定義されています。そのようなパッケージには ``Essential`` コントロールフィールドで ``Essential`` 指定が付加されています。``Essential`` コントロールフィールドの書式は :ref:`s-f-Essential` に記載されています。

en: Since these packages cannot be easily removed (one has to specify an extra *force option* to ``dpkg`` to do so), this flag must not be used unless absolutely necessary. A shared library package must not be tagged ``essential``; dependencies will prevent its premature removal, and we need to be able to remove it when it has been superseded.
ja: これらのパッケージは簡単には削除できません (削除するには ``dpkg`` に特別な *強制 (force) オプション* を指定しなければなりません)。このため、このフラグはどうしても必要な場合にのみ使うようにしなければなりません。共有ライブラリのパッケージに *Essential* 指定をしてはいけません。依存関係により誤った削除を阻止できますし、新しいものに入れ替える際には上書きできるようになっている必要があるからです。

en: Maintainers should take great care in adding any programs, interfaces, or functionality to ``essential`` packages. Packages may assume that functionality provided by ``essential`` packages is always available without declaring explicit dependencies, which means that removing functionality from the Essential set is very difficult and is almost never done. Any capability added to an ``essential`` package therefore creates an obligation to support that capability as part of the Essential set in perpetuity.
ja: メンテナは、プログラム、インターフェース、機能を ``essential`` パッケージに加える際には細心の注意を払う必要があります。パッケージは ``essential`` パッケージの提供する機能は明示的な依存関係の宣言なしに常に提供されていることを期待してよく、逆に Essential パッケージ群から機能を削除することは非常に難しく、ほとんどできないものになります。また、``essential`` パッケージに機能を加えることは、その機能を Essential 群で永久にサポートする義務を負わせることになります。

en: You must not tag any packages ``essential`` before this has been discussed on the ``debian-devel`` mailing list and a consensus about doing that has been reached.
ja: ``debian-devel`` メーリングリストで議論して同意が得られない限り、パッケージに ``Essential`` 指定を付加してはなりません。

en: Maintainer Scripts
ja: メンテナスクリプト

en: The package installation scripts should avoid producing output which is unnecessary for the user to see and should rely on ``dpkg`` to stave off boredom on the part of a user installing many packages. This means, amongst other things, not passing the ``--verbose`` option to ``update-alternatives``.
ja: パッケージのインストールスクリプトでは、ユーザにとって見る必要がない情報を出力することを避けるべきです。また、大量のパッケージをインストールする際にユーザが退屈するのを避けるのも、``dpkg`` に任せておくべきです。中でも、``update-alternatives`` に ``--verbose`` オプションを渡さないようにしましょう。

en: Errors which occur during the execution of an installation script must be checked and the installation must not continue after an error.
ja: インストールスクリプトの実行中に起こったエラーはチェックしなければなりませんし、エラーの後インストールの実行を続けてはなりません。
