# Debian Developer's Reference (Japanese)
-# Hideki Yamane (Debian-JP) <henrich@debian.or.jp>, 2008-2011.
+# (C) Hideki Yamane <henrich@debian.org>, 2008-2011.
#
msgid ""
msgstr ""
-"Project-Id-Version: developers-reference 3.4.4\n"
-"POT-Creation-Date: 2010-06-20 09:22-0400\n"
-"PO-Revision-Date: 2011-02-28 02:27+0900\n"
-"Last-Translator: Hideki Yamane (Debian-JP) <henrich@debian.or.jp>\n"
+"Project-Id-Version: developers-reference 3.4.7\n"
+"POT-Creation-Date: 2011-10-12 09:49+0300\n"
+"PO-Revision-Date: 2011-10-16 19:27+0900\n"
+"Last-Translator: Hideki Yamane <henrich@debian.org>\n"
"Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n"
"Language: Japanese\n"
"MIME-Version: 1.0\n"
"tools, tools which help you, the Debian maintainer, create and maintain "
"excellent packages."
msgstr ""
-"Debian の品質は、<ulink url=\"&url-debian-policy;\">Debian Policy</ulink> に大"
-"きく依存しています。これは、全ての Debian パッケージが満たす必要がある基本的要求"
-"を明示的に規定している"
+"Debian の品質は、<ulink url=\"&url-debian-policy;\">Debian Policy</ulink> に"
+"大きく依存しています。これは、全ての Debian パッケージが満たす必要がある基本"
+"的要求を明示的に規定している多くの非常に優秀な人々が素晴らしいツールを作って"
+"おり、このツールがあなた、つまり Debian のメンテナが素晴らしいパッケージを作"
+"り、維持していくのを手助けしてくれます。"
# type: Content of: <chapter><para>
#. type: Content of: <chapter><para>
#: best-pkging-practices.dbk:18
+#, fuzzy
msgid ""
"This chapter provides some best practices for Debian developers. All "
"recommendations are merely that, and are not requirements or policy. These "
"are just some subjective hints, advice and pointers collected from Debian "
"developers. Feel free to pick and choose whatever works best for you."
msgstr ""
+"この章では、Debian 開発者へのベストプラクティスをいくつか提供します。すべての"
+"勧めは単なる勧めであり、要求事項やポリシーではありません。あなたにとって一番"
+"うまくいくやり方を、どうぞご自由に選んでください。"
# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><title>
"and selects the files which go into the package (directly or indirectly), "
"it's usually the file maintainers spend the most time on."
msgstr ""
+"以下の推奨事項は、<filename>debian/rules</filename> ファイルに適用されます。"
+"<filename>debian/rules</filename> は、ビルド作業を管理し、(直接にせよ、そうで"
+"ないにせよ) パッケージにどのファイルが入るかを選択します。大抵の場合、メンテ"
+"ナが最も時間を費やすファイルです。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:32
msgid "Helper scripts"
-msgstr "補助スクリプト"
+msgstr "ヘルパースクリプト"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"with bugs? Also, supposing the menu directory changed, every package would "
"have to be changed."
msgstr ""
+"<filename>debian/rules</filename> でヘルパースクリプトを使う根拠は、多くの"
+"パッケージ間でメンテナらに共通のロジックを利用・共有させるようになるからで"
+"す。メニューエントリのインストールについての問いを例にとってみましょう: ファ"
+"イルを <filename>/usr/share/menu</filename> (必要であれば、実行形式のバイナリ"
+"のメニューファイルの場合 <filename>/usr/lib/menu</filename>) に置き、メンテナ"
+"スクリプトにメニューエントリを登録・解除するためのコマンドを追加する必要があ"
+"ります。これはパッケージが行う、非常に一般的なことです。なぜ個々のメンテナが"
+"これらのすべてを自分で書き直し、時にはバグを埋め込む必要があるでしょう? ま"
+"た、メニューディレクトリが変更された場合、すべてのパッケージを変更する必要が"
+"あります。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"just need to be rebuilt with the new version of the helper and no other "
"changes."
msgstr ""
+"ヘルパースクリプトがこれらの問題を引き受けてくれます。ヘルパースクリプトの期"
+"待するやり方に従っているならば、ヘルパースクリプトはすべての詳細について考慮"
+"をします。ポリシーの変更はヘルパースクリプト中で行えます; そして、パッケージ"
+"を新しいバージョンのヘルパースクリプトでリビルドする必要があるだけです。他に"
+"何の変更も必要ありません。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"helper scripts, where useful, in conjunction with hand-crafted commands in "
"<filename>debian/rules</filename>."
msgstr ""
+"<xref linkend=\"tools\"/> には、複数の異なったヘルパーが含まれています。もっ"
+"とも一般的で (我々の意見では) ベストなヘルパーシステムは <systemitem role="
+"\"package\">debhelper</systemitem> です。<systemitem role=\"package"
+"\">debmake</systemitem> のような、以前のヘルパーシステムはモノリシックでし"
+"た: 使えそうなヘルパーの一部を取り出して選ぶことはできず、何を行うにもヘル"
+"パーを使う必要がありました。ですが、<systemitem role=\"package\">debhelper</"
+"systemitem> は、いくつもの分割された小さな <command>dh_*</command> プログラム"
+"です。たとえば、<command>dh_installman</command> は man ページをインストール"
+"して圧縮し、<command>dh_installmenu</command> は menu ファイルをインストール"
+"するなどします。つまり、<filename>debian/rules</filename> 内で使える部分では"
+"小さなヘルパースクリプトを使い、手製のコマンドを使うといった十分な柔軟性を与"
+"えてくれます。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:66
"helper, you do need to take the time to learn to use that helper, to learn "
"its expectations and behavior."
msgstr ""
+"<citerefentry> <refentrytitle>debhelper</refentrytitle> <manvolnum>1</"
+"manvolnum> </citerefentry> を読んで、パッケージに付属している例を参照すれば、"
+"<systemitem role=\"package\">debhelper</systemitem> を使い始めることができま"
+"す。 <systemitem role=\"package\">dh-make</systemitem> パッケージ (<xref "
+"linkend=\"dh-make\"/> 参照) の <command>dh_make</command> は、素のソースパッ"
+"ケージを <systemitem role=\"package\">debhelper</systemitem>化されたパッケー"
+"ジに変換するのに利用できます。ですが、この近道では個々の <command>dh_*</"
+"command> ヘルパーをわざわざ理解する必要がないので、満足できないでしょう。ヘル"
+"パースクリプトを使おうとするのであれば、そのヘルパーを使うこと、つまり前提と"
+"動作を学ぶのに時間を割く必要があります。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"examples of vanilla <filename>debian/rules</filename> files are available at "
"<ulink url=\"&url-rules-files;\"></ulink>."
msgstr ""
+"いかなるヘルパーシステムの複雑さも学ぶ必要がないので、素の <filename>debian/"
+"rules</filename> ファイルのほうが良いと考える人もいます。この判断は完全にあな"
+"た次第です。あなたに合っている方を選んでください。素の <filename>debian/"
+"rules</filename> ファイルの多くの例は <ulink url=\"&url-rules-files;\"></"
+"ulink> から入手できます。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"the total set of diffs (e.g., from <filename>.diff.gz</filename>) and work "
"out which patch sets to back out as a unit as bugs are fixed upstream."
msgstr ""
+"巨大で複雑なパッケージには、対処が必要なたくさんのバグが含まれているかもしれ"
+"ません。直接ソース中で大量のバグを修正し、あまり注意を払っていなかった場合、"
+"適用した様々なパッチを識別するのは難しいことになるでしょう。(全てではなく) 幾"
+"つか修正を取り入れた新しい開発元のバージョンへパッケージを更新する必要が出た"
+"場合、とても悲惨なことになります。(例えば、<filename>.diff.gz</filename> か"
+"ら) diff をすべて適用することもできませんし、開発元で修正されたバグごとにどの"
+"パッチをバックアウトするようにすればよいのか分かりません。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:99
"<filename>debian/patches/series</filename> are automatically applied. As "
"the name implies, patches can be managed with <command>quilt</command>."
msgstr ""
+"幸いなことに、ソースフォーマット“3.0 (quilt)”では、パッチシステムを設定するた"
+"めに <filename>debian/rules</filename> を変更することなく、パッチを分割して保"
+"持できるようになっています。パッチは <filename>debian/patches/</filename> に"
+"保持され、ソースパッケージが展開されるときに <filename>debian/patches/"
+"series</filename> に記載されているパッチが自動的に適用されます。名前が指すよ"
+"うに、パッチは <command>quilt</command> で管理することができます。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:107
"reverted in the <literal>clean</literal> rule, through a dependency on the "
"<literal>unpatch</literal> rule."
msgstr ""
+"より古いソースフォーマット“1.0”を使っている場合でも、パッチを分割することは可"
+"能ですが、専用のパッチシステムを使う必要があります: パッチファイルは Debian "
+"パッチファイル (<filename>.diff.gz</filename>) 内に組み込まれ、通常 "
+"<filename>debian/</filename> ディレクトリ内にあります。違いは、すぐに "
+"<command>dpkg-source</command> では適用されないが、<filename>debian/rules</"
+"filename> の <literal>build</literal> ルールで <literal>patch</literal> ルー"
+"ルへの依存を通じて適用されることだけです。逆に言うと、これらのパッチは "
+"<literal>unpatch</literal> ルールへの依存を通じて <literal>clean</literal> "
+"ルールで外されます。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:119
"the above, and also allows to manage patch series. See the <systemitem role="
"\"package\">quilt</systemitem> package for more information."
msgstr ""
+"<command>quilt</command> はこの作業にお勧めのツールです。上記の全てを行う上、"
+"パッチ一覧の管理も可能です。詳細な情報は <systemitem role=\"package\">quilt</"
+"systemitem> パッケージを参照してください。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:125
"the patch system integrated with <systemitem role=\"package\">cdbs</"
"systemitem>."
msgstr ""
+"他にもパッチを管理するツールはあります。<command>dpatch</command> や、パッチ"
+"システムが統合されている <systemitem role=\"package\">cdbs</systemitem> など"
+"です。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"packages instead of a big one (e.g., so the user can install only the subset "
"needed, and thus save some disk space)."
msgstr ""
+"単一のソースパッケージはしばしば複数のバイナリパッケージを生成します。それ"
+"は、同じソフトウェアで複数のフレーバーを提供することであったり (例: "
+"<systemitem role=\"package\">vim</systemitem> ソースパッケージ)、巨大なパッ"
+"ケージではなく複数の小さなパッケージを作ったりします (例: ユーザがサブセット"
+"のみをインストールできるようにして、ディスク容量を節約できます)。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:141
+#, fuzzy
msgid ""
"The second case can be easily managed in <filename>debian/rules</filename>. "
"You just need to move the appropriate files from the build directory into "
"the various packages, ensuring that you have the inter-package dependencies "
"set right in <filename>debian/control</filename>."
msgstr ""
+"二つ目の例は、<filename>debian/rules</filename> で簡単に扱うことができます。"
+"ビルドディレクトリからパッケージの一時ツリーへ、適切なファイルを移動する必要"
+"があるだけです。これは、<command>install</command> または <systemitem role="
+"\"package\">debhelper</systemitem> の <command>dh_install</command> を使って"
+"できます。パッケージ間の依存関係を <filename>debian/control</filename> 内で正"
+"しく設定したのを保証してください。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"of how to manage this using an hand-crafted <filename>debian/rules</"
"filename> file."
msgstr ""
+"最初の例は、同じソフトウェアでありながら異なった設定オプションで複数回再コン"
+"パイルする必要があるので、ちょっと難しくなります。<systemitem role=\"package"
+"\">vim</systemitem> ソースパッケージは、手作りの<filename>debian/rules</"
+"filename> ファイルを使ってどのようにこの作業を扱うか、という例です。"
# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><title>
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:164
+#, fuzzy
+# debian policy 訳と照らし合わせてみる
msgid ""
"The following practices are relevant to the <filename>debian/control</"
"filename> file. They supplement the <ulink url=\"&url-debian-policy;ch-"
"binary.html#s-descriptions\">Policy on package descriptions</ulink>."
msgstr ""
+"以下のプラクティスは、<filename>debian/control</filename> ファイルに関するものです。"
+"<ulink url=\"&url-debian-policy;ch-binary.html#s-descriptions\">"
+"パッケージ説明文についてのポリシー</ulink> を補完します。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:170
+#, fuzzy
msgid ""
"The description of the package, as defined by the corresponding field in the "
"<filename>control</filename> file, contains both the package synopsis and "
"specific to the synopsis, and <xref linkend=\"bpp-pkg-desc\"/> contains "
"guidelines specific to the description."
msgstr ""
+"パッケージの説明文は、<filename>control</filename> ファイルの対応するフィールドで"
+"定義されている様に、"
+"パッケージの"
+"とパッケージの長い説明文の両方を含んでいます。"
+"<xref linkend=\"bpp-desc-basics\"/> では、パッケージ説明文の両方の部分についての一般的なガイドラインが記述されています。"
+"それによると、<xref linkend=\"bpp-pkg-synopsis\"/> が synopsis に特化したガイドラインを提供しており、"
+"そして <xref linkend=\"bpp-pkg-desc\"/> が説明文 (description) に特化したガイドラインを含んでいます。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:181
+#, fuzzy
msgid ""
"The package description should be written for the average likely user, the "
"average person who will use and benefit from the package. For instance, "
"language. More general-purpose applications, such as editors, should be "
"written for a less technical user."
msgstr ""
+"パッケージの説明文は平均的なユーザーに向けて書く必要があります。平均的な人というのは、"
+"パッケージを使って得をする人のことです。例えば、開発用パッケージであれば開発者向けですし、"
+"彼ら向けの言葉でテクニカルに記述することができます。より汎用的なアプリケーション、例えば"
+"エディタなどであれば、あまり技術的ではないユーザ向けに書く必要があります。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:188
+#, fuzzy
msgid ""
"Our review of package descriptions lead us to conclude that most package "
"descriptions are technical, that is, are not written to make sense for non-"
"technical users. Unless your package really is only for technical users, "
"this is a problem."
msgstr ""
+"パッケージ説明文のレビューを行った結果、ほとんどがテクニカルなものであり、つまりこれは、"
+"技術に詳しくはないユーザに通じるように書かれてはいないということです。あなたのパッケージが、"
+"本当にテクニカルなユーザに対してのみではない場合、これは問題です。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"but GTK+ is probably not. Try not to assume any knowledge at all. If you "
"must use technical terms, introduce them."
msgstr ""
+"どうやって技術に詳しくはないユーザに対して書けばいいのでしょう? ジャーゴンを避けましょう。"
+"ユーザが詳しくないであろう他のアプリケーションやフレームワークへの参照を避けましょうー"
+"GNOME や KDE については、おそらくユーザはその言葉について知っているでしょうから構いません"
+"が、GTK+ はおそらくダメです。まったく知識がないと仮定してみましょう。技術用語を使わねば"
+"ならない場合は、説明しましょう。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:201
+#, fuzzy
msgid ""
"Be objective. Package descriptions are not the place for advocating your "
"package, no matter how much you love it. Remember that the reader may not "
"care about the same things you care about."
msgstr ""
+"客観的になりましょう。パッケージ説明文はあなたのパッケージの宣伝場所ではありません。"
+"あなたがそのパッケージをどんなに愛しているかは関係ありません。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"Windows, or X Window. Use GTK+, not GTK or gtk. Use GNOME, not Gnome. Use "
"PostScript, not Postscript or postscript."
msgstr ""
+"他のソフトウェアパッケージ、プロトコル名、標準規格、仕様の名前を参照する場合"
+"には、もしあれば正規名称を使いましょう。X Windows や X-Windows や X Window "
+"ではなく、X Window System あるいは X11 または X を使いましょう。GTK や gtk "
+"ではなく GTK+ を使いましょう。Gnome ではなく GNOME を使いましょう。"
+"Postscript や postscript ではなく PostScript を使いましょう。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"If you are having problems writing your description, you may wish to send it "
"along to &email-debian-l10n-english; and request feedback."
msgstr ""
+"説明文を書くことに問題があれば、&email-debian-l10n-english; へそれを送って"
+"フィードバックを求めるとよいでしょう。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:219
msgid "The package synopsis, or short description"
-msgstr ""
+msgstr "パッケージの概要、あるいは短い説明文"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:221
"Policy says the synopsis line (the short description) must be concise, not "
"repeating the package name, but also informative."
msgstr ""
+"ポリシーでは、概要行 (短い説明文) はパッケージ名を繰り返すのではなく、簡潔"
+"かつ有益なものである必要がある、となっています。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:225
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:235
+#, fuzzy
msgid ""
"Technically this is a noun phrase minus articles, as opposed to a verb "
"phrase. A good heuristic is that it should be possible to substitute the "
"package <replaceable>name</replaceable> and <replaceable>synopsis</"
"replaceable> into this formula:"
msgstr ""
+"技術的に言えば、これは名詞のフレーズから文章を差し引いた、動詞のフレーズを"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:240
"The package <replaceable>name</replaceable> provides {a,an,the,some} "
"<replaceable>synopsis</replaceable>."
msgstr ""
+"パッケージの<replaceable>名前</replaceable>は<replaceable>概要</replaceable>"
+"を提供します。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:244
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:263
+#, fuzzy
msgid ""
"The package <replaceable>name</replaceable> provides {a,an,the} "
"<replaceable>role</replaceable> for the <replaceable>suite</replaceable>."
msgstr ""
+"パッケージ<replaceable>名</replaceable>は、<replaceable>スイート</replaceable>"
+"用の<replaceable>role</replaceable> "
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"check it. Both <command>ispell</command> and <command>aspell</command> have "
"special modes for checking <filename>debian/control</filename> files:"
msgstr ""
+"スペルミスや文法の間違いを避けるよう、注意してください。スペルチェックを"
+"確実に行ってください。<command>ispell</command> と <command>aspell</command> "
+"の双方に、<filename>debian/control</filename> ファイルをチェックするための"
+"特別なモードがあります:"
#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:299
"Users usually expect these questions to be answered in the package "
"description:"
msgstr ""
+"通常、ユーザは以下のような疑問がパッケージ説明文で答えられることを期待"
+"しています:"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"What does the package do? If it is an add-on to another package, then the "
"short description of the package we are an add-on to should be put in here."
msgstr ""
+"パッケージは何をするの? 他のパッケージのアドオンだった場合、パッケージが"
+"アドオンであるということを概要文に書く必要があります。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"same (this is a mail user agent; this is cool, fast, interfaces with PGP and "
"LDAP and IMAP, has features X, Y, and Z)."
msgstr ""
+"なぜこのパッケージを使うべきなの? これは上記に関連しますが、同じではありません "
+"(これはメールユーザーエージェントです; cool で速くて、PGP や LDAP や IMAP の"
+"インターフェイスがあり、X や Y や Z の機能があります)。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"If this package should not be installed directly, but is pulled in by "
"another package, this should be mentioned."
msgstr ""
+"パッケージが直接インストールされるべきではないが、他のパッケージから引っ張られる時には、"
+"付記しておく必要があります。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:329
+#, fuzzy
msgid ""
"If the package is <literal>experimental</literal>, or there are other "
"reasons it should not be used, if there are other packages that should be "
"used instead, it should be here as well."
msgstr ""
+"パッケージが<literal>実験的</literal>である、あるいは使われない方が良い他の理由がある"
+"場合、同様にここに記載する必要があります。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"implementation? more features? different features? Why should I choose this "
"package."
msgstr ""
+"パッケージは競合のものと比べてどうでしょうか? より良い実装なのでしょうか? 機能がより豊富"
+"なのでしょうか? 違った機能があるのでしょうか? このパッケージを選ぶ理由は何でしょう。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"in <filename>debian/control</filename>. Adding this information in the "
"package description itself is considered deprecated."
msgstr ""
+"<filename>debian/control</filename> 中の <literal>Source</literal> "
+"セクションの <literal>Homepage</literal> フィールドへ、パッケージのホームページの "
+"URL を追加することをお勧めします。この情報をパッケージ説明文自身に追加するのは推奨されない "
+"(deprecated) であると考えられています。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"There are additional fields for the location of the Version Control System "
"in <filename>debian/control</filename>."
msgstr ""
+"<filename>debian/control</filename> には、バージョン管理システムの位置についての"
+"追加フィールドがあります。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
"web-browsable copy of the Version Control System repository used to maintain "
"the given package, if available."
msgstr ""
+"このフィールドの値は、指定したパッケージのメンテナンスに使われているバージョン管理システムの"
+"リポジトリのコピーがもしあれば、それを指し示す <literal>http://</literal> URL である必要"
+"があります。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"the latest work done on the package (e.g. when looking for the patch fixing "
"a bug tagged as <literal>pending</literal> in the bug tracking system)."
msgstr ""
+"この情報は、パッケージに行われた最新の作業を閲覧したいエンドユーザにとって有用であるのが"
+"目的です (例: バグ追跡システムで <literal>pending</literal> とタグがつけられているバグ"
+"を修正するパッチを探している場合)。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
"<literal>svn</literal> (Subversion). It is allowed to specify different VCS "
"fields for the same package: they will all be shown in the PTS web interface."
msgstr ""
+"このフィールドの値は、もし利用可能でなのであれば、指定されたパッケージをメンテナンスするのに"
+"使われているバージョン管理システムの位置を明確に識別できる文字列である必要があります。"
+"<literal>*</literal> はバージョン管理システムの識別に使われます; 現在では、以下のシステム"
+"がパッケージ追跡システムによってサポートされています: <literal>arch</literal>、<literal>"
+"bzr</literal> (Bazaar)、<literal>cvs</literal>、<literal>darcs</literal>、"
+"<literal>git</literal>、<literal>hg</literal> (Mercurial)、<literal>mtn</literal> "
+"(Monotone)、<literal>svn</literal> (Subversion)。同じパッケージについて異なった "
+"VCS を指定することも可能です: これらはすべて PTS のウェブインターフェイスに表示されます。"
+#FIXME-trans: 場所からロケーション、にする？
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:392
"this requirement might imply pointing to an anonymous access of the "
"repository instead of pointing to an SSH-accessible version of the same."
msgstr ""
+"この情報は、そのバージョン管理システムについて知識があり、VCS ソースから現在のバージョン"
+"パッケージを生成ユーザにとって有益であるよう意図されています。この情報の他の使い方としては、"
+"指定されたパッケージの最新の VCS バージョンを自動ビルドするなどがあるかもしれません。"
+"このため、フィールドによって指し示される場所は、バージョンに関係なく、(そのようなコンセプト"
+"をサポートしている VCS であれば) メインブランチを指すのが良いでしょう。また、指し示される"
+"場所は一般ユーザがアクセス可能である必要があります; この要求を満たすには SSH アクセス可能な"
+"リポジトリを指すのではなく、匿名アクセスが可能なリポジトリを指すようにするのを意味します。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"filename> branch. The use of the <literal>Vcs-Browser</literal> and "
"<literal>Homepage</literal> fields described above is also shown."
msgstr ""
+"以下の例では、<systemitem role=\"package\">vim</systemitem> パッケージの Subversion "
+"リポジトリに対するフィールドの例が挙げられています。(<literal>svn+ssh://</literal> "
+"ではなく) <literal>svn://</literal> スキーム中で URL がどのようになっているか、"
+"<filename>trunk/</filename> ブランチをどのように指し示しているかに注意してください。"
+"上で挙げられた <literal>Vcs-Browser</literal> フィールドと <literal>Homepage</literal> "
+"フィールドの使い方も出ています。"
# type: Content of: <chapter><section><section><section><screen>
#. type: Content of: <chapter><section><section><section><screen>
#: best-pkging-practices.dbk:412
-#, fuzzy, no-wrap
+#, no-wrap
msgid ""
" Source: vim\n"
" Section: editors\n"
" Vcs-Browser: http://svn.debian.org/wsvn/pkg-vim/trunk/packages/vim\n"
" Homepage: http://www.vim.org\n"
msgstr ""
-"\n"
" Source: vim\n"
" Section: editors\n"
" Priority: optional\n"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:429
+#, fuzzy
+# debian policy 訳と照らし合わせてみる
msgid ""
"The following practices supplement the <ulink url=\"&url-debian-policy;ch-"
"docs.html#s-changelogs\">Policy on changelog files</ulink>."
msgstr ""
+"以下のプラクティスは <ulink url=\"&url-debian-policy;ch-docs.html"
+"#s-changelogs\">changelog ファイルに対するポリシー</ulink>を補完します。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:434
msgid "Writing useful changelog entries"
-msgstr ""
+msgstr "役立つ changelog のエントリを書く"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"revision, and only them. Concentrate on describing significant and user-"
"visible changes that were made since the last version."
msgstr ""
+"パッケージリビジョンに対する changelog エントリは、そのリビジョンでの変更それだけを"
+"記載します。最後のバージョンから行われた、重要な、そしてユーザに見える形の変更を記述する"
+"ことに集中しましょう。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"people who have provided notable help in making the package (e.g., those who "
"have sent in patches)."
msgstr ""
+"<emphasis>何が</emphasis>変更されたかについて集中しましょう — 誰が、どうやって、いつ"
+"は通常あまり重要ではありません。そうは言っても、パッケージ作成について明記すべき手助け"
+"をしてくれた人々 (例えば、パッチを送ってくれた人) を丁寧に明記するのを忘れないように"
+"しましょう。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:447
+#, fuzzy
msgid ""
"There's no need to elaborate the trivial and obvious changes. You can also "
"aggregate several changes in one entry. On the other hand, don't be overly "
"are changes that affect the behaviour of the program. For further "
"explanations, use the <filename>README.Debian</filename> file."
msgstr ""
+"些細で明白な変更を詳細に書く必要はありません。複数の変更点を一つのエントリにまとめることも"
+"できます。逆に言えば、大きな変更をした場合には、あまりに簡潔にしないようにしましょう。プロ"
+"グラムの動作に影響を与える変更がある場合には、特に名確認しておきましょう。詳細な説明について"
+"は、<filename>README.Debian</filename> ファイルを使ってください。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"bugs, especially for bugs filed by users that did not strike you as "
"particularly technically savvy. Be polite, don't swear."
msgstr ""
+"平易な英語を使いましょう。そうすれば読者の大半が理解できます。バグをクローズする変更を説明"
+"する際には略語や、テクニカルな言い方やジャーゴンを避けましょう。特に、技術的に精通していない"
+"と思われるユーザによって登録されたバグをクローズする際には気をつけましょう。礼儀正しく、断言"
+"しないように。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:466
+#, fuzzy
msgid ""
"When referring to bugs, don't assume anything. Say what the problem was, "
"how it was fixed, and append the closes: #nnnnn string. See <xref linkend="
"\"upload-bugfix\"/> for more information."
msgstr ""
+"バグについての仲裁を行う際には、何も仮定しないようにしましょう。何が問題だったのか、どうやって"
+"それが直されたのかについて言い、closes: #nnnnn の文字列を追加しましょう。詳細については "
+"<xref linkend=\"upload-bugfix\"/> を参照してください。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:473
msgid "Common misconceptions about changelog entries"
-msgstr ""
+msgstr "changelog のエントリに関するよくある誤解"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:507
msgid "Common errors in changelog entries"
-msgstr ""
+msgstr "changelog のエントリ中のよくある間違い"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"The following examples demonstrate some common errors or examples of bad "
"style in changelog entries."
msgstr ""
+"以下の例で、changelog エントリ中のよくある間違いや間違ったスタイルの例を挙げ"
+"ます。"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:516
msgid "This doesn't tell readers anything too useful, obviously."
-msgstr ""
+msgstr "これは、全く読み手に何も有用なことを教えてくれません。"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:522
msgid "What was the patch about?"
-msgstr ""
+msgstr "何についてのパッチですか?"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:535
+#, fuzzy
msgid ""
"Too many acronyms, and it's not overly clear what the, uh, fsckup (oops, a "
"curse word!) was actually about, or how it was fixed."
-msgstr ""
+msgstr "略称が多すぎ、どうやって修正したのか"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
"Where's the description? If you can't think of a descriptive message, start "
"by inserting the title of each different bug."
msgstr ""
+"説明はどこ? 説明文を考えられないのなら、それぞれのバグのタイトルを入れるとこ"
+"ろから始めてください。"
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:566
+#, fuzzy
msgid "Supplementing changelogs with <filename>NEWS.Debian</filename> files"
-msgstr ""
+msgstr "<filename>NEWS.Debian</filename> ファイルで changelog を"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:568
"creation or removal of files and directories. The following instructions "
"supplement the <ulink url=\"&url-debian-policy;\">Debian Policy</ulink>."
msgstr ""
+"メンテナスクリプトには <filename>debian/postinst</filename>、<filename>"
+"debian/preinst</filename>、<filename>debian/prerm</filename>、<filename>"
+"debian/postrm</filename> ファイルが含まれます。これらのスクリプトは、単なる"
+"ファイルやディレクトリの作成や削除では扱われない、パッケージのインストール"
+"と削除のセットアップの面倒をみます。以下の説明は、<ulink url=\"&url-debian-"
+"policy;\">Debian ポリシー</ulink>を補完します。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
"sure nothing bad will happen if the script is called twice where it would "
"usually be called once."
msgstr ""
+"メンテナスクリプトは冪等でなければなりません。これは、通常は 1 回呼ばれる"
+"スクリプトが 2 回呼ばれた場合、何も悪いことが起きないのを保証する必要が"
+"あるという意味です。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
"Standard input and output may be redirected (e.g. into pipes) for logging "
"purposes, so don't rely on them being a tty."
msgstr ""
+"標準入出力はログの取得のためにリダイレクトされることがあります (例: パイプへ"
+"向けられる)。ですので、これらが tty であることに依存してはいけません。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
"in any case can only be in the <literal>configure</literal> stage of the "
"<filename>postinst</filename> script."
msgstr ""
+"質問や対話的な設定はすべて最小限に止めておく必要があります。必要になった時は、"
+"インターフェイスに <systemitem role=\"package\">debconf</systemitem> パッケージ"
+"を使いましょう。どのような場合でも、質問は <filename>postinst</filename> "
+"スクリプトの <literal>configure</literal> 段階にのみ、配置することができます。"
+#FIXME-trans: enable?
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:653
+#, fuzzy
msgid ""
"Keep the maintainer scripts as simple as possible. We suggest you use pure "
"POSIX shell scripts. Remember, if you do need any bash features, the "
"preferred to Perl, since they enable <systemitem role=\"package\">debhelper</"
"systemitem> to easily add bits to the scripts."
msgstr ""
+"メンテナスクリプトは、できる限りシンプルなものにしておきましょう。あなたが、"
+"純粋な POSIX シェルスクリプトを使っているものだとします。覚えておいてください。"
+"何かしら bash の機能が必要になったら、メンテナスクリプトは bash のシェバン行"
+"にしておく必要があります。スクリプトを少し"
+"<systemitem role=\"package\">debhelper</systemitem> "
+"Perl より、POSIX シェルあるいは Bash の方が好まれます。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
"completely gone, that is, it must remove any files created, directly or "
"indirectly, in any maintainer script."
msgstr ""
+"メンテナスクリプトを変更したら、パッケージの削除や二重インストール、purge "
+"のテストを確認してください。purge されたパッケージが完全に削除されたことを"
+"確認してください。つまり、メンテナスクリプト中で直接／間接を問わず作成された"
+"ファイルを削除する必要があるということです。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
"If you need to check for the existence of a command, you should use "
"something like"
msgstr ""
+"コマンドの存在をチェックする必要がある場合は、こんな感じで行います"
# type: Content of: <chapter><section><programlisting>
#. type: Content of: <chapter><section><programlisting>
"If you don't wish to hard-code the path of a command in your maintainer "
"script, the following POSIX-compliant shell function may help:"
msgstr ""
+"メンテナスクリプト中でコマンドの path をハードコードしたくない場合には、"
+"以下の POSIX 互換シェル機能が役立つでしょう:"
#. type: Content of: <chapter><section><para>
#: best-pkging-practices.dbk:676
"<literal>command -v</literal>, <command>type</command>, and <command>which</"
"command> are not POSIX."
msgstr ""
+"コマンド名を引数として渡すことで、<varname>$PATH</varname> の検索するのに"
+"この関数を使うことができます。コマンドが見つかった場合は true (ゼロ) を返し、"
+"そうでない場合は false を返します。<literal>command -v</literal>、<command>"
+"type</command>、<command>which</command> は POSIX に無いので、これがもっとも"
+"汎用性の高いやり方です。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
"scripts which are run before the <filename>/usr</filename> partition is "
"mounted. Most scripts won't have this problem, though."
msgstr ""
+"<command>which</command> は、Required となっている <systemitem role"
+"=\"package\">debianutils</systemitem> パッケージにあるので、別解として利用"
+"可能ですが、ルートパーティションにありません。つまり、<filename>/usr/bin"
+"</filename> にあって <filename>/bin</filename> ではないので、<filename>/usr"
+"</filename> パーティションがマウントする前に走るスクリプトの中では使えない"
+"ということです。ほとんどのスクリプトは、この問題を持つようなことはありませんが。"
# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><title>
"Configuration management with <systemitem role=\"package\">debconf</"
"systemitem>"
msgstr ""
+"<systemitem role=\"package\">debconf</systemitem> による設定管理"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:914
+#, fuzzy
msgid ""
"Put all incomplete PO files out of the way. You can check the completeness "
"by using (needs the <systemitem role=\"package\">gettext</systemitem> "
"package installed):"
msgstr ""
+""
+"以下の様にすれば達成度をチェックできます (<systemitem role=\"package\">gettext</systemitem> "
+"パッケージがインストールされている必要があります):"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:922
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:936
+#, fuzzy
msgid ""
"Run <command>debconf-updatepo</command>. This will fuzzy all strings you "
"modified in translations. You can see this by running the above again."
msgstr ""
+"<command>debconf-updatepo</command> を実行します。これは、翻訳中であなたが"
+"変更したすべての文字列を fuzzy にします。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:942
msgid "Use the following command:"
-msgstr ""
+msgstr "以下のコマンドを利用してください:"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
"Move back to <filename>debian/po</filename> the files which showed fuzzy "
"strings in the first step."
msgstr ""
+"最初の手順で fuzzy 文字列を表示していた <filename>debian/po</filename> のファイルに"
+"戻ってください。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:953
msgid "Run <command>debconf-updatepo</command> again."
-msgstr ""
+msgstr "再度 <command>debconf-updatepo</command> を実行してください。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:979
msgid "Do not use first person"
-msgstr ""
+msgstr "一人称を使わない"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:981
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:991
msgid "Be gender neutral"
-msgstr ""
+msgstr "性差に対して中立であってください"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:993
+#, fuzzy
msgid ""
"The world is made of men and women. Please use gender-neutral constructions "
"in your writing."
msgstr ""
+"世界は男と女で成り立っています。記述の際には、性差に対して中立な書き方を行ってください。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1001
msgid "Templates fields definition"
-msgstr ""
+msgstr "テンプレートのフィールド定義"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"A true/false choice. Remember: true/false, <emphasis role=\"strong\">not "
"yes/no</emphasis>..."
msgstr ""
+"true/false の選択です。注意点: true/false であって、<emphasis role=\"strong\">"
+"yes/no ではありません</emphasis>..."
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1034
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1091
msgid "text"
-msgstr ""
+msgstr "text"
# type: Content of: <chapter><section><section><section><section><para>
#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1093
msgid "This type is now considered obsolete: don't use it."
-msgstr ""
+msgstr "この種類は現状では古すぎるものと考えられています: 使わないでください。"
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1098
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1163
msgid "Choices"
-msgstr ""
+msgstr "Choices"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1165
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1172
msgid "Default"
-msgstr ""
+msgstr "Default"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1199
msgid "String/password templates"
-msgstr ""
+msgstr "String/password テンプレート"
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1220
msgid "Boolean templates"
-msgstr ""
+msgstr "Boolean テンプレート"
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1240
msgid "Select/Multiselect"
-msgstr ""
+msgstr "Select/Multiselect"
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1314
msgid "Example, taken from the geneweb package templates:"
-msgstr ""
+msgstr "geneweb パッケージのテンプレートを例にとってみましょう:"
#. type: Content of: <chapter><section><section><section><screen>
#: best-pkging-practices.dbk:1317
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1455
msgid "Packages using <command>autoconf</command>/<command>automake</command>"
-msgstr "<command>autoconf</command>/<command>automake</command> を使っているパッケージ"
+msgstr ""
+"<command>autoconf</command>/<command>automake</command> を使っているパッケー"
+"ジ"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"search .|grep transitional</command>."
msgstr ""
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1674
+msgid ""
+"Also, it is recommended to adjust its section to <literal>oldlibs</literal> "
+"and its priority to <literal>extra</literal> in order to ease "
+"<command>deborphan</command>'s job."
+msgstr ""
+
# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1676
-msgid "Best practices for <filename>.orig.tar.{gz,bz2,lzma}</filename> files"
+#: best-pkging-practices.dbk:1683
+#, fuzzy
+#| msgid ""
+#| "Best practices for <filename>.orig.tar.{gz,bz2,lzma}</filename> files"
+msgid "Best practices for <filename>.orig.tar.{gz,bz2,xz}</filename> files"
msgstr ""
"<filename>.orig.tar.{gz,bz2,lzma}</filename> についてのベストプラクティス"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1678
+#: best-pkging-practices.dbk:1685
msgid ""
"There are two kinds of original source tarballs: Pristine source and "
"repackaged upstream source."
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1682
+#: best-pkging-practices.dbk:1689
msgid "Pristine source"
msgstr ""
#. type: Content of: <chapter><section><section><section><para><footnote><para>
-#: best-pkging-practices.dbk:1686
+#: best-pkging-practices.dbk:1693
msgid ""
"We cannot prevent upstream authors from changing the tarball they distribute "
"without also incrementing the version number, so there can be no guarantee "
"emphasis> distribute. If a difference arises later (say, if upstream "
"notices that he wasn't using maximal compression in his original "
"distribution and then re-<command>gzip</command>s it), that's just too bad. "
-"Since there is no good way to upload a new <filename>.orig.tar.{gz,bz2,lzma}"
-"</filename> for the same version, there is not even any point in treating "
-"this situation as a bug."
+"Since there is no good way to upload a new <filename>.orig.tar.{gz,bz2,xz}</"
+"filename> for the same version, there is not even any point in treating this "
+"situation as a bug."
msgstr ""
#. type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1684
+#: best-pkging-practices.dbk:1691
msgid ""
"The defining characteristic of a pristine source tarball is that the "
-"<filename>.orig.tar.{gz,bz2,lzma}</filename> file is byte-for-byte identical "
+"<filename>.orig.tar.{gz,bz2,xz}</filename> file is byte-for-byte identical "
"to a tarball officially distributed by the upstream author.<placeholder type="
"\"footnote\" id=\"0\"/> This makes it possible to use checksums to easily "
"verify that all changes between Debian's version and upstream's are "
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1704
+#: best-pkging-practices.dbk:1711
msgid ""
"There is no universally accepted guidelines that upstream authors follow "
"regarding to the directory structure inside their tarball, but <command>dpkg-"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1712
+#: best-pkging-practices.dbk:1719
msgid "It unpacks the tarball in an empty temporary directory by doing"
msgstr ""
# type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
-#: best-pkging-practices.dbk:1715
+#: best-pkging-practices.dbk:1722
#, no-wrap
msgid "zcat path/to/<replaceable>packagename</replaceable>_<replaceable>upstream-version</replaceable>.orig.tar.gz | tar xf -\n"
msgstr "zcat path/to/<replaceable>パッケージ名</replaceable>_<replaceable>upstream-version</replaceable>.orig.tar.gz | tar xf -\n"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1720
+#: best-pkging-practices.dbk:1727
msgid ""
"If, after this, the temporary directory contains nothing but one directory "
"and no other files, <command>dpkg-source</command> renames that directory to "
msgstr ""
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1729
+#: best-pkging-practices.dbk:1736
msgid ""
"Otherwise, the upstream tarball must have been packaged without a common top-"
"level directory (shame on the upstream author!). In this case, "
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1740
+#: best-pkging-practices.dbk:1747
msgid "Repackaged upstream source"
msgstr "upstream のソースをパッケージしなおす"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1742
+#: best-pkging-practices.dbk:1749
msgid ""
"You <emphasis role=\"strong\">should</emphasis> upload packages with a "
"pristine source tarball if possible, but there are various reasons why it "
msgstr ""
#. type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1749
+#: best-pkging-practices.dbk:1756
msgid ""
"In these cases the developer must construct a suitable <filename>.orig.tar."
-"{gz,bz2,lzma}</filename> file himself. We refer to such a tarball as a "
+"{gz,bz2,xz}</filename> file himself. We refer to such a tarball as a "
"repackaged upstream source. Note that a repackaged upstream source is "
"different from a Debian-native package. A repackaged source still comes "
"with Debian-specific changes in a separate <filename>.diff.gz</filename> or "
-"<filename>.debian.tar.{gz,bz2,lzma}</filename> and still has a version "
-"number composed of <replaceable>upstream-version</replaceable> and "
+"<filename>.debian.tar.{gz,bz2,xz}</filename> and still has a version number "
+"composed of <replaceable>upstream-version</replaceable> and "
"<replaceable>debian-version</replaceable>."
msgstr ""
#. type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1758
+#: best-pkging-practices.dbk:1765
msgid ""
"There may be cases where it is desirable to repackage the source even though "
-"upstream distributes a <filename>.tar.{gz,bz2,lzma}</filename> that could in "
+"upstream distributes a <filename>.tar.{gz,bz2,xz}</filename> that could in "
"principle be used in its pristine form. The most obvious is if "
"<emphasis>significant</emphasis> space savings can be achieved by "
"recompressing the tar archive or by removing genuinely useless cruft from "
"defend your decision if you repackage source that could have been pristine."
msgstr ""
+# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1767
-msgid "A repackaged <filename>.orig.tar.{gz,bz2,lzma}</filename>"
+#: best-pkging-practices.dbk:1774
+#, fuzzy
+#| msgid ""
+#| "Best practices for <filename>.orig.tar.{gz,bz2,lzma}</filename> files"
+msgid "A repackaged <filename>.orig.tar.{gz,bz2,xz}</filename>"
msgstr ""
+"<filename>.orig.tar.{gz,bz2,lzma}</filename> についてのベストプラクティス"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1772
+#: best-pkging-practices.dbk:1779
msgid ""
"<emphasis role=\"strong\">should</emphasis> be documented in the resulting "
"source package. Detailed information on how the repackaged source was "
msgstr ""
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote><para>
-#: best-pkging-practices.dbk:1787
+#: best-pkging-practices.dbk:1794
msgid ""
"As a special exception, if the omission of non-free files would lead to the "
"source failing to build without assistance from the Debian diff, it might be "
msgstr ""
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1785
+#: best-pkging-practices.dbk:1792
msgid ""
"<emphasis role=\"strong\">should not</emphasis> contain any file that does "
"not come from the upstream author(s), or whose contents has been changed by "
msgstr ""
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1798
+#: best-pkging-practices.dbk:1805
msgid ""
"<emphasis role=\"strong\">should</emphasis>, except where impossible for "
"legal reasons, preserve the entire building and portablility infrastructure "
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1807
+#: best-pkging-practices.dbk:1814
msgid ""
"(<emphasis>Rationale:</emphasis> It is common for Debian users who need to "
"build software for non-Debian platforms to fetch the source from a Debian "
msgstr ""
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1814
+#: best-pkging-practices.dbk:1821
msgid ""
"<emphasis role=\"strong\">should</emphasis> use "
"<filename><replaceable>packagename</replaceable>-<replaceable>upstream-"
msgstr ""
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
-#: best-pkging-practices.dbk:1822
+#: best-pkging-practices.dbk:1829
msgid ""
"<emphasis role=\"strong\">should</emphasis> be gzipped or bzipped with "
"maximal compression."
msgstr ""
#. type: Content of: <chapter><section><section><section><title>
-#: best-pkging-practices.dbk:1829
+#: best-pkging-practices.dbk:1836
msgid "Changing binary files"
msgstr ""
#. type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:1831
+#: best-pkging-practices.dbk:1838
msgid ""
"Sometimes it is necessary to change binary files contained in the original "
"tarball, or to add binary files that are not in it. This is fully supported "
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
-#: best-pkging-practices.dbk:1846
+#: best-pkging-practices.dbk:1853
msgid "Best practices for debug packages"
msgstr ""
#. type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1848
+#: best-pkging-practices.dbk:1855
msgid ""
"A debug package is a package with a name ending in -dbg, that contains "
"additional information that <command>gdb</command> can use. Since Debian "
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1856
+#: best-pkging-practices.dbk:1863
msgid ""
"It is up to a package's maintainer whether to create a debug package or "
"not. Maintainers are encouraged to create debug packages for library "
msgstr ""
#. type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1866
+#: best-pkging-practices.dbk:1873
msgid ""
"Some debug packages may contain an entire special debugging build of a "
"library or other binary, but most of them can save space and build time by "
msgstr ""
#. type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1878
+#: best-pkging-practices.dbk:1885
msgid ""
"The debugging symbols can be extracted from an object file using "
"<command>objcopy --only-keep-debug</command>. Then the object file can be "
msgstr ""
#. type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1886
+#: best-pkging-practices.dbk:1893
msgid ""
"The <command>dh_strip</command> command in <systemitem role=\"package"
"\">debhelper</systemitem> supports creating debug packages, and can take "
msgstr ""
#. type: Content of: <chapter><section><section><para>
-#: best-pkging-practices.dbk:1893
+#: best-pkging-practices.dbk:1900
msgid ""
"Note that the debug package should depend on the package that it provides "
"debugging symbols for, and this dependency should be versioned. For example:"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
-#: best-pkging-practices.dbk:1897
+#: best-pkging-practices.dbk:1904
#, no-wrap
msgid "Depends: libfoo (= ${binary:Version})\n"
msgstr "Depends: libfoo (= ${binary:Version})\n"
+
+# type: Content of: <chapter><section><title>
+#. type: Content of: <chapter><section><section><title>
+#: best-pkging-practices.dbk:1908
+#, fuzzy
+#| msgid "Best practices for maintainer scripts"
+msgid "Best practices for meta-packages"
+msgstr "メンテナスクリプトのベストプラクティス"
+
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1910
+msgid ""
+"A meta-package is a mostly empty package that makes it easy to install a "
+"coherent set of packages that can evolve over time. It achieves this by "
+"depending on all the packages of the set. Thanks to the power of APT, the "
+"meta-package maintainer can adjust the dependencies and the user's system "
+"will automatically get the supplementary packages. The dropped packages that "
+"were automatically installed will be also be marked as removal candidates "
+"(and are even automatically removed by <command>aptitude</command>). "
+"<systemitem role=\"package\">gnome</systemitem> and <systemitem role="
+"\"package\">linux-image-amd64</systemitem> are two examples of meta-packages "
+"(built by the source packages <systemitem role=\"package\">meta-gnome2</"
+"systemitem> and <systemitem role=\"package\">linux-latest</systemitem>)."
+msgstr ""
+
+#. type: Content of: <chapter><section><section><para>
+#: best-pkging-practices.dbk:1924
+msgid ""
+"The long description of the meta-package must clearly document its purpose "
+"so that the user knows what he will lose if he removes the package. Being "
+"explicit about the consequences is recommended. This is particularly "
+"important for meta-packages which are installed during initial installation "
+"and that have not been explicitly installed by the user. Those tend to be "
+"important to ensure smooth system upgrades and the user should be "
+"discouraged from uninstalling them to avoid potential breakages."
+msgstr ""
~ianmdlvl / developers-reference.git / blobdiff