1 # Debian Developer's Reference (Japanese)
2 # (C) Hideki Yamane <henrich@debian.org>, 2008-2011.
6 "Project-Id-Version: developers-reference 3.4.5\n"
7 "POT-Creation-Date: 2011-04-22 10:44-0400\n"
8 "PO-Revision-Date: 2011-07-03 23:04+0900\n"
9 "Last-Translator: Hideki Yamane <henrich@debian.org>\n"
10 "Language-Team: Japanese <debian-japanese@lists.debian.org>\n"
13 "Content-Type: text/plain; charset=UTF-8\n"
14 "Content-Transfer-Encoding: 8bit\n"
16 # type: Content of: <chapter><title>
17 #. type: Content of: <chapter><title>
18 #: beyond-pkging.dbk:7
19 msgid "Beyond Packaging"
22 # type: Content of: <chapter><para>
23 #. type: Content of: <chapter><para>
24 #: beyond-pkging.dbk:9
26 "Debian is about a lot more than just packaging software and maintaining "
27 "those packages. This chapter contains information about ways, often really "
28 "critical ways, to contribute to Debian beyond simply creating and "
29 "maintaining packages."
31 "Debian は、単にソフトウェアのパッケージを作ってメンテナンスをしているだけでは"
32 "ありません。この章では、単にパッケージを作ってメンテナンスする以外で Debian "
33 "へ協力・貢献するやり方、多くの場合とても重要となるやり方の情報を取り扱いま"
36 # type: Content of: <chapter><para>
37 #. type: Content of: <chapter><para>
38 #: beyond-pkging.dbk:14
40 "As a volunteer organization, Debian relies on the discretion of its members "
41 "in choosing what they want to work on and in choosing the most critical "
42 "thing to spend their time on."
44 "ボランティア組織の例にたがわず、Debian の活動はメンバーが何をしたいのか、時間"
45 "を割くのに最も重大だと思われることが何か、というメンバーの判断に依っていま"
48 # type: Content of: <chapter><section><title>
49 #. type: Content of: <chapter><section><title>
50 #: beyond-pkging.dbk:19
54 # type: Content of: <chapter><section><para>
55 #. type: Content of: <chapter><section><para>
56 #: beyond-pkging.dbk:21
58 "We encourage you to file bugs as you find them in Debian packages. In fact, "
59 "Debian developers are often the first line testers. Finding and reporting "
60 "bugs in other developers' packages improves the quality of Debian."
62 "我々としては、Debian パッケージで見つけたバグを登録することを勧めています。実"
63 "際のところ、大抵の場合は Debian 開発者が第一線でのテスト作業者となっていま"
64 "す。他の開発者のパッケージで見つけたバグを報告することで Debian の品質が向上"
67 # type: Content of: <chapter><section><para>
68 #. type: Content of: <chapter><section><para>
69 #: beyond-pkging.dbk:26
71 "Read the <ulink url=\"&url-bts-report;\">instructions for reporting bugs</"
72 "ulink> in the Debian <ulink url=\"&url-bts;\">bug tracking system</ulink>."
74 "Debian <ulink url=\"&url-bts;\">バグ追跡システム (BTS)</ulink> の <ulink url="
75 "\"&url-bts-report;\">バグ報告のやり方について (instructions for reporting "
76 "bugs)</ulink> を参照してください。"
78 # type: Content of: <chapter><section><para>
79 #. type: Content of: <chapter><section><para>
80 #: beyond-pkging.dbk:31
82 "Try to submit the bug from a normal user account at which you are likely to "
83 "receive mail, so that people can reach you if they need further information "
84 "about the bug. Do not submit bugs as root."
86 "いつも使っているメールを受け取れるユーザアカウントからバグを送ってみてくださ"
87 "い。そうすることで、開発者がそのバグに関するより詳細な情報を必要とする場合に"
88 "あなたに尋ねることができます。root ユーザでバグを報告しないでください。"
90 # type: Content of: <chapter><section><para>
91 #. type: Content of: <chapter><section><para>
92 #: beyond-pkging.dbk:36
94 "You can use a tool like <citerefentry> <refentrytitle>reportbug</"
95 "refentrytitle> <manvolnum>1</manvolnum> </citerefentry> to submit bugs. It "
96 "can automate and generally ease the process."
98 "バグを報告するには、<citerefentry> <refentrytitle>reportbug</refentrytitle> "
99 "<manvolnum>1</manvolnum> </citerefentry> のようなツールが使えます。これによって"
100 "作業を自動化し、かなり簡単なものにできます。"
102 # type: Content of: <chapter><section><para>
103 #. type: Content of: <chapter><section><para>
104 #: beyond-pkging.dbk:41
106 "Make sure the bug is not already filed against a package. Each package has "
107 "a bug list easily reachable at <literal>http://&bugs-host;/"
108 "<replaceable>packagename</replaceable></literal>. Utilities like "
109 "<citerefentry> <refentrytitle>querybts</refentrytitle> <manvolnum>1</"
110 "manvolnum> </citerefentry> can also provide you with this information (and "
111 "<command>reportbug</command> will usually invoke <command>querybts</command> "
112 "before sending, too)."
114 "パッケージに対して既にバグが報告されていないことを確認しておいてください。"
115 "個々のパッケージに対するバグのリストは <literal>http://&bugs-host;/"
116 "<replaceable>パッケージ名</replaceable></literal> にて簡単に確認できます。"
117 "<citerefentry> <refentrytitle>querybts</refentrytitle> <manvolnum>1</"
118 "manvolnum> </citerefentry> のようなユーティリティでもこの情報を入手できます "
119 "(なお、<command>reportbug</command> では大抵の場合、バグを送信する前に "
120 "<command>querybts</command> の実行も行っています)。"
122 # type: Content of: <chapter><section><para>
123 #. type: Content of: <chapter><section><para>
124 #: beyond-pkging.dbk:50
126 "Try to direct your bugs to the proper location. When for example your bug "
127 "is about a package which overwrites files from another package, check the "
128 "bug lists for <emphasis>both</emphasis> of those packages in order to avoid "
129 "filing duplicate bug reports."
131 "正しい所にバグを報告する様に心がけてください。例えばあるパッケージが他のパッ"
132 "ケージのファイルを上書きしてしまうバグの場合ですが、バグ報告が重複して登録さ"
133 "れるのを避けるため、これらのパッケージの<emphasis>両方</emphasis>のバグリスト"
136 # type: Content of: <chapter><section><para>
137 #. type: Content of: <chapter><section><para>
138 #: beyond-pkging.dbk:56
140 "For extra credit, you can go through other packages, merging bugs which are "
141 "reported more than once, or tagging bugs `fixed' when they have already been "
142 "fixed. Note that when you are neither the bug submitter nor the package "
143 "maintainer, you should not actually close the bug (unless you secure "
144 "permission from the maintainer)."
146 "さらに言うと、他のパッケージについても、何度も報告されているバグをマージした"
147 "り既に修正されているバグに「fixed」タグをつけたりすることもできます。そのバグ"
148 "の報告者であったりパッケージメンテナではない場合は (メンテナから許可をもらっ"
149 "ていなければ)、実際にバグをクローズしてはいけないことに注意してください。"
151 # type: Content of: <chapter><section><para>
152 #. type: Content of: <chapter><section><para>
153 #: beyond-pkging.dbk:63
155 "From time to time you may want to check what has been going on with the bug "
156 "reports that you submitted. Take this opportunity to close those that you "
157 "can't reproduce anymore. To find out all the bugs you submitted, you just "
158 "have to visit <literal>http://&bugs-host;/from:<replaceable>your-email-addr</"
159 "replaceable></literal>."
161 "時折、あなたが登録したバグ報告について何が起こっているのかをチェックしたくな"
162 "ることでしょう。これは、もう再現できないものをクローズするきっかけになりま"
163 "す。報告した全てのバグ報告を確認するには、<literal>http://&bugs-host;/from:"
164 "<replaceable>your-email-addr</replaceable></literal> を参照すればいいだけで"
167 # type: Content of: <chapter><section><section><title>
168 #. type: Content of: <chapter><section><section><title>
169 #: beyond-pkging.dbk:70
170 msgid "Reporting lots of bugs at once (mass bug filing)"
171 msgstr "一度に大量のバグを報告するには (mass bug filing)"
173 # type: Content of: <chapter><section><section><para>
174 #. type: Content of: <chapter><section><section><para>
175 #: beyond-pkging.dbk:72
177 "Reporting a great number of bugs for the same problem on a great number of "
178 "different packages — i.e., more than 10 — is a deprecated practice. Take "
179 "all possible steps to avoid submitting bulk bugs at all. For instance, if "
180 "checking for the problem can be automated, add a new check to <systemitem "
181 "role=\"package\">lintian</systemitem> so that an error or warning is emitted."
183 "大量の異なるパッケージに対して、同じ問題についての非常に多くのバグ (例えば "
184 "10 個以上) を報告するのは、推奨されていないやり方です。不要なバグ報告を避ける"
185 "ため、可能な限りの手続きを踏むようにしましょう。例えば、問題の確認を自動化で"
186 "きる場合は <systemitem role=\"package\">lintian</systemitem> に新しくチェック"
187 "項目を追加すれば、エラーや警告が明確になります。"
189 # type: Content of: <chapter><section><section><para>
190 #. type: Content of: <chapter><section><section><para>
191 #: beyond-pkging.dbk:79
193 "If you report more than 10 bugs on the same topic at once, it is recommended "
194 "that you send a message to &email-debian-devel; describing your intention "
195 "before submitting the report, and mentioning the fact in the subject of your "
196 "mail. This will allow other developers to verify that the bug is a real "
197 "problem. In addition, it will help prevent a situation in which several "
198 "maintainers start filing the same bug report simultaneously."
200 "同じ問題について一度に 10 個以上のバグを報告する場合は、バグ報告を登録する前に "
201 "&email-debian-devel; へ送ることをお勧めします。バグ報告を送る前に注意点を記述"
202 "し、メールのサブジェクトに事実を挙げておきます。これで他の開発者がそのバグが"
203 "本当に問題であるかどうかを確認できるようになります。さらに、これによって複数"
204 "のメンテナが平行して同じバグ報告を登録するのを防止できるようになります。"
206 # type: Content of: <chapter><section><section><para>
207 #. type: Content of: <chapter><section><section><para>
208 #: beyond-pkging.dbk:87
210 "Please use the programs <command>dd-list</command> and if appropriate "
211 "<command>whodepends</command> (from the package <systemitem role=\"package"
212 "\">devscripts</systemitem>) to generate a list of all affected packages, and "
213 "include the output in your mail to &email-debian-devel;."
215 "<command>dd-list</command> プログラムを利用することと、明確になっているのであ"
216 "れば影響を受けるパッケージのリストを (<systemitem role=\"package"
217 "\">devscripts</systemitem> パッケージの) <command>whodepends</command> を使っ"
218 "て出力して、&email-debian-devel; へのメールに含めて下さい。"
220 # type: Content of: <chapter><section><section><para>
221 #. type: Content of: <chapter><section><section><para>
222 #: beyond-pkging.dbk:93
224 "Note that when sending lots of bugs on the same subject, you should send the "
225 "bug report to <email>maintonly@&bugs-host;</email> so that the bug report is "
226 "not forwarded to the bug distribution mailing list."
228 "同じサブジェクトで大量のバグを送信する際は、バグ報告がバグ情報用"
229 "メーリングリストへ転送されないように <email>maintonly@&bugs-host;</email> へ"
230 "バグ報告を送るべきであるの注意してください。"
232 #. type: Content of: <chapter><section><section><section><title>
233 #: beyond-pkging.dbk:98
237 #. type: Content of: <chapter><section><section><section><para>
238 #: beyond-pkging.dbk:100
240 "You may wish to use BTS usertags when submitting bugs across a number of "
241 "packages. Usertags are similar to normal tags such as 'patch' and 'wishlist' "
242 "but differ in that they are user-defined and occupy a namespace that is "
243 "unique to a particular user. This allows multiple sets of developers to "
244 "'usertag' the same bug in different ways without conflicting."
246 "多数のパッケージに対するバグを登録する際に BTS の usertag を使いたくなるかも"
247 "しれません。usertag は 'patch' や 'wishlist' のような通常のタグに似ています"
248 "が、ユーザが定義する事と特定のユーザに対して一意な名前空間を占めるという点で"
249 "違っています。これによって、同じバグについて衝突する事無しに、開発者がそれぞ"
250 "れ別のやり方で複数の設定ができるようになります。"
252 #. type: Content of: <chapter><section><section><section><para>
253 #: beyond-pkging.dbk:107
255 "To add usertags when filing bugs, specify the <literal>User</literal> and "
256 "<literal>Usertags</literal> pseudo-headers:"
258 "バグを登録する際に usertag を追加するには、擬似ヘッダ (pseudo-header) "
259 "<literal>User</literal> と <literal>Usertags</literal> を指定します。"
261 #. type: Content of: <chapter><section><section><section><screen>
262 #: beyond-pkging.dbk:111
265 "To: submit@bugs.debian.org\n"
266 "Subject: <replaceable>title-of-bug</replaceable>\n"
268 "Package: <replaceable>pkgname</replaceable>\n"
269 "<replaceable>[ ... ]</replaceable>\n"
270 "User: <replaceable>email-addr</replaceable>\n"
271 "Usertags: <replaceable>tag-name [ tag-name ... ]</replaceable>\n"
273 "<replaceable>description-of-bug ...</replaceable>\n"
275 "To: submit@bugs.debian.org\n"
276 "Subject: <replaceable>バグタイトル</replaceable>\n"
278 "Package: <replaceable>パッケージ名</replaceable>\n"
279 "<replaceable>[ ... ]</replaceable>\n"
280 "User: <replaceable>メールアドレス</replaceable>\n"
281 "Usertags: <replaceable>タグ名 [ タグ名 ... ]</replaceable>\n"
283 "<replaceable>バグの説明 ...</replaceable>\n"
285 #. type: Content of: <chapter><section><section><section><para>
286 #: beyond-pkging.dbk:122
288 "Note that tags are seperated by spaces and cannot contain underscores. If "
289 "you are filing bugs for a particular group or team it is recommended that "
290 "you set the <literal>User</literal> to an appropriate mailing list after "
291 "describing your intention there."
293 "タグは空白で区切られ、アンダースコア (_) を含められないことに注意してください。"
294 "特定のグループやチームについてのバグを登録する場合は、適切なメーリングリスト"
295 "で注意を促した上で <literal>User</literal> をそのメーリングリストに設定するの"
298 #. type: Content of: <chapter><section><section><section><para>
299 #: beyond-pkging.dbk:128
301 "To view bugs tagged with a specific usertag, visit <literal>http://&bugs-"
302 "host;/cgi-bin/pkgreport.cgi?users=<replaceable>email-addr</replaceable>&"
303 "tag=<replaceable>tag-name</replaceable></literal>."
305 "特定の usertag でバグを参照する場合は <literal>http://&bugs-host;/cgi-bin/"
306 "pkgreport.cgi?users=<replaceable>メールアドレス</replaceable>&"
307 "tag=<replaceable>タグ名</replaceable></literal> を指定してください。"
309 # type: Content of: <chapter><section><title>
310 #. type: Content of: <chapter><section><title>
311 #: beyond-pkging.dbk:137
312 msgid "Quality Assurance effort"
315 # type: Content of: <chapter><section><section><title>
316 #. type: Content of: <chapter><section><section><title>
317 #: beyond-pkging.dbk:139
321 # type: Content of: <chapter><section><section><para>
322 #. type: Content of: <chapter><section><section><para>
323 #: beyond-pkging.dbk:141
325 "Even though there is a dedicated group of people for Quality Assurance, QA "
326 "duties are not reserved solely for them. You can participate in this effort "
327 "by keeping your packages as bug-free as possible, and as lintian-clean (see "
328 "<xref linkend=\"lintian\"/>) as possible. If you do not find that possible, "
329 "then you should consider orphaning some of your packages (see <xref linkend="
330 "\"orphaning\"/>). Alternatively, you may ask the help of other people in "
331 "order to catch up with the backlog of bugs that you have (you can ask for "
332 "help on &email-debian-qa; or &email-debian-devel;). At the same time, you "
333 "can look for co-maintainers (see <xref linkend=\"collaborative-maint\"/>)."
335 "品質保証に割り当てられたグループの人々がいたとしても、QA 作業は彼らのみに課せ"
336 "られるものではありません。あなたもパッケージを可能な限りバグが無いように保"
337 "ち、できるだけ lintian clean な状態 (<xref linkend=\"lintian\"/> を参照) にす"
338 "ることで品質保証の作業に参加することができるのです。それが可能ではないように"
339 "思えるなら、パッケージをいくつか「みなしご化 (orphan)」してください (<xref linkend="
340 "\"orphaning\"/> 参照)。または、溜まったバグ処理に追いつくため、他の人々に助力"
341 "を願い出ることも可能です (&email-debian-qa; や &email-debian-devel; で助けを"
342 "求めることができます)。同時に共同メンテナ (co-maintainer) を探すことも可能で"
343 "す (<xref linkend=\"collaborative-maint\"/> を参照してください)。"
345 # type: Content of: <chapter><section><section><title>
346 #. type: Content of: <chapter><section><section><title>
347 #: beyond-pkging.dbk:155
348 msgid "Bug squashing parties"
349 msgstr "バグ潰しパーティ (BSP)"
351 # type: Content of: <chapter><section><section><para>
352 #. type: Content of: <chapter><section><section><para>
353 #: beyond-pkging.dbk:157
355 "From time to time the QA group organizes bug squashing parties to get rid of "
356 "as many problems as possible. They are announced on &email-debian-devel-"
357 "announce; and the announcement explains which area will be the focus of the "
358 "party: usually they focus on release critical bugs but it may happen that "
359 "they decide to help finish a major upgrade (like a new <command>perl</"
360 "command> version which requires recompilation of all the binary modules)."
362 "時折、QA グループは可能な限りの問題を無くすためにバグ潰しパーティ (BSP) を開"
363 "催しています。開催案内は &email-debian-devel-announce; で行われ、パーティがど"
364 "の部分に集中して行われるのかが告知されます。大抵はリリースクリティカルバグ (RC) "
365 "への対応に当てられますが、大きなアップグレード (新しい <command>perl</"
366 "command> バージョンでの全バイナリモジュールを再コンパイルのような) を完了する"
367 "手助けのために開かれることもあります。"
369 # type: Content of: <chapter><section><section><para>
370 #. type: Content of: <chapter><section><section><para>
371 #: beyond-pkging.dbk:166
373 "The rules for non-maintainer uploads differ during the parties because the "
374 "announcement of the party is considered prior notice for NMU. If you have "
375 "packages that may be affected by the party (because they have release "
376 "critical bugs for example), you should send an update to each of the "
377 "corresponding bug to explain their current status and what you expect from "
378 "the party. If you don't want an NMU, or if you're only interested in a "
379 "patch, or if you will deal yourself with the bug, please explain that in the "
382 "メンテナ以外によるアップロード (non-maintainer upload) のルールはパーティの開"
383 "催中とそれ以外で違います。これは、パーティのアナウンスは NMU の予告であると考"
384 "えられているためです。パーティによって影響を受けるパッケージを持っている場合 "
385 "(例えばリリースクリティカルバグを持っている場合) は、それぞれ対応するバグにつ"
386 "いて現状説明とこのパーティでどの様なことを期待しているのかを説明しないといけ"
387 "ません。NMU を望まない、パッチでの対応にのみ興味がある、あるいは自分自身で対"
388 "処をする予定の場合は、BTS で説明をしてください。"
390 # type: Content of: <chapter><section><section><para>
391 #. type: Content of: <chapter><section><section><para>
392 #: beyond-pkging.dbk:175
394 "People participating in the party have special rules for NMU, they can NMU "
395 "without prior notice if they upload their NMU to DELAYED/3-day at least. "
396 "All other NMU rules apply as usually; they should send the patch of the NMU "
397 "to the BTS (to one of the open bugs fixed by the NMU, or to a new bug, "
398 "tagged fixed). They should also respect any particular wishes of the "
401 "パーティに参加している人には NMU についての特別ルールが割り当てられます。NMU "
402 "について、少なくとも 3 日遅延してアップロードを行う場合 (DELAYED/3-day キュー"
403 "などへのアップロードの場合) は予告無しで NMU できるのです。他の NMU ルールは"
404 "全て通常通りに適用されます - NMU のパッチを BTS に送付する必要があります (修"
405 "正されていないバグのいずれかを NMU で修正する、あるいは新たなバグにパッチを送"
406 "り、fixed とタグを付けるなど)。それから、作業者は各メンテナの要望に沿う必要が"
409 # type: Content of: <chapter><section><section><para>
410 #. type: Content of: <chapter><section><section><para>
411 #: beyond-pkging.dbk:182
413 "If you don't feel confident about doing an NMU, just send a patch to the "
414 "BTS. It's far better than a broken NMU."
416 "NMU をする自信が無い場合は、BTS へパッチを投げるだけにしてください。NMU で"
417 "パッケージを壊してしまうより、遥かに良いことです。"
419 # type: Content of: <chapter><section><title>
420 #. type: Content of: <chapter><section><title>
421 #: beyond-pkging.dbk:190
422 msgid "Contacting other maintainers"
423 msgstr "他のメンテナに連絡を取る"
425 # type: Content of: <chapter><section><para>
426 #. type: Content of: <chapter><section><para>
427 #: beyond-pkging.dbk:192
429 "During your lifetime within Debian, you will have to contact other "
430 "maintainers for various reasons. You may want to discuss a new way of "
431 "cooperating between a set of related packages, or you may simply remind "
432 "someone that a new upstream version is available and that you need it."
434 "Debian と共に過ごす間、様々な理由で他のメンテナに連絡を取りたくなることでしょ"
435 "う。関連パッケージ間での共同作業の新たなやり方について協議したい場合や、開発"
436 "元で自分が使いたい新しいバージョンが利用可能になっていることを単に知らせたい"
439 # type: Content of: <chapter><section><para>
440 #. type: Content of: <chapter><section><para>
441 #: beyond-pkging.dbk:198
443 "Looking up the email address of the maintainer for the package can be "
444 "distracting. Fortunately, there is a simple email alias, "
445 "<literal><replaceable>package</replaceable>@&packages-host;</literal>, which "
446 "provides a way to email the maintainer, whatever their individual email "
447 "address (or addresses) may be. Replace <replaceable>package</replaceable> "
448 "with the name of a source or a binary package."
450 "パッケージメンテナのメールアドレスを探しだすのは骨が折れます。幸いな事に、"
451 "<literal><replaceable>パッケージ名</replaceable>@&packages-host;</literal> と"
452 "いうシンプルなメールのエイリアスがあり、メンテナらの個人アドレスが何であれメ"
453 "ンテナへメールを届ける手段となっています。<replaceable>パッケージ名</"
454 "replaceable> はパッケージのソース名かバイナリパッケージ名に置き換えてくださ"
457 # type: Content of: <chapter><section><para>
458 #. type: Content of: <chapter><section><para>
459 #: beyond-pkging.dbk:206
461 "You may also be interested in contacting the persons who are subscribed to a "
462 "given source package via <xref linkend=\"pkg-tracking-system\"/>. You can "
463 "do so by using the <literal><replaceable>package</replaceable>@&pts-host;</"
464 "literal> email address."
466 "<xref linkend=\"pkg-tracking-system\"/> 経由でソースパッケージの購読を行って"
467 "いる人に連絡を取りたくなるかもしれません。その場合は <literal><replaceable>"
468 "パッケージ名</replaceable>@&pts-host;</literal> メールアドレスが使えます。"
470 # type: Content of: <chapter><section><title>
471 #. type: Content of: <chapter><section><title>
472 #: beyond-pkging.dbk:215
473 msgid "Dealing with inactive and/or unreachable maintainers"
474 msgstr "活動的でない、あるいは連絡が取れないメンテナに対応する"
476 # type: Content of: <chapter><section><para>
477 #. type: Content of: <chapter><section><para>
478 #: beyond-pkging.dbk:217
480 "If you notice that a package is lacking maintenance, you should make sure "
481 "that the maintainer is active and will continue to work on their packages. "
482 "It is possible that they are not active any more, but haven't registered out "
483 "of the system, so to speak. On the other hand, it is also possible that "
484 "they just need a reminder."
486 "パッケージがメンテナンスされていないと気づいた場合、メンテナが活動的でパッ"
487 "ケージの作業を続けるかどうかを確認する必要があります。もはや活動的な状態では"
488 "ない可能性もありますが、言わばシステムに登録していなかったという可能性もあり"
489 "ます。あるいは、単に確認が必要なだけという可能性もあります。"
491 # type: Content of: <chapter><section><para>
492 #. type: Content of: <chapter><section><para>
493 #: beyond-pkging.dbk:224
495 "There is a simple system (the MIA database) in which information about "
496 "maintainers who are deemed Missing In Action is recorded. When a member of "
497 "the QA group contacts an inactive maintainer or finds more information about "
498 "one, this is recorded in the MIA database. This system is available in "
499 "<filename>/org/qa.debian.org/mia</filename> on the host <literal>qa.debian."
500 "org</literal>, and can be queried with the <command>mia-query</command> "
501 "tool. Use <command>mia-query --help</command> to see how to query the "
502 "database. If you find that no information has been recorded about an "
503 "inactive maintainer yet, or that you can add more information, you should "
504 "generally proceed as follows."
506 "Missing In Action (行方不明) だと考えられているメンテナについての情報が記録さ"
507 "れるシンプルなシステム (MIA データベース) があります。品質保証グループ (QA グ"
508 "ループ) のメンバーが活動的ではないメンテナに連絡を取った場合や、そのメンテナ"
509 "について新たな情報がもたらされた場合、その記録が MIA データベースに残されま"
510 "す。このシステムは <literal>qa.debian.org</literal> ホスト上の <filename>/"
511 "org/qa.debian.org/mia</filename> で利用可能になっており、<command>mia-query</"
512 "command> ツールで検索ができます。どうやってデータベースを検索するのかについて"
513 "は <command>mia-query --help</command> と入力してください。"
514 "活動的ではないメンテナについての情報がまだ記録されていない、あるいはそのメンテナ"
515 "についての情報を追加できる場合は、おおよそ以下の手続きを行う必要があります。"
517 # type: Content of: <chapter><section><para>
518 #. type: Content of: <chapter><section><para>
519 #: beyond-pkging.dbk:235
521 "The first step is to politely contact the maintainer, and wait a reasonable "
522 "time for a response. It is quite hard to define reasonable time, but it is "
523 "important to take into account that real life is sometimes very hectic. One "
524 "way to handle this would be to send a reminder after two weeks."
526 "最初の一歩はメンテナに丁寧にコンタクトを取り、応答するのに充分な時間待つこと"
527 "です。充分な時間というのを定義するのは非常に困難ですが、実生活では時折非常に"
528 "多忙になるのを考慮に入れると重要なことです。一つのやり方としては、リマイン"
529 "ダーを二週間後に送るという方法があります。"
531 # type: Content of: <chapter><section><para>
532 #. type: Content of: <chapter><section><para>
533 #: beyond-pkging.dbk:241
535 "If the maintainer doesn't reply within four weeks (a month), one can assume "
536 "that a response will probably not happen. If that happens, you should "
537 "investigate further, and try to gather as much useful information about the "
538 "maintainer in question as possible. This includes:"
540 "メンテナが4週間 (1ヶ月)応答をしない場合、おそらく反応がないと判断できま"
541 "す。この様な場合はより詳細に確認し、可能な限り問題となっているメンテナに関す"
542 "る有用な情報をかき集める必要があります。これには以下のようなものが含まれてい"
545 # type: Content of: <chapter><section><itemizedlist><listitem><para>
546 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
547 #: beyond-pkging.dbk:249
549 "The <literal>echelon</literal> information available through the <ulink url="
550 "\"&url-debian-db;\">developers' LDAP database</ulink>, which indicates when "
551 "the developer last posted to a Debian mailing list. (This includes mails "
552 "about uploads distributed via the &email-debian-devel-changes; list.) Also, "
553 "remember to check whether the maintainer is marked as on vacation in the "
556 "<ulink url=\"&url-debian-db;\">開発者 LDAP データベース</ulink> を通じて得ら"
557 "れる <literal>echelon</literal> 情報は、開発者が最後に Debian メーリングリス"
558 "トに投稿したはいつなのかを示します (これには &email-debian-devel-changes; で"
559 "の配布物のアップロードのメールも含まれます)。また、データベースでメンテナが休"
562 # type: Content of: <chapter><section><itemizedlist><listitem><para>
563 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
564 #: beyond-pkging.dbk:259
566 "The number of packages this maintainer is responsible for, and the condition "
567 "of those packages. In particular, are there any RC bugs that have been open "
568 "for ages? Furthermore, how many bugs are there in general? Another important "
569 "piece of information is whether the packages have been NMUed, and if so, by "
572 "このメンテナが対応しているパッケージ数やパッケージの状態。特に、長期間放置さ"
573 "れ続けている RC バグがあるかどうか? さらに通常どの程度の数のバグがあるか? も"
574 "う一つの重要な情報はパッケージが NMU されているかどうか、されているとしたら誰"
577 # type: Content of: <chapter><section><itemizedlist><listitem><para>
578 #. type: Content of: <chapter><section><itemizedlist><listitem><para>
579 #: beyond-pkging.dbk:268
581 "Is there any activity of the maintainer outside of Debian? For example, they "
582 "might have posted something recently to non-Debian mailing lists or news "
585 "Debian 以外でメンテナの活動があるかどうか? 例えば、近頃 Debian 以外のメーリン"
586 "グリストや news グループへの投稿をしているなど。"
588 # type: Content of: <chapter><section><para>
589 #. type: Content of: <chapter><section><para>
590 #: beyond-pkging.dbk:275
592 "A bit of a problem are packages which were sponsored — the maintainer is not "
593 "an official Debian developer. The <literal>echelon</literal> information is "
594 "not available for sponsored people, for example, so you need to find and "
595 "contact the Debian developer who has actually uploaded the package. Given "
596 "that they signed the package, they're responsible for the upload anyhow, and "
597 "are likely to know what happened to the person they sponsored."
599 "パッケージがスポンサーされている、つまりメンテナが公式の Debian 開発者ではな"
600 "い場合はちょっとした問題となります。例えば <literal>echelon</literal> の情報"
601 "は、スポンサーされている人は利用できません。そのため実際にパッケージをアップ"
602 "ロードした Debian 開発者を探して確認を取る必要があります。彼らがパッケージに"
603 "サインしたということは、アップロードについて何であれ責任を持ち、スポンサーし"
604 "た人に何が起こっているかを知っていそうだということです。"
606 # type: Content of: <chapter><section><para>
607 #. type: Content of: <chapter><section><para>
608 #: beyond-pkging.dbk:283
610 "It is also allowed to post a query to &email-debian-devel;, asking if anyone "
611 "is aware of the whereabouts of the missing maintainer. Please Cc: the "
612 "person in question."
614 "&email-debian-devel; に、活動が見えないメンテナの居所に誰か気づいているかとい"
615 "う質問を投稿するのもありです。問題の人を Cc: に入れてください。"
617 # type: Content of: <chapter><section><para>
618 #. type: Content of: <chapter><section><para>
619 #: beyond-pkging.dbk:288
621 "Once you have gathered all of this, you can contact &email-mia;. People on "
622 "this alias will use the information you provide in order to decide how to "
623 "proceed. For example, they might orphan one or all of the packages of the "
624 "maintainer. If a package has been NMUed, they might prefer to contact the "
625 "NMUer before orphaning the package — perhaps the person who has done the NMU "
626 "is interested in the package."
628 "ここに書かれた全てを収集したなら、&email-mia;に連絡しましょう。この名前の宛先"
629 "を担当している人は、あなたが供給した情報を使ってどう進めるかを判断します。"
630 "例えば、そのメンテナのパッケージの一部または全てをみなしご化 (Orphan) するか"
631 "も知れません。パッケージがNMUされていた場合は、パッケージをみなしご化 "
632 "(Orphan) する前にNMUをした人に連絡する事を選ぶかもしれません — NMUをした人は"
633 "きっとパッケージに関心があるでしょうから。"
635 # type: Content of: <chapter><section><para>
636 #. type: Content of: <chapter><section><para>
637 #: beyond-pkging.dbk:296
639 "One last word: please remember to be polite. We are all volunteers and "
640 "cannot dedicate all of our time to Debian. Also, you are not aware of the "
641 "circumstances of the person who is involved. Perhaps they might be "
642 "seriously ill or might even have died — you do not know who may be on the "
643 "receiving side. Imagine how a relative will feel if they read the e-mail of "
644 "the deceased and find a very impolite, angry and accusing message!"
646 "最後に一言: 礼儀正しく振る舞いましょう。我々は所詮ボランティアで、全ての時間"
647 "を Debian に捧げられるわけではありません。また、関わっている人の状況がわかる"
648 "わけでもありません。重い病気にかかっているかかもしれないし、あるいは死んでし"
649 "まっているかもしれません - メッセージを受け取る側にどんな人がいるかは分かりま"
650 "せん。亡くなった方のご親戚の方がメールを読んだ場合に、非常に無礼で怒った叱責"
651 "調のメッセージを見つけてどうお感じになるかを想像してください。"
653 # type: Content of: <chapter><section><para>
654 #. type: Content of: <chapter><section><para>
655 #: beyond-pkging.dbk:304
657 "On the other hand, although we are volunteers, we do have a responsibility. "
658 "So you can stress the importance of the greater good — if a maintainer does "
659 "not have the time or interest anymore, they should let go and give the "
660 "package to someone with more time."
662 "一方で、我々はボランティアではありますが責任を持っています。全体の幸せの重要"
663 "性をよく考える必要があります — もしメンテナが時間が足りなかったり、もう興味を"
664 "無くしてしまった場合は、パッケージを誰か他のより時間がある人間に与えるべきで"
667 # type: Content of: <chapter><section><para>
668 #. type: Content of: <chapter><section><para>
669 #: beyond-pkging.dbk:310
671 "If you are interested in working in the MIA team, please have a look at the "
672 "<filename>README</filename> file in <filename>/org/qa.debian.org/mia</"
673 "filename> on <literal>qa.debian.org</literal> where the technical details "
674 "and the MIA procedures are documented and contact &email-mia;."
676 "MIA チームで働くのに興味を持った場合は、技術上の詳細と MIA の手順が記載されて"
677 "いる <literal>qa.debian.org</literal> 上の <filename>/org/qa.debian.org/mia</"
678 "filename> 内の <filename>README</filename> ファイルを参照して、&email-mia; に"
681 # type: Content of: <chapter><section><title>
682 #. type: Content of: <chapter><section><title>
683 #: beyond-pkging.dbk:318
684 msgid "Interacting with prospective Debian developers"
685 msgstr "Debian 開発者候補に対応する"
687 # type: Content of: <chapter><section><para>
688 #. type: Content of: <chapter><section><para>
689 #: beyond-pkging.dbk:320
691 "Debian's success depends on its ability to attract and retain new and "
692 "talented volunteers. If you are an experienced developer, we recommend that "
693 "you get involved with the process of bringing in new developers. This "
694 "section describes how to help new prospective developers."
696 "Debian の成功は新たな才能あるボランティアをどう魅了し確保するかにかかっていま"
697 "す。あなたが経験豊かな開発者なら、新たな開発者を呼び込むプロセスに関与するべ"
698 "きです。このセクションでは新たな開発者候補者をどうやって手助けするのかについ"
701 # type: Content of: <chapter><section><section><title>
702 #. type: Content of: <chapter><section><section><title>
703 #: beyond-pkging.dbk:326
704 msgid "Sponsoring packages"
705 msgstr "パッケージのスポンサーを行う"
707 # type: Content of: <chapter><section><section><para>
708 #. type: Content of: <chapter><section><section><para>
709 #: beyond-pkging.dbk:328
711 "Sponsoring a package means uploading a package for a maintainer who is not "
712 "able to do it on their own. It's not a trivial matter, the sponsor must "
713 "verify the packaging and ensure that it is of the high level of quality that "
714 "Debian strives to have."
716 "パッケージのスポンサーになるというのは、自分の権限ではパッケージをアップロード"
717 "できないメンテナのためにパッケージをアップロードする、ということです。これは些細"
718 "な問題ではなく、スポンサーはパッケージを精査して Debian が求めるような高いレベル"
719 "の品質であることを保証する必要があります。"
721 #. type: Content of: <chapter><section><section><para>
722 #: beyond-pkging.dbk:334
723 msgid "Debian Developers can sponsor packages. Debian Maintainers can't."
724 msgstr "Debian 開発者はパッケージをスポンサーできます。Debian メンテナはできません。"
726 #. type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
727 #: beyond-pkging.dbk:340
729 "The maintainer prepares a source package (<filename>.dsc</filename>) and "
730 "puts it online somewhere (like on <ulink url=\"http://mentors.debian.net/cgi-"
731 "bin/welcome\">mentors.debian.net</ulink>) or even better, provides a link to "
732 "a public VCS repository (see <xref linkend=\"servers-vcs\"/>) where the "
733 "package is maintained."
735 "メンテナはソースパッケージ (<filename>.dsc</filename>) を用意してオンライン上の何処か"
736 " (例えば <ulink url=\"http://mentors.debian.net/cgi-bin/welcome\">mentors.debian.net"
737 "</ulink>) に置く、あるいはもっと良いのは、パッケージがメンテナンスされている公開 VCS "
738 "リポジトリへのリンクを提供することです (<xref linkend=\"servers-vcs\"/> 参照)。"
740 #. type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
741 #: beyond-pkging.dbk:346
742 msgid "The sponsor downloads (or checkouts) the source package."
743 msgstr "スポンサーはソースパッケージをダウンロード (あるいはチェックアウト) します。"
745 #. type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
746 #: beyond-pkging.dbk:349
748 "The sponsor reviews the source package. If she finds issues, she informs the "
749 "maintainer and asks her to provide a fixed version (the process starts over "
752 "スポンサーはソースパッケージをレビューします。問題を見つけたら、メンテナに知らせて"
753 "修正版をくれるように尋ねます (作業は step 1 へやり直しされます)。"
755 #. type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
756 #: beyond-pkging.dbk:354
758 "The sponsor could not find any remaining problem. She builds the package, "
759 "signs it, and uploads it to Debian."
761 "スポンサーは、何も問題が残っているのを見つけられませんでした。パッケージをビルドし、"
762 "署名し、Debian へアップロードします。"
764 #. type: Content of: <chapter><section><section><para>
765 #: beyond-pkging.dbk:337
767 "The process of sponsoring a package is: <placeholder type=\"orderedlist\" id="
770 "パッケージのスポンサー作業の流れは以下の通りです: <placeholder type=\"orderedlist\" id="
773 #. type: Content of: <chapter><section><section><para>
774 #: beyond-pkging.dbk:360
776 "Before delving in the details of how to sponsor a package, you should ask "
777 "yourself whether adding the proposed package is beneficial to Debian."
779 "パッケージのスポンサーのやり方について詳細を詰める前に、提案されたパッケージ"
780 "を追加することが Debian にとって有益であるかどうか、自分自身に問いかける必要"
783 #. type: Content of: <chapter><section><section><para>
784 #: beyond-pkging.dbk:364
786 "There's no simple rule to answer this question, it can depend on many "
787 "factors: is the upstream codebase mature and not full of security holes? Are "
788 "there pre-existing packages that can do the same task and how do they "
789 "compare to this new package? Has the new package been requested by users and "
790 "how large is the user base? How active are the upstream developers?"
792 "この質問に答えるのは単純ではなく、多くの要因に依っています: 開発元のコード"
793 "は成熟していて、セキュリティホールの山ではないですか? 同じことができる既存"
794 "パッケージがありませんか? そしてこの新しいパッケージと比べてどうですか? "
795 "新しいパッケージはユーザから要求されたものですか? そしてユーザ数はどの程度"
796 "の大きさですか? 大本の開発者らはアクティブですか?"
798 #. type: Content of: <chapter><section><section><para>
799 #: beyond-pkging.dbk:371
801 "You should also ensure that the prospective maintainer is going to be a good "
802 "maintainer. Does she already have some experience with other packages? If "
803 "yes, is she doing a good job with them (check out some bugs)? Is she "
804 "familiar with the package and its programming language? Does she have the "
805 "skills needed for this package? If not, is she able to learn them?"
807 "それから、メンテナ候補者が良いメンテナになるであろうことを保証する必要が"
808 "あります。他のパッケージでの経験がありますか? そうであれば、良い仕事をして"
809 "いますか (バグを確認している)? パッケージと使われているプログラミング言語"
810 "について詳しいですか? そのパッケージに必要なスキルを持っていますか? そうで"
814 #. type: Content of: <chapter><section><section><para>
815 #: beyond-pkging.dbk:379
817 "It's also a good idea to know where she stands towards Debian: does she "
818 "agree with Debian's philosophy and does she intend to join Debian? Given how "
819 "easy it is to become a Debian Maintainer, you might want to only sponsor "
820 "people who plan to join. That way you know from the start that you won't "
821 "have to act as a sponsor indefinitely."
823 "候補者が、Debian に対してどういうスタンスでいるかを知ることも良い考えです: "
824 "Debian の哲学に賛同していて、Debian に参加したいと思っていますか? Debian "
825 "メンテナになるのがどれくらい簡単なのかを考えて、参加を検討している人たちだけ"
826 "をスポンサーするのが良いでしょう。こうすれば、最初からずっとスポンサーとして"
829 # type: Content of: <chapter><section><section><title>
830 #. type: Content of: <chapter><section><section><section><title>
831 #: beyond-pkging.dbk:386
832 msgid "Sponsoring a new package"
833 msgstr "新しいパッケージのスポンサーを行う"
835 # type: Content of: <chapter><section><section><para>
836 #. type: Content of: <chapter><section><section><section><para>
837 #: beyond-pkging.dbk:388
839 "New maintainers usually have certain difficulties creating Debian packages — "
840 "this is quite understandable. They will do mistakes. That's why sponsoring a "
841 "brand new package into Debian requires a thorough review of the Debian "
842 "packaging. Sometimes several iterations will be needed until the package is "
843 "good enough to be uploaded to Debian. Thus being a sponsor implies being a "
846 "新たなメンテナは、Debian パッケージの作成する際に大抵何らかの困難に会いますー"
847 "これは非常に理解できることです。彼らは間違いを犯します。これは、全く新しい"
848 "パッケージを Debian でスポンサーするのに、Debian パッケージングの徹底的なレビューを"
849 "受ける必要がある根拠です。時折、パッケージが Debian へアップロードされるのに"
850 "十分な状態になるまで、複数回のやり取りが必要になることがあります。それゆえ、"
851 "スポンサーになることは、メンターになることを伴います。"
853 #. type: Content of: <chapter><section><section><section><para>
854 #: beyond-pkging.dbk:396
856 "Don't ever sponsor a new package without reviewing it. The review of new "
857 "packages done by ftpmasters mainly ensures that the software is really free. "
858 "Of course, it happens that they stumble on packaging problems but they "
859 "really should not. It's your task to ensure that the uploaded package "
860 "complies with the Debian Free Software Guidelines and is of good quality."
862 "レビューをせずに新しいパッケージのスポンサーをしないでください。ftpmaster に"
863 "よる新しいパッケージのレビューは、主にソフトウェアが本当にフリーなものであるかを"
864 "確認するためです。もちろん、パッケージ化に関する問題に偶然気づくことはありますが、"
865 "それを期待すべきではありません。アップロードされたパッケージが、Debian フリー"
866 "ソフトウェアガイドラインに適合し、良い品質であるのを保証するのは、あなたの仕事です。"
868 #. type: Content of: <chapter><section><section><section><para><footnote><para>
869 #: beyond-pkging.dbk:409
871 "You can find more checks in the wiki where several developers share their "
872 "own <ulink url=\"http://wiki.debian.org/SponsorChecklist\">sponsorship "
873 "checklists</ulink>."
875 "もっと多くのチェック項目について、複数の開発者が持ち寄っている"
876 "<ulink url=\"http://wiki.debian.org/SponsorChecklist\">sponsorship "
877 "checklists</ulink> で見ることができます。"
879 #. type: Content of: <chapter><section><section><section><para>
880 #: beyond-pkging.dbk:404
882 "Building the package and testing the software is part of the review, but "
883 "it's also not enough. The rest of this section contains a non-exhaustive "
884 "list of points to check in your review. <placeholder type=\"footnote\" id="
887 "パッケージをビルドし、ソフトウェアのテストを行うのはレビューの一部ではありますが、"
888 "それだけでは十分ではありません。この章の残りの部分では、レビューでチェックする"
889 "ポイントの一覧を述べます (徹底的なものではありません)。<placeholder type=\"footnote\" id="
892 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
893 #: beyond-pkging.dbk:416
895 "Verify that the upstream tarball provided is the same that has been "
896 "distributed by the upstream author (when the sources are repackaged for "
897 "Debian, generate the modified tarball yourself)."
899 "upstream の tarball として提供されているものが、upstream の作者が配布している"
900 "ものと同じかどうかを確認する (ソースが Debian 用に再パッケージされている場合、"
901 "修正した tarball を自分自身で生成する)。"
903 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
904 #: beyond-pkging.dbk:421
906 "Run <command>lintian</command> (see <xref linkend=\"lintian\"/>). It will "
907 "catch many common problems. Be sure to verify that any <command>lintian</"
908 "command> overrides setup by the maintainer is fully justified."
910 "<command>lintian</command> を実行する (<xref linkend=\"lintian\"/> 参照)。多くの"
911 "一般的な問題を見つけてくれます。<command>lintian</command> の overrides 設定が"
912 "メンテナによって設定されている場合、完全に問題がないことを確認してください。"
914 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
915 #: beyond-pkging.dbk:426
917 "Run <command>licensecheck</command> (part of <xref linkend=\"devscripts\"/>) "
918 "and verify that <filename>debian/copyright</filename> seems correct and "
919 "complete. Look for license problems (like files with “All rights reserved” "
920 "headers, or with a non-DFSG compliant license). <command>grep -ri</command> "
921 "is your friend for this task."
923 "<command>licensecheck</command>(<xref linkend=\"devscripts\"/> の一部) を実行し、"
924 "<filename>debian/copyright</filename> が正しく、そして完全な事を確認する。"
925 "ライセンス問題を探してください (頭に“All rights reserved”とあるファイルや、"
926 "DFSG に適合しないライセンスがあるなど)。この作業には、<command>grep -ri</command> "
929 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
930 #: beyond-pkging.dbk:433
932 "Build the package with <command>pbuilder</command> (or any similar tool, see "
933 "<xref linkend=\"pbuilder\"/>) to ensure that the build-dependencies are "
936 "ビルドの依存関係が完全であるのを保証するため、パッケージを <command>pbuilder"
937 "</command> (やその他類似のツール) でビルドする (<xref linkend=\"pbuilder\"/> 参照)。"
939 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
940 #: beyond-pkging.dbk:438
942 "Proofread <filename>debian/control</filename>: does it follow the best "
943 "practices (see <xref linkend=\"bpp-debian-control\"/>)? Are the dependencies "
946 "<filename>debian/control</filename> を査読する: ベストプラクティスに従っている"
947 "? (<xref linkend=\"bpp-debian-control\"/> 参照) 依存関係は完璧ですか?"
949 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
950 #: beyond-pkging.dbk:443
952 "Proofread <filename>debian/rules</filename>: does it follow the best "
953 "practices (see <xref linkend=\"bpp-debian-rules\"/>)? Do you see some "
954 "possible improvements?"
956 "<filename>debian/rules</filename> を査読する: ベストプラクティスに従っている? "
959 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
960 #: beyond-pkging.dbk:448
962 "Proofread the maintainer scripts (<filename>preinst</filename>, "
963 "<filename>postinst</filename>, <filename>prerm</filename>, <filename>postrm</"
964 "filename>, <filename>config</filename>): will the <filename>preinst</"
965 "filename>/<filename>postrm</filename> work when the dependencies are not "
966 "installed? Are all the scripts idempotent (i.e. can you run them multiple "
967 "times without consequences)?"
969 "メンテナスクリプト (<filename>preinst</filename>, "
970 "<filename>postinst</filename>, <filename>prerm</filename>, <filename>postrm</"
971 "filename>, <filename>config</filename>) を査読する: 依存関係がインストール"
972 "されていない時でも動作する? 全てのスクリプトが等羃 (idempotent、すなわち、"
975 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
976 #: beyond-pkging.dbk:456
978 "Review any change to upstream files (either in <filename>.diff.gz</"
979 "filename>, or in <filename>debian/patches/</filename> or directly embedded "
980 "in the <filename>debian</filename> tarball for binary files). Are they "
981 "justified? Are they properly documented (with <ulink url=\"&url-dep3;"
982 "\">DEP-3</ulink> for patches)?"
984 "開発元のファイルに対する変更 (<filename>.diff.gz</filename>、<filename>debian/"
985 "patches/</filename>、あるいは直接 <filename>debian</filename> tarball に埋め込"
986 "まれているバイナリファイル) をレビューする。十分な根拠がありますか? (パッチに"
987 "対し、<ulink url=\"&url-dep3;\">DEP-3</ulink> に沿って) 正しくドキュメント化"
990 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
991 #: beyond-pkging.dbk:462
993 "For every file, ask yourself why the file is there and whether it's the "
994 "right way to achieve the desired result. Is the maintainer following the "
995 "best packaging practices (see <xref linkend=\"best-pkging-practices\"/>)?"
997 "すべてのファイルについて、そのファイルが何故そこにあるのか、望んでいる結果を"
998 "もたらすためにそれが正しいやり方かどうかを自身に問いかけてください。メンテナは"
999 "パッケージ化のベストプラクティスに従っていますか? (<xref linkend=\"best-pkging-"
1002 #. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para>
1003 #: beyond-pkging.dbk:468
1005 "Build the packages, install them and try the software. Ensure you can remove "
1006 "and purge the packages. Maybe test them with <command>piuparts</command>."
1008 "パッケージをビルドし、インストールし、ソフトウェアを使ってみてください。"
1009 "パッケージを削除 (remove)、及び完全削除 (purge) できることを確認してください。"
1010 "<command>piuparts</command> でテストすると良いかもしれません。"
1012 #. type: Content of: <chapter><section><section><section><para>
1013 #: beyond-pkging.dbk:474
1015 "If the audit did not reveal any problem, you can build the package and "
1016 "upload it to Debian. Remember that even if you're not the maintainer, the "
1017 "sponsor is still responsible of what he uploaded to Debian. That's why "
1018 "you're encouraged to keep up with the package through the <xref linkend="
1019 "\"pkg-tracking-system\"/>."
1021 "監査で何も問題が見つからなかった場合には、パッケージをビルドして Debian へ"
1022 "アップロードすることができます。あなたがメンテナでなかったとしても、スポンサー"
1023 "は Debian へアップロードされたものへの責任を持つことを覚えておいてください。"
1024 "これが、 <xref linkend=\"pkg-tracking-system\"/> を使ってパッケージを追いかけて"
1027 # type: Content of: <chapter><section><section><para>
1028 #. type: Content of: <chapter><section><section><section><para>
1029 #: beyond-pkging.dbk:481
1031 "Note that you should not need to modify the source package to put your name "
1032 "in the <filename>changelog</filename> or in the <filename>control</filename> "
1033 "file. The <literal>Maintainer</literal> field of the <filename>control</"
1034 "filename> file and the <filename>changelog</filename> should list the person "
1035 "who did the packaging, i.e. the sponsoree. That way she will get all the BTS "
1038 "<filename>changelog</filename> ファイルや <filename>control</filename> ファイル"
1039 "にあなたの名前を入れるために、ソースパッケージを変更する必要はないことに注意して"
1040 "ください。<filename>control</filename> ファイルの<literal>Maintainer</literal> 欄と "
1041 "<filename>changelog</filename> にはパッケージ作業を行った人を記載する必要があ"
1042 "ります。つまりはスポンサー対象者、ということです。そうすることで、メンテナはすべて"
1043 "の BTS メールを受け取るようになります。"
1045 #. type: Content of: <chapter><section><section><section><para>
1046 #: beyond-pkging.dbk:487
1048 "Instead you should instruct <command>dpkg-buildpackage</command> to use your "
1049 "key for the signature. You do that with the <literal>-k</literal> option:"
1051 "代わりに、署名にあなたの鍵を使うために <command>dpkg-buildpackage</command> "
1052 "に指示する必要があります。これは <literal>-k</literal> オプションを使って行います: "
1054 # type: Content of: <chapter><section><section><screen>
1055 #. type: Content of: <chapter><section><section><section><screen>
1056 #: beyond-pkging.dbk:490
1058 msgid "dpkg-buildpackage -k<replaceable>KEY-ID</replaceable>\n"
1059 msgstr "dpkg-buildpackage -k<replaceable>KEY-ID</replaceable>\n"
1061 #. type: Content of: <chapter><section><section><section><para>
1062 #: beyond-pkging.dbk:492
1064 "If you use <command>debuild</command> and <command>debsign</command>, you "
1065 "can even configure it permanently in <filename>~/.devscripts</filename>:"
1067 "<command>debuild</command> と <command>debsign</command> を使う場合は、"
1068 "<filename>~/.devscripts</filename> に設定を決め打ちで書いても構いません:"
1070 # type: Content of: <chapter><section><section><screen>
1071 #. type: Content of: <chapter><section><section><section><programlisting>
1072 #: beyond-pkging.dbk:495
1074 msgid "DEBSIGN_KEYID=<replaceable>KEY-ID</replaceable>\n"
1075 msgstr "DEBSIGN_KEYID=<replaceable>KEY-ID</replaceable>\n"
1077 #. type: Content of: <chapter><section><section><section><title>
1078 #: beyond-pkging.dbk:500
1079 msgid "Sponsoring an update of an existing package"
1080 msgstr "既存パッケージの更新をスポンサーする"
1082 #. type: Content of: <chapter><section><section><section><para>
1083 #: beyond-pkging.dbk:502
1085 "You will usually assume that the package has already gone through a full "
1086 "review. So instead of doing it again, you will carefully analyze the "
1087 "difference between the current version and the new version prepared by the "
1088 "maintainer. If you have not done the initial review yourself, you might "
1089 "still want to have a more deeper look just in case the initial reviewer was "
1092 "通常、パッケージは既に全体的なレビューを受けているとします。ですので、"
1093 "もう一度すべてを行う代わりに、現在のバージョンとメンテナによって準備された"
1094 "新しいバージョンとの差分を注意深く分析することになります。最初のレビューを"
1095 "あなた自身が行っていない場合は、最初のレビュワーがいい加減であった場合に備えて、"
1096 "より子細に確認を行った方が良いかもしれません。"
1098 #. type: Content of: <chapter><section><section><section><para>
1099 #: beyond-pkging.dbk:510
1101 "To be able to analyze the difference you need both versions. Download the "
1102 "current version of the source package (with <command>apt-get source</"
1103 "command>) and rebuild it (or download the current binary packages with "
1104 "<command>aptitude download</command>). Download the source package to "
1105 "sponsor (usually with <command>dget</command>)."
1107 "差分を分析する為には両方のバージョンが必要です。ソースパッケージの現在の"
1108 "バージョンをダウンロードし (<command>apt-get source</command>)、リビルド"
1109 "します (あるいは <command>aptitude download</command> で現在のバイナリ"
1110 "パッケージをダウンロードします)。それから、スポンサー用のソースパッケージを"
1111 "ダウンロードします (通常、<command>dget</command> を使います)。"
1113 #. type: Content of: <chapter><section><section><section><para>
1114 #: beyond-pkging.dbk:517
1116 "Read the new changelog entry, it should tell you what to expect during the "
1117 "review. The main tool you will use is <command>debdiff</command> (provide by "
1118 "the <systemitem role=\"package\">devscripts</systemitem> package), you can "
1119 "run it with two source packages (<filename>.dsc</filename> files), or two "
1120 "binary packages, or two <filename>.changes</filename> files (it will then "
1121 "compare all the binary packages listed in the <filename>.changes</filename>)."
1123 "まず、changelog の新しいエントリを読みます。これで、レビュー中に予期しておく"
1124 "事柄を知ることができます。使うことになる主なツールは <command>debdiff</command> "
1125 "です (<systemitem role=\"package\">devscripts</systemitem> パッケージに含まれて"
1126 "います)。2 つのソースパッケージ (<filename>.dsc</filename> ファイル) に対して実行"
1127 "するか、2 つのバイナリパッケージ、あるいは 2 つの <filename>.changes</filename> "
1128 "ファイルに対して実行することができます (その場合は <filename>.changes</filename> "
1129 "に記載されているすべてのバイナリファイルを比較します)。"
1131 #. type: Content of: <chapter><section><section><section><para>
1132 #: beyond-pkging.dbk:524
1134 "If you compare the source packages (excluding upstream files in the case of "
1135 "a new upstream version, for example by filtering the output of "
1136 "<command>debdiff</command> with <command>filterdiff -i '*/debian/*'</"
1137 "command>), you must understand all the changes you see and they should be "
1138 "properly documented in the Debian changelog."
1140 "ソースパッケージを比較した場合 (新しい開発元のバージョンの場合には、例えば "
1141 "<command>debdiff</command> の出力を <command>filterdiff -i '*/debian/*'</"
1142 "command> などとして、開発元のファイルを除外します)、確認したすべての変更点を"
1143 "理解して、この変更点が Debian の changelog に正しく記載されている必要があります。"
1145 #. type: Content of: <chapter><section><section><section><para>
1146 #: beyond-pkging.dbk:531
1148 "If everything is fine, build the package and compare the binary packages to "
1149 "verify that the changes on the source package have no unexpected "
1150 "consequences (like some files dropped by mistake, missing dependencies, "
1153 "何も問題がなければ、パッケージをビルドし、ソースパッケージ上の変更が期待して"
1154 "いない結果 (ミスのためファイルがなくなっている、依存関係の欠落など) をもたらして"
1155 "いないかを確認するため、バイナリパッケージを比較します。"
1157 #. type: Content of: <chapter><section><section><section><para>
1158 #: beyond-pkging.dbk:537
1160 "You might want to check out the Package Tracking System (see <xref linkend="
1161 "\"pkg-tracking-system\"/>) to verify if the maintainer has not missed "
1162 "something important. Maybe there are translations updates sitting in the BTS "
1163 "that could have been integrated. Maybe the package has been NMUed and the "
1164 "maintainer forgot to integrate the changes from the NMU in his package. "
1165 "Maybe there's a release critical bug that he has left unhandled and that's "
1166 "blocking migration to <literal>testing</literal>. Whatever. If you find "
1167 "something that she could have done (better), it's time to tell her so that "
1168 "she can improve for next time, and so that she has a better understanding of "
1169 "her responsibilities."
1171 "メンテナが何か重要なことを見逃していないかを確認する為に、パッケージ追跡シス"
1172 "テム (PTS、<xref linkend=\"pkg-tracking-system\"/> 参照) を見るのが良いかも"
1173 "しれません。追加が可能な翻訳の更新が BTS にあるかもしれません。パッケージが "
1174 "NMU されていて、メンテナが NMU での変更をパッケージへ取り入れるのを忘れている"
1175 "かもしれません。リリースクリティカルバグがあって、メンテナが放置しているために"
1176 "<literal>テスト版 (testing)</literal> への移行が阻まれているかもしれません。"
1177 "何でもあります。メンテナが何か (より良く) できることを見つけたら、それを伝えま"
1178 "しょう。次回に改善ができますし、メンテナは責務についてより深く理解することに"
1181 #. type: Content of: <chapter><section><section><section><para>
1182 #: beyond-pkging.dbk:549
1184 "If you have found no major problem, upload the new version. Otherwise ask "
1185 "the maintainer to provide you a fixed version."
1187 "何も大きな問題を見つけなければ、新しいバージョンをアップロードします。"
1188 "そうでなければ、メンテナに修正したバージョンをアップロードするよう要請します。"
1190 # type: Content of: <chapter><section><section><title>
1191 #. type: Content of: <chapter><section><section><title>
1192 #: beyond-pkging.dbk:556
1193 msgid "Advocating new developers"
1194 msgstr "新たな開発者を支持する (advocate)"
1196 # type: Content of: <chapter><section><section><para>
1197 #. type: Content of: <chapter><section><section><para>
1198 #: beyond-pkging.dbk:558
1200 "See the page about <ulink url=\"&url-newmaint-advocate;\">advocating a "
1201 "prospective developer</ulink> at the Debian web site."
1203 "Debian ウェブサイトの<ulink url=\"&url-newmaint-advocate;\">開発者志願者の支"
1204 "持者になる (advocating a prospective developer)</ulink>のページを参照してくだ"
1207 # type: Content of: <chapter><section><section><title>
1208 #. type: Content of: <chapter><section><section><title>
1209 #: beyond-pkging.dbk:565
1210 msgid "Handling new maintainer applications"
1211 msgstr "新規メンテナ申請 (new maintainer applications) を取り扱う"
1213 # type: Content of: <chapter><section><section><para>
1214 #. type: Content of: <chapter><section><section><para>
1215 #: beyond-pkging.dbk:567
1217 "Please see <ulink url=\"&url-newmaint-amchecklist;\">Checklist for "
1218 "Application Managers</ulink> at the Debian web site."
1220 "Debian のウェブサイトにある <ulink url=\"&url-newmaint-amchecklist;\">申請管"
1221 "理者用チェックリスト (Checklist for Application Managers)</ulink> を参照して"
1224 # type: Content of: <chapter><section><section><para>
1226 #~ "Sponsoring merely by signing the upload or just recompiling is <emphasis "
1227 #~ "role=\"strong\">definitely not recommended</emphasis>. You need to build "
1228 #~ "the source package just like you would build a package of your own. "
1229 #~ "Remember that it doesn't matter that you left the prospective developer's "
1230 #~ "name both in the changelog and the control file, the upload can still be "
1233 #~ "単にサインしてアップロードするや、再コンパイルするだけのスポンサー作業は"
1234 #~ "<emphasis role=\"strong\">全く推奨されません</emphasis>。ソースパッケージ"
1235 #~ "を自分自身がパッケージをビルドするようにビルドする必要があります。"
1236 #~ "changelog と control ファイルに開発候補者の名前を残してあろうとも、アップ"
1237 #~ "ロード誰がしたかは遡及できることを忘れないでください。"
1239 # type: Content of: <chapter><section><section><para>
1241 #~ "If you are an application manager for a prospective developer, you can "
1242 #~ "also be their sponsor. That way you can also verify how the applicant is "
1243 #~ "handling the 'Tasks and Skills' part of their application."
1245 #~ "もしあなたが開発候補者の応募管理者であれば、彼らのスポンサーとなることもで"
1246 #~ "きます。こうすることで応募者が応募作業の 'Tasks and Skills' 部分をどう取り"
1249 # type: Content of: <chapter><section><section><title>
1250 #~ msgid "Managing sponsored packages"
1251 #~ msgstr "スポンサーされたパッケージを取り扱う"
1253 # type: Content of: <chapter><section><section><para>
1255 #~ "By uploading a sponsored package to Debian, you are certifying that the "
1256 #~ "package meets minimum Debian standards. That implies that you must build "
1257 #~ "and test the package on your own system before uploading."
1259 #~ "スポンサーされたパッケージを Debian にアップロードすることは、Debian の標"
1260 #~ "準について最低限は合致していることを保証することです。つまり、アップロード"
1261 #~ "前に自分自身のシステムでパッケージをビルド、テストしなくてはいけないという"
1264 # type: Content of: <chapter><section><section><para>
1266 #~ "You cannot simply upload a binary <filename>.deb</filename> from the "
1267 #~ "sponsoree. In theory, you should only ask for the diff file and the "
1268 #~ "location of the original source tarball, and then you should download the "
1269 #~ "source and apply the diff yourself. In practice, you may want to use the "
1270 #~ "source package built by your sponsoree. In that case, you have to check "
1271 #~ "that they haven't altered the upstream files in the <filename>.orig.tar."
1272 #~ "{gz,bz2,lzma}</filename> file that they're providing."
1274 #~ "あなたは、スポンサー対象者からの <filename>.deb</filename> バイナリを単に"
1275 #~ "アップロードすることはできません。通常、diff ファイルとオリジナルのソース "
1276 #~ "tar ファイルを要求して、それから自分でソースをダウンロードして diff を適用"
1277 #~ "する必要があります。実際には、スポンサー対象者が生成したソースパッケージを"
1278 #~ "使うということです。この場合、彼らが提供した <filename>.orig.tar.{gz,bz2,"
1279 #~ "lzma}</filename> ファイル中の開発元 (upstream) を改変していないことを"
1282 # type: Content of: <chapter><section><section><para>
1284 #~ "Do not be afraid to write the sponsoree back and point out changes that "
1285 #~ "need to be made. It often takes several rounds of back-and-forth email "
1286 #~ "before the package is in acceptable shape. Being a sponsor means being a "
1289 #~ "スポンサー対象者に必要な変更点を指摘の連絡するのを恐れないでください。パッ"
1290 #~ "ケージが受け入れ可能な形になる前に何度もメールのやりとりが起こるのはよくあ"
1291 #~ "ることです。スポンサーになるということはメンター (mentor) になるということ"
1294 # type: Content of: <chapter><section><section><para>
1295 #~ msgid "Once the package meets Debian standards, build and sign it with"
1297 #~ "一旦 Debian の標準に合致するようになったら、incoming ディレクトリにアップ"
1298 #~ "ロードする前にパッケージを以下の様にしてビルドして署名してください"
1300 # type: Content of: <chapter><section><section><para>
1301 # FIXME devided articles
1303 #~ "before uploading it to the incoming directory. Of course, you can also "
1304 #~ "use any part of your <replaceable>KEY-ID</replaceable>, as long as it's "
1305 #~ "unique in your secret keyring."
1307 #~ "もちろん、秘密鍵のキーリング中で唯一である限り、どの <replaceable>KEY-ID</"
1308 #~ "replaceable> も使うことができます。"
1310 # type: Content of: <chapter><section><section><para>
1312 #~ "If you prefer to leave a more evident trace of your sponsorship job, you "
1313 #~ "can add a line stating it in the most recent changelog entry."
1315 #~ "スポンサーを行ったという状況証拠を残しておいて後から確認したいという場合"
1316 #~ "は、最も新しい changelog のエントリにそのような記述を追加できます。"
1318 # type: Content of: <chapter><section><section><para>
1321 #~ "You are encouraged to keep tabs on the package you sponsor using <xref "
1322 #~ "linkend=\"pkg-tracking-system\"/>."
1324 #~ "<xref linkend=\"pkg-tracking-system\"/> を使って、スポンサーしたパッケージ"
1325 #~ "の状況を把握するのをお勧めします。"