[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Developer's Reference chap.6
遠藤です。
Debian デベロッパーズリファレンスの第 6 章の翻訳です。
チェックお願いします。
| <chapt id="upload">Package uploads
|
| <sect>Announcing new packages
| <p>
| If you want to create a new package for the Debian distribution, you
| should first check the <url id="&url-wnpp;" name="Work-Needing and
| Prospective Packages (WNPP)"> list. Checking the WNPP ensures that no
| one is already working on packaging that software, and that effort is
| not duplicated. Assuming no one else is already working on your
| prospective package, you must then send a short email to
| &email-debian-devel; describing your plan to create a new package.
| You should set the subject of the email to ``intent to package
| <var>foo</var>'', substituting the name of the new package for
| <var>foo</var>.
| <p>
| There are a number of reasons why we ask maintainers to follow these
| steps:
<chapt id="upload">パッケージのアップロード
<sect>新規パッケージのアナウンス
<p>
Debian ディストリビューション用に新たなパッケージを作成しようと考えたら、
まず最初に
<url id="&url-wnpp;" name="Work-Needing and Prospective Packages (WNPP)">
の一覧をチェックしてください。
WNPP をチェックすることによって、
まだ誰もそのソフトウェアのパッケージング作業を行なっておらず、
作業が重複しないことが明らかになります。
あなたが作業を予定しているパッケージにまだ誰も手をつけていないことが
分かったら、新たなパッケージ作成に関するあなたの計画を説明するために
簡潔な電子メールを &email-debian-devel; 宛てに送ります。
その電子メールのサブジェクトは ``intent to package <var>foo</var>''
とするべきです。
<var>foo</var> のところには新たなパッケージの名前を当てはめてください
<p>
このような手順を踏むことを開発者にお願いするのは、
以下のようないくつかの理由のためです。
| <list compact>
| <item>
| It helps the (potentially new) maintainer to tap into the experience
| of people on the list, and lets them know if any one else is working
| on it already.
| <item>
| It lets other people thinking about working on the package know that
| there already is a volunteer, and efforts may be shared. The ``intent
| to package'' message to &email-debian-devel@; will be picked up the
| the WNPP maintainer, and your intention will be published in
| subsequent versions of the WNPP document.
<list compact>
<item>
このことは、(潜在的な新) 開発者が経験豊かな人々の輪に加わる助けとなります。
また、誰かがすでに作業していないかどうかを知る手だてにもなります。
<item>
そのパッケージの作業を考えていた他の人々に、
その作業の志願者がいることやまたその作業を協同して行なえることを
知らしめることができます。
&email-debian-devel; への ``intent to package'' メッセージは WNPP
メンテナによって収集され、その申し出は WNPP 文書の改訂版で公開されます。
| <item>
| It lets the rest of the maintainers know more about the package than
| the one line description and the changelog entry ``Initial version''
| that generally gets posted to <tt>debian-devel-changes</tt> by
| default.
| <item>
| It is helpful to the people who live off unstable (and form our first
| line of testers); we should encourage these people.
| <item>
| The announcements give maintainers and other interested parties a
| better feel of what is going on, and what is new, in the project.
| </list>
<item>
他の開発者に、パッケージ一行解説文や、
普通デフォルトで <tt>debian-devel-changes</tt> に投稿される
``Initial version'' の changelog エントリ
よりも詳しいパッケージ情報を伝えることができます。
<item>
このことは (テスタの第一陣を形成している) 開発版を常時使っている人々に
役立ちます。私たちはこのような人々を鼓舞すべきです。
<item>
このアナウンスは、開発者や関心の高い他のグループに対して、
当プロジェクトで行なわれていること、新しく起こっていることについての
よりよい感触をもたらします。
</list>
| <sect id="uploading">Uploading a package
|
| <sect1>Generating the changes file
| <p>
| When a package is uploaded to the Debian FTP archive, it must be
| accompanied by a <tt>.changes</tt> file, which gives directions to the
| archive maintainers for its handling. This is usually generated by
| <prgn>dpkg-genchanges</prgn> during the normal package build process.
| <p>
| The changes file is a control file with the following fields:
| <p>
| &control-file-fields;
| <p>
| All of these fields are mandatory for a Debian upload. See the list
| of control fields in the <url id="&url-pkg-manual;" name="Debian
| Packaging Manual"> for the contents of these fields. Only the
| <tt>Distribution</tt> field is discussed here, since it relates to the
| archive maintenance policies.
<sect id="uploading">パッケージをアップロードする
<sect1>changes ファイルの作成
<p>
Debian FTP アーカイブにパッケージをアップロードする際には、
アーカイブメンテナにその扱いを指示するための
<tt>.changes</tt> を添えなければなりません。
こちらは普通、通常のパッケージ構築プロセスの最中に
<prgn>dpkg-genchanges</prgn> によって生成されます。
<p>
この changes ファイルは以下のフィールドをもつ制御ファイルです。
<p>
&control-file-fields;
<p>
Debian アップロードの際、これらのフィールドはすべて必須です。
これらのフィールドの内容については
<url id="&url-pkg-manual;" name="Debian パッケージングマニュアル">
の制御フィールドの一覧をご覧ください。
ここではアーカイブメンテナンスのポリシーに関わる
<tt>Distribution</tt> フィールドのみを取り上げます。
| <sect1 id="upload-dist">Picking a distribution
| <p>
| Notably, the <tt>Distribution</tt> field, which originates from the
| <file>debian/changelog</file> file, indicates which distribution the
| package is intended for. There are four possible values for this
| field: `stable', `unstable', `frozen', or `experimental'; these values
| can also be combined. For instance, if you have a crucial security
| fix release of a package, and the package has not diverged between the
| <em>stable</em> and <em>unstable</em> distributions, then you might
| put `stable unstable' in the <file>changelog</file>'s
| <tt>Distribution</tt> field.
<sect1 id="upload-dist">ディストリビューションの選択
<p>
とりわけ <file>debian/changelog</file> ファイルから生成される
<tt>Distribution</tt> フィールドは、
そのパッケージがどのディストリビューション向けのものなのかを示します。
このフィールドの値には、`stable'、`unstable'、`frozen'、`experimental'
の四つが当てはまりえます。
またこれらの値は組み合わせて当てはめられる場合もあります。
例えば、極めて重要なセキュリティ上の修正を施したパッケージのリリースがあり、
そのパッケージが <em>stable</em> および <em>unstable</em>
ディストリビューションの双方に必要なものであったならば、
<file>changelog</file> の <tt>Distribution</tt> フィールドには
`stable unstable' と記入します。
| Or, if Debian has been frozen, and you
| want to get a bug-fix release into <em>frozen</em>, you would set the
| distribution to `frozen unstable'. (See <ref id="upload-frozen"> for
| more information on when to upload to <em>frozen</em>.) Note that
| setting the distribution to `stable' means that the package will be
| placed into the <tt>proposed-updates</tt> directory of the Debian
| archive for further testing before it is actually included in
| <em>stable</em>. Also note that it never makes sense to combine the
| <em>experimental</em> distribution with anything else.
あるいは、Debian がフリーズされており <em>frozen</em>
ディストリビューションにバグ修正リリースを収録したい場合は、
そのディストリビューションは `frozen unstable' とします。
(<em>frozen</em> へアップロードする際のより詳細な情報については
<ref id="upload-frozen"> をご覧ください。)
なお注意していただきたいのですが、ディストリビューションを
`stable' に設定することは、実際に <em>stable</em>
ディストリビューションに収録される前に、
そのパッケージがさらなるテストのために Debian アーカイブの
<tt>proposed-updates</tt> ディレクトリに収録されることを意味しています。
また <em>experimental</em> ディストリビューションを
他のディストリビューションと組み合わせることはまったく意味がありません。
注意してください。
| <p>
| The first time a version is uploaded which corresponds to a particular
| upstream version the original source tar file should be uploaded and
| included in the <tt>.changes</tt> file; subsequent times the very same
| tar file should be used to build the new diffs and <tt>.dsc</tt>
| files, and it need not then be uploaded.
| <p>
| By default <prgn>dpkg-genchanges</prgn> and
| <prgn>dpkg-buildpackage</prgn> will include the original source tar
| file if and only if the Debian revision part of the source version
| number is 0 or 1, indicating a new upstream version. This behaviour
| may be modified by using <tt>-sa</tt> to always include it or
| <tt>-sd</tt> to always leave it out.
<p>
特定のアップストリームバージョンに対応するバージョンを
初めてアップロードする際には、
オリジナルソースの tar ファイルを <tt>.changes</tt> ファイルを添えて
アップロードしなければなりません。
続いて新しい diff と <tt>.dsc</tt> ファイルを生成する際には、
これとまったく同じ tar ファイルを用いなければなりませんが、
その際にはこの tar ファイルをアップロードする必要はありません。
<p>
Debian ソースバージョン番号のリビジョン部分が 0 あるいは 1 であることは、
それが新たなアップストリームバージョンであることを示しますが、
この場合 (のみ) <prgn>dpkg-genchanges</prgn> と
<prgn>dpkg-buildpackage</prgn> は、デフォルトでオリジナルソースの
tar ファイルを収録します。
この動作は、常にこちらを収録するには <tt>-sa</tt> を、
常にそれを無視するには <tt>-sd</tt> を用いることによって
変更することができます。
| <p>
| If no original source is included in the upload then the original
| source tar-file used by <prgn>dpkg-source</prgn> when constructing the
| <tt>.dsc</tt> file and diff to be uploaded <em>must</em> be
| byte-for-byte identical with the one already in the archive. If there
| is some reason why this is not the case then the new version of the
| original source should be uploaded, possibly by using the <tt>-sa</tt>
| flag.
<p>
ただ、オリジナルソースがそのアップロードに含まれない場合は、
アップロードする <tt>.dsc</tt> ファイルと diff を生成する際に
<prgn>dpkg-source</prgn> が用いるオリジナル tar ファイルは、
すでにアーカイブにあるものと 1 バイトたりとも違わない
同一のものでなければ<em>なりません</em>。
なお何らかの特殊な理由がある場合は、おそらく <tt>-sa</tt> フラグを用いて、
新しいバージョンのオリジナルソースをアップロードしなければなりません。
| <sect2 id="upload-frozen">Uploading to <em>frozen</em>
| <p>
| The Debian freeze is a crucial time for Debian. It is our chance to
| synchronize and stabilize our distribution as a whole. Therefore,
| care must be taken when uploading to <em>frozen</em>.
| <p>
| It is tempting to always try to get the newest release of software
| into the release. However, it's much more important that the system
| as a whole is stable and works as expected.
| <p>
| The watchword for uploading to <em>frozen</em> is <strong>no new
| code</strong>. This is a difficult thing to quantify, so here are
| some guidelines:
<sect2 id="upload-frozen"><em>frozen</em> へのアップロード
<p>
Debian フリーズは Debian にとって重要な期間です。
この期間はディストリビューション全体を調和させ安定化させる機会なのです。
それゆえ、<em>frozen</em> へアップロードする際には注意を要します。
<p>
最新のソフトウェアを常にリリースに収録するという試みは、
魅惑的なことです。
しかしながら、システムが全体として安定し、
期待している通りに動作することの方がより重要なことです。
<p>
<em>frozen</em> へのアップロードのモットーは
「<strong>新たなコードは入れない</strong>」です。
その基準を定めることは難しいことですが、
以下のようないくつかのガイドラインがあります。
| <p>
| <list>
| <item>
| Fixes for bugs of severity <em>critical</em>, <em>grave</em>, or
| <em>important</em> severity are always allowed for those packages that
| must exist in the final release
| <item>
| <em>critical</em>, <em>grave</em>, and <em>important</em> bug fixes
| are only allowed for non-necessary packages if they don't add any new
| features
| <item>
| normal bug fixes are allowed (though discouraged) on all packages if
| and only if there are no new features
| <item>
| wishlist fixes are not allowed (they are, after all, not really bugs)
| <item>
| documentation bug fixes are allowed, since good documentation is
| important
| </list>
<p>
<list>
<item>
<em>critical</em>、<em>grave</em> といった深刻なバグや、
重要な <em>important</em> バグなどの修正は、最終リリース時に
収録しなければならないパッケージに対しては常に可能です。
<item>
必ずしも収録の必要のないパッケージに対しては、
<em>critical</em> や、<em>grave</em>、<em>important</em>
なバグの修正は、新たな機能を一切追加しない場合のみ可能です。
<item>
<em>normal</em> バグの修正は (推奨はされませんが)
新たな機能を追加しない場合 (のみ) 可能です。
<item>
<em>wishlist</em> に関する修正は
(それらが実は本当のバグであった場合を除いて) できません。
<item>
文書が優れていることは重要ですから、文書に関するバグ修正は可能です。
</list>
| <p>
| Remember, there is statistically a 15% chance that every bug fix will
| introduce a new bug. The introduction and discovery of new bugs
| either delays release or weakens the final product. There is little
| correlation between the severity of the original bug and the severity
| of the introduced bug.
<p>
新たなバグを招いてしまう可能性が、どんなバグ修正にでも
統計的に 15% はあることを心に留めておいてください。
新たなバグの混入や発見は、リリースを遅らせたり、
最終的なプロダクトの品質を低下させたりするのです。
元々のバグの問題と新たに混入したバグの問題との間に、
相関関係はほとんどありません。
| <sect1 id="upload-checking">Checking the package prior to upload
| <p>
| Before you upload your package, you should do basic testing on it.
| Make sure you try the following activities (you'll need to have an
| older version of the Debian package around).
<sect1 id="upload-checking">アップロードの前にパッケージをチェックする
<p>
ご自分のパッケージをアップロードする前に、
それに対して基本的なテストを行なうべきです。
必ず以下の作業を行なうようにしてください。
(現行の Debian パッケージがあれば、その古いバージョンも必要になるでしょう。)
| <list>
| <item>
| Install the package and make sure the software works, or upgrade the
| package from an older version to your new version if a Debian package
| for it already exists.
<list>
<item>
パッケージをインストールし、
そのソフトウェアが動作するかどうかを確認してください。
また、すでにその Debian パッケージが存在する場合は、
そのパッケージを古いバージョンから作成した新しいバージョンに
アップグレードしてみてください。
| <item>
| Run <prgn>lintian</prgn> over the package. You can run
| <prgn>lintian</prgn> as follows: <tt>lintian -v
| <var>package-version</var>.changes</tt>. This will check the source
| package as well as the binary package. If you don't understand the
| output that <prgn>lintian</prgn> generates, try adding the <tt>-i</tt>
| switch, which will cause <prgn>lintian</prgn> to output a very verbose
| description of the problem.
| <p>
| Normally, a package should <em>not</em> be uploaded if it causes lintian
| to emit errors (they will start with <tt>E</tt>).
| <p>
| For more information on <prgn>lintian</prgn>, see <ref id="lintian">.
<item>
そのパッケージに対して <prgn>lintian</prgn> を実行してください。
<prgn>lintian</prgn> は、
<tt>lintian -v <var>package-version</var>.changes</tt>
として実行します。
こちらは、バイナリパッケージもソースパッケージもチェックします。
<prgn>lintian</prgn> が生成する出力が理解できない場合は、
<tt>-i</tt> スイッチを追加してご覧ください。
こうすれば <prgn>lintian</prgn> は、
そのプログラムに関する大変冗長な解説を出力します。
<p>
<prgn>lintian</prgn> がエラーを出した場合
(その行は <tt>E</tt> から始まります)、
通常はそのパッケージをアップロードすべきでは<em>ありません</em>。
<p>
<prgn>lintian</prgn> に関するより詳細な情報については
<ref id="lintian"> をご覧ください。
| <item>
| Downgrade the package to the previous version (if one exists) -- this
| tests the <tt>postrm</tt> and <tt>prerm</tt> scripts.
| <item>
| Remove the package, then reinstall it.
| </list>
<item>
そのパッケージを (もし存在すれば)
以前のバージョンにダウングレードしてみてください。
-- こちらは <tt>postrm</tt> および <tt>prerm</tt>
スクリプトのテストになります。
<item>
そのパッケージを削除し、それを再インストールしてみてください。
</list>
| <sect1 id="upload-master">Uploading to <tt>master</tt>
| <p>
| To upload a package, you need a personal account on
| <ftpsite>master.debian.org</ftpsite>. All maintainers should already
| have this account, see <ref id="servers-master">. You can use either
| <prgn>scp</prgn> or <prgn>ftp</prgn> to transfer the files. In either
| case, the files need to be placed into
| <ftppath>&master-upload-dir</ftppath>. (You cannot upload to Incoming
| on master using anonymous FTP -- you must use your user-name and
| password.)
<sect1 id="upload-master"><tt>master</tt> へのアップロード
<p>
パッケージをアップロードするためには、
<ftpsite>master.debian.org</ftpsite> に個人アカウントが必要です。
開発者はすでに全員このアカウントを持っているはずです。
こちらに関しては <ref id="servers-master"> をご覧ください。
そのファイル群を転送するには <prgn>scp</prgn> と <prgn>ftp</prgn>
のいずれも利用できます。
どちらを使う場合でも、そのファイル群は
<ftppath>&master-upload-dir</ftppath> に設置する必要があります。
匿名 FTP を利用して master 上の Incoming
にアップロードすることはできません。
-- ご自分のユーザ名とパスワードを使わなければなりません。)
| <p>
| <em>Note:</em> Do not upload packages containing software that is
| export-controlled by the United States government to <tt>master</tt>,
| nor to the overseas upload queues on <tt>chiark</tt> or
| <tt>erlangen</tt>. This prohibition covers almost all cryptographic
| software, and even sometimes software that contains ``hooks'' to
| cryptographic software, such as electronic mail readers that support
| PGP encryption and authentication. Uploads of such software should go
| to <tt>non-us</tt> (see <ref id="upload-non-us">). If you are not
| sure whether U.S. export controls apply to your package, post a
| message to &email-debian-devel; and ask.
<p>
<em>注意:</em> アメリカ合衆国政府によって輸出規制されているソフトウェアを
パッケージが含む場合は、それを <tt>master</tt> や、海外にある
<tt>chiark</tt> や <tt>erlangen</tt> のアップロードキューには
アップロードしないでください。
この規制は、ほぼすべての暗号ソフトウェアや、
時にはPGP 暗号および認証をサポート電子メールリーダのような
暗号ソフトウェアを「利用する」ソフトウェアにも及びます。
このようなソフトのアップロードは <tt>non-us</tt> に行なってください。
(<ref id="upload-non-us"> をご覧ください。)
アメリカ合衆国の輸出規制がご自分のパッケージに適用されるかどうか
はっきりしない場合は、&email-debian-devel;
にメッセージを投稿し質問してください。
| <p>
| You may also find the Debian package <package>dupload</package> useful
| when uploading packages. This handy program is distributed with
| defaults for uploading via <prgn>ftp</prgn> to <tt>master</tt>,
| <tt>chiark</tt>, and <tt>erlangen</tt>. It can also be configured to
| use <prgn>ssh</prgn>. See <manref name="dupload" section="1"> and
| <manref name="dupload" section="5"> for more information.
<p>
また、パッケージをアップロードする際、
Debian package <package>dupload</package>
が便利なことにお気づきになるでしょう。
この便利なプログラムは、デフォルトで
<prgn>ftp</prgn> を経由し <tt>master</tt> や、<tt>chiark</tt>、
<tt>erlangen</tt> へのアップロードができるようになっています。
こちらは <prgn>ssh</prgn> を利用するように設定することもできます。
より詳細な情報については <manref name="dupload" section="1"> と
<manref name="dupload" section="5"> をご覧ください。
| <sect1 id="upload-non-us">Uploading to <tt>pandora</tt> (non-us)
| <p>
| As discussed above, export controlled software should not be uploaded
| to <tt>master</tt>. Instead, use non-anonymous FTP or
| <prgn>scp</prgn> to copy the package to
| <ftpsite>pandora.debian.org</ftpsite>, placing the files in
| <ftppath>&non-us-upload-dir</ftppath>. By default, you can use your
| same account which works on <tt>master</tt>.
| <p>
| The program <prgn>dupload</prgn> comes with support for uploading to
| <tt>pandora</tt>; please refer to the documentation that comes with
| the program for details.
<sect1 id="upload-non-us"><tt>pandora</tt> (non-us) へのアップロード
<p>
前述の通り、輸出規制されているソフトウェアは
<tt>master</tt> にアップロードしてはいけません。
その代わりに 非匿名 FTP か <prgn>scp</prgn> を使って、
パッケージを <ftpsite>pandora.debian.org</ftpsite> にコピーし、
そのファイル群を <ftppath>&non-us-upload-dir</ftppath> に設置してください。
デフォルトで <tt>master</tt> と同じアカウントが使えます。
<p>
<prgn>dupload</prgn> プログラムは <tt>pandora</tt>
へのアップロードをサポートしています。
詳細はプログラム付属のドキュメントを参照してください。
| <sect1>Uploads via <tt>chiark</tt>
| <p>
| If you have a slow network connection to <tt>master</tt>, there are
| alternatives. One is to upload files to <tt>Incoming</tt> via a
| upload queue in Europe on <tt>chiark</tt>. For details connect to
| <url id="&url-chiark-readme;">.
| <p>
| <em>Note:</em> Do not upload packages containing software that is
| export-controlled by the United States government to the queue on
| <tt>chiark</tt>. Since this upload queue goes to <tt>master</tt>, the
| prescription found in <ref id="upload-master"> applies here as well.
| <p>
| The program <prgn>dupload</prgn> comes with support for uploading to
| <tt>chiark</tt>; please refer to the documentation that comes with the
| program for details.
<sect1><tt>chiark</tt> 経由のアップロード
<p>
<tt>master</tt> へのネットワーク接続が遅い場合、
その代わりとなるものがあります。
その一つが、<tt>chiark</tt> 上にあるヨーロッパのアップロードキュー経由で
<tt>Incoming</tt> にファイル群をアップロードする方法です。
その詳細については <url id="&url-chiark-readme;"> をご覧ください。
<p>
<em>注意:</em>アメリカ合衆国政府によって輸出規制されている
ソフトウェアを含むパッケージを <tt>chiark</tt>
のキューにアップロードしないでください。
このアップロードキューは <tt>master</tt> に向けられたものですので、
<ref id="upload-master"> で説明した法規がここでも同様に適用されます。
<p>
<prgn>dupload</prgn> プログラムは <tt>chiark</tt>
へのアップロードをサポートしています。
詳細はプログラム付属のドキュメントを参照してください。
| <sect1>Uploads via <tt>erlangen</tt>
| <p>
| Another upload queue is available in Germany: just upload the files
| via anonymous FTP to <url id="&url-upload-erlangen;">.
| <p>
| The upload must be a complete Debian upload, as you would put it into
| <tt>master</tt>'s <tt>Incoming</tt>, i.e., a <tt>.changes</tt> files
| along with the other files mentioned in the <tt>.changes</tt>. The
| queue daemon also checks that the <tt>.changes</tt> is correctly
| PGP-signed by a Debian developer, so that no bogus files can find
| their way to <tt>master</tt> via the queue. Please also make sure that
| the <tt>Maintainer</tt> field in the <tt>.changes</tt> contains
| <em>your</em> e-mail address. The address found there is used for all
| replies, just as on <tt>master</tt>.
<sect1><tt>erlangen</tt> 経由のアップロード
<p>
他にもドイツにあるアップロードキューが利用できます。
匿名 FTP 経由で <url id="&url-upload-erlangen;">
にファイル群をアップロードしてください。
<p>
そのアップロードは、
<tt>master</tt> の <tt>Incoming</tt> へのアップロードと同じように、
完全な Debian アップロードでなければなりません。
つまり、<tt>.changes</tt> ファイルで触れている他のファイルを添えて
<tt>.changes</tt> ファイルをアップロードします。
そのキューデーモンは <tt>.changes</tt> が Debian 開発者によって
正しく PGP 署名されているかどうかをチェックし、
不正なファイルはそのキュー経由では <tt>master</tt> へ転送しません。
<tt>.changes</tt> の <tt>Maintainer</tt> フィールドに、
<em>あなた</em>の電子メールアドレスがあるかどうかも確認してください。
そこに記述されたアドレスは
<tt>master</tt> と同様あらゆるリプライに使用されます。
| <p>
| There's no need to move your files into a second directory after the
| upload as on <tt>chiark</tt>. And, in any case, you should get some
| mail reply from the queue daemon what happened to your
| upload. Hopefully it should have been moved to <tt>master</tt>, but in
| case of errors you're notified, too.
| <p>
| <em>Note:</em> Do not upload packages containing software that is
| export-controlled by the United States government to the queue on
| <tt>erlangen</tt>. Since this upload queue goes to <tt>master</tt>, the
| prescription found in <ref id="upload-master"> applies here as well.
| <p>
| The program <prgn>dupload</prgn> comes with support for uploading to
| <tt>erlangen</tt>; please refer to the documentation that comes with
| the program for details.
<p>
<tt>chiark</tt> と同様に、アップロードのあとご自分のファイルを
セカンドディレクトリに移動する必要はありません。
また、どんな場合でもアップロードがどうなったかについて、
キューデーモンから返信メールを受け取るはずです。
あなた宛てにエラーが通知されない限り
おそらくこちらも <tt>master</tt> へ移動されるはずです。
<p>
<em>注意:</em>アメリカ合衆国政府によって輸出規制されている
ソフトウェアを含むパッケージを <tt>erlangen</tt>
のキューにアップロードしないでください。
このアップロードキューは <tt>master</tt> に向けられたものですので、
<ref id="upload-master"> で説明した法規がここでも同様に適用されます。
<p>
<prgn>dupload</prgn> プログラムは <tt>erlangen</tt>
へのアップロードをサポートしています。
詳細はプログラム付属のドキュメントを参照してください。
| <sect1>Other Upload Queues
| <p>
| Another upload queue is available which is based in the US, and is a
| good backup when there are problems reaching <tt>master</tt>. You can
| upload files, just as in <tt>erlangen</tt>, to <url
| id="&url-upload-samosa;">.
| <p>
| An upload queue is available in Japan: just upload the files via
| anonymous FTP to <url id="&url-upload-jp;">.
<sect1>他のアップロードキュー
<p>
アメリカ合衆国にある他のアップロードキューも利用できます。
こちらは <tt>master</tt> に接続できない問題が発生した際の
優れたバックアップ手段です。
<tt>erlangen</tt> と同様に <url id="&url-upload-samosa;">
にファイル群をアップロードすることができます。
<p>
日本でもアップロードキューが利用できます。<url id="&url-upload-jp;">
への匿名 FTP 経由でファイル群をアップロードしてください。
| <sect id="upload-announce">Announcing package uploads
| <p>
| When a package is uploaded an announcement should be posted to one of
| the ``debian-changes'' lists. The announcement should give the
| (source) package name and version number, and a very short summary of
| the changes, in the <em>Subject</em> field, and should contain the
| PGP-signed <tt>.changes</tt> file. Some additional explanatory text
| may be added before the start of the <tt>.changes</tt> file.
| <p>
| If a package is released with the <tt>Distribution:</tt> set to
| `stable', the announcement is sent to &email-debian-changes;. If a
| package is released with <tt>Distribution:</tt> set to `unstable',
| `experimental', or `frozen' (when present), the announcement should be
| posted to &email-debian-devel-changes; instead.
<sect id="upload-announce">パッケージアップロードのアナウンス
<p>
パッケージをアップロードしたら、
そのアナウンスを``debian-changes''
メーリングリストの一つに投稿しなければなりません。
そのアナウンスの <em>Subject</em> フィールドには
(ソース) パッケージ名、バージョン番号、変更事項の極めて簡潔な要約を含め、
その本文には PGP で署名された <tt>.changes</tt> ファイルを含めます。
付加的な説明文は <tt>.changes</tt> ファイルの前に付け加えます。
<p>
あるパッケージが、その <tt>Distribution:</tt> フィールドに
`stable' と記述されてリリースされる場合、
そのアナウンスは &email-debian-changes; に送ります。
一方あるパッケージが、その <tt>Distribution:</tt> フィールドに
`unstable' や、`experimental'、(もしあれば) `frozen'
などが記述されてリリースされる場合、
そのアナウンスは &email-debian-devel-changes; に送らなければなりません。
| <p>
| On occasion, it is necessary to upload a package to both the
| <em>stable</em> and <em>unstable</em> distributions; this is done by
| putting both distributions in the <tt>Distribution:</tt> line. In
| such a case the upload announcement should go to both of the above
| mailing lists.
| <p>
| The <prgn>dupload</prgn> program is clever enough to determine for itself
| where the announcement should go, and will automatically mail the
| announcement to the right list. See <ref id="dupload">.
<p>
場合によっては、<em>stable</em> と <em>unstable</em>
ディストリビューションの両方にパッケージをアップロードする必要がありますが、
この場合は <tt>Distribution:</tt> フィールドに
両方のディストリビューション名を記述してください。
この場合アップロードアナウンスは、
上記のメーリングリストの両方に投稿してください。
<p>
なお、<prgn>dupload</prgn> プログラムは、
アナウンスをどこへ投稿すべきかを判断し
適切なメーリングリストに自動的にアナウンスを投稿してくれます。
<ref id="dupload"> をご覧ください。
| <sect id="upload-notification">
| <heading>Notification that a new package has been installed</heading>
| <p>
| The Debian archive maintainers are responsible for handling package
| uploads. For the most part, uploads are automatically handled on a
| daily basis by an archive maintenance tool called
| <prgn>dinstall</prgn>. Specifically, updates to existing packages to
| the `unstable' distribution are handled automatically. In other cases,
| notably new packages, placing the uploaded package into the
| distribution is handled manually. When uploads are handled manually,
| the change to the archive may take up to a week to occur (please be
| patient).
| <p>
| In any case, you will receive notification indicating that the package
| has been uploaded via email. Please examine this notification
| carefully. You may notice that the package didn't go into the section
| you thought you set it to go into. Read on for why.
<sect id="upload-notification">
<heading>新規パッケージインストールの通知</heading>
<p>
Debian アーカイブメンテナが、
アップロードされたパッケージの処理に責任を持ちます。
ほとんどの場合アップロードは、
<prgn>dinstall</prgn> というアーカイブメンテナンスツールによって
基本的に毎日自動的に処理されます。
特に `unstable' ディストリビューションに存在するパッケージのアップロードは、
自動的に処理されます。
ただ、その他の場合、特に新規パッケージのような場合には、
特定のディストリビューションへのパッケージアップロードは手動で処理されます。
アップロードされたパッケージが手動で処理される場合、
アーカイブの変更には一週間ほど時間がかかります。
(辛抱強くお待ちください。)
<p>
どんな場合でも、パッケージアップロードの通知を電子メールで受け取れます。
この通知の内容は十分注意してお確かめください。
パッケージがあなたの想定していたセクションに設置されなかった場合、
そのことがこちらで通知されるでしょう。
その理由に関してはこちらを良くお読みください。
| <sect1 id="override-file">The override file
| <p>
| The <file>debian/control</file> file's <tt>Section</tt> and
| <tt>Priority</tt> fields do not actually specify where the file will
| be placed in the archive, nor its priority. In order to retain the
| overall integrity of the archive, it is the archive maintainers who
| have control over these fields. The values in the
| <file>debian/control</file> file are actually just hints.
<sect1 id="override-file">オーバライドファイル
<p>
<file>debian/control</file> ファイルの
<tt>Section</tt> および <tt>Priority</tt> フィールドは、
そのファイルがアーカイブのどこに設置されるかや、その priority を
実際に特定するものではありません。
アーカイブ全体を整理された状態にしておくために、
これらのフィールドの管理はアーカイブメンテナが行ないます。
そのため <file>debian/control</file> ファイルに設定された値は、
実際はそのヒントになるだけです。
| <p>
| The archive maintainers keep track of the canonical sections and
| priorities for packages in the <em>override file</em>. Sometimes the
| <em>override file</em> needs correcting. Simply changing the
| package's <file>control</file> file is not going to work. Instead,
| you should email &email-override; or submit a bug against
| <package>ftp.debian.org</package>.
| <p>
| For more information about <em>override files</em>, see <manref
| name="dpkg-scanpackages" section="8">, &file-bts-mailing;, and
| &file-bts-info;.
<p>
アーカイブメンテナは、パッケージの正式なセクションやプライオリティを
<em>override file</em> にて管理します。
場合によっては <em>override file</em> は修正が必要になります。
ただ、パッケージの <file>control</file>
ファイルを単に変更しても効果はありません。
その代わりに &email-override; に電子メールを送るか、
<package>ftp.debian.org</package>
に対するバグとして報告を行なわなければなりません
<p>
<em>override files</em> に関するより詳細な情報については、
<manref name="dpkg-scanpackages" section="8"> や、
&file-bts-mailing;、&file-bts-info; をご覧ください。
--
Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>