X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=blobdiff_plain;f=po4a%2Fja%2Fbeyond-pkging.po;h=d36693eb4824ff15aa228a45966bb97df220c3cb;hp=f486f3bdd3eee815003c0028307936d7bf8ad67c;hb=9afdf8bcc6795a93b50467b46c13f93665ce9624;hpb=9d3a7b993a4e279ff8e4249bdba075f7cfff70a2 diff --git a/po4a/ja/beyond-pkging.po b/po4a/ja/beyond-pkging.po index f486f3b..d36693e 100644 --- a/po4a/ja/beyond-pkging.po +++ b/po4a/ja/beyond-pkging.po @@ -1,13 +1,14 @@ # Debian Developer's Reference (Japanese) -# (C) Hideki Yamane (Debian-JP) , 2008-2010. +# (C) Hideki Yamane , 2008-2011. # msgid "" msgstr "" -"Project-Id-Version: developers-reference 3.4.2\n" -"POT-Creation-Date: 2010-06-20 09:22-0400\n" -"PO-Revision-Date: 2010-10-01 08:04+0900\n" +"Project-Id-Version: developers-reference 3.4.5\n" +"POT-Creation-Date: 2011-04-22 10:44-0400\n" +"PO-Revision-Date: 2011-07-03 23:04+0900\n" "Last-Translator: Hideki Yamane \n" "Language-Team: Japanese \n" +"Language: ja\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" @@ -82,7 +83,7 @@ msgid "" "receive mail, so that people can reach you if they need further information " "about the bug. Do not submit bugs as root." msgstr "" -"いつも使っているメールを受け取れるユーザアカウントからバグを送って見てくださ" +"いつも使っているメールを受け取れるユーザアカウントからバグを送ってみてくださ" "い。そうすることで、開発者がそのバグに関するより詳細な情報を必要とする場合に" "あなたに尋ねることができます。root ユーザでバグを報告しないでください。" @@ -95,8 +96,8 @@ msgid "" "can automate and generally ease the process." msgstr "" "バグを報告するには、 reportbug " -"1 の様なツールが使えます。これによって" -"自動化を行って、かなり簡単な作業にできます。" +"1 のようなツールが使えます。これによって" +"作業を自動化し、かなり簡単なものにできます。" # type: Content of:
#. type: Content of:
@@ -104,7 +105,7 @@ msgstr "" msgid "" "Make sure the bug is not already filed against a package. Each package has " "a bug list easily reachable at http://&bugs-host;/" -"packagename Utilities like " +"packagename. Utilities like " " querybts 1 can also provide you with this information (and " "reportbug will usually invoke querybts " @@ -114,9 +115,9 @@ msgstr "" "個々のパッケージに対するバグのリストは http://&bugs-host;/" "パッケージ名 にて簡単に確認できます。" " querybts 1 のようなユーティリティもこの情報を入手できます (そ" -"れから reportbug では大抵の場合は、バグを送信する前に " -"querybts の実行もします)。" +"manvolnum> のようなユーティリティでもこの情報を入手できます " +"(なお、reportbug では大抵の場合、バグを送信する前に " +"querybts の実行も行っています)。" # type: Content of:
#. type: Content of:
@@ -157,7 +158,7 @@ msgid "" "have to visit http://&bugs-host;/from:your-email-addr." msgstr "" -"時折、あなたが報告したバグ報告について何が起こっているのかをチェックしたくな" +"時折、あなたが登録したバグ報告について何が起こっているのかをチェックしたくな" "ることでしょう。これは、もう再現できないものをクローズするきっかけになりま" "す。報告した全てのバグ報告を確認するには、http://&bugs-host;/from:" "your-email-addr を参照すればいいだけで" @@ -196,7 +197,7 @@ msgid "" "problem. In addition, it will help prevent a situation in which several " "maintainers start filing the same bug report simultaneously." msgstr "" -"同じ問題について一度に 10 個以上のバグを報告する場合は、バグの投稿をする前に " +"同じ問題について一度に 10 個以上のバグを報告する場合は、バグ報告を登録する前に " "&email-debian-devel; へ送ることをお勧めします。バグ報告を送る前に注意点を記述" "し、メールのサブジェクトに事実を挙げておきます。これで他の開発者がそのバグが" "本当に問題であるかどうかを確認できるようになります。さらに、これによって複数" @@ -224,9 +225,9 @@ msgid "" "bug report to maintonly@&bugs-host; so that the bug report is " "not forwarded to the bug distribution mailing list." msgstr "" -"同じサブジェクトで大量のバグを送信する際の注意として、バグ報告がバグ情報用" +"同じサブジェクトで大量のバグを送信する際は、バグ報告がバグ情報用" "メーリングリストへ転送されないように　maintonly@&bugs-host; へ" -"バグ報告を送るべきである、ということです。" +"バグ報告を送るべきであるの注意してください。" #. type: Content of:
#: beyond-pkging.dbk:98 @@ -289,7 +290,7 @@ msgid "" "you set the <literal>User</literal> to an appropriate mailing list after " "describing your intention there." msgstr "" -"タグは空白で区切られ、アンダースコア (_) を含められないのに注意してください。" +"タグは空白で区切られ、アンダースコア (_) を含められないことに注意してください。" "特定のグループやチームについてのバグを登録する場合は、適切なメーリングリスト" "で注意を促した上で <literal>User</literal> をそのメーリングリストに設定するの" "をお勧めします。" @@ -334,8 +335,8 @@ msgstr "" "品質保証に割り当てられたグループの人々がいたとしても、QA 作業は彼らのみに課せ" "られるものではありません。あなたもパッケージを可能な限りバグが無いように保" "ち、できるだけ lintian clean な状態 (<xref linkend=\"lintian\"/> を参照) にす" -"ることで参加することができるのです。それが可能ではないように思えるなら、パッ" -"ケージをいくつか「みなしご化 (orphan)」してください (<xref linkend=" +"ることで品質保証の作業に参加することができるのです。それが可能ではないように" +"思えるなら、パッケージをいくつか「みなしご化 (orphan)」してください (<xref linkend=" "\"orphaning\"/> 参照)。または、溜まったバグ処理に追いつくため、他の人々に助力" "を願い出ることも可能です (&email-debian-qa; や &email-debian-devel; で助けを" "求めることができます)。同時に共同メンテナ (co-maintainer) を探すことも可能で" @@ -360,7 +361,7 @@ msgid "" msgstr "" "時折、QA グループは可能な限りの問題を無くすためにバグ潰しパーティ (BSP) を開" "催しています。開催案内は &email-debian-devel-announce; で行われ、パーティがど" -"の部分に集中してやるのかが告知されます。大抵はリリースクリティカルバグ (RC) " +"の部分に集中して行われるのかが告知されます。大抵はリリースクリティカルバグ (RC) " "への対応に当てられますが、大きなアップグレード (新しい <command>perl</" "command> バージョンでの全バイナリモジュールを再コンパイルのような) を完了する" "手助けのために開かれることもあります。" @@ -510,6 +511,8 @@ msgstr "" "org/qa.debian.org/mia</filename> で利用可能になっており、<command>mia-query</" "command> ツールで検索ができます。どうやってデータベースを検索するのかについて" "は <command>mia-query --help</command> と入力してください。" +"活動的ではないメンテナについての情報がまだ記録されていない、あるいはそのメンテナ" +"についての情報を追加できる場合は、おおよそ以下の手続きを行う必要があります。" # type: Content of: <chapter><section><para> #. type: Content of: <chapter><section><para> @@ -622,8 +625,8 @@ msgid "" "NMUer before orphaning the package — perhaps the person who has done the NMU " "is interested in the package." msgstr "" -"ここに書かれた全てを収集したなら、&email-mia;に連絡しましょう。この名前のエリ" -"アスを担当している人はあなたが供給した情報を使ってどう進めるかを判断します。" +"ここに書かれた全てを収集したなら、&email-mia;に連絡しましょう。この名前の宛先" +"を担当している人は、あなたが供給した情報を使ってどう進めるかを判断します。" "例えば、そのメンテナのパッケージの一部または全てをみなしご化 (Orphan) するか" "も知れません。パッケージがNMUされていた場合は、パッケージをみなしご化 " "(Orphan) する前にNMUをした人に連絡する事を選ぶかもしれません — NMUをした人は" @@ -706,182 +709,493 @@ msgstr "パッケージのスポンサーを行う" #: beyond-pkging.dbk:328 msgid "" "Sponsoring a package means uploading a package for a maintainer who is not " -"able to do it on their own, a new maintainer applicant. Sponsoring a " -"package also means accepting responsibility for it." +"able to do it on their own. It's not a trivial matter, the sponsor must " +"verify the packaging and ensure that it is of the high level of quality that " +"Debian strives to have." msgstr "" -"パッケージのスポンサーになるというのは自分の権限ではパッケージをアップロード" -"できない、新規メンテナ応募者のパッケージをアップロードするということです。ま" -"た、パッケージのスポンサーを行うことはそれに伴う責任を引き受けることを意味し" -"ます。" +"パッケージのスポンサーになるというのは、自分の権限ではパッケージをアップロード" +"できないメンテナのためにパッケージをアップロードする、ということです。これは些細" +"な問題ではなく、スポンサーはパッケージを精査して Debian が求めるような高いレベル" +"の品質であることを保証する必要があります。" -# type: Content of: <chapter><section><section><para> #. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:339 +#: beyond-pkging.dbk:334 +msgid "Debian Developers can sponsor packages. Debian Maintainers can't." +msgstr "Debian 開発者はパッケージをスポンサーできます。Debian メンテナはできません。" + +#. type: Content of: <chapter><section><section><para><orderedlist><listitem><para> +#: beyond-pkging.dbk:340 msgid "" -"New maintainers usually have certain difficulties creating Debian packages — " -"this is quite understandable. That is why the sponsor is there, to check " -"the package and verify that it is good enough for inclusion in Debian. " -"(Note that if the sponsored package is new, the ftpmasters will also have to " -"inspect it before letting it in.)" +"The maintainer prepares a source package (<filename>.dsc</filename>) and " +"puts it online somewhere (like on <ulink url=\"http://mentors.debian.net/cgi-" +"bin/welcome\">mentors.debian.net</ulink>) or even better, provides a link to " +"a public VCS repository (see <xref linkend=\"servers-vcs\"/>) where the " +"package is maintained." msgstr "" -"新たなメンテナは大抵 Debian パッケージの作成する際に何らかの困難に会いますー" -"これは非常に理解できることです。これはなぜスポンサーがいてパッケージをチェッ" -"クし Debian に含めるのに充分良いものであるかどうかを確認するのかの根拠です。" -"(注記: スポンサーされたパッケージが新規の場合、Debian に入れる前に ftpmaster " -"らがそのパッケージをチェックする必要があります)。" +"メンテナはソースパッケージ (<filename>.dsc</filename>) を用意してオンライン上の何処か" +" (例えば <ulink url=\"http://mentors.debian.net/cgi-bin/welcome\">mentors.debian.net" +"</ulink>) に置く、あるいはもっと良いのは、パッケージがメンテナンスされている公開 VCS " +"リポジトリへのリンクを提供することです (<xref linkend=\"servers-vcs\"/> 参照)。" -# type: Content of: <chapter><section><section><para> -#. type: Content of: <chapter><section><section><para> +#. type: Content of: <chapter><section><section><para><orderedlist><listitem><para> #: beyond-pkging.dbk:346 +msgid "The sponsor downloads (or checkouts) the source package." +msgstr "スポンサーはソースパッケージをダウンロード (あるいはチェックアウト) します。" + +#. type: Content of: <chapter><section><section><para><orderedlist><listitem><para> +#: beyond-pkging.dbk:349 msgid "" -"Sponsoring merely by signing the upload or just recompiling is <emphasis " -"role=\"strong\">definitely not recommended</emphasis>. You need to build " -"the source package just like you would build a package of your own. " -"Remember that it doesn't matter that you left the prospective developer's " -"name both in the changelog and the control file, the upload can still be " -"traced to you." +"The sponsor reviews the source package. If she finds issues, she informs the " +"maintainer and asks her to provide a fixed version (the process starts over " +"at step 1)." msgstr "" -"単にサインしてアップロードするや、再コンパイルするだけのスポンサー作業は" -"<emphasis role=\"strong\">全く推奨されません</emphasis>。ソースパッケージを自" -"分自身がパッケージをビルドするようにビルドする必要があります。changelog と " -"control ファイルに開発候補者の名前を残してあろうとも、アップロード誰がしたか" -"は遡及できることを忘れないでください。" +"スポンサーはソースパッケージをレビューします。問題を見つけたら、メンテナに知らせて" +"修正版をくれるように尋ねます (作業は step 1 へやり直しされます)。" + +#. type: Content of: <chapter><section><section><para><orderedlist><listitem><para> +#: beyond-pkging.dbk:354 +msgid "" +"The sponsor could not find any remaining problem. She builds the package, " +"signs it, and uploads it to Debian." +msgstr "" +"スポンサーは、何も問題が残っているのを見つけられませんでした。パッケージをビルドし、" +"署名し、Debian へアップロードします。" -# type: Content of: <chapter><section><section><para> #. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:353 +#: beyond-pkging.dbk:337 msgid "" -"If you are an application manager for a prospective developer, you can also " -"be their sponsor. That way you can also verify how the applicant is " -"handling the 'Tasks and Skills' part of their application." +"The process of sponsoring a package is: <placeholder type=\"orderedlist\" id=" +"\"0\"/>" msgstr "" -"もしあなたが開発候補者の応募管理者であれば、彼らのスポンサーとなることもでき" -"ます。こうすることで応募者が応募作業の 'Tasks and Skills' 部分をどう取り扱え" -"るかを判断できます。" +"パッケージのスポンサー作業の流れは以下の通りです: <placeholder type=\"orderedlist\" id=" +"\"0\"/>" -# type: Content of: <chapter><section><section><title> -#. type: Content of: <chapter><section><section><title> +#. type: Content of: <chapter><section><section><para> #: beyond-pkging.dbk:360 -msgid "Managing sponsored packages" -msgstr "スポンサーされたパッケージを取り扱う" +msgid "" +"Before delving in the details of how to sponsor a package, you should ask " +"yourself whether adding the proposed package is beneficial to Debian." +msgstr "" +"パッケージのスポンサーのやり方について詳細を詰める前に、提案されたパッケージ" +"を追加することが Debian にとって有益であるかどうか、自分自身に問いかける必要" +"があります。" -# type: Content of: <chapter><section><section><para> #. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:362 +#: beyond-pkging.dbk:364 msgid "" -"By uploading a sponsored package to Debian, you are certifying that the " -"package meets minimum Debian standards. That implies that you must build " -"and test the package on your own system before uploading." +"There's no simple rule to answer this question, it can depend on many " +"factors: is the upstream codebase mature and not full of security holes? Are " +"there pre-existing packages that can do the same task and how do they " +"compare to this new package? Has the new package been requested by users and " +"how large is the user base? How active are the upstream developers?" msgstr "" -"スポンサーされたパッケージを Debian にアップロードすることは、Debian の標準に" -"ついて最低限は合致していることを保証することです。つまり、アップロード前に自" -"分自身のシステムでパッケージをビルド、テストしなくてはいけないという意味で" -"す。" +"この質問に答えるのは単純ではなく、多くの要因に依っています: 開発元のコード" +"は成熟していて、セキュリティホールの山ではないですか? 同じことができる既存" +"パッケージがありませんか? そしてこの新しいパッケージと比べてどうですか? " +"新しいパッケージはユーザから要求されたものですか? そしてユーザ数はどの程度" +"の大きさですか? 大本の開発者らはアクティブですか?" -# type: Content of: <chapter><section><section><para> #. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:367 -msgid "" -"You cannot simply upload a binary <filename>.deb</filename> from the " -"sponsoree. In theory, you should only ask for the diff file and the " -"location of the original source tarball, and then you should download the " -"source and apply the diff yourself. In practice, you may want to use the " -"source package built by your sponsoree. In that case, you have to check " -"that they haven't altered the upstream files in the <filename>.orig.tar.{gz," -"bz2,lzma}</filename> file that they're providing." -msgstr "" -"あなたは、スポンサー対象者からの <filename>.deb</filename> バイナリを単にアッ" -"プロードすることはできません。通常、diff ファイルとオリジナルのソース tar " -"ファイルを要求して、それから自分でソースをダウンロードして diff を適用する必" -"要があります。実際には、スポンサー対象者が生成したソースパッケージを使うとい" -"うことです。この場合、彼らが提供した <filename>.orig.tar.{gz,bz2,lzma}</" -"filename> ファイル中の開発元 (upstream) を改変していないことをチェックする必" -"要があります。" +#: beyond-pkging.dbk:371 +msgid "" +"You should also ensure that the prospective maintainer is going to be a good " +"maintainer. Does she already have some experience with other packages? If " +"yes, is she doing a good job with them (check out some bugs)? Is she " +"familiar with the package and its programming language? Does she have the " +"skills needed for this package? If not, is she able to learn them?" +msgstr "" +"それから、メンテナ候補者が良いメンテナになるであろうことを保証する必要が" +"あります。他のパッケージでの経験がありますか? そうであれば、良い仕事をして" +"いますか (バグを確認している)? パッケージと使われているプログラミング言語" +"について詳しいですか? そのパッケージに必要なスキルを持っていますか? そうで" +"なければ、学ぶことが可能でしょうか?" -# type: Content of: <chapter><section><section><para> +# FIXME-trans #. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:376 +#: beyond-pkging.dbk:379 msgid "" -"Do not be afraid to write the sponsoree back and point out changes that need " -"to be made. It often takes several rounds of back-and-forth email before " -"the package is in acceptable shape. Being a sponsor means being a mentor." +"It's also a good idea to know where she stands towards Debian: does she " +"agree with Debian's philosophy and does she intend to join Debian? Given how " +"easy it is to become a Debian Maintainer, you might want to only sponsor " +"people who plan to join. That way you know from the start that you won't " +"have to act as a sponsor indefinitely." msgstr "" -"スポンサー対象者に必要な変更点を指摘の連絡するのを恐れないでください。パッ" -"ケージが受け入れ可能な形になる前に何度もメールのやりとりが起こるのはよくある" -"ことです。スポンサーになるということはメンター (mentor) になるということで" -"す。" +"候補者が、Debian に対してどういうスタンスでいるかを知ることも良い考えです: " +"Debian の哲学に賛同していて、Debian に参加したいと思っていますか? Debian " +"メンテナになるのがどれくらい簡単なのかを考えて、参加を検討している人たちだけ" +"をスポンサーするのが良いでしょう。こうすれば、最初からずっとスポンサーとして" +"行動しなくて良いと思っておけます。" + +# type: Content of: <chapter><section><section><title> +#. type: Content of: <chapter><section><section><section><title> +#: beyond-pkging.dbk:386 +msgid "Sponsoring a new package" +msgstr "新しいパッケージのスポンサーを行う" # type: Content of: <chapter><section><section><para> -#. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:381 -msgid "Once the package meets Debian standards, build and sign it with" +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:388 +msgid "" +"New maintainers usually have certain difficulties creating Debian packages — " +"this is quite understandable. They will do mistakes. That's why sponsoring a " +"brand new package into Debian requires a thorough review of the Debian " +"packaging. Sometimes several iterations will be needed until the package is " +"good enough to be uploaded to Debian. Thus being a sponsor implies being a " +"mentor." +msgstr "" +"新たなメンテナは、Debian パッケージの作成する際に大抵何らかの困難に会いますー" +"これは非常に理解できることです。彼らは間違いを犯します。これは、全く新しい" +"パッケージを Debian でスポンサーするのに、Debian パッケージングの徹底的なレビューを" +"受ける必要がある根拠です。時折、パッケージが Debian へアップロードされるのに" +"十分な状態になるまで、複数回のやり取りが必要になることがあります。それゆえ、" +"スポンサーになることは、メンターになることを伴います。" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:396 +msgid "" +"Don't ever sponsor a new package without reviewing it. The review of new " +"packages done by ftpmasters mainly ensures that the software is really free. " +"Of course, it happens that they stumble on packaging problems but they " +"really should not. It's your task to ensure that the uploaded package " +"complies with the Debian Free Software Guidelines and is of good quality." +msgstr "" +"レビューをせずに新しいパッケージのスポンサーをしないでください。ftpmaster に" +"よる新しいパッケージのレビューは、主にソフトウェアが本当にフリーなものであるかを" +"確認するためです。もちろん、パッケージ化に関する問題に偶然気づくことはありますが、" +"それを期待すべきではありません。アップロードされたパッケージが、Debian フリー" +"ソフトウェアガイドラインに適合し、良い品質であるのを保証するのは、あなたの仕事です。" + +#. type: Content of: <chapter><section><section><section><para><footnote><para> +#: beyond-pkging.dbk:409 +msgid "" +"You can find more checks in the wiki where several developers share their " +"own <ulink url=\"http://wiki.debian.org/SponsorChecklist\">sponsorship " +"checklists</ulink>." +msgstr "" +"もっと多くのチェック項目について、複数の開発者が持ち寄っている" +"<ulink url=\"http://wiki.debian.org/SponsorChecklist\">sponsorship " +"checklists</ulink> で見ることができます。" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:404 +msgid "" +"Building the package and testing the software is part of the review, but " +"it's also not enough. The rest of this section contains a non-exhaustive " +"list of points to check in your review. <placeholder type=\"footnote\" id=" +"\"0\"/>" +msgstr "" +"パッケージをビルドし、ソフトウェアのテストを行うのはレビューの一部ではありますが、" +"それだけでは十分ではありません。この章の残りの部分では、レビューでチェックする" +"ポイントの一覧を述べます (徹底的なものではありません)。<placeholder type=\"footnote\" id=" +"\"0\"/>" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:416 +msgid "" +"Verify that the upstream tarball provided is the same that has been " +"distributed by the upstream author (when the sources are repackaged for " +"Debian, generate the modified tarball yourself)." +msgstr "" +"upstream の tarball として提供されているものが、upstream の作者が配布している" +"ものと同じかどうかを確認する (ソースが Debian 用に再パッケージされている場合、" +"修正した tarball を自分自身で生成する)。" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:421 +msgid "" +"Run <command>lintian</command> (see <xref linkend=\"lintian\"/>). It will " +"catch many common problems. Be sure to verify that any <command>lintian</" +"command> overrides setup by the maintainer is fully justified." +msgstr "" +"<command>lintian</command> を実行する (<xref linkend=\"lintian\"/> 参照)。多くの" +"一般的な問題を見つけてくれます。<command>lintian</command> の overrides 設定が" +"メンテナによって設定されている場合、完全に問題がないことを確認してください。" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:426 +msgid "" +"Run <command>licensecheck</command> (part of <xref linkend=\"devscripts\"/>) " +"and verify that <filename>debian/copyright</filename> seems correct and " +"complete. Look for license problems (like files with “All rights reserved” " +"headers, or with a non-DFSG compliant license). <command>grep -ri</command> " +"is your friend for this task." +msgstr "" +"<command>licensecheck</command>(<xref linkend=\"devscripts\"/> の一部) を実行し、" +"<filename>debian/copyright</filename> が正しく、そして完全な事を確認する。" +"ライセンス問題を探してください (頭に“All rights reserved”とあるファイルや、" +"DFSG に適合しないライセンスがあるなど)。この作業には、<command>grep -ri</command> " +"が助けとなることでしょう。" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:433 +msgid "" +"Build the package with <command>pbuilder</command> (or any similar tool, see " +"<xref linkend=\"pbuilder\"/>) to ensure that the build-dependencies are " +"complete." +msgstr "" +"ビルドの依存関係が完全であるのを保証するため、パッケージを <command>pbuilder" +"</command> (やその他類似のツール) でビルドする (<xref linkend=\"pbuilder\"/> 参照)。" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:438 +msgid "" +"Proofread <filename>debian/control</filename>: does it follow the best " +"practices (see <xref linkend=\"bpp-debian-control\"/>)? Are the dependencies " +"complete?" +msgstr "" +"<filename>debian/control</filename> を査読する: ベストプラクティスに従っている" +"? (<xref linkend=\"bpp-debian-control\"/> 参照) 依存関係は完璧ですか?" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:443 +msgid "" +"Proofread <filename>debian/rules</filename>: does it follow the best " +"practices (see <xref linkend=\"bpp-debian-rules\"/>)? Do you see some " +"possible improvements?" +msgstr "" +"<filename>debian/rules</filename> を査読する: ベストプラクティスに従っている? " +"改善可能な点がある?" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:448 +msgid "" +"Proofread the maintainer scripts (<filename>preinst</filename>, " +"<filename>postinst</filename>, <filename>prerm</filename>, <filename>postrm</" +"filename>, <filename>config</filename>): will the <filename>preinst</" +"filename>/<filename>postrm</filename> work when the dependencies are not " +"installed? Are all the scripts idempotent (i.e. can you run them multiple " +"times without consequences)?" +msgstr "" +"メンテナスクリプト (<filename>preinst</filename>, " +"<filename>postinst</filename>, <filename>prerm</filename>, <filename>postrm</" +"filename>, <filename>config</filename>) を査読する: 依存関係がインストール" +"されていない時でも動作する? 全てのスクリプトが等羃 (idempotent、すなわち、" +"問題無しに複数回実行できる)?" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:456 +msgid "" +"Review any change to upstream files (either in <filename>.diff.gz</" +"filename>, or in <filename>debian/patches/</filename> or directly embedded " +"in the <filename>debian</filename> tarball for binary files). Are they " +"justified? Are they properly documented (with <ulink url=\"&url-dep3;" +"\">DEP-3</ulink> for patches)?" +msgstr "" +"開発元のファイルに対する変更 (<filename>.diff.gz</filename>、<filename>debian/" +"patches/</filename>、あるいは直接 <filename>debian</filename> tarball に埋め込" +"まれているバイナリファイル) をレビューする。十分な根拠がありますか? (パッチに" +"対し、<ulink url=\"&url-dep3;\">DEP-3</ulink> に沿って) 正しくドキュメント化" +"されている?" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:462 +msgid "" +"For every file, ask yourself why the file is there and whether it's the " +"right way to achieve the desired result. Is the maintainer following the " +"best packaging practices (see <xref linkend=\"best-pkging-practices\"/>)?" +msgstr "" +"すべてのファイルについて、そのファイルが何故そこにあるのか、望んでいる結果を" +"もたらすためにそれが正しいやり方かどうかを自身に問いかけてください。メンテナは" +"パッケージ化のベストプラクティスに従っていますか? (<xref linkend=\"best-pkging-" +"practices\"/> 参照)" + +#. type: Content of: <chapter><section><section><section><itemizedlist><listitem><para> +#: beyond-pkging.dbk:468 +msgid "" +"Build the packages, install them and try the software. Ensure you can remove " +"and purge the packages. Maybe test them with <command>piuparts</command>." +msgstr "" +"パッケージをビルドし、インストールし、ソフトウェアを使ってみてください。" +"パッケージを削除 (remove)、及び完全削除 (purge) できることを確認してください。" +"<command>piuparts</command> でテストすると良いかもしれません。" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:474 +msgid "" +"If the audit did not reveal any problem, you can build the package and " +"upload it to Debian. Remember that even if you're not the maintainer, the " +"sponsor is still responsible of what he uploaded to Debian. That's why " +"you're encouraged to keep up with the package through the <xref linkend=" +"\"pkg-tracking-system\"/>." +msgstr "" +"監査で何も問題が見つからなかった場合には、パッケージをビルドして Debian へ" +"アップロードすることができます。あなたがメンテナでなかったとしても、スポンサー" +"は Debian へアップロードされたものへの責任を持つことを覚えておいてください。" +"これが、 <xref linkend=\"pkg-tracking-system\"/> を使ってパッケージを追いかけて" +"おくことが推奨される理由です。" + +# type: Content of: <chapter><section><section><para> +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:481 +msgid "" +"Note that you should not need to modify the source package to put your name " +"in the <filename>changelog</filename> or in the <filename>control</filename> " +"file. The <literal>Maintainer</literal> field of the <filename>control</" +"filename> file and the <filename>changelog</filename> should list the person " +"who did the packaging, i.e. the sponsoree. That way she will get all the BTS " +"mail." +msgstr "" +"<filename>changelog</filename> ファイルや <filename>control</filename> ファイル" +"にあなたの名前を入れるために、ソースパッケージを変更する必要はないことに注意して" +"ください。<filename>control</filename> ファイルの<literal>Maintainer</literal> 欄と " +"<filename>changelog</filename> にはパッケージ作業を行った人を記載する必要があ" +"ります。つまりはスポンサー対象者、ということです。そうすることで、メンテナはすべて" +"の BTS メールを受け取るようになります。" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:487 +msgid "" +"Instead you should instruct <command>dpkg-buildpackage</command> to use your " +"key for the signature. You do that with the <literal>-k</literal> option:" msgstr "" -"一旦 Debian の標準に合致するようになったら、incoming ディレクトリにアップロー" -"ドする前にパッケージを以下の様にしてビルドして署名してください" +"代わりに、署名にあなたの鍵を使うために <command>dpkg-buildpackage</command> " +"に指示する必要があります。これは <literal>-k</literal> オプションを使って行います: " # type: Content of: <chapter><section><section><screen> -#. type: Content of: <chapter><section><section><screen> -#: beyond-pkging.dbk:384 +#. type: Content of: <chapter><section><section><section><screen> +#: beyond-pkging.dbk:490 #, no-wrap msgid "dpkg-buildpackage -k<replaceable>KEY-ID</replaceable>\n" msgstr "dpkg-buildpackage -k<replaceable>KEY-ID</replaceable>\n" -# type: Content of: <chapter><section><section><para> -# FIXME devided articles -#. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:387 +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:492 msgid "" -"before uploading it to the incoming directory. Of course, you can also use " -"any part of your <replaceable>KEY-ID</replaceable>, as long as it's unique " -"in your secret keyring." +"If you use <command>debuild</command> and <command>debsign</command>, you " +"can even configure it permanently in <filename>~/.devscripts</filename>:" msgstr "" -"もちろん、秘密鍵のキーリング中で唯一である限り、どの <replaceable>KEY-ID</" -"replaceable> も使うことができます。" +"<command>debuild</command> と <command>debsign</command> を使う場合は、" +"<filename>~/.devscripts</filename> に設定を決め打ちで書いても構いません:" -# type: Content of: <chapter><section><section><para> -#. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:392 +# type: Content of: <chapter><section><section><screen> +#. type: Content of: <chapter><section><section><section><programlisting> +#: beyond-pkging.dbk:495 +#, no-wrap +msgid "DEBSIGN_KEYID=<replaceable>KEY-ID</replaceable>\n" +msgstr "DEBSIGN_KEYID=<replaceable>KEY-ID</replaceable>\n" + +#. type: Content of: <chapter><section><section><section><title> +#: beyond-pkging.dbk:500 +msgid "Sponsoring an update of an existing package" +msgstr "既存パッケージの更新をスポンサーする" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:502 msgid "" -"The <literal>Maintainer</literal> field of the <filename>control</filename> " -"file and the <filename>changelog</filename> should list the person who did " -"the packaging, i.e., the sponsoree. The sponsoree will therefore get all " -"the BTS mail about the package." +"You will usually assume that the package has already gone through a full " +"review. So instead of doing it again, you will carefully analyze the " +"difference between the current version and the new version prepared by the " +"maintainer. If you have not done the initial review yourself, you might " +"still want to have a more deeper look just in case the initial reviewer was " +"sloppy." msgstr "" -"<filename>control</filename> ファイルの<literal>Maintainer</literal> 欄と" -"<filename>changelog</filename> にはパッケージ作業を行った人を記載する必要があ" -"ります。つまりはスポンサー対象者、ということです。そうすることで、スポンサー" -"対象者がパッケージに対する BTS メールを受け取れるようになります。" +"通常、パッケージは既に全体的なレビューを受けているとします。ですので、" +"もう一度すべてを行う代わりに、現在のバージョンとメンテナによって準備された" +"新しいバージョンとの差分を注意深く分析することになります。最初のレビューを" +"あなた自身が行っていない場合は、最初のレビュワーがいい加減であった場合に備えて、" +"より子細に確認を行った方が良いかもしれません。" -# type: Content of: <chapter><section><section><para> -#. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:398 +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:510 msgid "" -"If you prefer to leave a more evident trace of your sponsorship job, you can " -"add a line stating it in the most recent changelog entry." +"To be able to analyze the difference you need both versions. Download the " +"current version of the source package (with <command>apt-get source</" +"command>) and rebuild it (or download the current binary packages with " +"<command>aptitude download</command>). Download the source package to " +"sponsor (usually with <command>dget</command>)." msgstr "" -"スポンサーを行ったという状況証拠を残しておいて後から確認したいという場合は、" -"最も新しい changelog のエントリにそのような記述を追加できます。" +"差分を分析する為には両方のバージョンが必要です。ソースパッケージの現在の" +"バージョンをダウンロードし (<command>apt-get source</command>)、リビルド" +"します (あるいは <command>aptitude download</command> で現在のバイナリ" +"パッケージをダウンロードします)。それから、スポンサー用のソースパッケージを" +"ダウンロードします (通常、<command>dget</command> を使います)。" -# type: Content of: <chapter><section><section><para> -# FIXME keep tabs? -#. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:402 +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:517 +msgid "" +"Read the new changelog entry, it should tell you what to expect during the " +"review. The main tool you will use is <command>debdiff</command> (provide by " +"the <systemitem role=\"package\">devscripts</systemitem> package), you can " +"run it with two source packages (<filename>.dsc</filename> files), or two " +"binary packages, or two <filename>.changes</filename> files (it will then " +"compare all the binary packages listed in the <filename>.changes</filename>)." +msgstr "" +"まず、changelog の新しいエントリを読みます。これで、レビュー中に予期しておく" +"事柄を知ることができます。使うことになる主なツールは <command>debdiff</command> " +"です (<systemitem role=\"package\">devscripts</systemitem> パッケージに含まれて" +"います)。2 つのソースパッケージ (<filename>.dsc</filename> ファイル) に対して実行" +"するか、2 つのバイナリパッケージ、あるいは 2 つの <filename>.changes</filename> " +"ファイルに対して実行することができます (その場合は <filename>.changes</filename> " +"に記載されているすべてのバイナリファイルを比較します)。" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:524 +msgid "" +"If you compare the source packages (excluding upstream files in the case of " +"a new upstream version, for example by filtering the output of " +"<command>debdiff</command> with <command>filterdiff -i '*/debian/*'</" +"command>), you must understand all the changes you see and they should be " +"properly documented in the Debian changelog." +msgstr "" +"ソースパッケージを比較した場合 (新しい開発元のバージョンの場合には、例えば " +"<command>debdiff</command> の出力を <command>filterdiff -i '*/debian/*'</" +"command> などとして、開発元のファイルを除外します)、確認したすべての変更点を" +"理解して、この変更点が Debian の changelog に正しく記載されている必要があります。" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:531 +msgid "" +"If everything is fine, build the package and compare the binary packages to " +"verify that the changes on the source package have no unexpected " +"consequences (like some files dropped by mistake, missing dependencies, " +"etc.)." +msgstr "" +"何も問題がなければ、パッケージをビルドし、ソースパッケージ上の変更が期待して" +"いない結果 (ミスのためファイルがなくなっている、依存関係の欠落など) をもたらして" +"いないかを確認するため、バイナリパッケージを比較します。" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:537 msgid "" -"You are encouraged to keep tabs on the package you sponsor using <xref " -"linkend=\"pkg-tracking-system\"/>." +"You might want to check out the Package Tracking System (see <xref linkend=" +"\"pkg-tracking-system\"/>) to verify if the maintainer has not missed " +"something important. Maybe there are translations updates sitting in the BTS " +"that could have been integrated. Maybe the package has been NMUed and the " +"maintainer forgot to integrate the changes from the NMU in his package. " +"Maybe there's a release critical bug that he has left unhandled and that's " +"blocking migration to <literal>testing</literal>. Whatever. If you find " +"something that she could have done (better), it's time to tell her so that " +"she can improve for next time, and so that she has a better understanding of " +"her responsibilities." msgstr "" -"<xref linkend=\"pkg-tracking-system\"/> を使って、スポンサーしたパッケージの" -"状況を把握するのをお勧めします。" +"メンテナが何か重要なことを見逃していないかを確認する為に、パッケージ追跡シス" +"テム (PTS、<xref linkend=\"pkg-tracking-system\"/> 参照) を見るのが良いかも" +"しれません。追加が可能な翻訳の更新が BTS にあるかもしれません。パッケージが " +"NMU されていて、メンテナが NMU での変更をパッケージへ取り入れるのを忘れている" +"かもしれません。リリースクリティカルバグがあって、メンテナが放置しているために" +"<literal>テスト版 (testing)</literal> への移行が阻まれているかもしれません。" +"何でもあります。メンテナが何か (より良く) できることを見つけたら、それを伝えま" +"しょう。次回に改善ができますし、メンテナは責務についてより深く理解することに" +"なります。" + +#. type: Content of: <chapter><section><section><section><para> +#: beyond-pkging.dbk:549 +msgid "" +"If you have found no major problem, upload the new version. Otherwise ask " +"the maintainer to provide you a fixed version." +msgstr "" +"何も大きな問題を見つけなければ、新しいバージョンをアップロードします。" +"そうでなければ、メンテナに修正したバージョンをアップロードするよう要請します。" # type: Content of: <chapter><section><section><title> #. type: Content of: <chapter><section><section><title> -#: beyond-pkging.dbk:408 +#: beyond-pkging.dbk:556 msgid "Advocating new developers" msgstr "新たな開発者を支持する (advocate)" # type: Content of: <chapter><section><section><para> #. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:410 +#: beyond-pkging.dbk:558 msgid "" "See the page about <ulink url=\"&url-newmaint-advocate;\">advocating a " "prospective developer</ulink> at the Debian web site." @@ -892,13 +1206,13 @@ msgstr "" # type: Content of: <chapter><section><section><title> #. type: Content of: <chapter><section><section><title> -#: beyond-pkging.dbk:417 +#: beyond-pkging.dbk:565 msgid "Handling new maintainer applications" msgstr "新規メンテナ申請 (new maintainer applications) を取り扱う" # type: Content of: <chapter><section><section><para> #. type: Content of: <chapter><section><section><para> -#: beyond-pkging.dbk:419 +#: beyond-pkging.dbk:567 msgid "" "Please see <ulink url=\"&url-newmaint-amchecklist;\">Checklist for " "Application Managers</ulink> at the Debian web site." @@ -906,3 +1220,106 @@ msgstr "" "Debian のウェブサイトにある <ulink url=\"&url-newmaint-amchecklist;\">申請管" "理者用チェックリスト (Checklist for Application Managers)</ulink> を参照して" "ください。" + +# type: Content of: <chapter><section><section><para> +#~ msgid "" +#~ "Sponsoring merely by signing the upload or just recompiling is <emphasis " +#~ "role=\"strong\">definitely not recommended</emphasis>. You need to build " +#~ "the source package just like you would build a package of your own. " +#~ "Remember that it doesn't matter that you left the prospective developer's " +#~ "name both in the changelog and the control file, the upload can still be " +#~ "traced to you." +#~ msgstr "" +#~ "単にサインしてアップロードするや、再コンパイルするだけのスポンサー作業は" +#~ "<emphasis role=\"strong\">全く推奨されません</emphasis>。ソースパッケージ" +#~ "を自分自身がパッケージをビルドするようにビルドする必要があります。" +#~ "changelog と control ファイルに開発候補者の名前を残してあろうとも、アップ" +#~ "ロード誰がしたかは遡及できることを忘れないでください。" + +# type: Content of: <chapter><section><section><para> +#~ msgid "" +#~ "If you are an application manager for a prospective developer, you can " +#~ "also be their sponsor. That way you can also verify how the applicant is " +#~ "handling the 'Tasks and Skills' part of their application." +#~ msgstr "" +#~ "もしあなたが開発候補者の応募管理者であれば、彼らのスポンサーとなることもで" +#~ "きます。こうすることで応募者が応募作業の 'Tasks and Skills' 部分をどう取り" +#~ "扱えるかを判断できます。" + +# type: Content of: <chapter><section><section><title> +#~ msgid "Managing sponsored packages" +#~ msgstr "スポンサーされたパッケージを取り扱う" + +# type: Content of: <chapter><section><section><para> +#~ msgid "" +#~ "By uploading a sponsored package to Debian, you are certifying that the " +#~ "package meets minimum Debian standards. That implies that you must build " +#~ "and test the package on your own system before uploading." +#~ msgstr "" +#~ "スポンサーされたパッケージを Debian にアップロードすることは、Debian の標" +#~ "準について最低限は合致していることを保証することです。つまり、アップロード" +#~ "前に自分自身のシステムでパッケージをビルド、テストしなくてはいけないという" +#~ "意味です。" + +# type: Content of: <chapter><section><section><para> +#~ msgid "" +#~ "You cannot simply upload a binary <filename>.deb</filename> from the " +#~ "sponsoree. In theory, you should only ask for the diff file and the " +#~ "location of the original source tarball, and then you should download the " +#~ "source and apply the diff yourself. In practice, you may want to use the " +#~ "source package built by your sponsoree. In that case, you have to check " +#~ "that they haven't altered the upstream files in the <filename>.orig.tar." +#~ "{gz,bz2,lzma}</filename> file that they're providing." +#~ msgstr "" +#~ "あなたは、スポンサー対象者からの <filename>.deb</filename> バイナリを単に" +#~ "アップロードすることはできません。通常、diff ファイルとオリジナルのソース " +#~ "tar ファイルを要求して、それから自分でソースをダウンロードして diff を適用" +#~ "する必要があります。実際には、スポンサー対象者が生成したソースパッケージを" +#~ "使うということです。この場合、彼らが提供した <filename>.orig.tar.{gz,bz2," +#~ "lzma}</filename> ファイル中の開発元 (upstream) を改変していないことを" +#~ "チェックする必要があります。" + +# type: Content of: <chapter><section><section><para> +#~ msgid "" +#~ "Do not be afraid to write the sponsoree back and point out changes that " +#~ "need to be made. It often takes several rounds of back-and-forth email " +#~ "before the package is in acceptable shape. Being a sponsor means being a " +#~ "mentor." +#~ msgstr "" +#~ "スポンサー対象者に必要な変更点を指摘の連絡するのを恐れないでください。パッ" +#~ "ケージが受け入れ可能な形になる前に何度もメールのやりとりが起こるのはよくあ" +#~ "ることです。スポンサーになるということはメンター (mentor) になるということ" +#~ "です。" + +# type: Content of: <chapter><section><section><para> +#~ msgid "Once the package meets Debian standards, build and sign it with" +#~ msgstr "" +#~ "一旦 Debian の標準に合致するようになったら、incoming ディレクトリにアップ" +#~ "ロードする前にパッケージを以下の様にしてビルドして署名してください" + +# type: Content of: <chapter><section><section><para> +# FIXME devided articles +#~ msgid "" +#~ "before uploading it to the incoming directory. Of course, you can also " +#~ "use any part of your <replaceable>KEY-ID</replaceable>, as long as it's " +#~ "unique in your secret keyring." +#~ msgstr "" +#~ "もちろん、秘密鍵のキーリング中で唯一である限り、どの <replaceable>KEY-ID</" +#~ "replaceable> も使うことができます。" + +# type: Content of: <chapter><section><section><para> +#~ msgid "" +#~ "If you prefer to leave a more evident trace of your sponsorship job, you " +#~ "can add a line stating it in the most recent changelog entry." +#~ msgstr "" +#~ "スポンサーを行ったという状況証拠を残しておいて後から確認したいという場合" +#~ "は、最も新しい changelog のエントリにそのような記述を追加できます。" + +# type: Content of: <chapter><section><section><para> +# FIXME keep tabs? +#~ msgid "" +#~ "You are encouraged to keep tabs on the package you sponsor using <xref " +#~ "linkend=\"pkg-tracking-system\"/>." +#~ msgstr "" +#~ "<xref linkend=\"pkg-tracking-system\"/> を使って、スポンサーしたパッケージ" +#~ "の状況を把握するのをお勧めします。"