1 # Debian Developer's Reference (Japanese)
2 # Hideki Yamane (Debian-JP) <henrich@debian.or.jp>, 2008-2011.
6 "Project-Id-Version: developers-reference 3.4.4\n"
7 "POT-Creation-Date: 2011-04-20 21:36-0400\n"
8 "PO-Revision-Date: 2011-02-13 15:32+0100\n"
9 "Last-Translator: Hideki Yamane <henrich@debian.org>\n"
10 "Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n"
11 "Language: Japanese\n"
13 "Content-Type: text/plain; charset=UTF-8\n"
14 "Content-Transfer-Encoding: 8bit\n"
16 # type: Content of: <chapter><title>
17 #. type: Content of: <chapter><title>
19 msgid "Managing Packages"
22 # type: Content of: <chapter><para>
23 #. type: Content of: <chapter><para>
26 "This chapter contains information related to creating, uploading, "
27 "maintaining, and porting packages."
29 "この章では、パッケージの作成、アップロード、メンテナンス、移植についての情報"
32 # type: Content of: <chapter><section><title>
33 #. type: Content of: <chapter><section><title>
38 # type: Content of: <chapter><section><para>
39 #. type: Content of: <chapter><section><para>
42 "If you want to create a new package for the Debian distribution, you should "
43 "first check the <ulink url=\"&url-wnpp;\">Work-Needing and Prospective "
44 "Packages (WNPP)</ulink> list. Checking the WNPP list ensures that no one is "
45 "already working on packaging that software, and that effort is not "
46 "duplicated. Read the <ulink url=\"&url-wnpp;\">WNPP web pages</ulink> for "
49 "もしあなたが Debian ディストリビューションに対して新たなパッケージを作成した"
50 "いという場合、まず <ulink url=\"&url-wnpp;\">作業が望まれるパッケージ (Work-"
51 "Needing and Prospective Packages (WNPP))</ulink> の一覧をチェックする必要があ"
52 "ります。WNPP 一覧をチェックすることで、まだ誰もそのソフトをパッケージ化してい"
53 "ないことや、作業が重複していないことを確認します。詳細については <ulink url="
54 "\"&url-wnpp;\">WNPP のページ</ulink> を読んでください。"
56 # type: Content of: <chapter><section><para>
57 # FIXME: "but not limiting yourself to"?
58 #. type: Content of: <chapter><section><para>
61 "Assuming no one else is already working on your prospective package, you "
62 "must then submit a bug report (<xref linkend=\"submit-bug\"/>) against the "
63 "pseudo-package <systemitem role=\"package\">wnpp</systemitem> describing "
64 "your plan to create a new package, including, but not limiting yourself to, "
65 "a description of the package, the license of the prospective package, and "
66 "the current URL where it can be downloaded from."
68 "パッケージ化しようとしているソフトについて、誰もまだ作業していないようであれ"
69 "ば、まずは <systemitem role=\"package\">wnpp</systemitem> 擬似パッケージ "
70 "(pseudo-package) に対してバグ報告を投稿する必要があります (<xref linkend="
71 "\"submit-bug\"/>)。このバグ報告には、パッケージの説明、作業しようとしている"
72 "パッケージのライセンス、ダウンロードが可能な現在の URL を含めた新規パッケージ"
73 "の作成予定 (自分自身が分かるだけではないもの) を記述します。"
75 # type: Content of: <chapter><section><para>
76 #. type: Content of: <chapter><section><para>
79 "You should set the subject of the bug to <literal>ITP: <replaceable>foo</"
80 "replaceable> -- <replaceable>short description</replaceable></literal>, "
81 "substituting the name of the new package for <replaceable>foo</"
82 "replaceable>. The severity of the bug report must be set to "
83 "<literal>wishlist</literal>. Please send a copy to &email-debian-devel; by "
84 "using the X-Debbugs-CC header (don't use CC:, because that way the message's "
85 "subject won't indicate the bug number). If you are packaging so many new "
86 "packages (>10) that notifying the mailing list in separate messages is too "
87 "disruptive, send a summary after filing the bugs to the debian-devel list "
88 "instead. This will inform the other developers about upcoming packages and "
89 "will allow a review of your description and package name."
91 "サブジェクトを <literal>ITP: <replaceable>foo</replaceable> -- "
92 "<replaceable>short description</replaceable></literal> に設定する必要がありま"
93 "す。ここでは <replaceable>foo</replaceable> は新規パッケージの名前に置き換え"
94 "ます。バグ報告の重要度は <literal>wishlist</literal> に設定しなければなりませ"
95 "ん。X-Debbugs-CC ヘッダを使ってコピーを &email-debian-devel; に送信してくださ"
96 "い (CC: は使わないでください。CC: を使った場合はメールのサブジェクトにバグ番"
97 "号が付与されないためです)。大量の新規パッケージの作成 (11 個以上) を行ってい"
98 "る場合、メーリングリストへ個別に通知するのは鬱陶しいので、代わりにバグを登録"
99 "した後で要約を送信してください。これによって、他の開発者らに次に来るパッケー"
100 "ジを知らせ、説明とパッケージ名のレビューが可能になります。"
102 # type: Content of: <chapter><section><para>
103 #. type: Content of: <chapter><section><para>
106 "Please include a <literal>Closes: #<replaceable>nnnnn</replaceable></"
107 "literal> entry in the changelog of the new package in order for the bug "
108 "report to be automatically closed once the new package is installed in the "
109 "archive (see <xref linkend=\"upload-bugfix\"/>)."
111 "新規パッケージがアーカイブへインストールされる際にバグ報告を自動的に閉じるた"
112 "め、<literal>Closes: #<replaceable>nnnnn</replaceable></literal> というエント"
113 "リを新規パッケージの changelog 内に含めてください (<xref linkend=\"upload-"
116 # FIXME: ftpmaster@debian.org
117 #. type: Content of: <chapter><section><para>
120 "If you think your package needs some explanations for the administrators of "
121 "the NEW package queue, include them in your changelog, send to &email-"
122 "ftpmaster; a reply to the email you receive as a maintainer after your "
123 "upload, or reply to the rejection email in case you are already re-uploading."
125 "パッケージについて、NEW パッケージキューの管理者への説明が必要だろうと思う場"
126 "合は、changelog に説明を含めて &email-ftpmaster; へ送ってください。アップロー"
127 "ド後であればメンテナとして受け取ったメールに返信してください。もしくは既に再"
128 "アップロード最中の場合は reject メールに対して返信してください。"
130 # type: Content of: <chapter><section><para>
131 #. type: Content of: <chapter><section><para>
134 "When closing security bugs include CVE numbers as well as the "
135 "<literal>Closes: #<replaceable>nnnnn</replaceable></literal>. This is "
136 "useful for the security team to track vulnerabilities. If an upload is made "
137 "to fix the bug before the advisory ID is known, it is encouraged to modify "
138 "the historical changelog entry with the next upload. Even in this case, "
139 "please include all available pointers to background information in the "
140 "original changelog entry."
142 "セキュリティバグを閉じる場合は、CVE 番号を <literal>Closes: "
143 "#<replaceable>nnnnn</replaceable></literal> と同じく含めるようにしてくださ"
144 "い。これは、セキュリティチームが脆弱性を追跡するのに役立ちます。アドバイザリ"
145 "の ID が分かる前にバグ修正のためのアップロードが行われた場合は、以前の "
146 "changelog エントリを次のアップロード時に修正するのが推奨されています。このよ"
147 "うな場合でも、元々の changelog での記載に可能な限り背景情報へのポインタを全て"
150 # type: Content of: <chapter><section><para>
151 #. type: Content of: <chapter><section><para>
154 "There are a number of reasons why we ask maintainers to announce their "
157 "我々がメンテナに意図しているところをアナウンスする様に求めるのには、いくつも"
160 # type: Content of: <chapter><section><itemizedlist><listitem><para>
161 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
164 "It helps the (potentially new) maintainer to tap into the experience of "
165 "people on the list, and lets them know if anyone else is working on it "
168 "(潜在的な新たな) メンテナが、メーリングリストの人々の経験を活かすのを手助け"
169 "し、もし他の誰かが既に作業を行っていた場合に知らせる。"
171 # type: Content of: <chapter><section><itemizedlist><listitem><para>
172 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
175 "It lets other people thinking about working on the package know that there "
176 "already is a volunteer, so efforts may be shared."
178 "そのパッケージについての作業を検討している他の人へ、既に作業をしているボラン"
179 "ティアがいることを知らせ、労力が共有される。"
181 # type: Content of: <chapter><section><itemizedlist><listitem><para>
182 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
185 "It lets the rest of the maintainers know more about the package than the one "
186 "line description and the usual changelog entry ``Initial release'' that gets "
187 "posted to &email-debian-devel-changes;."
189 "&email-debian-devel-changes; に流される一行の説明文 (description) と通常どお"
190 "りの「Intial release」という changelog エントリよりも、残った他のメンテナが"
191 "パッケージに関してより深く知ることができる。"
193 # type: Content of: <chapter><section><itemizedlist><listitem><para>
194 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
197 "It is helpful to the people who live off <literal>unstable</literal> (and "
198 "form our first line of testers). We should encourage these people."
200 "<literal>不安定版 (unstable)</literal> で暮らす人 (そして最前線のテスターであ"
203 # type: Content of: <chapter><section><itemizedlist><listitem><para>
204 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
207 "The announcements give maintainers and other interested parties a better "
208 "feel of what is going on, and what is new, in the project."
210 "メンテナや他に興味を持つ人々へ、プロジェクトで何が行われているのか、何か新し"
211 "いことがあるかということ関して、告知は良い印象を与える。"
213 # type: Content of: <chapter><section><para>
214 #. type: Content of: <chapter><section><para>
217 "Please see <ulink url=\"http://&ftp-master-host;/REJECT-FAQ.html\"></ulink> "
218 "for common rejection reasons for a new package."
220 "新しいパッケージに対するよくある拒否理由については <ulink url=\"http://&ftp-"
221 "master-host;/REJECT-FAQ.html\"></ulink> を参照してください。"
223 # type: Content of: <chapter><section><title>
224 #. type: Content of: <chapter><section><title>
226 msgid "Recording changes in the package"
227 msgstr "パッケージの変更を記録する"
229 # type: Content of: <chapter><section><para>
230 #. type: Content of: <chapter><section><para>
233 "Changes that you make to the package need to be recorded in the "
234 "<filename>debian/changelog</filename>. These changes should provide a "
235 "concise description of what was changed, why (if it's in doubt), and note if "
236 "any bugs were closed. They also record when the package was completed. "
237 "This file will be installed in <filename>/usr/share/doc/"
238 "<replaceable>package</replaceable>/changelog.Debian.gz</filename>, or "
239 "<filename>/usr/share/doc/<replaceable>package</replaceable>/changelog.gz</"
240 "filename> for native packages."
242 "パッケージについて行った変更は <filename>debian/changelog</filename> に記録さ"
243 "れなくてはいけません。これらの変更には、何が変更されたのか、(不確かであれば) "
244 "何故なのか、そしてどのバグが閉じられたのかの簡潔な説明文を付加する必要があり"
245 "ます。このファイルは <filename>/usr/share/doc/<replaceable>package</"
246 "replaceable>/changelog.Debian.gz</filename>、あるいはネイティブパッケージの場"
247 "合は <filename>/usr/share/doc/<replaceable>package</replaceable>/changelog."
248 "gz</filename> にインストールされます。"
250 # type: Content of: <chapter><section><para>
251 #. type: Content of: <chapter><section><para>
254 "The <filename>debian/changelog</filename> file conforms to a certain "
255 "structure, with a number of different fields. One field of note, the "
256 "<literal>distribution</literal>, is described in <xref linkend=\"distribution"
257 "\"/>. More information about the structure of this file can be found in the "
258 "Debian Policy section titled <filename>debian/changelog</filename>."
260 "<filename>debian/changelog</filename> ファイルは、幾つもの異なった項目からな"
261 "る特定の構造に従っています。一点を取り上げてみると、<literal>distribution</"
262 "literal> については<xref linkend=\"distribution\"/>に記述されています。この"
263 "ファイルの構造について、より詳細な情報は Debian ポリシーの <filename>debian/"
264 "changelog</filename> という章で確認できます。"
266 # type: Content of: <chapter><section><para>
267 #. type: Content of: <chapter><section><para>
270 "Changelog entries can be used to automatically close Debian bugs when the "
271 "package is installed into the archive. See <xref linkend=\"upload-bugfix\"/"
274 "changelog への記載は、パッケージがアーカイブにインストールされる際、自動的に "
275 "Debian バグを閉じるのに利用できます。<xref linkend=\"upload-bugfix\"/> を参照"
278 # type: Content of: <chapter><section><para>
279 #. type: Content of: <chapter><section><para>
282 "It is conventional that the changelog entry of a package that contains a new "
283 "upstream version of the software looks like this:"
285 "ソフトウェアの新しい開発元のバージョン (new upstream version) を含むパッケー"
286 "ジの changelog エントリは、以下のようにするのが慣習です:"
288 # type: Content of: <chapter><section><screen>
289 #. type: Content of: <chapter><section><screen>
292 msgid " * New upstream release.\n"
293 msgstr " * New upstream release.\n"
295 # type: Content of: <chapter><section><para>
296 #. type: Content of: <chapter><section><para>
299 "There are tools to help you create entries and finalize the "
300 "<filename>changelog</filename> for release — see <xref linkend=\"devscripts"
301 "\"/> and <xref linkend=\"dpkg-dev-el\"/>."
303 "<filename>changelog</filename> エントリの作成と仕上げ処理に使えるツールがあり"
304 "ます。<xref linkend=\"devscripts\"/> と <xref linkend=\"dpkg-dev-el\"/> を参"
307 # type: Content of: <chapter><section><para>
308 #. type: Content of: <chapter><section><para>
310 msgid "See also <xref linkend=\"bpp-debian-changelog\"/>."
311 msgstr "<xref linkend=\"bpp-debian-changelog\"/> も参照してください。"
313 # type: Content of: <chapter><section><title>
314 #. type: Content of: <chapter><section><title>
316 msgid "Testing the package"
319 # type: Content of: <chapter><section><para>
321 #. type: Content of: <chapter><section><para>
324 "Before you upload your package, you should do basic testing on it. At a "
325 "minimum, you should try the following activities (you'll need to have an "
326 "older version of the same Debian package around):"
328 "パッケージをアップロードする前に、基本的なテストをする必要があります。最低"
329 "限、以下の作業が必要です (同じ Debian パッケージの古いバージョンなどが必要に"
332 # type: Content of: <chapter><section><itemizedlist><listitem><para>
333 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
336 "Install the package and make sure the software works, or upgrade the package "
337 "from an older version to your new version if a Debian package for it already "
340 "パッケージをインストールしてソフトウェアが動作するのを確認する、あるいは既に"
341 "そのソフトの Debian パッケージが存在している場合、パッケージを以前のバージョ"
342 "ンから新しいバージョンにアップグレードする。"
344 # type: Content of: <chapter><section><itemizedlist><listitem><para>
345 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
348 "Run <command>lintian</command> over the package. You can run "
349 "<command>lintian</command> as follows: <literal>lintian -v "
350 "<replaceable>package-version</replaceable>.changes</literal>. This will "
351 "check the source package as well as the binary package. If you don't "
352 "understand the output that <command>lintian</command> generates, try adding "
353 "the <literal>-i</literal> switch, which will cause <command>lintian</"
354 "command> to output a very verbose description of the problem."
356 "パッケージに対して <command>lintian</command> を実行する。以下のようにして "
357 "<command>lintian</command> を実行できます: <literal>lintian -v "
358 "<replaceable>package-version</replaceable>.changes</literal> 。"
359 "<command>lintian</command> が生成した出力を理解していない場合は、"
360 "<command>lintian</command> が問題の説明を非常に冗長に出力するようにする "
361 "<literal>-i</literal> オプションを付けて実行してみてください。"
363 # type: Content of: <chapter><section><itemizedlist><listitem><para>
364 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
367 "Normally, a package should <emphasis>not</emphasis> be uploaded if it causes "
368 "<command>lintian</command> to emit errors (they will start with <literal>E</"
371 "通常、<command>lintian</command> がエラーを出力するようであれば、パッケージを"
372 "アップロードしては<emphasis>いけません</emphasis> (エラーは <literal>E</"
375 # type: Content of: <chapter><section><itemizedlist><listitem><para>
376 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
379 "For more information on <command>lintian</command>, see <xref linkend="
382 "<command>lintian</command> についての詳細は、<xref linkend=\"lintian\"/> を参"
385 # type: Content of: <chapter><section><itemizedlist><listitem><para>
386 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
389 "Optionally run <command>debdiff</command> (see <xref linkend=\"debdiff\"/>) "
390 "to analyze changes from an older version, if one exists."
392 "もし古いバージョンがあれば、それからの変更点を分析するために追加で "
393 "<command>debdiff</command> を実行する (<xref linkend=\"debdiff\"/> を参照) 。"
395 # type: Content of: <chapter><section><itemizedlist><listitem><para>
396 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
399 "Downgrade the package to the previous version (if one exists) — this tests "
400 "the <filename>postrm</filename> and <filename>prerm</filename> scripts."
402 "(もしあれば) 以前のバージョンにダウングレードする — これは <filename>postrm</"
403 "filename> スクリプトと <filename>prerm</filename> スクリプトをテストします。"
405 # type: Content of: <chapter><section><itemizedlist><listitem><para>
406 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
408 msgid "Remove the package, then reinstall it."
409 msgstr "パッケージを削除して、再インストールする。"
411 # type: Content of: <chapter><section><itemizedlist><listitem><para>
412 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
415 "Copy the source package in a different directory and try unpacking it and "
416 "rebuilding it. This tests if the package relies on existing files outside "
417 "of it, or if it relies on permissions being preserved on the files shipped "
418 "inside the <filename>.diff.gz</filename> file."
420 "ソースパッケージを違うディレクトリにコピーして展開し、再構築する。これは、"
421 "パッケージが外部の既存ファイルに依っているか、<filename>.diff.gz</filename> "
422 "ファイル内に含まれているファイルで保存されている権限に依るかどうかをテストし"
425 # type: Content of: <chapter><section><title>
426 #. type: Content of: <chapter><section><title>
428 msgid "Layout of the source package"
431 # type: Content of: <chapter><section><para>
432 #. type: Content of: <chapter><section><para>
434 msgid "There are two types of Debian source packages:"
435 msgstr "Debian のソースパッケージには 2 種類あります:"
437 # type: Content of: <chapter><section><itemizedlist><listitem><para>
438 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
441 "the so-called <literal>native</literal> packages, where there is no "
442 "distinction between the original sources and the patches applied for Debian"
444 "いわゆる <literal>ネイティブ (native)</literal> パッケージ。元のソースと "
445 "Debian で当てられたパッチの間に差が無いもの"
447 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
450 "the (more common) packages where there's an original source tarball file "
451 "accompanied by another file that contains the changes made by Debian"
453 "オリジナルのソースコードの tarball ファイルに、Debian によって作成された変更"
454 "点を含む別のファイルが付随している (より一般的な) パッケージ"
456 #. type: Content of: <chapter><section><para>
459 "For the native packages, the source package includes a Debian source control "
460 "file (<filename>.dsc</filename>) and the source tarball (<filename>.tar.{gz,"
461 "bz2,lzma}</filename>). A source package of a non-native package includes a "
462 "Debian source control file, the original source tarball (<filename>.orig.tar."
463 "{gz,bz2,lzma}</filename>) and the Debian changes (<filename>.diff.gz</"
464 "filename> for the source format “1.0” or <filename>.debian.tar.{gz,bz2,lzma}"
465 "</filename> for the source format “3.0 (quilt)”)."
467 "ネイティブパッケージの場合、ソースパッケージは Debian のソース control ファイ"
468 "ル (<filename>.dsc</filename>) とソースコードの tarball (<filename>.tar.{gz,"
469 "bz2,lzma}</filename>) を含んでいます。ネイティブではないパッケージのソース"
470 "パッケージは Debian のソース control ファイルと、オリジナルのソースコードの "
471 "tarball (<filename>.orig.tar.{gz,bz2,lzma}</filename>)、そして Debian での変"
472 "更点 (ソース形式“1.0”は <filename>.diff.gz</filename>、ソース形式“3.0 "
473 "(quilt)”は <filename>.debian.tar.{gz,bz2,lzma}</filename>) を含んでいます。"
475 #. type: Content of: <chapter><section><para>
478 "With source format “1.0”, whether a package is native or not was determined "
479 "by <command>dpkg-source</command> at build time. Nowadays it is recommended "
480 "to be explicit about the desired source format by putting either “3.0 "
481 "(quilt)” or “3.0 (native)” in <filename>debian/source/format</filename>. "
482 "The rest of this section relates only to non-native packages."
484 "ソース形式“1.0”では、パッケージが native かどうかはビルド時に <command>dpkg-"
485 "source</command> によって決められていました。最近では望むソース形式を "
486 "<filename>debian/source/format</filename> に“3.0 (quilt)”または“3.0 "
487 "(native)”と記述することによって明示することが推奨されています。この章の残りの"
488 "部分は native ではないパッケージについてのみ記しています。"
490 # type: Content of: <chapter><section><para>
491 #. type: Content of: <chapter><section><para>
494 "The first time a version is uploaded which corresponds to a particular "
495 "upstream version, the original source tar file should be uploaded and "
496 "included in the <filename>.changes</filename> file. Subsequently, this very "
497 "same tar file should be used to build the new diffs and <filename>.dsc</"
498 "filename> files, and will not need to be re-uploaded."
500 "初回には、特定の開発元のバージョン (upstream version) に該当するバージョンが"
501 "アップロードされます。元のソース tar ファイルは、アップロードされて "
502 "<filename>.changes</filename> ファイルに含まれている必要があります。その後、"
503 "新しい diff ファイルや <filename>.dsc</filename> ファイルの生成には全く同じ "
504 "tar ファイルを使わなければならず、これを再アップロードする必要はありません。"
506 #. type: Content of: <chapter><section><para>
509 "By default, <command>dpkg-genchanges</command> and <command>dpkg-"
510 "buildpackage</command> will include the original source tar file if and only "
511 "if the current changelog entry has a different upstream version from the "
512 "preceding entry. This behavior may be modified by using <literal>-sa</"
513 "literal> to always include it or <literal>-sd</literal> to always leave it "
516 "デフォルトでは、<command>dpkg-genchanges</command> および <command>dpkg-"
517 "buildpackage</command> は前述されている changelog エントリと現在のエントリが"
518 "異なった upstream バージョンを持つ場合にのみ、オリジナルのソース tar ファイル"
519 "を含めようとします。この挙動は、<literal>-sa</literal> を使って常に含めたり、"
520 "<literal>-sd</literal> を使うことで常に含めないようにするように変更できます。"
522 # type: Content of: <chapter><section><para>
523 #. type: Content of: <chapter><section><para>
526 "If no original source is included in the upload, the original source tar-"
527 "file used by <command>dpkg-source</command> when constructing the <filename>."
528 "dsc</filename> file and diff to be uploaded <emphasis>must</emphasis> be "
529 "byte-for-byte identical with the one already in the archive."
531 "アップロード時にオリジナルのソースが含まれていない場合、アップロードされる "
532 "<filename>.dsc</filename> と diff ファイルを構築する際に <command>dpkg-"
533 "source</command> が使用するオリジナルの tar ファイルは、<emphasis>必ず</"
534 "emphasis>既にアーカイブにあるものと 1 バイトも違わぬものでなくてはなりませ"
537 #. type: Content of: <chapter><section><para>
540 "Please notice that, in non-native packages, permissions on files that are "
541 "not present in the <filename>*.orig.tar.{gz,bz2,lzma}</filename> will not be "
542 "preserved, as diff does not store file permissions in the patch. However "
543 "when using source format “3.0 (quilt)”, permissions of files inside the "
544 "<filename>debian</filename> directory are preserved since they are stored in "
547 "注意していただきたいのですが、native ではないパッケージでは、diff はパッチ内"
548 "のファイルパーミッションを保存しないので、<filename>*.orig.tar.{gz,bz2,lzma}"
549 "</filename> 内に存在しないファイルのパーミッションは保持されません。しかし、"
550 "ソース形式“3.0 (quilt)”を使っている場合、<filename>debian</filename> ディレク"
551 "トリ内にあるファイルのパーミッションは tar アーカイブで保存されるのでそのまま"
554 # type: Content of: <chapter><section><title>
555 #. type: Content of: <chapter><section><title>
557 msgid "Picking a distribution"
558 msgstr "ディストリビューションを選ぶ"
560 # type: Content of: <chapter><section><para>
561 #. type: Content of: <chapter><section><para>
564 "Each upload needs to specify which distribution the package is intended "
565 "for. The package build process extracts this information from the first "
566 "line of the <filename>debian/changelog</filename> file and places it in the "
567 "<literal>Distribution</literal> field of the <filename>.changes</filename> "
570 "アップロードでは、パッケージがどのディストリビューション向けになっているかを"
571 "指定してあることが必要です。パッケージの構築プロセスでは、<filename>debian/"
572 "changelog</filename> ファイルの最初の行からこの情報を展開し、<filename>."
573 "changes</filename> ファイルの <literal>Distribution</literal> 欄に配置しま"
576 # type: Content of: <chapter><section><para>
577 #. type: Content of: <chapter><section><para>
580 "There are several possible values for this field: <literal>stable</literal>, "
581 "<literal>unstable</literal>, <literal>testing-proposed-updates</literal> and "
582 "<literal>experimental</literal>. Normally, packages are uploaded into "
583 "<literal>unstable</literal>."
585 "この欄にはいくつか指定可能な値があります: <literal>stable</literal>、"
586 "<literal>unstable</literal>、<literal>testing-proposed-updates</literal>、そ"
587 "して <literal>experimental</literal> です。通常、パッケージは "
588 "<literal>unstable</literal> にアップロードされます。"
590 # type: Content of: <chapter><section><para>
591 #. type: Content of: <chapter><section><para>
594 "Actually, there are two other possible distributions: <literal>stable-"
595 "security</literal> and <literal>testing-security</literal>, but read <xref "
596 "linkend=\"bug-security\"/> for more information on those."
598 "実際には、他に二つ指定可能なディストリビューションがあります: "
599 "<literal>stable-security</literal> と <literal>testing-security</literal> で"
600 "すが、これらについての詳細は <xref linkend=\"bug-security\"/> を読んでくださ"
603 # type: Content of: <chapter><section><para>
604 #. type: Content of: <chapter><section><para>
607 "It is not possible to upload a package into several distributions at the "
610 "同時に複数のディストリビューションへ、パッケージをアップロードすることはでき"
613 # type: Content of: <chapter><section><section><title>
614 #. type: Content of: <chapter><section><section><title>
617 "Special case: uploads to the <literal>stable</literal> and "
618 "<literal>oldstable</literal> distributions"
620 "特別な例: <literal>安定版 (stable)</literal> と <literal>旧安定版 (oldstable)"
621 "</literal> ディストリビューションへアップロードする"
623 #. type: Content of: <chapter><section><section><para>
626 "Uploading to <literal>stable</literal> means that the package will "
627 "transferred to the <literal>proposed-updates-new</literal> queue for review "
628 "by the stable release managers, and if approved will be installed in "
629 "<filename>stable-proposed-updates</filename> directory of the Debian "
630 "archive. From there, it will be included in <literal>stable</literal> with "
631 "the next point release."
633 "<literal>安定版 (stable)</literal> へのアップロードは、安定版リリースマネー"
634 "ジャによるレビューのため、パッケージが <literal>proposed-updates-new</"
635 "literal> キューに転送され、許可された場合は Debian アーカイブの "
636 "<filename>stable-proposed-updates</filename> ディレクトリにインストールされま"
639 # type: Content of: <chapter><section><section><para>
640 #. type: Content of: <chapter><section><section><para>
643 "To ensure that your upload will be accepted, you should discuss the changes "
644 "with the stable release team before you upload. For that, send a mail to the "
645 "&email-debian-release; mailing list, including the patch you want to apply "
646 "to the package version currently in <literal>stable</literal>. Always be "
647 "verbose and detailed in your changelog entries for uploads to the "
648 "<literal>stable</literal> distribution."
650 "アップロードが許可されるのを確実にするには、アップロードの前に変更点について"
651 "安定版リリースチームと協議する必要があります。そのためには、<literal>安定版 "
652 "(stable)</literal> にある現在のパッケージバージョンに適用したいパッチを含めた"
653 "メールを &email-debian-release; メーリングリストに送ってください。<literal>安"
654 "定版 (stable)</literal> ディストリビューションへアップロードするパッケージの "
655 "changelog のエントリには常にくどいほど詳細にしてください。"
657 # type: Content of: <chapter><section><section><para>
658 #. type: Content of: <chapter><section><section><para>
661 "Extra care should be taken when uploading to <literal>stable</literal>. "
662 "Basically, a package should only be uploaded to <literal>stable</literal> if "
663 "one of the following happens:"
665 "<literal>安定版 (stable)</literal> へのアップロード時には特に注意を払うことが"
666 "必要です。基本的に、以下のいずれかが起こった際にのみ <literal>安定版 (stable)"
667 "</literal> へパッケージはアップロードされます:"
669 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
670 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
672 msgid "a truly critical functionality problem"
673 msgstr "本当に致命的な機能の問題がある"
675 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
676 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
678 msgid "the package becomes uninstallable"
679 msgstr "パッケージがインストールできなくなる"
681 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
682 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
684 msgid "a released architecture lacks the package"
685 msgstr "リリースされたアーキテクチャにパッケージが無い"
687 # type: Content of: <chapter><section><section><para>
688 #. type: Content of: <chapter><section><section><para>
691 "In the past, uploads to <literal>stable</literal> were used to address "
692 "security problems as well. However, this practice is deprecated, as uploads "
693 "used for Debian security advisories are automatically copied to the "
694 "appropriate <filename>proposed-updates</filename> archive when the advisory "
695 "is released. See <xref linkend=\"bug-security\"/> for detailed information "
696 "on handling security problems. If the security teams deems the problem to be "
697 "too benign to be fixed through a <literal>DSA</literal>, the stable release "
698 "managers are usually willing to include your fix nonetheless in a regular "
699 "upload to <literal>stable</literal>."
701 "以前、<literal>安定版 (stable)</literal> へのアップロードはセキュリティ問題へ"
702 "の対処と同等に取り扱われていました。しかし、この慣習は廃れており、Debian セ"
703 "キュリティ勧告がリリースされた際、セキュリティ勧告へのアップロードに使われた"
704 "ものが自動的に適切な <filename>proposed-updates</filename> アーカイブにコピー"
705 "されます。セキュリティ情報の取り扱い方の詳細については <xref linkend=\"bug-"
706 "security\"/> を参照してください。セキュリティチームがその問題は "
707 "<literal>DSA</literal> を通じて修正するには軽微過ぎると思った場合であっても、"
708 "安定版のリリースマネージャらはそれに関わらず <literal>安定版 (stable)</"
709 "literal> への定期アップロードに修正を含めようとするでしょう。"
711 # type: Content of: <chapter><section><section><para>
712 #. type: Content of: <chapter><section><section><para>
715 "Changing anything else in the package that isn't important is discouraged, "
716 "because even trivial fixes can cause bugs later on."
718 "些細な修正でも後ほどバグを引き起こすことがあるので、重要でないものは何であろ"
721 #. type: Content of: <chapter><section><section><para>
724 "Packages uploaded to <literal>stable</literal> need to be compiled on "
725 "systems running <literal>stable</literal>, so that their dependencies are "
726 "limited to the libraries (and other packages) available in <literal>stable</"
727 "literal>; for example, a package uploaded to <literal>stable</literal> that "
728 "depends on a library package that only exists in <literal>unstable</literal> "
729 "will be rejected. Making changes to dependencies of other packages (by "
730 "messing with <literal>Provides</literal> or <filename>shlibs</filename> "
731 "files), possibly making those other packages uninstallable, is strongly "
734 "<literal>安定版 (stable)</literal> にアップロードされるパッケージは<literal>"
735 "安定版 (stable)</literal> を動作しているシステム上でコンパイルされていなけれ"
736 "ばならず、ライブラリ (やその他のパッケージ) への依存は<literal>安定版 "
737 "(stable)</literal> で入手可能なものに限られます。例えば、<literal>安定版 "
738 "(stable)</literal> にアップロードされたパッケージが<literal>不安定版 "
739 "(unstable)</literal> にのみ存在するライブラリパッケージに依存していると "
740 "reject されます。他のパッケージへの依存を (<literal>提供 (Provides)</"
741 "literal> や <filename>shlibs</filename> をいじることで) 変更するのは、他の"
742 "パッケージをインストールできないようにする可能性があるので認められません。"
744 #. type: Content of: <chapter><section><section><para>
747 "Uploads to the <literal>oldstable</literal> distributions are possible as "
748 "long as it hasn't been archived. The same rules as for <literal>stable</"
751 "<literal>旧安定版 (oldstable)</literal> ディストリビューションへのアップロー"
752 "ドはアーカイブされてない限り可能です。<literal>安定版 (stable)</literal>と同"
755 # type: Content of: <chapter><section><section><title>
756 #. type: Content of: <chapter><section><section><title>
759 "Special case: uploads to <literal>testing/testing-proposed-updates</literal>"
761 "特別な例: <literal>testing/testing-proposed-updates</literal> へアップロード"
764 # type: Content of: <chapter><section><section><para>
765 #. type: Content of: <chapter><section><section><para>
768 "Please see the information in the <link linkend=\"t-p-u\">testing section</"
771 "詳細については、<link linkend=\"t-p-u\">testing section</link> にある情報を参"
774 # type: Content of: <chapter><section><title>
775 #. type: Content of: <chapter><section><title>
777 msgid "Uploading a package"
778 msgstr "パッケージをアップロードする"
780 # type: Content of: <chapter><section><section><title>
781 #. type: Content of: <chapter><section><section><title>
783 msgid "Uploading to <literal>ftp-master</literal>"
784 msgstr "<literal>ftp-master</literal> にアップロードする"
786 #. type: Content of: <chapter><section><section><para>
789 "To upload a package, you should upload the files (including the signed "
790 "changes and dsc-file) with anonymous ftp to <literal>&ftp-upload-host;</"
791 "literal> in the directory <ulink url=\"ftp://&ftp-upload-host;&upload-queue;"
792 "\">&upload-queue;</ulink>. To get the files processed there, they need to "
793 "be signed with a key in the Debian Developers keyring or the Debian "
794 "Maintainers keyring (see <ulink url=\"&url-wiki-dm;\"></ulink>)."
796 "パッケージをアップロードするには、ファイル (署名された changes ファイルと "
797 "dsc ファイル) を anonymous ftp で <literal>&ftp-upload-host;</literal> の "
798 "<ulink url=\"ftp://&ftp-upload-host;&upload-queue;\">&upload-queue;</ulink> "
799 "へアップロードする必要があります。そこでファイルを処理するためには、Debian "
800 "Developers keyring または Debian Maintainers keyring (<ulink url=\"&url-wiki-"
801 "dm;\"></ulink> 参照) にある鍵で署名しておく必要があります。"
803 # type: Content of: <chapter><section><section><para>
804 #. type: Content of: <chapter><section><section><para>
807 "Please note that you should transfer the changes file last. Otherwise, your "
808 "upload may be rejected because the archive maintenance software will parse "
809 "the changes file and see that not all files have been uploaded."
811 "changes ファイルは最後に転送する必要があることに注意してください。そうしない"
812 "とアーカイブのメンテナンスを行っているソフトが changes ファイルをパースして全"
813 "てのファイルがアップロードされていないと判断して、アップロードは reject され"
816 #. type: Content of: <chapter><section><section><para>
819 "You may also find the Debian packages <link linkend=\"dupload\">dupload</"
820 "link> or <link linkend=\"dput\">dput</link> useful when uploading packages."
821 "These handy programs help automate the process of uploading packages into "
824 "パッケージのアップロードを行う際には <link linkend=\"dupload\">dupload</"
825 "link> や <link linkend=\"dput\">dput</link> が便利なことにも気づくことでしょ"
826 "う。これらの便利なプログラムは、パッケージを Debian にアップロードする作業を"
829 #. type: Content of: <chapter><section><section><para>
832 "For removing packages, please see <ulink url=\"ftp://&ftp-upload-host;"
833 "&upload-queue;README\"/> and the Debian package <link linkend=\"dcut\">dcut</"
836 "パッケージを削除するには <ulink url=\"ftp://&ftp-upload-host;&upload-queue;"
837 "README\"/> と <link linkend=\"dcut\">dcut</link> Debian パッケージを参照して"
840 # type: Content of: <chapter><section><section><title>
841 #. type: Content of: <chapter><section><section><title>
843 msgid "Delayed uploads"
846 #. type: Content of: <chapter><section><section><para>
849 "It is sometimes useful to upload a package immediately, but to want this "
850 "package to arrive in the archive only a few days later. For example, when "
851 "preparing a <link linkend=\"nmu\">Non-Maintainer Upload</link>, you might "
852 "want to give the maintainer a few days to react."
854 "パッケージを直ちにアップロードするのが良い時もありますが、パッケージがアーカ"
855 "イブに入るのが数日後であるのが良いと思う時もあります。例えば、<link linkend="
856 "\"nmu\">Non-Maintainer アップロード</link>の準備をする際は、メンテナに対して"
857 "猶予期間を数日間与えたいと思うでしょう。"
859 #. type: Content of: <chapter><section><section><para>
862 "An upload to the delayed directory keeps the package in <ulink url=\"http://"
863 "ftp-master.debian.org/deferred.html\">the deferred uploads queue</ulink>. "
864 "When the specified waiting time is over, the package is moved into the "
865 "regular incoming directory for processing. This is done through automatic "
866 "uploading to <literal>&ftp-upload-host;</literal> in upload-directory "
867 "<literal>DELAYED/[012345678]-day</literal>. 0-day is uploaded multiple times "
868 "per day to <literal>&ftp-upload-host;</literal>."
870 "delayed ディレクトリにアップロードされると、パッケージは <ulink url=\"http://"
871 "ftp-master.debian.org/deferred.html\">the deferred uploads queue</ulink> に保"
872 "存されます。指定した待ち時間が終わると、パッケージは処理のため通常の "
873 "incoming ディレクトリに移動されます。この作業は <literal>&ftp-upload-host;</"
874 "literal> の <literal>DELAYED/[012345678]-day</literal> ディレクトリへのアップ"
875 "ロードを通じて自動的に処理されます。0-day は一日に複数回 <literal>&ftp-"
876 "upload-host;</literal> へアップロードするのに使われます。"
878 #. type: Content of: <chapter><section><section><para>
881 "With dput, you can use the <literal>--delayed <replaceable>DELAY</"
882 "replaceable></literal> parameter to put the package into one of the queues."
884 "dput を使うと、パッケージを遅延キューに入れるのに <literal>--delayed "
885 "<replaceable>DELAY</replaceable></literal> パラメータを使えます。"
887 # type: Content of: <chapter><section><section><title>
888 #. type: Content of: <chapter><section><section><title>
890 msgid "Security uploads"
891 msgstr "セキュリティアップロード"
893 # type: Content of: <chapter><section><section><para>
894 #. type: Content of: <chapter><section><section><para>
897 "Do <emphasis role=\"strong\">NOT</emphasis> upload a package to the security "
898 "upload queue (<literal>oldstable-security</literal>, <literal>stable-"
899 "security</literal>, etc.) without prior authorization from the security "
900 "team. If the package does not exactly meet the team's requirements, it will "
901 "cause many problems and delays in dealing with the unwanted upload. For "
902 "details, please see <xref linkend=\"bug-security\"/>."
904 "セキュリティアップロードキュー (<literal>oldstable-security</literal>、"
905 "<literal>stable-security</literal> 等) には、セキュリティチームからの事前許可"
906 "無しにパッケージを<emphasis role=\"strong\">アップロードしないでください</"
907 "emphasis>。パッケージがチームの要求に完全に合致していない場合、望まれないアッ"
908 "プロードに対処するために多くの問題が引き起こされたり遅延が生じることになりま"
909 "す。詳細については <xref linkend=\"bug-security\"/> を参照してください。"
911 # type: Content of: <chapter><section><section><title>
912 #. type: Content of: <chapter><section><section><title>
914 msgid "Other upload queues"
917 #. type: Content of: <chapter><section><section><para>
920 "There is an alternative upload queue in Europe at <ulink url=\"ftp://&ftp-eu-"
921 "upload-host;&upload-queue;\"/>. It operates in the same way as <literal>&ftp-"
922 "upload-host;</literal>, but should be faster for European developers."
924 "ヨーロッパにはもう一つのアップロードキューが <ulink url=\"ftp://&ftp-eu-"
925 "upload-host;&upload-queue;\"/> にあります。操作方法は <literal>&ftp-upload-"
926 "host;</literal> と同じですが、ヨーロッパ圏の開発者に対しては、より速いはずで"
929 #. type: Content of: <chapter><section><section><para>
932 "Packages can also be uploaded via ssh to <literal>&ssh-upload-host;</"
933 "literal>; files should be put <literal>/srv/upload.debian.org/UploadQueue</"
934 "literal>. This queue does not support <link linkend=\"delayed-incoming"
935 "\">delayed uploads</link>."
937 "パッケージは ssh を使って <literal>&ssh-upload-host;</literal> へアップロード"
938 "することも可能です。ファイルは <literal>/srv/upload.debian.org/UploadQueue</"
939 "literal> に置く必要があります。このキューは<link linkend=\"delayed-incoming"
940 "\">遅延アップロード</link>をサポートしていません。"
942 # type: Content of: <chapter><section><section><title>
943 #. type: Content of: <chapter><section><section><title>
945 msgid "Notification that a new package has been installed"
946 msgstr "新しいパッケージがインストールされたことの通知"
948 # type: Content of: <chapter><section><section><para>
949 #. type: Content of: <chapter><section><section><para>
952 "The Debian archive maintainers are responsible for handling package "
953 "uploads. For the most part, uploads are automatically handled on a daily "
954 "basis by the archive maintenance tools, <command>katie</command>. "
955 "Specifically, updates to existing packages to the <literal>unstable</"
956 "literal> distribution are handled automatically. In other cases, notably "
957 "new packages, placing the uploaded package into the distribution is handled "
958 "manually. When uploads are handled manually, the change to the archive may "
959 "take up to a month to occur. Please be patient."
961 "Debian アーカイブメンテナはパッケージのアップロードに関して責任を持っていま"
962 "す。多くの部分は、アップロードはアーカイブ用のメンテナンスツール "
963 "<command>katie</command> によって日々自動的に行われています。特に、<literal>"
964 "不安定版 (unstable)</literal> に存在しているパッケージの更新は自動的に処理さ"
965 "れます。それ以外の場合、特に新規パッケージの場合は、アップロードされたパッ"
966 "ケージをディストリビューションに含めるのは手動で行われます。アップロードが手"
967 "動で処理される場合は、アーカイブへの変更は実施されるまでに一ヶ月ほどかかりま"
970 # type: Content of: <chapter><section><section><para>
971 #. type: Content of: <chapter><section><section><para>
974 "In any case, you will receive an email notification indicating that the "
975 "package has been added to the archive, which also indicates which bugs will "
976 "be closed by the upload. Please examine this notification carefully, "
977 "checking if any bugs you meant to close didn't get triggered."
979 "どの場合であっても、パッケージがアーカイブに追加されたことや、バグがアップ"
980 "ロードで閉じられたことを告げるメールでの通知を受け取ることになります。あなた"
981 "が閉じようとしたバグが処理されてない場合は、この通知を注意深く確認してくださ"
984 # type: Content of: <chapter><section><section><para>
985 #. type: Content of: <chapter><section><section><para>
988 "The installation notification also includes information on what section the "
989 "package was inserted into. If there is a disparity, you will receive a "
990 "separate email notifying you of that. Read on below."
992 "インストール通知もパッケージがどのセクションに入ったかを示す情報を含んでいま"
993 "す。不一致がある場合は、それを示す別のメール通知を受け取ります。以下も参照く"
996 # type: Content of: <chapter><section><section><para>
997 #. type: Content of: <chapter><section><section><para>
1000 "Note that if you upload via queues, the queue daemon software will also send "
1001 "you a notification by email."
1003 "キュー経由でアップロードした場合は、キューデーモンソフトウェアもメールで通知"
1006 # type: Content of: <chapter><section><title>
1007 #. type: Content of: <chapter><section><title>
1009 msgid "Specifying the package section, subsection and priority"
1010 msgstr "パッケージのセクション、サブセクション、優先度を指定する"
1012 # type: Content of: <chapter><section><para>
1013 #. type: Content of: <chapter><section><para>
1016 "The <filename>debian/control</filename> file's <literal>Section</literal> "
1017 "and <literal>Priority</literal> fields do not actually specify where the "
1018 "file will be placed in the archive, nor its priority. In order to retain "
1019 "the overall integrity of the archive, it is the archive maintainers who have "
1020 "control over these fields. The values in the <filename>debian/control</"
1021 "filename> file are actually just hints."
1023 "<filename>debian/control</filename> ファイルの <literal>セクション (Section)"
1024 "</literal> フィールドと <literal>優先度 (Priority)</literal> フィールドは実際"
1025 "にアーカイブ内でどこに配置されるか、あるいはプライオリティが何かという指定で"
1026 "はありません。<filename>debian/control</filename> ファイル中の値は、実際のと"
1029 # type: Content of: <chapter><section><para>
1030 #. type: Content of: <chapter><section><para>
1033 "The archive maintainers keep track of the canonical sections and priorities "
1034 "for packages in the <literal>override file</literal>. If there is a "
1035 "disparity between the <literal>override file</literal> and the package's "
1036 "fields as indicated in <filename>debian/control</filename>, then you will "
1037 "receive an email noting the divergence when the package is installed into "
1038 "the archive. You can either correct your <filename>debian/control</"
1039 "filename> file for your next upload, or else you may wish to make a change "
1040 "in the <literal>override file</literal>."
1042 "アーカイブメンテナは、<literal>override ファイル</literal>内でパッケージにつ"
1043 "いて定められたセクションと優先度を常に確認しています。<literal>override ファ"
1044 "イル</literal>と <filename>debian/control</filename> で指定されたパッケージの"
1045 "フィールドに不一致がある場合、パッケージがアーカイブにインストールされる際に"
1046 "相違について記述されたメールを受け取ります。<filename>debian/control</"
1047 "filename> ファイルを次回のアップロード時に修正することもできますし、"
1048 "<literal>override ファイル</literal>に変更を加えるように依頼するのもよいで"
1051 #. type: Content of: <chapter><section><para>
1054 "To alter the actual section that a package is put in, you need to first make "
1055 "sure that the <filename>debian/control</filename> file in your package is "
1056 "accurate. Next, submit a bug against <systemitem role=\"package\">ftp."
1057 "debian.org</systemitem> requesting that the section or priority for your "
1058 "package be changed from the old section or priority to the new one. Use a "
1059 "Subject like <literal>override: PACKAGE1:section/priority, [...], PACKAGEX:"
1060 "section/priority</literal>, and include the justification for the change in "
1061 "the body of the bug report."
1063 "パッケージが現状で置かれているセクションを変更するには、まずパッケージの "
1064 "<filename>debian/control</filename> ファイルが正しいことを確認する必要があり"
1065 "ます。次に、<systemitem role=\"package\">ftp.debian.org</systemitem> に対し、"
1066 "あなたのパッケージに対するセクションあるいは優先度について古いものから新しい"
1067 "ものへ変更する依頼のバグ登録をします。<literal>override: PACKAGE1:section/"
1068 "priority, [...], PACKAGEX:section/priority</literal> のようなサブジェクトを使"
1069 "い、バグ報告の本文に変更に関する根拠を記述してください。"
1071 # type: Content of: <chapter><section><para>
1072 #. type: Content of: <chapter><section><para>
1075 "For more information about <literal>override files</literal>, see "
1076 "<citerefentry> <refentrytitle>dpkg-scanpackages</refentrytitle> "
1077 "<manvolnum>1</manvolnum> </citerefentry> and <ulink url=\"&url-bts-devel;"
1078 "#maintincorrect\"></ulink>."
1080 "<literal>override ファイル</literal> についての詳細は、<citerefentry> "
1081 "<refentrytitle>dpkg-scanpackages</refentrytitle> <manvolnum>1</manvolnum> </"
1082 "citerefentry> と <ulink url=\"&url-bts-devel;#maintincorrect\"></ulink> を参"
1085 #. type: Content of: <chapter><section><para>
1088 "Note that the <literal>Section</literal> field describes both the section as "
1089 "well as the subsection, which are described in <xref linkend=\"archive-"
1090 "sections\"/>. If the section is main, it should be omitted. The list of "
1091 "allowable subsections can be found in <ulink url=\"&url-debian-policy;ch-"
1092 "archive.html#s-subsections\"></ulink>."
1094 "<xref linkend=\"archive-sections\"/> で書かれているように、<literal>セクショ"
1095 "ン (Section)</literal>フィールドにはセクション同様にサブセクションも記述する"
1096 "のに注意ください。セクションが main の場合は、それは書かないようにしてくださ"
1097 "い。利用可能なサブセクションは <ulink url=\"&url-debian-policy;ch-archive."
1098 "html#s-subsections\"></ulink> で検索できます。"
1100 # type: Content of: <chapter><section><title>
1101 #. type: Content of: <chapter><section><title>
1103 msgid "Handling bugs"
1106 # type: Content of: <chapter><section><para>
1107 #. type: Content of: <chapter><section><para>
1110 "Every developer has to be able to work with the Debian <ulink url=\"&url-bts;"
1111 "\">bug tracking system</ulink>. This includes knowing how to file bug "
1112 "reports properly (see <xref linkend=\"submit-bug\"/>), how to update them "
1113 "and reorder them, and how to process and close them."
1115 "すべての開発者は Debian <ulink url=\"&url-bts;\">バグ追跡システム</ulink>を取"
1116 "り扱えるようでなければいけません。これは、どの様にしてバグ報告を正しく登録す"
1117 "るか (<xref linkend=\"submit-bug\"/> 参照)、どの様に更新及び整理するか、そし"
1118 "てどの様にして処理をして完了するかを知っていることを含みます。"
1120 # type: Content of: <chapter><section><para>
1121 #. type: Content of: <chapter><section><para>
1124 "The bug tracking system's features are described in the <ulink url=\"&url-"
1125 "bts-devel;\">BTS documentation for developers</ulink>. This includes "
1126 "closing bugs, sending followup messages, assigning severities and tags, "
1127 "marking bugs as forwarded, and other issues."
1129 "バグ追跡システムの機能は、<ulink url=\"&url-bts-devel;\">Debian BTS 開発者向"
1130 "け情報</ulink>に記載されています。これには、バグの完了処理・追加メッセージの"
1131 "送信・重要度とタグを割り当てる・バグを転送済み (Forwarded) にする・その他が含"
1134 # type: Content of: <chapter><section><para>
1135 #. type: Content of: <chapter><section><para>
1138 "Operations such as reassigning bugs to other packages, merging separate bug "
1139 "reports about the same issue, or reopening bugs when they are prematurely "
1140 "closed, are handled using the so-called control mail server. All of the "
1141 "commands available on this server are described in the <ulink url=\"&url-bts-"
1142 "control;\">BTS control server documentation</ulink>."
1144 "バグを他のパッケージに割り当てし直す、同じ問題についての別々のバグ報告をマー"
1145 "ジする、などの作業はいわゆる制御メールサーバと呼ばれるものを使って処理されて"
1146 "います。このサーバで利用可能なすべてのコマンドは、<ulink url=\"&url-bts-"
1147 "control;\">BTS 制御サーバドキュメント</ulink>に記載されています。"
1149 # type: Content of: <chapter><section><section><title>
1150 #. type: Content of: <chapter><section><section><title>
1152 msgid "Monitoring bugs"
1155 # type: Content of: <chapter><section><section><para>
1156 #. type: Content of: <chapter><section><section><para>
1159 "If you want to be a good maintainer, you should periodically check the "
1160 "<ulink url=\"&url-bts;\">Debian bug tracking system (BTS)</ulink> for your "
1161 "packages. The BTS contains all the open bugs against your packages. You "
1162 "can check them by browsing this page: <literal>http://&bugs-host;/"
1163 "<replaceable>yourlogin</replaceable>@debian.org</literal>."
1165 "良いメンテナになりたい場合は、あなたのパッケージに関する <ulink url=\"&url-"
1166 "bts;\">Debian バグ追跡システム (BTS)</ulink> のページを定期的にチェックする必"
1167 "要があります。BTS には、あなたのパッケージに対して登録されている全てのバグが"
1168 "含まれています。登録されているバグについては、以下のページを参照することで確"
1169 "認できます: <literal>http://&bugs-host;/<replaceable>yourlogin</"
1170 "replaceable>@debian.org</literal>"
1172 # type: Content of: <chapter><section><section><para>
1173 #. type: Content of: <chapter><section><section><para>
1176 "Maintainers interact with the BTS via email addresses at <literal>&bugs-host;"
1177 "</literal>. Documentation on available commands can be found at <ulink url="
1178 "\"&url-bts;\"></ulink>, or, if you have installed the <systemitem role="
1179 "\"package\">doc-debian</systemitem> package, you can look at the local files "
1182 "メンテナは、<literal>&bugs-host;</literal> のメールアドレス経由で BTS に対応"
1183 "します。利用可能なコマンドについてのドキュメントは <ulink url=\"&url-bts;"
1184 "\"></ulink> で参照可能ですし、もし <systemitem role=\"package\">doc-debian</"
1185 "systemitem> パッケージをインストールしてあれば、ローカルファイル &file-bts-"
1188 # type: Content of: <chapter><section><section><para>
1189 #. type: Content of: <chapter><section><section><para>
1192 "Some find it useful to get periodic reports on open bugs. You can add a "
1193 "cron job such as the following if you want to get a weekly email outlining "
1194 "all the open bugs against your packages:"
1196 "定期的にオープンになっているバグについてのレポートを受け取るのも良いでしょ"
1197 "う。あなたのパッケージでオープンになっているバグの全一覧を毎週受け取りたい場"
1198 "合、以下のような cron ジョブを追加します:"
1200 #. type: Content of: <chapter><section><section><screen>
1204 "# ask for weekly reports of bugs in my packages\n"
1205 "&cron-bug-report;\n"
1207 "# 自分のパッケージにあるバグのレポートを毎週取得する\n"
1208 "&cron-bug-report;\n"
1210 # type: Content of: <chapter><section><section><para>
1211 #. type: Content of: <chapter><section><section><para>
1214 "Replace <replaceable>address</replaceable> with your official Debian "
1215 "maintainer address."
1217 "<replaceable>address</replaceable> は、あなたの公式な Debian パッケージメンテ"
1218 "ナとしてのメールアドレスに置き換えてください。"
1220 # type: Content of: <chapter><section><section><title>
1221 #. type: Content of: <chapter><section><section><title>
1223 msgid "Responding to bugs"
1226 # type: Content of: <chapter><section><section><para>
1227 #. type: Content of: <chapter><section><section><para>
1230 "When responding to bugs, make sure that any discussion you have about bugs "
1231 "is sent both to the original submitter of the bug, and to the bug itself (e."
1232 "g., <email><replaceable>123</replaceable>@&bugs-host;</email>). If you're "
1233 "writing a new mail and you don't remember the submitter email address, you "
1234 "can use the <email><replaceable>123</replaceable>-submitter@&bugs-host;</"
1235 "email> email to contact the submitter <emphasis>and</emphasis> to record "
1236 "your mail within the bug log (that means you don't need to send a copy of "
1237 "the mail to <email><replaceable>123</replaceable>@&bugs-host;</email>)."
1239 "バグに対応する際は、バグについて行った議論がバグの元々の報告者とバグ自身 (例"
1240 "えば <email><replaceable>123</replaceable>@&bugs-host;</email>) の両方に送ら"
1241 "れているのを確認してください。新しくメールを書いていて元々の報告者のメールア"
1242 "ドレスを思い出せない場合は、<email><replaceable>123</replaceable>-"
1243 "submitter@&bugs-host;</email> というメールアドレスが報告者へ連絡するのと、"
1244 "<emphasis>さらに</emphasis>バグのログへあなたがメールしたのを記録するのにも使"
1245 "えます (これは <email><replaceable>123</replaceable>@&bugs-host;</email> へ"
1246 "メールのコピーを送らなくても済むことを意味しています)。"
1248 # type: Content of: <chapter><section><section><para>
1249 #. type: Content of: <chapter><section><section><para>
1252 "If you get a bug which mentions FTBFS, this means Fails to build from "
1253 "source. Porters frequently use this acronym."
1255 "FTBFS である旨のバグを受け取った場合、これはソースからビルドできないこと "
1256 "(Fails to build from source) を意味します。移植作業をしている人たちはこの略語"
1259 # type: Content of: <chapter><section><section><para>
1260 #. type: Content of: <chapter><section><section><para>
1263 "Once you've dealt with a bug report (e.g. fixed it), mark it as "
1264 "<literal>done</literal> (close it) by sending an explanation message to "
1265 "<email><replaceable>123</replaceable>-done@&bugs-host;</email>. If you're "
1266 "fixing a bug by changing and uploading the package, you can automate bug "
1267 "closing as described in <xref linkend=\"upload-bugfix\"/>."
1269 "既にバグに対処していた場合 (例えば修正済みの時)、説明のメッセージを "
1270 "<email><replaceable>123</replaceable>-done@&bugs-host;</email> に送ることで "
1271 "<literal>done</literal> とマークしておいて (閉じて) ください。パッケージを変"
1272 "更してアップロードすることでバグを修正する場合は、<xref linkend=\"upload-"
1273 "bugfix\"/> に記載されているように自動的にバグを閉じることができます。"
1275 # type: Content of: <chapter><section><section><para>
1276 # FIXME: via the bug server ?
1277 #. type: Content of: <chapter><section><section><para>
1280 "You should <emphasis>never</emphasis> close bugs via the bug server "
1281 "<literal>close</literal> command sent to &email-bts-control;. If you do so, "
1282 "the original submitter will not receive any information about why the bug "
1285 "<literal>close</literal> コマンドを &email-bts-control; に送って、バグサーバ"
1286 "経由でバグを閉じるのは<emphasis>決して</emphasis>してはいけません。そのように"
1287 "した場合、元々の報告者は何故バグが閉じられたのかという情報を得られません。"
1289 # type: Content of: <chapter><section><section><title>
1290 #. type: Content of: <chapter><section><section><title>
1292 msgid "Bug housekeeping"
1295 # type: Content of: <chapter><section><section><para>
1296 #. type: Content of: <chapter><section><section><para>
1299 "As a package maintainer, you will often find bugs in other packages or have "
1300 "bugs reported against your packages which are actually bugs in other "
1301 "packages. The bug tracking system's features are described in the <ulink "
1302 "url=\"&url-bts-devel;\">BTS documentation for Debian developers</ulink>. "
1303 "Operations such as reassigning, merging, and tagging bug reports are "
1304 "described in the <ulink url=\"&url-bts-control;\">BTS control server "
1305 "documentation</ulink>. This section contains some guidelines for managing "
1306 "your own bugs, based on the collective Debian developer experience."
1308 "パッケージメンテナになると、他のパッケージにバグを見つけたり、自分のパッケー"
1309 "ジに対して報告されたバグが実際には他のパッケージにあるバグであったりというこ"
1310 "とが頻繁にあるでしょう。バグ追跡システムの機能は <ulink url=\"&url-bts-devel;"
1311 "\">Debian 開発者向けの BTS ドキュメント</ulink> に記載されています。バグ報告"
1312 "の再指定 (reassign) やマージ (merge)、そしてタグ付けなどの作業は <ulink url="
1313 "\"&url-bts-control;\">BTS 制御サーバのドキュメント</ulink> に記述されていま"
1314 "す。この章では、Debian 開発者から集められた経験を元にしたバグの扱い方のガイド"
1317 # type: Content of: <chapter><section><section><para>
1318 #. type: Content of: <chapter><section><section><para>
1321 "Filing bugs for problems that you find in other packages is one of the civic "
1322 "obligations of maintainership, see <xref linkend=\"submit-bug\"/> for "
1323 "details. However, handling the bugs in your own packages is even more "
1326 "他のパッケージで見つけた問題についてバグを登録するのは、メンテナとしての責務"
1327 "の一つです。詳細については <xref linkend=\"submit-bug\"/> を参照してくださ"
1328 "い。しかし、自分のパッケージのバグを管理するのはさらに重要です。"
1330 # type: Content of: <chapter><section><section><para>
1331 #. type: Content of: <chapter><section><section><para>
1333 msgid "Here's a list of steps that you may follow to handle a bug report:"
1334 msgstr "以下がバグ報告を取り扱う手順です:"
1336 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1337 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1340 "Decide whether the report corresponds to a real bug or not. Sometimes users "
1341 "are just calling a program in the wrong way because they haven't read the "
1342 "documentation. If you diagnose this, just close the bug with enough "
1343 "information to let the user correct their problem (give pointers to the good "
1344 "documentation and so on). If the same report comes up again and again you "
1345 "may ask yourself if the documentation is good enough or if the program "
1346 "shouldn't detect its misuse in order to give an informative error message. "
1347 "This is an issue that may need to be brought up with the upstream author."
1349 "報告が実際にバグに関連するものか否かを決めてください。ユーザはドキュメントを"
1350 "読んでいないため、誤ったプログラムの使い方をしているだけのことが時々ありま"
1351 "す。このように判断した場合は、ユーザに問題を修正するのに十分な情報を与えて "
1352 "(良いドキュメントへのポインタを教えるなどして) バグを閉じます。同じ報告が何度"
1353 "も繰り返し来る場合には、ドキュメントが十分なものかどうか、あるいは有益なエ"
1354 "ラーメッセージを与えるよう、誤った使い方を検知していないのでは、と自身に問い"
1355 "直してください。これは開発元の作者に伝える必要がある問題かもしれません。"
1357 # FIXME-trans: "If you don't find any," - any what?
1358 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1359 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1362 "If the bug submitter disagrees with your decision to close the bug, they may "
1363 "reopen it until you find an agreement on how to handle it. If you don't "
1364 "find any, you may want to tag the bug <literal>wontfix</literal> to let "
1365 "people know that the bug exists but that it won't be corrected. If this "
1366 "situation is unacceptable, you (or the submitter) may want to require a "
1367 "decision of the technical committee by reassigning the bug to <systemitem "
1368 "role=\"package\">tech-ctte</systemitem> (you may use the clone command of "
1369 "the BTS if you wish to keep it reported against your package). Before doing "
1370 "so, please read the <ulink url=\"&url-tech-ctte;\">recommended procedure</"
1373 "バグを閉じるという貴方の判断にバグ報告者らが同意しない場合には、それをどう取"
1374 "り扱うかについての同意が見つかるまで、彼らは再度オープンな状態 (reopen) にす"
1375 "るでしょう。そのバグについてもう議論することが無いという場合は、バグは存在す"
1376 "るが修正することはないと知らせるため、バグに対して <literal>wontfix</"
1377 "literal> タグを付けることになります。この決定が受け入れがたい時には、あなた "
1378 "(あるいは報告者) はバグを <systemitem role=\"package\">tech-ctte</"
1379 "systemitem> に再指定 (reassign) して技術委員会 (technical committee) の判断を"
1380 "仰いでください (パッケージへ報告されたものをそのままにしておきたい場合は、"
1381 "BTS の clone コマンドを使ってください)。これを行う前には<ulink url=\"&url-"
1382 "tech-ctte;\">推奨手順</ulink>を読んでおいてください。"
1384 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1387 "If the bug is real but it's caused by another package, just reassign the bug "
1388 "to the right package. If you don't know which package it should be "
1389 "reassigned to, you should ask for help on <link linkend=\"irc-channels"
1390 "\">IRC</link> or on &email-debian-devel;. Please inform the maintainer(s) "
1391 "of the package you reassign the bug to, for example by Cc:ing the message "
1392 "that does the reassign to <email><replaceable>packagename</"
1393 "replaceable>@packages.debian.org</email> and explaining your reasons in that "
1394 "mail. Please note that a simple reassignment is <emphasis>not</emphasis> e-"
1395 "mailed to the maintainers of the package being reassigned to, so they won't "
1396 "know about it until they look at a bug overview for their packages."
1398 "バグが実際にあるが、他のパッケージによって引き起こされている場合は、バグを正"
1399 "しいパッケージに再指定 (reassign) します。どのパッケージに再指定するべきかが"
1400 "分からない場合は、<link linkend=\"irc-channels\">IRC</link> か &email-debian-"
1401 "devel; で聞いてください。再指定するパッケージのメンテナに通知をしてください。"
1402 "例えば <email><replaceable>packagename</replaceable>@packages.debian.org</"
1403 "email> 宛にメッセージを Cc: してメール中に理由を説明するなどします。単に再指"
1404 "定しただけでは再指定された先のメンテナにはメールは<emphasis>送信されません</"
1405 "emphasis>ので、彼らがパッケージのバグ一覧を見るまでそれを知ることはありませ"
1408 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1409 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1412 "If the bug affects the operation of your package, please consider cloning "
1413 "the bug and reassigning the clone to the package that really causes the "
1414 "behavior. Otherwise, the bug will not be shown in your package's bug list, "
1415 "possibly causing users to report the same bug over and over again. You "
1416 "should block \"your\" bug with the reassigned, cloned bug to document the "
1419 "バグがあなたのパッケージの動作に影響する場合は、バグを複製し (clone)、複製し"
1420 "たバグをその挙動を実際に起こしているパッケージに再指定することを検討してくだ"
1421 "さい。さもなければ、あなたのパッケージのバグ一覧にバグが見つからないので、多"
1422 "分ユーザに同じバグを何度も繰り返し報告される羽目になる可能性があります。あな"
1423 "たは、再指定 (reassign) によって「自分の」バグということを防ぎ、バグの複製 "
1424 "(clone) によって関係があることを記載しておく必要があります。"
1426 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1427 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1430 "Sometimes you also have to adjust the severity of the bug so that it matches "
1431 "our definition of the severity. That's because people tend to inflate the "
1432 "severity of bugs to make sure their bugs are fixed quickly. Some bugs may "
1433 "even be dropped to wishlist severity when the requested change is just "
1436 "時々、重要度の定義に合うようにバグの重要度を調整する必要もあります。これは、"
1437 "人々はバグ修正を確実に早くしてもらうために重要度を極端に上げようとするからで"
1438 "す。要望された変更点が単に体裁的なものな時には、バグは要望 (wishlist) に格下"
1441 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1442 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1445 "If the bug is real but the same problem has already been reported by someone "
1446 "else, then the two relevant bug reports should be merged into one using the "
1447 "merge command of the BTS. In this way, when the bug is fixed, all of the "
1448 "submitters will be informed of this. (Note, however, that emails sent to "
1449 "one bug report's submitter won't automatically be sent to the other report's "
1450 "submitter.) For more details on the technicalities of the merge command and "
1451 "its relative, the unmerge command, see the BTS control server documentation."
1453 "バグが確かにあるが既に他の誰かによって同じ問題が報告されている場合は、2 つの"
1454 "関連したバグを BTS の merge コマンドを使って 1 つにマージします。このようにす"
1455 "ると、バグが修正された時に全ての投稿者に通知がいきます (ですが、そのバグ報告"
1456 "の投稿者へのメールは報告の他の投稿者には自動的には通知されないことに注意して"
1457 "ください)。merge コマンドや類似の unmerge コマンドの技術詳細については、BTS "
1458 "制御サーバドキュメントを参照してください。"
1460 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1461 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1464 "The bug submitter may have forgotten to provide some information, in which "
1465 "case you have to ask them for the required information. You may use the "
1466 "<literal>moreinfo</literal> tag to mark the bug as such. Moreover if you "
1467 "can't reproduce the bug, you tag it <literal>unreproducible</literal>. "
1468 "Anyone who can reproduce the bug is then invited to provide more information "
1469 "on how to reproduce it. After a few months, if this information has not "
1470 "been sent by someone, the bug may be closed."
1472 "バグ報告者は情報を書き漏らしている場合、必要な情報を尋ねる必要があります。そ"
1473 "の様なバグに印をつけるには <literal>moreinfo</literal> タグを使います。さら"
1474 "に、そのバグを再現できない場合には、<literal>unreproducible</literal> タグを"
1475 "付けます。誰もそのバグを再現できない場合、どうやって再現するのか、さらに情報"
1476 "を何ヶ月経っても、この情報が誰からも送られてこない場合はバグは閉じても構いま"
1479 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1480 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1483 "If the bug is related to the packaging, you just fix it. If you are not "
1484 "able to fix it yourself, then tag the bug as <literal>help</literal>. You "
1485 "can also ask for help on &email-debian-devel; or &email-debian-qa;. If it's "
1486 "an upstream problem, you have to forward it to the upstream author. "
1487 "Forwarding a bug is not enough, you have to check at each release if the bug "
1488 "has been fixed or not. If it has, you just close it, otherwise you have to "
1489 "remind the author about it. If you have the required skills you can prepare "
1490 "a patch that fixes the bug and send it to the author at the same time. Make "
1491 "sure to send the patch to the BTS and to tag the bug as <literal>patch</"
1494 "バグがパッケージに起因する場合、さっさと直します。自分では直せない場合は、バ"
1495 "グに <literal>help</literal> タグを付けます。&email-debian-devel; や &email-"
1496 "debian-qa; で助けを求めることも出来ます。開発元 (upstream) の問題であれば、作"
1497 "者に転送する必要があります。バグを転送するだけでは十分ではありません。リリー"
1498 "スごとにバグが修正されているかどうかを確認しなければいけません。もし修正され"
1499 "ていれば、それを閉じ、そうでなければ作者に確認を取る必要があります。必要な技"
1500 "能を持っていてバグを修正するパッチが用意できる場合は、同時に作者に送りましょ"
1501 "う。パッチを BTS に送付してバグに <literal>patch</literal> タグを付けるのを忘"
1504 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1507 "If you have fixed a bug in your local copy, or if a fix has been committed "
1508 "to the VCS repository, you may tag the bug as <literal>pending</literal> to "
1509 "let people know that the bug is corrected and that it will be closed with "
1510 "the next upload (add the <literal>closes:</literal> in the "
1511 "<filename>changelog</filename>). This is particularly useful if you are "
1512 "several developers working on the same package."
1514 "ローカル環境でバグを修正した、あるいは VCS リポジトリに修正をコミットした場合"
1515 "には、バグに <literal>pending</literal> タグを付けてバグが修正されたことと次"
1516 "のアップロードでバグが閉じられるであろうことを回りに知らせます "
1517 "(<filename>changelog</filename> に <literal>closes:</literal> を追加します)。"
1518 "これは複数の開発者が同一のパッケージで作業している際に特に役立ちます。"
1520 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1521 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1524 "Once a corrected package is available in the archive, the bug should be "
1525 "closed indicating the version in which it was fixed. This can be done "
1526 "automatically, read <xref linkend=\"upload-bugfix\"/>."
1528 "一旦修正されたパッケージがアーカイブから入手可能になったら、バグはどのバー"
1529 "ジョンで修正されたかを指定して閉じられる必要があります。これは自動的に行われ"
1530 "ます。<xref linkend=\"upload-bugfix\"/> を読んでください。"
1532 # type: Content of: <chapter><section><section><title>
1533 #. type: Content of: <chapter><section><section><title>
1535 msgid "When bugs are closed by new uploads"
1536 msgstr "新規アップロードでバグがクローズされる時"
1538 # type: Content of: <chapter><section><section><para>
1539 #. type: Content of: <chapter><section><section><para>
1542 "As bugs and problems are fixed in your packages, it is your responsibility "
1543 "as the package maintainer to close these bugs. However, you should not "
1544 "close a bug until the package which fixes the bug has been accepted into the "
1545 "Debian archive. Therefore, once you get notification that your updated "
1546 "package has been installed into the archive, you can and should close the "
1547 "bug in the BTS. Also, the bug should be closed with the correct version."
1549 "バグや問題があなたのパッケージで修正されたとしたら、そのバグを閉じるのはパッ"
1550 "ケージメンテナとしての責任になります。しかし、バグを修正したパッケージが "
1551 "Debian アーカイブに受け入れられるまではバグを閉じてはいけません。従って、一旦"
1552 "更新したパッケージがアーカイブにインストールされたという通知を受け取った場合"
1553 "は、BTS でバグを閉じることができますし、そうしなければいけません。もちろん、"
1554 "バグは正しいバージョンで閉じなくてはいけません。"
1556 # type: Content of: <chapter><section><section><para>
1557 #. type: Content of: <chapter><section><section><para>
1560 "However, it's possible to avoid having to manually close bugs after the "
1561 "upload — just list the fixed bugs in your <filename>debian/changelog</"
1562 "filename> file, following a certain syntax, and the archive maintenance "
1563 "software will close the bugs for you. For example:"
1565 "ですが、アップロード後に手動でバグをクローズしなくても済む方法があります — "
1566 "<filename>debian/changelog</filename> に以下の特定の書き方にて修正したバグを"
1567 "列挙すれば、それだけで後はアーカイブのメンテナンスソフトがバグをクローズして"
1570 # type: Content of: <chapter><section><section><screen>
1571 #. type: Content of: <chapter><section><section><screen>
1575 "acme-cannon (3.1415) unstable; urgency=low\n"
1577 " * Frobbed with options (closes: Bug#98339)\n"
1578 " * Added safety to prevent operator dismemberment, closes: bug#98765,\n"
1579 " bug#98713, #98714.\n"
1580 " * Added man page. Closes: #98725.\n"
1582 "acme-cannon (3.1415) unstable; urgency=low\n"
1584 " * Frobbed with options (closes: Bug#98339)\n"
1585 " * Added safety to prevent operator dismemberment, closes: bug#98765,\n"
1586 " bug#98713, #98714.\n"
1587 " * Added man page. Closes: #98725.\n"
1589 # type: Content of: <chapter><section><section><para>
1590 #. type: Content of: <chapter><section><section><para>
1593 "Technically speaking, the following Perl regular expression describes how "
1594 "bug closing changelogs are identified:"
1596 "技術的に言うと、どの様にしてバグを閉じる changelog が判別されているかを以下"
1597 "の Perl の正規表現にて記述しています:"
1599 # type: Content of: <chapter><section><section><screen>
1600 #. type: Content of: <chapter><section><section><screen>
1603 msgid " /closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig\n"
1604 msgstr " /closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig\n"
1606 #. type: Content of: <chapter><section><section><para>
1609 "We prefer the <literal>closes: #<replaceable>XXX</replaceable></literal> "
1610 "syntax, as it is the most concise entry and the easiest to integrate with "
1611 "the text of the <filename>changelog</filename>. Unless specified different "
1612 "by the <literal>-v</literal>-switch to <command>dpkg-buildpackage</command>, "
1613 "only the bugs closed in the most recent changelog entry are closed "
1614 "(basically, exactly the bugs mentioned in the changelog-part in the "
1615 "<filename>.changes</filename> file are closed)."
1617 "<literal>closes: #<replaceable>XXX</replaceable></literal> という書き方が推奨"
1618 "されています。これは、最も分かり易いエントリで、<filename>changelog</"
1619 "filename> の本文に挿入するのがもっとも簡単だからです。<command>dpkg-"
1620 "buildpackage</command> に <literal>-v</literal> スイッチを指定して別バージョ"
1621 "ンを指定しない限り、最も新しい changelog のエントリにあるバグだけが閉じられま"
1622 "す (基本的には、です。正確には <filename>.changes</filename> ファイルの "
1623 "changelog-part で明示されたバグが閉じられます)。"
1625 #. type: Content of: <chapter><section><section><para>
1628 "Historically, uploads identified as <link linkend=\"nmu\">non-maintainer "
1629 "upload (NMU)</link> were tagged <literal>fixed</literal> instead of being "
1630 "closed, but that practice was ceased with the advent of version-tracking. "
1631 "The same applied to the tag <literal>fixed-in-experimental</literal>."
1633 "歴史的に、<link linkend=\"nmu\">non-maintainer upload (NMU)</link> と判別され"
1634 "るアップロードは closed ではなく <literal>fixed</literal> とタグがされてきま"
1635 "したが、この習慣はバージョントラッキングの進化によって廃れています。同じこと"
1636 "が <literal>fixed-in-experimental</literal> タグにも言えます。"
1638 #. type: Content of: <chapter><section><section><para>
1641 "If you happen to mistype a bug number or forget a bug in the changelog "
1642 "entries, don't hesitate to undo any damage the error caused. To reopen "
1643 "wrongly closed bugs, send a <literal>reopen <replaceable>XXX</replaceable></"
1644 "literal> command to the bug tracking system's control address, &email-bts-"
1645 "control;. To close any remaining bugs that were fixed by your upload, email "
1646 "the <filename>.changes</filename> file to <email><replaceable>XXX</"
1647 "replaceable>-done@&bugs-host;</email>, where <replaceable>XXX</replaceable> "
1648 "is the bug number, and put Version: <replaceable>YYY</replaceable> and an "
1649 "empty line as the first two lines of the body of the email, where "
1650 "<replaceable>YYY</replaceable> is the first version where the bug has been "
1653 "もしバグ場号を間違って入力したり、changelog のエントリにバグを入れ忘れた場"
1654 "合、そのミスが起こすであろうダメージを防ぐのを躊躇わないでください。誤って閉"
1655 "じたバグを再度オープンにするには、バグトラッキングシステムのコントロールアド"
1656 "レスである &email-bts-control; に <literal>reopen <replaceable>XXX</"
1657 "replaceable></literal> コマンドを投げます。アップロードで修正されたがまだ残っ"
1658 "ているバグを閉じるには <filename>.changes</filename> ファイルを "
1659 "<email><replaceable>XXX</replaceable>-done@&bugs-host;</email> にメールしま"
1660 "す。<replaceable>XXX</replaceable> はバグ番号で、メールの本文の最初の 2 行に "
1661 "Version: <replaceable>YYY</replaceable> と空白行を入れます。"
1662 "<replaceable>YYY</replaceable> はバグが修正された最初のバージョンです。"
1664 #. type: Content of: <chapter><section><section><para>
1667 "Bear in mind that it is not obligatory to close bugs using the changelog as "
1668 "described above. If you simply want to close bugs that don't have anything "
1669 "to do with an upload you made, do it by emailing an explanation to "
1670 "<email><replaceable>XXX</replaceable>-done@&bugs-host;</email>. Do "
1671 "<emphasis role=\"strong\">not</emphasis> close bugs in the changelog entry "
1672 "of a version if the changes in that version of the package don't have any "
1673 "bearing on the bug."
1675 "上に書いたような changelog を使ったバグの閉じ方は必須ではない、ということは念"
1676 "頭に置いておいてください。行ったアップロードとは無関係に単にバグを閉じたい、"
1677 "という場合は、説明をメールに書いて <email><replaceable>XXX</replaceable>-"
1678 "done@&bugs-host;</email> に送ってバグを閉じてください。そのバージョンのパッ"
1679 "ケージでの変更がバグに何も関係ない場合は、そのバージョンの changelog エントリ"
1680 "ではバグを<emphasis role=\"strong\">閉じないで</emphasis>ください。"
1682 # type: Content of: <chapter><section><section><para>
1683 #. type: Content of: <chapter><section><section><para>
1686 "For general information on how to write your changelog entries, see <xref "
1687 "linkend=\"bpp-debian-changelog\"/>."
1689 "どのように changelog のエントリを書くのか、一般的な情報については <xref "
1690 "linkend=\"bpp-debian-changelog\"/> を参照してください。"
1692 # type: Content of: <chapter><section><section><title>
1693 #. type: Content of: <chapter><section><section><title>
1695 msgid "Handling security-related bugs"
1696 msgstr "セキュリティ関連バグの取扱い"
1698 # type: Content of: <chapter><section><section><para>
1699 #. type: Content of: <chapter><section><section><para>
1702 "Due to their sensitive nature, security-related bugs must be handled "
1703 "carefully. The Debian Security Team exists to coordinate this activity, "
1704 "keeping track of outstanding security problems, helping maintainers with "
1705 "security problems or fixing them themselves, sending security advisories, "
1706 "and maintaining <literal>security.debian.org</literal>."
1708 "機密性が高いその性質上、セキュリティ関連のバグは注意深く取り扱わねばなりませ"
1709 "ん。この作業をコーディネイトし、未処理のセキュリティ問題を追い続け、セキュリ"
1710 "ティ問題についてメンテナを手助けしたり修正自体を行い、セキュリティ勧告を出"
1711 "し、<literal>security.debian.org</literal> を維持するために Debian セキュリ"
1714 #. type: Content of: <chapter><section><section><para>
1717 "When you become aware of a security-related bug in a Debian package, whether "
1718 "or not you are the maintainer, collect pertinent information about the "
1719 "problem, and promptly contact the security team at &email-security-team; as "
1720 "soon as possible. <emphasis role=\"strong\">DO NOT UPLOAD</emphasis> any "
1721 "packages for <literal>stable</literal> without contacting the team. Useful "
1722 "information includes, for example:"
1724 "Debian パッケージ中のセキュリティ関連のバグに気づいたら、あなたがメンテナであ"
1725 "るかどうかに関わらず、問題に関する正確な情報を集めて、まずは可能な限り早く "
1726 "&email-security-team; 宛でセキュリティチームに連絡を取ってください。チームに"
1727 "問い合わせること無く <literal>安定版 (stable)</literal> 向けのパッケージを"
1728 "<emphasis role=\"strong\">アップロードしないでください</emphasis>。例えば、役"
1731 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1732 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1735 "Which versions of the package are known to be affected by the bug. Check "
1736 "each version that is present in a supported Debian release, as well as "
1737 "<literal>testing</literal> and <literal>unstable</literal>."
1739 "バグによって、どのバージョンが影響を受けると分かっているか。サポートされてい"
1740 "る Debian のリリース、ならびに <literal>テスト版 (testing)</literal> 及び "
1741 "<literal>不安定版 (unstable)</literal> にある各バージョンをチェックしてくださ"
1744 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1745 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1748 "The nature of the fix, if any is available (patches are especially helpful)"
1749 msgstr "利用可能なものがあれば、修正内容 (パッチが特に望ましい)"
1751 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1752 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1755 "Any fixed packages that you have prepared yourself (send only the <filename>."
1756 "diff.gz</filename> and <filename>.dsc</filename> files and read <xref "
1757 "linkend=\"bug-security-building\"/> first)"
1759 "自身で準備した修正パッケージ (まずは <xref linkend=\"bug-security-building\"/"
1760 "> を読んで、<filename>.diff.gz</filename> と <filename>.dsc</filename> ファイ"
1763 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1764 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1767 "Any assistance you can provide to help with testing (exploits, regression "
1770 "テストについて何かしらの手助けになるもの (攻撃コード、リグレッションテストな"
1773 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1774 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1777 "Any information needed for the advisory (see <xref linkend=\"bug-security-"
1780 "勧告に必要になる情報 (<xref linkend=\"bug-security-advisories\"/> 参照)"
1782 #. type: Content of: <chapter><section><section><para>
1785 "As the maintainer of the package, you have the responsibility to maintain "
1786 "it, even in the stable release. You are in the best position to evaluate "
1787 "patches and test updated packages, so please see the sections below on how "
1788 "to prepare packages for the Security Team to handle."
1790 "パッケージメンテナとして、あなたは安定版リリースについてもメンテナンスする責"
1791 "任を持ちます。あなたがパッチの評価と更新パッケージのテストを行うのに最も適任"
1792 "な人です。ですから、以下のセキュリティチームによって取り扱ってもらうため、ど"
1793 "のようにしてパッケージを用意するかについての章を参照してください。"
1795 #. type: Content of: <chapter><section><section><section><title>
1797 msgid "The Security Tracker"
1798 msgstr "セキュリティ追跡システム"
1800 #. type: Content of: <chapter><section><section><section><para>
1803 "The security team maintains a central database, the <ulink url=\"http://"
1804 "security-tracker.debian.org/\">Debian Security Tracker</ulink>. This "
1805 "contains all public information that is known about security issues: which "
1806 "packages and versions are affected or fixed, and thus whether stable, "
1807 "testing and/or unstable are vulnerable. Information that is still "
1808 "confidential is not added to the tracker."
1810 "セキュリティチームは集約的なデータベース、<ulink url=\"http://security-"
1811 "tracker.debian.org/\">Debian セキュリティ追跡システム (Debian Security "
1812 "Tracker)</ulink>をメンテナンスしています。これはセキュリティ問題として知られ"
1813 "ている全ての公開情報を含んでいます: どのパッケージ/バージョンが影響を受ける"
1814 "/修正されているか、つまりは安定版、テスト版、不安定版が脆弱かどうか、という"
1815 "情報です。まだ機密扱いの情報は追跡システムには追加されません。"
1817 #. type: Content of: <chapter><section><section><section><para>
1820 "You can search it for a specific issue, but also on package name. Look for "
1821 "your package to see which issues are still open. If you can, please provide "
1822 "more information about those issues, or help to address them in your "
1823 "package. Instructions are on the tracker web pages."
1825 "特定の問題について検索することもできますし、パッケージ名でも検索できます。あ"
1826 "なたのパッケージを探して、どの問題がまだ未解決かを確認してください。できれば"
1827 "追加情報を提供するか、パッケージの問題に対処するのを手伝ってください。やり方"
1828 "は追跡システムのウェブページにあります。"
1830 # type: Content of: <chapter><section><section><section><title>
1831 #. type: Content of: <chapter><section><section><section><title>
1833 msgid "Confidentiality"
1836 # type: Content of: <chapter><section><section><section><para>
1837 #. type: Content of: <chapter><section><section><section><para>
1840 "Unlike most other activities within Debian, information about security "
1841 "issues must sometimes be kept private for a time. This allows software "
1842 "distributors to coordinate their disclosure in order to minimize their "
1843 "users' exposure. Whether this is the case depends on the nature of the "
1844 "problem and corresponding fix, and whether it is already a matter of public "
1847 "Debian 内での他の多くの活動とは違い、セキュリティ問題に関する情報については、"
1848 "暫くの間秘密にしておく必要がしばしばあります。これによって、ソフトウェアの"
1849 "ディストリビュータがユーザが危険にさらされるのを最小限にするため、公開時期を"
1850 "合わせることができます。今回がそうであるかは、問題と対応する修正の性質や、既"
1851 "に既知のものとなっているかどうかによります。"
1853 # type: Content of: <chapter><section><section><section><para>
1854 #. type: Content of: <chapter><section><section><section><para>
1856 msgid "There are several ways developers can learn of a security problem:"
1857 msgstr "開発者がセキュリティ問題を知る方法はいくつかあります:"
1859 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1860 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1862 msgid "they notice it on a public forum (mailing list, web site, etc.)"
1863 msgstr "公開フォーラム (メーリングリスト、ウェブサイトなど) で知らせる"
1865 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1866 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1868 msgid "someone files a bug report"
1869 msgstr "誰かがバグ報告を登録している"
1871 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1872 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1874 msgid "someone informs them via private email"
1875 msgstr "誰かがプライベートなメールで教えてきた"
1877 # type: Content of: <chapter><section><section><section><para>
1878 #. type: Content of: <chapter><section><section><section><para>
1881 "In the first two cases, the information is public and it is important to "
1882 "have a fix as soon as possible. In the last case, however, it might not be "
1883 "public information. In that case there are a few possible options for "
1884 "dealing with the problem:"
1886 "最初の二つのケースでは、情報は公開されていて可能な限り早く修正することが重要"
1887 "です。しかしながら最後のケースは、公開情報ではないかもしれません。この場合"
1888 "は、問題に対処するのに幾つか取り得る選択肢があります:"
1890 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1891 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1894 "If the security exposure is minor, there is sometimes no need to keep the "
1895 "problem a secret and a fix should be made and released."
1897 "セキュリティの影響度が小さい場合、問題を秘密にしておく必要はなく、修正を行っ"
1898 "てリリースするのが良い場合がしばしばあります。"
1900 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1901 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1904 "If the problem is severe, it is preferable to share the information with "
1905 "other vendors and coordinate a release. The security team keeps in contact "
1906 "with the various organizations and individuals and can take care of that."
1908 "問題が深刻な場合、他のベンダと情報を共有してリリースをコーディネイトする方が"
1909 "望ましいでしょう。セキュリティチームは様々な組織/個人と連絡を取りつづけ、こ"
1912 # type: Content of: <chapter><section><section><section><para>
1913 #. type: Content of: <chapter><section><section><section><para>
1916 "In all cases if the person who reports the problem asks that it not be "
1917 "disclosed, such requests should be honored, with the obvious exception of "
1918 "informing the security team in order that a fix may be produced for a stable "
1919 "release of Debian. When sending confidential information to the security "
1920 "team, be sure to mention this fact."
1922 "どのような場合でも、問題を報告した人がこれを公開しないように求めているのであ"
1923 "れば、明白な例外として Debian の安定版リリースに対する修正を作成してもらうた"
1924 "めにセキュリティチームへ連絡すること以外、この様な要求は尊重されるべきです。"
1925 "機密情報をセキュリティチームに送る場合は、この点を明示しておくのを忘れないで"
1928 # type: Content of: <chapter><section><section><section><para>
1929 #. type: Content of: <chapter><section><section><section><para>
1932 "Please note that if secrecy is needed you may not upload a fix to "
1933 "<literal>unstable</literal> (or anywhere else, such as a public VCS "
1934 "repository). It is not sufficient to obfuscate the details of the change, "
1935 "as the code itself is public, and can (and will) be examined by the general "
1938 "機密を要する場合は、修正を<literal>不安定版 (unstable)</literal> (や公開 VCS "
1939 "リポジトリなどその他どこへも) へ修正をアップロードしないよう、注意してくださ"
1940 "い。コードその物が公開されている場合、変更の詳細を難読化するだけでは十分では"
1941 "なく、皆によって解析され得る (そしてされる) でしょう。"
1943 # type: Content of: <chapter><section><section><section><para>
1944 #. type: Content of: <chapter><section><section><section><para>
1947 "There are two reasons for releasing information even though secrecy is "
1948 "requested: the problem has been known for a while, or the problem or exploit "
1949 "has become public."
1951 "機密であることを要求されたにも関わらず、情報を公開するのには 2 つの理由があり"
1952 "ます: 問題が一定期間既知の状態になっている、あるいは問題や攻撃コードが公開さ"
1955 #. type: Content of: <chapter><section><section><section><para>
1958 "The Security Team has a PGP-key to enable encrypted communication about "
1959 "sensitive issues. See the <ulink url=\"http://www.debian.org/security/"
1960 "faq#contact\">Security Team FAQ</ulink> for details."
1962 "セキュリティチームは、機密事項に関して通信を暗号化できる PGP 鍵を持っていま"
1963 "す。詳細については、<ulink url=\"http://www.debian.org/security/faq#contact"
1964 "\">セキュリティチーム FAQ</ulink> を参照してください。"
1966 # type: Content of: <chapter><section><section><section><title>
1967 #. type: Content of: <chapter><section><section><section><title>
1969 msgid "Security Advisories"
1972 # type: Content of: <chapter><section><section><section><para>
1973 # FIXME: how about oldstable?
1974 #. type: Content of: <chapter><section><section><section><para>
1977 "Security advisories are only issued for the current, released stable "
1978 "distribution, and <emphasis>not</emphasis> for <literal>testing</literal> or "
1979 "<literal>unstable</literal>. When released, advisories are sent to the "
1980 "&email-debian-security-announce; mailing list and posted on <ulink url="
1981 "\"&url-debian-security-advisories;\">the security web page</ulink>. "
1982 "Security advisories are written and posted by the security team. However "
1983 "they certainly do not mind if a maintainer can supply some of the "
1984 "information for them, or write part of the text. Information that should be "
1985 "in an advisory includes:"
1987 "セキュリティ勧告は現在のところ、リリースされた安定版ディストリビューションに"
1988 "ついてのみ、取り扱われます。<literal>テスト版 (testing)</literal> や "
1989 "<literal>不安定版 (unstable)</literal> についてでは<emphasis>ありません</"
1990 "emphasis>。リリースされると、セキュリティ勧告は email-debian-security-"
1991 "announce; メーリングリストに送られ、<ulink url=\"&url-debian-security-"
1992 "advisories;\">セキュリティのウェブページ</ulink>に掲載されます。セキュリティ"
1993 "勧告はセキュリティチームによって記述、掲載されます。しかし、メンテナが情報を"
1994 "提供できたり、文章の一部を書けるのであれば、彼らは当然そんなことは気にしませ"
1995 "ん。勧告にあるべき情報は以下を含んでいます:"
1997 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1998 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2000 msgid "A description of the problem and its scope, including:"
2001 msgstr "以下のようなものを含めた問題の説明と範囲:"
2003 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2004 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2006 msgid "The type of problem (privilege escalation, denial of service, etc.)"
2007 msgstr "問題の種類 (権限の上昇、サービス拒否など)"
2009 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2010 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2012 msgid "What privileges may be gained, and by whom (if any)"
2013 msgstr "何の権限が得られるのか、(もし分かれば) 誰が得るのか"
2015 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2016 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2018 msgid "How it can be exploited"
2019 msgstr "どのようにして攻撃が可能なのか"
2021 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2022 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2024 msgid "Whether it is remotely or locally exploitable"
2025 msgstr "攻撃はリモートから可能なのかそれともローカルから可能なのか"
2027 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2028 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
2030 msgid "How the problem was fixed"
2031 msgstr "どのようにして問題が修正されたのか"
2033 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2034 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2036 msgid "This information allows users to assess the threat to their systems."
2038 "この情報によって、ユーザがシステムに対する脅威を評価できるようになります。"
2040 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2041 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2043 msgid "Version numbers of affected packages"
2044 msgstr "影響を受けるパッケージのバージョン番号"
2046 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2047 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2049 msgid "Version numbers of fixed packages"
2050 msgstr "修正されたパッケージのバージョン番号"
2052 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2053 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2056 "Information on where to obtain the updated packages (usually from the Debian "
2059 "どこで更新されたパッケージを得るかという情報 (通常は Debian のセキュリティ"
2062 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2063 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2066 "References to upstream advisories, <ulink url=\"http://cve.mitre.org\">CVE</"
2067 "ulink> identifiers, and any other information useful in cross-referencing "
2070 "開発元のアドバイザリへの参照、<ulink url=\"http://cve.mitre.org\">CVE</"
2071 "ulink> 番号、脆弱性の相互参照について役立つその他の情報"
2073 # type: Content of: <chapter><section><section><section><title>
2074 #. type: Content of: <chapter><section><section><section><title>
2076 msgid "Preparing packages to address security issues"
2077 msgstr "セキュリティ問題に対処するパッケージを用意する"
2079 # type: Content of: <chapter><section><section><section><para>
2080 #. type: Content of: <chapter><section><section><section><para>
2083 "One way that you can assist the security team in their duties is to provide "
2084 "them with fixed packages suitable for a security advisory for the stable "
2087 "あなたがセキュリティチームに対し、彼らの職務に関して手助けできる方法の一つ"
2088 "は、安定版 Debian リリース用のセキュリティ勧告に適した修正版パッケージを提供"
2091 # type: Content of: <chapter><section><section><section><para>
2092 #. type: Content of: <chapter><section><section><section><para>
2095 "When an update is made to the stable release, care must be taken to avoid "
2096 "changing system behavior or introducing new bugs. In order to do this, make "
2097 "as few changes as possible to fix the bug. Users and administrators rely on "
2098 "the exact behavior of a release once it is made, so any change that is made "
2099 "might break someone's system. This is especially true of libraries: make "
2100 "sure you never change the API or ABI, no matter how small the change."
2102 "安定版について更新が作成される際、システムの挙動の変化や新しいバグの導入を避"
2103 "けるように注意が必要です。これを行うため、バグを修正するための変更は可能な限"
2104 "り少なくします。ユーザや管理者は一旦リリースされたものの厳密な挙動を当てにし"
2105 "ているので、どのような変更でも誰かのシステムを壊しかねません。これは特にライ"
2106 "ブラリについて当てはまります: API や ABI を決して変更していないことを確認して"
2107 "ください。変更がどれほど小さいものでも関係ありません。"
2109 # type: Content of: <chapter><section><section><section><para>
2110 #. type: Content of: <chapter><section><section><section><para>
2113 "This means that moving to a new upstream version is not a good solution. "
2114 "Instead, the relevant changes should be back-ported to the version present "
2115 "in the current stable Debian release. Generally, upstream maintainers are "
2116 "willing to help if needed. If not, the Debian security team may be able to "
2119 "これは、開発元の新しいリリースバージョン (new upstream version) への移行が良"
2120 "い解決策ではないことを意味しています。代わりに、関連する変更を現在の Debian "
2121 "安定版リリースに存在しているバージョンへバックポートするべきです。通常、開発"
2122 "元のメンテナは助けが必要であれば手伝おうとしてくれます。そうでない場合は、"
2123 "Debian セキュリティチームが手助けすることができます。"
2125 # type: Content of: <chapter><section><section><section><para>
2126 #. type: Content of: <chapter><section><section><section><para>
2129 "In some cases, it is not possible to back-port a security fix, for example "
2130 "when large amounts of source code need to be modified or rewritten. If this "
2131 "happens, it may be necessary to move to a new upstream version. However, "
2132 "this is only done in extreme situations, and you must always coordinate that "
2133 "with the security team beforehand."
2135 "いくつかのケースでは、例えば大量のソースコードの変更や書き直しが必要など、セ"
2136 "キュリティ修正をバックポートできないことがあります。この様な場合、新しいバー"
2137 "ジョン (new upstream version) へ移行する必要があるかもしれません。しかし、こ"
2138 "れは極端な状況の場合にのみ行われるものであり、実行する前に必ずセキュリティ"
2139 "チームと調整をしなければなりません。"
2141 # type: Content of: <chapter><section><section><section><para>
2142 #. type: Content of: <chapter><section><section><section><para>
2145 "Related to this is another important guideline: always test your changes. "
2146 "If you have an exploit available, try it and see if it indeed succeeds on "
2147 "the unpatched package and fails on the fixed package. Test other, normal "
2148 "actions as well, as sometimes a security fix can break seemingly unrelated "
2149 "features in subtle ways."
2151 "これに関してはもう一つ重要な指針があります: 必ず変更についてテストをしてくだ"
2152 "さい。攻撃用コード (exploit) が入手可能な場合には、それを試してみて、パッチを"
2153 "当てていないパッケージで成功するか、修正したパッケージでは失敗することかどう"
2154 "かを確かめてみてください。他の確認として、セキュリティ修正は時折表面上はそれ"
2155 "と関係が無いような機能を壊すことがあるので、通常の動作も同様にテストしてくだ"
2158 # type: Content of: <chapter><section><section><section><para>
2159 #. type: Content of: <chapter><section><section><section><para>
2162 "Do <emphasis role=\"strong\">NOT</emphasis> include any changes in your "
2163 "package which are not directly related to fixing the vulnerability. These "
2164 "will only need to be reverted, and this wastes time. If there are other "
2165 "bugs in your package that you would like to fix, make an upload to proposed-"
2166 "updates in the usual way, after the security advisory is issued. The "
2167 "security update mechanism is not a means for introducing changes to your "
2168 "package which would otherwise be rejected from the stable release, so please "
2169 "do not attempt to do this."
2171 "脆弱性の修正に直接関係しない変更をパッケージへ<emphasis role=\"strong\">加え"
2172 "ない</emphasis>ようにしてください。この様な変更は元に戻さなくてはならなくなる"
2173 "だけで、時間を無駄にします。他に直したいバグがパッケージにある場合は、セキュ"
2174 "リティ勧告が発行された後、通常通りに proposed-update にアップロードを行ってく"
2175 "ださい。セキュリティ更新の仕組みは、それ以外の方法では安定版リリースから "
2176 "reject されるであろう変更をあなたのパッケージに加える方法ではありませんので、"
2179 #. type: Content of: <chapter><section><section><section><para>
2182 "Review and test your changes as much as possible. Check the differences "
2183 "from the previous version repeatedly (<command>interdiff</command> from the "
2184 "<systemitem role=\"package\">patchutils</systemitem> package and "
2185 "<command>debdiff</command> from <systemitem role=\"package\">devscripts</"
2186 "systemitem> are useful tools for this, see <xref linkend=\"debdiff\"/>)."
2188 "変更点を可能な限り見直してください。以前のバージョンとの変更点を繰り返し確認"
2189 "してください (これには <systemitem role=\"package\">patchutils</systemitem> "
2190 "パッケージの <command>interdiff</command> や <systemitem role=\"package"
2191 "\">devscripts</systemitem> の <command>debdiff</command> が役立ちます。<xref "
2192 "linkend=\"debdiff\"/> を参照してください)。"
2194 # type: Content of: <chapter><section><section><section><para>
2195 #. type: Content of: <chapter><section><section><section><para>
2197 msgid "Be sure to verify the following items:"
2198 msgstr "以下の項目を必ず確認してください"
2200 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2203 "<emphasis role=\"strong\">Target the right distribution</emphasis> in your "
2204 "<filename>debian/changelog</filename>. For <literal>stable</literal> this "
2205 "is <literal>stable-security</literal> and for <literal>testing</literal> "
2206 "this is <literal>testing-security</literal>, and for the previous stable "
2207 "release, this is <literal>oldstable-security</literal>. Do not target "
2208 "<replaceable>distribution</replaceable><literal>-proposed-updates</literal> "
2209 "or <literal>stable</literal>!"
2211 "<filename>debian/changelog</filename> で <emphasis role=\"strong\">正しいディ"
2212 "ストリビューションを対象にする</emphasis>。<literal>安定版 (stable)</"
2213 "literal> の場合、これは <literal>stable-security</literal> になり、<literal>"
2214 "テスト版 (testing)</literal> の場合は <literal>testing-security</literal> "
2215 "に、そして以前の安定版リリースへの場合は <literal>oldstable-security</"
2216 "literal> となります。<replaceable>distribution</replaceable><literal>-"
2217 "proposed-updates</literal> や <literal>stable</literal> を対象にしないでくだ"
2220 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2221 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2224 "The upload should have <emphasis role=\"strong\">urgency=high</emphasis>."
2226 "アップロードは <emphasis role=\"strong\">urgency=high</emphasis> で行う必要が"
2229 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2232 "Make descriptive, meaningful changelog entries. Others will rely on them to "
2233 "determine whether a particular bug was fixed. Add <literal>closes:</"
2234 "literal> statements for any <emphasis role=\"strong\">Debian bugs</emphasis> "
2235 "filed. Always include an external reference, preferably a <emphasis role="
2236 "\"strong\">CVE identifier</emphasis>, so that it can be cross-referenced. "
2237 "However, if a CVE identifier has not yet been assigned, do not wait for it "
2238 "but continue the process. The identifier can be cross-referenced later."
2240 "説明が十分にされている、意味がある changelog エントリを書くこと。他の人は、こ"
2241 "れらを元に特定のバグが修正されているのかを見つけ出します。登録されている "
2242 "<emphasis role=\"strong\">Debian バグ</emphasis> に対して <literal>closes:</"
2243 "literal> 行を追加すること。外部のリファレンス、できれば <emphasis role="
2244 "\"strong\">CVE 識別番号</emphasis> を常に含めること、そうすれば相互参照が可能"
2245 "になります。しかし、CVE 識別番号がまだ付与されていない場合には、それを待たず"
2246 "に作業を進めてください。識別番号は後ほど付与することができます。"
2248 # FIXME: etch1 -> <stable code>
2250 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2253 "Make sure the <emphasis role=\"strong\">version number</emphasis> is "
2254 "proper. It must be greater than the current package, but less than package "
2255 "versions in later distributions. If in doubt, test it with <literal>dpkg --"
2256 "compare-versions</literal>. Be careful not to re-use a version number that "
2257 "you have already used for a previous upload, or one that conflicts with a "
2258 "binNMU. The convention is to append <literal>+</"
2259 "literal><replaceable>codename</replaceable><literal>1</literal>, e.g. "
2260 "<literal>1:2.4.3-4+lenny1</literal>, of course increasing 1 for any "
2261 "subsequent uploads."
2263 "<emphasis role=\"strong\">バージョン番号</emphasis>が正しいことを確認する。現"
2264 "在のパッケージより大きく、しかし以降のディストリビューションよりパッケージ"
2265 "バージョンが小さい必要があります。分からない場合は <literal>dpkg --compare-"
2266 "versions</literal> でテストしてください。以前のアップロードで既に使っている"
2267 "バージョン番号を再利用しないように注意してください。そうしないと番号が "
2268 "binNMU と衝突します。<literal>+</literal><replaceable>codename</"
2269 "replaceable><literal>1</literal> を追加するのが通例です。例えば "
2270 "<literal>1:2.4.3-4+lenny1</literal> とします。もちろん 1 はアップロードするご"
2274 # FIXME: how about debuild -sa ?
2275 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2278 "Unless the upstream source has been uploaded to <literal>security.debian."
2279 "org</literal> before (by a previous security update), build the upload "
2280 "<emphasis role=\"strong\">with full upstream source</emphasis> "
2281 "(<literal>dpkg-buildpackage -sa</literal>). If there has been a previous "
2282 "upload to <literal>security.debian.org</literal> with the same upstream "
2283 "version, you may upload without upstream source (<literal>dpkg-buildpackage -"
2286 "これまでに (以前のセキュリティ更新によって) <literal>security.debian.org</"
2287 "literal> へ開発元のソースコードをアップロードしていなければ、<emphasis role="
2288 "\"strong\">開発元のソースコードを全て含めて</emphasis>アップロードするパッ"
2289 "ケージをビルドする (<literal>dpkg-buildpackage -sa</literal>)。以前、同じ開発"
2290 "元のバージョンで <literal>security.debian.org</literal> にアップロードしたこ"
2291 "とがある場合は、開発元のソースコード無しでアップロードしても構いません "
2292 "(<literal>dpkg-buildpackage -sd</literal>)。"
2294 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2297 "Be sure to use the <emphasis role=\"strong\">exact same <filename>*.orig.tar."
2298 "{gz,bz2,lzma}</filename></emphasis> as used in the normal archive, otherwise "
2299 "it is not possible to move the security fix into the main archives later."
2301 "通常のアーカイブで使われているのと<emphasis role=\"strong\">全く同じ "
2302 "<filename>*.orig.tar.{gz,bz2,lzma}</filename></emphasis>を必ず使うようにして"
2303 "ください。さもなくば、後ほどセキュリティ修正を main アーカイブに移動すること"
2306 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2309 "Build the package on a <emphasis role=\"strong\">clean system</emphasis> "
2310 "which only has packages installed from the distribution you are building "
2311 "for. If you do not have such a system yourself, you can use a debian.org "
2312 "machine (see <xref linkend=\"server-machines\"/>) or setup a chroot (see "
2313 "<xref linkend=\"pbuilder\"/> and <xref linkend=\"debootstrap\"/>)."
2315 "ビルドを行っているディストリビューションからインストールしたパッケージだけが"
2316 "含まれている<emphasis role=\"strong\">クリーンなシステム上で</emphasis>パッ"
2317 "ケージをビルドしてください。その様なシステムを自分で持っていない場合は、"
2318 "debian.org マシン (<xref linkend=\"server-machines\"/> を参照してください) を"
2319 "使うこともできますし、chroot を設定することもできます (<xref linkend="
2320 "\"pbuilder\"/> と <xref linkend=\"debootstrap\"/> を参照してください)。"
2322 # type: Content of: <chapter><section><section><section><title>
2323 #. type: Content of: <chapter><section><section><section><title>
2325 msgid "Uploading the fixed package"
2326 msgstr "修正したパッケージをアップロードする"
2328 # type: Content of: <chapter><section><section><para>
2329 #. type: Content of: <chapter><section><section><section><para>
2332 "Do <emphasis role=\"strong\">NOT</emphasis> upload a package to the security "
2333 "upload queue (<literal>oldstable-security</literal>, <literal>stable-"
2334 "security</literal>, etc.) without prior authorization from the security "
2335 "team. If the package does not exactly meet the team's requirements, it will "
2336 "cause many problems and delays in dealing with the unwanted upload."
2338 "セキュリティアップロードキュー (<literal>oldstable-security</literal>、"
2339 "<literal>stable-security </literal> 等) には、セキュリティチームからの事前許"
2340 "可無しにパッケージを<emphasis role=\"strong\">アップロードしないでください</"
2341 "emphasis>。パッケージがチームの要求に完全に合致していない場合、望まれないアッ"
2342 "プロードに対処するために多くの問題が引き起こされたり遅延が生じることになりま"
2343 "す。詳細については <xref linkend=\"bug-security\"/> を参照してください。"
2345 #. type: Content of: <chapter><section><section><section><para>
2348 "Do <emphasis role=\"strong\">NOT</emphasis> upload your fix to "
2349 "<literal>proposed-updates</literal> without coordinating with the security "
2350 "team. Packages from <literal>security.debian.org</literal> will be copied "
2351 "into the <literal>proposed-updates</literal> directory automatically. If a "
2352 "package with the same or a higher version number is already installed into "
2353 "the archive, the security update will be rejected by the archive system. "
2354 "That way, the stable distribution will end up without a security update for "
2355 "this package instead."
2357 "セキュリティチームと調整する事無しに <literal>proposed-updates</literal> へ修"
2358 "正したものをアップロード<emphasis role=\"strong\">しない</emphasis>ようにして"
2359 "ください。<literal>security.debian.org</literal> からパッケージは "
2360 "<literal>proposed-updates</literal> ディレクトリに自動的にコピーされます。"
2361 "アーカイブに同じ、あるいはより高いバージョン番号のものが既にインストールされ"
2362 "ている場合は、セキュリティアップデートはアーカイブシステムに reject されま"
2363 "す。そうすると、安定版ディストリビューションはこのパッケージに対するセキュリ"
2364 "ティ更新無しで終了してしまうでしょう。"
2366 #. type: Content of: <chapter><section><section><section><para>
2369 "Once you have created and tested the new package and it has been approved by "
2370 "the security team, it needs to be uploaded so that it can be installed in "
2371 "the archives. For security uploads, the place to upload to is "
2372 "<literal>ftp://security-master.debian.org/pub/SecurityUploadQueue/</literal>."
2374 "一旦、新しいパッケージを作成してテストし、セキュリティチームによって許可を受"
2375 "けたら、アーカイブへインストールできるようにするためにアップロードをする必要"
2376 "があります。セキュリティに関するアップロードの場合、アップロード先は "
2377 "<literal>ftp://security-master.debian.org/pub/SecurityUploadQueue/</literal> "
2380 #. type: Content of: <chapter><section><section><section><para>
2383 "Once an upload to the security queue has been accepted, the package will "
2384 "automatically be built for all architectures and stored for verification by "
2385 "the security team."
2387 "セキュリティキューへアップロードしたものが許可されると、パッケージは自動的に"
2388 "すべてのアーキテクチャに対してビルドされ、セキュリティチームによる確認の為に"
2391 # type: Content of: <chapter><section><section><section><para>
2392 #. type: Content of: <chapter><section><section><section><para>
2395 "Uploads which are waiting for acceptance or verification are only accessible "
2396 "by the security team. This is necessary since there might be fixes for "
2397 "security problems that cannot be disclosed yet."
2399 "許可、あるいは確認を待っているアップロードには、セキュリティチームのみがアク"
2400 "セスできます。これは、まだ公開できないセキュリティ問題の修正があるかも知れな"
2403 # type: Content of: <chapter><section><section><section><para>
2404 #. type: Content of: <chapter><section><section><section><para>
2407 "If a member of the security team accepts a package, it will be installed on "
2408 "<literal>security.debian.org</literal> as well as proposed for the proper "
2409 "<replaceable>distribution</replaceable><literal>-proposed-updates</literal> "
2410 "on <literal>&ftp-master-host;</literal>."
2412 "セキュリティチームのメンバーがパッケージを許可した場合は、proposed パッケージ"
2413 "に対する <literal>&ftp-master-host;</literal> 上の適切な "
2414 "<replaceable>distribution</replaceable><literal>-proposed-updates</literal> "
2415 "と同様に <literal>security.debian.org</literal> 上にインストールされます。"
2417 # type: Content of: <chapter><section><title>
2418 #. type: Content of: <chapter><section><title>
2420 msgid "Moving, removing, renaming, adopting, and orphaning packages"
2421 msgstr "パッケージの移動、削除、リネーム、変更、みなしご化"
2423 # type: Content of: <chapter><section><para>
2424 #. type: Content of: <chapter><section><para>
2427 "Some archive manipulation operations are not automated in the Debian upload "
2428 "process. These procedures should be manually followed by maintainers. This "
2429 "chapter gives guidelines on what to do in these cases."
2431 "アーカイブの変更作業のいくつかは、Debian のアップロードプロセスでは自動的なも"
2432 "のにはなっていません。これらの手続きはメンテナによる手動での作業である必要が"
2433 "あります。この章では、この様な場合に何をするかのガイドラインを提供します。"
2435 # type: Content of: <chapter><section><section><title>
2436 #. type: Content of: <chapter><section><section><title>
2438 msgid "Moving packages"
2441 # type: Content of: <chapter><section><section><para><footnote><para>
2442 #. type: Content of: <chapter><section><section><para><footnote><para>
2445 "See the <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for "
2446 "guidelines on what section a package belongs in."
2448 "パッケージがどのセクションに属するかのガイドラインは <ulink url=\"&url-"
2449 "debian-policy;\">Debian ポリシーマニュアル</ulink>を参照してください。"
2451 #. type: Content of: <chapter><section><section><para>
2454 "Sometimes a package will change its section. For instance, a package from "
2455 "the `non-free' section might be GPL'd in a later version, in which case the "
2456 "package should be moved to `main' or `contrib'.<placeholder type=\"footnote"
2459 "時折、パッケージは属しているセクションが変わることがあります。例えば「non-"
2460 "free」セクションのパッケージが新しいバージョンで GPL になった場合、パッケージ"
2461 "は「main」か「contrib」に移動する必要があります。<placeholder type=\"footnote"
2464 #. type: Content of: <chapter><section><section><para>
2467 "If you need to change the section for one of your packages, change the "
2468 "package control information to place the package in the desired section, and "
2469 "re-upload the package (see the <ulink url=\"&url-debian-policy;\">Debian "
2470 "Policy Manual</ulink> for details). You must ensure that you include the "
2471 "<filename>.orig.tar.{gz,bz2,lzma}</filename> in your upload (even if you are "
2472 "not uploading a new upstream version), or it will not appear in the new "
2473 "section together with the rest of the package. If your new section is "
2474 "valid, it will be moved automatically. If it does not, then contact the "
2475 "ftpmasters in order to understand what happened."
2477 "パッケージのどれかがセクションを変更する必要がある場合、希望するセクションに"
2478 "パッケージを配置するためパッケージの control 情報を変更してから再アップロード"
2479 "します (詳細については <ulink url=\"&url-debian-policy;\">Debian ポリシーマ"
2480 "ニュアル</ulink>を参照してください)。必ず <filename>.orig.tar.{gz,bz2,lzma}</"
2481 "filename> を (開発元のバージョンが新しいものになったのではなくても) アップ"
2482 "ロードに含める必要があります。新しいセクションが正しい場合は、自動的に移動さ"
2483 "れます。移動されない場合には、何が起こったのかを理解するために ftpmaster に連"
2486 #. type: Content of: <chapter><section><section><para>
2489 "If, on the other hand, you need to change the <literal>subsection</literal> "
2490 "of one of your packages (e.g., ``devel'', ``admin''), the procedure is "
2491 "slightly different. Correct the subsection as found in the control file of "
2492 "the package, and re-upload that. Also, you'll need to get the override file "
2493 "updated, as described in <xref linkend=\"override-file\"/>."
2495 "一方で、もしパッケージの一つの<literal>サブセクション</literal> (例:「devel」"
2496 "「admin」) を変更する必要がある、という場合には、手順は全く異なります。パッ"
2497 "ケージの control ファイルにあるサブセクションを修正して、再アップロードしま"
2498 "す。また、<xref linkend=\"override-file\"/> に記述してあるように override "
2499 "ファイルを更新する必要が出てくるでしょう。"
2501 # type: Content of: <chapter><section><section><title>
2502 #. type: Content of: <chapter><section><section><title>
2504 msgid "Removing packages"
2507 #. type: Content of: <chapter><section><section><para>
2510 "If for some reason you want to completely remove a package (say, if it is an "
2511 "old compatibility library which is no longer required), you need to file a "
2512 "bug against <literal>ftp.debian.org</literal> asking that the package be "
2513 "removed; as all bugs, this bug should normally have normal severity. The "
2514 "bug title should be in the form <literal>RM: <replaceable>package</"
2515 "replaceable> <replaceable>[architecture list]</replaceable> -- "
2516 "<replaceable>reason</replaceable></literal>, where <replaceable>package</"
2517 "replaceable> is the package to be removed and <replaceable>reason</"
2518 "replaceable> is a short summary of the reason for the removal request. "
2519 "<replaceable>[architecture list]</replaceable> is optional and only needed "
2520 "if the removal request only applies to some architectures, not all. Note "
2521 "that the <command>reportbug</command> will create a title conforming to "
2522 "these rules when you use it to report a bug against the <literal>ftp.debian."
2523 "org</literal> pseudo-package."
2525 "何らかの理由でパッケージを完全に削除したくなった場合 (もう必要がなくなった古"
2526 "い互換用ライブラリの場合、など)、パッケージを削除するよう <literal>ftp."
2527 "debian.org</literal> に対してバグ登録をする必要があります; すべてのバグ同様、"
2528 "通常このバグは重要度 normal です。バグの題名は <literal>RM: <replaceable>パッ"
2529 "ケージ名</replaceable> <replaceable>[アーキテクチャ一覧]</replaceable> -- "
2530 "<replaceable>理由</replaceable></literal> という形式である必要があります。"
2531 "<replaceable>パッケージ名</replaceable>は削除されるパッケージ、<replaceable>"
2532 "理由</replaceable>は削除を依頼する理由の短い要約です。<replaceable>[アーキテ"
2533 "クチャ一覧]</replaceable>はオプションで、削除依頼が全アーキテクチャではなく一"
2534 "部のアーキテクチャのみに適用される場合にのみ、必要となります。"
2535 "<command>reportbug</command> は <literal>ftp.debian.org</literal> 擬似パッ"
2536 "ケージに対してバグを報告しようとした場合に、これらのルールに則ってバグの題名"
2537 "を作成しようとすることに注意してください。"
2539 # type: Content of: <chapter><section><section><para>
2540 #. type: Content of: <chapter><section><section><para>
2543 "If you want to remove a package you maintain, you should note this in the "
2544 "bug title by prepending <literal>ROM</literal> (Request Of Maintainer). "
2545 "There are several other standard acronyms used in the reasoning for a "
2546 "package removal, see <ulink url=\"http://&ftp-master-host;/removals.html\"></"
2547 "ulink> for a complete list. That page also provides a convenient overview of "
2548 "pending removal requests."
2550 "あなたがメンテナンスしているパッケージを削除したくなった場合は、題名の先頭に "
2551 "<literal>ROM</literal> (Request Of Maintainer) という文字を付けたバグにこれを"
2552 "記述する必要があります。パッケージの削除理由に使われる他の一般的な略語が幾つ"
2553 "かありますので、完全な一覧については <ulink url=\"http://&ftp-master-host;/"
2554 "removals.html\"></ulink> を参照してください。このページでは、まだ作業されてい"
2555 "ない削除依頼の便利な一覧も見ることができます。"
2557 # FIXME-TRANS: experimental は試験版?実験版
2558 #. type: Content of: <chapter><section><section><para>
2561 "Note that removals can only be done for the <literal>unstable</literal>, "
2562 "<literal>experimental</literal> and <literal>stable</literal> distribution. "
2563 "Packages are not removed from <literal>testing</literal> directly. Rather, "
2564 "they will be removed automatically after the package has been removed from "
2565 "<literal>unstable</literal> and no package in <literal>testing</literal> "
2568 "削除は<literal>不安定版 (unstable)</literal>、<literal>実験版 (experimental)"
2569 "</literal>、<literal>安定版 (stable)</literal> ディストリビューションに対して"
2570 "のみ実施が可能であることに注意してください。パッケージは <literal>テスト版 "
2571 "(testing)</literal> から直接は削除されません。代わりに<literal>不安定版 "
2572 "(unstable)</literal> から削除された後で自動的に削除され、<literal>テスト版 "
2573 "(testing)</literal> にあるパッケージは削除されたパッケージに依存しなくなりま"
2576 # type: Content of: <chapter><section><section><para>
2577 #. type: Content of: <chapter><section><section><para>
2580 "There is one exception when an explicit removal request is not necessary: If "
2581 "a (source or binary) package is an orphan, it will be removed semi-"
2582 "automatically. For a binary-package, this means if there is no longer any "
2583 "source package producing this binary package; if the binary package is just "
2584 "no longer produced on some architectures, a removal request is still "
2585 "necessary. For a source-package, this means that all binary packages it "
2586 "refers to have been taken over by another source package."
2588 "例外として、明示的な削除依頼が必要ない場合が一つあります: (ソース、あるいはバ"
2589 "イナリ) パッケージがみなしご化された場合、半自動的に削除されます。バイナリ"
2590 "パッケージの場合、これはこのバイナリパッケージを生成するソースパッケージがも"
2591 "はや存在しないということを意味します。バイナリパッケージがいくつかのアーキテ"
2592 "クチャで生成されなくなったという場合には、削除依頼は必要です。ソースパッケー"
2593 "ジの場合は、関連の全バイナリパッケージが別のソースパッケージによって上書きさ"
2596 # type: Content of: <chapter><section><section><para>
2597 #. type: Content of: <chapter><section><section><para>
2600 "In your removal request, you have to detail the reasons justifying the "
2601 "request. This is to avoid unwanted removals and to keep a trace of why a "
2602 "package has been removed. For example, you can provide the name of the "
2603 "package that supersedes the one to be removed."
2605 "削除依頼では、依頼を判断する理由を詳細に書く必要があります。これは不必要な削"
2606 "除を避け、何故パッケージが削除されたのかを追跡できるようにするためです。例え"
2607 "ば、削除されるパッケージにとって代わるパッケージの名前を記述します。"
2609 # type: Content of: <chapter><section><section><para>
2610 #. type: Content of: <chapter><section><section><para>
2613 "Usually you only ask for the removal of a package maintained by yourself. "
2614 "If you want to remove another package, you have to get the approval of its "
2615 "maintainer. Should the package be orphaned and thus have no maintainer, you "
2616 "should first discuss the removal request on &email-debian-qa;. If there is a "
2617 "consensus that the package should be removed, you should reassign and "
2618 "retitle the <literal>O:</literal> bug filed against the <literal>wnpp</"
2619 "literal> package instead of filing a new bug as removal request."
2621 "通常は自分がメンテナンスしているパッケージの削除のみを依頼します。その他の"
2622 "パッケージを削除したい場合は、メンテナの許可を取る必要があります。パッケージ"
2623 "がみなしご化されたのでメンテナがいない場合は、まず &email-debian-qa; で削除依"
2624 "頼について議論をしてください。パッケージの削除についての合意ができたら、削除"
2625 "依頼の新規バグを登録するのではなく、<literal>wnpp</literal> パッケージに対し"
2626 "て登録されているバグを reassign して <literal>O:</literal> に題名を変更するべ"
2629 # type: Content of: <chapter><section><section><para>
2630 #. type: Content of: <chapter><section><section><para>
2633 "Further information relating to these and other package removal related "
2634 "topics may be found at <ulink url=\"http://wiki.debian.org/ftpmaster_Removals"
2635 "\"></ulink> and <ulink url=\"&url-debian-qa;howto-remove.html\"></ulink>."
2637 "この件、あるいはパッケージ削除に関するその他のトピックについて、さらなる情報"
2638 "を <ulink url=\"http://wiki.debian.org/ftpmaster_Removals\"></ulink> や "
2639 "<ulink url=\"&url-debian-qa;howto-remove.html\"></ulink> で参照できます。"
2641 #. type: Content of: <chapter><section><section><para>
2644 "If in doubt concerning whether a package is disposable, email &email-debian-"
2645 "devel; asking for opinions. Also of interest is the <command>apt-cache</"
2646 "command> program from the <systemitem role=\"package\">apt</systemitem> "
2647 "package. When invoked as <literal>apt-cache showpkg <replaceable>package</"
2648 "replaceable></literal>, the program will show details for "
2649 "<replaceable>package</replaceable>, including reverse depends. Other useful "
2650 "programs include <command>apt-cache rdepends</command>, <command>apt-"
2651 "rdepends</command>, <command>build-rdeps</command> (in the <systemitem role="
2652 "\"package\">devscripts</systemitem> package) and <command>grep-dctrl</"
2653 "command>. Removal of orphaned packages is discussed on &email-debian-qa;."
2655 "パッケージを破棄しても構わないか迷う場合には、意見を聞きに &email-debian-"
2656 "devel; へメールしてください。<systemitem role=\"package\">apt</systemitem> "
2657 "の <command>apt-cache</command> プログラムも重要です。<literal>apt-cache "
2658 "showpkg <replaceable>パッケージ名</replaceable></literal> として起動した際、"
2659 "プログラムは<replaceable>パッケージ名</replaceable>の非依存関係を含む詳細を表"
2660 "示します。他にも <command>apt-cache rdepends</command>、<command>apt-"
2661 "rdepends</command>、<command>build-rdeps</command> (<systemitem role="
2662 "\"package\">devscripts</systemitem> パッケージに含まれる)、<command>grep-"
2663 "dctrl</command> などの有用なプログラムが非依存関係を含む情報を表示します。み"
2664 "なしご化されたパッケージの削除は、&email-debian-qa; で話し合われます。"
2666 #. type: Content of: <chapter><section><section><para>
2669 "Once the package has been removed, the package's bugs should be handled. "
2670 "They should either be reassigned to another package in the case where the "
2671 "actual code has evolved into another package (e.g. <literal>libfoo12</"
2672 "literal> was removed because <literal>libfoo13</literal> supersedes it) or "
2673 "closed if the software is simply no longer part of Debian. When closing the "
2674 "bugs, to avoid marking the bugs as fixed in versions of the packages in "
2675 "previous Debian releases, they should be marked as fixed in the version "
2676 "<literal><most-recent-version-ever-in-Debian>+rm</literal>."
2678 "一旦パッケージが削除されたら、パッケージのバグを処理する必要があります。実際"
2679 "のコードが別のパッケージに含まれるようになったので、別のパッケージへバグを付"
2680 "け替える (例えば、<literal>libfoo13</literal> が上書きするので、"
2681 "<literal>libfoo12</literal> が削除される) か、あるいはソフトウェアがもう "
2682 "Debian の一部では無くなった場合にはバグを閉じるかする必要があります。バグを閉"
2683 "じる場合、過去の Debian のリリースにあるパッケージバージョンで修正されたと"
2684 "マークするのを避けてください。バージョン <literal><most-recent-version-"
2685 "ever-in-Debian>+rm</literal> で修正されたとマークしなければなりません。"
2687 # type: Content of: <chapter><section><section><section><title>
2688 #. type: Content of: <chapter><section><section><section><title>
2690 msgid "Removing packages from <filename>Incoming</filename>"
2691 msgstr "<filename>Incoming</filename> からパッケージを削除する"
2693 # type: Content of: <chapter><section><section><section><para>
2694 #. type: Content of: <chapter><section><section><section><para>
2697 "In the past, it was possible to remove packages from <filename>incoming</"
2698 "filename>. However, with the introduction of the new incoming system, this "
2699 "is no longer possible. Instead, you have to upload a new revision of your "
2700 "package with a higher version than the package you want to replace. Both "
2701 "versions will be installed in the archive but only the higher version will "
2702 "actually be available in <literal>unstable</literal> since the previous "
2703 "version will immediately be replaced by the higher. However, if you do "
2704 "proper testing of your packages, the need to replace a package should not "
2705 "occur too often anyway."
2707 "以前は、<filename>incoming</filename> からパッケージを削除することが可能でし"
2708 "た。しかし、新しい incoming システムが導入されたことにより、これはもはや不可"
2709 "能となっています。その代わりに、置き換えたいパッケージよりも高いバージョンの"
2710 "リビジョンの新しいパッケージをアップロードする必要があります。両方のバージョ"
2711 "ンのパッケージがアーカイブにインストールされますが、一つ前のバージョンはすぐ"
2712 "に高いバージョンで置き換えられるため、実際にはバージョンが高い方だけが "
2713 "<literal>不安定版 (unstable)</literal> で利用可能になります。しかし、もしあな"
2714 "たがパッケージをきちんとテストしていれば、パッケージを置き換える必要はそんな"
2717 # type: Content of: <chapter><section><section><title>
2718 #. type: Content of: <chapter><section><section><title>
2720 msgid "Replacing or renaming packages"
2721 msgstr "パッケージをリプレースあるいはリネームする"
2723 #. type: Content of: <chapter><section><section><para>
2726 "When the upstream maintainers for one of your packages chose to rename their "
2727 "software (or you made a mistake naming your package), you should follow a "
2728 "two-step process to rename it. In the first step, change the "
2729 "<filename>debian/control</filename> file to reflect the new name and to "
2730 "replace, provide and conflict with the obsolete package name (see the <ulink "
2731 "url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for details). "
2732 "Please note that you should only add a <literal>Provides</literal> relation "
2733 "if all packages depending on the obsolete package name continue to work "
2734 "after the renaming. Once you've uploaded the package and the package has "
2735 "moved into the archive, file a bug against <literal>ftp.debian.org</literal> "
2736 "asking to remove the package with the obsolete name (see <xref linkend="
2737 "\"removing-pkgs\"/>). Do not forget to properly reassign the package's bugs "
2740 "あなたのパッケージのどれかの開発元のメンテナらが、ソフトウェアをリネームする"
2741 "のを決めた時 (あるいはパッケージを間違えて名前を付けた時)、以下の二段階のリ"
2742 "ネーム手続きに従う必要があります。最初の段階では、<filename>debian/control</"
2743 "filename> ファイルに新しい名前を反映し、利用しなくなるパッケージ名に対して "
2744 "Replace、Provides、Conflicts を設定する変更をします (詳細に関しては <ulink "
2745 "url=\"&url-debian-policy;\">Debian ポリシーマニュアルl</ulink> を参照)。注意"
2746 "してほしいのは、利用しなくなるパッケージ名がリネーム後も動作する場合のみ、"
2747 "<literal>Provides</literal> を付け加えるべきだということです。一旦パッケージ"
2748 "をアップロードがアップロードされてアーカイブに移動したら、<literal>ftp."
2749 "debian.org</literal> に対してバグを報告してください (<xref linkend="
2750 "\"removing-pkgs\"/> 参照)。同時にパッケージのバグを正しく付け替えするのを忘れ"
2753 #. type: Content of: <chapter><section><section><para>
2756 "At other times, you may make a mistake in constructing your package and wish "
2757 "to replace it. The only way to do this is to increase the version number "
2758 "and upload a new version. The old version will be expired in the usual "
2759 "manner. Note that this applies to each part of your package, including the "
2760 "sources: if you wish to replace the upstream source tarball of your package, "
2761 "you will need to upload it with a different version. An easy possibility is "
2762 "to replace <filename>foo_1.00.orig.tar.gz</filename> with "
2763 "<filename>foo_1.00+0.orig.tar.gz</filename> or <filename>foo_1.00.orig.tar."
2764 "bz2</filename>. This restriction gives each file on the ftp site a unique "
2765 "name, which helps to ensure consistency across the mirror network."
2767 "他に、パッケージの作成でミスを犯したので置き換えたいという場合があるかもしれ"
2768 "ません。これを行う方法は唯一つ、バージョン番号を上げて新しいバージョンをアッ"
2769 "プロードすることです。通常、古いバージョンは無効になります。これはソースを含"
2770 "めた各パッケージ部分に適用されることに注意してください: パッケージの開発元の"
2771 "ソース tarball を入れ替えたい場合には、別のバージョンをつけてアップロードする"
2772 "必要があります。よくある例は <filename>foo_1.00.orig.tar.gz</filename> を "
2773 "<filename>foo_1.00+0.orig.tar.gz</filename>、あるいは <filename>foo_1.00."
2774 "orig.tar.bz2</filename> で置き換えるというものです。この制約によって、ftp サ"
2775 "イト上で各ファイルが一意の名前を持つことになり、ミラーネットワークをまたがっ"
2778 # type: Content of: <chapter><section><section><title>
2779 #. type: Content of: <chapter><section><section><title>
2781 msgid "Orphaning a package"
2782 msgstr "パッケージをみなしご化する"
2784 # type: Content of: <chapter><section><section><para>
2785 #. type: Content of: <chapter><section><section><para>
2788 "If you can no longer maintain a package, you need to inform others, and see "
2789 "that the package is marked as orphaned. You should set the package "
2790 "maintainer to <literal>Debian QA Group &orphan-address;</literal> and submit "
2791 "a bug report against the pseudo package <systemitem role=\"package\">wnpp</"
2792 "systemitem>. The bug report should be titled <literal>O: "
2793 "<replaceable>package</replaceable> -- <replaceable>short description</"
2794 "replaceable></literal> indicating that the package is now orphaned. The "
2795 "severity of the bug should be set to <literal>normal</literal>; if the "
2796 "package has a priority of standard or higher, it should be set to "
2797 "important. If you feel it's necessary, send a copy to &email-debian-devel; "
2798 "by putting the address in the X-Debbugs-CC: header of the message (no, don't "
2799 "use CC:, because that way the message's subject won't indicate the bug "
2802 "パッケージをもうメンテナンスできなくなってしまった場合、ほかの人に知らせて、"
2803 "パッケージがみなしご化 (orphaned) とマークされたのが分かるようにする必要があ"
2804 "ります。パッケージメンテナを <literal>Debian QA Group &orphan-address;</"
2805 "literal> に設定し、疑似パッケージ<systemitem role=\"package\">wnpp</"
2806 "systemitem> に対してバグ報告を送信しなければなりません。バグ報告は、パッケー"
2807 "ジが今みなしご化されていることを示すように <literal>O: <replaceable>パッケー"
2808 "ジ名</replaceable> -- <replaceable>短い要約</replaceable></literal> というタ"
2809 "イトルにする必要があります。バグの重要度は <literal>通常 (normal)</literal> "
2810 "に設定しなければなりません; パッケージの重要 (priority) が standard より高い"
2811 "場合には重要 (important) に設定する必要があります。必要だと思うのならば、メッ"
2812 "セージの X-Debbugs-CC: ヘッダのアドレスに &email-debian-devel; を入れてコピー"
2813 "を送ってください (そう、CC: を使わないでください。その理由は、CC: を使うと、"
2814 "メッセージの題名がバグ番号を含まないからです)。"
2816 # type: Content of: <chapter><section><section><para>
2817 #. type: Content of: <chapter><section><section><para>
2820 "If you just intend to give the package away, but you can keep maintainership "
2821 "for the moment, then you should instead submit a bug against <systemitem "
2822 "role=\"package\">wnpp</systemitem> and title it <literal>RFA: "
2823 "<replaceable>package</replaceable> -- <replaceable>short description</"
2824 "replaceable></literal>. <literal>RFA</literal> stands for <literal>Request "
2825 "For Adoption</literal>."
2827 "パッケージを手放したいが、しばらくの間はメンテナンスを継続できる場合には、代"
2828 "わりに <systemitem role=\"package\">wnpp</systemitem> へ <literal>RFA: "
2829 "<replaceable>パッケージ名</replaceable> -- <replaceable>短い要約</"
2830 "replaceable></literal> という題名でバグ報告を送信する必要があります。"
2831 "<literal>RFA</literal> は <literal>Request For Adoption (引き取り依頼)</"
2832 "literal> を意味しています。"
2834 # type: Content of: <chapter><section><section><para>
2835 #. type: Content of: <chapter><section><section><para>
2838 "More information is on the <ulink url=\"&url-wnpp;\">WNPP web pages</ulink>."
2840 "より詳細な情報は <ulink url=\"&url-wnpp;\">WNPP ウェブページ</ulink>にありま"
2843 # type: Content of: <chapter><section><section><title>
2844 #. type: Content of: <chapter><section><section><title>
2846 msgid "Adopting a package"
2847 msgstr "パッケージに変更を加える"
2849 # type: Content of: <chapter><section><section><para>
2850 #. type: Content of: <chapter><section><section><para>
2853 "A list of packages in need of a new maintainer is available in the <ulink "
2854 "url=\"&url-wnpp;\">Work-Needing and Prospective Packages list (WNPP)</"
2855 "ulink>. If you wish to take over maintenance of any of the packages listed "
2856 "in the WNPP, please take a look at the aforementioned page for information "
2859 "新たなメンテナが必要なパッケージの一覧は <ulink url=\"&url-wnpp;\">作業が望ま"
2860 "れるパッケージ (WNPP、Work-Needing and Prospective Packages list)</ulink> で"
2861 "入手できます。WNPP でリストに挙がっているパッケージのどれかに対するメンテナン"
2862 "スを引き継ぎたい場合には、情報と手続きについては前述のページを確認してくださ"
2865 #. type: Content of: <chapter><section><section><para>
2868 "It is not OK to simply take over a package that you feel is neglected — that "
2869 "would be package hijacking. You can, of course, contact the current "
2870 "maintainer and ask them if you may take over the package. If you have "
2871 "reason to believe a maintainer has gone AWOL (absent without leave), see "
2872 "<xref linkend=\"mia-qa\"/>."
2874 "メンテナンスされていないと思うパッケージを単純に持っていっても構いませんか? —"
2875 "それはパッケージの乗っ取り (hijacking) です。できますが、もちろんのこと、現在"
2876 "のメンテナに確認をとってパッケージを持って行って良いか尋ねましょう。メンテナ"
2877 "が AWOL (absent without leave、無届け欠席状態) であると信ずる理由があれば、"
2878 "<xref linkend=\"mia-qa\"/> を参照してください。"
2880 # type: Content of: <chapter><section><section><para>
2881 #. type: Content of: <chapter><section><section><para>
2884 "Generally, you may not take over the package without the assent of the "
2885 "current maintainer. Even if they ignore you, that is still not grounds to "
2886 "take over a package. Complaints about maintainers should be brought up on "
2887 "the developers' mailing list. If the discussion doesn't end with a positive "
2888 "conclusion, and the issue is of a technical nature, consider bringing it to "
2889 "the attention of the technical committee (see the <ulink url=\"&url-tech-"
2890 "ctte;\">technical committee web page</ulink> for more information)."
2892 "一般的に、現在のメンテナの同意なしでパッケージを引き取るべきではありません。"
2893 "彼らがあなたのことを無視したのだとしても、それはパッケージを引き取る理由とは"
2894 "なりません。メンテナへの不満は開発者のメーリングリストへ送られるべきです。議"
2895 "論が良い結論に至らない、かつ問題が技術的なものなのであれば、技術委員会に相談"
2896 "することを検討してください (より詳細については、<ulink url=\"&url-tech-ctte;"
2897 "\">Debian 技術委員会のページ</ulink> を参照してください)。"
2899 #. type: Content of: <chapter><section><section><para>
2902 "If you take over an old package, you probably want to be listed as the "
2903 "package's official maintainer in the bug system. This will happen "
2904 "automatically once you upload a new version with an updated "
2905 "<literal>Maintainer</literal> field, although it can take a few hours after "
2906 "the upload is done. If you do not expect to upload a new version for a "
2907 "while, you can use <xref linkend=\"pkg-tracking-system\"/> to get the bug "
2908 "reports. However, make sure that the old maintainer has no problem with the "
2909 "fact that they will continue to receive the bugs during that time."
2911 "古いパッケージを引き継いだ場合は、おそらくバグ追跡システムでパッケージの公式"
2912 "メンテナとして表示されるようにしたいことでしょう。これは、一旦 "
2913 "<literal>Maintainer</literal> 欄を更新した新しいバージョンをアップロードすれ"
2914 "ば自動的に行われますが、アップロードが完了してから数時間はかかります。しばら"
2915 "くは新しいバージョンをアップロードする予定が無い場合は、<xref linkend=\"pkg-"
2916 "tracking-system\"/> を使ってバグ報告を受け取ることができます。しかし、以前の"
2917 "メンテナにしばらくの間はバグ報告が届き続けても問題無いことを確認してくださ"
2920 # type: Content of: <chapter><section><title>
2921 #. type: Content of: <chapter><section><title>
2923 msgid "Porting and being ported"
2924 msgstr "移植作業、そして移植できるようにすること"
2926 # type: Content of: <chapter><section><para>
2927 #. type: Content of: <chapter><section><para>
2930 "Debian supports an ever-increasing number of architectures. Even if you are "
2931 "not a porter, and you don't use any architecture but one, it is part of your "
2932 "duty as a maintainer to be aware of issues of portability. Therefore, even "
2933 "if you are not a porter, you should read most of this chapter."
2935 "Debian がサポートするアーキテクチャの数は増え続けています。あなたが移植作業者"
2936 "ではない、あるいは別のアーキテクチャを使うことが無いという場合であっても、移"
2937 "植性の問題に注意を払うことはメンテナとしてのあなたの義務です。従って、あなた"
2938 "が移植作業者でなくても、この章の大半を読む必要があります。"
2940 #. type: Content of: <chapter><section><para>
2943 "Porting is the act of building Debian packages for architectures that are "
2944 "different from the original architecture of the package maintainer's binary "
2945 "package. It is a unique and essential activity. In fact, porters do most "
2946 "of the actual compiling of Debian packages. For instance, when a maintainer "
2947 "uploads a (portable) source packages with binaries for the <literal>i386</"
2948 "literal> architecture, it will be built for each of the other architectures, "
2949 "amounting to &number-of-arches; more builds."
2951 "移植作業 (Porting) とは、パッケージメンテナが生成したバイナリパッケージの元々"
2952 "のアーキテクチャとは違うアーキテクチャの Debian パッケージをビルドする作業で"
2953 "す。これは非常にユニークかつ極めて重要な活動です。事実、移植作業者は実際の "
2954 "Debian パッケージのコンパイルの大半を行っています。例えば、メンテナが (移植可"
2955 "能な) ソースパッケージと <literal>i386</literal> のバイナリをアップロードする"
2956 "と、他の各アーキテクチャ、&number-of-arches; 以上の数のビルドが生成されます。"
2958 # type: Content of: <chapter><section><section><title>
2959 #. type: Content of: <chapter><section><section><title>
2961 msgid "Being kind to porters"
2962 msgstr "移植作業者に対して協力的になる"
2964 # type: Content of: <chapter><section><section><para>
2965 #. type: Content of: <chapter><section><section><para>
2968 "Porters have a difficult and unique task, since they are required to deal "
2969 "with a large volume of packages. Ideally, every source package should build "
2970 "right out of the box. Unfortunately, this is often not the case. This "
2971 "section contains a checklist of ``gotchas'' often committed by Debian "
2972 "maintainers — common problems which often stymie porters, and make their "
2973 "jobs unnecessarily difficult."
2975 "移植作業者は、難解かつ他には無いタスクを抱えています。それは、彼らは膨大な量"
2976 "のパッケージに対処する必要があるからです。理想を言えば、すべてのソースパッ"
2977 "ケージは変更を加えないできちんとビルドできるべきです。残念なことに、その様な"
2978 "場合はほとんどありません。この章は Debian メンテナによってよくコミットされる"
2979 "「潜在的な問題」のチェックリストを含んでいます — よく移植作業者を困らせ、彼ら"
2980 "の作業を不必要に難解にする共通の問題です。"
2982 # type: Content of: <chapter><section><section><para>
2983 #. type: Content of: <chapter><section><section><para>
2986 "The first and most important thing is to respond quickly to bug or issues "
2987 "raised by porters. Please treat porters with courtesy, as if they were in "
2988 "fact co-maintainers of your package (which, in a way, they are). Please be "
2989 "tolerant of succinct or even unclear bug reports; do your best to hunt down "
2990 "whatever the problem is."
2992 "まず初めの、そして最も重要な点はバグや移植作業者から投げかけられた問題に素早"
2993 "く回答することです。移植作業者をパッケージの副メンテナ (co-maintainer) である"
2994 "ように丁重に扱ってください (ある意味、その通りではあります)。簡潔、あるいは不"
2995 "明瞭なバグ報告に寛容になってください。問題が何であれ、原因を捕えることに最善"
2998 # type: Content of: <chapter><section><section><para>
2999 #. type: Content of: <chapter><section><section><para>
3002 "By far, most of the problems encountered by porters are caused by "
3003 "<emphasis>packaging bugs</emphasis> in the source packages. Here is a "
3004 "checklist of things you should check or be aware of."
3006 "移植作業者が遭遇する問題のほとんどは、何といっても、ソースパッケージ内での"
3007 "<emphasis>パッケージ作成のバグ</emphasis>によって引き起こされます。以下は、確"
3008 "認あるいは注意すべき項目のリストです。"
3010 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3013 "Make sure that your <literal>Build-Depends</literal> and <literal>Build-"
3014 "Depends-Indep</literal> settings in <filename>debian/control</filename> are "
3015 "set properly. The best way to validate this is to use the <systemitem role="
3016 "\"package\">debootstrap</systemitem> package to create an <literal>unstable</"
3017 "literal> chroot environment (see <xref linkend=\"debootstrap\"/>). Within "
3018 "that chrooted environment, install the <systemitem role=\"package\">build-"
3019 "essential</systemitem> package and any package dependencies mentioned in "
3020 "<literal>Build-Depends</literal> and/or <literal>Build-Depends-Indep</"
3021 "literal>. Finally, try building your package within that chrooted "
3022 "environment. These steps can be automated by the use of the "
3023 "<command>pbuilder</command> program which is provided by the package of the "
3024 "same name (see <xref linkend=\"pbuilder\"/>)."
3026 "<filename>debian/control</filename> 中の <literal>Build-Depends</literal> と "
3027 "<literal>Build-Depends-Indep</literal> の設定が正しいことを確認してください。"
3028 "これを検証するのに最も良い方法は <systemitem role=\"package\">debootstrap</"
3029 "systemitem> パッケージを使って <literal>不安定版 (unstable)</literal> の "
3030 "chroot 環境を作成することです (<xref linkend=\"debootstrap\"/> 参照)。chroot "
3031 "環境内では、<systemitem role=\"package\">build-essential</systemitem> パッ"
3032 "ケージと、<literal>Build-Depends</literal> または <literal>Build-Depends-"
3033 "Indep</literal> に記載されている依存パッケージをインストールしてください。最"
3034 "後に、chroot 環境でパッケージの生成を試してください。これらの手順は "
3035 "<command>pbuilder</command> パッケージで提供される同名のプログラムの利用に"
3036 "よって自動化することができます (<xref linkend=\"pbuilder\"/> 参照)。"
3038 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3041 "If you can't set up a proper chroot, <command>dpkg-depcheck</command> may be "
3042 "of assistance (see <xref linkend=\"dpkg-depcheck\"/>)."
3044 "chroot を正しく設定できない場合は、<command>dpkg-depcheck</command> が手助け"
3045 "になることでしょう (<xref linkend=\"dpkg-depcheck\"/> 参照)。"
3047 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
3048 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3051 "See the <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for "
3052 "instructions on setting build dependencies."
3054 "ビルドの依存情報の指定方法については、<ulink url=\"&url-debian-policy;"
3055 "\">Debian ポリシーマニュアル</ulink>を参照してください。"
3057 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
3058 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3061 "Don't set architecture to a value other than <literal>all</literal> or "
3062 "<literal>any</literal> unless you really mean it. In too many cases, "
3063 "maintainers don't follow the instructions in the <ulink url=\"&url-debian-"
3064 "policy;\">Debian Policy Manual</ulink>. Setting your architecture to only "
3065 "one architecture (such as <literal>i386</literal> or <literal>amd64</"
3066 "literal>) is usually incorrect."
3068 "意図がある場合以外は、アーキテクチャの値を <literal>all</literal> または "
3069 "<literal>any</literal> 以外に指定しないでください。非常に多くの場合、メンテナ"
3070 "が <ulink url=\"&url-debian-policy;\">Debianポリシーマニュアル</ulink>の指示"
3071 "に従っていません。アーキテクチャを単一のものに指定する (<literal>i386</"
3072 "literal> あるいは <literal>amd64</literal> など) は大抵誤りです。"
3074 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
3075 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3078 "Make sure your source package is correct. Do <literal>dpkg-source -x "
3079 "<replaceable>package</replaceable>.dsc</literal> to make sure your source "
3080 "package unpacks properly. Then, in there, try building your package from "
3081 "scratch with <command>dpkg-buildpackage</command>."
3083 "ソースパッケージが正しいことを確かめてください。ソースパッケージが正しく展開"
3084 "されたのを確認するため、<literal>dpkg-source -x <replaceable>package</"
3085 "replaceable>.dsc</literal> を実行してください。そして、ここでは、一からパッ"
3086 "ケージを <command>dpkg-buildpackage</command> でビルドするのに挑戦してみてく"
3089 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
3090 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3093 "Make sure you don't ship your source package with the <filename>debian/"
3094 "files</filename> or <filename>debian/substvars</filename> files. They "
3095 "should be removed by the <literal>clean</literal> target of <filename>debian/"
3098 "<filename>debian/files</filename> や <filename>debian/substvars</filename> を"
3099 "含んだソースパッケージを出していないかを確かめてください。これらは、"
3100 "<filename>debian/rules</filename> の <literal>clean</literal> ターゲットに"
3103 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
3104 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3107 "Make sure you don't rely on locally installed or hacked configurations or "
3108 "programs. For instance, you should never be calling programs in <filename>/"
3109 "usr/local/bin</filename> or the like. Try not to rely on programs being "
3110 "setup in a special way. Try building your package on another machine, even "
3111 "if it's the same architecture."
3113 "ローカル環境にインストールされていたり、弄くられている設定やプログラムに依存"
3114 "していないことを確かめてください。例えば、<filename>/usr/local/bin</"
3115 "filename> やその類のプログラムは決して呼び出してはいけません。特殊なやり方で"
3116 "設定されたプログラムには依存しないようにしてください。別のマシンでパッケージ"
3117 "をビルドしてください。それが同じアーキテクチャであっても、です。"
3119 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
3120 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3123 "Don't depend on the package you're building being installed already (a sub-"
3124 "case of the above issue). There are, of course, exceptions to this rule, but "
3125 "be aware that any case like this needs manual bootstrapping and cannot be "
3126 "done by automated package builders."
3128 "構築中の既にインストールしてあるパッケージに依存しないでください (上記の話の"
3129 "一例です)。もちろん、このルールには例外はありますが、そのような場合には手動で"
3130 "一から環境を構築する必要があり、パッケージ作成マシンで自動的に構築することは"
3133 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
3134 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3137 "Don't rely on the compiler being a certain version, if possible. If not, "
3138 "then make sure your build dependencies reflect the restrictions, although "
3139 "you are probably asking for trouble, since different architectures sometimes "
3140 "standardize on different compilers."
3142 "可能であれば、特定のバージョンのコンパイラに依存しないでください。もし無理で"
3143 "あれば、その制約をビルドの依存関係に反映されているのを確認してください。だと"
3144 "しても異なったアーキテクチャでは時折異なったバージョンのコンパイラで統一され"
3145 "ているので、それでも恐らく問題を引き起こすことになるでしょう。"
3147 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
3150 "Make sure your <filename>debian/rules</filename> contains separate "
3151 "<literal>binary-arch</literal> and <literal>binary-indep</literal> targets, "
3152 "as the Debian Policy Manual requires. Make sure that both targets work "
3153 "independently, that is, that you can call the target without having called "
3154 "the other before. To test this, try to run <command>dpkg-buildpackage -B</"
3157 "<filename>debian/rules</filename> で、Debian ポリシーマニュアルが定めるよう"
3158 "に、<literal>binary-arch</literal> 及び <literal>binary-indep</literal> ター"
3159 "ゲットに分かれて含まれていることを確かめてください。両方のターゲットが独立し"
3160 "て動作するのを確かめてください。つまり、他のターゲットを事前に呼び出さなくて"
3161 "も、ターゲットを呼び出せるのを確かめるということです。これをテストするには、"
3162 "<command>dpkg-buildpackage -B</command> を実行してください。"
3164 # type: Content of: <chapter><section><section><title>
3165 #. type: Content of: <chapter><section><section><title>
3167 msgid "Guidelines for porter uploads"
3168 msgstr "移植作業者のアップロード (porter upload) に関するガイドライン"
3170 # type: Content of: <chapter><section><section><para>
3171 #. type: Content of: <chapter><section><section><para>
3174 "If the package builds out of the box for the architecture to be ported to, "
3175 "you are in luck and your job is easy. This section applies to that case; it "
3176 "describes how to build and upload your binary package so that it is properly "
3177 "installed into the archive. If you do have to patch the package in order to "
3178 "get it to compile for the other architecture, you are actually doing a "
3179 "source NMU, so consult <xref linkend=\"nmu-guidelines\"/> instead."
3181 "パッケージが移植作業を行うアーキテクチャで手を入れずに構築できるのであれば、"
3182 "あなたは幸運で作業は簡単です。この章は、その様な場合に当てはめられます: きち"
3183 "んとアーカイブにインストールされるために、どうやってバイナリパッケージを構"
3184 "築・アップロードするかを記述しています。他のアーキテクチャでコンパイルできる"
3185 "ようにするため、パッケージにパッチを当てる必要がある場合は、実際のところ、"
3186 "ソース NMU を行なうので、代わりに <xref linkend=\"nmu-guidelines\"/> を参照し"
3189 # type: Content of: <chapter><section><section><para>
3190 #. type: Content of: <chapter><section><section><para>
3193 "For a porter upload, no changes are being made to the source. You do not "
3194 "need to touch any of the files in the source package. This includes "
3195 "<filename>debian/changelog</filename>."
3197 "移植作業者のアップロード (porter upload) は、ソースに何も変更を加えません。"
3198 "ソースパッケージ中のファイルには触る必要はありません。これは "
3199 "<filename>debian/changelog</filename> を含みます。"
3201 #. type: Content of: <chapter><section><section><para>
3204 "The way to invoke <command>dpkg-buildpackage</command> is as <literal>dpkg-"
3205 "buildpackage -B -m<replaceable>porter-email</replaceable></literal>. Of "
3206 "course, set <replaceable>porter-email</replaceable> to your email address. "
3207 "This will do a binary-only build of only the architecture-dependent portions "
3208 "of the package, using the <literal>binary-arch</literal> target in "
3209 "<filename>debian/rules</filename>."
3211 "<command>dpkg-buildpackage</command> を <literal>dpkg-buildpackage -B -"
3212 "m<replaceable>porter-email</replaceable></literal> として起動してください。も"
3213 "ちろん、<replaceable>porter-email</replaceable>にはあなたのメールアドレスを設"
3214 "定します。これは<filename>debian/rules</filename> の <literal>binary-arch</"
3215 "literal> を使ってパッケージのバイナリ依存部分のみのビルドを行います。"
3217 # type: Content of: <chapter><section><section><para>
3218 #. type: Content of: <chapter><section><section><para>
3221 "If you are working on a Debian machine for your porting efforts and you need "
3222 "to sign your upload locally for its acceptance in the archive, you can run "
3223 "<command>debsign</command> on your <filename>.changes</filename> file to "
3224 "have it signed conveniently, or use the remote signing mode of <command>dpkg-"
3227 "移植作業のために Debian マシン上で作業をしていて、アーカイブに入れてもらうた"
3228 "めにアップロードするパッケージにローカルでサインする必要がある場合は、"
3229 "<filename>.changes</filename> に対して <command>debsign</command> を手軽に実"
3230 "行するのもできますし、<command>dpkg-sig</command> のリモート署名モードを使う"
3233 # type: Content of: <chapter><section><section><section><title>
3234 #. type: Content of: <chapter><section><section><section><title>
3236 msgid "Recompilation or binary-only NMU"
3237 msgstr "再コンパイル、あるいは binary-only NMU"
3239 #. type: Content of: <chapter><section><section><section><para>
3242 "Sometimes the initial porter upload is problematic because the environment "
3243 "in which the package was built was not good enough (outdated or obsolete "
3244 "library, bad compiler, etc.). Then you may just need to recompile it in an "
3245 "updated environment. However, you have to bump the version number in this "
3246 "case, so that the old bad package can be replaced in the Debian archive "
3247 "(<command>dak</command> refuses to install new packages if they don't have a "
3248 "version number greater than the currently available one)."
3250 "時折、最初の移植作業者のアップロード作業は困難なものになります。パッケージが"
3251 "構築された環境があまり良くないからです (古すぎる、使われていないライブラリが"
3252 "ある、コンパイラの問題、などなど…)。その場合には、更新した環境で再コンパイル"
3253 "する必要があるでしょう。しかし、この場合にはバージョンを上げる必要があり、古"
3254 "いおかしなパッケージは Debian アーカイブ中で入れ替えられることになります (現"
3255 "在利用可能なものよりバージョン番号が大きくない場合、<command>dak</command> は"
3256 "新しいパッケージのインストールを拒否します)。"
3258 #. type: Content of: <chapter><section><section><section><para>
3261 "You have to make sure that your binary-only NMU doesn't render the package "
3262 "uninstallable. This could happen when a source package generates arch-"
3263 "dependent and arch-independent packages that have inter-dependencies "
3264 "generated using dpkg's substitution variable <literal>$(Source-Version)</"
3267 "binary-only NMU がパッケージをインストール不可能にしてしまっていないことを確"
3268 "認する必要があります。ソースパッケージが、dpkg の substitution 変数 <literal>"
3269 "$(Source-Version)</literal> を使って内部依存関係を生成しているアーキテクチャ"
3270 "依存パッケージとアーキテクチャ非依存パッケージを生成した場合に起こる可能性が"
3273 # type: Content of: <chapter><section><section><section><para>
3274 #. type: Content of: <chapter><section><section><section><para>
3277 "Despite the required modification of the changelog, these are called binary-"
3278 "only NMUs — there is no need in this case to trigger all other architectures "
3279 "to consider themselves out of date or requiring recompilation."
3281 "changelog の変更が必要かどうかに関わらず、これらは binary-only NMU と呼ばれま"
3282 "す — この場合には、他の全アーキテクチャで古すぎるかどうかや再コンパイルが必要"
3285 # type: Content of: <chapter><section><section><section><para>
3286 #. type: Content of: <chapter><section><section><section><para>
3289 "Such recompilations require special ``magic'' version numbering, so that the "
3290 "archive maintenance tools recognize that, even though there is a new Debian "
3291 "version, there is no corresponding source update. If you get this wrong, "
3292 "the archive maintainers will reject your upload (due to lack of "
3293 "corresponding source code)."
3295 "このような再コンパイルは、特別な「magic」バージョン番号を付けるのを必要とする"
3296 "ので、アーカイブのメンテナンスツールは、これを理解してくれます。新しい "
3297 "Debian バージョンで、対応するソースアップデートが無くても、です。これを間違え"
3298 "た場合、アーカイブメンテナは (対応するソースコードが欠落しているので) アップ"
3301 # type: Content of: <chapter><section><section><section><para><footnote><para>
3302 #. type: Content of: <chapter><section><section><section><para><footnote><para>
3305 "In the past, such NMUs used the third-level number on the Debian part of the "
3306 "revision to denote their recompilation-only status; however, this syntax was "
3307 "ambiguous with native packages and did not allow proper ordering of "
3308 "recompile-only NMUs, source NMUs, and security NMUs on the same package, and "
3309 "has therefore been abandoned in favor of this new syntax."
3311 "過去においては、再コンパイルのみの状態を意味するために、このような NMU はリビ"
3312 "ジョンの Debian 部分の三つ目の番号を使っていました。しかし、この記法はネイ"
3313 "ティブパッケージの場合に曖昧で、同一パッケージでの再コンパイルのみの NMU と、"
3314 "ソース NMU と、セキュリティ NMU の正しい順序が付けられなかったため、この新し"
3317 #. type: Content of: <chapter><section><section><section><para>
3320 "The ``magic'' for a recompilation-only NMU is triggered by using a suffix "
3321 "appended to the package version number, following the form "
3322 "<literal>b<replaceable>number</replaceable></literal>. For instance, if the "
3323 "latest version you are recompiling against was version <literal>2.9-3</"
3324 "literal>, your binary-only NMU should carry a version of <literal>2.9-3+b1</"
3325 "literal>. If the latest version was <literal>3.4+b1</literal> (i.e, a "
3326 "native package with a previous recompilation NMU), your binary-only NMU "
3327 "should have a version number of <literal>3.4+b2</literal>.<placeholder type="
3328 "\"footnote\" id=\"0\"/>"
3330 "再コンパイルのみの NMU への「magic」は、<literal>b<replaceable>番号</"
3331 "replaceable></literal> という形式に従った、パッケージのバージョン番号に対する"
3332 "サフィックスを追加することで引き起こされます。例えば、再コンパイル対象の最新"
3333 "バージョンが <literal>2.9-3</literal> の場合、バイナリのみの NMU は "
3334 "<literal>2.9-3+b1</literal> というバージョンになる必要があります。最新のバー"
3335 "ジョンが <literal>3.4+b1</literal> (つまり、ネイティブパッケージで、前回が再"
3336 "コンパイルの NMU) の場合、バイナリのみの NMU は <literal>3.4+b2</literal> と"
3337 "いうバージョン番号にならねばいけません。<placeholder type=\"footnote\" id="
3340 # type: Content of: <chapter><section><section><section><para>
3341 #. type: Content of: <chapter><section><section><section><para>
3344 "Similar to initial porter uploads, the correct way of invoking <command>dpkg-"
3345 "buildpackage</command> is <literal>dpkg-buildpackage -B</literal> to only "
3346 "build the architecture-dependent parts of the package."
3348 "最初の移植作業者のアップロード (porter upload) と同様に、パッケージのアーキテ"
3349 "クチャ依存部分をビルドするための <command>dpkg-buildpackage</command> の正し"
3350 "い実行の仕方は <literal>dpkg-buildpackage -B</literal> です。"
3352 # type: Content of: <chapter><section><section><section><title>
3353 #. type: Content of: <chapter><section><section><section><title>
3355 msgid "When to do a source NMU if you are a porter"
3356 msgstr "あなたが移植作業者の場合、source NMU を行う時は何時か"
3358 #. type: Content of: <chapter><section><section><section><para>
3361 "Porters doing a source NMU generally follow the guidelines found in <xref "
3362 "linkend=\"nmu\"/>, just like non-porters. However, it is expected that the "
3363 "wait cycle for a porter's source NMU is smaller than for a non-porter, since "
3364 "porters have to cope with a large quantity of packages. Again, the "
3365 "situation varies depending on the distribution they are uploading to. It "
3366 "also varies whether the architecture is a candidate for inclusion into the "
3367 "next stable release; the release managers decide and announce which "
3368 "architectures are candidates."
3371 #. type: Content of: <chapter><section><section><section><para>
3374 "If you are a porter doing an NMU for <literal>unstable</literal>, the above "
3375 "guidelines for porting should be followed, with two variations. Firstly, "
3376 "the acceptable waiting period — the time between when the bug is submitted "
3377 "to the BTS and when it is OK to do an NMU — is seven days for porters "
3378 "working on the <literal>unstable</literal> distribution. This period can be "
3379 "shortened if the problem is critical and imposes hardship on the porting "
3380 "effort, at the discretion of the porter group. (Remember, none of this is "
3381 "Policy, just mutually agreed upon guidelines.) For uploads to "
3382 "<literal>stable</literal> or <literal>testing</literal>, please coordinate "
3383 "with the appropriate release team first."
3386 # type: Content of: <chapter><section><section><section><para>
3387 #. type: Content of: <chapter><section><section><section><para>
3390 "Secondly, porters doing source NMUs should make sure that the bug they "
3391 "submit to the BTS should be of severity <literal>serious</literal> or "
3392 "greater. This ensures that a single source package can be used to compile "
3393 "every supported Debian architecture by release time. It is very important "
3394 "that we have one version of the binary and source package for all "
3395 "architectures in order to comply with many licenses."
3398 # type: Content of: <chapter><section><section><section><para>
3399 #. type: Content of: <chapter><section><section><section><para>
3402 "Porters should try to avoid patches which simply kludge around bugs in the "
3403 "current version of the compile environment, kernel, or libc. Sometimes such "
3404 "kludges can't be helped. If you have to kludge around compiler bugs and the "
3405 "like, make sure you <literal>#ifdef</literal> your work properly; also, "
3406 "document your kludge so that people know to remove it once the external "
3407 "problems have been fixed."
3410 # type: Content of: <chapter><section><section><section><para>
3411 #. type: Content of: <chapter><section><section><section><para>
3414 "Porters may also have an unofficial location where they can put the results "
3415 "of their work during the waiting period. This helps others running the port "
3416 "have the benefit of the porter's work, even during the waiting period. Of "
3417 "course, such locations have no official blessing or status, so buyer beware."
3420 # type: Content of: <chapter><section><section><title>
3421 #. type: Content of: <chapter><section><section><title>
3423 msgid "Porting infrastructure and automation"
3424 msgstr "移植用のインフラと自動化"
3426 # type: Content of: <chapter><section><section><para>
3427 #. type: Content of: <chapter><section><section><para>
3430 "There is infrastructure and several tools to help automate package porting. "
3431 "This section contains a brief overview of this automation and porting to "
3432 "these tools; see the package documentation or references for full "
3435 "パッケージの自動移植に役立つインフラストラクチャと複数のツールがあります。こ"
3436 "の章には、この自動化とこれらのツールへの移植の概要が含まれています。全体の情"
3437 "報に付いてはパッケージのドキュメントかリファレンスを参照してください。"
3439 # type: Content of: <chapter><section><section><section><title>
3440 #. type: Content of: <chapter><section><section><section><title>
3442 msgid "Mailing lists and web pages"
3443 msgstr "メーリングリストとウェブページ"
3445 # type: Content of: <chapter><section><section><section><para>
3446 #. type: Content of: <chapter><section><section><section><para>
3449 "Web pages containing the status of each port can be found at <ulink url="
3450 "\"&url-debian-ports;\"></ulink>."
3452 "各移植版についての状況を含んだウェブページは <ulink url=\"&url-debian-ports;"
3453 "\"></ulink> から参照できます。"
3455 # type: Content of: <chapter><section><section><section><para>
3456 #. type: Content of: <chapter><section><section><section><para>
3459 "Each port of Debian has a mailing list. The list of porting mailing lists "
3460 "can be found at <ulink url=\"&url-debian-port-lists;\"></ulink>. These "
3461 "lists are used to coordinate porters, and to connect the users of a given "
3462 "port with the porters."
3464 "Debian の各移植版はメーリングリストを持っています。移植作業のメーリングリスト"
3465 "は <ulink url=\"&url-debian-port-lists;\"></ulink> で見ることができます。これ"
3466 "らのリストは移植作業者の作業の調整や移植版のユーザと移植作業者をつなぐために"
3469 # type: Content of: <chapter><section><section><section><title>
3470 #. type: Content of: <chapter><section><section><section><title>
3472 msgid "Porter tools"
3475 #. type: Content of: <chapter><section><section><section><para>
3478 "Descriptions of several porting tools can be found in <xref linkend=\"tools-"
3481 "移植用のツールの説明をいくつか <xref linkend=\"tools-porting\"/> で見ることが"
3484 # type: Content of: <chapter><section><section><section><title>
3485 #. type: Content of: <chapter><section><section><section><title>
3487 msgid "<systemitem role=\"package\">wanna-build</systemitem>"
3488 msgstr "<systemitem role=\"package\">wanna-build</systemitem>"
3490 #. type: Content of: <chapter><section><section><section><para>
3493 "The <systemitem role=\"package\">wanna-build</systemitem> system is used as "
3494 "a distributed, client-server build distribution system. It is usually used "
3495 "in conjunction with build daemons running the <systemitem role=\"package"
3496 "\">buildd</systemitem> program. <literal>Build daemons</literal> are "
3497 "``slave'' hosts which contact the central <systemitem role=\"package\">wanna-"
3498 "build</systemitem> system to receive a list of packages that need to be "
3501 "<systemitem role=\"package\">wanna-build</systemitem> システムは、分散型の、"
3502 "クライアント・サーバでの構築配布システムとして利用されています。通常、これは "
3503 "<systemitem role=\"package\">buildd</systemitem> プログラムが動作しているビル"
3504 "ドデーモンと連携して使われます。<literal>ビルドデーモン</literal>は、ビルドが"
3505 "必要なパッケージの一覧を受け取るために中央の <systemitem role=\"package"
3506 "\">wanna-build</systemitem> システムと通信する「slave」ホストです。"
3508 #. type: Content of: <chapter><section><section><section><para>
3511 "<systemitem role=\"package\">wanna-build</systemitem> is not yet available "
3512 "as a package; however, all Debian porting efforts are using it for automated "
3513 "package building. The tool used to do the actual package builds, "
3514 "<systemitem role=\"package\">sbuild</systemitem> is available as a package, "
3515 "see its description in <xref linkend=\"sbuild\"/>. Please note that the "
3516 "packaged version is not the same as the one used on build daemons, but it is "
3517 "close enough to reproduce problems."
3519 "<systemitem role=\"package\">wanna-build</systemitem> は、まだパッケージとし"
3520 "ては入手可能になっていません。ですが、すべての Debian の移植作業ではパッケー"
3521 "ジ構築作業の自動化にこれが使われています。実際のパッケージ構築に使われるツー"
3522 "ル、<systemitem role=\"package\">sbuild</systemitem> はパッケージとして利用可"
3523 "能です。<xref linkend=\"sbuild\"/> で説明を参照してください。パッケージ化され"
3524 "たバージョンは、ビルドデーモンで使われているものとは同じではありませんが、問"
3525 "題を再現するには十分なものである点に注意ください。"
3527 #. type: Content of: <chapter><section><section><section><para>
3530 "Most of the data produced by <systemitem role=\"package\">wanna-build</"
3531 "systemitem> which is generally useful to porters is available on the web at "
3532 "<ulink url=\"&url-buildd;\"></ulink>. This data includes nightly updated "
3533 "statistics, queueing information and logs for build attempts."
3535 "<systemitem role=\"package\">wanna-build</systemitem> によって生成される移植"
3536 "作業者にとって大抵有用であるデータの多くは、ウェブ上の <ulink url=\"&url-"
3537 "buildd;\"></ulink> で入手可能です。このデータには、毎晩更新される統計情報や、"
3538 "queue 情報、ビルド失敗のログが含まれています。"
3540 # type: Content of: <chapter><section><section><section><para>
3541 #. type: Content of: <chapter><section><section><section><para>
3544 "We are quite proud of this system, since it has so many possible uses. "
3545 "Independent development groups can use the system for different sub-flavors "
3546 "of Debian, which may or may not really be of general interest (for instance, "
3547 "a flavor of Debian built with <command>gcc</command> bounds checking). It "
3548 "will also enable Debian to recompile entire distributions quickly."
3550 "我々はこのシステムを極めて誇りに思っています。何故ならば、様々な利用方法の可"
3551 "能性があるからです。独立した開発グループは、実際に一般的な用途に合うかどうか"
3552 "分からない異なった別アプローチの Debian にシステムを使うことができます (例え"
3553 "ば、<command>gcc</command> の配列境界チェック付きでビルドした Debian など)。"
3554 "そして、Debian がディストリビューション全体を素早く再コンパイルできるようにも"
3557 #. type: Content of: <chapter><section><section><section><para>
3560 "The wanna-build team, in charge of the buildds, can be reached at "
3561 "<literal>debian-wb-team@lists.debian.org</literal>. To determine who (wanna-"
3562 "build team, release team) and how (mail, BTS) to contact, refer to <ulink "
3563 "url=\"&url-wb-team;\"></ulink>."
3565 "buildd の担当である wanna-build チームには、<literal>debian-wb-team@lists."
3566 "debian.org</literal> で連絡が取れます。誰 (wanna-build チーム、リリースチー"
3567 "ム) に連絡を取るのか、どうやって (メール、BTS) 連絡するのかを決めるには、"
3568 "<ulink url=\"&url-wb-team;\"></ulink> を参照してください。"
3570 #. type: Content of: <chapter><section><section><section><para>
3573 "When requesting binNMUs or give-backs (retries after a failed build), please "
3574 "use the format described at <ulink url=\"&url-release-wb;\"/>."
3576 "binNMU や give-back (ビルド失敗後のやり直し) を依頼する時には、<ulink url="
3577 "\"&url-release-wb;\"/> で記述されている形式を使ってください。"
3579 # type: Content of: <chapter><section><section><title>
3580 #. type: Content of: <chapter><section><section><title>
3582 msgid "When your package is <emphasis>not</emphasis> portable"
3583 msgstr "あなたのパッケージが移植可能なものでは<emphasis>ない</emphasis>場合"
3585 # type: Content of: <chapter><section><section><para>
3586 #. type: Content of: <chapter><section><section><para>
3589 "Some packages still have issues with building and/or working on some of the "
3590 "architectures supported by Debian, and cannot be ported at all, or not "
3591 "within a reasonable amount of time. An example is a package that is SVGA-"
3592 "specific (only available for <literal>i386</literal> and <literal>amd64</"
3593 "literal>), or uses other hardware-specific features not supported on all "
3596 "いくつかのパッケージでは、Debian でサポートされているアーキテクチャのうちの幾"
3597 "つかで、構築や動作に問題を抱えており、全く移植できない、あるいは十分な時間内"
3598 "では移植ができないものがあります。例としては、SVGA に特化したパッケージ "
3599 "(<literal>i386</literal> と <literal>amd64</literal> のみで利用可能)や、すべ"
3600 "てのアーキテクチャではサポートされていないようなハードウェア固有の機能があり"
3603 # type: Content of: <chapter><section><section><para>
3604 #. type: Content of: <chapter><section><section><para>
3607 "In order to prevent broken packages from being uploaded to the archive, and "
3608 "wasting buildd time, you need to do a few things:"
3610 "壊れたパッケージがアーカイブにアップロードされたり buildd の時間が無駄に費や"
3611 "されたりするのを防ぐため、幾つかしなければならないことがあります:"
3613 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3614 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3617 "First, make sure your package <emphasis>does</emphasis> fail to build on "
3618 "architectures that it cannot support. There are a few ways to achieve "
3619 "this. The preferred way is to have a small testsuite during build time that "
3620 "will test the functionality, and fail if it doesn't work. This is a good "
3621 "idea anyway, as this will prevent (some) broken uploads on all "
3622 "architectures, and also will allow the package to build as soon as the "
3623 "required functionality is available."
3625 "まず、サポートできないアーキテクチャ上ではパッケージがビルドに<emphasis>失敗"
3626 "する</emphasis>のを確認しておく必要があります。これを行うには幾つかやり方があ"
3627 "ります。お勧めの方法は構築時に機能をテストする小さなテストスイートを用意し"
3628 "て、動かない場合に失敗するようにすることです。これは、全てのアーキテクチャ上"
3629 "で、壊れたものをアップロードするのを防ぎ、必要な機能が動作するようになれば"
3630 "パッケージがビルドできるようになる、良い考えです。"
3633 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3634 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3638 "Additionally, if you believe the list of supported architectures is pretty "
3639 "constant, you should change <literal>any</literal> to a list of supported "
3640 "architectures in <filename>debian/control</filename>. This way, the build "
3641 "will fail also, and indicate this to a human reader without actually trying."
3643 "さらに、サポートしているアーキテクチャの一覧が十分一定量あるのであれば、"
3644 "<filename>debian/control</filename> 内のサポートアーキテクチャの一覧を "
3645 "<literal>any</literal> に変更する必要があります。このようにして、ビルドの失敗"
3648 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3651 "In order to prevent autobuilders from needlessly trying to build your "
3652 "package, it must be included in <filename>Packages-arch-specific</filename>, "
3653 "a list used by the <command>wanna-build</command> script. The current "
3654 "version is available as <ulink url=\"&url-buildd-p-a-s;\"/>; please see the "
3655 "top of the file for whom to contact for changes."
3657 "autobuilder が必要もなくパッケージをビルドしようとしないように、"
3658 "<command>wanna-build</command> スクリプトが使うリストである "
3659 "<filename>Packages-arch-specific</filename> に追加しておく必要があります。現"
3660 "在のバージョンは <ulink url=\"&url-buildd-p-a-s;\"/> から入手できます: 変更依"
3661 "頼をする相手はファイルの一番上を参照してください。"
3663 #. type: Content of: <chapter><section><section><para>
3666 "Please note that it is insufficient to only add your package to "
3667 "<filename>Packages-arch-specific</filename> without making it fail to build "
3668 "on unsupported architectures: A porter or any other person trying to build "
3669 "your package might accidently upload it without noticing it doesn't work. "
3670 "If in the past some binary packages were uploaded on unsupported "
3671 "architectures, request their removal by filing a bug against <systemitem "
3672 "role=\"package\">ftp.debian.org</systemitem>."
3674 "サポートしていないアーキテクチャ上でビルドが失敗するようにせずに、パッケージ"
3675 "を単に <filename>Packages-arch-specific</filename> に付け加えるだけでは不十分"
3676 "であることに注意してください: 移植作業者、あるいはあなたのパッケージをビルド"
3677 "しようとしている他の人は、それが動かないのに気づかないで誤ってアップロードす"
3678 "るかもしれません。過去に、サポートされてないアーキテクチャ上にバイナリパッ"
3679 "ケージがアップロードされてしまった場合、削除依頼は <systemitem role=\"package"
3680 "\">ftp.debian.org</systemitem> に対するバグを登録することによって行われまし"
3683 # type: Content of: <chapter><section><title>
3684 #. type: Content of: <chapter><section><title>
3686 msgid "Non-Maintainer Uploads (NMUs)"
3687 msgstr "Non-Maintainer Upload (NMU)"
3689 #. type: Content of: <chapter><section><para>
3692 "Every package has one or more maintainers. Normally, these are the people "
3693 "who work on and upload new versions of the package. In some situations, it "
3694 "is useful that other developers can upload a new version as well, for "
3695 "example if they want to fix a bug in a package they don't maintain, when the "
3696 "maintainer needs help to respond to issues. Such uploads are called "
3697 "<emphasis>Non-Maintainer Uploads (NMU)</emphasis>."
3699 "すべてのパッケージには最低一人のメンテナがいます。通常、この人達がパッケージ"
3700 "に対して作業をし、新しいバージョンをアップロードします。時折、他の開発者らが"
3701 "新しいバージョンをアップロードできると便利な場合があります。例えば、彼らがメ"
3702 "ンテナンスしていないパッケージにあるバグを修正したいが、メンテナが問題に対応"
3703 "するのには助けが必要な場合です。このようなアップロードは <emphasis>Non-"
3704 "Maintainer Upload (NMU)</emphasis> と呼ばれます。"
3706 # type: Content of: <chapter><section><section><title>
3707 #. type: Content of: <chapter><section><section><title>
3709 msgid "When and how to do an NMU"
3710 msgstr "いつ、どうやって NMU を行うか"
3712 #. type: Content of: <chapter><section><section><para>
3714 msgid "Before doing an NMU, consider the following questions:"
3715 msgstr "NMU を行う前に、以下の質問について考えてください:"
3717 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3720 "Does your NMU really fix bugs? Fixing cosmetic issues or changing the "
3721 "packaging style in NMUs is discouraged."
3723 "NMU は本当にバグを修正しますか? NMU では、些細な問題の修正やパッケージ方式の"
3726 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3729 "Did you give enough time to the maintainer? When was the bug reported to the "
3730 "BTS? Being busy for a week or two isn't unusual. Is the bug so severe that "
3731 "it needs to be fixed right now, or can it wait a few more days?"
3733 "メンテナに十分な時間を与えましたか? BTS にバグが報告されたのは何時ですか? "
3734 "一、二週間忙しいことはあり得ないことでは無いです。そのバグはすぐに修正しなけ"
3735 "ればならないほど重大ですか? それとも、あと数日待てるものですか?"
3737 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3740 "How confident are you about your changes? Please remember the Hippocratic "
3741 "Oath: \"Above all, do no harm.\" It is better to leave a package with an "
3742 "open grave bug than applying a non-functional patch, or one that hides the "
3743 "bug instead of resolving it. If you are not 100% sure of what you did, it "
3744 "might be a good idea to seek advice from others. Remember that if you break "
3745 "something in your NMU, many people will be very unhappy about it."
3747 "その変更にどれくらい自信がありますか? ヒポクラテスの誓いを思い出してくださ"
3748 "い: 「何よりも、害を及ぼすことなかれ」 動かないパッチを当てるよりもパッケージ"
3749 "の重大なバグをそのままオープンな状態にしておく方が良いですし、パッチによって"
3750 "バグを解決するのではなく隠してしまうかもしれません。自分が 100% 何をしたのか"
3751 "分かっていないのであれば、他の人からアドバイスをもらうのも良い考えでしょう。"
3752 "NMU で何かを壊したのであれば、多くの人がとても不幸になるであろうことを覚えて"
3755 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3758 "Have you clearly expressed your intention to NMU, at least in the BTS? It is "
3759 "also a good idea to try to contact the maintainer by other means (private "
3762 "少なくとも BTS で、NMU するのを明確に表明しましたか? 他の手段 (プライベートな"
3763 "メール、IRC) でメンテナに連絡をとるのも良い考えです。"
3765 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3768 "If the maintainer is usually active and responsive, have you tried to "
3769 "contact him? In general it should be considered preferable that a maintainer "
3770 "takes care of an issue himself and that he is given the chance to review and "
3771 "correct your patch, because he can be expected to be more aware of potential "
3772 "issues which an NMUer might miss. It is often a better use of everyone's "
3773 "time if the maintainer is given an opportunity to upload a fix on their own."
3775 "メンテナがいつも活動的で応答してくれる場合、彼に連絡を取ろうとしましたか? 大"
3776 "概の場合、メンテナ自身が問題に対応して、あなたのパッチをレビューする機会が与"
3777 "えられる方が好ましいと思われます。これは、NMU をする人が見落としているだろう"
3778 "潜在的な問題にメンテナは気付くことができるからです。大抵、メンテナが自分で"
3779 "アップロードする機会が与えられる方が、皆の時間を使うよりも良いやり方です。"
3781 #. type: Content of: <chapter><section><section><para>
3784 "When doing an NMU, you must first make sure that your intention to NMU is "
3785 "clear. Then, you must send a patch with the differences between the current "
3786 "package and your proposed NMU to the BTS. The <command>nmudiff</command> "
3787 "script in the <systemitem role=\"package\">devscripts</systemitem> package "
3790 "NMU をする際には、まず NMU をする意図を明確にしておかねばなりません。それか"
3791 "ら、BTS へ現在のパッケージと提案する NMU との差分をパッチとして送付する必要が"
3792 "あります。<systemitem role=\"package\">devscripts</systemitem> パッケージにあ"
3793 "る <command>nmudiff</command> スクリプトが役に立つでしょう。"
3795 #. type: Content of: <chapter><section><section><para>
3798 "While preparing the patch, you should better be aware of any package-"
3799 "specific practices that the maintainer might be using. Taking them into "
3800 "account reduces the burden of getting your changes integrated back in the "
3801 "normal package workflow and thus increases the possibilities that that will "
3802 "happen. A good place where to look for for possible package-specific "
3803 "practices is <ulink url=\"&url-debian-policy;ch-source.html#s-readmesource"
3804 "\"><filename>debian/README.source</filename></ulink>."
3806 "パッチを準備している間、メンテナが利用しているであろうパッケージ固有の慣例に"
3807 "注意を向けた方がいいでしょう。これを考慮に入れることは、通常のパッケージの作"
3808 "業工程に対してあなたの変更が入る負担を減らし、それに従って変更が入る可能性を"
3809 "高めます。パッケージ固有の慣例がある可能性があるので探すと良い場所は、<ulink "
3810 "url=\"&url-debian-policy;ch-source.html#s-readmesource\"><filename>debian/"
3811 "README.source</filename></ulink> です。"
3813 #. type: Content of: <chapter><section><section><para>
3816 "Unless you have an excellent reason not to do so, you must then give some "
3817 "time to the maintainer to react (for example, by uploading to the "
3818 "<literal>DELAYED</literal> queue). Here are some recommended values to use "
3821 "そうするべき十二分な理由が無い限り、メンテナに対応する時間を与えるべきです "
3822 "(例えば <literal>DELAYED</literal> キューにアップロードすることによってこれを"
3823 "行います)。以下が delayed キューを使う際のお勧めの値です:"
3825 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3827 msgid "Upload fixing only release-critical bugs older than 7 days: 2 days"
3829 "7 日以上経っているリリースクリティカルバグのみを修正するアップロード: 2 日"
3831 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3833 msgid "Upload fixing only release-critical and important bugs: 5 days"
3834 msgstr "リリースクリティカルバグや重要なバグの修正のみのアップロード: 5 日"
3836 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3838 msgid "Other NMUs: 10 days"
3839 msgstr "他の NMU: 10 日"
3841 #. type: Content of: <chapter><section><section><para>
3844 "Those delays are only examples. In some cases, such as uploads fixing "
3845 "security issues, or fixes for trivial bugs that blocking a transition, it is "
3846 "desirable that the fixed package reaches <literal>unstable</literal> sooner."
3848 "この値は例に過ぎません。セキュリティ問題を修正するアップロードや、移行を阻む"
3849 "些細なバグを修正するなど、いくつかのケースでは修正されたパッケージが "
3850 "<literal>不安定版 (unstable)</literal> にすぐ入るようになるのは望ましいことで"
3853 #. type: Content of: <chapter><section><section><para>
3856 "Sometimes, release managers decide to allow NMUs with shorter delays for a "
3857 "subset of bugs (e.g release-critical bugs older than 7 days). Also, some "
3858 "maintainers list themselves in the <ulink url=\"&url-low-threshold-nmu;"
3859 "\">Low Threshold NMU list</ulink>, and accept that NMUs are uploaded without "
3860 "delay. But even in those cases, it's still a good idea to give the "
3861 "maintainer a few days to react before you upload, especially if the patch "
3862 "wasn't available in the BTS before, or if you know that the maintainer is "
3865 "時々、リリースマネージャが特定のバグに対して短い delay 日数の NMU を許可を認"
3866 "めることがあります (7 日より古いリリースクリティカルバグなど)。また、一部のメ"
3867 "ンテナは <ulink url=\"&url-low-threshold-nmu;\">Low Threshold NMU list</"
3868 "ulink> に自身を挙げており、遅延なしの NMU アップロードを許可しています。しか"
3869 "しどのような場合であっても、特にパッチが BTS で以前手に入らなかったり、メンテ"
3870 "ナが大抵アクティブであるのを知っている場合など、アップロードの前にメンテナに"
3873 #. type: Content of: <chapter><section><section><para>
3876 "After you upload an NMU, you are responsible for the possible problems that "
3877 "you might have introduced. You must keep an eye on the package (subscribing "
3878 "to the package on the PTS is a good way to achieve this)."
3880 "NMU アップロード後、あなたは自分が導入したであろう問題に責任を持つことになり"
3881 "ます。パッケージを見張らなければなりません (これを行うには PTS 上のパッケージ"
3884 #. type: Content of: <chapter><section><section><para>
3887 "This is not a license to perform NMUs thoughtlessly. If you NMU when it is "
3888 "clear that the maintainers are active and would have acknowledged a patch in "
3889 "a timely manner, or if you ignore the recommendations of this document, your "
3890 "upload might be a cause of conflict with the maintainer. You should always "
3891 "be prepared to defend the wisdom of any NMU you perform on its own merits."
3893 "これは、軽率な NMU を行うための許可証ではありません。明らかにメンテナがアク"
3894 "ティブで時期を逃さずパッチについて対応している場合や、このドキュメントに書か"
3895 "れている推奨を無視している場合など、あなたによるアップロードはメンテナと衝突"
3896 "を起こすでしょう。NMU のメリットについて、自分が行ったことの賢明さを常に弁護"
3897 "できるようにしておく必要があります。"
3899 #. type: Content of: <chapter><section><section><title>
3901 msgid "NMUs and <filename>debian/changelog</filename>"
3902 msgstr "NMU と <filename>debian/changelog</filename>"
3904 #. type: Content of: <chapter><section><section><para>
3907 "Just like any other (source) upload, NMUs must add an entry to "
3908 "<filename>debian/changelog</filename>, telling what has changed with this "
3909 "upload. The first line of this entry must explicitely mention that this "
3910 "upload is an NMU, e.g.:"
3912 "他の (ソース) アップロード同様、NMU は <filename>debian/changelog</filename> "
3913 "にそのアップロードで何を変更したのかを示すエントリを追加せねばなりません。エ"
3914 "ントリの最初の行は、このアップロードが NMU であることを明白に示す必要がありま"
3917 # type: Content of: <chapter><section><section><screen>
3918 #. type: Content of: <chapter><section><section><screen>
3921 msgid " * Non-maintainer upload.\n"
3922 msgstr " * Non-maintainer upload.\n"
3924 #. type: Content of: <chapter><section><section><para>
3926 msgid "The way to version NMUs differs for native and non-native packages."
3928 "NMU のバージョンのつけ方は、ネイティブなパッケージとネイティブではないパッ"
3931 #. type: Content of: <chapter><section><section><para>
3934 "If the package is a native package (without a Debian revision in the version "
3935 "number), the version must be the version of the last maintainer upload, plus "
3936 "<literal>+nmu<replaceable>X</replaceable></literal>, where <replaceable>X</"
3937 "replaceable> is a counter starting at <literal>1</literal>. If the last "
3938 "upload was also an NMU, the counter should be increased. For example, if "
3939 "the current version is <literal>1.5</literal>, then an NMU would get version "
3940 "<literal>1.5+nmu1</literal>."
3942 "パッケージがネイティブパッケージの場合 (バージョン番号に Debian リビジョンが"
3943 "付かない)、バージョンはメンテナの最後のアップロードのバージョン + <literal>"
3944 "+nmu<replaceable>X</replaceable></literal> となり、<replaceable>X</"
3945 "replaceable> は <literal>1</literal> から始まる数字になります。最後のアップ"
3946 "ロードが同様に NMU の場合は、数字を増やします。例えば、現在のバージョンが "
3947 "<literal>1.5</literal> だとすると、NMU はバージョンが <literal>1.5+nmu1</"
3950 #. type: Content of: <chapter><section><section><para>
3953 "If the package is a not a native package, you should add a minor version "
3954 "number to the Debian revision part of the version number (the portion after "
3955 "the last hyphen). This extra number must start at <literal>1</literal>. For "
3956 "example, if the current version is <literal>1.5-2</literal>, then an NMU "
3957 "would get version <literal>1.5-2.1</literal>. If a new upstream version is "
3958 "packaged in the NMU, the Debian revision is set to <literal>0</literal>, for "
3959 "example <literal>1.6-0.1</literal>."
3961 "パッケージがネイティブパッケージではない場合は、バージョン番号の Debian リビ"
3962 "ジョン部分 (最後のハイフン以下の部分) にマイナーバージョン番号を追加します。"
3963 "例えば、現在のバージョンが <literal>1.5-2</literal> であれば、NMU は "
3964 "<literal>1.5-2.1</literal> というバージョンになります。開発元のバージョンが新"
3965 "しくなったものが NMU でパッケージになった場合は、Debian リビジョンは "
3966 "<literal>0</literal> に設定されます。例えば <literal>1.6-0.1</literal> です。"
3968 #. type: Content of: <chapter><section><section><para>
3971 "In both cases, if the last upload was also an NMU, the counter should be "
3972 "increased. For example, if the current version is <literal>1.5+nmu3</"
3973 "literal> (a native package which has already been NMUed), the NMU would get "
3974 "version <literal>1.5+nmu4</literal>."
3976 "どちらの場合でも、最後のアップロードも NMU だった場合には数字が増えます。例え"
3977 "ば、現在のバージョンが <literal>1.5+nmu3</literal> (既に NMU されたネイティ"
3978 "ブパッケージ) の場合、NMU は <literal>1.5+nmu4</literal> というバージョンにな"
3981 #. type: Content of: <chapter><section><section><para>
3984 "A special versioning scheme is needed to avoid disrupting the maintainer's "
3985 "work, since using an integer for the Debian revision will potentially "
3986 "conflict with a maintainer upload already in preparation at the time of an "
3987 "NMU, or even one sitting in the ftp NEW queue. It also has the benefit of "
3988 "making it visually clear that a package in the archive was not made by the "
3989 "official maintainer."
3991 "特別なバージョン付け方法が必要とされるのは、メンテナの作業を混乱させるのを避"
3992 "けるためです。何故ならば、Debian リビジョンのために整数を使っていると、NMU の"
3993 "際に既に準備されていたメンテナによるアップロードや、さらには ftp NEW queue に"
3994 "あるパッケージともぶつかる可能性があります。これには、アーカイブのパッケージ"
3995 "が公式メンテナによるものではない、と視覚的に明らかにする利点もあります。"
3997 #. type: Content of: <chapter><section><section><para>
4000 "If you upload a package to testing or stable, you sometimes need to \"fork\" "
4001 "the version number tree. This is the case for security uploads, for "
4002 "example. For this, a version of the form <literal>+deb<replaceable>XY</"
4003 "replaceable>u<replaceable>Z</replaceable></literal> should be used, where "
4004 "<replaceable>X</replaceable> and <replaceable>Y</replaceable> are the major "
4005 "and minor release numbers, and <replaceable>Z</replaceable> is a counter "
4006 "starting at <literal>1</literal>. When the release number is not yet known "
4007 "(often the case for <literal>testing</literal>, at the beginning of release "
4008 "cycles), the lowest release number higher than the last stable release "
4009 "number must be used. For example, while Lenny (Debian 5.0) is stable, a "
4010 "security NMU to stable for a package at version <literal>1.5-3</literal> "
4011 "would have version <literal>1.5-3+deb50u1</literal>, whereas a security NMU "
4012 "to Squeeze would get version <literal>1.5-3+deb60u1</literal>. After the "
4013 "release of Squeeze, security uploads to the <literal>testing</literal> "
4014 "distribution will be versioned <literal>+deb61uZ</literal>, until it is "
4015 "known whether that release will be Debian 6.1 or Debian 7.0 (if that becomes "
4016 "the case, uploads will be versioned as <literal>+deb70uZ</literal>)."
4018 "テスト版 (testing) あるいは 不安定版 (unstable) にパッケージをアップロードし"
4019 "た場合、バージョン番号のツリーを「分岐 (fork)」させねばならない時がしばしばあ"
4020 "ります。例えばセキュリティアップロードの場合です。この場合、<literal>"
4021 "+deb<replaceable>XY</replaceable>u<replaceable>Z</replaceable></literal> とい"
4022 "うバージョン形式が使われる必要があり、<replaceable>X</replaceable> と "
4023 "<replaceable>Y</replaceable> はメジャーリリース番号とマイナーリリース番号で、"
4024 "<replaceable>Z</replaceable> は <literal>1</literal> から始まる数字です。リ"
4025 "リース番号がまだ分からない場合 (リリースサイクルの初期に <literal>テスト版 "
4026 "(testing)</literal> に良くあることです)、最後の安定版リリース番号よりは大き"
4027 "い、最も小さなリリース番号を使います。例えば、Lenny (Debian 5.0) が安定版の間"
4028 "は、バージョンが <literal>1.5-3+deb50u1</literal> であるパッケージの安定版へ"
4029 "のセキュリティ NMU はバージョン <literal>1.5-3+deb50u1</literal> になり、同様"
4030 "に Squeeze へのセキュリティ NMU はバージョン <literal>1.5-3+deb60u1</"
4031 "literal> になります。リリースのリリース後、<literal>テスト版 (testing)</"
4032 "literal> ディストリビューションへのセキュリティアップロードは、リリースが "
4033 "Debian 6.1 なのか Debian 7.0 なのかが分かるまで <literal>+deb61uZ</literal> "
4034 "とバージョンが付けられます (バージョンが Debian 7.0 になった場合は、アップ"
4035 "ロードは <literal>+deb70uZ</literal> とバージョンが付けられます)。"
4037 # type: Content of: <chapter><section><section><title>
4038 #. type: Content of: <chapter><section><section><title>
4040 msgid "Using the <literal>DELAYED/</literal> queue"
4041 msgstr "<literal>DELAYED/</literal> キューを使う"
4043 #. type: Content of: <chapter><section><section><para>
4046 "Having to wait for a response after you request permission to NMU is "
4047 "inefficient, because it costs the NMUer a context switch to come back to the "
4048 "issue. The <literal>DELAYED</literal> queue (see <xref linkend=\"delayed-"
4049 "incoming\"/>) allows the developer doing the NMU to perform all the "
4050 "necessary tasks at the same time. For instance, instead of telling the "
4051 "maintainer that you will upload the updated package in 7 days, you should "
4052 "upload the package to <literal>DELAYED/7</literal> and tell the maintainer "
4053 "that he has 7 days to react. During this time, the maintainer can ask you "
4054 "to delay the upload some more, or cancel your upload."
4056 "NMU の許可を求めた後で待っているのは効率的ではありません。NMU した人が作業に"
4057 "もどるために頭を切り替えるのに手間がかかるからです。<literal>DELAYED</"
4058 "literal> キュー (<xref linkend=\"delayed-incoming\"/> 参照) は、開発者が NMU "
4059 "をするのに必要な作業を同時にできるようになります。例えば、メンテナに対して更"
4060 "新したパッケージを 7 日後にアップロードするのを伝えるのではなく、パッケージ"
4061 "を <literal>DELAYED/7</literal> にアップロードしてメンテナに対して対応するの"
4062 "に 7 日間あることを伝えるべきです。この間、メンテナはもっとアップロードを遅ら"
4063 "せるかアップロードをキャンセルするかを尋ねることができます。"
4065 #. type: Content of: <chapter><section><section><para>
4068 "The <literal>DELAYED</literal> queue should not be used to put additional "
4069 "pressure on the maintainer. In particular, it's important that you are "
4070 "available to cancel or delay the upload before the delay expires since the "
4071 "maintainer cannot cancel the upload himself."
4073 "<literal>DELAYED</literal> キューは、無用のプレッシャーをメンテナに与えるため"
4074 "に使われるべきではありません。特に、メンテナはアップロードを自身ではキャンセ"
4075 "ルできないので、delay が完了する前にアップロードをキャンセルあるいは遅らせる"
4076 "ことができるのはあなただ、という点が重要です。"
4078 #. type: Content of: <chapter><section><section><para>
4081 "If you make an NMU to <literal>DELAYED</literal> and the maintainer updates "
4082 "his package before the delay expires, your upload will be rejected because a "
4083 "newer version is already available in the archive. Ideally, the maintainer "
4084 "will take care to include your proposed changes (or at least a solution for "
4085 "the problems they address) in that upload."
4087 "<literal>DELAYED</literal> を使った NMU を行って delay が完了する前にメンテナ"
4088 "がパッケージを更新した場合には、アーカイブに既により新しいバージョンがあるの"
4089 "で、あなたのアップロードは拒否されます。理想的なのは、メンテナがそのアップ"
4090 "ロードであなたが提案した変更 (あるいは少なくとも対応した問題の解決方法) を含"
4093 #. type: Content of: <chapter><section><section><title>
4095 msgid "NMUs from the maintainer's point of view"
4096 msgstr "メンテナの視点から見た NMU"
4098 #. type: Content of: <chapter><section><section><para>
4101 "When someone NMUs your package, this means they want to help you to keep it "
4102 "in good shape. This gives users fixed packages faster. You can consider "
4103 "asking the NMUer to become a co-maintainer of the package. Receiving an NMU "
4104 "on a package is not a bad thing; it just means that the package is "
4105 "interesting enough for other people to work on it."
4107 "誰かがあなたのパッケージを NMU した場合、これは彼らがパッケージを良い形に保つ"
4108 "のを助けたいと思っているということです。これによって、ユーザへ修正したパッ"
4109 "ケージをより早く届けます。NMU した人に、パッケージの副メンテナになることを尋"
4110 "ねるのを考えてみるのも良いでしょう。パッケージに対して NMU を受け取るのは悪い"
4111 "ことではありません。それは、単にそのパッケージが他の人が作業する価値があると"
4114 #. type: Content of: <chapter><section><section><para>
4117 "To acknowledge an NMU, include its changes and changelog entry in your next "
4118 "maintainer upload. If you do not acknowledge the NMU by including the NMU "
4119 "changelog entry in your changelog, the bugs will remain closed in the BTS "
4120 "but will be listed as affecting your maintainer version of the package."
4122 "NMU を承認するには、変更と changelog のエントリを次のメンテナアップロードに含"
4123 "めます。バグは BTS で close されたままになりますが、パッケージのメンテナバー"
4124 "ジョンに影響していると表示されます。"
4126 #. type: Content of: <chapter><section><section><title>
4128 msgid "Source NMUs vs Binary-only NMUs (binNMUs)"
4129 msgstr "ソース NMU vs バイナリのみの NMU (binNMU)"
4131 #. type: Content of: <chapter><section><section><para>
4134 "The full name of an NMU is <emphasis>source NMU</emphasis>. There is also "
4135 "another type, namely the <emphasis>binary-only NMU</emphasis>, or "
4136 "<emphasis>binNMU</emphasis>. A binNMU is also a package upload by someone "
4137 "other than the package's maintainer. However, it is a binary-only upload."
4139 "NMU のフルネームは<emphasis>ソース NMU</emphasis> です。もう一つ別の種類が"
4140 "あって、<emphasis>バイナリのみの NMU (binary-only NMU)</emphasis> あるいは "
4141 "<emphasis>binNMU</emphasis> と名付けられています。binNMU も、パッケージメンテ"
4142 "ナ以外の誰かによるパッケージのアップロードです。しかし、これはバイナリのみの"
4145 #. type: Content of: <chapter><section><section><para>
4148 "When a library (or other dependency) is updated, the packages using it may "
4149 "need to be rebuilt. Since no changes to the source are needed, the same "
4150 "source package is used."
4152 "ライブラリ (や他の依存関係) が更新された時、それを使っているパッケージを再ビ"
4153 "ルドする必要があるかもしれません。ソースへの変更は必要ないので、同じソース"
4156 #. type: Content of: <chapter><section><section><para>
4159 "BinNMUs are usually triggered on the buildds by wanna-build. An entry is "
4160 "added to <filename>debian/changelog</filename>, explaining why the upload "
4161 "was needed and increasing the version number as described in <xref linkend="
4162 "\"binary-only-nmu\"/>. This entry should not be included in the next upload."
4164 "binNMU は、通常 wanna-build によって buildd 上で引き起こされます。"
4165 "<filename>debian/changelog</filename> にエントリが追加され、なぜアップロード"
4166 "が必要だったのか、という説明と <xref linkend=\"binary-only-nmu\"/> で記述され"
4167 "ているようにバージョン番号を増やします。このエントリは、その次のアップロード"
4170 #. type: Content of: <chapter><section><section><para>
4173 "Buildds upload packages for their architecture to the archive as binary-only "
4174 "uploads. Strictly speaking, these are binNMUs. However, they are not "
4175 "normally called NMU, and they don't add an entry to <filename>debian/"
4176 "changelog</filename>."
4178 "buildd は、アーカイブするために、バイナリのみのアップロードとして、そのアーキ"
4179 "テクチャに対してパッケージをアップロードします。厳密に言えば、これは binNMU "
4180 "です。しかし、これは通常 NMU とは呼ばれず、<filename>debian/changelog</"
4181 "filename> にエントリを追加しません。"
4183 #. type: Content of: <chapter><section><section><title>
4185 msgid "NMUs vs QA uploads"
4186 msgstr "NMU vs QA アップロード"
4188 #. type: Content of: <chapter><section><section><para>
4191 "NMUs are uploads of packages by somebody else than their assigned "
4192 "maintainer. There is another type of upload where the uploaded package is "
4193 "not yours: QA uploads. QA uploads are uploads of orphaned packages."
4195 "NMU は、割り当てられているメンテナ以外の誰かによるパッケージのアップロードで"
4196 "す。自分のものではないパッケージのアップロードについては、もう一つ、別の種類"
4197 "のアップロードがあります: QA アップロードです。QAアップロードは、みなしご化さ"
4200 #. type: Content of: <chapter><section><section><para>
4203 "QA uploads are very much like normal maintainer uploads: they may fix "
4204 "anything, even minor issues; the version numbering is normal, and there is "
4205 "no need to use a delayed upload. The difference is that you are not listed "
4206 "as the <literal>Maintainer</literal> or <literal>Uploader</literal> for the "
4207 "package. Also, the changelog entry of a QA upload has a special first line:"
4209 "QA アップロードは、ほとんど通常のメンテナによるアップロードと同じです: 些細な"
4210 "問題であっても、なんでも修正します。バージョン番号の付け方は通常のものです"
4211 "し、delay アップロードをする必要もありません。違いは、パッケージのメンテナあ"
4212 "るいはアップローダとして記載されていない点です。また、QA アップロードの "
4213 "changelog のエントリは以下のように最初の一行が特別になっています:"
4215 #. type: Content of: <chapter><section><section><screen>
4218 msgid " * QA upload.\n"
4219 msgstr " * QA upload.\n"
4221 #. type: Content of: <chapter><section><section><para>
4224 "If you want to do an NMU, and it seems that the maintainer is not active, it "
4225 "is wise to check if the package is orphaned (this information is displayed "
4226 "on the package's Package Tracking System page). When doing the first QA "
4227 "upload to an orphaned package, the maintainer should be set to "
4228 "<literal>Debian QA Group <packages@qa.debian.org></literal>. Orphaned "
4229 "packages which did not yet have a QA upload still have their old maintainer "
4230 "set. There is a list of them at <ulink url=\"&url-orphaned-not-qa;\"/>."
4232 "あなたが NMU をしたいと思い、かつ、メンテナが活動的ではない場合、パッケージが"
4233 "みなしご化されてないかどうかを確認するのが賢明です (この情報はパッケージ追跡"
4234 "システム (PTS) のページで表示されています)。みなしご化されたパッケージに対し"
4235 "て最初の QA アップロードを行うときは、メンテナは <literal>Debian QA Group "
4236 "<packages@qa.debian.org></literal> に設定する必要があります。まだ QA "
4237 "アップロードがされていないみなしご化されたパッケージには、以前のメンテナが設"
4238 "定されています。この一覧は <ulink url=\"&url-orphaned-not-qa;\"/> で手に入り"
4241 #. type: Content of: <chapter><section><section><para>
4244 "Instead of doing a QA upload, you can also consider adopting the package by "
4245 "making yourself the maintainer. You don't need permission from anybody to "
4246 "adopt an orphaned package, you can just set yourself as maintainer and "
4247 "upload the new version (see <xref linkend=\"adopting\"/>)."
4249 "QA アップロードをする代わりに、メンテナをあなた自身に変更してパッケージを引き"
4250 "取ることも考えられます。みなしご化されたパッケージを引き取るのには、誰からの"
4251 "許可も必要としません。メンテナをあなた自身に設定して新しいバージョンをアップ"
4252 "ロードするだけです (<xref linkend=\"adopting\"/> を参照)。"
4254 #. type: Content of: <chapter><section><section><title>
4256 msgid "NMUs vs team uploads"
4257 msgstr "NMU vs チームアップロード"
4259 #. type: Content of: <chapter><section><section><para>
4262 "Sometimes you are fixing and/or updating a package because you are member of "
4263 "a packaging team (which uses a mailing list as <literal>Maintainer</literal> "
4264 "or <literal>Uploader</literal>, see <xref linkend=\"collaborative-maint\"/>) "
4265 "but you don't want to add yourself to <literal>Uploaders</literal> because "
4266 "you do not plan to contribute regularly to this specific package. If it "
4267 "conforms with your team's policy, you can perform a normal upload without "
4268 "being listed directly as <literal>Maintainer</literal> or <literal>Uploader</"
4269 "literal>. In that case, you should start your changelog entry with the "
4272 "パッケージングチーム (<literal>Maintainer</literal> あるいは "
4273 "<literal>Uploader</literal> としてメーリングリストを使う。<xref linkend="
4274 "\"collaborative-maint\"/> 参照) の一員であるため、時々パッケージを修正あるい"
4275 "は更新しているが、常にこの特定パッケージに貢献する予定は無いので自分を "
4276 "<literal>Uploaders</literal> には加えたくはない、という時があります。これがあ"
4277 "なたのチームの方針に沿っているなら、直接 <literal>Maintainer</literal> 欄や "
4278 "<literal>Uploader</literal> 欄に記載せずとも通常のアップロードが可能です。こ"
4279 "の場合、changelog のエントリを以下の行で始める必要があります:"
4281 #. type: Content of: <chapter><section><section><screen>
4284 msgid " * Team upload.\n"
4285 msgstr " * Team upload.\n"
4287 # type: Content of: <chapter><section><title>
4288 #. type: Content of: <chapter><section><title>
4290 msgid "Collaborative maintenance"
4293 #. type: Content of: <chapter><section><para>
4296 "Collaborative maintenance is a term describing the sharing of Debian package "
4297 "maintenance duties by several people. This collaboration is almost always a "
4298 "good idea, since it generally results in higher quality and faster bug fix "
4299 "turnaround times. It is strongly recommended that packages with a priority "
4300 "of <literal>standard</literal> or which are part of the base set have co-"
4303 "共同メンテナンス (collaborative maintenance) は、Debian パッケージのメンテナ"
4304 "ンス責任を数人でシェアすることを指す用語です。この共同作業は、通常はより上質"
4305 "で短いバグ修正時間をもたらすので、大抵の場合は常に良い考えです。優先度が標準 "
4306 "(<literal>standard</literal>) あるいは基本セット (base) の一部であるパッケー"
4307 "ジは、副メンテナ (co-maintainer) を持つことを強くお勧めします。"
4309 # type: Content of: <chapter><section><para>
4310 #. type: Content of: <chapter><section><para>
4313 "Generally there is a primary maintainer and one or more co-maintainers. The "
4314 "primary maintainer is the person whose name is listed in the "
4315 "<literal>Maintainer</literal> field of the <filename>debian/control</"
4316 "filename> file. Co-maintainers are all the other maintainers, usually "
4317 "listed in the <literal>Uploaders</literal> field of the <filename>debian/"
4318 "control</filename> file."
4320 "大抵の場合、主メンテナに加えて一人か二人の副メンテナが居ます。主メンテナは "
4321 "<filename>debian/control</filename> ファイルの <literal>Maintainer</literal> "
4322 "欄に名前が記載されている人です。副メンテナは他のすべてのメンテナで、通常 "
4323 "<filename>debian/control</filename> ファイルの <literal>Uploaders</literal> "
4326 # type: Content of: <chapter><section><para>
4327 #. type: Content of: <chapter><section><para>
4330 "In its most basic form, the process of adding a new co-maintainer is quite "
4332 msgstr "もっとも基本的なやり方では、新しい副メンテナの追加は大変簡単です:"
4334 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
4337 "Setup the co-maintainer with access to the sources you build the package "
4338 "from. Generally this implies you are using a network-capable version "
4339 "control system, such as <literal>CVS</literal> or <literal>Subversion</"
4340 "literal>. Alioth (see <xref linkend=\"alioth\"/>) provides such tools, "
4343 "副メンテナが、あなたがビルドしたパッケージのソースにアクセスできるように設定"
4344 "します。一般に、これはあなたが <literal>CVS</literal> や "
4345 "<literal>Subversion</literal> のようなネットワークを利用するバージョン管理シ"
4346 "ステムを利用しているということを意味しています。Alioth (<xref linkend="
4347 "\"alioth\"/> 参照) はこの様なツールを提供しており、他でも同様です。"
4349 # type: Content of: <chapter><section><itemizedlist><listitem><para>
4350 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
4353 "Add the co-maintainer's correct maintainer name and address to the "
4354 "<literal>Uploaders</literal> field in the first paragraph of the "
4355 "<filename>debian/control</filename> file."
4357 "副メンテナの正確なメンテナ名とアドレスを <filename>debian/control</filename> "
4358 "ファイルの最初の段落の <literal>Uploaders</literal> 欄に追加します。"
4360 # type: Content of: <chapter><section><itemizedlist><listitem><screen>
4361 #. type: Content of: <chapter><section><itemizedlist><listitem><screen>
4364 msgid "Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org>\n"
4365 msgstr "Uploaders: John Buzz <jbuzz@debian.org>, Adam Rex <arex@debian.org>\n"
4367 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
4370 "Using the PTS (<xref linkend=\"pkg-tracking-system\"/>), the co-maintainers "
4371 "should subscribe themselves to the appropriate source package."
4373 "PTS (<xref linkend=\"pkg-tracking-system\"/>) を使う場合、副メンテナは適切な"
4374 "ソースパッケージの購読をする必要があります。"
4376 #. type: Content of: <chapter><section><para>
4379 "Another form of collaborative maintenance is team maintenance, which is "
4380 "recommended if you maintain several packages with the same group of "
4381 "developers. In that case, the <literal>Maintainer</literal> and "
4382 "<literal>Uploaders</literal> field of each package must be managed with "
4383 "care. It is recommended to choose between one of the two following schemes:"
4385 "共同メンテナンスのもう一つの形態はチームメンテナンスです。これは、複数のパッ"
4386 "ケージを同じ開発者グループでメンテナンスする場合にお勧めです。その場合、各"
4387 "パッケージの <literal>Maintainer</literal> 欄と <literal>Uploaders</literal> "
4388 "欄は注意して扱わねばいけません。以下の二つの案からいずれかを選ぶのがお勧めで"
4391 #. type: Content of: <chapter><section><orderedlist><listitem><para>
4394 "Put the team member mainly responsible for the package in the "
4395 "<literal>Maintainer</literal> field. In the <literal>Uploaders</literal>, "
4396 "put the mailing list address, and the team members who care for the package."
4398 "パッケージの主に担当をするチームメンバーを <literal>Maintainer</literal> 欄に"
4399 "追加します。<literal>Uploaders</literal> 欄には、メーリングリストのアドレスと"
4400 "パッケージの面倒をみるチームメンバーを追加します。"
4402 #. type: Content of: <chapter><section><orderedlist><listitem><para>
4405 "Put the mailing list address in the <literal>Maintainer</literal> field. In "
4406 "the <literal>Uploaders</literal> field, put the team members who care for "
4407 "the package. In this case, you must make sure the mailing list accept bug "
4408 "reports without any human interaction (like moderation for non-subscribers)."
4410 "メーリングリストのアドレスを <literal>Maintainer</literal> 欄に追加します。"
4411 "<literal>Uploaders</literal> 欄には、パッケージの面倒をみるチームメンバーを追"
4412 "加します。この場合、メーリングリストは (購読者以外に対するモデレーションなど"
4413 "の) 人手を介さずにバグ報告を受け取ることを確認する必要があります。"
4415 #. type: Content of: <chapter><section><para>
4418 "In any case, it is a bad idea to automatically put all team members in the "
4419 "<literal>Uploaders</literal> field. It clutters the Developer's Package "
4420 "Overview listing (see <xref linkend=\"ddpo\"/>) with packages one doesn't "
4421 "really care for, and creates a false sense of good maintenance. For the same "
4422 "reason, team members do not need to add themselves to the "
4423 "<literal>Uploaders</literal> field just because they are uploading the "
4424 "package once, they can do a “Team upload” (see <xref linkend=\"nmu-team-"
4425 "upload\"/>). Conversely, it is a bad idea to keep a package with only the "
4426 "mailing list address as a <literal>Maintainer</literal> and no "
4427 "<literal>Uploaders</literal>."
4429 "どのような場合でも、すべてのチームメンバーを <literal>Uploaders</literal> 欄"
4430 "に入れるのは良くない考えです。これは、Developer's Package Overview の一覧 "
4431 "(<xref linkend=\"ddpo\"/> 参照) を実際には対応していないパッケージで散らかし"
4432 "てしまい、偽りの良いメンテナンス状態を作り出します。同じ理由から、パッケージ"
4433 "を一回アップロードするのであれば、「チームアップロード (Team Upload)」ができ"
4434 "るので、チームメンバーは <literal>Uploaders</literal> 欄へ自分を追加する必要"
4435 "はありません (<xref linkend=\"nmu-team-upload\"/> 参照)。逆にいえば、"
4436 "<literal>Maintainer</literal> 欄にメーリングリストのアドレスのみで "
4437 "<literal>Uploaders</literal> 欄に誰も追加していないままにしておくのは良くない"
4440 # type: Content of: <chapter><section><title>
4441 #. type: Content of: <chapter><section><title>
4443 msgid "The testing distribution"
4444 msgstr "テスト版ディストリビューション"
4446 # type: Content of: <chapter><section><section><title>
4447 #. type: Content of: <chapter><section><section><title>
4452 # type: Content of: <chapter><section><section><para>
4453 #. type: Content of: <chapter><section><section><para>
4456 "Packages are usually installed into the <literal>testing</literal> "
4457 "distribution after they have undergone some degree of <literal>testing</"
4458 "literal> in <literal>unstable</literal>."
4460 "通常、パッケージは<literal>不安定版 (unstable)</literal> での必要ないくつかの"
4461 "テストを潜り抜けた後で、<literal>テスト版ディストリビューション(testing)</"
4462 "literal> にインストールされます。"
4464 #. type: Content of: <chapter><section><section><para>
4467 "They must be in sync on all architectures and mustn't have dependencies that "
4468 "make them uninstallable; they also have to have generally no known release-"
4469 "critical bugs at the time they're installed into <literal>testing</"
4470 "literal>. This way, <literal>testing</literal> should always be close to "
4471 "being a release candidate. Please see below for details."
4473 "これらは、すべてのアーキテクチャ上で同期していなければならず、インストールで"
4474 "きなくなるような依存関係を持ってはいけません。また、<literal>テスト版 "
4475 "(testing)</literal> にインストールされる際に既知のリリースクリティカルバグを"
4476 "持っていない必要があります。このようにして、<literal>テスト版 (testing)</"
4477 "literal> は常にリリース候補に近いものである必要があります。詳細は以下を参照し"
4480 # type: Content of: <chapter><section><section><title>
4481 #. type: Content of: <chapter><section><section><title>
4483 msgid "Updates from unstable"
4486 # type: Content of: <chapter><section><section><para>
4487 #. type: Content of: <chapter><section><section><para>
4490 "The scripts that update the <literal>testing</literal> distribution are run "
4491 "twice each day, right after the installation of the updated packages; these "
4492 "scripts are called <literal>britney</literal>. They generate the "
4493 "<filename>Packages</filename> files for the <literal>testing</literal> "
4494 "distribution, but they do so in an intelligent manner; they try to avoid any "
4495 "inconsistency and to use only non-buggy packages."
4497 "<literal>テスト版 (testing)</literal> ディストリビューションを更新するスクリ"
4498 "プトは、日に二回、更新されたパッケージのインストール直後に動作します。これら"
4499 "のスクリプトは <literal>britney</literal> と呼ばれます。これは、<literal>テス"
4500 "ト版 (testing)</literal> ディストリビューションに対して <filename>Packages</"
4501 "filename> ファイルを生成しますが、不整合を避けてバグが無いパッケージのみを利"
4502 "用しようとする気の利いたやり方で行います。"
4504 # type: Content of: <chapter><section><section><para>
4505 #. type: Content of: <chapter><section><section><para>
4508 "The inclusion of a package from <literal>unstable</literal> is conditional "
4511 "<literal>不安定版 (unstable)</literal> からのパッケージの取り込みは以下の条件"
4514 # sticky あたりから良く分からない…
4515 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4516 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4520 "The package must have been available in <literal>unstable</literal> for 2, 5 "
4521 "or 10 days, depending on the urgency (high, medium or low). Please note "
4522 "that the urgency is sticky, meaning that the highest urgency uploaded since "
4523 "the previous <literal>testing</literal> transition is taken into account. "
4524 "Those delays may be doubled during a freeze, or <literal>testing</literal> "
4525 "transitions may be switched off altogether;"
4527 "パッケージは、urgency に応じて (high、medium、low)、2日、5日、10日の間、"
4528 "<literal>不安定版 (unstable)</literal> で利用可能になっていなければいけませ"
4529 "ん。urgency は、最も高い urgency でアップロードされたものは以前の <literal>テ"
4530 "スト版 (testing)</literal> への移行が考慮に入れられるためですこの遅延は、フ"
4531 "リーズ期間の間は倍になるか、<literal>テスト版 (testing)</literal> への移行が"
4534 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4535 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4538 "It must not have new release-critical bugs (RC bugs affecting the version "
4539 "available in <literal>unstable</literal>, but not affecting the version in "
4540 "<literal>testing</literal>);"
4542 "新たなリリースクリティカルバグを持っていないこと (<literal>不安定版 "
4543 "(unstable)</literal>で利用可能なバージョンに影響する RC バグであって、"
4544 "<literal>テスト版 (testing)</literal> にあるバージョンに影響するものではな"
4547 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4550 "It must be available on all architectures on which it has previously been "
4551 "built in <literal>unstable</literal>. <link linkend=\"dak-ls\">dak ls</link> "
4552 "may be of interest to check that information;"
4554 "あらかじめ <literal>unstable</literal> でビルドされた際に、全アーキテクチャで"
4555 "利用可能になっていなくてはいけません。この情報をチェックするのに <link "
4556 "linkend=\"dak-ls\">dak ls</link> に興味を持つかもしれません;"
4558 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4559 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4562 "It must not break any dependency of a package which is already available in "
4563 "<literal>testing</literal>;"
4565 "既に<literal>テスト版 (testing)</literal> で利用可能になっているパッケージの"
4568 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4571 "The packages on which it depends must either be available in "
4572 "<literal>testing</literal> or they must be accepted into <literal>testing</"
4573 "literal> at the same time (and they will be if they fulfill all the "
4574 "necessary criteria)."
4576 "パッケージが依存するものは、<literal>テスト版 (testing)</literal> で利用可能"
4577 "なものか、<literal>テスト版 (testing)</literal> に同時に受け入れられるもので"
4578 "なくてはいけない (そして、それらは必要な条件をすべて満たしていれば、<literal>"
4579 "テスト版 (testing)</literal>) に入る)。"
4581 # type: Content of: <chapter><section><section><para>
4582 #. type: Content of: <chapter><section><section><para>
4585 "To find out whether a package is progressing into <literal>testing</literal> "
4586 "or not, see the <literal>testing</literal> script output on the <ulink url="
4587 "\"&url-testing-maint;\">web page of the testing distribution</ulink>, or use "
4588 "the program <command>grep-excuses</command> which is in the <systemitem role="
4589 "\"package\">devscripts</systemitem> package. This utility can easily be "
4590 "used in a <citerefentry> <refentrytitle>crontab</refentrytitle> "
4591 "<manvolnum>5</manvolnum> </citerefentry> to keep yourself informed of the "
4592 "progression of your packages into <literal>testing</literal>."
4594 "パッケージが<literal>テスト版 (testing)</literal> に入る処理がされるかどうか"
4595 "は、<ulink url=\"&url-testing-maint;\">テスト版ディストリビューションのウェブ"
4596 "ページ</ulink>の<literal>テスト版 (testing)</literal> スクリプトの出力を参照"
4597 "するか、<systemitem role=\"package\">devscripts</systemitem> パッケージ中の "
4598 "<command>grep-excuses</command> プログラムを使ってください。このユーティリ"
4599 "ティは、パッケージが<literal>テスト版 (testing)</literal> への進行の通知をし"
4600 "続けるのに、<citerefentry> <refentrytitle>crontab</refentrytitle> "
4601 "<manvolnum>5</manvolnum> </citerefentry> で手軽に使うことができます。"
4603 # type: Content of: <chapter><section><section><para>
4604 #. type: Content of: <chapter><section><section><para>
4607 "The <filename>update_excuses</filename> file does not always give the "
4608 "precise reason why the package is refused; you may have to find it on your "
4609 "own by looking for what would break with the inclusion of the package. The "
4610 "<ulink url=\"&url-testing-maint;\">testing web page</ulink> gives some more "
4611 "information about the usual problems which may be causing such troubles."
4613 "<filename>update_excuses</filename> は、なぜパッケージが拒否されたのか正確な"
4614 "理由を必ずしも表示しません。自分自身で何がパッケージが含まれるのを妨げている"
4615 "のか、探す必要があるかもしれません。<ulink url=\"&url-testing-maint;\">テスト"
4616 "版のウェブページ</ulink>が、そのような問題を引き起こす良くある問題についての"
4619 # type: Content of: <chapter><section><section><para>
4620 #. type: Content of: <chapter><section><section><para>
4623 "Sometimes, some packages never enter <literal>testing</literal> because the "
4624 "set of interrelationship is too complicated and cannot be sorted out by the "
4625 "scripts. See below for details."
4627 "時折、相互依存関係の組み合わせが非常に難解なのでスクリプトが解決できないこと"
4628 "があるため、パッケージが<literal>テスト版 (testing)</literal> に決して入らな"
4629 "いことがあります。詳細は下記を参照してください。"
4631 # type: Content of: <chapter><section><section><para>
4632 #. type: Content of: <chapter><section><section><para>
4635 "Some further dependency analysis is shown on <ulink url=\"http://release."
4636 "debian.org/migration/\"></ulink> — but be warned, this page also shows build "
4637 "dependencies which are not considered by britney."
4639 "依存性についてのさらなる分析は、<ulink url=\"http://release.debian.org/"
4640 "migration/\"></ulink> で表示されています — ですが、このページが britney が処"
4641 "理した依存性ではないものも表示しているのに注意してください。"
4643 #. type: Content of: <chapter><section><section><section><title>
4646 msgstr "時代遅れ (Out-of-date)"
4648 # type: Content of: <chapter><section><section><section><para>
4649 #. FIXME: better rename this file than document rampant professionalism?
4650 #. type: Content of: <chapter><section><section><section><para>
4653 "For the <literal>testing</literal> migration script, outdated means: There "
4654 "are different versions in <literal>unstable</literal> for the release "
4655 "architectures (except for the architectures in fuckedarches; fuckedarches is "
4656 "a list of architectures that don't keep up (in <filename>update_out.py</"
4657 "filename>), but currently, it's empty). outdated has nothing whatsoever to "
4658 "do with the architectures this package has in <literal>testing</literal>."
4660 "<literal>テスト版 (testing)</literal> への移行スクリプトの場合、時代遅れ "
4661 "(outdated) というのが意味しているのは: リリースアーキテクチャに対して、複数の"
4662 "異なったバージョンが<literal>不安定版 (unstable)</literal> にある "
4663 "(fuckedarches にあるアーキテクチャを除く。fuckedarches は "
4664 "(<filename>update_out.py</filename> 中で) 更新を行わないアーキテクチャの一覧"
4665 "ですが、現在のところは空になっています)。時代遅れ (outdated) の場合、"
4666 "<literal>テスト版 (testing)</literal> でこのパッケージが存在しているアーキテ"
4669 # type: Content of: <chapter><section><section><section><para>
4670 #. type: Content of: <chapter><section><section><section><para>
4672 msgid "Consider this example:"
4673 msgstr "以下の例を考えてみましょう:"
4675 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4676 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4677 #: pkgs.dbk:2423 pkgs.dbk:2456
4681 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4682 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4683 #: pkgs.dbk:2424 pkgs.dbk:2457
4687 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4688 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4689 #: pkgs.dbk:2429 pkgs.dbk:2463 pkgs.dbk:2525
4693 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4694 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4695 #: pkgs.dbk:2430 pkgs.dbk:2435 pkgs.dbk:2464 pkgs.dbk:2465 pkgs.dbk:2472
4699 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4700 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4701 #: pkgs.dbk:2431 pkgs.dbk:2466 pkgs.dbk:2471
4705 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4706 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4707 #: pkgs.dbk:2434 pkgs.dbk:2469 pkgs.dbk:2526
4711 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4712 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4713 #: pkgs.dbk:2436 pkgs.dbk:2470
4717 #. type: Content of: <chapter><section><section><section><para>
4720 "The package is out of date on <literal>alpha</literal> in <literal>unstable</"
4721 "literal>, and will not go to <literal>testing</literal>. Removing the "
4722 "package would not help at all, the package is still out of date on "
4723 "<literal>alpha</literal>, and will not propagate to <literal>testing</"
4726 "<literal>不安定版 (unstable)</literal> での <literal>alpha</literal> のパッ"
4727 "ケージは時代遅れになっているので、<literal>テスト版 (testing)</literal> に入"
4728 "りません。パッケージの削除は全く役に立たず、<literal>alpha</literal> ではパッ"
4729 "ケージは時代遅れのままで、<literal>テスト版 (testing)</literal> には移行しま"
4732 # type: Content of: <chapter><section><section><section><para>
4733 #. type: Content of: <chapter><section><section><section><para>
4736 "However, if ftp-master removes a package in <literal>unstable</literal> "
4737 "(here on <literal>arm</literal>):"
4739 "ですが、もしも ftp-master が<literal>不安定版 (unstable)</literal> のパッケー"
4740 "ジ (ここでは <literal>arm</literal> の) を削除した場合:"
4742 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4743 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
4748 # type: Content of: <chapter><section><section><section><para>
4749 #. type: Content of: <chapter><section><section><section><para>
4752 "In this case, the package is up to date on all release architectures in "
4753 "<literal>unstable</literal> (and the extra <literal>hurd-i386</literal> "
4754 "doesn't matter, as it's not a release architecture)."
4756 "この場合、パッケージは<literal>不安定版 (unstable)</literal> ですべてのリリー"
4757 "スアーキテクチャで最新になります (それから、もう一つの <literal>hurd-i386</"
4758 "literal> は、リリースアーキテクチャではないので問題になりません)。"
4760 # type: Content of: <chapter><section><section><section><para>
4761 #. type: Content of: <chapter><section><section><section><para>
4764 "Sometimes, the question is raised if it is possible to allow packages in "
4765 "that are not yet built on all architectures: No. Just plainly no. (Except "
4766 "if you maintain glibc or so.)"
4768 "時折、すべてのアーキテクチャでまだビルドされていていないパッケージを入れられ"
4769 "るか、という質問がでてきます: いいえ。 単純にいいえ、です (glibc などをメンテ"
4772 # type: Content of: <chapter><section><section><section><title>
4773 #. type: Content of: <chapter><section><section><section><title>
4775 msgid "Removals from testing"
4778 # type: Content of: <chapter><section><section><section><para>
4779 #. type: Content of: <chapter><section><section><section><para>
4782 "Sometimes, a package is removed to allow another package in: This happens "
4783 "only to allow <emphasis>another</emphasis> package to go in if it's ready in "
4784 "every other sense. Suppose e.g. that <literal>a</literal> cannot be "
4785 "installed with the new version of <literal>b</literal>; then <literal>a</"
4786 "literal> may be removed to allow <literal>b</literal> in."
4788 "時折、パッケージは他のパッケージがテスト版へ入るために削除されます: これは、"
4789 "<emphasis>他の</emphasis>パッケージが他のすべての面で準備ができている場合にテ"
4790 "スト版に入るようにする場合のみ発生します。例えば、<literal>a</literal> が新し"
4791 "いバージョンの <literal>b</literal> とはインストールできない場合を考えてみま"
4792 "しょう。その場合、<literal>a</literal> は <literal>b</literal> が入るために削"
4795 #. type: Content of: <chapter><section><section><section><para>
4798 "Of course, there is another reason to remove a package from "
4799 "<literal>testing</literal>: It's just too buggy (and having a single RC-bug "
4800 "is enough to be in this state)."
4802 "もちろん、他にも <literal>テスト版 (testing)</literal> からパッケージが削除さ"
4803 "れる理由があります: バグが多すぎる場合です (そして RC バグが1個だけあるのもこ"
4806 # type: Content of: <chapter><section><section><section><para>
4807 #. type: Content of: <chapter><section><section><section><para>
4810 "Furthermore, if a package has been removed from <literal>unstable</literal>, "
4811 "and no package in <literal>testing</literal> depends on it any more, then it "
4812 "will automatically be removed."
4814 "さらに、パッケージが <literal>不安定版 (unstable)</literal> から削除され、"
4815 "<literal>テスト版 (testing)</literal> にはこれに依存するパッケージがもうなく"
4816 "なった場合、パッケージは自動的に削除されます。"
4818 #. type: Content of: <chapter><section><section><section><title>
4820 msgid "Circular dependencies"
4823 # type: Content of: <chapter><section><section><section><para>
4824 #. type: Content of: <chapter><section><section><section><para>
4827 "A situation which is not handled very well by britney is if package "
4828 "<literal>a</literal> depends on the new version of package <literal>b</"
4829 "literal>, and vice versa."
4831 "britney によってうまく取扱われない状況は、パッケージ <literal>a</literal> が"
4832 "パッケージ <literal>b</literal> の新しいバージョンに依存していて、そしてその"
4835 # type: Content of: <chapter><section><section><section><para>
4836 #. type: Content of: <chapter><section><section><section><para>
4838 msgid "An example of this is:"
4841 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4842 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4847 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4848 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4850 msgid "1; depends: b=1"
4851 msgstr "1; depends: b=1"
4853 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4854 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4856 msgid "2; depends: b=2"
4857 msgstr "2; depends: b=2"
4859 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4860 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4865 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4866 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4868 msgid "1; depends: a=1"
4869 msgstr "1; depends: a=1"
4871 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4872 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
4874 msgid "2; depends: a=2"
4875 msgstr "2; depends: a=2"
4877 # type: Content of: <chapter><section><section><section><para>
4878 #. type: Content of: <chapter><section><section><section><para>
4881 "Neither package <literal>a</literal> nor package <literal>b</literal> is "
4882 "considered for update."
4884 "パッケージ <literal>a</literal> あるいはパッケージ <literal>b</literal> が更"
4887 # type: Content of: <chapter><section><section><section><para>
4888 #. type: Content of: <chapter><section><section><section><para>
4891 "Currently, this requires some manual hinting from the release team. Please "
4892 "contact them by sending mail to &email-debian-release; if this happens to "
4893 "one of your packages."
4895 "現状、このような場合はリリースチームによる手動でのヒントが必要になります。あ"
4896 "なたのパッケージのどれかにこのような状況が起きた場合は、&email-debian-"
4897 "release; にメールを送って連絡を取ってください。"
4899 # type: Content of: <chapter><section><section><section><title>
4900 #. type: Content of: <chapter><section><section><section><title>
4902 msgid "Influence of package in testing"
4903 msgstr "テスト版 (testing) にあるパッケージへの影響"
4905 #. type: Content of: <chapter><section><section><section><para>
4908 "Generally, there is nothing that the status of a package in "
4909 "<literal>testing</literal> means for transition of the next version from "
4910 "<literal>unstable</literal> to <literal>testing</literal>, with two "
4911 "exceptions: If the RC-bugginess of the package goes down, it may go in even "
4912 "if it is still RC-buggy. The second exception is if the version of the "
4913 "package in <literal>testing</literal> is out of sync on the different "
4914 "arches: Then any arch might just upgrade to the version of the source "
4915 "package; however, this can happen only if the package was previously forced "
4916 "through, the arch is in fuckedarches, or there was no binary package of that "
4917 "arch present in <literal>unstable</literal> at all during the "
4918 "<literal>testing</literal> migration."
4920 "一般的に言って、<literal>不安定版 (unstable)</literal> にあるパッケージのス"
4921 "テータスが意味するのは、<literal>不安定版 (unstable)</literal> から <literal>"
4922 "テスト版 (testing)</literal> へ移行する次のバージョン2 つの例外があります: "
4923 "パッケージの RC バグ数が減っている場合、RC バグが残っていてもテスト版に入る可"
4924 "能性があります。2 つ目の例外は、<literal>テスト版 (testing)</literal> のパッ"
4925 "ケージのバージョンが異なったアーキテクチャで同期していない場合です: その場"
4926 "合、すべてのアーキテクチャがソースパッケージのバージョンへとアップグレードさ"
4927 "れることがあります。ですが、これはパッケージが以前にアーキテクチャが、"
4928 "<literal>テスト版 (testing)</literal> への移行の際、<literal>不安定版 "
4929 "(unstable)</literal> にそのアーキテクチャのバイナリパッケージが全くないという"
4932 #. type: Content of: <chapter><section><section><section><para>
4935 "In summary this means: The only influence that a package being in "
4936 "<literal>testing</literal> has on a new version of the same package is that "
4937 "the new version might go in easier."
4939 "この要旨: 影響は、<literal>テスト版 (testing)</literal> にあるパッケージが、"
4940 "同じパッケージの新しいバージョンになるのは、新しいバージョンの方が楽にできそ"
4943 #. type: Content of: <chapter><section><section><section><title>
4948 # type: Content of: <chapter><section><section><section><para>
4949 #. type: Content of: <chapter><section><section><section><para>
4951 msgid "If you are interested in details, this is how britney works:"
4952 msgstr "詳細について知りたい場合ですが、britney の動作は以下のようになります:"
4954 # type: Content of: <chapter><section><section><section><para>
4955 #. type: Content of: <chapter><section><section><section><para>
4958 "The packages are looked at to determine whether they are valid candidates. "
4959 "This gives the update excuses. The most common reasons why a package is not "
4960 "considered are too young, RC-bugginess, and out of date on some arches. For "
4961 "this part of britney, the release managers have hammers of various sizes to "
4962 "force britney to consider a package. (Also, the base freeze is coded in "
4963 "that part of britney.) (There is a similar thing for binary-only updates, "
4964 "but this is not described here. If you're interested in that, please peruse "
4967 "パッケージが、適切な候補であるかどうかを決めるために確認が行われます。これに"
4968 "よって、更新が実行されます。パッケージが候補とみなされない理由でもっともよく"
4969 "あるのは、まだ日数が経過していない (too young)、RC バグがある、いくつかのアー"
4970 "キテクチャで古くなりすぎている、というものです。britney のこの部分では、リ"
4971 "リースマネージャーが britney がパッケージを検討できるように様々なサイズのハン"
4972 "マーを使います (それから、base freeze が britney のこの部分のコードに記述され"
4973 "ています)。(バイナリのみの更新 (binary-only update) についても同様ですが、ここ"
4974 "では記述しません。興味がある場合はコードを解析してください)。"
4976 #. type: Content of: <chapter><section><section><section><para>
4979 "Now, the more complex part happens: Britney tries to update "
4980 "<literal>testing</literal> with the valid candidates. For that, britney "
4981 "tries to add each valid candidate to the testing distribution. If the number "
4982 "of uninstallable packages in <literal>testing</literal> doesn't increase, "
4983 "the package is accepted. From that point on, the accepted package is "
4984 "considered to be part of <literal>testing</literal>, such that all "
4985 "subsequent installability tests include this package. Hints from the "
4986 "release team are processed before or after this main run, depending on the "
4989 "さて、より複雑な部分に差し掛かります: Britney が適正候補を使って<literal>テス"
4990 "ト版 (testing)</literal> を更新しようとします。このため、britney はテスト版"
4991 "ディストリビューションに個々の適正な候補を追加しようとします。<literal>テスト"
4992 "版 (testing)</literal> でインストール不可能なパッケージの数が増えないのであれ"
4993 "ば、パッケージは受け入れられます。その時から、受け入れられたパッケージは"
4994 "<literal>テスト版 (testing)</literal> の一部として取り扱われ、このパッケージ"
4995 "を含めるためのインストールチェックテストが引き続き行われます。リリースチーム"
4996 "からのヒントは、実際の内容に応じて、このメインの処理の前後に処理されます。"
4998 # type: Content of: <chapter><section><section><section><para>
4999 #. type: Content of: <chapter><section><section><section><para>
5002 "If you want to see more details, you can look it up on <ulink url=\"http://"
5003 "&ftp-master-host;/testing/update_output/\"></ulink>."
5005 "より詳細を見たい場合は、<ulink url=\"http://&ftp-master-host;/testing/update_output/\">"
5006 "</ulink> で探すことができます。"
5008 # type: Content of: <chapter><section><section><section><para>
5009 #. type: Content of: <chapter><section><section><section><para>
5012 "The hints are available via <ulink url=\"http://&ftp-master-host;/testing/"
5013 "hints/\"></ulink>."
5015 "hints は <ulink url=\"http://&ftp-master-host;/testing/hints/\"></ulink> 経由"
5018 # type: Content of: <chapter><section><section><title>
5019 #. type: Content of: <chapter><section><section><title>
5021 msgid "Direct updates to testing"
5022 msgstr "直接テスト版を更新する"
5024 #. type: Content of: <chapter><section><section><para>
5027 "The <literal>testing</literal> distribution is fed with packages from "
5028 "<literal>unstable</literal> according to the rules explained above. "
5029 "However, in some cases, it is necessary to upload packages built only for "
5030 "<literal>testing</literal>. For that, you may want to upload to "
5031 "<literal>testing-proposed-updates</literal>."
5033 "<literal>テスト版 (testing)</literal> ディストリビューションは、上記で説明し"
5034 "たルールに従って <literal>不安定版 (unstable)</literal> からのパッケージで作"
5035 "られています。しかし、時折、<literal>テスト版 (testing)</literal> の為だけに"
5036 "構築したパッケージをアップロードする必要があるという場合があります。そのため"
5037 "には、<literal>testing-proposed-updates</literal> にアップロードするのが良い"
5040 # type: Content of: <chapter><section><section><para>
5041 #. type: Content of: <chapter><section><section><para>
5044 "Keep in mind that packages uploaded there are not automatically processed, "
5045 "they have to go through the hands of the release manager. So you'd better "
5046 "have a good reason to upload there. In order to know what a good reason is "
5047 "in the release managers' eyes, you should read the instructions that they "
5048 "regularly give on &email-debian-devel-announce;."
5050 "アップロードされたパッケージは自動的に処理されず、リリースマネージャの手に"
5051 "よって処理される必要があることに注意してください。ですので、アップロードする"
5052 "のに十分な理由があるのが望ましいでしょう。何が十分な理由かを知るには、リリー"
5053 "スマネージャの視点で、彼らが定期的に &email-debian-devel-announce; に流してい"
5056 #. type: Content of: <chapter><section><section><para>
5059 "You should not upload to <literal>testing-proposed-updates</literal> when "
5060 "you can update your packages through <literal>unstable</literal>. If you "
5061 "can't (for example because you have a newer development version in "
5062 "<literal>unstable</literal>), you may use this facility, but it is "
5063 "recommended that you ask for authorization from the release manager first. "
5064 "Even if a package is frozen, updates through <literal>unstable</literal> are "
5065 "possible, if the upload via <literal>unstable</literal> does not pull in any "
5068 "<literal>不安定版 (unstable)</literal> でパッケージを更新できるのであれば、"
5069 "<literal>testing-proposed-updates</literal> にアップロードすべきではありませ"
5070 "ん。更新できない場合 (例えば、<literal>不安定版 (unstable)</literal> に新しい"
5071 "開発版がある場合)、この機能を使うことができますが、まずはリリースマネージャか"
5072 "ら許可を得るのが良いでしょう。パッケージがフリーズされていても、<literal>不安"
5073 "定版 (unstable)</literal> 経由のアップロードが新たな依存関係を何も引き起こさ"
5074 "ない場合、<literal>不安定版 (unstable)</literal> での更新は可能です。"
5076 #. type: Content of: <chapter><section><section><para>
5079 "Version numbers are usually selected by adding the codename of the "
5080 "<literal>testing</literal> distribution and a running number, like "
5081 "<literal>1.2squeeze1</literal> for the first upload through <literal>testing-"
5082 "proposed-updates</literal> of package version <literal>1.2</literal>."
5084 "バージョン番号は、通常<literal>テスト版 (testing)</literal> ディストリビュー"
5085 "ションのコードネームと動作している番号を追加するなどして決定されます。例え"
5086 "ば、<literal>1.2squeeze1</literal> はパッケージバージョン <literal>1.2</"
5087 "literal> の <literal>testing-proposed-updates</literal> への最初のアップロー"
5090 # type: Content of: <chapter><section><section><para>
5091 #. type: Content of: <chapter><section><section><para>
5093 msgid "Please make sure you didn't miss any of these items in your upload:"
5095 "アップロードで、以下の項目のいずれも見落とさないように必ずしてください:"
5097 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5100 "Make sure that your package really needs to go through <literal>testing-"
5101 "proposed-updates</literal>, and can't go through <literal>unstable</literal>;"
5103 "本当に <literal>testing-proposed-updates</literal> を通す必要があり、"
5104 "<literal>unstable</literal> ではダメなことを確認する;"
5106 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5107 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5109 msgid "Make sure that you included only the minimal amount of changes;"
5110 msgstr "必ず、最小限な量だけの変更を含めるようにする;"
5112 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5113 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5116 "Make sure that you included an appropriate explanation in the changelog;"
5117 msgstr "必ず changelog 中に適切な説明を含める;"
5119 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5120 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5123 "Make sure that you've written <literal>testing</literal> or <literal>testing-"
5124 "proposed-updates</literal> into your target distribution;"
5126 "必ず、対象とするディストリビューションとして <literal>testing</literal> か "
5127 "<literal>testing-proposed-updates</literal> を記述している;"
5129 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5130 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5133 "Make sure that you've built and tested your package in <literal>testing</"
5134 "literal>, not in <literal>unstable</literal>;"
5136 "必ず <literal>不安定版 (unstable)</literal> ではなく <literal>テスト版 "
5137 "(testing)</literal> でパッケージを構築・テストしている;"
5139 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5140 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5143 "Make sure that your version number is higher than the version in "
5144 "<literal>testing</literal> and <literal>testing-proposed-updates</literal>, "
5145 "and lower than in <literal>unstable</literal>;"
5147 "バージョン番号が <literal>testing</literal> および <literal>testing-proposed-"
5148 "updates</literal> のものよりも大きく、<literal>unstable</literal> のものより"
5151 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5152 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
5155 "After uploading and successful build on all platforms, contact the release "
5156 "team at &email-debian-release; and ask them to approve your upload."
5158 "アップロードしてすべてのプラットフォームで構築が成功したら、&email-debian-"
5159 "release; 宛でリリースチームに連絡を取って、アップロードを承認してくれるように"
5162 # type: Content of: <chapter><section><section><title>
5163 #. type: Content of: <chapter><section><section><title>
5165 msgid "Frequently asked questions"
5166 msgstr "よく聞かれる質問とその答え (FAQ)"
5168 # type: Content of: <chapter><section><section><section><title>
5169 #. type: Content of: <chapter><section><section><section><title>
5171 msgid "What are release-critical bugs, and how do they get counted?"
5172 msgstr "リリースクリティカルバグとは何ですか、どうやって数えるのですか?"
5174 # type: Content of: <chapter><section><section><section><para>
5175 #. type: Content of: <chapter><section><section><section><para>
5178 "All bugs of some higher severities are by default considered release-"
5179 "critical; currently, these are <literal>critical</literal>, <literal>grave</"
5180 "literal> and <literal>serious</literal> bugs."
5182 "ある重要度以上のバグすべてが通常リリースクリティカルであると見なされます。現"
5183 "在のところ、<literal>critical (致命的)</literal>、<literal>grave (重大)</"
5184 "literal>、<literal>serious (深刻)</literal> バグがそれにあたります。"
5186 #. type: Content of: <chapter><section><section><section><para>
5189 "Such bugs are presumed to have an impact on the chances that the package "
5190 "will be released with the <literal>stable</literal> release of Debian: in "
5191 "general, if a package has open release-critical bugs filed on it, it won't "
5192 "get into <literal>testing</literal>, and consequently won't be released in "
5193 "<literal>stable</literal>."
5195 "そのようなバグは、Debian の <literal>安定版 (stable)</literal> リリース時に、"
5196 "そのパッケージがリリースされる見込みに影響があるものと仮定されます: 一般的"
5197 "に、パッケージでオープンになっているリリースクリティカルバグがある場合、その"
5198 "パッケージは<literal>テスト版 (testing)</literal> に入らず、その結果<literal>"
5199 "安定版 (stable)</literal> ではリリースされません。"
5201 #. type: Content of: <chapter><section><section><section><para>
5204 "The <literal>unstable</literal> bug count are all release-critical bugs "
5205 "which are marked to apply to <replaceable>package</replaceable>/"
5206 "<replaceable>version</replaceable> combinations that are available in "
5207 "unstable for a release architecture. The <literal>testing</literal> bug "
5208 "count is defined analogously."
5210 "<literal>不安定版 (unstable)</literal> でのバグのカウント数は、リリース対象"
5211 "アーキテクチャの不安定版 (unstable) で利用可能な<replaceable>パッケージ</"
5212 "replaceable>/<replaceable>バージョン</replaceable>の組み合わせに適用されると"
5213 "マークされたすべてのリリースクリティカルバグです。<literal>テスト版 (testing)"
5214 "</literal> のバグのカウント数も同様に定義します。"
5216 # type: Content of: <chapter><section><section><section><title>
5217 #. type: Content of: <chapter><section><section><section><title>
5220 "How could installing a package into <literal>testing</literal> possibly "
5221 "break other packages?"
5223 "どのようにすれば、他のパッケージを壊す可能性があるパッケージを<literal>テスト"
5224 "版 (testing)</literal> へインストールできますか?"
5226 #. type: Content of: <chapter><section><section><section><para>
5229 "The structure of the distribution archives is such that they can only "
5230 "contain one version of a package; a package is defined by its name. So when "
5231 "the source package <literal>acmefoo</literal> is installed into "
5232 "<literal>testing</literal>, along with its binary packages <literal>acme-foo-"
5233 "bin</literal>, <literal>acme-bar-bin</literal>, <literal>libacme-foo1</"
5234 "literal> and <literal>libacme-foo-dev</literal>, the old version is removed."
5236 "ディストリビューションにおけるアーカイブの構造では、一つのバージョンのパッ"
5237 "ケージだけを持つことができ、パッケージは名前によって定義されています。そのた"
5238 "め、ソースパッケージ <literal>acmefoo</literal> が<literal>テスト版 (testing)"
5239 "</literal> にインストールされると、付随するバイナリパッケージ <literal>acme-"
5240 "foo-bin</literal>、<literal>acme-bar-bin</literal>、<literal>libacme-foo1</"
5241 "literal>、<literal>libacme-foo-dev</literal> の古いバージョンが削除されます。"
5243 # type: Content of: <chapter><section><section><section><para>
5244 #. type: Content of: <chapter><section><section><section><para>
5247 "However, the old version may have provided a binary package with an old "
5248 "soname of a library, such as <literal>libacme-foo0</literal>. Removing the "
5249 "old <literal>acmefoo</literal> will remove <literal>libacme-foo0</literal>, "
5250 "which will break any packages which depend on it."
5252 "しかし、古いバージョンではライブラリに古い soname を含んだ <literal>libacme-"
5253 "foo0</literal> のようなバイナリパッケージを提供しているかもしれません。古い "
5254 "<literal>acmefoo</literal> を削除するのは <literal>libacme-foo0</literal> を"
5255 "削除することになり、これに依存しているパッケージを壊してしまいます。"
5257 # type: Content of: <chapter><section><section><section><para>
5258 #. type: Content of: <chapter><section><section><section><para>
5261 "Evidently, this mainly affects packages which provide changing sets of "
5262 "binary packages in different versions (in turn, mainly libraries). However, "
5263 "it will also affect packages upon which versioned dependencies have been "
5264 "declared of the ==, <=, or << varieties."
5267 # type: Content of: <chapter><section><section><section><para>
5268 #. type: Content of: <chapter><section><section><section><para>
5271 "When the set of binary packages provided by a source package change in this "
5272 "way, all the packages that depended on the old binaries will have to be "
5273 "updated to depend on the new binaries instead. Because installing such a "
5274 "source package into <literal>testing</literal> breaks all the packages that "
5275 "depended on it in <literal>testing</literal>, some care has to be taken now: "
5276 "all the depending packages must be updated and ready to be installed "
5277 "themselves so that they won't be broken, and, once everything is ready, "
5278 "manual intervention by the release manager or an assistant is normally "
5282 # type: Content of: <chapter><section><section><section><para>
5283 #. type: Content of: <chapter><section><section><section><para>
5286 "If you are having problems with complicated groups of packages like this, "
5287 "contact &email-debian-devel; or &email-debian-release; for help."
5289 "この様に複雑な組み合わせのパッケージで問題がある場合は、&email-debian-devel; "
5290 "あるいは &email-debian-release; に連絡を取って手助けを求めてください。"
5293 #~ "If you want to see more details, you can look it up on <filename>merkel:/"
5294 #~ "org/&ftp-debian-org;/testing/update_out/</filename> (or in "
5295 #~ "<filename>merkel:~aba/testing/update_out</filename> to see a setup with a "
5296 #~ "smaller packages file). Via web, it's at <ulink url=\"http://&ftp-master-"
5297 #~ "host;/testing/update_out_code/\"></ulink>."
5299 #~ "より詳細を確認したい場合は、<filename>merkel:/org/&ftp-debian-org;/"
5300 #~ "testing/update_out/</filename> にあるのを参照できます (または、"
5301 #~ "<filename>merkel:~aba/testing/update_out</filename> でより小さなパッケージ"
5302 #~ "ファイルの設定が参照できます)。ウェブからの場合は、<ulink url=\"http://"
5303 #~ "&ftp-master-host;/testing/update_out_code/\"></ulink> にあります。"