chiark / gitweb /
POT and PO update (planned with Hideki).
[developers-reference.git] / po4a / ja / pkgs.po
1 # Debian Developer's Reference (Japanese)
2 # Hideki Yamane (Debian-JP) <henrich@debian.or.jp>, 2008-2010.
3 #
4 msgid ""
5 msgstr ""
6 "Project-Id-Version: developers-reference 3.4.4\n"
7 "POT-Creation-Date: 2010-06-20 09:23-0400\n"
8 "PO-Revision-Date: 2010-01-05 18:27+0900\n"
9 "Last-Translator: Hideki Yamane (Debian-JP) <henrich@debian.or.jp>\n"
10 "Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n"
11 "Language: \n"
12 "MIME-Version: 1.0\n"
13 "Content-Type: text/plain; charset=UTF-8\n"
14 "Content-Transfer-Encoding: 8bit\n"
15
16 # type: Content of: <chapter><title>
17 #. type: Content of: <chapter><title>
18 #: pkgs.dbk:7
19 msgid "Managing Packages"
20 msgstr "パッケージの取扱い方"
21
22 # type: Content of: <chapter><para>
23 #. type: Content of: <chapter><para>
24 #: pkgs.dbk:9
25 msgid ""
26 "This chapter contains information related to creating, uploading, "
27 "maintaining, and porting packages."
28 msgstr ""
29 "この章では、パッケージの作成、アップロード、メンテナンス、移植についての情報"
30 "を扱います。"
31
32 # type: Content of: <chapter><section><title>
33 #. type: Content of: <chapter><section><title>
34 #: pkgs.dbk:13
35 msgid "New packages"
36 msgstr "新規パッケージ"
37
38 # type: Content of: <chapter><section><para>
39 #. type: Content of: <chapter><section><para>
40 #: pkgs.dbk:15
41 msgid ""
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 "
47 "more information."
48 msgstr ""
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> を読んでください。"
55
56 # type: Content of: <chapter><section><para>
57 # FIXME: "but not limiting yourself to"?
58 #. type: Content of: <chapter><section><para>
59 #: pkgs.dbk:23
60 msgid ""
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."
67 msgstr ""
68 "パッケージ化しようとしているソフトについて誰もまだ作業していないようであれ"
69 "ば、まずは <systemitem role=\"package\">wnpp</systemitem> 擬似パッケージ "
70 "(pseudo-package) に対してバグ報告を投稿する必要があります (<xref linkend="
71 "\"submit-bug\"/>)。このバグ報告には、新規パッケージの作成予定や、パッケージの"
72 "説明 (自分自身が分かるだけではないもの)、作業しようとしているパッケージのライ"
73 "センス、ダウンロードが可能な現在の URL を含めます。"
74
75 # type: Content of: <chapter><section><para>
76 #. type: Content of: <chapter><section><para>
77 #: pkgs.dbk:31
78 #, fuzzy
79 msgid ""
80 "You should set the subject of the bug to <literal>ITP: <replaceable>foo</"
81 "replaceable> -- <replaceable>short description</replaceable></literal>, "
82 "substituting the name of the new package for <replaceable>foo</"
83 "replaceable>.  The severity of the bug report must be set to "
84 "<literal>wishlist</literal>.  Please send a copy to &email-debian-devel; by "
85 "using the X-Debbugs-CC header (don't use CC:, because that way the message's "
86 "subject won't indicate the bug number). If you are packaging so many new "
87 "packages (>10)  that notifying the mailing list in separate messages is too "
88 "disruptive, send a summary after filing the bugs to the debian-devel list "
89 "instead.  This will inform the other developers about upcoming packages and "
90 "will allow a review of your description and package name."
91 msgstr ""
92 "サブジェクトを <literal>ITP: <replaceable>foo</replaceable> -- "
93 "<replaceable>short description</replaceable></literal> に設定する必要がありま"
94 "す。ここでは <replaceable>foo</replaceable> は新規パッケージの名前に置き換え"
95 "ます。バグ報告の重要度は <literal>wishlist</literal> に設定しなければなりませ"
96 "ん。X-Debbugs-CC ヘッダを使ってコピーを &email-debian-devel; に送信してくださ"
97 "い (CC: は使わないでください。CC: を使った場合はメールのサブジェクトがバグ番"
98 "号を表示しないためです)。大量の新規パッケージの作成 (11 個以上) を行っている"
99 "場合、メーリングリストへ個別に通知するのは鬱陶しいので、代わりにバグを登録し"
100 "た後で要約を送信してください。これによって、他の開発者らに次に来るパッケージ"
101 "を知らせ、説明とパッケージ名のレビューが可能になります。"
102
103 # type: Content of: <chapter><section><para>
104 #. type: Content of: <chapter><section><para>
105 #: pkgs.dbk:45
106 msgid ""
107 "Please include a <literal>Closes: #<replaceable>nnnnn</replaceable></"
108 "literal> entry in the changelog of the new package in order for the bug "
109 "report to be automatically closed once the new package is installed in the "
110 "archive (see <xref linkend=\"upload-bugfix\"/>)."
111 msgstr ""
112 "新規パッケージがアーカイブへインストールされる際にバグ報告を自動的に閉じるた"
113 "め、<literal>Closes: #<replaceable>nnnnn</replaceable></literal> というエント"
114 "リを新規パッケージの changelog 内に含めてください (<xref linkend=\"upload-"
115 "bugfix\"/> を参照)。"
116
117 # FIXME: ftpmaster@debian.org
118 #. type: Content of: <chapter><section><para>
119 #: pkgs.dbk:51
120 msgid ""
121 "If you think your package needs some explanations for the administrators of "
122 "the NEW package queue, include them in your changelog, send to &email-"
123 "ftpmaster; a reply to the email you receive as a maintainer after your "
124 "upload, or reply to the rejection email in case you are already re-uploading."
125 msgstr ""
126 "パッケージについて、NEW パッケージキューの管理者への説明が必要だろうと思う場"
127 "合は、アップロード後にメンテナとして受け取るメールへの返信、あるいは既に再"
128 "アップロードという場合は reject のメールに対しての返信として、説明を "
129 "changelog に含めて &email-ftpmaster; へ送ってください。"
130
131 # type: Content of: <chapter><section><para>
132 #. type: Content of: <chapter><section><para>
133 #: pkgs.dbk:57
134 msgid ""
135 "When closing security bugs include CVE numbers as well as the "
136 "<literal>Closes: #<replaceable>nnnnn</replaceable></literal>.  This is "
137 "useful for the security team to track vulnerabilities.  If an upload is made "
138 "to fix the bug before the advisory ID is known, it is encouraged to modify "
139 "the historical changelog entry with the next upload.  Even in this case, "
140 "please include all available pointers to background information in the "
141 "original changelog entry."
142 msgstr ""
143 "セキュリティバグを閉じる場合は、CVE 番号を <literal>Closes: "
144 "#<replaceable>nnnnn</replaceable></literal> と同じく含めるようにしてくださ"
145 "い。これは、セキュリティチームが脆弱性を追跡するのに役立ちます。アドバイザリ"
146 "の ID が分かる前にバグ修正のためのアップロードが行われた場合は、以前の "
147 "changelog エントリを次のアップロード時に修正するのが推奨されています。このよ"
148 "うな場合でも、元々の changelog での記載に、可能な限り背景情報へのポインタを全"
149 "て含めてください。"
150
151 # type: Content of: <chapter><section><para>
152 #. type: Content of: <chapter><section><para>
153 #: pkgs.dbk:66
154 msgid ""
155 "There are a number of reasons why we ask maintainers to announce their "
156 "intentions:"
157 msgstr ""
158 "我々がメンテナにその意図をアナウンスする様に求めるのには、いくつもの理由があ"
159 "ります。"
160
161 # type: Content of: <chapter><section><itemizedlist><listitem><para>
162 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
163 #: pkgs.dbk:72
164 msgid ""
165 "It helps the (potentially new) maintainer to tap into the experience of "
166 "people on the list, and lets them know if anyone else is working on it "
167 "already."
168 msgstr ""
169 "(潜在的な新たな) メンテナが、メーリングリストの人々の経験を活かすのを手助け"
170 "し、もし他の誰かが既に作業を行っていた場合に知らせる。"
171
172 # type: Content of: <chapter><section><itemizedlist><listitem><para>
173 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
174 #: pkgs.dbk:78
175 msgid ""
176 "It lets other people thinking about working on the package know that there "
177 "already is a volunteer, so efforts may be shared."
178 msgstr ""
179 "そのパッケージについて作業することを検討している他の人へ、既に作業をしている"
180 "ボランティアがいることを知らせ、労力が共有される。"
181
182 # type: Content of: <chapter><section><itemizedlist><listitem><para>
183 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
184 #: pkgs.dbk:84
185 msgid ""
186 "It lets the rest of the maintainers know more about the package than the one "
187 "line description and the usual changelog entry ``Initial release'' that gets "
188 "posted to &email-debian-devel-changes;."
189 msgstr ""
190 "&email-debian-devel-changes; に流される一行の説明文 (description) と通常どお"
191 "りの「Intial release」という changelog エントリよりも、残った他のメンテナが"
192 "パッケージに関してより深く知ることができる。"
193
194 # type: Content of: <chapter><section><itemizedlist><listitem><para>
195 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
196 #: pkgs.dbk:91
197 msgid ""
198 "It is helpful to the people who live off <literal>unstable</literal> (and "
199 "form our first line of testers).  We should encourage these people."
200 msgstr ""
201 "<literal>不安定版 (unstable)</literal> で暮らす人 (そして最前線のテスターであ"
202 "る人) の助けになる。"
203
204 # type: Content of: <chapter><section><itemizedlist><listitem><para>
205 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
206 #: pkgs.dbk:97
207 msgid ""
208 "The announcements give maintainers and other interested parties a better "
209 "feel of what is going on, and what is new, in the project."
210 msgstr ""
211 "メンテナや他に興味を持つ人々へ、プロジェクトで何が行われているのか、何か新し"
212 "いことがあるかということ関して、告知は良い印象を与える。"
213
214 # type: Content of: <chapter><section><para>
215 #. type: Content of: <chapter><section><para>
216 #: pkgs.dbk:103
217 msgid ""
218 "Please see <ulink url=\"http://&ftp-master-host;/REJECT-FAQ.html\"></ulink> "
219 "for common rejection reasons for a new package."
220 msgstr ""
221 "新しいパッケージに対する一般的な拒否理由については <ulink url=\"http://&ftp-"
222 "master-host;/REJECT-FAQ.html\"></ulink> を参照してください。"
223
224 # type: Content of: <chapter><section><title>
225 #. type: Content of: <chapter><section><title>
226 #: pkgs.dbk:109
227 msgid "Recording changes in the package"
228 msgstr "パッケージの変更を記録する"
229
230 # type: Content of: <chapter><section><para>
231 #. type: Content of: <chapter><section><para>
232 #: pkgs.dbk:111
233 msgid ""
234 "Changes that you make to the package need to be recorded in the "
235 "<filename>debian/changelog</filename>.  These changes should provide a "
236 "concise description of what was changed, why (if it's in doubt), and note if "
237 "any bugs were closed.  They also record when the package was completed.  "
238 "This file will be installed in <filename>/usr/share/doc/"
239 "<replaceable>package</replaceable>/changelog.Debian.gz</filename>, or "
240 "<filename>/usr/share/doc/<replaceable>package</replaceable>/changelog.gz</"
241 "filename> for native packages."
242 msgstr ""
243 "パッケージについて行った変更は <filename>debian/changelog</filename> に記録さ"
244 "れる必要があります。これらの変更には、何が変更されたのか、(疑問であれば) 何故"
245 "なのか、そしてどのバグが完了されたのかの簡潔な説明文を付加する必要がありま"
246 "す。"
247
248 # type: Content of: <chapter><section><para>
249 #. type: Content of: <chapter><section><para>
250 #: pkgs.dbk:122
251 #, fuzzy
252 msgid ""
253 "The <filename>debian/changelog</filename> file conforms to a certain "
254 "structure, with a number of different fields.  One field of note, the "
255 "<literal>distribution</literal>, is described in <xref linkend=\"distribution"
256 "\"/>.  More information about the structure of this file can be found in the "
257 "Debian Policy section titled <filename>debian/changelog</filename>."
258 msgstr ""
259 "<filename>debian/changelog</filename> ファイルは、幾つもの異なった項目からな"
260 "る特定の構造に従っています。文書のとある項目、<literal>distribution</"
261 "literal> については<xref linkend=\"distribution\"/>に記述されています。この"
262 "ファイルの構造について、より詳細な情報は Debian ポリシーの <filename>debian/"
263 "changelog</filename> という章で確認できます。"
264
265 # type: Content of: <chapter><section><para>
266 #. type: Content of: <chapter><section><para>
267 #: pkgs.dbk:130
268 msgid ""
269 "Changelog entries can be used to automatically close Debian bugs when the "
270 "package is installed into the archive.  See <xref linkend=\"upload-bugfix\"/"
271 ">."
272 msgstr ""
273 "changelog への記載は、パッケージがアーカイブにインストールされる際、自動的に "
274 "Debian バグを閉じるのに利用できます。<xref linkend=\"upload-bugfix\"/> を参照"
275 "してください。"
276
277 # type: Content of: <chapter><section><para>
278 #. type: Content of: <chapter><section><para>
279 #: pkgs.dbk:134
280 msgid ""
281 "It is conventional that the changelog entry of a package that contains a new "
282 "upstream version of the software looks like this:"
283 msgstr ""
284 "ソフトウェアの新しい開発元のバージョン (new upstream version) を含むパッケー"
285 "ジの changelog エントリは、以下のようにするのが慣習です:"
286
287 # type: Content of: <chapter><section><screen>
288 #. type: Content of: <chapter><section><screen>
289 #: pkgs.dbk:138
290 #, no-wrap
291 msgid "  * New upstream release.\n"
292 msgstr "  * New upstream release.\n"
293
294 # type: Content of: <chapter><section><para>
295 #. type: Content of: <chapter><section><para>
296 #: pkgs.dbk:141
297 msgid ""
298 "There are tools to help you create entries and finalize the "
299 "<filename>changelog</filename> for release — see <xref linkend=\"devscripts"
300 "\"/> and <xref linkend=\"dpkg-dev-el\"/>."
301 msgstr ""
302 "<filename>changelog</filename> エントリの作成と仕上げ処理に使えるツールがあり"
303 "ます。<xref linkend=\"devscripts\"/> と <xref linkend=\"dpkg-dev-el\"/> を参"
304 "照してください。"
305
306 # type: Content of: <chapter><section><para>
307 #. type: Content of: <chapter><section><para>
308 #: pkgs.dbk:146
309 msgid "See also <xref linkend=\"bpp-debian-changelog\"/>."
310 msgstr "<xref linkend=\"bpp-debian-changelog\"/> も参照してください。"
311
312 # type: Content of: <chapter><section><title>
313 #. type: Content of: <chapter><section><title>
314 #: pkgs.dbk:151
315 msgid "Testing the package"
316 msgstr "パッケージをテストする"
317
318 # type: Content of: <chapter><section><para>
319 # FIXME: around
320 #. type: Content of: <chapter><section><para>
321 #: pkgs.dbk:153
322 msgid ""
323 "Before you upload your package, you should do basic testing on it.  At a "
324 "minimum, you should try the following activities (you'll need to have an "
325 "older version of the same Debian package around):"
326 msgstr ""
327 "パッケージをアップロードする前に、基本的なテストをする必要があります。最低"
328 "限、以下の作業が必要です (同じ Debian パッケージの古いバージョンなどが必要に"
329 "なるでしょう):"
330
331 # type: Content of: <chapter><section><itemizedlist><listitem><para>
332 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
333 #: pkgs.dbk:160
334 msgid ""
335 "Install the package and make sure the software works, or upgrade the package "
336 "from an older version to your new version if a Debian package for it already "
337 "exists."
338 msgstr ""
339 "パッケージをインストールしてソフトウェアが動作するのを確認する、あるいは既に"
340 "そのソフトの Debian パッケージが存在している場合、パッケージを以前のバージョ"
341 "ンから新しいバージョンにアップグレードする。"
342
343 # type: Content of: <chapter><section><itemizedlist><listitem><para>
344 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
345 #: pkgs.dbk:167
346 msgid ""
347 "Run <command>lintian</command> over the package.  You can run "
348 "<command>lintian</command> as follows: <literal>lintian -v "
349 "<replaceable>package-version</replaceable>.changes</literal>.  This will "
350 "check the source package as well as the binary package.  If you don't "
351 "understand the output that <command>lintian</command> generates, try adding "
352 "the <literal>-i</literal> switch, which will cause <command>lintian</"
353 "command> to output a very verbose description of the problem."
354 msgstr ""
355 "パッケージに対して <command>lintian</command> を実行する。以下のようにして "
356 "<command>lintian</command> を実行できます: <literal>lintian -v "
357 "<replaceable>package-version</replaceable>.changes</literal> 。"
358 "<command>lintian</command> が生成した出力を理解していない場合は、"
359 "<command>lintian</command> が問題の説明を非常に冗長に出力するようにする "
360 "<literal>-i</literal> オプションを付けて実行してみてください。"
361
362 # type: Content of: <chapter><section><itemizedlist><listitem><para>
363 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
364 #: pkgs.dbk:176
365 msgid ""
366 "Normally, a package should <emphasis>not</emphasis> be uploaded if it causes "
367 "lintian to emit errors (they will start with <literal>E</literal>)."
368 msgstr ""
369 "通常、lintian がエラーを出力するようであれば、パッケージをアップロードしては"
370 "<emphasis>いけません</emphasis> (エラーは <literal>E</literal> で始まりま"
371 "す)。"
372
373 # type: Content of: <chapter><section><itemizedlist><listitem><para>
374 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
375 #: pkgs.dbk:180
376 msgid ""
377 "For more information on <command>lintian</command>, see <xref linkend="
378 "\"lintian\"/>."
379 msgstr ""
380 "<command>lintian</command> についての詳細は、<xref linkend=\"lintian\"/> を参"
381 "照してください。"
382
383 # type: Content of: <chapter><section><itemizedlist><listitem><para>
384 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
385 #: pkgs.dbk:186
386 #, fuzzy
387 msgid ""
388 "Optionally run <command>debdiff</command> (see <xref linkend=\"debdiff\"/>) "
389 "to analyze changes from an older version, if one exists."
390 msgstr ""
391 "もし古いバージョンがあれば、それからの変更点を分析するために追加で <xref "
392 "linkend=\"debdiff\"/> を実行する。"
393
394 # type: Content of: <chapter><section><itemizedlist><listitem><para>
395 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
396 #: pkgs.dbk:192
397 msgid ""
398 "Downgrade the package to the previous version (if one exists) — this tests "
399 "the <filename>postrm</filename> and <filename>prerm</filename> scripts."
400 msgstr ""
401 "(もしあれば) 以前のバージョンにダウングレードする — これは <filename>postrm</"
402 "filename> スクリプトと <filename>prerm</filename> スクリプトをテストします。"
403
404 # type: Content of: <chapter><section><itemizedlist><listitem><para>
405 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
406 #: pkgs.dbk:198
407 msgid "Remove the package, then reinstall it."
408 msgstr "パッケージを削除して、再インストールする。"
409
410 # type: Content of: <chapter><section><itemizedlist><listitem><para>
411 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
412 #: pkgs.dbk:203
413 msgid ""
414 "Copy the source package in a different directory and try unpacking it and "
415 "rebuilding it.  This tests if the package relies on existing files outside "
416 "of it, or if it relies on permissions being preserved on the files shipped "
417 "inside the <filename>.diff.gz</filename> file."
418 msgstr ""
419 "ソースパッケージを違うディレクトリにコピーして展開し、再構築する。これは、"
420 "パッケージが外部の既存ファイルに依っているか、<filename>.diff.gz</filename> "
421 "ファイル内に含まれているファイルで保存されている権限に依るかどうかをテストし"
422 "ます。"
423
424 # type: Content of: <chapter><section><title>
425 #. type: Content of: <chapter><section><title>
426 #: pkgs.dbk:213
427 msgid "Layout of the source package"
428 msgstr "ソースパッケージの概要"
429
430 # type: Content of: <chapter><section><para>
431 #. type: Content of: <chapter><section><para>
432 #: pkgs.dbk:215
433 msgid "There are two types of Debian source packages:"
434 msgstr "Debian のソースパッケージには 2 種類あります:"
435
436 # type: Content of: <chapter><section><itemizedlist><listitem><para>
437 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
438 #: pkgs.dbk:220
439 msgid ""
440 "the so-called <literal>native</literal> packages, where there is no "
441 "distinction between the original sources and the patches applied for Debian"
442 msgstr ""
443 "いわゆる <literal>native</literal>パッケージ。元のソースと Debian で当てられ"
444 "たパッチの間に差が無いもの"
445
446 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
447 #: pkgs.dbk:226
448 msgid ""
449 "the (more common) packages where there's an original source tarball file "
450 "accompanied by another file that contains the changes made by Debian"
451 msgstr ""
452 "オリジナルのソースコードの tarball ファイルに、Debian によって作成された変更"
453 "点を含む別のファイルが付随している (より一般的な) パッケージ"
454
455 # FIXME: control ファイル?コントロールファイル?
456 #. type: Content of: <chapter><section><para>
457 #: pkgs.dbk:232
458 #, fuzzy
459 msgid ""
460 "For the native packages, the source package includes a Debian source control "
461 "file (<filename>.dsc</filename>) and the source tarball (<filename>.tar.{gz,"
462 "bz2,lzma}</filename>). A source package of a non-native package includes a "
463 "Debian source control file, the original source tarball (<filename>.orig.tar."
464 "{gz,bz2,lzma}</filename>) and the Debian changes (<filename>.diff.gz</"
465 "filename> for the source format “1.0” or <filename>.debian.tar.{gz,bz2,lzma}"
466 "</filename> for the source format “3.0 (quilt)”)."
467 msgstr ""
468 "native パッケージの場合、ソースパッケージは Debian のソース control ファイル "
469 "(<filename>.dsc</filename>) とソースコードの tarball (<filename>.tar.{gz,bz2,"
470 "lzma}</filename>) を含んでいます。native ではないパッケージのソースパッケージ"
471 "は Debian のソース control ファイルと、オリジナルのソースコードの tarball "
472 "(<filename>.orig.tar.{gz,bz2,lzma}</filename>)、そして Debian での変更点 "
473 "(ソース形式“1.0”は <filename>.diff.gz</filename>、ソース形式“3.0 (quilt)”は "
474 "<filename>.debian.tar.{gz,bz2,lzma}</filename>) を含んでいます。"
475
476 #. type: Content of: <chapter><section><para>
477 #: pkgs.dbk:241
478 #, fuzzy
479 msgid ""
480 "With source format “1.0”, whether a package is native or not was determined "
481 "by <command>dpkg-source</command> at build time. Nowadays it is recommended "
482 "to be explicit about the desired source format by putting either “3.0 "
483 "(quilt)” or “3.0 (native)” in <filename>debian/source/format</filename>.  "
484 "The rest of this section relates only to non-native packages."
485 msgstr ""
486 "ソース形式“1.0”では、パッケージが native かどうかはビルド時に <command>dpkg-"
487 "source</command> によって決められていました。最近では望むソース形式を "
488 "<filename>debian/source/format</filename> に“3.0 (quilt)”または“3.0 "
489 "(native)”と記述することによって明示することが推奨されています。この章の残り"
490 "は native ではないパッケージについてのみに関係しています。"
491
492 # type: Content of: <chapter><section><para>
493 #. type: Content of: <chapter><section><para>
494 #: pkgs.dbk:248
495 msgid ""
496 "The first time a version is uploaded which corresponds to a particular "
497 "upstream version, the original source tar file should be uploaded and "
498 "included in the <filename>.changes</filename> file.  Subsequently, this very "
499 "same tar file should be used to build the new diffs and <filename>.dsc</"
500 "filename> files, and will not need to be re-uploaded."
501 msgstr ""
502
503 #. type: Content of: <chapter><section><para>
504 #: pkgs.dbk:255
505 #, fuzzy
506 msgid ""
507 "By default, <command>dpkg-genchanges</command> and <command>dpkg-"
508 "buildpackage</command> will include the original source tar file if and only "
509 "if the current changelog entry has a different upstream version from the "
510 "preceding entry. This behavior may be modified by using <literal>-sa</"
511 "literal> to always include it or <literal>-sd</literal> to always leave it "
512 "out."
513 msgstr ""
514 "デフォルトで、<command>dpkg-genchanges</command> および <command>dpkg-"
515 "buildpackage</command> この挙動は、常に含めるのに <literal>-sa</literal> を常"
516 "に含めないのには <literal>-sd</literal> を使うことで"
517
518 # type: Content of: <chapter><section><para>
519 #. type: Content of: <chapter><section><para>
520 #: pkgs.dbk:263
521 #, fuzzy
522 msgid ""
523 "If no original source is included in the upload, the original source tar-"
524 "file used by <command>dpkg-source</command> when constructing the <filename>."
525 "dsc</filename> file and diff to be uploaded <emphasis>must</emphasis> be "
526 "byte-for-byte identical with the one already in the archive."
527 msgstr ""
528 "アップロード時にオリジナルのソースが含まれていない場合、アップロードされる "
529 "<filename>.dsc</filename> と diff ファイルを構築する際に <command>dpkg-"
530 "source</command> が使用するオリジナルの tar ファイルは、<emphasis>必ず</"
531 "empashis>既にアーカイブにあるものと 1 バイトも変わらぬものでなくてはなりませ"
532 "ん。"
533
534 #. type: Content of: <chapter><section><para>
535 #: pkgs.dbk:270
536 msgid ""
537 "Please notice that, in non-native packages, permissions on files that are "
538 "not present in the <filename>*.orig.tar.{gz,bz2,lzma}</filename> will not be "
539 "preserved, as diff does not store file permissions in the patch. However "
540 "when using source format “3.0 (quilt)”, permissions of files inside the "
541 "<filename>debian</filename> directory are preserved since they are stored in "
542 "a tar archive."
543 msgstr ""
544
545 # type: Content of: <chapter><section><title>
546 #. type: Content of: <chapter><section><title>
547 #: pkgs.dbk:279
548 msgid "Picking a distribution"
549 msgstr "ディストリビューションを選ぶ"
550
551 # type: Content of: <chapter><section><para>
552 #. type: Content of: <chapter><section><para>
553 #: pkgs.dbk:281
554 msgid ""
555 "Each upload needs to specify which distribution the package is intended "
556 "for.  The package build process extracts this information from the first "
557 "line of the <filename>debian/changelog</filename> file and places it in the "
558 "<literal>Distribution</literal> field of the <filename>.changes</filename> "
559 "file."
560 msgstr ""
561 "アップロードでは、パッケージがどのディストリビューション向けになっているかを"
562 "指定してあることが必要です。パッケージの構築プロセスでは、<filename>debian/"
563 "changelog</filename> ファイルの最初の行からこの情報を展開し、<filename>."
564 "changes</filename> ファイルの <literal>Distribution</literal> 欄に配置しま"
565 "す。"
566
567 # type: Content of: <chapter><section><para>
568 #. type: Content of: <chapter><section><para>
569 #: pkgs.dbk:287
570 msgid ""
571 "There are several possible values for this field: <literal>stable</literal>, "
572 "<literal>unstable</literal>, <literal>testing-proposed-updates</literal> and "
573 "<literal>experimental</literal>.  Normally, packages are uploaded into "
574 "<literal>unstable</literal>."
575 msgstr ""
576 "この欄にはいくつか指定可能な値があります: <literal>stable</literal>、"
577 "<literal>unstable</literal>、<literal>testing-proposed-updates</literal>、そ"
578 "して <literal>experimental</literal> です。通常、パッケージは "
579 "<literal>unstable</literal> にアップロードされます。"
580
581 # type: Content of: <chapter><section><para>
582 #. type: Content of: <chapter><section><para>
583 #: pkgs.dbk:293
584 msgid ""
585 "Actually, there are two other possible distributions: <literal>stable-"
586 "security</literal> and <literal>testing-security</literal>, but read <xref "
587 "linkend=\"bug-security\"/> for more information on those."
588 msgstr ""
589 "実際には、他に二つ指定可能なディストリビューションがあります: "
590 "<literal>stable-security</literal> と <literal>testing-security</literal> で"
591 "すが、これらについての詳細は <xref linkend=\"bug-security\"/> を読んでくださ"
592 "い。"
593
594 # type: Content of: <chapter><section><para>
595 #. type: Content of: <chapter><section><para>
596 #: pkgs.dbk:298
597 msgid ""
598 "It is not possible to upload a package into several distributions at the "
599 "same time."
600 msgstr ""
601 "同時に複数のディストリビューションへパッケージをアップロードすることはできま"
602 "せん。"
603
604 # type: Content of: <chapter><section><section><title>
605 #. type: Content of: <chapter><section><section><title>
606 #: pkgs.dbk:302
607 msgid ""
608 "Special case: uploads to the <literal>stable</literal> and "
609 "<literal>oldstable</literal> distributions"
610 msgstr ""
611 "特別な例: <literal>安定版 (stable)</literal> と <literal>旧安定版 (oldstable)"
612 "</literal> ディストリビューションへアップロードする"
613
614 #. type: Content of: <chapter><section><section><para>
615 #: pkgs.dbk:305
616 msgid ""
617 "Uploading to <literal>stable</literal> means that the package will "
618 "transferred to the <literal>proposed-updates-new</literal> queue for review "
619 "by the stable release managers, and if approved will be installed in "
620 "<filename>stable-proposed-updates</filename> directory of the Debian "
621 "archive.  From there, it will be included in <literal>stable</literal> with "
622 "the next point release."
623 msgstr ""
624 "<literal>安定版 (stable)</literal> へのアップロードは、安定版リリースマネー"
625 "ジャによるレビューのため、パッケージが <literal>proposed-updates-new</"
626 "literal> キューに転送され、許可された場合は Debian アーカイブの "
627 "<filename>stable-proposed-updates</filename> ディレクトリにインストールされま"
628 "す。"
629
630 # type: Content of: <chapter><section><section><para>
631 #. type: Content of: <chapter><section><section><para>
632 #: pkgs.dbk:313
633 #, fuzzy
634 msgid ""
635 "To ensure that your upload will be accepted, you should discuss the changes "
636 "with the stable release team before you upload. For that, send a mail to the "
637 "&email-debian-release; mailing list, including the patch you want to apply "
638 "to the package version currently in <literal>stable</literal>. Always be "
639 "verbose and detailed in your changelog entries for uploads to the "
640 "<literal>stable</literal> distribution."
641 msgstr ""
642 "アップロードが許可されるのを確実にするには、アップロードの前に変更点について"
643 "安定版リリースチームと協議する必要があります。そのためには、<literal>安定版 "
644 "(stable)</literal> にある現在のパッケージバージョンに適用したいパッチを含めた"
645 "メールを &email-debian-release; メーリングリストに送ってください。<literal>安"
646 "定版 (stable)</literal> ディストリビューションへアップロードするパッケージの "
647 "changelog のエントリには常に verbose で詳細にしてください。"
648
649 # type: Content of: <chapter><section><section><para>
650 #. type: Content of: <chapter><section><section><para>
651 #: pkgs.dbk:321
652 msgid ""
653 "Extra care should be taken when uploading to <literal>stable</literal>.  "
654 "Basically, a package should only be uploaded to <literal>stable</literal> if "
655 "one of the following happens:"
656 msgstr ""
657
658 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
659 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
660 #: pkgs.dbk:328
661 msgid "a truly critical functionality problem"
662 msgstr "本当に致命的な機能への問題がある"
663
664 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
665 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
666 #: pkgs.dbk:333
667 msgid "the package becomes uninstallable"
668 msgstr "パッケージがインストールできなくなる"
669
670 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
671 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
672 #: pkgs.dbk:338
673 msgid "a released architecture lacks the package"
674 msgstr "リリースされたアーキテクチャにパッケージが無い"
675
676 # type: Content of: <chapter><section><section><para>
677 #. type: Content of: <chapter><section><section><para>
678 #: pkgs.dbk:343
679 msgid ""
680 "In the past, uploads to <literal>stable</literal> were used to address "
681 "security problems as well.  However, this practice is deprecated, as uploads "
682 "used for Debian security advisories are automatically copied to the "
683 "appropriate <filename>proposed-updates</filename> archive when the advisory "
684 "is released.  See <xref linkend=\"bug-security\"/> for detailed information "
685 "on handling security problems. If the security teams deems the problem to be "
686 "too benign to be fixed through a <literal>DSA</literal>, the stable release "
687 "managers are usually willing to include your fix nonetheless in a regular "
688 "upload to <literal>stable</literal>."
689 msgstr ""
690
691 # type: Content of: <chapter><section><section><para>
692 #. type: Content of: <chapter><section><section><para>
693 #: pkgs.dbk:354
694 msgid ""
695 "Changing anything else in the package that isn't important is discouraged, "
696 "because even trivial fixes can cause bugs later on."
697 msgstr ""
698
699 #. type: Content of: <chapter><section><section><para>
700 #: pkgs.dbk:358
701 msgid ""
702 "Packages uploaded to <literal>stable</literal> need to be compiled on "
703 "systems running <literal>stable</literal>, so that their dependencies are "
704 "limited to the libraries (and other packages) available in <literal>stable</"
705 "literal>; for example, a package uploaded to <literal>stable</literal> that "
706 "depends on a library package that only exists in <literal>unstable</literal> "
707 "will be rejected.  Making changes to dependencies of other packages (by "
708 "messing with <literal>Provides</literal> or <filename>shlibs</filename> "
709 "files), possibly making those other packages uninstallable, is strongly "
710 "discouraged."
711 msgstr ""
712
713 #. type: Content of: <chapter><section><section><para>
714 #: pkgs.dbk:368
715 msgid ""
716 "Uploads to the <literal>oldstable</literal> distributions are possible as "
717 "long as it hasn't been archived. The same rules as for <literal>stable</"
718 "literal> apply."
719 msgstr ""
720
721 # type: Content of: <chapter><section><section><title>
722 #. type: Content of: <chapter><section><section><title>
723 #: pkgs.dbk:375
724 msgid ""
725 "Special case: uploads to <literal>testing/testing-proposed-updates</literal>"
726 msgstr ""
727 "特別な例: <literal>testing/testing-proposed-updates</literal> へアップロード"
728 "する"
729
730 # type: Content of: <chapter><section><section><para>
731 #. type: Content of: <chapter><section><section><para>
732 #: pkgs.dbk:377
733 msgid ""
734 "Please see the information in the <link linkend=\"t-p-u\">testing section</"
735 "link> for details."
736 msgstr ""
737 "詳細については、<link linkend=\"t-p-u\">testing section</link> にある情報を参"
738 "照してください。"
739
740 # type: Content of: <chapter><section><title>
741 #. type: Content of: <chapter><section><title>
742 #: pkgs.dbk:385
743 msgid "Uploading a package"
744 msgstr "パッケージをアップロードする"
745
746 # type: Content of: <chapter><section><section><title>
747 #. type: Content of: <chapter><section><section><title>
748 #: pkgs.dbk:387
749 msgid "Uploading to <literal>ftp-master</literal>"
750 msgstr "<literal>ftp-master</literal> にアップロードする"
751
752 #. type: Content of: <chapter><section><section><para>
753 #: pkgs.dbk:389
754 msgid ""
755 "To upload a package, you should upload the files (including the signed "
756 "changes and dsc-file) with anonymous ftp to <literal>&ftp-upload-host;</"
757 "literal> in the directory <ulink url=\"ftp://&ftp-upload-host;&upload-queue;"
758 "\">&upload-queue;</ulink>.  To get the files processed there, they need to "
759 "be signed with a key in the Debian Developers keyring or the Debian "
760 "Maintainers keyring (see <ulink url=\"&url-wiki-dm;\"></ulink>)."
761 msgstr ""
762
763 # type: Content of: <chapter><section><section><para>
764 #. type: Content of: <chapter><section><section><para>
765 #: pkgs.dbk:398
766 msgid ""
767 "Please note that you should transfer the changes file last.  Otherwise, your "
768 "upload may be rejected because the archive maintenance software will parse "
769 "the changes file and see that not all files have been uploaded."
770 msgstr ""
771
772 #. type: Content of: <chapter><section><section><para>
773 #: pkgs.dbk:403
774 msgid ""
775 "You may also find the Debian packages <link linkend=\"dupload\">dupload</"
776 "link> or <link linkend=\"dput\">dput</link> useful when uploading packages."
777 "These handy programs help automate the process of uploading packages into "
778 "Debian."
779 msgstr ""
780
781 #. type: Content of: <chapter><section><section><para>
782 #: pkgs.dbk:408
783 msgid ""
784 "For removing packages, please see <ulink url=\"ftp://&ftp-upload-host;"
785 "&upload-queue;README\"/> and the Debian package <link linkend=\"dcut\">dcut</"
786 "link>."
787 msgstr ""
788
789 # type: Content of: <chapter><section><section><title>
790 #. type: Content of: <chapter><section><section><title>
791 #: pkgs.dbk:415
792 msgid "Delayed uploads"
793 msgstr "遅延アップロード"
794
795 #. type: Content of: <chapter><section><section><para>
796 #: pkgs.dbk:418
797 msgid ""
798 "It is sometimes useful to upload a package immediately, but to want this "
799 "package to arrive in the archive only a few days later. For example, when "
800 "preparing a <link linkend=\"nmu\">Non-Maintainer Upload</link>, you might "
801 "want to give the maintainer a few days to react."
802 msgstr ""
803
804 #. type: Content of: <chapter><section><section><para>
805 #: pkgs.dbk:425
806 msgid ""
807 "An upload to the delayed directory keeps the package in <ulink url=\"http://"
808 "ftp-master.debian.org/deferred.html\">the deferred uploads queue</ulink>.  "
809 "When the specified waiting time is over, the package is moved into the "
810 "regular incoming directory for processing.  This is done through automatic "
811 "uploading to <literal>&ftp-upload-host;</literal> in upload-directory "
812 "<literal>DELAYED/[012345678]-day</literal>. 0-day is uploaded multiple times "
813 "per day to <literal>&ftp-upload-host;</literal>."
814 msgstr ""
815
816 #. type: Content of: <chapter><section><section><para>
817 #: pkgs.dbk:435
818 msgid ""
819 "With dput, you can use the <literal>--delayed <replaceable>DELAY</"
820 "replaceable></literal> parameter to put the package into one of the queues."
821 msgstr ""
822
823 # type: Content of: <chapter><section><section><title>
824 #. type: Content of: <chapter><section><section><title>
825 #: pkgs.dbk:441
826 msgid "Security uploads"
827 msgstr "セキュリティアップロード"
828
829 # type: Content of: <chapter><section><section><para>
830 #. type: Content of: <chapter><section><section><para>
831 #: pkgs.dbk:443
832 #, fuzzy
833 msgid ""
834 "Do <emphasis role=\"strong\">NOT</emphasis> upload a package to the security "
835 "upload queue (<literal>oldstable-security</literal>, <literal>stable-"
836 "security</literal>, etc.) without prior authorization from the security "
837 "team.  If the package does not exactly meet the team's requirements, it will "
838 "cause many problems and delays in dealing with the unwanted upload.  For "
839 "details, please see <xref linkend=\"bug-security\"/>."
840 msgstr ""
841 "セキュリティアップロードキュー (<literal>oldstable-security</literal>、"
842 "<literal>stable-security</literal> 等) には、セキュリティチームからの事前許可"
843 "無しにパッケージを<emphasis role=\"strong\">アップロードしないでください</"
844 "emphasis>。パッケージがチームの要求に完全に合致していない場合、望まれないアッ"
845 "プロードに対処するために多くの問題が引き起こされたり遅延が生じることになりま"
846 "す。詳細については <xref linkend=\"bug-security\"/> を参照してください。"
847
848 # type: Content of: <chapter><section><section><title>
849 #. type: Content of: <chapter><section><section><title>
850 #: pkgs.dbk:453
851 msgid "Other upload queues"
852 msgstr "他のアップロードキュー"
853
854 #. type: Content of: <chapter><section><section><para>
855 #: pkgs.dbk:455
856 msgid ""
857 "There is an alternative upload queue in Europe at <ulink url=\"ftp://&ftp-eu-"
858 "upload-host;&upload-queue;\"/>. It operates in the same way as <literal>&ftp-"
859 "upload-host;</literal>, but should be faster for European developers."
860 msgstr ""
861 "ヨーロッパにはもう一つのアップロードキューが <ulink url=\"ftp://&ftp-eu-"
862 "upload-host;&upload-queue;\"/> にあります。操作方法は <literal>&ftp-upload-"
863 "host;</literal> と同じですが、ヨーロッパ圏の開発者に対しては、より速いはずで"
864 "す。"
865
866 #. type: Content of: <chapter><section><section><para>
867 #: pkgs.dbk:461
868 msgid ""
869 "Packages can also be uploaded via ssh to <literal>&ssh-upload-host;</"
870 "literal>; files should be put <literal>/srv/upload.debian.org/UploadQueue</"
871 "literal>. This queue does not support <link linkend=\"delayed-incoming"
872 "\">delayed uploads</link>."
873 msgstr ""
874
875 # type: Content of: <chapter><section><section><title>
876 #. type: Content of: <chapter><section><section><title>
877 #: pkgs.dbk:469
878 msgid "Notification that a new package has been installed"
879 msgstr "新しいパッケージがインストールされたことの通知"
880
881 # type: Content of: <chapter><section><section><para>
882 #. type: Content of: <chapter><section><section><para>
883 #: pkgs.dbk:471
884 msgid ""
885 "The Debian archive maintainers are responsible for handling package "
886 "uploads.  For the most part, uploads are automatically handled on a daily "
887 "basis by the archive maintenance tools, <command>katie</command>.  "
888 "Specifically, updates to existing packages to the <literal>unstable</"
889 "literal> distribution are handled automatically.  In other cases, notably "
890 "new packages, placing the uploaded package into the distribution is handled "
891 "manually.  When uploads are handled manually, the change to the archive may "
892 "take up to a month to occur.  Please be patient."
893 msgstr ""
894
895 # type: Content of: <chapter><section><section><para>
896 #. type: Content of: <chapter><section><section><para>
897 #: pkgs.dbk:481
898 msgid ""
899 "In any case, you will receive an email notification indicating that the "
900 "package has been added to the archive, which also indicates which bugs will "
901 "be closed by the upload.  Please examine this notification carefully, "
902 "checking if any bugs you meant to close didn't get triggered."
903 msgstr ""
904
905 # type: Content of: <chapter><section><section><para>
906 #. type: Content of: <chapter><section><section><para>
907 #: pkgs.dbk:487
908 msgid ""
909 "The installation notification also includes information on what section the "
910 "package was inserted into.  If there is a disparity, you will receive a "
911 "separate email notifying you of that.  Read on below."
912 msgstr ""
913
914 # type: Content of: <chapter><section><section><para>
915 #. type: Content of: <chapter><section><section><para>
916 #: pkgs.dbk:492
917 msgid ""
918 "Note that if you upload via queues, the queue daemon software will also send "
919 "you a notification by email."
920 msgstr ""
921
922 # type: Content of: <chapter><section><title>
923 #. type: Content of: <chapter><section><title>
924 #: pkgs.dbk:500
925 msgid "Specifying the package section, subsection and priority"
926 msgstr "パッケージのセクション、サブセクション、優先度を指定する"
927
928 # type: Content of: <chapter><section><para>
929 #. type: Content of: <chapter><section><para>
930 #: pkgs.dbk:502
931 msgid ""
932 "The <filename>debian/control</filename> file's <literal>Section</literal> "
933 "and <literal>Priority</literal> fields do not actually specify where the "
934 "file will be placed in the archive, nor its priority.  In order to retain "
935 "the overall integrity of the archive, it is the archive maintainers who have "
936 "control over these fields.  The values in the <filename>debian/control</"
937 "filename> file are actually just hints."
938 msgstr ""
939
940 # type: Content of: <chapter><section><para>
941 #. type: Content of: <chapter><section><para>
942 #: pkgs.dbk:510
943 msgid ""
944 "The archive maintainers keep track of the canonical sections and priorities "
945 "for packages in the <literal>override file</literal>.  If there is a "
946 "disparity between the <literal>override file</literal> and the package's "
947 "fields as indicated in <filename>debian/control</filename>, then you will "
948 "receive an email noting the divergence when the package is installed into "
949 "the archive.  You can either correct your <filename>debian/control</"
950 "filename> file for your next upload, or else you may wish to make a change "
951 "in the <literal>override file</literal>."
952 msgstr ""
953
954 #. type: Content of: <chapter><section><para>
955 #: pkgs.dbk:520
956 msgid ""
957 "To alter the actual section that a package is put in, you need to first make "
958 "sure that the <filename>debian/control</filename> file in your package is "
959 "accurate.  Next, submit a bug against <systemitem role=\"package\">ftp."
960 "debian.org</systemitem> requesting that the section or priority for your "
961 "package be changed from the old section or priority to the new one. Use a "
962 "Subject like <literal>override: PACKAGE1:section/priority, [...], PACKAGEX:"
963 "section/priority</literal>, and include the justification for the change in "
964 "the body of the bug report."
965 msgstr ""
966
967 # type: Content of: <chapter><section><para>
968 #. type: Content of: <chapter><section><para>
969 #: pkgs.dbk:531
970 msgid ""
971 "For more information about <literal>override files</literal>, see "
972 "<citerefentry> <refentrytitle>dpkg-scanpackages</refentrytitle> "
973 "<manvolnum>1</manvolnum> </citerefentry> and <ulink url=\"&url-bts-devel;"
974 "#maintincorrect\"></ulink>."
975 msgstr ""
976 "<literal>override ファイル</literal> についての詳細は、<citerefentry> "
977 "<refentrytitle>dpkg-scanpackages</refentrytitle> <manvolnum>1</manvolnum> </"
978 "citerefentry> と <ulink url=\"&url-bts-devel;#maintincorrect\"></ulink> を参"
979 "照してください。"
980
981 # type: Content of: <chapter><section><para>
982 #. type: Content of: <chapter><section><para>
983 #: pkgs.dbk:537
984 msgid ""
985 "Note that the <literal>Section</literal> field describes both the section as "
986 "well as the subsection, which are described in <xref linkend=\"archive-"
987 "sections\"/>.  If the section is main, it should be omitted.  The list of "
988 "allowable subsections can be found in <ulink url=\"&url-debian-policy;ch-"
989 "archive.html#s-subsections\"></ulink>."
990 msgstr ""
991
992 # type: Content of: <chapter><section><title>
993 #. type: Content of: <chapter><section><title>
994 #: pkgs.dbk:546
995 msgid "Handling bugs"
996 msgstr "バグの取扱い"
997
998 # type: Content of: <chapter><section><para>
999 #. type: Content of: <chapter><section><para>
1000 #: pkgs.dbk:548
1001 msgid ""
1002 "Every developer has to be able to work with the Debian <ulink url=\"&url-bts;"
1003 "\">bug tracking system</ulink>.  This includes knowing how to file bug "
1004 "reports properly (see <xref linkend=\"submit-bug\"/>), how to update them "
1005 "and reorder them, and how to process and close them."
1006 msgstr ""
1007 "すべての開発者は Debian <ulink url=\"&url-bts;\">バグ追跡システム</ulink>を取"
1008 "り扱えるようでなければいけません。これはどの様にしてバグ報告を正しく登録する"
1009 "か (<xref linkend=\"submit-bug\"/> 参照)、どの様に更新をして整理しなおすか、"
1010 "そしてどの様にして処理をして完了するかを知っていることを含みます。"
1011
1012 # type: Content of: <chapter><section><para>
1013 #. type: Content of: <chapter><section><para>
1014 #: pkgs.dbk:554
1015 msgid ""
1016 "The bug tracking system's features are described in the <ulink url=\"&url-"
1017 "bts-devel;\">BTS documentation for developers</ulink>.  This includes "
1018 "closing bugs, sending followup messages, assigning severities and tags, "
1019 "marking bugs as forwarded, and other issues."
1020 msgstr ""
1021 "バグ追跡システムの機能は<ulink url=\"&url-bts-devel;\"> Debian BTS 開発者向け"
1022 "情報</ulink>に記載されています。これには、バグの完了処理・追加メッセージの送"
1023 "信・重要度とタグを割り当てる・バグを転送済み (Forwarded) にする・その他が含ま"
1024 "れています。"
1025
1026 # type: Content of: <chapter><section><para>
1027 #. type: Content of: <chapter><section><para>
1028 #: pkgs.dbk:560
1029 msgid ""
1030 "Operations such as reassigning bugs to other packages, merging separate bug "
1031 "reports about the same issue, or reopening bugs when they are prematurely "
1032 "closed, are handled using the so-called control mail server.  All of the "
1033 "commands available on this server are described in the <ulink url=\"&url-bts-"
1034 "control;\">BTS control server documentation</ulink>."
1035 msgstr ""
1036 "バグを他のパッケージに割り当てし直す、同じ問題についての別々のバグ報告をマー"
1037 "ジする、などの作業はいわゆる制御メールサーバと呼ばれるものを使って処理されて"
1038 "います。このサーバで利用可能なすべてのコマンドは、<ulink url=\"&url-bts-"
1039 "control;\">BTS 制御サーバドキュメント</ulink>に記載されています。"
1040
1041 # type: Content of: <chapter><section><section><title>
1042 #. type: Content of: <chapter><section><section><title>
1043 #: pkgs.dbk:568
1044 msgid "Monitoring bugs"
1045 msgstr "バグの監視"
1046
1047 # type: Content of: <chapter><section><section><para>
1048 #. type: Content of: <chapter><section><section><para>
1049 #: pkgs.dbk:570
1050 msgid ""
1051 "If you want to be a good maintainer, you should periodically check the "
1052 "<ulink url=\"&url-bts;\">Debian bug tracking system (BTS)</ulink> for your "
1053 "packages.  The BTS contains all the open bugs against your packages.  You "
1054 "can check them by browsing this page: <literal>http://&bugs-host;/"
1055 "<replaceable>yourlogin</replaceable>@debian.org</literal>."
1056 msgstr ""
1057 "良いメンテナになりたい場合は、あなたのパッケージに関する <ulink url=\"&url-"
1058 "bts;\">Debian バグ追跡システム (BTS)</ulink> のページを定期的にチェックする必"
1059 "要があります。BTS には、あなたのパッケージに対して登録されている全てのバグが"
1060 "含まれています。登録されているバグについては、以下のページを参照することで確"
1061 "認できます: <literal>http://&bugs-host;/<replaceable>yourlogin</"
1062 "replaceable>@debian.org</literal>"
1063
1064 # type: Content of: <chapter><section><section><para>
1065 #. type: Content of: <chapter><section><section><para>
1066 #: pkgs.dbk:577
1067 msgid ""
1068 "Maintainers interact with the BTS via email addresses at <literal>&bugs-host;"
1069 "</literal>.  Documentation on available commands can be found at <ulink url="
1070 "\"&url-bts;\"></ulink>, or, if you have installed the <systemitem role="
1071 "\"package\">doc-debian</systemitem> package, you can look at the local files "
1072 "&file-bts-docs;."
1073 msgstr ""
1074 "メンテナは、<literal>&bugs-host;</literal> のメールアドレス経由で BTS に対応"
1075 "します。利用可能なコマンドについてのドキュメントは <ulink url=\"&url-bts;"
1076 "\"></ulink> で参照可能ですし、もし <systemitem role=\"package\">doc-debian</"
1077 "systemitem> パッケージをインストールしてあれば、ローカルファイル &file-bts-"
1078 "docs; で見ることも可能です。"
1079
1080 # type: Content of: <chapter><section><section><para>
1081 #. type: Content of: <chapter><section><section><para>
1082 #: pkgs.dbk:584
1083 msgid ""
1084 "Some find it useful to get periodic reports on open bugs.  You can add a "
1085 "cron job such as the following if you want to get a weekly email outlining "
1086 "all the open bugs against your packages:"
1087 msgstr ""
1088
1089 #. type: Content of: <chapter><section><section><screen>
1090 #: pkgs.dbk:589
1091 #, no-wrap
1092 msgid ""
1093 "# ask for weekly reports of bugs in my packages\n"
1094 "&cron-bug-report;\n"
1095 msgstr ""
1096 "# 自分のパッケージにあるバグのレポートを毎週取得する\n"
1097 "&cron-bug-report;\n"
1098
1099 # type: Content of: <chapter><section><section><para>
1100 #. type: Content of: <chapter><section><section><para>
1101 #: pkgs.dbk:593
1102 msgid ""
1103 "Replace <replaceable>address</replaceable> with your official Debian "
1104 "maintainer address."
1105 msgstr ""
1106 "<replaceable>address</replaceable> は、あなたの公式な Debian パッケージメンテ"
1107 "ナとしてのメールアドレスに置き換えてください。"
1108
1109 # type: Content of: <chapter><section><section><title>
1110 #. type: Content of: <chapter><section><section><title>
1111 #: pkgs.dbk:599
1112 msgid "Responding to bugs"
1113 msgstr "バグへの対応"
1114
1115 # type: Content of: <chapter><section><section><para>
1116 #. type: Content of: <chapter><section><section><para>
1117 #: pkgs.dbk:601
1118 msgid ""
1119 "When responding to bugs, make sure that any discussion you have about bugs "
1120 "is sent both to the original submitter of the bug, and to the bug itself (e."
1121 "g., <email><replaceable>123</replaceable>@&bugs-host;</email>).  If you're "
1122 "writing a new mail and you don't remember the submitter email address, you "
1123 "can use the <email><replaceable>123</replaceable>-submitter@&bugs-host;</"
1124 "email> email to contact the submitter <emphasis>and</emphasis> to record "
1125 "your mail within the bug log (that means you don't need to send a copy of "
1126 "the mail to <email><replaceable>123</replaceable>@&bugs-host;</email>)."
1127 msgstr ""
1128 "バグに対応する際は、バグについて行った議論がバグの元々の報告者とバグ自身 (例"
1129 "えば <email><replaceable>123</replaceable>@&bugs-host;</email>) の両方に送ら"
1130 "れているのを確認してください。新しくメールを書いていて元々の報告者のメールア"
1131 "ドレスを思い出せない場合は、<email><replaceable>123</replaceable>-"
1132 "submitter@&bugs-host;</email> というメールアドレスを報告者へ連絡するのに使え"
1133 "ます。<emphasis>さらに</emphasis>バグのログへあなたのメールを記録するのにも使"
1134 "えます (これは <email><replaceable>123</replaceable>@&bugs-host;</email> へ"
1135 "メールのコピーを送らなくても済むことを意味しています)。"
1136
1137 # type: Content of: <chapter><section><section><para>
1138 #. type: Content of: <chapter><section><section><para>
1139 #: pkgs.dbk:610
1140 msgid ""
1141 "If you get a bug which mentions FTBFS, this means Fails to build from "
1142 "source.  Porters frequently use this acronym."
1143 msgstr ""
1144 "FTBFS である旨のバグを受け取った場合、これはソースからビルドできないこと "
1145 "(Fails to build from source) を意味します。移植作業をしている人たちはこの略語"
1146 "をよく使います。"
1147
1148 # type: Content of: <chapter><section><section><para>
1149 #. type: Content of: <chapter><section><section><para>
1150 #: pkgs.dbk:614
1151 msgid ""
1152 "Once you've dealt with a bug report (e.g.  fixed it), mark it as "
1153 "<literal>done</literal> (close it) by sending an explanation message to "
1154 "<email><replaceable>123</replaceable>-done@&bugs-host;</email>.  If you're "
1155 "fixing a bug by changing and uploading the package, you can automate bug "
1156 "closing as described in <xref linkend=\"upload-bugfix\"/>."
1157 msgstr ""
1158 "既にバグに対処していた場合 (例えば修正済み)、説明のメッセージを "
1159 "<email><replaceable>123</replaceable>-done@&bugs-host;</email> に送ることで "
1160 "<literal>done</literal> とマークしておいて (閉じて) ください。パッケージを変"
1161 "更してアップロードすることでバグを修正する場合は、<xref linkend=\"upload-"
1162 "bugfix\"/> に記載されているように自動的にバグを閉じることができます。"
1163
1164 # type: Content of: <chapter><section><section><para>
1165 # FIXME: via the bug server ?
1166 #. type: Content of: <chapter><section><section><para>
1167 #: pkgs.dbk:621
1168 msgid ""
1169 "You should <emphasis>never</emphasis> close bugs via the bug server "
1170 "<literal>close</literal> command sent to &email-bts-control;.  If you do so, "
1171 "the original submitter will not receive any information about why the bug "
1172 "was closed."
1173 msgstr ""
1174 "<literal>close</literal> コマンドを &email-bts-control; に送って、バグサーバ"
1175 "経由でバグを閉じるのは<emphasis>決して</emphasis>してはいけません。そのように"
1176 "した場合、元々の報告者は何故バグが閉じられたのかという情報を得られません。"
1177
1178 # type: Content of: <chapter><section><section><title>
1179 #. type: Content of: <chapter><section><section><title>
1180 #: pkgs.dbk:629
1181 msgid "Bug housekeeping"
1182 msgstr "バグを掃除する"
1183
1184 # type: Content of: <chapter><section><section><para>
1185 #. type: Content of: <chapter><section><section><para>
1186 #: pkgs.dbk:631
1187 msgid ""
1188 "As a package maintainer, you will often find bugs in other packages or have "
1189 "bugs reported against your packages which are actually bugs in other "
1190 "packages.  The bug tracking system's features are described in the <ulink "
1191 "url=\"&url-bts-devel;\">BTS documentation for Debian developers</ulink>.  "
1192 "Operations such as reassigning, merging, and tagging bug reports are "
1193 "described in the <ulink url=\"&url-bts-control;\">BTS control server "
1194 "documentation</ulink>.  This section contains some guidelines for managing "
1195 "your own bugs, based on the collective Debian developer experience."
1196 msgstr ""
1197
1198 # type: Content of: <chapter><section><section><para>
1199 #. type: Content of: <chapter><section><section><para>
1200 #: pkgs.dbk:642
1201 msgid ""
1202 "Filing bugs for problems that you find in other packages is one of the civic "
1203 "obligations of maintainership, see <xref linkend=\"submit-bug\"/> for "
1204 "details.  However, handling the bugs in your own packages is even more "
1205 "important."
1206 msgstr ""
1207
1208 # type: Content of: <chapter><section><section><para>
1209 #. type: Content of: <chapter><section><section><para>
1210 #: pkgs.dbk:647
1211 msgid "Here's a list of steps that you may follow to handle a bug report:"
1212 msgstr ""
1213
1214 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1215 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1216 #: pkgs.dbk:652
1217 msgid ""
1218 "Decide whether the report corresponds to a real bug or not.  Sometimes users "
1219 "are just calling a program in the wrong way because they haven't read the "
1220 "documentation.  If you diagnose this, just close the bug with enough "
1221 "information to let the user correct their problem (give pointers to the good "
1222 "documentation and so on).  If the same report comes up again and again you "
1223 "may ask yourself if the documentation is good enough or if the program "
1224 "shouldn't detect its misuse in order to give an informative error message.  "
1225 "This is an issue that may need to be brought up with the upstream author."
1226 msgstr ""
1227
1228 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1229 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1230 #: pkgs.dbk:662
1231 msgid ""
1232 "If the bug submitter disagrees with your decision to close the bug, they may "
1233 "reopen it until you find an agreement on how to handle it.  If you don't "
1234 "find any, you may want to tag the bug <literal>wontfix</literal> to let "
1235 "people know that the bug exists but that it won't be corrected.  If this "
1236 "situation is unacceptable, you (or the submitter) may want to require a "
1237 "decision of the technical committee by reassigning the bug to <systemitem "
1238 "role=\"package\">tech-ctte</systemitem> (you may use the clone command of "
1239 "the BTS if you wish to keep it reported against your package).  Before doing "
1240 "so, please read the <ulink url=\"&url-tech-ctte;\">recommended procedure</"
1241 "ulink>."
1242 msgstr ""
1243
1244 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1245 #: pkgs.dbk:676
1246 msgid ""
1247 "If the bug is real but it's caused by another package, just reassign the bug "
1248 "to the right package.  If you don't know which package it should be "
1249 "reassigned to, you should ask for help on <link linkend=\"irc-channels"
1250 "\">IRC</link> or on &email-debian-devel;.  Please inform the maintainer(s) "
1251 "of the package you reassign the bug to, for example by Cc:ing the message "
1252 "that does the reassign to <email><replaceable>packagename</"
1253 "replaceable>@packages.debian.org</email> and explaining your reasons in that "
1254 "mail. Please note that a simple reassignment is <emphasis>not</emphasis> e-"
1255 "mailed to the maintainers of the package being reassigned to, so they won't "
1256 "know about it until they look at a bug overview for their packages."
1257 msgstr ""
1258
1259 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1260 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1261 #: pkgs.dbk:688
1262 msgid ""
1263 "If the bug affects the operation of your package, please consider cloning "
1264 "the bug and reassigning the clone to the package that really causes the "
1265 "behavior. Otherwise, the bug will not be shown in your package's bug list, "
1266 "possibly causing users to report the same bug over and over again. You "
1267 "should block \"your\" bug with the reassigned, cloned bug to document the "
1268 "relationship."
1269 msgstr ""
1270
1271 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1272 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1273 #: pkgs.dbk:698
1274 msgid ""
1275 "Sometimes you also have to adjust the severity of the bug so that it matches "
1276 "our definition of the severity.  That's because people tend to inflate the "
1277 "severity of bugs to make sure their bugs are fixed quickly.  Some bugs may "
1278 "even be dropped to wishlist severity when the requested change is just "
1279 "cosmetic."
1280 msgstr ""
1281
1282 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1283 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1284 #: pkgs.dbk:706
1285 msgid ""
1286 "If the bug is real but the same problem has already been reported by someone "
1287 "else, then the two relevant bug reports should be merged into one using the "
1288 "merge command of the BTS.  In this way, when the bug is fixed, all of the "
1289 "submitters will be informed of this.  (Note, however, that emails sent to "
1290 "one bug report's submitter won't automatically be sent to the other report's "
1291 "submitter.) For more details on the technicalities of the merge command and "
1292 "its relative, the unmerge command, see the BTS control server documentation."
1293 msgstr ""
1294
1295 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1296 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1297 #: pkgs.dbk:717
1298 msgid ""
1299 "The bug submitter may have forgotten to provide some information, in which "
1300 "case you have to ask them for the required information.  You may use the "
1301 "<literal>moreinfo</literal> tag to mark the bug as such.  Moreover if you "
1302 "can't reproduce the bug, you tag it <literal>unreproducible</literal>.  "
1303 "Anyone who can reproduce the bug is then invited to provide more information "
1304 "on how to reproduce it.  After a few months, if this information has not "
1305 "been sent by someone, the bug may be closed."
1306 msgstr ""
1307
1308 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1309 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1310 #: pkgs.dbk:728
1311 msgid ""
1312 "If the bug is related to the packaging, you just fix it.  If you are not "
1313 "able to fix it yourself, then tag the bug as <literal>help</literal>.  You "
1314 "can also ask for help on &email-debian-devel; or &email-debian-qa;.  If it's "
1315 "an upstream problem, you have to forward it to the upstream author.  "
1316 "Forwarding a bug is not enough, you have to check at each release if the bug "
1317 "has been fixed or not.  If it has, you just close it, otherwise you have to "
1318 "remind the author about it.  If you have the required skills you can prepare "
1319 "a patch that fixes the bug and send it to the author at the same time.  Make "
1320 "sure to send the patch to the BTS and to tag the bug as <literal>patch</"
1321 "literal>."
1322 msgstr ""
1323
1324 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1325 #: pkgs.dbk:742
1326 msgid ""
1327 "If you have fixed a bug in your local copy, or if a fix has been committed "
1328 "to the VCS repository, you may tag the bug as <literal>pending</literal> to "
1329 "let people know that the bug is corrected and that it will be closed with "
1330 "the next upload (add the <literal>closes:</literal> in the "
1331 "<filename>changelog</filename>).  This is particularly useful if you are "
1332 "several developers working on the same package."
1333 msgstr ""
1334
1335 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
1336 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
1337 #: pkgs.dbk:752
1338 msgid ""
1339 "Once a corrected package is available in the archive, the bug should be "
1340 "closed indicating the version in which it was fixed. This can be done "
1341 "automatically, read <xref linkend=\"upload-bugfix\"/>."
1342 msgstr ""
1343
1344 # type: Content of: <chapter><section><section><title>
1345 #. type: Content of: <chapter><section><section><title>
1346 #: pkgs.dbk:761
1347 msgid "When bugs are closed by new uploads"
1348 msgstr "新規アップロードでバグがクローズされる時"
1349
1350 # type: Content of: <chapter><section><section><para>
1351 #. type: Content of: <chapter><section><section><para>
1352 #: pkgs.dbk:763
1353 msgid ""
1354 "As bugs and problems are fixed in your packages, it is your responsibility "
1355 "as the package maintainer to close these bugs.  However, you should not "
1356 "close a bug until the package which fixes the bug has been accepted into the "
1357 "Debian archive.  Therefore, once you get notification that your updated "
1358 "package has been installed into the archive, you can and should close the "
1359 "bug in the BTS.  Also, the bug should be closed with the correct version."
1360 msgstr ""
1361
1362 # type: Content of: <chapter><section><section><para>
1363 #. type: Content of: <chapter><section><section><para>
1364 #: pkgs.dbk:771
1365 msgid ""
1366 "However, it's possible to avoid having to manually close bugs after the "
1367 "upload — just list the fixed bugs in your <filename>debian/changelog</"
1368 "filename> file, following a certain syntax, and the archive maintenance "
1369 "software will close the bugs for you.  For example:"
1370 msgstr ""
1371
1372 # type: Content of: <chapter><section><section><screen>
1373 #. type: Content of: <chapter><section><section><screen>
1374 #: pkgs.dbk:777
1375 #, no-wrap
1376 msgid ""
1377 "acme-cannon (3.1415) unstable; urgency=low\n"
1378 "\n"
1379 "  * Frobbed with options (closes: Bug#98339)\n"
1380 "  * Added safety to prevent operator dismemberment, closes: bug#98765,\n"
1381 "    bug#98713, #98714.\n"
1382 "  * Added man page. Closes: #98725.\n"
1383 msgstr ""
1384 "acme-cannon (3.1415) unstable; urgency=low\n"
1385 "\n"
1386 "  * Frobbed with options (closes: Bug#98339)\n"
1387 "  * Added safety to prevent operator dismemberment, closes: bug#98765,\n"
1388 "    bug#98713, #98714.\n"
1389 "  * Added man page. Closes: #98725.\n"
1390
1391 # type: Content of: <chapter><section><section><para>
1392 #. type: Content of: <chapter><section><section><para>
1393 #: pkgs.dbk:785
1394 msgid ""
1395 "Technically speaking, the following Perl regular expression describes how "
1396 "bug closing changelogs are identified:"
1397 msgstr ""
1398
1399 # type: Content of: <chapter><section><section><screen>
1400 #. type: Content of: <chapter><section><section><screen>
1401 #: pkgs.dbk:789
1402 #, no-wrap
1403 msgid "  /closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig\n"
1404 msgstr "  /closes:\\s*(?:bug)?\\#\\s*\\d+(?:,\\s*(?:bug)?\\#\\s*\\d+)*/ig\n"
1405
1406 #. type: Content of: <chapter><section><section><para>
1407 #: pkgs.dbk:792
1408 msgid ""
1409 "We prefer the <literal>closes: #<replaceable>XXX</replaceable></literal> "
1410 "syntax, as it is the most concise entry and the easiest to integrate with "
1411 "the text of the <filename>changelog</filename>.  Unless specified different "
1412 "by the <literal>-v</literal>-switch to <command>dpkg-buildpackage</command>, "
1413 "only the bugs closed in the most recent changelog entry are closed "
1414 "(basically, exactly the bugs mentioned in the changelog-part in the "
1415 "<filename>.changes</filename> file are closed)."
1416 msgstr ""
1417
1418 #. type: Content of: <chapter><section><section><para>
1419 #: pkgs.dbk:801
1420 msgid ""
1421 "Historically, uploads identified as <link linkend=\"nmu\">non-maintainer "
1422 "upload (NMU)</link> were tagged <literal>fixed</literal> instead of being "
1423 "closed, but that practice was ceased with the advent of version-tracking.  "
1424 "The same applied to the tag <literal>fixed-in-experimental</literal>."
1425 msgstr ""
1426
1427 #. type: Content of: <chapter><section><section><para>
1428 #: pkgs.dbk:807
1429 msgid ""
1430 "If you happen to mistype a bug number or forget a bug in the changelog "
1431 "entries, don't hesitate to undo any damage the error caused.  To reopen "
1432 "wrongly closed bugs, send a <literal>reopen <replaceable>XXX</replaceable></"
1433 "literal> command to the bug tracking system's control address, &email-bts-"
1434 "control;.  To close any remaining bugs that were fixed by your upload, email "
1435 "the <filename>.changes</filename> file to <email><replaceable>XXX</"
1436 "replaceable>-done@&bugs-host;</email>, where <replaceable>XXX</replaceable> "
1437 "is the bug number, and put Version: <replaceable>YYY</replaceable> and an "
1438 "empty line as the first two lines of the body of the email, where "
1439 "<replaceable>YYY</replaceable> is the first version where the bug has been "
1440 "fixed."
1441 msgstr ""
1442
1443 #. type: Content of: <chapter><section><section><para>
1444 #: pkgs.dbk:819
1445 msgid ""
1446 "Bear in mind that it is not obligatory to close bugs using the changelog as "
1447 "described above.  If you simply want to close bugs that don't have anything "
1448 "to do with an upload you made, do it by emailing an explanation to "
1449 "<email><replaceable>XXX</replaceable>-done@&bugs-host;</email>.  Do "
1450 "<emphasis role=\"strong\">not</emphasis> close bugs in the changelog entry "
1451 "of a version if the changes in that version of the package don't have any "
1452 "bearing on the bug."
1453 msgstr ""
1454
1455 # type: Content of: <chapter><section><section><para>
1456 #. type: Content of: <chapter><section><section><para>
1457 #: pkgs.dbk:827
1458 msgid ""
1459 "For general information on how to write your changelog entries, see <xref "
1460 "linkend=\"bpp-debian-changelog\"/>."
1461 msgstr ""
1462 "どのように changelog のエントリを書くのか、一般的な情報については <xref "
1463 "linkend=\"bpp-debian-changelog\"/> を参照してください。"
1464
1465 # type: Content of: <chapter><section><section><title>
1466 #. type: Content of: <chapter><section><section><title>
1467 #: pkgs.dbk:833
1468 msgid "Handling security-related bugs"
1469 msgstr "セキュリティ関連バグの取扱い"
1470
1471 # type: Content of: <chapter><section><section><para>
1472 #. type: Content of: <chapter><section><section><para>
1473 #: pkgs.dbk:835
1474 msgid ""
1475 "Due to their sensitive nature, security-related bugs must be handled "
1476 "carefully.  The Debian Security Team exists to coordinate this activity, "
1477 "keeping track of outstanding security problems, helping maintainers with "
1478 "security problems or fixing them themselves, sending security advisories, "
1479 "and maintaining <literal>security.debian.org</literal>."
1480 msgstr ""
1481 "機密性が高いその性質上、セキュリティ関連のバグは注意深く取り扱わねばなりませ"
1482 "ん。この作業をコーディネイトし、未処理のセキュリティ問題を追い続け、セキュリ"
1483 "ティ問題についてメンテナを手助けしたり修正自体を行い、セキュリティ勧告を出"
1484 "し、<literal>security.debian.org</literal> を維持するために Debian セキュリ"
1485 "ティチームが存在します。"
1486
1487 #. type: Content of: <chapter><section><section><para>
1488 #: pkgs.dbk:842
1489 msgid ""
1490 "When you become aware of a security-related bug in a Debian package, whether "
1491 "or not you are the maintainer, collect pertinent information about the "
1492 "problem, and promptly contact the security team at &email-security-team; as "
1493 "soon as possible.  <emphasis role=\"strong\">DO NOT UPLOAD</emphasis> any "
1494 "packages for <literal>stable</literal> without contacting the team.  Useful "
1495 "information includes, for example:"
1496 msgstr ""
1497 "Debian パッケージ中のセキュリティ関連のバグに気づいたら、あなたがメンテナであ"
1498 "るかどうかに関わらず、問題に関する正確な情報を集めて、まずは可能な限り早く "
1499 "&email-security-team; 宛でセキュリティチームに連絡を取ってください。チームに"
1500 "問い合わせること無く <literal>安定版 (stable)</literal> 向けのパッケージを"
1501 "<emphasis role=\"strong\">アップロードしないでください</emphasis>。例えば、役"
1502 "に立つ情報は以下を含んでいます:"
1503
1504 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1505 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1506 #: pkgs.dbk:852
1507 msgid ""
1508 "Which versions of the package are known to be affected by the bug.  Check "
1509 "each version that is present in a supported Debian release, as well as "
1510 "<literal>testing</literal> and <literal>unstable</literal>."
1511 msgstr ""
1512 "バグによって、どのバージョンが影響を受けると分かっているか。サポートされてい"
1513 "る Debian のリリース、ならびに <literal>テスト版 (testing)</literal> 及び "
1514 "<literal>不安定版 (unstable)</literal> にある各バージョンをチェックしてくださ"
1515 "い。"
1516
1517 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1518 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1519 #: pkgs.dbk:859
1520 msgid ""
1521 "The nature of the fix, if any is available (patches are especially helpful)"
1522 msgstr "利用可能なものがあれば、修正内容 (パッチが特に望ましい)"
1523
1524 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1525 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1526 #: pkgs.dbk:864
1527 msgid ""
1528 "Any fixed packages that you have prepared yourself (send only the <filename>."
1529 "diff.gz</filename> and <filename>.dsc</filename> files and read <xref "
1530 "linkend=\"bug-security-building\"/> first)"
1531 msgstr ""
1532 "自身で準備した修正パッケージ (まずは <xref linkend=\"bug-security-building\"/"
1533 "> を読んで、<filename>.diff.gz</filename> と <filename>.dsc</filename> ファイ"
1534 "ルだけを送ってください)"
1535
1536 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1537 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1538 #: pkgs.dbk:871
1539 msgid ""
1540 "Any assistance you can provide to help with testing (exploits, regression "
1541 "testing, etc.)"
1542 msgstr ""
1543 "テストについて何かしらの手助けになるもの (攻撃コード、リグレッションテストな"
1544 "ど)"
1545
1546 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1547 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1548 #: pkgs.dbk:877
1549 msgid ""
1550 "Any information needed for the advisory (see <xref linkend=\"bug-security-"
1551 "advisories\"/>)"
1552 msgstr ""
1553 "勧告に必要になる情報 (<xref linkend=\"bug-security-advisories\"/> 参照)"
1554
1555 #. type: Content of: <chapter><section><section><para>
1556 #: pkgs.dbk:882
1557 msgid ""
1558 "As the maintainer of the package, you have the responsibility to maintain "
1559 "it, even in the stable release. You are in the best position to evaluate "
1560 "patches and test updated packages, so please see the sections below on how "
1561 "to prepare packages for the Security Team to handle."
1562 msgstr ""
1563 "パッケージメンテナとして、あなたは安定版リリースについてもメンテナンスする責"
1564 "任を持ちます。あなたがパッチの評価と更新パッケージのテストを行うのに最も適任"
1565 "な人です。ですから、以下のセキュリティチームによって取り扱ってもらうため、ど"
1566 "のようにしてパッケージを用意するかについての章を参照してください。"
1567
1568 #. type: Content of: <chapter><section><section><section><title>
1569 #: pkgs.dbk:888
1570 msgid "The Security Tracker"
1571 msgstr "セキュリティ追跡システム"
1572
1573 #. type: Content of: <chapter><section><section><section><para>
1574 #: pkgs.dbk:890
1575 msgid ""
1576 "The security team maintains a central database, the <ulink url=\"http://"
1577 "security-tracker.debian.org/\">Debian Security Tracker</ulink>.  This "
1578 "contains all public information that is known about security issues: which "
1579 "packages and versions are affected or fixed, and thus whether stable, "
1580 "testing and/or unstable are vulnerable. Information that is still "
1581 "confidential is not added to the tracker."
1582 msgstr ""
1583 "セキュリティチームは集約的なデータベース、<ulink url=\"http://security-"
1584 "tracker.debian.org/\">Debian セキュリティ追跡システム</ulink>をメンテナンスし"
1585 "ています。これはセキュリティ問題として知られている全ての公開情報を含んでいま"
1586 "す: どのパッケージ/バージョンが影響を受ける/修正されているか、つまりは安定"
1587 "版、テスト版、不安定版が脆弱化かどうか、という情報です。まだ機密扱いの情報は"
1588 "追跡システムには追加されません。"
1589
1590 #. type: Content of: <chapter><section><section><section><para>
1591 #: pkgs.dbk:898
1592 msgid ""
1593 "You can search it for a specific issue, but also on package name. Look for "
1594 "your package to see which issues are still open. If you can, please provide "
1595 "more information about those issues, or help to address them in your "
1596 "package.  Instructions are on the tracker web pages."
1597 msgstr ""
1598 "特定の問題について検索することもできますし、パッケージ名でも検索できます。あ"
1599 "なたのパッケージを探して、どの問題がまだ未解決かを確認してください。できれば"
1600 "追加情報を提供するか、パッケージの問題に対処するのを手伝ってください。やり方"
1601 "は追跡システムのウェブページにあります。"
1602
1603 # type: Content of: <chapter><section><section><section><title>
1604 #. type: Content of: <chapter><section><section><section><title>
1605 #: pkgs.dbk:906
1606 msgid "Confidentiality"
1607 msgstr "秘匿性"
1608
1609 # type: Content of: <chapter><section><section><section><para>
1610 #. type: Content of: <chapter><section><section><section><para>
1611 #: pkgs.dbk:908
1612 msgid ""
1613 "Unlike most other activities within Debian, information about security "
1614 "issues must sometimes be kept private for a time.  This allows software "
1615 "distributors to coordinate their disclosure in order to minimize their "
1616 "users' exposure.  Whether this is the case depends on the nature of the "
1617 "problem and corresponding fix, and whether it is already a matter of public "
1618 "knowledge."
1619 msgstr ""
1620 "Debian 内での他の多くの活動とは違い、時折セキュリティ問題に関する情報について"
1621 "は暫くの間秘密にしておく必要があります。これによって、ソフトウェアのディスト"
1622 "リビュータがユーザが危険にさらされるのを最小限にするため、公開時期を合わせる"
1623 "ことができます。今回がそうであるかは、問題と対応する修正の性質や、既に既知の"
1624 "ものになっているかどうかによります。"
1625
1626 # type: Content of: <chapter><section><section><section><para>
1627 #. type: Content of: <chapter><section><section><section><para>
1628 #: pkgs.dbk:915
1629 msgid "There are several ways developers can learn of a security problem:"
1630 msgstr "開発者がセキュリティ問題を知る方法はいくつかあります:"
1631
1632 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1633 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1634 #: pkgs.dbk:920
1635 msgid "they notice it on a public forum (mailing list, web site, etc.)"
1636 msgstr "公開フォーラム (メーリングリスト、ウェブサイトなど) で知らせる"
1637
1638 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1639 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1640 #: pkgs.dbk:925
1641 msgid "someone files a bug report"
1642 msgstr "誰かがバグ報告を登録している"
1643
1644 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1645 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1646 #: pkgs.dbk:930
1647 msgid "someone informs them via private email"
1648 msgstr "誰かがプライベートなメールで教えてきた"
1649
1650 # type: Content of: <chapter><section><section><section><para>
1651 #. type: Content of: <chapter><section><section><section><para>
1652 #: pkgs.dbk:935
1653 msgid ""
1654 "In the first two cases, the information is public and it is important to "
1655 "have a fix as soon as possible.  In the last case, however, it might not be "
1656 "public information.  In that case there are a few possible options for "
1657 "dealing with the problem:"
1658 msgstr ""
1659 "最初の二つのケースでは、情報は公開されていて可能な限り早く修正することが重要"
1660 "です。しかしながら最後のケースは、公開情報ではないかもしれません。この場合"
1661 "は、問題に対処するのに幾つか取り得る選択肢があります:"
1662
1663 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1664 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1665 #: pkgs.dbk:943
1666 msgid ""
1667 "If the security exposure is minor, there is sometimes no need to keep the "
1668 "problem a secret and a fix should be made and released."
1669 msgstr ""
1670 "セキュリティの影響度が小さい場合、問題を秘密にしておく必要はなく、修正を行っ"
1671 "てリリースするのが良い場合がしばしばあります。"
1672
1673 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1674 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1675 #: pkgs.dbk:949
1676 msgid ""
1677 "If the problem is severe, it is preferable to share the information with "
1678 "other vendors and coordinate a release.  The security team keeps in contact "
1679 "with the various organizations and individuals and can take care of that."
1680 msgstr ""
1681 "問題が深刻な場合、他のベンダと情報を共有してリリースをコーディネイトする方が"
1682 "望ましいでしょう。セキュリティチームは様々な組織/個人と連絡を取りつづけ、こ"
1683 "の問題に対応することができます。"
1684
1685 # type: Content of: <chapter><section><section><section><para>
1686 #. type: Content of: <chapter><section><section><section><para>
1687 #: pkgs.dbk:956
1688 msgid ""
1689 "In all cases if the person who reports the problem asks that it not be "
1690 "disclosed, such requests should be honored, with the obvious exception of "
1691 "informing the security team in order that a fix may be produced for a stable "
1692 "release of Debian.  When sending confidential information to the security "
1693 "team, be sure to mention this fact."
1694 msgstr ""
1695 "どのような場合でも、問題を報告した人がこれを公開しないように求めているのであ"
1696 "れば、明白な例外として Debian の安定版リリースに対する修正を作成してもらうた"
1697 "めにセキュリティチームへ連絡すること以外、この様な要求は尊重されるべきです。"
1698 "機密情報をセキュリティチームに送る場合は、この点を明示しておくのを忘れないで"
1699 "ください。"
1700
1701 # type: Content of: <chapter><section><section><section><para>
1702 #. type: Content of: <chapter><section><section><section><para>
1703 #: pkgs.dbk:963
1704 msgid ""
1705 "Please note that if secrecy is needed you may not upload a fix to "
1706 "<literal>unstable</literal> (or anywhere else, such as a public VCS "
1707 "repository).  It is not sufficient to obfuscate the details of the change, "
1708 "as the code itself is public, and can (and will) be examined by the general "
1709 "public."
1710 msgstr ""
1711 "機密を要する場合は、修正を<literal>不安定版 (unstable)</literal> (や公開 VCS "
1712 "リポジトリなどその他どこでも) へ修正をアップロードしないよう、注意してくださ"
1713 "い。コードその物が公開されている場合、変更の詳細を難読化するだけでは十分では"
1714 "なく、皆によって解析され得る (そしてされる) でしょう。"
1715
1716 # type: Content of: <chapter><section><section><section><para>
1717 #. type: Content of: <chapter><section><section><section><para>
1718 #: pkgs.dbk:970
1719 msgid ""
1720 "There are two reasons for releasing information even though secrecy is "
1721 "requested: the problem has been known for a while, or the problem or exploit "
1722 "has become public."
1723 msgstr ""
1724 "機密であることを要求されたにも関わらず、情報を公開するのには 2 つの理由があり"
1725 "ます: 問題がしばらくの間既知になっている、あるいは問題や攻撃コードが公開され"
1726 "た場合です。"
1727
1728 #. type: Content of: <chapter><section><section><section><para>
1729 #: pkgs.dbk:975
1730 msgid ""
1731 "The Security Team has a PGP-key to enable encrypted communication about "
1732 "sensitive issues. See the <ulink url=\"http://www.debian.org/security/"
1733 "faq#contact\">Security Team FAQ</ulink> for details."
1734 msgstr ""
1735 "セキュリティチームは、機密事項に関して通信を暗号化できる PGP 鍵を持っていま"
1736 "す。詳細については、<ulink url=\"http://www.debian.org/security/faq#contact"
1737 "\">セキュリティチーム FAQ</ulink> を参照してください。"
1738
1739 # type: Content of: <chapter><section><section><section><title>
1740 #. type: Content of: <chapter><section><section><section><title>
1741 #: pkgs.dbk:981
1742 msgid "Security Advisories"
1743 msgstr "セキュリティ勧告"
1744
1745 # type: Content of: <chapter><section><section><section><para>
1746 # FIXME: how about oldstable?
1747 #. type: Content of: <chapter><section><section><section><para>
1748 #: pkgs.dbk:983
1749 msgid ""
1750 "Security advisories are only issued for the current, released stable "
1751 "distribution, and <emphasis>not</emphasis> for <literal>testing</literal> or "
1752 "<literal>unstable</literal>.  When released, advisories are sent to the "
1753 "&email-debian-security-announce; mailing list and posted on <ulink url="
1754 "\"&url-debian-security-advisories;\">the security web page</ulink>.  "
1755 "Security advisories are written and posted by the security team.  However "
1756 "they certainly do not mind if a maintainer can supply some of the "
1757 "information for them, or write part of the text.  Information that should be "
1758 "in an advisory includes:"
1759 msgstr ""
1760 "セキュリティ勧告は現在のところ、リリースされた安定版ディストリビューションに"
1761 "ついてのみ、取り扱われます。<literal>テスト版 (testing)</literal> や "
1762 "<literal>不安定版 (unstable)</literal> についてでは<emphasis>ありません</"
1763 "emphasis>。リリースされると、セキュリティ勧告は email-debian-security-"
1764 "announce; メーリングリストに送られ、<ulink url=\"&url-debian-security-"
1765 "advisories;\">セキュリティのウェブページ</ulink>に掲載されます。セキュリティ"
1766 "勧告はセキュリティチームによって記述、掲載されます。しかし、メンテナが情報を"
1767 "提供できたり、文章の一部を書けるのであれば、彼らは当然そんなことは気にしませ"
1768 "ん。勧告にあるべき情報は以下を含んでいます:"
1769
1770 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1771 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1772 #: pkgs.dbk:996
1773 msgid "A description of the problem and its scope, including:"
1774 msgstr "以下のようなものを含めた問題の説明と範囲:"
1775
1776 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1777 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1778 #: pkgs.dbk:1001
1779 msgid "The type of problem (privilege escalation, denial of service, etc.)"
1780 msgstr "問題の種類 (権限の上昇、サービス拒否など)"
1781
1782 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1783 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1784 #: pkgs.dbk:1006
1785 msgid "What privileges may be gained, and by whom (if any)"
1786 msgstr "何の権限が得られるのか、(もし分かれば) 誰が得るのか"
1787
1788 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1789 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1790 #: pkgs.dbk:1011
1791 msgid "How it can be exploited"
1792 msgstr "どのようにして攻撃が可能なのか"
1793
1794 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1795 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1796 #: pkgs.dbk:1016
1797 msgid "Whether it is remotely or locally exploitable"
1798 msgstr "攻撃はリモートから可能なのかそれともローカルから可能なのか"
1799
1800 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1801 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><itemizedlist><listitem><para>
1802 #: pkgs.dbk:1021
1803 msgid "How the problem was fixed"
1804 msgstr "どのようにして問題が修正されたのか"
1805
1806 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1807 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1808 #: pkgs.dbk:1026
1809 msgid "This information allows users to assess the threat to their systems."
1810 msgstr ""
1811 "この情報によって、ユーザがシステムに対する脅威を評価できるようになります。"
1812
1813 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1814 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1815 #: pkgs.dbk:1031
1816 msgid "Version numbers of affected packages"
1817 msgstr "影響を受けるパッケージのバージョン番号"
1818
1819 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1820 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1821 #: pkgs.dbk:1036
1822 msgid "Version numbers of fixed packages"
1823 msgstr "修正されたパッケージのバージョン番号"
1824
1825 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1826 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1827 #: pkgs.dbk:1041
1828 msgid ""
1829 "Information on where to obtain the updated packages (usually from the Debian "
1830 "security archive)"
1831 msgstr ""
1832 "どこで更新されたパッケージを得るかという情報 (通常は Debian のセキュリティ"
1833 "アーカイブからです)"
1834
1835 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1836 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1837 #: pkgs.dbk:1047
1838 msgid ""
1839 "References to upstream advisories, <ulink url=\"http://cve.mitre.org\">CVE</"
1840 "ulink> identifiers, and any other information useful in cross-referencing "
1841 "the vulnerability"
1842 msgstr ""
1843 "開発元のアドバイザリへの参照、<ulink url=\"http://cve.mitre.org\">CVE</"
1844 "ulink> 番号、脆弱性の相互参照について役立つその他の情報"
1845
1846 # type: Content of: <chapter><section><section><section><title>
1847 #. type: Content of: <chapter><section><section><section><title>
1848 #: pkgs.dbk:1056
1849 msgid "Preparing packages to address security issues"
1850 msgstr "セキュリティ問題に対処するパッケージを用意する"
1851
1852 # type: Content of: <chapter><section><section><section><para>
1853 #. type: Content of: <chapter><section><section><section><para>
1854 #: pkgs.dbk:1058
1855 #, fuzzy
1856 msgid ""
1857 "One way that you can assist the security team in their duties is to provide "
1858 "them with fixed packages suitable for a security advisory for the stable "
1859 "Debian release."
1860 msgstr ""
1861 "セキュリティチームを彼らの作業範囲内で手助けできる方法の一つは、安定版 "
1862 "Debian リリース用のセキュリティ勧告に適した修正版パッケージを提供することで"
1863 "す。"
1864
1865 # type: Content of: <chapter><section><section><section><para>
1866 #. type: Content of: <chapter><section><section><section><para>
1867 #: pkgs.dbk:1063
1868 msgid ""
1869 "When an update is made to the stable release, care must be taken to avoid "
1870 "changing system behavior or introducing new bugs.  In order to do this, make "
1871 "as few changes as possible to fix the bug.  Users and administrators rely on "
1872 "the exact behavior of a release once it is made, so any change that is made "
1873 "might break someone's system.  This is especially true of libraries: make "
1874 "sure you never change the API or ABI, no matter how small the change."
1875 msgstr ""
1876 "安定版について更新が作成される際、システムの挙動の変化や新しいバグの導入を避"
1877 "けるように注意が必要です。これを行うため、バグを修正するための変更は可能な限"
1878 "り少なくします。ユーザや管理者は一旦リリースされたものの厳密な挙動を当てにし"
1879 "ている、どのような変更でも誰かのシステムを壊しかねません。これは特にライブラ"
1880 "リについて当てはまります: API や ABI を決して変更していないことを確認してくだ"
1881 "さい。変更がどれほど小さいものでも関係ありません。"
1882
1883 # type: Content of: <chapter><section><section><section><para>
1884 #. type: Content of: <chapter><section><section><section><para>
1885 #: pkgs.dbk:1071
1886 msgid ""
1887 "This means that moving to a new upstream version is not a good solution.  "
1888 "Instead, the relevant changes should be back-ported to the version present "
1889 "in the current stable Debian release.  Generally, upstream maintainers are "
1890 "willing to help if needed.  If not, the Debian security team may be able to "
1891 "help."
1892 msgstr ""
1893 "これは、開発元の新しいリリースバージョン (new upstream version) への移行が良"
1894 "い解決策ではないことを意味しています。代わりに、関連する変更を現在の Debian "
1895 "安定版リリースに存在しているバージョンへバックポートするべきです。通常、開発"
1896 "元のメンテナは助けが必要であれば手伝おうとしてくれます。そうでない場合は、"
1897 "Debian セキュリティチームが手助けすることができます。"
1898
1899 # type: Content of: <chapter><section><section><section><para>
1900 #. type: Content of: <chapter><section><section><section><para>
1901 #: pkgs.dbk:1077
1902 msgid ""
1903 "In some cases, it is not possible to back-port a security fix, for example "
1904 "when large amounts of source code need to be modified or rewritten.  If this "
1905 "happens, it may be necessary to move to a new upstream version.  However, "
1906 "this is only done in extreme situations, and you must always coordinate that "
1907 "with the security team beforehand."
1908 msgstr ""
1909
1910 # type: Content of: <chapter><section><section><section><para>
1911 #. type: Content of: <chapter><section><section><section><para>
1912 #: pkgs.dbk:1084
1913 msgid ""
1914 "Related to this is another important guideline: always test your changes.  "
1915 "If you have an exploit available, try it and see if it indeed succeeds on "
1916 "the unpatched package and fails on the fixed package.  Test other, normal "
1917 "actions as well, as sometimes a security fix can break seemingly unrelated "
1918 "features in subtle ways."
1919 msgstr ""
1920
1921 # type: Content of: <chapter><section><section><section><para>
1922 #. type: Content of: <chapter><section><section><section><para>
1923 #: pkgs.dbk:1091
1924 msgid ""
1925 "Do <emphasis role=\"strong\">NOT</emphasis> include any changes in your "
1926 "package which are not directly related to fixing the vulnerability.  These "
1927 "will only need to be reverted, and this wastes time.  If there are other "
1928 "bugs in your package that you would like to fix, make an upload to proposed-"
1929 "updates in the usual way, after the security advisory is issued.  The "
1930 "security update mechanism is not a means for introducing changes to your "
1931 "package which would otherwise be rejected from the stable release, so please "
1932 "do not attempt to do this."
1933 msgstr ""
1934
1935 # type: Content of: <chapter><section><section><section><para>
1936 #. type: Content of: <chapter><section><section><section><para>
1937 #: pkgs.dbk:1101
1938 msgid ""
1939 "Review and test your changes as much as possible.  Check the differences "
1940 "from the previous version repeatedly (<command>interdiff</command> from the "
1941 "<systemitem role=\"package\">patchutils</systemitem> package and "
1942 "<command>debdiff</command> from <systemitem role=\"package\">devscripts</"
1943 "systemitem> are useful tools for this, see <xref linkend=\"debdiff\"/>)."
1944 msgstr ""
1945
1946 # type: Content of: <chapter><section><section><section><para>
1947 #. type: Content of: <chapter><section><section><section><para>
1948 #: pkgs.dbk:1109
1949 msgid "Be sure to verify the following items:"
1950 msgstr ""
1951
1952 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1953 #: pkgs.dbk:1114
1954 msgid ""
1955 "<emphasis role=\"strong\">Target the right distribution</emphasis> in your "
1956 "<filename>debian/changelog</filename>.  For <literal>stable</literal> this "
1957 "is <literal>stable-security</literal> and for <literal>testing</literal> "
1958 "this is <literal>testing-security</literal>, and for the previous stable "
1959 "release, this is <literal>oldstable-security</literal>.  Do not target "
1960 "<replaceable>distribution</replaceable><literal>-proposed-updates</literal> "
1961 "or <literal>stable</literal>!"
1962 msgstr ""
1963 "<filename>debian/changelog</filename> で <emphasis role=\"strong\">正しいディ"
1964 "ストリビューションを対象にする</emphasis>。<literal>安定版 (stable)</"
1965 "literal> の場合、これは <literal>stable-security</literal> になり、<literal>"
1966 "テスト版 (testing)</literal> の場合は <literal>testing-security</literal> "
1967 "に、そして以前の安定版リリースへの場合は <literal>oldstable-security</"
1968 "literal> となります。<replaceable>distribution</replaceable><literal>-"
1969 "proposed-updates</literal> や <literal>安定版 (stable)</literal> を対象にしな"
1970 "いでください!"
1971
1972 # type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1973 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1974 #: pkgs.dbk:1125
1975 msgid ""
1976 "The upload should have <emphasis role=\"strong\">urgency=high</emphasis>."
1977 msgstr ""
1978 "アップロードは <emphasis role=\"strong\">urgency=high</emphasis> で行う必要が"
1979 "あります。"
1980
1981 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1982 #: pkgs.dbk:1130
1983 msgid ""
1984 "Make descriptive, meaningful changelog entries.  Others will rely on them to "
1985 "determine whether a particular bug was fixed.  Add <literal>closes:</"
1986 "literal> statements for any <emphasis role=\"strong\">Debian bugs</emphasis> "
1987 "filed.  Always include an external reference, preferably a <emphasis role="
1988 "\"strong\">CVE identifier</emphasis>, so that it can be cross-referenced. "
1989 "However, if a CVE identifier has not yet been assigned, do not wait for it "
1990 "but continue the process. The identifier can be cross-referenced later."
1991 msgstr ""
1992
1993 # FIXME: etch1 -> <stable code>
1994 # convention
1995 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1996 #: pkgs.dbk:1141
1997 msgid ""
1998 "Make sure the <emphasis role=\"strong\">version number</emphasis> is "
1999 "proper.  It must be greater than the current package, but less than package "
2000 "versions in later distributions.  If in doubt, test it with <literal>dpkg --"
2001 "compare-versions</literal>.  Be careful not to re-use a version number that "
2002 "you have already used for a previous upload, or one that conflicts with a "
2003 "binNMU. The convention is to append <literal>+</"
2004 "literal><replaceable>codename</replaceable><literal>1</literal>, e.g.  "
2005 "<literal>1:2.4.3-4+lenny1</literal>, of course increasing 1 for any "
2006 "subsequent uploads."
2007 msgstr ""
2008 "<emphasis role=\"strong\">バージョン番号</emphasis>が正しいことを確認する。現"
2009 "在のパッケージより大きく、しかし以降のディストリビューションよりパッケージ"
2010 "バージョンが小さい必要があります。分からない場合は <literal>dpkg --compare-"
2011 "versions</literal> でテストしてください。バ以前のアップロードで既に使っている"
2012 "バージョン番号を再利用しないように注意してください。そうしないと番号が "
2013 "binNMU と衝突します。<literal>+</literal><replaceable>codename</"
2014 "replaceable><literal>1</literal> を追加するのが通例です。例えば "
2015 "<literal>1:2.4.3-4+lenny1</literal> とします。もちろん 1 はアップロードするご"
2016 "とに増やします。"
2017
2018 # FIXME: remove " "
2019 # FIXME: how about debuild -sa ?
2020 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2021 #: pkgs.dbk:1154
2022 msgid ""
2023 "Unless the upstream source has been uploaded to <literal>security.debian.org "
2024 "</literal> before (by a previous security update), build the upload "
2025 "<emphasis role=\"strong\">with full upstream source</emphasis> "
2026 "(<literal>dpkg-buildpackage -sa</literal>).  If there has been a previous "
2027 "upload to <literal>security.debian.org</literal> with the same upstream "
2028 "version, you may upload without upstream source (<literal>dpkg-buildpackage -"
2029 "sd</literal>)."
2030 msgstr ""
2031 "これまでに (以前のセキュリティ更新によって) <literal>security.debian.org</"
2032 "literal> へ開発元のソースコードをアップロードしていなければ、<emphasis role="
2033 "\"strong\">開発元のソースコードを全て含めて</emphasis>アップロードするパッ"
2034 "ケージをビルドする (<literal>dpkg-buildpackage -sa</literal>)。以前、同じ開発"
2035 "元のバージョンで <literal>security.debian.org</literal> にアップロードしたこ"
2036 "とがある場合は、開発元のソースコード無しでアップロードしても構いません "
2037 "(<literal>dpkg-buildpackage -sd</literal>)。"
2038
2039 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2040 #: pkgs.dbk:1164
2041 msgid ""
2042 "Be sure to use the <emphasis role=\"strong\">exact same <filename>*.orig.tar."
2043 "{gz,bz2,lzma}</filename></emphasis> as used in the normal archive, otherwise "
2044 "it is not possible to move the security fix into the main archives later."
2045 msgstr ""
2046
2047 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
2048 #: pkgs.dbk:1172
2049 msgid ""
2050 "Build the package on a <emphasis role=\"strong\">clean system</emphasis> "
2051 "which only has packages installed from the distribution you are building "
2052 "for. If you do not have such a system yourself, you can use a debian.org "
2053 "machine (see <xref linkend=\"server-machines\"/>) or setup a chroot (see "
2054 "<xref linkend=\"pbuilder\"/> and <xref linkend=\"debootstrap\"/>)."
2055 msgstr ""
2056
2057 # type: Content of: <chapter><section><section><section><title>
2058 #. type: Content of: <chapter><section><section><section><title>
2059 #: pkgs.dbk:1183
2060 msgid "Uploading the fixed package"
2061 msgstr "修正したパッケージをアップロードする"
2062
2063 # type: Content of: <chapter><section><section><section><para>
2064 #. type: Content of: <chapter><section><section><section><para>
2065 #: pkgs.dbk:1185
2066 msgid ""
2067 "Do <emphasis role=\"strong\">NOT</emphasis> upload a package to the security "
2068 "upload queue (<literal>oldstable-security</literal>, <literal>stable-"
2069 "security</literal>, etc.) without prior authorization from the security "
2070 "team.  If the package does not exactly meet the team's requirements, it will "
2071 "cause many problems and delays in dealing with the unwanted upload."
2072 msgstr ""
2073
2074 #. type: Content of: <chapter><section><section><section><para>
2075 #: pkgs.dbk:1192
2076 msgid ""
2077 "Do <emphasis role=\"strong\">NOT</emphasis> upload your fix to "
2078 "<literal>proposed-updates</literal> without coordinating with the security "
2079 "team.  Packages from <literal>security.debian.org</literal> will be copied "
2080 "into the <literal>proposed-updates</literal> directory automatically.  If a "
2081 "package with the same or a higher version number is already installed into "
2082 "the archive, the security update will be rejected by the archive system.  "
2083 "That way, the stable distribution will end up without a security update for "
2084 "this package instead."
2085 msgstr ""
2086
2087 # type: Content of: <chapter><section><section><section><para>
2088 #. type: Content of: <chapter><section><section><section><para>
2089 #: pkgs.dbk:1202
2090 msgid ""
2091 "Once you have created and tested the new package and it has been approved by "
2092 "the security team, it needs to be uploaded so that it can be installed in "
2093 "the archives.  For security uploads, the place to upload to is "
2094 "<literal>ftp://security-master.debian.org/pub/SecurityUploadQueue/</literal>."
2095 msgstr ""
2096
2097 #. type: Content of: <chapter><section><section><section><para>
2098 #: pkgs.dbk:1208
2099 msgid ""
2100 "Once an upload to the security queue has been accepted, the package will "
2101 "automatically be built for all architectures and stored for verification by "
2102 "the security team."
2103 msgstr ""
2104
2105 # type: Content of: <chapter><section><section><section><para>
2106 #. type: Content of: <chapter><section><section><section><para>
2107 #: pkgs.dbk:1213
2108 msgid ""
2109 "Uploads which are waiting for acceptance or verification are only accessible "
2110 "by the security team.  This is necessary since there might be fixes for "
2111 "security problems that cannot be disclosed yet."
2112 msgstr ""
2113
2114 # type: Content of: <chapter><section><section><section><para>
2115 #. type: Content of: <chapter><section><section><section><para>
2116 #: pkgs.dbk:1218
2117 msgid ""
2118 "If a member of the security team accepts a package, it will be installed on "
2119 "<literal>security.debian.org</literal> as well as proposed for the proper "
2120 "<replaceable>distribution</replaceable><literal>-proposed-updates</literal> "
2121 "on <literal>&ftp-master-host;</literal>."
2122 msgstr ""
2123
2124 # type: Content of: <chapter><section><title>
2125 #. type: Content of: <chapter><section><title>
2126 #: pkgs.dbk:1230
2127 msgid "Moving, removing, renaming, adopting, and orphaning packages"
2128 msgstr "パッケージの移動、削除、リネーム、変更、みなしご化"
2129
2130 # type: Content of: <chapter><section><para>
2131 #. type: Content of: <chapter><section><para>
2132 #: pkgs.dbk:1232
2133 msgid ""
2134 "Some archive manipulation operations are not automated in the Debian upload "
2135 "process.  These procedures should be manually followed by maintainers.  This "
2136 "chapter gives guidelines on what to do in these cases."
2137 msgstr ""
2138
2139 # type: Content of: <chapter><section><section><title>
2140 #. type: Content of: <chapter><section><section><title>
2141 #: pkgs.dbk:1237
2142 msgid "Moving packages"
2143 msgstr "パッケージの移動"
2144
2145 # type: Content of: <chapter><section><section><para><footnote><para>
2146 #. type: Content of: <chapter><section><section><para><footnote><para>
2147 #: pkgs.dbk:1241
2148 msgid ""
2149 "See the <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for "
2150 "guidelines on what section a package belongs in."
2151 msgstr ""
2152
2153 #. type: Content of: <chapter><section><section><para>
2154 #: pkgs.dbk:1239
2155 msgid ""
2156 "Sometimes a package will change its section.  For instance, a package from "
2157 "the `non-free' section might be GPL'd in a later version, in which case the "
2158 "package should be moved to `main' or `contrib'.<placeholder type=\"footnote"
2159 "\" id=\"0\"/>"
2160 msgstr ""
2161
2162 #. type: Content of: <chapter><section><section><para>
2163 #: pkgs.dbk:1246
2164 msgid ""
2165 "If you need to change the section for one of your packages, change the "
2166 "package control information to place the package in the desired section, and "
2167 "re-upload the package (see the <ulink url=\"&url-debian-policy;\">Debian "
2168 "Policy Manual</ulink> for details).  You must ensure that you include the "
2169 "<filename>.orig.tar.{gz,bz2,lzma}</filename> in your upload (even if you are "
2170 "not uploading a new upstream version), or it will not appear in the new "
2171 "section together with the rest of the package.  If your new section is "
2172 "valid, it will be moved automatically.  If it does not, then contact the "
2173 "ftpmasters in order to understand what happened."
2174 msgstr ""
2175
2176 # type: Content of: <chapter><section><section><para>
2177 #. type: Content of: <chapter><section><section><para>
2178 #: pkgs.dbk:1258
2179 msgid ""
2180 "If, on the other hand, you need to change the <literal>subsection</literal> "
2181 "of one of your packages (e.g., ``devel'', ``admin''), the procedure is "
2182 "slightly different.  Correct the subsection as found in the control file of "
2183 "the package, and re-upload that.  Also, you'll need to get the override file "
2184 "updated, as described in <xref linkend=\"override-file\"/>."
2185 msgstr ""
2186
2187 # type: Content of: <chapter><section><section><title>
2188 #. type: Content of: <chapter><section><section><title>
2189 #: pkgs.dbk:1267
2190 msgid "Removing packages"
2191 msgstr "パッケージの削除"
2192
2193 #. type: Content of: <chapter><section><section><para>
2194 #: pkgs.dbk:1269
2195 msgid ""
2196 "If for some reason you want to completely remove a package (say, if it is an "
2197 "old compatibility library which is no longer required), you need to file a "
2198 "bug against <literal>ftp.debian.org</literal> asking that the package be "
2199 "removed; as all bugs, this bug should normally have normal severity.  The "
2200 "bug title should be in the form <literal>RM: <replaceable>package</"
2201 "replaceable> <replaceable>[architecture list]</replaceable> -- "
2202 "<replaceable>reason</replaceable></literal>, where <replaceable>package</"
2203 "replaceable> is the package to be removed and <replaceable>reason</"
2204 "replaceable> is a short summary of the reason for the removal request.  "
2205 "<replaceable>[architecture list]</replaceable> is optional and only needed "
2206 "if the removal request only applies to some architectures, not all. Note "
2207 "that the <command>reportbug</command> will create a title conforming to "
2208 "these rules when you use it to report a bug against the <literal>ftp.debian."
2209 "org</literal> pseudo-package."
2210 msgstr ""
2211
2212 # type: Content of: <chapter><section><section><para>
2213 #. type: Content of: <chapter><section><section><para>
2214 #: pkgs.dbk:1286
2215 msgid ""
2216 "If you want to remove a package you maintain, you should note this in the "
2217 "bug title by prepending <literal>ROM</literal> (Request Of Maintainer).  "
2218 "There are several other standard acronyms used in the reasoning for a "
2219 "package removal, see <ulink url=\"http://&ftp-master-host;/removals.html\"></"
2220 "ulink> for a complete list. That page also provides a convenient overview of "
2221 "pending removal requests."
2222 msgstr ""
2223
2224 #. type: Content of: <chapter><section><section><para>
2225 #: pkgs.dbk:1295
2226 msgid ""
2227 "Note that removals can only be done for the <literal>unstable</literal>, "
2228 "<literal>experimental</literal> and <literal>stable</literal> distribution.  "
2229 "Packages are not removed from <literal>testing</literal> directly.  Rather, "
2230 "they will be removed automatically after the package has been removed from "
2231 "<literal>unstable</literal> and no package in <literal>testing</literal> "
2232 "depends on it."
2233 msgstr ""
2234
2235 # type: Content of: <chapter><section><section><para>
2236 #. type: Content of: <chapter><section><section><para>
2237 #: pkgs.dbk:1304
2238 msgid ""
2239 "There is one exception when an explicit removal request is not necessary: If "
2240 "a (source or binary) package is an orphan, it will be removed semi-"
2241 "automatically.  For a binary-package, this means if there is no longer any "
2242 "source package producing this binary package; if the binary package is just "
2243 "no longer produced on some architectures, a removal request is still "
2244 "necessary.  For a source-package, this means that all binary packages it "
2245 "refers to have been taken over by another source package."
2246 msgstr ""
2247
2248 # type: Content of: <chapter><section><section><para>
2249 #. type: Content of: <chapter><section><section><para>
2250 #: pkgs.dbk:1313
2251 msgid ""
2252 "In your removal request, you have to detail the reasons justifying the "
2253 "request.  This is to avoid unwanted removals and to keep a trace of why a "
2254 "package has been removed.  For example, you can provide the name of the "
2255 "package that supersedes the one to be removed."
2256 msgstr ""
2257
2258 # type: Content of: <chapter><section><section><para>
2259 #. type: Content of: <chapter><section><section><para>
2260 #: pkgs.dbk:1319
2261 msgid ""
2262 "Usually you only ask for the removal of a package maintained by yourself.  "
2263 "If you want to remove another package, you have to get the approval of its "
2264 "maintainer. Should the package be orphaned and thus have no maintainer, you "
2265 "should first discuss the removal request on &email-debian-qa;. If there is a "
2266 "consensus that the package should be removed, you should reassign and "
2267 "retitle the <literal>O:</literal> bug filed against the <literal>wnpp</"
2268 "literal> package instead of filing a new bug as removal request."
2269 msgstr ""
2270
2271 # type: Content of: <chapter><section><section><para>
2272 #. type: Content of: <chapter><section><section><para>
2273 #: pkgs.dbk:1329
2274 msgid ""
2275 "Further information relating to these and other package removal related "
2276 "topics may be found at <ulink url=\"http://wiki.debian.org/ftpmaster_Removals"
2277 "\"></ulink> and <ulink url=\"&url-debian-qa;howto-remove.html\"></ulink>."
2278 msgstr ""
2279
2280 #. type: Content of: <chapter><section><section><para>
2281 #: pkgs.dbk:1334
2282 msgid ""
2283 "If in doubt concerning whether a package is disposable, email &email-debian-"
2284 "devel; asking for opinions.  Also of interest is the <command>apt-cache</"
2285 "command> program from the <systemitem role=\"package\">apt</systemitem> "
2286 "package.  When invoked as <literal>apt-cache showpkg <replaceable>package</"
2287 "replaceable></literal>, the program will show details for "
2288 "<replaceable>package</replaceable>, including reverse depends.  Other useful "
2289 "programs include <command>apt-cache rdepends</command>, <command>apt-"
2290 "rdepends</command>, <command>build-rdeps</command> (in the <systemitem role="
2291 "\"package\">devscripts</systemitem> package) and <command>grep-dctrl</"
2292 "command>.  Removal of orphaned packages is discussed on &email-debian-qa;."
2293 msgstr ""
2294
2295 #. type: Content of: <chapter><section><section><para>
2296 #: pkgs.dbk:1347
2297 msgid ""
2298 "Once the package has been removed, the package's bugs should be handled.  "
2299 "They should either be reassigned to another package in the case where the "
2300 "actual code has evolved into another package (e.g.  <literal>libfoo12</"
2301 "literal> was removed because <literal>libfoo13</literal> supersedes it) or "
2302 "closed if the software is simply no longer part of Debian.  When closing the "
2303 "bugs, to avoid marking the bugs as fixed in versions of the packages in "
2304 "previous Debian releases, they should be marked as fixed in the version "
2305 "<literal>&lt;most-recent-version-ever-in-Debian&gt;+rm</literal>."
2306 msgstr ""
2307
2308 # type: Content of: <chapter><section><section><section><title>
2309 #. type: Content of: <chapter><section><section><section><title>
2310 #: pkgs.dbk:1358
2311 msgid "Removing packages from <filename>Incoming</filename>"
2312 msgstr "<filename>Incoming</filename> からパッケージを削除する"
2313
2314 # type: Content of: <chapter><section><section><section><para>
2315 #. type: Content of: <chapter><section><section><section><para>
2316 #: pkgs.dbk:1360
2317 msgid ""
2318 "In the past, it was possible to remove packages from <filename>incoming</"
2319 "filename>.  However, with the introduction of the new incoming system, this "
2320 "is no longer possible.  Instead, you have to upload a new revision of your "
2321 "package with a higher version than the package you want to replace.  Both "
2322 "versions will be installed in the archive but only the higher version will "
2323 "actually be available in <literal>unstable</literal> since the previous "
2324 "version will immediately be replaced by the higher.  However, if you do "
2325 "proper testing of your packages, the need to replace a package should not "
2326 "occur too often anyway."
2327 msgstr ""
2328
2329 # type: Content of: <chapter><section><section><title>
2330 #. type: Content of: <chapter><section><section><title>
2331 #: pkgs.dbk:1375
2332 msgid "Replacing or renaming packages"
2333 msgstr "パッケージをリプレースあるいはリネームする"
2334
2335 #. type: Content of: <chapter><section><section><para>
2336 #: pkgs.dbk:1377
2337 msgid ""
2338 "When the upstream maintainers for one of your packages chose to rename their "
2339 "software (or you made a mistake naming your package), you should follow a "
2340 "two-step process to rename it. In the first step, change the "
2341 "<filename>debian/control</filename> file to reflect the new name and to "
2342 "replace, provide and conflict with the obsolete package name (see the <ulink "
2343 "url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for details).  "
2344 "Please note that you should only add a <literal>Provides</literal> relation "
2345 "if all packages depending on the obsolete package name continue to work "
2346 "after the renaming. Once you've uploaded the package and the package has "
2347 "moved into the archive, file a bug against <literal>ftp.debian.org</literal> "
2348 "asking to remove the package with the obsolete name (see <xref linkend="
2349 "\"removing-pkgs\"/>).  Do not forget to properly reassign the package's bugs "
2350 "at the same time."
2351 msgstr ""
2352
2353 #. type: Content of: <chapter><section><section><para>
2354 #: pkgs.dbk:1393
2355 msgid ""
2356 "At other times, you may make a mistake in constructing your package and wish "
2357 "to replace it.  The only way to do this is to increase the version number "
2358 "and upload a new version.  The old version will be expired in the usual "
2359 "manner.  Note that this applies to each part of your package, including the "
2360 "sources: if you wish to replace the upstream source tarball of your package, "
2361 "you will need to upload it with a different version.  An easy possibility is "
2362 "to replace <filename>foo_1.00.orig.tar.gz</filename> with "
2363 "<filename>foo_1.00+0.orig.tar.gz</filename> or <filename>foo_1.00.orig.tar."
2364 "bz2</filename>.  This restriction gives each file on the ftp site a unique "
2365 "name, which helps to ensure consistency across the mirror network."
2366 msgstr ""
2367
2368 # type: Content of: <chapter><section><section><title>
2369 #. type: Content of: <chapter><section><section><title>
2370 #: pkgs.dbk:1408
2371 msgid "Orphaning a package"
2372 msgstr "パッケージをみなしご化する"
2373
2374 # type: Content of: <chapter><section><section><para>
2375 #. type: Content of: <chapter><section><section><para>
2376 #: pkgs.dbk:1410
2377 msgid ""
2378 "If you can no longer maintain a package, you need to inform others, and see "
2379 "that the package is marked as orphaned.  You should set the package "
2380 "maintainer to <literal>Debian QA Group &orphan-address;</literal> and submit "
2381 "a bug report against the pseudo package <systemitem role=\"package\">wnpp</"
2382 "systemitem>.  The bug report should be titled <literal>O: "
2383 "<replaceable>package</replaceable> -- <replaceable>short description</"
2384 "replaceable></literal> indicating that the package is now orphaned.  The "
2385 "severity of the bug should be set to <literal>normal</literal>; if the "
2386 "package has a priority of standard or higher, it should be set to "
2387 "important.  If you feel it's necessary, send a copy to &email-debian-devel; "
2388 "by putting the address in the X-Debbugs-CC: header of the message (no, don't "
2389 "use CC:, because that way the message's subject won't indicate the bug "
2390 "number)."
2391 msgstr ""
2392
2393 # type: Content of: <chapter><section><section><para>
2394 #. type: Content of: <chapter><section><section><para>
2395 #: pkgs.dbk:1425
2396 msgid ""
2397 "If you just intend to give the package away, but you can keep maintainership "
2398 "for the moment, then you should instead submit a bug against <systemitem "
2399 "role=\"package\">wnpp</systemitem> and title it <literal>RFA: "
2400 "<replaceable>package</replaceable> -- <replaceable>short description</"
2401 "replaceable></literal>.  <literal>RFA</literal> stands for <literal>Request "
2402 "For Adoption</literal>."
2403 msgstr ""
2404
2405 # type: Content of: <chapter><section><section><para>
2406 #. type: Content of: <chapter><section><section><para>
2407 #: pkgs.dbk:1433
2408 msgid ""
2409 "More information is on the <ulink url=\"&url-wnpp;\">WNPP web pages</ulink>."
2410 msgstr ""
2411 "より詳細な情報は <ulink url=\"&url-wnpp;\">WNPP ウェブページ</ulink>にありま"
2412 "す。"
2413
2414 # type: Content of: <chapter><section><section><title>
2415 #. type: Content of: <chapter><section><section><title>
2416 #: pkgs.dbk:1439
2417 msgid "Adopting a package"
2418 msgstr "パッケージに変更を加える"
2419
2420 # type: Content of: <chapter><section><section><para>
2421 #. type: Content of: <chapter><section><section><para>
2422 #: pkgs.dbk:1441
2423 msgid ""
2424 "A list of packages in need of a new maintainer is available in the <ulink "
2425 "url=\"&url-wnpp;\">Work-Needing and Prospective Packages list (WNPP)</"
2426 "ulink>.  If you wish to take over maintenance of any of the packages listed "
2427 "in the WNPP, please take a look at the aforementioned page for information "
2428 "and procedures."
2429 msgstr ""
2430
2431 # type: Content of: <chapter><section><section><para>
2432 #. type: Content of: <chapter><section><section><para>
2433 #: pkgs.dbk:1448
2434 msgid ""
2435 "It is not OK to simply take over a package that you feel is neglected — that "
2436 "would be package hijacking.  You can, of course, contact the current "
2437 "maintainer and ask them if you may take over the package.  If you have "
2438 "reason to believe a maintainer has gone AWOL (absent without leave), see "
2439 "<xref linkend=\"mia-qa\"/>."
2440 msgstr ""
2441
2442 # type: Content of: <chapter><section><section><para>
2443 #. type: Content of: <chapter><section><section><para>
2444 #: pkgs.dbk:1454
2445 msgid ""
2446 "Generally, you may not take over the package without the assent of the "
2447 "current maintainer.  Even if they ignore you, that is still not grounds to "
2448 "take over a package.  Complaints about maintainers should be brought up on "
2449 "the developers' mailing list.  If the discussion doesn't end with a positive "
2450 "conclusion, and the issue is of a technical nature, consider bringing it to "
2451 "the attention of the technical committee (see the <ulink url=\"&url-tech-"
2452 "ctte;\">technical committee web page</ulink> for more information)."
2453 msgstr ""
2454
2455 #. type: Content of: <chapter><section><section><para>
2456 #: pkgs.dbk:1464
2457 msgid ""
2458 "If you take over an old package, you probably want to be listed as the "
2459 "package's official maintainer in the bug system.  This will happen "
2460 "automatically once you upload a new version with an updated "
2461 "<literal>Maintainer</literal> field, although it can take a few hours after "
2462 "the upload is done.  If you do not expect to upload a new version for a "
2463 "while, you can use <xref linkend=\"pkg-tracking-system\"/> to get the bug "
2464 "reports.  However, make sure that the old maintainer has no problem with the "
2465 "fact that they will continue to receive the bugs during that time."
2466 msgstr ""
2467
2468 # type: Content of: <chapter><section><title>
2469 #. type: Content of: <chapter><section><title>
2470 #: pkgs.dbk:1478
2471 msgid "Porting and being ported"
2472 msgstr ""
2473
2474 # type: Content of: <chapter><section><para>
2475 #. type: Content of: <chapter><section><para>
2476 #: pkgs.dbk:1480
2477 msgid ""
2478 "Debian supports an ever-increasing number of architectures.  Even if you are "
2479 "not a porter, and you don't use any architecture but one, it is part of your "
2480 "duty as a maintainer to be aware of issues of portability.  Therefore, even "
2481 "if you are not a porter, you should read most of this chapter."
2482 msgstr ""
2483
2484 #. type: Content of: <chapter><section><para>
2485 #: pkgs.dbk:1486
2486 msgid ""
2487 "Porting is the act of building Debian packages for architectures that are "
2488 "different from the original architecture of the package maintainer's binary "
2489 "package.  It is a unique and essential activity.  In fact, porters do most "
2490 "of the actual compiling of Debian packages.  For instance, when a maintainer "
2491 "uploads a (portable) source packages with binaries for the <literal>i386</"
2492 "literal> architecture, it will be built for each of the other architectures, "
2493 "amounting to &number-of-arches; more builds."
2494 msgstr ""
2495
2496 # type: Content of: <chapter><section><section><title>
2497 #. type: Content of: <chapter><section><section><title>
2498 #: pkgs.dbk:1495
2499 msgid "Being kind to porters"
2500 msgstr ""
2501
2502 # type: Content of: <chapter><section><section><para>
2503 #. type: Content of: <chapter><section><section><para>
2504 #: pkgs.dbk:1497
2505 msgid ""
2506 "Porters have a difficult and unique task, since they are required to deal "
2507 "with a large volume of packages.  Ideally, every source package should build "
2508 "right out of the box.  Unfortunately, this is often not the case.  This "
2509 "section contains a checklist of ``gotchas'' often committed by Debian "
2510 "maintainers — common problems which often stymie porters, and make their "
2511 "jobs unnecessarily difficult."
2512 msgstr ""
2513
2514 # type: Content of: <chapter><section><section><para>
2515 #. type: Content of: <chapter><section><section><para>
2516 #: pkgs.dbk:1505
2517 msgid ""
2518 "The first and most important thing is to respond quickly to bug or issues "
2519 "raised by porters.  Please treat porters with courtesy, as if they were in "
2520 "fact co-maintainers of your package (which, in a way, they are).  Please be "
2521 "tolerant of succinct or even unclear bug reports; do your best to hunt down "
2522 "whatever the problem is."
2523 msgstr ""
2524
2525 # type: Content of: <chapter><section><section><para>
2526 #. type: Content of: <chapter><section><section><para>
2527 #: pkgs.dbk:1512
2528 msgid ""
2529 "By far, most of the problems encountered by porters are caused by "
2530 "<emphasis>packaging bugs</emphasis> in the source packages.  Here is a "
2531 "checklist of things you should check or be aware of."
2532 msgstr ""
2533
2534 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2535 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2536 #: pkgs.dbk:1519
2537 msgid ""
2538 "Make sure that your <literal>Build-Depends</literal> and <literal>Build-"
2539 "Depends-Indep</literal> settings in <filename>debian/control</filename> are "
2540 "set properly.  The best way to validate this is to use the <systemitem role="
2541 "\"package\">debootstrap</systemitem> package to create an <literal>unstable</"
2542 "literal> chroot environment (see <xref linkend=\"debootstrap\"/>).  Within "
2543 "that chrooted environment, install the <systemitem role=\"package\">build-"
2544 "essential</systemitem> package and any package dependencies mentioned in "
2545 "<literal>Build-Depends</literal> and/or <literal>Build-Depends-Indep</"
2546 "literal>.  Finally, try building your package within that chrooted "
2547 "environment.  These steps can be automated by the use of the "
2548 "<command>pbuilder</command> program which is provided by the package of the "
2549 "same name (see <xref linkend=\"pbuilder\"/>)."
2550 msgstr ""
2551
2552 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2553 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2554 #: pkgs.dbk:1534
2555 msgid ""
2556 "If you can't set up a proper chroot, <command>dpkg-depcheck</command> may be "
2557 "of assistance (see <xref linkend=\"dpkg-depcheck\"/>)."
2558 msgstr ""
2559
2560 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2561 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2562 #: pkgs.dbk:1538
2563 msgid ""
2564 "See the <ulink url=\"&url-debian-policy;\">Debian Policy Manual</ulink> for "
2565 "instructions on setting build dependencies."
2566 msgstr ""
2567
2568 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2569 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2570 #: pkgs.dbk:1544
2571 msgid ""
2572 "Don't set architecture to a value other than <literal>all</literal> or "
2573 "<literal>any</literal> unless you really mean it.  In too many cases, "
2574 "maintainers don't follow the instructions in the <ulink url=\"&url-debian-"
2575 "policy;\">Debian Policy Manual</ulink>.  Setting your architecture to only "
2576 "one architecture (such as <literal>i386</literal> or <literal>amd64</"
2577 "literal>) is usually incorrect."
2578 msgstr ""
2579
2580 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2581 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2582 #: pkgs.dbk:1554
2583 msgid ""
2584 "Make sure your source package is correct.  Do <literal>dpkg-source -x "
2585 "<replaceable>package</replaceable>.dsc</literal> to make sure your source "
2586 "package unpacks properly.  Then, in there, try building your package from "
2587 "scratch with <command>dpkg-buildpackage</command>."
2588 msgstr ""
2589
2590 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2591 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2592 #: pkgs.dbk:1562
2593 msgid ""
2594 "Make sure you don't ship your source package with the <filename>debian/"
2595 "files</filename> or <filename>debian/substvars</filename> files.  They "
2596 "should be removed by the <literal>clean</literal> target of <filename>debian/"
2597 "rules</filename>."
2598 msgstr ""
2599
2600 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2601 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2602 #: pkgs.dbk:1570
2603 msgid ""
2604 "Make sure you don't rely on locally installed or hacked configurations or "
2605 "programs.  For instance, you should never be calling programs in <filename>/"
2606 "usr/local/bin</filename> or the like.  Try not to rely on programs being "
2607 "setup in a special way.  Try building your package on another machine, even "
2608 "if it's the same architecture."
2609 msgstr ""
2610
2611 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2612 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2613 #: pkgs.dbk:1579
2614 msgid ""
2615 "Don't depend on the package you're building being installed already (a sub-"
2616 "case of the above issue). There are, of course, exceptions to this rule, but "
2617 "be aware that any case like this needs manual bootstrapping and cannot be "
2618 "done by automated package builders."
2619 msgstr ""
2620
2621 # type: Content of: <chapter><section><section><orderedlist><listitem><para>
2622 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2623 #: pkgs.dbk:1587
2624 msgid ""
2625 "Don't rely on the compiler being a certain version, if possible.  If not, "
2626 "then make sure your build dependencies reflect the restrictions, although "
2627 "you are probably asking for trouble, since different architectures sometimes "
2628 "standardize on different compilers."
2629 msgstr ""
2630
2631 #. type: Content of: <chapter><section><section><orderedlist><listitem><para>
2632 #: pkgs.dbk:1595
2633 msgid ""
2634 "Make sure your <filename>debian/rules</filename> contains separate "
2635 "<literal>binary-arch</literal> and <literal>binary-indep</literal> targets, "
2636 "as the Debian Policy Manual requires.  Make sure that both targets work "
2637 "independently, that is, that you can call the target without having called "
2638 "the other before.  To test this, try to run <command>dpkg-buildpackage -B</"
2639 "command>."
2640 msgstr ""
2641
2642 # type: Content of: <chapter><section><section><title>
2643 #. type: Content of: <chapter><section><section><title>
2644 #: pkgs.dbk:1606
2645 msgid "Guidelines for porter uploads"
2646 msgstr ""
2647
2648 # type: Content of: <chapter><section><section><para>
2649 #. type: Content of: <chapter><section><section><para>
2650 #: pkgs.dbk:1608
2651 msgid ""
2652 "If the package builds out of the box for the architecture to be ported to, "
2653 "you are in luck and your job is easy.  This section applies to that case; it "
2654 "describes how to build and upload your binary package so that it is properly "
2655 "installed into the archive.  If you do have to patch the package in order to "
2656 "get it to compile for the other architecture, you are actually doing a "
2657 "source NMU, so consult <xref linkend=\"nmu-guidelines\"/> instead."
2658 msgstr ""
2659
2660 # type: Content of: <chapter><section><section><para>
2661 #. type: Content of: <chapter><section><section><para>
2662 #: pkgs.dbk:1616
2663 msgid ""
2664 "For a porter upload, no changes are being made to the source.  You do not "
2665 "need to touch any of the files in the source package.  This includes "
2666 "<filename>debian/changelog</filename>."
2667 msgstr ""
2668
2669 #. type: Content of: <chapter><section><section><para>
2670 #: pkgs.dbk:1621
2671 msgid ""
2672 "The way to invoke <command>dpkg-buildpackage</command> is as <literal>dpkg-"
2673 "buildpackage -B -m<replaceable>porter-email</replaceable></literal>.  Of "
2674 "course, set <replaceable>porter-email</replaceable> to your email address.  "
2675 "This will do a binary-only build of only the architecture-dependent portions "
2676 "of the package, using the <literal>binary-arch</literal> target in "
2677 "<filename>debian/rules</filename>."
2678 msgstr ""
2679
2680 # type: Content of: <chapter><section><section><para>
2681 #. type: Content of: <chapter><section><section><para>
2682 #: pkgs.dbk:1630
2683 msgid ""
2684 "If you are working on a Debian machine for your porting efforts and you need "
2685 "to sign your upload locally for its acceptance in the archive, you can run "
2686 "<command>debsign</command> on your <filename>.changes</filename> file to "
2687 "have it signed conveniently, or use the remote signing mode of <command>dpkg-"
2688 "sig</command>."
2689 msgstr ""
2690
2691 # type: Content of: <chapter><section><section><section><title>
2692 #. type: Content of: <chapter><section><section><section><title>
2693 #: pkgs.dbk:1637
2694 msgid "Recompilation or binary-only NMU"
2695 msgstr ""
2696
2697 #. type: Content of: <chapter><section><section><section><para>
2698 #: pkgs.dbk:1639
2699 msgid ""
2700 "Sometimes the initial porter upload is problematic because the environment "
2701 "in which the package was built was not good enough (outdated or obsolete "
2702 "library, bad compiler, etc.).  Then you may just need to recompile it in an "
2703 "updated environment.  However, you have to bump the version number in this "
2704 "case, so that the old bad package can be replaced in the Debian archive "
2705 "(<command>dak</command> refuses to install new packages if they don't have a "
2706 "version number greater than the currently available one)."
2707 msgstr ""
2708
2709 #. type: Content of: <chapter><section><section><section><para>
2710 #: pkgs.dbk:1648
2711 msgid ""
2712 "You have to make sure that your binary-only NMU doesn't render the package "
2713 "uninstallable.  This could happen when a source package generates arch-"
2714 "dependent and arch-independent packages that have inter-dependencies "
2715 "generated using dpkg's substitution variable <literal>$(Source-Version)</"
2716 "literal>."
2717 msgstr ""
2718
2719 # type: Content of: <chapter><section><section><section><para>
2720 #. type: Content of: <chapter><section><section><section><para>
2721 #: pkgs.dbk:1654
2722 msgid ""
2723 "Despite the required modification of the changelog, these are called binary-"
2724 "only NMUs — there is no need in this case to trigger all other architectures "
2725 "to consider themselves out of date or requiring recompilation."
2726 msgstr ""
2727
2728 # type: Content of: <chapter><section><section><section><para>
2729 #. type: Content of: <chapter><section><section><section><para>
2730 #: pkgs.dbk:1659
2731 msgid ""
2732 "Such recompilations require special ``magic'' version numbering, so that the "
2733 "archive maintenance tools recognize that, even though there is a new Debian "
2734 "version, there is no corresponding source update.  If you get this wrong, "
2735 "the archive maintainers will reject your upload (due to lack of "
2736 "corresponding source code)."
2737 msgstr ""
2738
2739 # type: Content of: <chapter><section><section><section><para><footnote><para>
2740 #. type: Content of: <chapter><section><section><section><para><footnote><para>
2741 #: pkgs.dbk:1674
2742 msgid ""
2743 "In the past, such NMUs used the third-level number on the Debian part of the "
2744 "revision to denote their recompilation-only status; however, this syntax was "
2745 "ambiguous with native packages and did not allow proper ordering of "
2746 "recompile-only NMUs, source NMUs, and security NMUs on the same package, and "
2747 "has therefore been abandoned in favor of this new syntax."
2748 msgstr ""
2749
2750 #. type: Content of: <chapter><section><section><section><para>
2751 #: pkgs.dbk:1666
2752 msgid ""
2753 "The ``magic'' for a recompilation-only NMU is triggered by using a suffix "
2754 "appended to the package version number, following the form "
2755 "<literal>b<replaceable>number</replaceable></literal>.  For instance, if the "
2756 "latest version you are recompiling against was version <literal>2.9-3</"
2757 "literal>, your binary-only NMU should carry a version of <literal>2.9-3+b1</"
2758 "literal>.  If the latest version was <literal>3.4+b1</literal> (i.e, a "
2759 "native package with a previous recompilation NMU), your binary-only NMU "
2760 "should have a version number of <literal>3.4+b2</literal>.<placeholder type="
2761 "\"footnote\" id=\"0\"/>"
2762 msgstr ""
2763
2764 # type: Content of: <chapter><section><section><section><para>
2765 #. type: Content of: <chapter><section><section><section><para>
2766 #: pkgs.dbk:1682
2767 msgid ""
2768 "Similar to initial porter uploads, the correct way of invoking <command>dpkg-"
2769 "buildpackage</command> is <literal>dpkg-buildpackage -B</literal> to only "
2770 "build the architecture-dependent parts of the package."
2771 msgstr ""
2772
2773 # type: Content of: <chapter><section><section><section><title>
2774 #. type: Content of: <chapter><section><section><section><title>
2775 #: pkgs.dbk:1689
2776 msgid "When to do a source NMU if you are a porter"
2777 msgstr ""
2778
2779 #. type: Content of: <chapter><section><section><section><para>
2780 #: pkgs.dbk:1691
2781 msgid ""
2782 "Porters doing a source NMU generally follow the guidelines found in <xref "
2783 "linkend=\"nmu\"/>, just like non-porters.  However, it is expected that the "
2784 "wait cycle for a porter's source NMU is smaller than for a non-porter, since "
2785 "porters have to cope with a large quantity of packages.  Again, the "
2786 "situation varies depending on the distribution they are uploading to.  It "
2787 "also varies whether the architecture is a candidate for inclusion into the "
2788 "next stable release; the release managers decide and announce which "
2789 "architectures are candidates."
2790 msgstr ""
2791
2792 #. type: Content of: <chapter><section><section><section><para>
2793 #: pkgs.dbk:1700
2794 msgid ""
2795 "If you are a porter doing an NMU for <literal>unstable</literal>, the above "
2796 "guidelines for porting should be followed, with two variations.  Firstly, "
2797 "the acceptable waiting period — the time between when the bug is submitted "
2798 "to the BTS and when it is OK to do an NMU — is seven days for porters "
2799 "working on the <literal>unstable</literal> distribution.  This period can be "
2800 "shortened if the problem is critical and imposes hardship on the porting "
2801 "effort, at the discretion of the porter group.  (Remember, none of this is "
2802 "Policy, just mutually agreed upon guidelines.) For uploads to "
2803 "<literal>stable</literal> or <literal>testing</literal>, please coordinate "
2804 "with the appropriate release team first."
2805 msgstr ""
2806
2807 # type: Content of: <chapter><section><section><section><para>
2808 #. type: Content of: <chapter><section><section><section><para>
2809 #: pkgs.dbk:1712
2810 msgid ""
2811 "Secondly, porters doing source NMUs should make sure that the bug they "
2812 "submit to the BTS should be of severity <literal>serious</literal> or "
2813 "greater.  This ensures that a single source package can be used to compile "
2814 "every supported Debian architecture by release time.  It is very important "
2815 "that we have one version of the binary and source package for all "
2816 "architectures in order to comply with many licenses."
2817 msgstr ""
2818
2819 # type: Content of: <chapter><section><section><section><para>
2820 #. type: Content of: <chapter><section><section><section><para>
2821 #: pkgs.dbk:1720
2822 msgid ""
2823 "Porters should try to avoid patches which simply kludge around bugs in the "
2824 "current version of the compile environment, kernel, or libc.  Sometimes such "
2825 "kludges can't be helped.  If you have to kludge around compiler bugs and the "
2826 "like, make sure you <literal>#ifdef</literal> your work properly; also, "
2827 "document your kludge so that people know to remove it once the external "
2828 "problems have been fixed."
2829 msgstr ""
2830
2831 # type: Content of: <chapter><section><section><section><para>
2832 #. type: Content of: <chapter><section><section><section><para>
2833 #: pkgs.dbk:1728
2834 msgid ""
2835 "Porters may also have an unofficial location where they can put the results "
2836 "of their work during the waiting period.  This helps others running the port "
2837 "have the benefit of the porter's work, even during the waiting period.  Of "
2838 "course, such locations have no official blessing or status, so buyer beware."
2839 msgstr ""
2840
2841 # type: Content of: <chapter><section><section><title>
2842 #. type: Content of: <chapter><section><section><title>
2843 #: pkgs.dbk:1738
2844 msgid "Porting infrastructure and automation"
2845 msgstr ""
2846
2847 # type: Content of: <chapter><section><section><para>
2848 #. type: Content of: <chapter><section><section><para>
2849 #: pkgs.dbk:1740
2850 msgid ""
2851 "There is infrastructure and several tools to help automate package porting.  "
2852 "This section contains a brief overview of this automation and porting to "
2853 "these tools; see the package documentation or references for full "
2854 "information."
2855 msgstr ""
2856
2857 # type: Content of: <chapter><section><section><section><title>
2858 #. type: Content of: <chapter><section><section><section><title>
2859 #: pkgs.dbk:1745
2860 msgid "Mailing lists and web pages"
2861 msgstr "メーリングリストとウェブページ"
2862
2863 # type: Content of: <chapter><section><section><section><para>
2864 #. type: Content of: <chapter><section><section><section><para>
2865 #: pkgs.dbk:1747
2866 msgid ""
2867 "Web pages containing the status of each port can be found at <ulink url="
2868 "\"&url-debian-ports;\"></ulink>."
2869 msgstr ""
2870
2871 # type: Content of: <chapter><section><section><section><para>
2872 #. type: Content of: <chapter><section><section><section><para>
2873 #: pkgs.dbk:1751
2874 msgid ""
2875 "Each port of Debian has a mailing list.  The list of porting mailing lists "
2876 "can be found at <ulink url=\"&url-debian-port-lists;\"></ulink>.  These "
2877 "lists are used to coordinate porters, and to connect the users of a given "
2878 "port with the porters."
2879 msgstr ""
2880
2881 # type: Content of: <chapter><section><section><section><title>
2882 #. type: Content of: <chapter><section><section><section><title>
2883 #: pkgs.dbk:1759
2884 msgid "Porter tools"
2885 msgstr "移植用ツール"
2886
2887 # type: Content of: <chapter><section><section><section><para>
2888 #. type: Content of: <chapter><section><section><section><para>
2889 #: pkgs.dbk:1761
2890 msgid ""
2891 "Descriptions of several porting tools can be found in <xref linkend=\"tools-"
2892 "porting\"/>."
2893 msgstr ""
2894
2895 # type: Content of: <chapter><section><section><section><title>
2896 #. type: Content of: <chapter><section><section><section><title>
2897 #: pkgs.dbk:1767
2898 msgid "<systemitem role=\"package\">wanna-build</systemitem>"
2899 msgstr ""
2900
2901 #. type: Content of: <chapter><section><section><section><para>
2902 #: pkgs.dbk:1769
2903 msgid ""
2904 "The <systemitem role=\"package\">wanna-build</systemitem> system is used as "
2905 "a distributed, client-server build distribution system.  It is usually used "
2906 "in conjunction with build daemons running the <systemitem role=\"package"
2907 "\">buildd</systemitem> program. <literal>Build daemons</literal> are "
2908 "``slave'' hosts which contact the central <systemitem role=\"package\">wanna-"
2909 "build</systemitem> system to receive a list of packages that need to be "
2910 "built."
2911 msgstr ""
2912
2913 # type: Content of: <chapter><section><section><section><para>
2914 #. type: Content of: <chapter><section><section><section><para>
2915 #: pkgs.dbk:1777
2916 msgid ""
2917 "<systemitem role=\"package\">wanna-build</systemitem> is not yet available "
2918 "as a package; however, all Debian porting efforts are using it for automated "
2919 "package building.  The tool used to do the actual package builds, "
2920 "<systemitem role=\"package\">sbuild</systemitem> is available as a package, "
2921 "see its description in <xref linkend=\"sbuild\"/>.  Please note that the "
2922 "packaged version is not the same as the one used on build daemons, but it is "
2923 "close enough to reproduce problems."
2924 msgstr ""
2925
2926 #. type: Content of: <chapter><section><section><section><para>
2927 #: pkgs.dbk:1786
2928 msgid ""
2929 "Most of the data produced by <systemitem role=\"package\">wanna-build</"
2930 "systemitem> which is generally useful to porters is available on the web at "
2931 "<ulink url=\"&url-buildd;\"></ulink>.  This data includes nightly updated "
2932 "statistics, queueing information and logs for build attempts."
2933 msgstr ""
2934
2935 # type: Content of: <chapter><section><section><section><para>
2936 #. type: Content of: <chapter><section><section><section><para>
2937 #: pkgs.dbk:1792
2938 msgid ""
2939 "We are quite proud of this system, since it has so many possible uses.  "
2940 "Independent development groups can use the system for different sub-flavors "
2941 "of Debian, which may or may not really be of general interest (for instance, "
2942 "a flavor of Debian built with <command>gcc</command> bounds checking).  It "
2943 "will also enable Debian to recompile entire distributions quickly."
2944 msgstr ""
2945
2946 #. type: Content of: <chapter><section><section><section><para>
2947 #: pkgs.dbk:1799
2948 msgid ""
2949 "The wanna-build team, in charge of the buildds, can be reached at "
2950 "<literal>debian-wb-team@lists.debian.org</literal>.  To determine who (wanna-"
2951 "build team, release team) and how (mail, BTS)  to contact, refer to <ulink "
2952 "url=\"&url-wb-team;\"></ulink>."
2953 msgstr ""
2954
2955 #. type: Content of: <chapter><section><section><section><para>
2956 #: pkgs.dbk:1806
2957 msgid ""
2958 "When requesting binNMUs or give-backs (retries after a failed build), please "
2959 "use the format described at <ulink url=\"&url-release-wb;\"/>."
2960 msgstr ""
2961
2962 # type: Content of: <chapter><section><section><title>
2963 #. type: Content of: <chapter><section><section><title>
2964 #: pkgs.dbk:1815
2965 msgid "When your package is <emphasis>not</emphasis> portable"
2966 msgstr ""
2967
2968 # type: Content of: <chapter><section><section><para>
2969 #. type: Content of: <chapter><section><section><para>
2970 #: pkgs.dbk:1817
2971 msgid ""
2972 "Some packages still have issues with building and/or working on some of the "
2973 "architectures supported by Debian, and cannot be ported at all, or not "
2974 "within a reasonable amount of time.  An example is a package that is SVGA-"
2975 "specific (only available for <literal>i386</literal> and <literal>amd64</"
2976 "literal>), or uses other hardware-specific features not supported on all "
2977 "architectures."
2978 msgstr ""
2979
2980 # type: Content of: <chapter><section><section><para>
2981 #. type: Content of: <chapter><section><section><para>
2982 #: pkgs.dbk:1824
2983 msgid ""
2984 "In order to prevent broken packages from being uploaded to the archive, and "
2985 "wasting buildd time, you need to do a few things:"
2986 msgstr ""
2987
2988 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
2989 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
2990 #: pkgs.dbk:1830
2991 msgid ""
2992 "First, make sure your package <emphasis>does</emphasis> fail to build on "
2993 "architectures that it cannot support.  There are a few ways to achieve "
2994 "this.  The preferred way is to have a small testsuite during build time that "
2995 "will test the functionality, and fail if it doesn't work.  This is a good "
2996 "idea anyway, as this will prevent (some) broken uploads on all "
2997 "architectures, and also will allow the package to build as soon as the "
2998 "required functionality is available."
2999 msgstr ""
3000
3001 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3002 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3003 #: pkgs.dbk:1838
3004 msgid ""
3005 "Additionally, if you believe the list of supported architectures is pretty "
3006 "constant, you should change <literal>any</literal> to a list of supported "
3007 "architectures in <filename>debian/control</filename>.  This way, the build "
3008 "will fail also, and indicate this to a human reader without actually trying."
3009 msgstr ""
3010
3011 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3012 #: pkgs.dbk:1846
3013 msgid ""
3014 "In order to prevent autobuilders from needlessly trying to build your "
3015 "package, it must be included in <filename>Packages-arch-specific</filename>, "
3016 "a list used by the <command>wanna-build</command> script.  The current "
3017 "version is available as <ulink url=\"&url-buildd-p-a-s;\"/>; please see the "
3018 "top of the file for whom to contact for changes."
3019 msgstr ""
3020
3021 #. type: Content of: <chapter><section><section><para>
3022 #: pkgs.dbk:1855
3023 msgid ""
3024 "Please note that it is insufficient to only add your package to "
3025 "<filename>Packages-arch-specific</filename> without making it fail to build "
3026 "on unsupported architectures: A porter or any other person trying to build "
3027 "your package might accidently upload it without noticing it doesn't work.  "
3028 "If in the past some binary packages were uploaded on unsupported "
3029 "architectures, request their removal by filing a bug against <systemitem "
3030 "role=\"package\">ftp.debian.org</systemitem>."
3031 msgstr ""
3032
3033 # type: Content of: <chapter><section><title>
3034 #. type: Content of: <chapter><section><title>
3035 #: pkgs.dbk:1868
3036 msgid "Non-Maintainer Uploads (NMUs)"
3037 msgstr ""
3038
3039 #. type: Content of: <chapter><section><para>
3040 #: pkgs.dbk:1870
3041 msgid ""
3042 "Every package has one or more maintainers. Normally, these are the people "
3043 "who work on and upload new versions of the package. In some situations, it "
3044 "is useful that other developers can upload a new version as well, for "
3045 "example if they want to fix a bug in a package they don't maintain, when the "
3046 "maintainer needs help to respond to issues.  Such uploads are called "
3047 "<emphasis>Non-Maintainer Uploads (NMU)</emphasis>."
3048 msgstr ""
3049
3050 # type: Content of: <chapter><section><section><title>
3051 #. type: Content of: <chapter><section><section><title>
3052 #: pkgs.dbk:1879
3053 msgid "When and how to do an NMU"
3054 msgstr "いつ、どうやって NMU を行うか"
3055
3056 #. type: Content of: <chapter><section><section><para>
3057 #: pkgs.dbk:1882
3058 msgid "Before doing an NMU, consider the following questions:"
3059 msgstr "NMU を行う前に、以下の質問について考えてください:"
3060
3061 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3062 #: pkgs.dbk:1887
3063 msgid ""
3064 "Does your NMU really fix bugs? Fixing cosmetic issues or changing the "
3065 "packaging style in NMUs is discouraged."
3066 msgstr ""
3067
3068 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3069 #: pkgs.dbk:1893
3070 msgid ""
3071 "Did you give enough time to the maintainer? When was the bug reported to the "
3072 "BTS? Being busy for a week or two isn't unusual.  Is the bug so severe that "
3073 "it needs to be fixed right now, or can it wait a few more days?"
3074 msgstr ""
3075
3076 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3077 #: pkgs.dbk:1900
3078 msgid ""
3079 "How confident are you about your changes? Please remember the Hippocratic "
3080 "Oath: \"Above all, do no harm.\" It is better to leave a package with an "
3081 "open grave bug than applying a non-functional patch, or one that hides the "
3082 "bug instead of resolving it. If you are not 100% sure of what you did, it "
3083 "might be a good idea to seek advice from others. Remember that if you break "
3084 "something in your NMU, many people will be very unhappy about it."
3085 msgstr ""
3086
3087 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3088 #: pkgs.dbk:1910
3089 msgid ""
3090 "Have you clearly expressed your intention to NMU, at least in the BTS? It is "
3091 "also a good idea to try to contact the maintainer by other means (private "
3092 "email, IRC)."
3093 msgstr ""
3094
3095 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3096 #: pkgs.dbk:1917
3097 msgid ""
3098 "If the maintainer is usually active and responsive, have you tried to "
3099 "contact him? In general it should be considered preferable that a maintainer "
3100 "takes care of an issue himself and that he is given the chance to review and "
3101 "correct your patch, because he can be expected to be more aware of potential "
3102 "issues which an NMUer might miss. It is often a better use of everyone's "
3103 "time if the maintainer is given an opportunity to upload a fix on their own."
3104 msgstr ""
3105
3106 #. type: Content of: <chapter><section><section><para>
3107 #: pkgs.dbk:1927
3108 msgid ""
3109 "When doing an NMU, you must first make sure that your intention to NMU is "
3110 "clear.  Then, you must send a patch with the differences between the current "
3111 "package and your proposed NMU to the BTS. The <command>nmudiff</command> "
3112 "script in the <systemitem role=\"package\">devscripts</systemitem> package "
3113 "might be helpful."
3114 msgstr ""
3115
3116 #. type: Content of: <chapter><section><section><para>
3117 #: pkgs.dbk:1934
3118 msgid ""
3119 "While preparing the patch, you should better be aware of any package-"
3120 "specific practices that the maintainer might be using. Taking them into "
3121 "account reduces the burden of getting your changes integrated back in the "
3122 "normal package workflow and thus increases the possibilities that that will "
3123 "happen. A good place where to look for for possible package-specific "
3124 "practices is <ulink url=\"&url-debian-policy;ch-source.html#s-readmesource"
3125 "\"><filename>debian/README.source</filename></ulink>."
3126 msgstr ""
3127
3128 #. type: Content of: <chapter><section><section><para>
3129 #: pkgs.dbk:1942
3130 msgid ""
3131 "Unless you have an excellent reason not to do so, you must then give some "
3132 "time to the maintainer to react (for example, by uploading to the "
3133 "<literal>DELAYED</literal> queue).  Here are some recommended values to use "
3134 "for delays:"
3135 msgstr ""
3136
3137 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3138 #: pkgs.dbk:1949
3139 msgid "Upload fixing only release-critical bugs older than 7 days: 2 days"
3140 msgstr ""
3141
3142 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3143 #: pkgs.dbk:1954
3144 msgid "Upload fixing only release-critical and important bugs: 5 days"
3145 msgstr ""
3146
3147 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3148 #: pkgs.dbk:1959
3149 msgid "Other NMUs: 10 days"
3150 msgstr ""
3151
3152 #. type: Content of: <chapter><section><section><para>
3153 #: pkgs.dbk:1965
3154 msgid ""
3155 "Those delays are only examples. In some cases, such as uploads fixing "
3156 "security issues, or fixes for trivial bugs that blocking a transition, it is "
3157 "desirable that the fixed package reaches <literal>unstable</literal> sooner."
3158 msgstr ""
3159
3160 #. type: Content of: <chapter><section><section><para>
3161 #: pkgs.dbk:1971
3162 msgid ""
3163 "Sometimes, release managers decide to allow NMUs with shorter delays for a "
3164 "subset of bugs (e.g release-critical bugs older than 7 days). Also, some "
3165 "maintainers list themselves in the <ulink url=\"&url-low-threshold-nmu;"
3166 "\">Low Threshold NMU list</ulink>, and accept that NMUs are uploaded without "
3167 "delay. But even in those cases, it's still a good idea to give the "
3168 "maintainer a few days to react before you upload, especially if the patch "
3169 "wasn't available in the BTS before, or if you know that the maintainer is "
3170 "generally active."
3171 msgstr ""
3172
3173 #. type: Content of: <chapter><section><section><para>
3174 #: pkgs.dbk:1981
3175 msgid ""
3176 "After you upload an NMU, you are responsible for the possible problems that "
3177 "you might have introduced. You must keep an eye on the package (subscribing "
3178 "to the package on the PTS is a good way to achieve this)."
3179 msgstr ""
3180
3181 #. type: Content of: <chapter><section><section><para>
3182 #: pkgs.dbk:1987
3183 msgid ""
3184 "This is not a license to perform NMUs thoughtlessly.  If you NMU when it is "
3185 "clear that the maintainers are active and would have acknowledged a patch in "
3186 "a timely manner, or if you ignore the recommendations of this document, your "
3187 "upload might be a cause of conflict with the maintainer.  You should always "
3188 "be prepared to defend the wisdom of any NMU you perform on its own merits."
3189 msgstr ""
3190
3191 #. type: Content of: <chapter><section><section><title>
3192 #: pkgs.dbk:1997
3193 msgid "NMUs and <filename>debian/changelog</filename>"
3194 msgstr "NMU と <filename>debian/changelog</filename>"
3195
3196 #. type: Content of: <chapter><section><section><para>
3197 #: pkgs.dbk:1999
3198 msgid ""
3199 "Just like any other (source) upload, NMUs must add an entry to "
3200 "<filename>debian/changelog</filename>, telling what has changed with this "
3201 "upload.  The first line of this entry must explicitely mention that this "
3202 "upload is an NMU, e.g.:"
3203 msgstr ""
3204
3205 # type: Content of: <chapter><section><section><screen>
3206 #. type: Content of: <chapter><section><section><screen>
3207 #: pkgs.dbk:2004
3208 #, no-wrap
3209 msgid "  * Non-maintainer upload.\n"
3210 msgstr "  * Non-maintainer upload.\n"
3211
3212 #. type: Content of: <chapter><section><section><para>
3213 #: pkgs.dbk:2008
3214 msgid "The way to version NMUs differs for native and non-native packages."
3215 msgstr ""
3216
3217 #. type: Content of: <chapter><section><section><para>
3218 #: pkgs.dbk:2011
3219 msgid ""
3220 "If the package is a native package (without a Debian revision in the version "
3221 "number), the version must be the version of the last maintainer upload, plus "
3222 "<literal>+nmu<replaceable>X</replaceable></literal>, where <replaceable>X</"
3223 "replaceable> is a counter starting at <literal>1</literal>.  If the last "
3224 "upload was also an NMU, the counter should be increased.  For example, if "
3225 "the current version is <literal>1.5</literal>, then an NMU would get version "
3226 "<literal>1.5+nmu1</literal>."
3227 msgstr ""
3228
3229 #. type: Content of: <chapter><section><section><para>
3230 #: pkgs.dbk:2021
3231 msgid ""
3232 "If the package is a not a native package, you should add a minor version "
3233 "number to the Debian revision part of the version number (the portion after "
3234 "the last hyphen). This extra number must start at <literal>1</literal>.  For "
3235 "example, if the current version is <literal>1.5-2</literal>, then an NMU "
3236 "would get version <literal>1.5-2.1</literal>. If a new upstream version is "
3237 "packaged in the NMU, the Debian revision is set to <literal>0</literal>, for "
3238 "example <literal>1.6-0.1</literal>."
3239 msgstr ""
3240
3241 #. type: Content of: <chapter><section><section><para>
3242 #: pkgs.dbk:2030
3243 msgid ""
3244 "In both cases, if the last upload was also an NMU, the counter should be "
3245 "increased. For example, if the current version is <literal>1.5+nmu3</"
3246 "literal> (a native package which has already been NMUed), the NMU would get "
3247 "version <literal>1.5+nmu4</literal>."
3248 msgstr ""
3249
3250 #. type: Content of: <chapter><section><section><para>
3251 #: pkgs.dbk:2036
3252 msgid ""
3253 "A special versioning scheme is needed to avoid disrupting the maintainer's "
3254 "work, since using an integer for the Debian revision will potentially "
3255 "conflict with a maintainer upload already in preparation at the time of an "
3256 "NMU, or even one sitting in the ftp NEW queue.  It also has the benefit of "
3257 "making it visually clear that a package in the archive was not made by the "
3258 "official maintainer."
3259 msgstr ""
3260
3261 #. type: Content of: <chapter><section><section><para>
3262 #: pkgs.dbk:2046
3263 msgid ""
3264 "If you upload a package to testing or stable, you sometimes need to \"fork\" "
3265 "the version number tree. This is the case for security uploads, for "
3266 "example.  For this, a version of the form <literal>+deb<replaceable>XY</"
3267 "replaceable>u<replaceable>Z</replaceable></literal> should be used, where "
3268 "<replaceable>X</replaceable> and <replaceable>Y</replaceable> are the major "
3269 "and minor release numbers, and <replaceable>Z</replaceable> is a counter "
3270 "starting at <literal>1</literal>.  When the release number is not yet known "
3271 "(often the case for <literal>testing</literal>, at the beginning of release "
3272 "cycles), the lowest release number higher than the last stable release "
3273 "number must be used.  For example, while Lenny (Debian 5.0) is stable, a "
3274 "security NMU to stable for a package at version <literal>1.5-3</literal> "
3275 "would have version <literal>1.5-3+deb50u1</literal>, whereas a security NMU "
3276 "to Squeeze would get version <literal>1.5-3+deb60u1</literal>. After the "
3277 "release of Squeeze, security uploads to the <literal>testing</literal> "
3278 "distribution will be versioned <literal>+deb61uZ</literal>, until it is "
3279 "known whether that release will be Debian 6.1 or Debian 7.0 (if that becomes "
3280 "the case, uploads will be versioned as <literal>+deb70uZ</literal>)."
3281 msgstr ""
3282
3283 # type: Content of: <chapter><section><section><title>
3284 #. type: Content of: <chapter><section><section><title>
3285 #: pkgs.dbk:2068
3286 msgid "Using the <literal>DELAYED/</literal> queue"
3287 msgstr "<literal>DELAYED/</literal> キューを使う"
3288
3289 #. type: Content of: <chapter><section><section><para>
3290 #: pkgs.dbk:2071
3291 msgid ""
3292 "Having to wait for a response after you request permission to NMU is "
3293 "inefficient, because it costs the NMUer a context switch to come back to the "
3294 "issue.  The <literal>DELAYED</literal> queue (see <xref linkend=\"delayed-"
3295 "incoming\"/>)  allows the developer doing the NMU to perform all the "
3296 "necessary tasks at the same time. For instance, instead of telling the "
3297 "maintainer that you will upload the updated package in 7 days, you should "
3298 "upload the package to <literal>DELAYED/7</literal> and tell the maintainer "
3299 "that he has 7 days to react.  During this time, the maintainer can ask you "
3300 "to delay the upload some more, or cancel your upload."
3301 msgstr ""
3302
3303 #. type: Content of: <chapter><section><section><para>
3304 #: pkgs.dbk:2085
3305 msgid ""
3306 "The <literal>DELAYED</literal> queue should not be used to put additional "
3307 "pressure on the maintainer. In particular, it's important that you are "
3308 "available to cancel or delay the upload before the delay expires since the "
3309 "maintainer cannot cancel the upload himself."
3310 msgstr ""
3311
3312 #. type: Content of: <chapter><section><section><para>
3313 #: pkgs.dbk:2092
3314 msgid ""
3315 "If you make an NMU to <literal>DELAYED</literal> and the maintainer updates "
3316 "his package before the delay expires, your upload will be rejected because a "
3317 "newer version is already available in the archive.  Ideally, the maintainer "
3318 "will take care to include your proposed changes (or at least a solution for "
3319 "the problems they address) in that upload."
3320 msgstr ""
3321
3322 #. type: Content of: <chapter><section><section><title>
3323 #: pkgs.dbk:2102
3324 msgid "NMUs from the maintainer's point of view"
3325 msgstr ""
3326
3327 #. type: Content of: <chapter><section><section><para>
3328 #: pkgs.dbk:2105
3329 msgid ""
3330 "When someone NMUs your package, this means they want to help you to keep it "
3331 "in good shape.  This gives users fixed packages faster.  You can consider "
3332 "asking the NMUer to become a co-maintainer of the package.  Receiving an NMU "
3333 "on a package is not a bad thing; it just means that the package is "
3334 "interesting enough for other people to work on it."
3335 msgstr ""
3336
3337 #. type: Content of: <chapter><section><section><para>
3338 #: pkgs.dbk:2114
3339 msgid ""
3340 "To acknowledge an NMU, include its changes and changelog entry in your next "
3341 "maintainer upload.  If you do not acknowledge the NMU by including the NMU "
3342 "changelog entry in your changelog, the bugs will remain closed in the BTS "
3343 "but will be listed as affecting your maintainer version of the package."
3344 msgstr ""
3345
3346 #. type: Content of: <chapter><section><section><title>
3347 #: pkgs.dbk:2123
3348 msgid "Source NMUs vs Binary-only NMUs (binNMUs)"
3349 msgstr ""
3350
3351 #. type: Content of: <chapter><section><section><para>
3352 #: pkgs.dbk:2126
3353 msgid ""
3354 "The full name of an NMU is <emphasis>source NMU</emphasis>.  There is also "
3355 "another type, namely the <emphasis>binary-only NMU</emphasis>, or "
3356 "<emphasis>binNMU</emphasis>.  A binNMU is also a package upload by someone "
3357 "other than the package's maintainer.  However, it is a binary-only upload."
3358 msgstr ""
3359
3360 #. type: Content of: <chapter><section><section><para>
3361 #: pkgs.dbk:2133
3362 msgid ""
3363 "When a library (or other dependency) is updated, the packages using it may "
3364 "need to be rebuilt.  Since no changes to the source are needed, the same "
3365 "source package is used."
3366 msgstr ""
3367
3368 #. type: Content of: <chapter><section><section><para>
3369 #: pkgs.dbk:2139
3370 msgid ""
3371 "BinNMUs are usually triggered on the buildds by wanna-build.  An entry is "
3372 "added to <filename>debian/changelog</filename>, explaining why the upload "
3373 "was needed and increasing the version number as described in <xref linkend="
3374 "\"binary-only-nmu\"/>.  This entry should not be included in the next upload."
3375 msgstr ""
3376
3377 #. type: Content of: <chapter><section><section><para>
3378 #: pkgs.dbk:2147
3379 msgid ""
3380 "Buildds upload packages for their architecture to the archive as binary-only "
3381 "uploads.  Strictly speaking, these are binNMUs.  However, they are not "
3382 "normally called NMU, and they don't add an entry to <filename>debian/"
3383 "changelog</filename>."
3384 msgstr ""
3385
3386 #. type: Content of: <chapter><section><section><title>
3387 #: pkgs.dbk:2155
3388 msgid "NMUs vs QA uploads"
3389 msgstr "NMU vs QA アップロード"
3390
3391 #. type: Content of: <chapter><section><section><para>
3392 #: pkgs.dbk:2158
3393 msgid ""
3394 "NMUs are uploads of packages by somebody else than their assigned "
3395 "maintainer.  There is another type of upload where the uploaded package is "
3396 "not yours: QA uploads. QA uploads are uploads of orphaned packages."
3397 msgstr ""
3398
3399 #. type: Content of: <chapter><section><section><para>
3400 #: pkgs.dbk:2165
3401 msgid ""
3402 "QA uploads are very much like normal maintainer uploads: they may fix "
3403 "anything, even minor issues; the version numbering is normal, and there is "
3404 "no need to use a delayed upload.  The difference is that you are not listed "
3405 "as the <literal>Maintainer</literal> or <literal>Uploader</literal> for the "
3406 "package.  Also, the changelog entry of a QA upload has a special first line:"
3407 msgstr ""
3408
3409 #. type: Content of: <chapter><section><section><screen>
3410 #: pkgs.dbk:2173
3411 #, no-wrap
3412 msgid " * QA upload.\n"
3413 msgstr " * QA upload.\n"
3414
3415 #. type: Content of: <chapter><section><section><para>
3416 #: pkgs.dbk:2177
3417 msgid ""
3418 "If you want to do an NMU, and it seems that the maintainer is not active, it "
3419 "is wise to check if the package is orphaned (this information is displayed "
3420 "on the package's Package Tracking System page).  When doing the first QA "
3421 "upload to an orphaned package, the maintainer should be set to "
3422 "<literal>Debian QA Group &lt;packages@qa.debian.org&gt;</literal>.  Orphaned "
3423 "packages which did not yet have a QA upload still have their old maintainer "
3424 "set.  There is a list of them at <ulink url=\"&url-orphaned-not-qa;\"/>."
3425 msgstr ""
3426
3427 #. type: Content of: <chapter><section><section><para>
3428 #: pkgs.dbk:2188
3429 msgid ""
3430 "Instead of doing a QA upload, you can also consider adopting the package by "
3431 "making yourself the maintainer.  You don't need permission from anybody to "
3432 "adopt an orphaned package, you can just set yourself as maintainer and "
3433 "upload the new version (see <xref linkend=\"adopting\"/>)."
3434 msgstr ""
3435
3436 #. type: Content of: <chapter><section><section><title>
3437 #: pkgs.dbk:2197
3438 #, fuzzy
3439 msgid "NMUs vs team uploads"
3440 msgstr "NMU vs QA アップロード"
3441
3442 #. type: Content of: <chapter><section><section><para>
3443 #: pkgs.dbk:2200
3444 msgid ""
3445 "Sometimes you are fixing and/or updating a package because you are member of "
3446 "a packaging team (which uses a mailing list as <literal>Maintainer</literal> "
3447 "or <literal>Uploader</literal>, see <xref linkend=\"collaborative-maint\"/>) "
3448 "but you don't want to add yourself to <literal>Uploaders</literal> because "
3449 "you do not plan to contribute regularly to this specific package. If it "
3450 "conforms with your team's policy, you can perform a normal upload without "
3451 "being listed directly as <literal>Maintainer</literal> or <literal>Uploader</"
3452 "literal>. In that case, you should start your changelog entry with the "
3453 "following line:"
3454 msgstr ""
3455
3456 #. type: Content of: <chapter><section><section><screen>
3457 #: pkgs.dbk:2210
3458 #, fuzzy, no-wrap
3459 msgid " * Team upload.\n"
3460 msgstr " * QA upload.\n"
3461
3462 # type: Content of: <chapter><section><title>
3463 #. type: Content of: <chapter><section><title>
3464 #: pkgs.dbk:2218
3465 msgid "Collaborative maintenance"
3466 msgstr "共同メンテナンス"
3467
3468 #. type: Content of: <chapter><section><para>
3469 #: pkgs.dbk:2220
3470 msgid ""
3471 "Collaborative maintenance is a term describing the sharing of Debian package "
3472 "maintenance duties by several people.  This collaboration is almost always a "
3473 "good idea, since it generally results in higher quality and faster bug fix "
3474 "turnaround times.  It is strongly recommended that packages with a priority "
3475 "of <literal>standard</literal> or which are part of the base set have co-"
3476 "maintainers."
3477 msgstr ""
3478
3479 # type: Content of: <chapter><section><para>
3480 #. type: Content of: <chapter><section><para>
3481 #: pkgs.dbk:2228
3482 msgid ""
3483 "Generally there is a primary maintainer and one or more co-maintainers.  The "
3484 "primary maintainer is the person whose name is listed in the "
3485 "<literal>Maintainer</literal> field of the <filename>debian/control</"
3486 "filename> file.  Co-maintainers are all the other maintainers, usually "
3487 "listed in the <literal>Uploaders</literal> field of the <filename>debian/"
3488 "control</filename> file."
3489 msgstr ""
3490
3491 # type: Content of: <chapter><section><para>
3492 #. type: Content of: <chapter><section><para>
3493 #: pkgs.dbk:2236
3494 msgid ""
3495 "In its most basic form, the process of adding a new co-maintainer is quite "
3496 "easy:"
3497 msgstr ""
3498
3499 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
3500 #: pkgs.dbk:2242
3501 msgid ""
3502 "Setup the co-maintainer with access to the sources you build the package "
3503 "from.  Generally this implies you are using a network-capable version "
3504 "control system, such as <literal>CVS</literal> or <literal>Subversion</"
3505 "literal>.  Alioth (see <xref linkend=\"alioth\"/>) provides such tools, "
3506 "amongst others."
3507 msgstr ""
3508
3509 # type: Content of: <chapter><section><itemizedlist><listitem><para>
3510 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
3511 #: pkgs.dbk:2250
3512 msgid ""
3513 "Add the co-maintainer's correct maintainer name and address to the "
3514 "<literal>Uploaders</literal> field in the first paragraph of the "
3515 "<filename>debian/control</filename> file."
3516 msgstr ""
3517
3518 # type: Content of: <chapter><section><itemizedlist><listitem><screen>
3519 #. type: Content of: <chapter><section><itemizedlist><listitem><screen>
3520 #: pkgs.dbk:2255
3521 #, no-wrap
3522 msgid "Uploaders: John Buzz &lt;jbuzz@debian.org&gt;, Adam Rex &lt;arex@debian.org&gt;\n"
3523 msgstr "Uploaders: John Buzz &lt;jbuzz@debian.org&gt;, Adam Rex &lt;arex@debian.org&gt;\n"
3524
3525 # type: Content of: <chapter><section><itemizedlist><listitem><para>
3526 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
3527 #: pkgs.dbk:2260
3528 msgid ""
3529 "Using the PTS (<xref linkend=\"pkg-tracking-system\"/>), the co-maintainers "
3530 "should subscribe themselves to the appropriate source package."
3531 msgstr ""
3532
3533 #. type: Content of: <chapter><section><para>
3534 #: pkgs.dbk:2266
3535 msgid ""
3536 "Another form of collaborative maintenance is team maintenance, which is "
3537 "recommended if you maintain several packages with the same group of "
3538 "developers.  In that case, the <literal>Maintainer</literal> and "
3539 "<literal>Uploaders</literal> field of each package must be managed with "
3540 "care.  It is recommended to choose between one of the two following schemes:"
3541 msgstr ""
3542
3543 #. type: Content of: <chapter><section><orderedlist><listitem><para>
3544 #: pkgs.dbk:2275
3545 msgid ""
3546 "Put the team member mainly responsible for the package in the "
3547 "<literal>Maintainer</literal> field.  In the <literal>Uploaders</literal>, "
3548 "put the mailing list address, and the team members who care for the package."
3549 msgstr ""
3550
3551 #. type: Content of: <chapter><section><orderedlist><listitem><para>
3552 #: pkgs.dbk:2282
3553 msgid ""
3554 "Put the mailing list address in the <literal>Maintainer</literal> field.  In "
3555 "the <literal>Uploaders</literal> field, put the team members who care for "
3556 "the package.  In this case, you must make sure the mailing list accept bug "
3557 "reports without any human interaction (like moderation for non-subscribers)."
3558 msgstr ""
3559
3560 #. type: Content of: <chapter><section><para>
3561 #: pkgs.dbk:2291
3562 msgid ""
3563 "In any case, it is a bad idea to automatically put all team members in the "
3564 "<literal>Uploaders</literal> field. It clutters the Developer's Package "
3565 "Overview listing (see <xref linkend=\"ddpo\"/>) with packages one doesn't "
3566 "really care for, and creates a false sense of good maintenance. For the same "
3567 "reason, team members do not need to add themselves to the "
3568 "<literal>Uploaders</literal> field just because they are uploading the "
3569 "package once, they can do a “Team upload” (see <xref linkend=\"nmu-team-"
3570 "upload\"/>). Conversely, it it a bad idea to keep a package with only the "
3571 "mailing list address as a <literal>Maintainer</literal> and no "
3572 "<literal>Uploaders</literal>."
3573 msgstr ""
3574
3575 # type: Content of: <chapter><section><title>
3576 #. type: Content of: <chapter><section><title>
3577 #: pkgs.dbk:2304
3578 msgid "The testing distribution"
3579 msgstr "テスト版ディストリビューション"
3580
3581 # type: Content of: <chapter><section><section><title>
3582 #. type: Content of: <chapter><section><section><title>
3583 #: pkgs.dbk:2306
3584 msgid "Basics"
3585 msgstr "基本"
3586
3587 # type: Content of: <chapter><section><section><para>
3588 #. type: Content of: <chapter><section><section><para>
3589 #: pkgs.dbk:2308
3590 msgid ""
3591 "Packages are usually installed into the <literal>testing</literal> "
3592 "distribution after they have undergone some degree of <literal>testing</"
3593 "literal> in <literal>unstable</literal>."
3594 msgstr ""
3595
3596 #. type: Content of: <chapter><section><section><para>
3597 #: pkgs.dbk:2313
3598 msgid ""
3599 "They must be in sync on all architectures and mustn't have dependencies that "
3600 "make them uninstallable; they also have to have generally no known release-"
3601 "critical bugs at the time they're installed into <literal>testing</"
3602 "literal>.  This way, <literal>testing</literal> should always be close to "
3603 "being a release candidate.  Please see below for details."
3604 msgstr ""
3605
3606 # type: Content of: <chapter><section><section><title>
3607 #. type: Content of: <chapter><section><section><title>
3608 #: pkgs.dbk:2322
3609 msgid "Updates from unstable"
3610 msgstr "不安定版からの更新"
3611
3612 # type: Content of: <chapter><section><section><para>
3613 #. type: Content of: <chapter><section><section><para>
3614 #: pkgs.dbk:2324
3615 msgid ""
3616 "The scripts that update the <literal>testing</literal> distribution are run "
3617 "twice each day, right after the installation of the updated packages; these "
3618 "scripts are called <literal>britney</literal>.  They generate the "
3619 "<filename>Packages</filename> files for the <literal>testing</literal> "
3620 "distribution, but they do so in an intelligent manner; they try to avoid any "
3621 "inconsistency and to use only non-buggy packages."
3622 msgstr ""
3623
3624 # type: Content of: <chapter><section><section><para>
3625 #. type: Content of: <chapter><section><section><para>
3626 #: pkgs.dbk:2332
3627 msgid ""
3628 "The inclusion of a package from <literal>unstable</literal> is conditional "
3629 "on the following:"
3630 msgstr ""
3631
3632 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3633 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3634 #: pkgs.dbk:2338
3635 msgid ""
3636 "The package must have been available in <literal>unstable</literal> for 2, 5 "
3637 "or 10 days, depending on the urgency (high, medium or low).  Please note "
3638 "that the urgency is sticky, meaning that the highest urgency uploaded since "
3639 "the previous <literal>testing</literal> transition is taken into account.  "
3640 "Those delays may be doubled during a freeze, or <literal>testing</literal> "
3641 "transitions may be switched off altogether;"
3642 msgstr ""
3643
3644 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3645 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3646 #: pkgs.dbk:2348
3647 msgid ""
3648 "It must not have new release-critical bugs (RC bugs affecting the version "
3649 "available in <literal>unstable</literal>, but not affecting the version in "
3650 "<literal>testing</literal>);"
3651 msgstr ""
3652
3653 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3654 #: pkgs.dbk:2355
3655 msgid ""
3656 "It must be available on all architectures on which it has previously been "
3657 "built in <literal>unstable</literal>. <link linkend=\"dak-ls\">dak ls</link> "
3658 "may be of interest to check that information;"
3659 msgstr ""
3660
3661 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3662 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3663 #: pkgs.dbk:2362
3664 msgid ""
3665 "It must not break any dependency of a package which is already available in "
3666 "<literal>testing</literal>;"
3667 msgstr ""
3668
3669 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
3670 #: pkgs.dbk:2368
3671 msgid ""
3672 "The packages on which it depends must either be available in "
3673 "<literal>testing</literal> or they must be accepted into <literal>testing</"
3674 "literal> at the same time (and they will be if they fulfill all the "
3675 "necessary criteria)."
3676 msgstr ""
3677
3678 # type: Content of: <chapter><section><section><para>
3679 #. type: Content of: <chapter><section><section><para>
3680 #: pkgs.dbk:2376
3681 msgid ""
3682 "To find out whether a package is progressing into <literal>testing</literal> "
3683 "or not, see the <literal>testing</literal> script output on the <ulink url="
3684 "\"&url-testing-maint;\">web page of the testing distribution</ulink>, or use "
3685 "the program <command>grep-excuses</command> which is in the <systemitem role="
3686 "\"package\">devscripts</systemitem> package.  This utility can easily be "
3687 "used in a <citerefentry> <refentrytitle>crontab</refentrytitle> "
3688 "<manvolnum>5</manvolnum> </citerefentry> to keep yourself informed of the "
3689 "progression of your packages into <literal>testing</literal>."
3690 msgstr ""
3691
3692 # type: Content of: <chapter><section><section><para>
3693 #. type: Content of: <chapter><section><section><para>
3694 #: pkgs.dbk:2387
3695 msgid ""
3696 "The <filename>update_excuses</filename> file does not always give the "
3697 "precise reason why the package is refused; you may have to find it on your "
3698 "own by looking for what would break with the inclusion of the package.  The "
3699 "<ulink url=\"&url-testing-maint;\">testing web page</ulink> gives some more "
3700 "information about the usual problems which may be causing such troubles."
3701 msgstr ""
3702
3703 # type: Content of: <chapter><section><section><para>
3704 #. type: Content of: <chapter><section><section><para>
3705 #: pkgs.dbk:2394
3706 msgid ""
3707 "Sometimes, some packages never enter <literal>testing</literal> because the "
3708 "set of inter-relationship is too complicated and cannot be sorted out by the "
3709 "scripts.  See below for details."
3710 msgstr ""
3711
3712 # type: Content of: <chapter><section><section><para>
3713 #. type: Content of: <chapter><section><section><para>
3714 #: pkgs.dbk:2399
3715 msgid ""
3716 "Some further dependency analysis is shown on <ulink url=\"http://release."
3717 "debian.org/migration/\"></ulink> — but be warned, this page also shows build "
3718 "dependencies which are not considered by britney."
3719 msgstr ""
3720
3721 #. type: Content of: <chapter><section><section><section><title>
3722 #: pkgs.dbk:2404
3723 msgid "Out-of-date"
3724 msgstr ""
3725
3726 # type: Content of: <chapter><section><section><section><para>
3727 #.  FIXME: better rename this file than document rampant professionalism? 
3728 #. type: Content of: <chapter><section><section><section><para>
3729 #: pkgs.dbk:2407
3730 msgid ""
3731 "For the <literal>testing</literal> migration script, outdated means: There "
3732 "are different versions in <literal>unstable</literal> for the release "
3733 "architectures (except for the architectures in fuckedarches; fuckedarches is "
3734 "a list of architectures that don't keep up (in <filename>update_out.py</"
3735 "filename>), but currently, it's empty).  outdated has nothing whatsoever to "
3736 "do with the architectures this package has in <literal>testing</literal>."
3737 msgstr ""
3738
3739 # type: Content of: <chapter><section><section><section><para>
3740 #. type: Content of: <chapter><section><section><section><para>
3741 #: pkgs.dbk:2415
3742 msgid "Consider this example:"
3743 msgstr ""
3744
3745 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3746 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3747 #: pkgs.dbk:2422 pkgs.dbk:2455
3748 msgid "alpha"
3749 msgstr "alpha"
3750
3751 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3752 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3753 #: pkgs.dbk:2423 pkgs.dbk:2456
3754 msgid "arm"
3755 msgstr "arm"
3756
3757 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3758 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3759 #: pkgs.dbk:2428 pkgs.dbk:2462 pkgs.dbk:2524
3760 msgid "testing"
3761 msgstr "テスト版"
3762
3763 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3764 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3765 #: pkgs.dbk:2429 pkgs.dbk:2434 pkgs.dbk:2463 pkgs.dbk:2464 pkgs.dbk:2471
3766 msgid "1"
3767 msgstr "1"
3768
3769 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3770 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3771 #: pkgs.dbk:2430 pkgs.dbk:2465 pkgs.dbk:2470
3772 msgid "-"
3773 msgstr "-"
3774
3775 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3776 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3777 #: pkgs.dbk:2433 pkgs.dbk:2468 pkgs.dbk:2525
3778 msgid "unstable"
3779 msgstr "不安定版"
3780
3781 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3782 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3783 #: pkgs.dbk:2435 pkgs.dbk:2469
3784 msgid "2"
3785 msgstr "2"
3786
3787 #. type: Content of: <chapter><section><section><section><para>
3788 #: pkgs.dbk:2441
3789 msgid ""
3790 "The package is out of date on <literal>alpha</literal> in <literal>unstable</"
3791 "literal>, and will not go to <literal>testing</literal>. Removing the "
3792 "package would not help at all, the package is still out of date on "
3793 "<literal>alpha</literal>, and will not propagate to <literal>testing</"
3794 "literal>."
3795 msgstr ""
3796
3797 # type: Content of: <chapter><section><section><section><para>
3798 #. type: Content of: <chapter><section><section><section><para>
3799 #: pkgs.dbk:2447
3800 msgid ""
3801 "However, if ftp-master removes a package in <literal>unstable</literal> "
3802 "(here on <literal>arm</literal>):"
3803 msgstr ""
3804
3805 # type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3806 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><thead><row><entry>
3807 #: pkgs.dbk:2457
3808 msgid "hurd-i386"
3809 msgstr "hurd-i386"
3810
3811 # type: Content of: <chapter><section><section><section><para>
3812 #. type: Content of: <chapter><section><section><section><para>
3813 #: pkgs.dbk:2477
3814 msgid ""
3815 "In this case, the package is up to date on all release architectures in "
3816 "<literal>unstable</literal> (and the extra <literal>hurd-i386</literal> "
3817 "doesn't matter, as it's not a release architecture)."
3818 msgstr ""
3819
3820 # type: Content of: <chapter><section><section><section><para>
3821 #. type: Content of: <chapter><section><section><section><para>
3822 #: pkgs.dbk:2482
3823 msgid ""
3824 "Sometimes, the question is raised if it is possible to allow packages in "
3825 "that are not yet built on all architectures: No.  Just plainly no.  (Except "
3826 "if you maintain glibc or so.)"
3827 msgstr ""
3828
3829 # type: Content of: <chapter><section><section><section><title>
3830 #. type: Content of: <chapter><section><section><section><title>
3831 #: pkgs.dbk:2489
3832 msgid "Removals from testing"
3833 msgstr "テスト版からの削除"
3834
3835 # type: Content of: <chapter><section><section><section><para>
3836 #. type: Content of: <chapter><section><section><section><para>
3837 #: pkgs.dbk:2491
3838 msgid ""
3839 "Sometimes, a package is removed to allow another package in: This happens "
3840 "only to allow <emphasis>another</emphasis> package to go in if it's ready in "
3841 "every other sense.  Suppose e.g.  that <literal>a</literal> cannot be "
3842 "installed with the new version of <literal>b</literal>; then <literal>a</"
3843 "literal> may be removed to allow <literal>b</literal> in."
3844 msgstr ""
3845
3846 #. type: Content of: <chapter><section><section><section><para>
3847 #: pkgs.dbk:2498
3848 msgid ""
3849 "Of course, there is another reason to remove a package from "
3850 "<literal>testing</literal>: It's just too buggy (and having a single RC-bug "
3851 "is enough to be in this state)."
3852 msgstr ""
3853
3854 # type: Content of: <chapter><section><section><section><para>
3855 #. type: Content of: <chapter><section><section><section><para>
3856 #: pkgs.dbk:2503
3857 msgid ""
3858 "Furthermore, if a package has been removed from <literal>unstable</literal>, "
3859 "and no package in <literal>testing</literal> depends on it any more, then it "
3860 "will automatically be removed."
3861 msgstr ""
3862
3863 #. type: Content of: <chapter><section><section><section><title>
3864 #: pkgs.dbk:2510
3865 msgid "Circular dependencies"
3866 msgstr ""
3867
3868 # type: Content of: <chapter><section><section><section><para>
3869 #. type: Content of: <chapter><section><section><section><para>
3870 #: pkgs.dbk:2512
3871 msgid ""
3872 "A situation which is not handled very well by britney is if package "
3873 "<literal>a</literal> depends on the new version of package <literal>b</"
3874 "literal>, and vice versa."
3875 msgstr ""
3876
3877 # type: Content of: <chapter><section><section><section><para>
3878 #. type: Content of: <chapter><section><section><section><para>
3879 #: pkgs.dbk:2517
3880 msgid "An example of this is:"
3881 msgstr ""
3882
3883 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3884 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3885 #: pkgs.dbk:2530
3886 msgid "a"
3887 msgstr "a"
3888
3889 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3890 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3891 #: pkgs.dbk:2531
3892 msgid "1; depends: b=1"
3893 msgstr "1; depends: b=1"
3894
3895 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3896 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3897 #: pkgs.dbk:2532
3898 msgid "2; depends: b=2"
3899 msgstr "2; depends: b=2"
3900
3901 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3902 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3903 #: pkgs.dbk:2535
3904 msgid "b"
3905 msgstr "b"
3906
3907 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3908 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3909 #: pkgs.dbk:2536
3910 msgid "1; depends: a=1"
3911 msgstr "1; depends: a=1"
3912
3913 # type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3914 #. type: Content of: <chapter><section><section><section><informaltable><tgroup><tbody><row><entry>
3915 #: pkgs.dbk:2537
3916 msgid "2; depends: a=2"
3917 msgstr "2; depends: a=2"
3918
3919 # type: Content of: <chapter><section><section><section><para>
3920 #. type: Content of: <chapter><section><section><section><para>
3921 #: pkgs.dbk:2543
3922 msgid ""
3923 "Neither package <literal>a</literal> nor package <literal>b</literal> is "
3924 "considered for update."
3925 msgstr ""
3926
3927 # type: Content of: <chapter><section><section><section><para>
3928 #. type: Content of: <chapter><section><section><section><para>
3929 #: pkgs.dbk:2547
3930 msgid ""
3931 "Currently, this requires some manual hinting from the release team.  Please "
3932 "contact them by sending mail to &email-debian-release; if this happens to "
3933 "one of your packages."
3934 msgstr ""
3935
3936 # type: Content of: <chapter><section><section><section><title>
3937 #. type: Content of: <chapter><section><section><section><title>
3938 #: pkgs.dbk:2554
3939 #, fuzzy
3940 msgid "Influence of package in testing"
3941 msgstr "テスト版パッケージへの影響"
3942
3943 #. type: Content of: <chapter><section><section><section><para>
3944 #: pkgs.dbk:2556
3945 msgid ""
3946 "Generally, there is nothing that the status of a package in "
3947 "<literal>testing</literal> means for transition of the next version from "
3948 "<literal>unstable</literal> to <literal>testing</literal>, with two "
3949 "exceptions: If the RC-bugginess of the package goes down, it may go in even "
3950 "if it is still RC-buggy.  The second exception is if the version of the "
3951 "package in <literal>testing</literal> is out of sync on the different "
3952 "arches: Then any arch might just upgrade to the version of the source "
3953 "package; however, this can happen only if the package was previously forced "
3954 "through, the arch is in fuckedarches, or there was no binary package of that "
3955 "arch present in <literal>unstable</literal> at all during the "
3956 "<literal>testing</literal> migration."
3957 msgstr ""
3958
3959 #. type: Content of: <chapter><section><section><section><para>
3960 #: pkgs.dbk:2568
3961 msgid ""
3962 "In summary this means: The only influence that a package being in "
3963 "<literal>testing</literal> has on a new version of the same package is that "
3964 "the new version might go in easier."
3965 msgstr ""
3966
3967 #. type: Content of: <chapter><section><section><section><title>
3968 #: pkgs.dbk:2575
3969 msgid "Details"
3970 msgstr ""
3971
3972 # type: Content of: <chapter><section><section><section><para>
3973 #. type: Content of: <chapter><section><section><section><para>
3974 #: pkgs.dbk:2577
3975 msgid "If you are interested in details, this is how britney works:"
3976 msgstr ""
3977
3978 # type: Content of: <chapter><section><section><section><para>
3979 #. type: Content of: <chapter><section><section><section><para>
3980 #: pkgs.dbk:2580
3981 msgid ""
3982 "The packages are looked at to determine whether they are valid candidates.  "
3983 "This gives the update excuses.  The most common reasons why a package is not "
3984 "considered are too young, RC-bugginess, and out of date on some arches.  For "
3985 "this part of britney, the release managers have hammers of various sizes to "
3986 "force britney to consider a package.  (Also, the base freeze is coded in "
3987 "that part of britney.) (There is a similar thing for binary-only updates, "
3988 "but this is not described here.  If you're interested in that, please peruse "
3989 "the code.)"
3990 msgstr ""
3991
3992 #. type: Content of: <chapter><section><section><section><para>
3993 #: pkgs.dbk:2589
3994 msgid ""
3995 "Now, the more complex part happens: Britney tries to update "
3996 "<literal>testing</literal> with the valid candidates. For that, britney "
3997 "tries to add each valid candidate to the testing distribution. If the number "
3998 "of uninstallable packages in <literal>testing</literal> doesn't increase, "
3999 "the package is accepted. From that point on, the accepted package is "
4000 "considered to be part of <literal>testing</literal>, such that all "
4001 "subsequent installability tests include this package.  Hints from the "
4002 "release team are processed before or after this main run, depending on the "
4003 "exact type."
4004 msgstr ""
4005
4006 #. type: Content of: <chapter><section><section><section><para>
4007 #: pkgs.dbk:2599
4008 msgid ""
4009 "If you want to see more details, you can look it up on <filename>merkel:/org/"
4010 "&ftp-debian-org;/testing/update_out/</filename> (or in <filename>merkel:~aba/"
4011 "testing/update_out</filename> to see a setup with a smaller packages file).  "
4012 "Via web, it's at <ulink url=\"http://&ftp-master-host;/testing/"
4013 "update_out_code/\"></ulink>."
4014 msgstr ""
4015
4016 # type: Content of: <chapter><section><section><section><para>
4017 #. type: Content of: <chapter><section><section><section><para>
4018 #: pkgs.dbk:2606
4019 msgid ""
4020 "The hints are available via <ulink url=\"http://&ftp-master-host;/testing/"
4021 "hints/\"></ulink>."
4022 msgstr ""
4023
4024 # type: Content of: <chapter><section><section><title>
4025 #. type: Content of: <chapter><section><section><title>
4026 #: pkgs.dbk:2614
4027 msgid "Direct updates to testing"
4028 msgstr "直接テスト版を更新する"
4029
4030 #. type: Content of: <chapter><section><section><para>
4031 #: pkgs.dbk:2616
4032 msgid ""
4033 "The <literal>testing</literal> distribution is fed with packages from "
4034 "<literal>unstable</literal> according to the rules explained above.  "
4035 "However, in some cases, it is necessary to upload packages built only for "
4036 "<literal>testing</literal>.  For that, you may want to upload to "
4037 "<literal>testing-proposed-updates</literal>."
4038 msgstr ""
4039
4040 # type: Content of: <chapter><section><section><para>
4041 #. type: Content of: <chapter><section><section><para>
4042 #: pkgs.dbk:2623
4043 msgid ""
4044 "Keep in mind that packages uploaded there are not automatically processed, "
4045 "they have to go through the hands of the release manager.  So you'd better "
4046 "have a good reason to upload there.  In order to know what a good reason is "
4047 "in the release managers' eyes, you should read the instructions that they "
4048 "regularly give on &email-debian-devel-announce;."
4049 msgstr ""
4050
4051 #. type: Content of: <chapter><section><section><para>
4052 #: pkgs.dbk:2630
4053 msgid ""
4054 "You should not upload to <literal>testing-proposed-updates</literal> when "
4055 "you can update your packages through <literal>unstable</literal>.  If you "
4056 "can't (for example because you have a newer development version in "
4057 "<literal>unstable</literal>), you may use this facility, but it is "
4058 "recommended that you ask for authorization from the release manager first.  "
4059 "Even if a package is frozen, updates through <literal>unstable</literal> are "
4060 "possible, if the upload via <literal>unstable</literal> does not pull in any "
4061 "new dependencies."
4062 msgstr ""
4063
4064 #. type: Content of: <chapter><section><section><para>
4065 #: pkgs.dbk:2639
4066 msgid ""
4067 "Version numbers are usually selected by adding the codename of the "
4068 "<literal>testing</literal> distribution and a running number, like "
4069 "<literal>1.2squeeze1</literal> for the first upload through <literal>testing-"
4070 "proposed-updates</literal> of package version <literal>1.2</literal>."
4071 msgstr ""
4072
4073 # type: Content of: <chapter><section><section><para>
4074 #. type: Content of: <chapter><section><section><para>
4075 #: pkgs.dbk:2646
4076 msgid "Please make sure you didn't miss any of these items in your upload:"
4077 msgstr ""
4078
4079 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4080 #: pkgs.dbk:2651
4081 msgid ""
4082 "Make sure that your package really needs to go through <literal>testing-"
4083 "proposed-updates</literal>, and can't go through <literal>unstable</literal>;"
4084 msgstr ""
4085
4086 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4087 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4088 #: pkgs.dbk:2658
4089 msgid "Make sure that you included only the minimal amount of changes;"
4090 msgstr ""
4091
4092 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4093 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4094 #: pkgs.dbk:2663
4095 msgid ""
4096 "Make sure that you included an appropriate explanation in the changelog;"
4097 msgstr ""
4098
4099 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4100 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4101 #: pkgs.dbk:2668
4102 msgid ""
4103 "Make sure that you've written <literal>testing</literal> or <literal>testing-"
4104 "proposed-updates</literal> into your target distribution;"
4105 msgstr ""
4106
4107 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4108 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4109 #: pkgs.dbk:2674
4110 msgid ""
4111 "Make sure that you've built and tested your package in <literal>testing</"
4112 "literal>, not in <literal>unstable</literal>;"
4113 msgstr ""
4114
4115 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4116 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4117 #: pkgs.dbk:2680
4118 msgid ""
4119 "Make sure that your version number is higher than the version in "
4120 "<literal>testing</literal> and <literal>testing-proposed-updates</literal>, "
4121 "and lower than in <literal>unstable</literal>;"
4122 msgstr ""
4123
4124 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4125 #. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
4126 #: pkgs.dbk:2687
4127 msgid ""
4128 "After uploading and successful build on all platforms, contact the release "
4129 "team at &email-debian-release; and ask them to approve your upload."
4130 msgstr ""
4131
4132 # type: Content of: <chapter><section><section><title>
4133 #. type: Content of: <chapter><section><section><title>
4134 #: pkgs.dbk:2695
4135 msgid "Frequently asked questions"
4136 msgstr ""
4137
4138 # type: Content of: <chapter><section><section><section><title>
4139 #. type: Content of: <chapter><section><section><section><title>
4140 #: pkgs.dbk:2697
4141 msgid "What are release-critical bugs, and how do they get counted?"
4142 msgstr ""
4143
4144 # type: Content of: <chapter><section><section><section><para>
4145 #. type: Content of: <chapter><section><section><section><para>
4146 #: pkgs.dbk:2699
4147 msgid ""
4148 "All bugs of some higher severities are by default considered release-"
4149 "critical; currently, these are <literal>critical</literal>, <literal>grave</"
4150 "literal> and <literal>serious</literal> bugs."
4151 msgstr ""
4152
4153 #. type: Content of: <chapter><section><section><section><para>
4154 #: pkgs.dbk:2704
4155 msgid ""
4156 "Such bugs are presumed to have an impact on the chances that the package "
4157 "will be released with the <literal>stable</literal> release of Debian: in "
4158 "general, if a package has open release-critical bugs filed on it, it won't "
4159 "get into <literal>testing</literal>, and consequently won't be released in "
4160 "<literal>stable</literal>."
4161 msgstr ""
4162
4163 #. type: Content of: <chapter><section><section><section><para>
4164 #: pkgs.dbk:2711
4165 msgid ""
4166 "The <literal>unstable</literal> bug count are all release-critical bugs "
4167 "which are marked to apply to <replaceable>package</replaceable>/"
4168 "<replaceable>version</replaceable> combinations that are available in "
4169 "unstable for a release architecture. The <literal>testing</literal> bug "
4170 "count is defined analogously."
4171 msgstr ""
4172
4173 # type: Content of: <chapter><section><section><section><title>
4174 #. type: Content of: <chapter><section><section><section><title>
4175 #: pkgs.dbk:2719
4176 msgid ""
4177 "How could installing a package into <literal>testing</literal> possibly "
4178 "break other packages?"
4179 msgstr ""
4180
4181 #. type: Content of: <chapter><section><section><section><para>
4182 #: pkgs.dbk:2722
4183 msgid ""
4184 "The structure of the distribution archives is such that they can only "
4185 "contain one version of a package; a package is defined by its name.  So when "
4186 "the source package <literal>acmefoo</literal> is installed into "
4187 "<literal>testing</literal>, along with its binary packages <literal>acme-foo-"
4188 "bin</literal>, <literal>acme-bar-bin</literal>, <literal>libacme-foo1</"
4189 "literal> and <literal>libacme-foo-dev</literal>, the old version is removed."
4190 msgstr ""
4191
4192 # type: Content of: <chapter><section><section><section><para>
4193 #. type: Content of: <chapter><section><section><section><para>
4194 #: pkgs.dbk:2730
4195 msgid ""
4196 "However, the old version may have provided a binary package with an old "
4197 "soname of a library, such as <literal>libacme-foo0</literal>.  Removing the "
4198 "old <literal>acmefoo</literal> will remove <literal>libacme-foo0</literal>, "
4199 "which will break any packages which depend on it."
4200 msgstr ""
4201
4202 # type: Content of: <chapter><section><section><section><para>
4203 #. type: Content of: <chapter><section><section><section><para>
4204 #: pkgs.dbk:2736
4205 msgid ""
4206 "Evidently, this mainly affects packages which provide changing sets of "
4207 "binary packages in different versions (in turn, mainly libraries).  However, "
4208 "it will also affect packages upon which versioned dependencies have been "
4209 "declared of the ==, &lt;=, or &lt;&lt; varieties."
4210 msgstr ""
4211
4212 # type: Content of: <chapter><section><section><section><para>
4213 #. type: Content of: <chapter><section><section><section><para>
4214 #: pkgs.dbk:2742
4215 msgid ""
4216 "When the set of binary packages provided by a source package change in this "
4217 "way, all the packages that depended on the old binaries will have to be "
4218 "updated to depend on the new binaries instead.  Because installing such a "
4219 "source package into <literal>testing</literal> breaks all the packages that "
4220 "depended on it in <literal>testing</literal>, some care has to be taken now: "
4221 "all the depending packages must be updated and ready to be installed "
4222 "themselves so that they won't be broken, and, once everything is ready, "
4223 "manual intervention by the release manager or an assistant is normally "
4224 "required."
4225 msgstr ""
4226
4227 # type: Content of: <chapter><section><section><section><para>
4228 #. type: Content of: <chapter><section><section><section><para>
4229 #: pkgs.dbk:2753
4230 msgid ""
4231 "If you are having problems with complicated groups of packages like this, "
4232 "contact &email-debian-devel; or &email-debian-release; for help."
4233 msgstr ""