# 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: 2011-09-10 16:28-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-12-04 17:07+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"
# type: Content of: <chapter><para>
#. type: Content of: <chapter><para>
#: best-pkging-practices.dbk:9
-#, fuzzy
msgid ""
"Debian's quality is largely due to the <ulink url=\"&url-debian-policy;"
"\">Debian Policy</ulink>, which defines explicit baseline requirements which "
"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 の品質は、全ての Debian パッケージが満たす必要がある基本的要求を明示的"
+"に規定する<ulink url=\"&url-debian-policy;\">Debian ポリシー</ulink>に"
+"大きく依存しています。そして、パッケージングでの長年の経験で溜め込まれた財産で"
+"ある、Debian ポリシーを越えて共有してきた経験の積み重ねというものもあります。"
+"多くの非常に優秀な人々が素晴らしいツールを作っており、このツールがあなた、"
+"つまり Debian のメンテナが素晴らしいパッケージを作り、維持していくのを手助け"
+"してくれます。"
# type: Content of: <chapter><para>
#. type: Content of: <chapter><para>
"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 開発者へのベストプラクティスをいくつか提供します。すべての"
+"勧めは単に勧めであり、要求事項やポリシーではありません。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>
"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>
"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>
"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\"/> が概要に特化したガイドラインを提供しており、"
+"そして <xref linkend=\"bpp-pkg-desc\"/> が説明文 (description) に特化した"
+"ガイドラインを含んでいます。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"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>
"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>
"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
"initial indefinite or definite article — \"a\", \"an\", or \"the\". Thus for "
"instance:"
msgstr ""
+"概要は、完全な文章ではなくパッケージを記述するフレーズとして機能します。ですので、"
+"句読点は不適切です: 追加の大文字や最後のピリオドは不要です。また、最初の不定冠詞や"
+"定冠詞 — \"a\", \"an\", or \"the\" を削る必要があります。つまり、例えば以下のよう"
+"になります:"
#. type: Content of: <chapter><section><section><screen>
#: best-pkging-practices.dbk:231
#. 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>役割</replaceable>を提供しています。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:269
msgid "The long description"
-msgstr ""
+msgstr "長い説明文 (long description)"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"needed to let the user decide whether to install the package. Assume that "
"the user has already read the package synopsis."
msgstr ""
+"長い説明文は、ユーザーがパッケージをインストールする前に利用可能な最初の情報"
+"です。ユーザーがインストールするか否かを決めるのに必要な情報を、すべて提供する"
+"必要があります。ユーザーがパッケージの概要を既に読んでいると仮定してください。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:277
msgid "The long description should consist of full and complete sentences."
-msgstr ""
+msgstr "長い説明文は、完全な文章から成る必要があります。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"accomplish? It is important to describe this in a non-technical way, unless "
"of course the audience for the package is necessarily technical."
msgstr ""
+"長い説明文の最初の段落は、以下の質問に答えている必要があります: このパッケージは"
+"何をするの? ユーザが作業を完了するのに、どのタスクが役に立つの? ─ 技術寄り"
+"ではない書き方でこれを記述するのが重要です。もちろんパッケージの利用者が必然的に"
+"技術者ではない限り、です。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"packages in some way that is not handled by the package manager (e.g., this "
"is the client for the foo server)?"
msgstr ""
+"続く段落は以下の質問に答える必要があります: 何故私はユーザーとしてこの"
+"パッケージを必要とするの? パッケージは他にどんな機能を持っているの? 他の"
+"パッケージと比べて、どんな特別な機能や不足している部分があるがあるの? "
+"(例: X が必要な場合、代わりに Y を使いましょう) このパッケージはパッケージ"
+"マネージャーで管理していない、何らかの方法で他のパッケージに関連している? "
+"(例: これは foo サーバのクライアントです)"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"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 ""
+"なぜこのパッケージを使うべきなの? これは上記に関連しますが、同じではありません "
+"(これはメールユーザーエージェントです; クールで速く、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>
"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"
"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>
"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>
"and every last one of the changed files, especially if the change was small "
"or repetitive. You may use wildcards."
msgstr ""
+"時折、changelog エントリに変更したファイルの名前を頭に付けたくなることがあります。"
+"ですが、個々のすべての変更したファイルを一覧にする必要性はありません。特に変更点が"
+"小さくて繰り返される場合です。ワイルドカードを使いましょう。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"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>
"systems. Do, however, mention if you change the location of a configuration "
"file."
msgstr ""
+"changelog エントリは、一般的なパッケージ化の事柄 (ほら、foo.conf を探しているなら "
+"/etc/blah にあるよ) を記載するべきでは<emphasis role=\"strong\">ありません</emphasis>。"
+"何故なら、管理者やユーザは少なくとも Debian システム上でそのようなことがどのように"
+"扱われるかを多少は知らされているでしょうから。ですが、設定ファイルの場所を変更"
+"したのであれば、それは一言添えておくべきです。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:483
"actually fixed in the same package revision. Closing unrelated bugs in the "
"changelog is bad practice. See <xref linkend=\"upload-bugfix\"/>."
msgstr ""
+"changelog エントリでクローズされるバグは、実際にそのパッケージリビジョンで修正"
+"されたものだけにすべきです。changelog で関係ないバグを閉じるのは良くない習慣です。"
+"<xref linkend=\"upload-bugfix\"/> を参照してください。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"actual changes in the package. See <xref linkend=\"bug-answering\"/> for "
"more information on how to use the bug tracking system."
msgstr ""
+"changelog エントリは、バグ報告者との各種の議論の場 (foo をオプション bar "
+"付きで起動した際にはセグメンテーションフォルトは見られません; もっと詳しい"
+"情報を送ってください)、生命、宇宙、そして万物についての概要 (すいません"
+"が、このアップロードに時間がかかったので風邪をひきました)、手助けの求め ("
+"このパッケージのバグ一覧は巨大です、手を貸してください) に使うべきでは"
+"<emphasis role=\"strong\">ありません</emphasis>。そのようなことは、大抵の"
+"場合対象としている読者は気づくことが無く、パッケージで実際にあった変更点の"
+"情報について読みたい人々を悩ますことでしょう。どの様にバグ報告システムを"
+"使えばいいのかについて、詳細な情報は<xref linkend=\"bug-answering\"/>を"
+"参照してください。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"version tracking now, it is enough to keep the NMUed changelog entries and "
"just mention this fact in your own changelog entry."
msgstr ""
+"正式なメンテナによるアップロードの changelog エントリの最初で、non-maintainer "
+"upload で修正されたバグを承認するのは、古い慣習です。今はバージョン管理を行って"
+"いるので、NMU された changelog エントリを残しておいて自分の changelog エントリ中"
+"でその事実に触れるだけで十分です。"
# type: Content of: <chapter><section><section><title>
#. 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>
"Overhaul which accomplished what? Is the mention of late night supposed to "
"remind us that we shouldn't trust that code?"
msgstr ""
+"何をオーバーホールしてどうなったのですか? 深夜というのに言及しているのは、"
+"私たちにこのコードを信用するなと言いたいのですか?"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
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 "略称が多すぎます。そして、ええっと、fsckup (あぁ、ひどい言葉!) は実際"
+"何だったのか、あるいはどうやって修正したのかがまったく明らかではありません。"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
"this information; instead, use the bug tracking system. Secondly, there's "
"no explanation as to why the report is not a bug."
msgstr ""
+"まず初めに、この情報を伝えるためにパッケージをアップロードする必要は、全く"
+"ありません; 代わりにバグ追跡システムを使ってください。次に、何故この報告が"
+"バグではなかったのかについての説明がありません。"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
"well, you don't have to track bugs that they fixed ages ago in your "
"changelog)."
msgstr ""
+"何らかの理由で以前の changelog エントリ内でバグ番号について触れていなかったとしても、"
+"何も問題はありません。単にいつも通りに BTS でバグをクローズしてください。修正の記述が"
+"既にあるものと考えて、changelog ファイルに触れる必要はありません (これは、開発元の"
+"作者／メンテナによる修正にも同様に適用されます。彼らがずっと前に修正したバグを、"
+"あなたの changelog 内で追いかける必要はありません)。"
# 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
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
"<filename>README.Debian</filename>, since the user can easily miss such "
"notes."
msgstr ""
+"パッケージの変更に関する重要なニュースは <filename>NEWS.Debian</filename> ファイル"
+"にも書くことができます。このニュースは <systemitem role=\"package\">apt-listchanges"
+"</systemitem> のようなツールで、残りすべての changelog の前に表示されます。これは、"
+"ユーザにパッケージ内の著しい変更点について知らせるのに好ましいやり方です。インス"
+"トール後にユーザが一旦戻って <filename>NEWS.Debian</filename> ファイルを参照できる"
+"ので、<systemitem role=\"package\">debconf</systemitem> の notes を使うより良いです。"
+"そして、目立った変更点を <filename>README.Debian</filename> に列挙するより良いです。"
+"何故ならば、ユーザは容易にそのような注意書きを見逃すからです。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:579
"the changelog is. Here is an example of a real <filename>NEWS.Debian</"
"filename> file:"
msgstr ""
+"ファイル形式は debian changelog ファイルと同じですが、アスタリスク (*) を取って"
+"各ニュースを changelog に書くような簡潔な要約ではなく、必要に応じて完全な段落で"
+"記述してください。changelog のようにビルド中に自動的にはチェックされないので、"
+"ファイルを <literal>dpkg-parsechangelog</literal> を実行してチェックするのは良い"
+"考えです。実際の <filename>NEWS.Debian</filename> ファイルの例が、以下になります:"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
"you use <literal>debhelper</literal>, <literal>dh_installchangelogs</"
"literal> will install <filename>debian/NEWS</filename> files for you."
msgstr ""
+"<filename>NEWS.Debian</filename> ファイルは <filename>/usr/share/doc/"
+"<replaceable>package</replaceable>/NEWS.Debian.gz</filename> ファイルとして"
+"インストールされます。圧縮されていて、Debian ネイティブパッケージ中でも常に"
+"この名前です。<literal>debhelper</literal> を使う場合は、<literal>"
+"dh_installchangelogs</literal> が <filename>debian/NEWS</filename> ファイル"
+"をインストールしてくれます。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"all, there's no need to ship a <filename>NEWS.Debian</filename> file in your "
"package. No news is good news!"
msgstr ""
+"changelog ファイルと違って、毎回のリリースごとに <filename>NEWS.Debian"
+"</filename> ファイルを更新する必要はありません。何か特にユーザが知るべき"
+"目新しいことがあったときにのみ、更新してください。全くニュースがない場合、"
+"<filename>NEWS.Debian</filename> ファイルをパッケージに入れてリリースする"
+"必要はありません。便りが無いのは良い知らせ、です (No news is good news!)。"
# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><title>
"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> 段階にのみ、配置することができます。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
"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>
"be avoided in favor of <systemitem role=\"package\">debconf</systemitem> "
"interaction. This will enable non-interactive installations in the future."
msgstr ""
+"<systemitem role=\"package\">debconf</systemitem> は、(主に <filename>postinst"
+"</filename> をはじめとする) すべての様々なパッケージスクリプトが、ユーザはどの様"
+"にパッケージを設定したいのかというフィードバックを問い合わせるのに使うことが"
+"可能な設定管理システムです。直接ユーザとの対話処理は、<systemitem "
+"role=\"package\">debconf</systemitem> での処理の方を選んだので、現状では"
+"避けるべきです。これにより、将来には非対話的なインストールが可能になる予定です。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
"something that you must read if you decide to use debconf. Also, we "
"document some best practices here."
msgstr ""
+"debconf は素晴らしいツールですが、しばしば適当に扱われています。多くの共通する"
+"失敗は、<citerefentry> <refentrytitle>debconf-devel</refentrytitle> <manvolnum>7"
+"</manvolnum> </citerefentry> man ページに記載されています。これは、debconf を"
+"使うのを決めた時、あなたが読むべきものです。また、ここではベストプラクティスを"
+"記述しています。"
# type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:724
+#, fuzzy
msgid ""
"Keep usage notes to what they belong: the <filename>NEWS.Debian</filename>, "
"or <filename>README.Debian</filename> file. Only use notes for important "
"notes which may directly affect the package usability. Remember that notes "
"will always block the install until confirmed or bother the user by email."
msgstr ""
+"使い方のメモは載せるべきところへ載せましょう: <filename>NEWS.Debian</filename>、または "
+"<filename>README.Debian</filename> ファイルです。notes はパッケージのユーザビリティ"
+"に直接影響する重要な記述にだけ使いましょう。notes は確認するかメールで bother するまで、"
+"インストールを常にブロックすることを覚えておいてください。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"manvolnum> </citerefentry> for details about priorities. Most questions "
"should use medium and low priorities."
msgstr ""
+"メンテナスクリプト中の質問の優先度を注意深く選びましょう。優先度の詳細に"
+"ついては、<citerefentry> <refentrytitle>debconf-devel</refentrytitle> "
+"<manvolnum>7</manvolnum> </citerefentry> を参照してください。ほとんどの"
+"質問は優先度が medium あるいは low を使うべきです。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:738
msgid "General recommendations for authors and translators"
-msgstr ""
+msgstr "作者と翻訳者に対する雑多な推奨"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
"Most Debian package maintainers are not native English speakers. So, "
"writing properly phrased templates may not be easy for them."
msgstr ""
+"ほとんどの Debian パッケージメンテナはネイティブの英語話者ではありません。"
+"ですので、正しいフレーズのテンプレートを書くのは彼らにとっては容易ではありません。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"Please use (and abuse) &email-debian-l10n-english; mailing list. Have your "
"templates proofread."
msgstr ""
+"&email-debian-l10n-english; メーリングリストを利用してください (むしろ乱用して"
+"ください)。テンプレートを査読してもらいましょう。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:750
"Badly written templates give a poor image of your package, of your work... "
"or even of Debian itself."
msgstr ""
+"下手に書かれたテンプレートは、パッケージに対して、そしてあなたの作業に対して、"
+"さらには Debian それ自体にすら対して、悪い印象を与えます。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"them, try to explain them (use the extended description). When doing so, "
"try to balance between verbosity and simplicity."
msgstr ""
+"可能な限り技術的なジャーゴンを避けましょう。いくつかの用語があなたにとっては"
+"普通に聞こえても、他の人には理解不可能かもしれません。避けられない場合には、"
+" (説明文を使って) 解説してみましょう。その場合には、冗長さとシンプルさのバランス"
+"を取るようにしましょう。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
"<command>po-debconf</command> offers a simple framework for getting "
"templates translated by translation teams or even individuals."
msgstr ""
+"debconf テンプレートは翻訳されるでしょう。debconf、そして関連する"
+"姉妹パッケージ <command>po-debconf</command> は、テンプレートを翻訳チームやさらに"
+"は個人が翻訳できるようにする、シンプルなフレームワークを提供します。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:769
"debconf</systemitem> on your development system and read its documentation "
"(<command>man po-debconf</command> is a good start)."
msgstr ""
+"gettext ベースのテンプレートを使ってください。開発用のシステムに <systemitem "
+"role=\"package\">po-debconf</systemitem> をインストールしてドキュメントを読み"
+"ましょう (<command>man po-debconf</command> が取っ掛かりとして良いでしょう)。"
#. type: Content of: <chapter><section><section><section><para>
-#: best-pkging-practices.dbk:774
+#: best-pkging-practices.dbk:77
+#, fuzzy
msgid ""
"Avoid changing templates too often. Changing templates text induces more "
"work to translators which will get their translation fuzzied. A fuzzy "
"When changes are small enough, the original translation is kept in PO files "
"but marked as <literal>fuzzy</literal>."
msgstr ""
+"テンプレートを頻繁に変更しすぎることを避けましょう。テンプレート文の変更は翻訳を fuzzy にして、"
+"さらなる作業を翻訳作業者に強います。fuzzy になっている翻訳文は、翻訳されてから大本の文章が"
+"変更された文字列で、そのため使えるようにするには翻訳作業者による若干の更新が必要なものです。"
+"変更点が十分に小さい場合、大本の翻訳文は PO ファイル中に保持されますが <literal>fuzzy"
+"</literal> とマークされます。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:782
+#, fuzzy
msgid ""
"If you plan to do changes to your original templates, please use the "
"notification system provided with the <systemitem role=\"package\">po-"
"templates, the translator's name and e-mail addresses are mentioned in the "
"PO files headers and will be used by <command>podebconf-report-po</command>."
msgstr ""
+"大本のテンプレートを変更する予定がある場合、<systemitem role=\"package\">po-debconf"
+"</systemitem> パッケージで提供されている、<command>podebconf-report-po</command> "
+"という名の通知システムを使って翻訳作業者にコンタクトを取ってください。ほとんどのアクティブな"
+"翻訳作業者たちはとても反応が良く、変更を加えたテンプレートに対応するための作業をしてくれ、"
+"あなたが追加でアップロードする必要を減らしてくれます。gettext ベースのテンプレートを使って"
+"いる場合、翻訳作業者の名前とメールアドレスは PO ファイルのヘッダに表示されており、"
+"<command>podebconf-report-po</command> によって利用されることになります。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:794
msgid "A recommended use of that utility is:"
-msgstr ""
+msgstr "このユーティリティの使い方のお勧めの使い方:"
#. type: Content of: <chapter><section><section><section><programlisting>
#: best-pkging-practices.dbk:796
#, no-wrap
msgid "cd debian/po && podebconf-report-po --call --languageteam --withtranslators --deadline=\"+10 days\""
-msgstr ""
+msgstr "cd debian/po && podebconf-report-po --call --languageteam --withtranslators --deadline=\"+10 days\""
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:798
"Team</literal> field of each PO file) as well as the last translator "
"(mentioned in <literal>Last-translator</literal>)."
msgstr ""
+"このコマンドは、まず <filename>debian/po</filename> にある PO ファイルと POT ファイルを "
+"<filename>debian/po/POTFILES.in</filename> に記載しているテンプレートファイルを使って"
+"同期します。そして、&email-debian-i18n; メーリングリストに call for new translations "
+"(新しい翻訳作業の募集) を送信します。最後に、call for translation updates (翻訳更新作業者の"
+"募集) を (各 PO ファイルの <literal>Language-Team</literal> 欄に記載されている) 各言語"
+"チームおよび (<literal>Last-translator</literal> に記載されている) 最後の翻訳者に送信します。"
+# lower than ... 以下？未満？
+# should be kept for... は only の意味も含んでいるように思う
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:807
+#, fuzzy
msgid ""
"Giving a deadline to translators is always appreciated, so that they can "
"organize their work. Please remember that some translation teams have a "
"considered as unreasonable. A shorter delay puts too much pressure on "
"translation teams and should be kept for very minor changes."
msgstr ""
+"翻訳作業者に締切りを伝えるのは常に推奨されます。これによって、彼らは作業を調整できます。"
+"いくつかの翻訳作業チームは形式化された翻訳／レビュープロセスを持っており、10 日未満の猶予は"
+"unreasonable であると考えられています。より短い猶予期間は強すぎるプレッシャーを翻訳"
+"チームに与えるので、非常に些細な変更点に対してのみに留めるべきです。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"If in doubt, you may also contact the translation team for a given language "
"(debian-l10n-xxxxx@&lists-host;), or the &email-debian-i18n; mailing list."
msgstr ""
+"迷った場合は、該当の言語の翻訳チーム (debian-l10n-xxxxx@&lists-host;) か "
+"&email-debian-i18n; にも問い合わせましょう。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:821
msgid "Unfuzzy complete translations when correcting typos and spelling"
-msgstr ""
+msgstr "誤字やミススペルを修正する際に fuzzy を取る"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:823
"\">not</emphasis> affect translations, please be kind to translators and "
"<emphasis>unfuzzy</emphasis> their translations."
msgstr ""
+"debconf テンプレートの文章が修正されて、その変更が翻訳に<emphasis role="
+"\"strong\">影響しない</emphasis>と<emphasis role=\"strong\">確信している"
+"</emphasis>場合には、翻訳作業者を労って翻訳文を <emphasis>unfuzzy</emphasis> "
+"してください。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"If you don't do so, the whole template will not be translated as long as a "
"translator will send you an update."
msgstr ""
+"そうしないと、翻訳作業者が更新をあなたに送るまでテンプレート全体は翻訳され"
+"ていない状態になります。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:833
"in the PO files. The latter uses <command>gettext</command> utilities to "
"<emphasis>unfuzzy</emphasis> strings."
msgstr ""
+"翻訳から <emphasis>fuzzy を取り除く</emphasis>場合、2 つの方法を選ぶことができます。"
+"1 つ目のやり方は<emphasis>preventive</emphasis> 検索を行い、PO ファイル中で置換作業を"
+"行います。もう一つのやり方は、<emphasis>fuzzy 文字列を取り除く</emphasis>のに "
+"<command>gettext</command> ユーティリティを使います。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:839
+#, fuzzy
msgid "<emphasis>Preventive unfuzzy</emphasis> method:"
-msgstr ""
+msgstr "<emphasis>fuzzy の予防</emphasis> 方法:"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:844
"Try finding a complete translation file <emphasis role=\"strong\">before</"
"emphasis> the change:"
msgstr ""
+"変更<emphasis role=\"strong\">前</emphasis>に完全な翻訳ファイルを見つけるようにしてください:"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#: best-pkging-practices.dbk:847 best-pkging-practices.dbk:918
#, no-wrap
msgid "for i in debian/po/*po; do echo -n $i: ; msgfmt -o /dev/null --statistics $i; done"
-msgstr ""
+msgstr "for i in debian/po/*po; do echo -n $i: ; msgfmt -o /dev/null --statistics $i; done"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:849
"inadvertently written as <literal>tpyo</literal>. Therefore, the change is "
"<command>s/tpyo/typo</command>."
msgstr ""
+"必要な変更を認識します。この例では、文字列 <literal>typo</literal> が不注意にも "
+"<literal>tpyo</literal> として書かれている誤字の修正の変更であると仮定してみましょう。"
+"そのため、変更は <command>s/tpyo/typo</command> です。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:865
"where the original string is appropriate. This specifically applies to "
"change in punctuation, for instance."
msgstr ""
+"この変更が本当に意図した場所だけに適用されて、元々の文字列が適切な他の場所には<emphasis "
+"role=\"strong\">適用されない</emphasis> ことを確認しましょう。例えば、これは特に句読点"
+"の変更に当てはまります。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:873
"is recommended over any text editor to guarantee that the files encoding "
"will not be broken by the edit action:"
msgstr ""
+"すべての PO ファイルを <command>sed</command> を使って変更してください。編集作業によって"
+"ファイルのエンコーディングがこわされないことを保証するため、どのテキストエディタよりも"
+"このコマンドの利用を推奨します。"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:884
msgid "Change the debconf template file to fix the typo."
-msgstr ""
+msgstr "debconf テンプレートファイルを誤字修正のために変更する。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:889
"Check the <filename>foo.po</filename> reference file. Its statistics should "
"not be changed:"
msgstr ""
+"<filename>foo.po</filename> 参照ファイルをチェックする。統計は変化がないはずです:"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><programlisting>
#: best-pkging-practices.dbk:898
"If the file's statistics changed, you did something wrong. Try again or ask "
"for help on the &email-debian-i18n; mailing list."
msgstr ""
+"ファイルの統計が変化していた場合、何かしら間違ったことをやっています。再度やってみるか、"
+"&email-debian-i18n; メーリングリストで助けを求めましょう。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:909
"by using (needs the <systemitem role=\"package\">gettext</systemitem> "
"package installed):"
msgstr ""
+"不完全な PO ファイルすべてをどけておきましょう。以下の様にすれば達成度をチェック"
+"できます (<systemitem role=\"package\">gettext</systemitem> パッケージがインストール"
+"されている必要があります):"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:922
"Files which report no fuzzy strings (only translated and untranslated) will "
"be kept in place."
msgstr ""
+"fuzzy 文字列を報告してきたすべてのファイルを一時的な場所へ移動しましょう。"
+"何も fuzzy 文字列を報告しないファイル (翻訳済と未訳のみ) はそこに置いたままにしておきます。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:929
+#, fuzzy
msgid ""
"Now <emphasis role=\"strong\">and now only</emphasis>, modify the template "
"for the typos and check again that translation are not impacted (typos, "
"spelling errors, sometimes typographical corrections are usually OK)."
msgstr ""
+"now <emphasis role=\"strong\">and now only</emphasis>、誤字の修正のために"
+"テンプレートに手を入れて翻訳が影響を受けていないことを再確認しましょう (誤字、スペルミス、時には"
+"文言の修正なども大抵は OK です)。"
#. 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 にします。上記を再度実行すれば、You can see this by running the above again."
#. 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>
#: best-pkging-practices.dbk:960
msgid "Do not make assumptions about interfaces"
-msgstr ""
+msgstr "インターフェイスについて仮定をしない"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:962
"emphasis> have no meaning for users of graphical interfaces which use "
"checkboxes for boolean questions."
msgstr ""
+"テンプレートのテキストは、debconf のインターフェイスに属するウィジェットには"
+"言及してはいけません。<emphasis>「はい」と答えた場合には...</emphasis> "
+"のような文章は、2 択の質問に対してチェックボックスを使うようなグラフィカルインター"
+"フェイスのユーザには何の意味もありません。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:973
+#, fuzzy
msgid ""
"More generally speaking, try to avoid referring to user actions. Just give "
"facts."
msgstr ""
+"より一般的に言うと、ユーザの行動を参照するのを避けるようにしましょう。単に事実を与えましょう。"
# 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 "一人称を使わない"
+# speak for
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:981
msgid ""
"<emphasis>Enable this if ...</emphasis> instead of <emphasis>This can be "
"enabled if...</emphasis>."
msgstr ""
+"(<emphasis>I will do this...</emphasis> や <emphasis>We recommend..."
+"</emphasis> などの) 一人称の利用を避けましょう。コンピュータは人ではなく、debconf "
+"テンプレートは Debian 開発者を代弁するものではありません。中立的な解釈を行いましょう。"
+"あなたが科学論文を書いたことがあるならば、論文を書くのと同様にテンプレートを書きましょう。"
+"ですが、可能であれば <emphasis>This can be enabled if...</emphasis> ではなく "
+"<emphasis>Enable this if ...</emphasis> などとして生の声を届けるようにしましょう。"
# type: Content of: <chapter><section><section><section><title>
#. 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>
"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>
"<citerefentry> <refentrytitle>debconf-devel</refentrytitle> <manvolnum>7</"
"manvolnum> </citerefentry> manual page."
msgstr ""
+"この章の情報は、ほとんどを <citerefentry> <refentrytitle>debconf-devel</refentrytitle> "
+"<manvolnum>7</manvolnum> </citerefentry> マニュアルページから得ています。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
"password the user enters will be written to debconf's database. You should "
"probably clean that value out of the database as soon as is possible."
msgstr ""
+"ユーザにパスワードの入力を求めます。これを使う場合は注意して使ってください: ユーザが入力した"
+"パスワードは debconf のデータベースに書き込まれることに注意してください。おそらく、この値を"
+"データベースから可能な限り早く消す必要があります。"
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1026
"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
"in a field named 'Choices'. Separate the possible values with commas and "
"spaces, like this: <literal>Choices: yes, no, maybe</literal>."
msgstr ""
+"複数の値から一つを選びます。選択するものは 'Choices' というフィールド名で"
+"指定されている必要があります。利用可能な値をコンマとスペースで区切ってください。"
+"以下のようになります: <literal>Choices: yes, no, maybe</literal>"
#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1041
"translatable by using <literal>__Choices</literal>. The double underscore "
"will split out each choice in a separate string."
msgstr ""
+"選択肢が翻訳可能な文字列である場合、'Choices' フィールドは <literal>__Choices</literal> "
+"を使って翻訳可能であることを示しておくと良いでしょう。2つのアンダースコアは、各選択肢を"
+"分かれた文字列に分割してくれます。"
#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1046
"possibilities to only mark <emphasis role=\"strong\">some</emphasis> choices "
"as translatable. Example:"
msgstr ""
+"<command>po-debconf</command> システムは、翻訳可能な<emphasis role=\"strong\">"
+"いくつかの<emphasis role=\"strong\">選択肢のみをマークする面白い機能を提供してくれます。"
+"例:"
#. type: Content of: <chapter><section><section><section><section><programlisting>
#: best-pkging-practices.dbk:1051
"acronyms that should not be translated. The above allows only 'Other' to be "
"included in PO and POT files."
msgstr ""
+"この例では、他は頭文字から構成されていて翻訳できませんが、'Other' 文字列だけは翻訳可能です。"
+"上記では 'Other' だけが PO および POT ファイルに含めることができます。"
#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1064
"<citerefentry> <refentrytitle>po-debconf</refentrytitle> <manvolnum>7</"
"manvolnum> </citerefentry> manual page lists all these possibilities."
msgstr ""
+"debconf テンプレートのフラグシステムは、この様な機能をたくさん提供します。"
+"<citerefentry> <refentrytitle>po-debconf</refentrytitle> <manvolnum>7</"
+"manvolnum> </citerefentry> マニュアルページでは、これらの利用可能な機能をすべて"
+"列挙しています。"
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1072
"Like the select data type, except the user can choose any number of items "
"from the choices list (or chose none of them)."
msgstr ""
+"select データ型とそっくりですが、ユーザが選択肢一覧からいくつでも項目を選べる "
+"(あるいはどれも選ばないこともできる) 点だけが違います。"
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1080
msgid "note"
-msgstr ""
+msgstr "note"
# type: Content of: <chapter><section><section><section><section><para>
#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1082
+#, fuzzy
msgid ""
"Rather than being a question per se, this datatype indicates a note that can "
"be displayed to the user. It should be used only for important notes that "
"sure the user sees it; halting the install for them to press a key, and even "
"mailing the note to them in some cases."
msgstr ""
+"本来質問ではありませんが、このデータ型が示すのはユーザに表示することができるメモです。"
+"debconf はユーザが必ず見るようにするために、キーを押すためにインストールを休止したり、"
+"いくつかの例では記述をメールさえするなどの多大な苦痛を与えることになるので、ユーザが"
+"知っておく必要がある重要な記述にのみ使うべきです。"
#. 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 は現状では古すぎるものと考えられています: 使わないでください。"
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1098
"note type. Frontends may present it differently (for instance, the dialog "
"frontend of cdebconf draws a red screen instead of the usual blue one)."
msgstr ""
+"この type はエラーメッセージを取り扱うためにデザインされています。ほとんど "
+"note type と似通っています。違いはフロントエンドが存在しているであろうことです "
+"(例えば、cdebconf の dialog フロントエンドは通常の青い画面ではなく、赤い画面を"
+"描画します)。"
# type: Content of: <chapter><section><section><section><section><para>
#. type: Content of: <chapter><section><section><section><section><para>
#: best-pkging-practices.dbk:1105
+#, fuzzy
msgid ""
"It is recommended to use this type for any message that needs user attention "
"for a correction of any kind."
msgstr ""
+"何かを補正するためにユーザの注意を引く必要があるメッセージにこの type を使うのがお勧めです。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1113
+#, fuzzy
msgid "Description: short and extended description"
-msgstr ""
+msgstr "Description: short および extended 説明文"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1115
+#, fuzzy
msgid ""
"Template descriptions have two parts: short and extended. The short "
"description is in the Description: line of the template."
msgstr ""
+"テンプレート説明文は 2 つのパートに分かれます: short と extended です。短い説明文 "
+"(short description) はテンプレートの Description: 行にあります。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"translators, as usually translations tend to end up being longer than the "
"original."
msgstr ""
+"短い説明文は、ほとんどの debconf インターフェイスに適用するように、"
+"短く (50 文字程度に) しておく必要があります。通常、翻訳はオリジナルよりも長くなる傾向にあるので、"
+"短くすることは翻訳作業者を助けます。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1131
+#, fuzzy
msgid ""
"The short description does not necessarily have to be a full sentence. This "
"is part of the keep it short and efficient recommendation."
msgstr ""
+"短い説明文は完全な文章である必要はありません。これは文章を短くしておき、効率的に推奨を行うためです。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"extended description is important. If after all that you still can't come "
"up with anything, leave it blank."
msgstr ""
+"拡張された説明文 (extended description) は、短い説明文を一語一句繰り返しをしてはなりません。"
+"長い説明文章を思いつかなければ、まず、もっと考えてください。debian-devel に投稿しましょう。"
+"助けを求めましょう。文章の書き方講座を受講しましょう! この拡張された説明文は重要です。もし、"
+"まったく何も思いつかなければ、空のままにしておきましょう。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1142
+#, fuzzy
msgid ""
"The extended description should use complete sentences. Paragraphs should "
"be kept short for improved readability. Do not mix two ideas in the same "
"paragraph but rather use another paragraph."
msgstr ""
+"extended な説明文は完全な文章である必要があります。段落を短くしておくのは可読性を高めます。"
+"同じ段落で 2 つの考えを混ぜてはいけません。代わりに別の段落を書きます。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"classical dialog interface, people will need to scroll, and lot of people "
"just don't do that."
msgstr ""
+"あまり冗長にしないようにしてください。ユーザは長すぎる画面を無視しようとします。経験からすると、"
+"20 行が越えてはならない境界です。何故ならば、クラシックなダイアログインターフェイスでは、"
+"スクロールする必要がでてくることになり、そして多くの人がスクロールなどしないからです。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1153
+#, fuzzy
msgid ""
"The extended description should <emphasis role=\"strong\">never</emphasis> "
"include a question."
msgstr ""
+"extended な説明文は質問を含めては、<emphasis role=\"strong\">決していけません</emphasis>。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"For specific rules depending on templates type (string, boolean, etc.), "
"please read below."
msgstr ""
+"テンプレートの type (string、boolean など) に応じた特別なルールについては、以下を読んで"
+"ください。"
# type: Content of: <chapter><section><section><section><title>
#. 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><title>
#: best-pkging-practices.dbk:1183
msgid "Templates fields specific style guide"
-msgstr ""
+msgstr "テンプレートのフィールド固有スタイルガイド"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1185
msgid "Type field"
-msgstr ""
+msgstr "Type フィールド"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1193
msgid "Description field"
-msgstr ""
+msgstr "Description フィールド"
# 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><section><title>
#. type: Content of: <chapter><section><section><section><section><title>
#: best-pkging-practices.dbk:1262
+#, fuzzy
msgid "Notes"
-msgstr ""
+msgstr "Note"
#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1266
+#, fuzzy
msgid ""
"The short description should be considered to be a <emphasis role=\"strong"
"\">title</emphasis>."
msgstr ""
+"short 説明文は<emphasis role=\"strong\">title</emphasis>として扱われます。"
# type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1271
+#, fuzzy
msgid ""
"The extended description is what will be displayed as a more detailed "
"explanation of the note. Phrases, no terse writing style."
msgstr ""
+"extended 説明文は、note のより詳細な説明を表示します。フレーズで、簡潔過ぎない書き方です。"
#. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para>
#: best-pkging-practices.dbk:1277
+#, fuzzy
msgid ""
"<emphasis role=\"strong\">Do not abuse debconf.</emphasis> Notes are the "
"most common way to abuse debconf. As written in debconf-devel manual page: "
"Debian</filename> or <filename>README.Debian</filename>, plus consider "
"keeping existing translations for the future."
msgstr ""
+"<emphasis role=\"strong\">debconf を乱用しないでください。</emphasis> note は、"
+"debconf の乱用で最も良く使われるやり方です。debconf-devel マニュアルページに書かれています: "
+"とても深刻な問題について警告する場合のみに使うのがベストです。多くのメモについては、"
+"<filename>NEWS.Debian</filename> ファイルや <filename>README.Debian</filename> "
+"ファイルが適切な場所です。もし、これを読んで、Note 型のテンプレートを <filename>NEWS."
+"Debian</filename> あるいは <filename>README.Debian</filename> 中のエントリに"
+"変換することを考えた場合、既存の翻訳も保持することを考えに足してください。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1292
msgid "Choices field"
-msgstr ""
+msgstr "Choices フィールド"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"__Choices trick. This will split each individual choice into a single "
"string, which will considerably help translators for doing their work."
msgstr ""
+"もし Choise が頻繁に変わるようであれば、__Choices という使い方をするのを検討して"
+"ください。これは個々の選択項目を単一の文字列に分割するので、翻訳作業者が作業を行う"
+"のを助けてくれると考えられています。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1301 best-pkging-practices.dbk:1339
msgid "Default field"
-msgstr ""
+msgstr "Default フィールド"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1303
"the user language (for instance, if the choice is a language choice), please "
"use the _Default trick."
msgstr ""
+"select のテンプレートで、デフォルト値がユーザの言語に応じて変化するようであれば、"
+"_Default という使い方をしてください (例えば、選択肢が言語の選択の場合等) 。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1308
"their language is used while your own mentioned Default Choice will be used "
"when using English."
msgstr ""
+"この特別なフィールドによって、翻訳作業者は言語に応じたもっとも適切な選択肢を挿入することができる"
+"ようになります。彼らの言語が選択された場合にデフォルトの選択になりますが、英語を使うときには"
+"最初に提示された Default Choice が使われます。"
# type: Content of: <chapter><section><section><section><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
#, no-wrap
+#, fuzzy
msgid ""
"Template: geneweb/lang\n"
"Type: select\n"
"Also note the use of comments which will show up in files the translators "
"will work with."
msgstr ""
+"ブラケットを使うとdebconf のフィールド中に内部コメントができることに注意してください。"
+"コメントの利用は、翻訳作業者が作業するファイルに表示されるのにも注意ください。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1333
"The comments are needed as the _Default trick is a bit confusing: the "
"translators may put their own choice"
msgstr ""
+"_Default を使うやり方は、若干混乱するのでコメントが必要です: 翻訳者は自身の選択肢を書きます。"
# type: Content of: <chapter><section><section><section><para>
#. type: Content of: <chapter><section><section><section><para>
"Do NOT use empty default field. If you don't want to use default values, do "
"not use Default at all."
msgstr ""
+"空のデフォルトフィールドを使っては「いけません」。デフォルト値を設定したくないのであれば、Default "
+"は使うべきではありません。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1345
"see <xref linkend=\"s6.5.2.2\"/>), consider making this field translatable, "
"if you think it may be translated."
msgstr ""
+"po-debconf を使うのであれば (そして <emphasis role=\"strong\">使うべき</emphasis> です、"
+"<xref linkend=\"s6.5.2.2\"/> 参照)、このフィールドが翻訳できるのであれば、翻訳可能な状態"
+"にするのを検討しましょう。"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1350
"_Default type documented in <citerefentry> <refentrytitle>po-debconf</"
"refentrytitle> <manvolnum>7</manvolnum> </citerefentry>."
msgstr ""
+"(例えば言語選択のデフォルト値など) デフォルト値が言語／地域に応じて変化するようであれば 、"
+"<citerefentry> <refentrytitle>po-debconf</refentrytitle> <manvolnum>7"
+"</manvolnum> </citerefentry> に記載されている特別な _Default 型を使うことを考えましょう。"
# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:1364
msgid ""
"This section contains global information for developers to make translators' "
-"life easier. More information for translators and developers interrested in "
+"life easier. More information for translators and developers interested in "
"internationalization are available in the <ulink url=\"&url-i18n-l10n;"
"\">Internationalisation and localisation in Debian</ulink> documentation."
msgstr ""
+"この章では、開発者に対して、翻訳作業者の作業がより楽になるようにするための大まかな情報を含めて"
+"います。国際化について興味を持っている翻訳作業者と開発者への詳細な情報は、<ulink url="
+"\"&url-i18n-l10n;\">Internationalisation and localisation in Debian</ulink> "
+"で入手できます。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"for translators."
msgstr ""
+#FIXME: source control sysytem -> source control management system (SCM)?
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1412
+#, fuzzy
msgid ""
"If you maintain documentation of any size, it is easier for translators if "
"they have access to a source control system. That lets translators see the "
"file, the revision of the original file the translation is based on. You "
"might wish to adapt and provide that in your VCS area."
msgstr ""
+"どのようなサイズであれドキュメントをメンテナンスしている場合、翻訳作業者がソース"
+"コントロールシステムにアクセスできるのであれば、彼らの作業が楽になるでしょう。翻訳作業者が、"
+"ドキュメントの 2 つのバージョン間の違いを見ることができるので、例えば、何を再翻訳すれば"
+"いいのかがわかるようになります。翻訳されたドキュメントは、翻訳作業がどのソースコントロール"
+"リビジョンをベースにしているのかという記録を保持しておくことをお勧めします。<systemitem "
+"role=\"package\">debian-installer</systemitem> パッケージ中の <ulink url="
+"\"&url-i18n-doc-check;\">doc-check</ulink> では興味深いシステムが提供されて"
+"おり、これは指定されたあらゆる言語の翻訳状況の概要を表示し、翻訳すべき現在のリビジョンの"
+"ファイルへのusing structured commentsを、、"
+"そして翻訳されたファイルについては、翻訳がベースにしたオリジナルのファイルのリビジョンを"
+"表示します。あなたは VCS 領域でこれを導入して利用した方が良いでしょう。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1426
+#, fuzzy
msgid ""
"If you maintain XML or SGML documentation, we suggest that you isolate any "
"language-independent information and define those as entities in a separate "
"file which is included by all the different translations. This makes it "
"much easier, for instance, to keep URLs up to date across multiple files."
msgstr ""
+"XML あるいは SGML のドキュメントをメンテナンスしているのであれば、言語非依存の情報を isolate "
+"し、それらをすべての異なった翻訳に含まれる分割されたファイルにエンティティとして定義した方"
+"が良いでしょう。これは、URL を複数のファイル間で最新に保つなど、作業をより楽にしてくれます。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1432
"format quite common to translators, which permits to see what needs to be "
"retranslated when the translated document is updated."
msgstr ""
+"いくつかのツール (例: <systemitem role=\"package\">po4a</systemitem>、<systemitem "
+"role=\"package\">poxml</systemitem>、<systemitem role=\"package\">translate-"
+"toolkit</systemitem>) は異なった形式から翻訳可能な素材を展開するのに特化しています。"
+"これらは、翻訳作業者には極めて馴染み深い形式である PO ファイルを生成します。これによって、"
+"翻訳したドキュメントが更新された際に何を再翻訳すればよいのかを見ることを可能にしてくれます。"
# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><title>
#: best-pkging-practices.dbk:1444
msgid "Common packaging situations"
-msgstr ""
+msgstr "パッケージ化に於ける一般的なシチュエーション"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"You're strongly encouraged to read this file and to follow the given "
"recommendations."
msgstr ""
+"<command>autoconf</command> の <filename>config.sub</filename> および "
+"<filename>config.guess</filename> を最新に保ちつづけるのは、移植作業者、"
+"特により移行中の状況であるアーキテクチャの移植作業者にとって非常に重要です。"
+"<command>autoconf</command> や <command>automake</command> を使うあらゆる"
+"パッケージについてのとても素晴らしいパッケージ化における教訓が <systemitem "
+"role=\"package\">autotools-dev</systemitem> パッケージの &file-bpp-autotools; "
+"にまとめられています。このファイルを読んで書かれている推奨に従うことを"
+"強くお勧めします。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"are as simple as possible when a new upstream version comes out. Breakage "
"in a library can result in dozens of dependent packages breaking."
msgstr ""
+"ライブラリは様々な理由から常にパッケージにするのが難しいです。ポリシーは、"
+"メンテナンスに楽にし、新しいバージョンが開発元から出た際にアップグレードを"
+"可能な限りシンプルであることを確保するため、多くの制約を課しています。"
+"ライブラリでの破損は、依存している何十ものパッケージの破損を招き得ます。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"Good practices for library packaging have been grouped in <ulink url=\"&url-"
"libpkg-guide;\">the library packaging guide</ulink>."
msgstr ""
+"ライブラリのパッケージ化の良い作法が <ulink url=\"&url-libpkg-guide;\">"
+"the library packaging guide</ulink> にまとめられています。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"Be sure to follow the <ulink url=\"&url-debian-policy;ch-docs.html\">Policy "
"on documentation</ulink>."
msgstr ""
+"<ulink url=\"&url-debian-policy;ch-docs.html\">ドキュメント化のポリシー"
+"</ulink>に忘れず従ってください。"
+# ship は「出荷」の意味だが、Debian の場合は製品ではないので「リリース」とした
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1491
"you not ship the XML or SGML source in the binary package(s). If users want "
"the source of the documentation, they should retrieve the source package."
msgstr ""
+"あなたのパッケージが XML や SGML から生成されるドキュメントを含んでいる場合、"
+"XML や SGML のソースをバイナリパッケージに含めてリリースしないことをお勧めします。"
+"ユーザがドキュメントのソースを欲しい場合には、ソースパッケージを引っ張ってくれば"
+"良いのです。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"generally not appropriate to ship plain text versions of documentation whose "
"source format is HTML."
msgstr ""
+"ポリシーではドキュメントは HTML 形式でリリースされるべきであると定めています。"
+"我々は、もし手がかからないで問題ない品質の出力が可能であれば、ドキュメントを "
+"PDF 形式とテキスト形式でもリリースすることをお勧めしています。ですが、ソースの"
+"形式が HTML のドキュメントを普通のテキスト版でリリースするのは、大抵の場合は適切"
+"ではありません。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"\"package\">doc-base</systemitem> on installation. See the <systemitem role="
"\"package\">doc-base</systemitem> package documentation for more information."
msgstr ""
+"リリースされたメジャーなマニュアルは、インストール時に<systemitem role="
+"\"package\">doc-base</systemitem>で登録されるべきです。詳細については、"
+"<systemitem role=\"package\">doc-base</systemitem> パッケージのドキュメントを"
+"参照してください。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1509
"manual pages, consider writing them for inclusion in your package, and "
"submitting them upstream."
msgstr ""
+"Debian ポリシー (12.1 章) では、マニュアルページはすべてのプログラム・"
+"ユーティリティ・関数に対して付属すべきであり、設定ファイルのようなその他の"
+"ものについては付属を提案を示しています。もし、あなたがパッケージングを"
+"しているものがそのようなマニュアルページを持っていない場合は、パッケージ"
+"に含めるために記述を行い、開発元 (upstream) へ送付することを検討してください。"
+#FIXME-Trans: to a lesser extent の訳。
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1516
msgid ""
"<command>rst2man</command> respectively. To a lesser extent, the "
"<command>help2man</command> program can also be used to write a stub."
msgstr ""
+"manpage は直接 troff 形式で書く必要はありません。よく使われるソース形式は、"
+"Docbook、POD、reST で、それぞれ <command>xsltproc</command>、<command>pod2man"
+"</command>、<command>rst2man</command> を使うことで変換できます。少なくとも、"
+"スタブを書くために <command>help2man</command> プログラムを使うことは可能です。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1525
msgid "Specific types of packages"
-msgstr ""
+msgstr "特定の種類のパッケージ"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"Several specific types of packages have special sub-policies and "
"corresponding packaging rules and practices:"
msgstr ""
+"いくつかの特定の種類のパッケージは、特別なサブポリシーと対応する"
+"パッケージ化ルールおよびプラクティスを持っています:"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"\"package\">libdbd-pg-perl</systemitem> (binary perl module) or <systemitem "
"role=\"package\">libmldbm-perl</systemitem> (arch independent perl module)."
msgstr ""
+"Perl 関連パッケージは、<ulink url=\"&url-perl-policy;\">Perl ポリシー</"
+"ulink> があり、このポリシーに従っているパッケージの例が <systemitem role="
+"\"package\">libdbd-pg-perl</systemitem> (バイナリ perl モジュール) または "
+"<systemitem role=\"package\">libmldbm-perl</systemitem> (アーキテクチャ非依存 "
+"perl モジュール) です。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"Python related packages have their python policy; see &file-python-policy; "
"in the <systemitem role=\"package\">python</systemitem> package."
msgstr ""
+"Python 関連パッケージは、python ポリシーを持っています; <systemitem "
+"role=\"package\">python</systemitem> パッケージ中の &file-python-policy; "
+"を参照してください。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"Emacs related packages have the <ulink url=\"&url-emacs-policy;\">emacs "
"policy</ulink>."
msgstr ""
+"Emacs 関連パッケージには、<ulink url=\"&url-emacs-policy;\">emacs ポリシー</ulink>"
+"があります。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"Java related packages have their <ulink url=\"&url-java-policy;\">java "
"policy</ulink>."
msgstr ""
+"Java 関連パッケージには、<ulink url=\"&url-java-policy;\">java ポリシー</ulink>"
+"があります。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"example is the <systemitem role=\"package\">camlzip</systemitem> source "
"package."
msgstr ""
+"Ocaml 関連パッケージは、固有のポリシーを持っており、<systemitem role="
+"\"package\">ocaml</systemitem> パッケージの &file-ocaml-policy; でみることが"
+"できます。良い例は <systemitem role=\"package\">camlzip</systemitem> ソース"
+"パッケージです。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"Packages providing XML or SGML DTDs should conform to the recommendations "
"found in the <systemitem role=\"package\">sgml-base-doc</systemitem> package."
msgstr ""
+"XML や SGML DTD を提供しているパッケージは、<systemitem role=\"package\">"
+"sgml-base-doc</systemitem> パッケージ中の推奨に従わねばなりません。"
# type: Content of: <chapter><section><section><itemizedlist><listitem><para>
#. type: Content of: <chapter><section><section><itemizedlist><listitem><para>
"\">common-lisp-controller</systemitem>, about which see &file-lisp-"
"controller;."
msgstr ""
+"lisp パッケージは、パッケージ自身を <systemitem role=\"package\">"
+"common-lisp-controller</systemitem> に登録する必要があります。これについては、"
+"&file-lisp-controller; を参照してください。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
"negligible compared to the size of the rest of the package, it's probably "
"best to keep it all in a single package."
msgstr ""
+"大量のアーキテクチャ非依存データがプログラムと共にパッケージ化されるのは、良くあることでは"
+"ありません。例えば、音声ファイル、アイコン集、様々な模様の壁紙、その他一般的な画像ファイルです。"
+"このデータのサイズがパッケージの残りのサイズと比較して取るに足らないのであれば、おそらくは"
+"単一パッケージでひとまとめにしておくのがベストでしょう。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1616
"data also reduces processing time of <command>lintian</command> (see <xref "
"linkend=\"tools-lint\"/>) when run over the entire Debian archive."
msgstr ""
+"しかし、データのサイズが考えた方が良い程であれば、分かれたアーキテクチャ非依存パッケージ "
+"(<filename>_all.deb</filename>) に分割するのを考えてください。これによって、"
+"11 あるいはそれ以上の .deb ファイルについて、1アーキテクチャごとに同じデータの不必要な重複"
+"を避けられます。これは <filename>Packages</filename> ファイルに更なるオーバーヘッド"
+"を追加しますが、Debian ミラーサーバ上で多くのディスク容量を節約します。アーキテクチャ非依存"
+"のデータを分割することは、Debian アーカイブ全体に対して実行される <command>lintian"
+"</command> の処理時間の削減にもつながります (<xref linkend=\"tools-lint\"/> 参照)。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1628
msgid "Needing a certain locale during build"
-msgstr ""
+msgstr "ビルド中に特定のロケールが必要"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"If you need a certain locale during build, you can create a temporary file "
"via this trick:"
msgstr ""
+"ビルド中に特定のロケールを必要とする場合、こんな技を使えば一時ファイルを"
+"作成できます:"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"locale you generate, you should get what you want without being root. "
"Something like this:"
msgstr ""
+"<varname>LOCPATH</varname> を <filename>/usr/lib/locale</filename> と同等の"
+"ものに、そして <varname>LC_ALL</varname> を生成したロケールの名前に設定すれば、"
+"root にならなくても欲しいものが手に入ります。こんな感じです:"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1652
msgid "Make transition packages deborphan compliant"
-msgstr ""
+msgstr "移行パッケージを deboprhan に適合するようにする"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"upgrade but which can now safely be removed. For that, it looks for the "
"string dummy or transitional in their short description."
msgstr ""
+"例えば、<literal>--guess-dummy</literal> つきだと、<command>deborphan</"
+"command> はアップグレードに必要だったが、現在は問題なく削除できるすべての移行パッケージを"
+"探そうとします。これには、それぞれの短い説明文中に dummy あるいは transitional の文字列"
+"を探します。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"<command>apt-cache search .|grep dummy</command> or <command>apt-cache "
"search .|grep transitional</command>."
msgstr ""
+"ですので、あなたがそのようなパッケージを作る際には、この文章を短い説明文に必ず追加してください。"
+"例を探す場合は、以下を実行してください: <command>apt-cache search .|grep dummy</command> "
+"または <command>apt-cache search .|grep transitional</command>"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1674
"and its priority to <literal>extra</literal> in order to ease "
"<command>deborphan</command>'s job."
msgstr ""
+"それから、<command>deborphan</command> の作業を楽にするため、section を <literal>"
+"oldlibs</literal>、priority を <literal>extra</literal> にするのもお勧めです。"
# type: Content of: <chapter><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1683
-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> についてのベストプラクティス"
+"<filename>.orig.tar.{gz,bz2,xz}</filename> についてのベストプラクティス"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1685
+#, fuzzy
msgid ""
"There are two kinds of original source tarballs: Pristine source and "
"repackaged upstream source."
msgstr ""
+"オリジナルのソース tarball には 2 種類あります: 素のソース (Pristine source) と"
+"再パッケージした開発元のソース (repackaged upstream source) です。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1689
+#, fuzzy
msgid "Pristine source"
-msgstr ""
+msgstr "素のソース (Pristine source)"
#. type: Content of: <chapter><section><section><section><para><footnote><para>
#: best-pkging-practices.dbk:1693
"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: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><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1719
msgid "It unpacks the tarball in an empty temporary directory by doing"
-msgstr ""
+msgstr "以下のようにして空の一時ディレクトリに tarball を展開します"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><screen>
#: 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"
+msgstr "zcat path/to/<replaceable>パッケージ名</replaceable>_<replaceable>開発元のバージョン</replaceable>.orig.tar.gz | tar xf -\n"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1727
+#, fuzzy
msgid ""
"If, after this, the temporary directory contains nothing but one directory "
"and no other files, <command>dpkg-source</command> renames that directory to "
"version</replaceable>(.orig)</filename>. The name of the top-level "
"directory in the tarball does not matter, and is forgotten."
msgstr ""
+"もし、この後で、一時ディレクトリが 1 つのディレクトリ以外含まず他にどのファイルも無い場合、"
+"<command>dpkg-source</command> はそのディレクトリを <filename><replaceable>"
+"パッケージ名</replaceable>-<replaceable>開発元のバージョン</replaceable>(.orig)"
+"</filename> にリネームします。tarball 中の最上位のディレクトリ名は問題にはされず、"
+"忘れられます。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1736
+#, fuzzy
msgid ""
"Otherwise, the upstream tarball must have been packaged without a common top-"
"level directory (shame on the upstream author!). In this case, "
"<emphasis>itself</emphasis> to <filename><replaceable>packagename</"
"replaceable>-<replaceable>upstream-version</replaceable>(.orig)</filename>."
msgstr ""
+"それ以外の場合、開発元の tarball は共通の最上位ディレクトリ無しでパッケージされなくては "
+"いけません (開発元の作者よ、恥を知りなさい!)。この場合、<command>dpkg-source</command> "
+"は一時ディレクトリ<emphasis>そのもの</emphasis>を <filename><replaceable>パッケージ名"
+"</replaceable>-<replaceable>開発元のバージョン</replaceable>(.orig)</filename> "
+"へリネームします。"
# type: Content of: <chapter><section><section><section><title>
#. type: Content of: <chapter><section><section><section><title>
"source as gzipped tar at all, or if upstream's tarball contains non-DFSG-"
"free material that you must remove before uploading."
msgstr ""
+"パッケージは素のソース tarball と共にアップロード<emphasis role=\"strong\">すべき"
+"</emphasis>ですが、それが可能ではない場合が色々とあります。開発元がソースを gzip 圧縮した "
+"tarball を全く配布していない場合や、upstream の tarball が DFSG-free ではない、"
+"あなたがアップロード前に削除しなければならない素材を含んでいる場合がこれにあたります。"
#. type: Content of: <chapter><section><section><section><para>
#: 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 ""
+"この様な場合、開発者は適切な <filename>.orig.tar.{gz,bz2,xz}</filename> ファイルを"
+"自身で準備する必要があります。この様な tarball を、再パッケージした開発元のソース (repackaged "
+"upstream source) と呼びます。再パッケージした開発元のソースでは Debian ネイティブパッケージ"
+"とは違うことに注意してください。再パッケージしたソースは、Debian 固有の変更点は分割された "
+"<filename>.diff.gz</filename> または <filename>.debian.tar.{gz,bz2,xz}</filename> "
+"のままであり、バージョン番号は <replaceable>開発元のバージョン</replaceable> と <replaceable>"
+"debian リビジョン</replaceable> から構成されたままです。"
#. type: Content of: <chapter><section><section><section><para>
#: 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:1774
-msgid "A repackaged <filename>.orig.tar.{gz,bz2,lzma}</filename>"
+msgid "A repackaged <filename>.orig.tar.{gz,bz2,xz}</filename>"
msgstr ""
+"<filename>.orig.tar.{gz,bz2,xz}</filename> についてのベストプラクティス"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1779
"<ulink url=\"&url-debian-policy;ch-source.html#s-debianrules\">Main building "
"script: <filename>debian/rules</filename></ulink>."
msgstr ""
+"ソースパッケージの由来を<emphasis role=\"strong\">ドキュメントにすべき</emphasis>"
+"です。どうやってソースを得たのかという詳細情報が得たのか、どの様にすれば"
+"再生成できるのかを <filename>debian/copyright</filename> で提供しましょう。"
+"ポリシーマニュアルで、<ulink url=\"&url-debian-policy;ch-source.html#"
+"s-debianrules\">メイン構築スクリプト: <filename>debian/rules</filename></ulink> "
+"に記述しているように、<filename>debian/rules</filename> に作業を繰り返して"
+"くれる <literal>get-orig-source</literal> ターゲットを追加するのも良い考えです。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote><para>
#: best-pkging-practices.dbk:1794
"not come from the upstream author(s), or whose contents has been changed by "
"you.<placeholder type=\"footnote\" id=\"0\"/>"
msgstr ""
+"開発元の作者由来ではないファイルや、あなたが内容を変更したファイルを含める"
+"<emphasis role=\"strong\">べきではありません</emphasis>。<placeholder "
+"type=\"footnote\" id=\"0\"/>"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1805
"be omitted even if the first thing your <filename>debian/rules</filename> "
"does is to overwrite it by running a configure script."
msgstr ""
+"法的理由から不可能であるものを除いて、開発元の作者が提供しているビルドおよび"
+"移植作業環境を完全に<emphasis role=\"strong\">保全すべき</emphasis>です。"
+"例えば、ファイルを省略する理由として MS-DOS でのビルドにしか使われないから、"
+"というのは十分な理由にはなりません。同様に、開発元から提供されている "
+"<filename>Makefile</filename> を省略すべきではありません。たとえ <filename>"
+"debian/rules</filename> が最初にすることが configure スクリプトを実行して"
+"それを上書きすることであったとしても、です。"
# type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
"mirror rather than trying to locate a canonical upstream distribution point)."
msgstr ""
+#FIXME-trans: pristine の訳
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1821
+#, fuzzy
msgid ""
"<emphasis role=\"strong\">should</emphasis> use "
"<filename><replaceable>packagename</replaceable>-<replaceable>upstream-"
"in its tarball. This makes it possible to distinguish pristine tarballs "
"from repackaged ones."
msgstr ""
+"tarball の最上位ディレクトリの名前として <filename><replaceable>パッケージ名"
+"</replaceable>-<replaceable>開発元のバージョン</replaceable>.orig</filename> "
+"を<emphasis role=\"strong\">使うべき</emphasis>です。これは、大元の tarball と"
+"再パッケージしたものを判別できるようにしてくれます。"
#. type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
#: best-pkging-practices.dbk:1829
"<emphasis role=\"strong\">should</emphasis> be gzipped or bzipped with "
"maximal compression."
msgstr ""
+"gzip あるいは bzip で最大限<emphasis role=\"strong\">圧縮されるべき</emphasis>です。"
#. type: Content of: <chapter><section><section><section><title>
#: best-pkging-practices.dbk:1836
msgid "Changing binary files"
-msgstr ""
+msgstr "バイナリファイルの変更"
#. type: Content of: <chapter><section><section><section><para>
#: best-pkging-practices.dbk:1838
"version of the file(s) and decode it at build time in <filename>debian/"
"rules</filename> (and move it in its official location)."
msgstr ""
+"オリジナルの tarball に含まれているバイナリファイルを変更する、あるいは存在"
+"していなかったバイナリファイルを追加する必要がある場合がしばしばあります。"
+"これは、ソースパッケージが“3.0 (quilt)”形式を使っている場合は完全にサポート"
+"されています。詳細は <citerefentry><refentrytitle>dpkg-source</refentrytitle>"
+"<manvolnum>1</manvolnum></citerefentry> マニュアルのページを参照してください。"
+"古い“1.0”形式を使っている場合、バイナリファイルを <filename>.diff.gz</"
+"filename> 中に保存できないので、<command>uuencode</command> (か類似のもの) を"
+"使ったファイルを保存し、<filename>debian/rules</filename> 中でビルド時に"
+"デコードします (そしてファイルを正しい位置へ移動する)。"
# type: Content of: <chapter><section><section><title>
#. type: Content of: <chapter><section><section><title>
#: best-pkging-practices.dbk:1853
msgid "Best practices for debug packages"
-msgstr ""
+msgstr "デバッグパッケージのベストプラクティス"
+#FIXME-trans: otherwise?
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1855
msgid ""
"need this additional debugging information to install it, without bloating a "
"regular system with the information."
msgstr ""
+"デバッグパッケージは名前が -dbg で終わっているもので、<command>gdb</command> "
+"が利用可能な追加情報を含んでいます。Debian のバイナリはデフォルトで strip されて"
+"いるので、関数名や行番号を含むデバッグ情報は、Debian のバイナリに <command>gdb"
+"</command> を走らせたときに利用できません。デバッグパッケージは、この追加デバッグ"
+"情報を必要とするユーザが、通常のシステムを巨大化させること無く使えるように"
+"してくれます。"
# type: Content of: <chapter><section><section><para>
#. type: Content of: <chapter><section><section><para>
"make a debug package for it. Programs that are core infrastructure, such as "
"apache and the X server are also good candidates for debug packages."
msgstr ""
+"デバッグパッケージを作るか否かは、パッケージのメンテナ次第です。メンテナは、"
+"ライブラリパッケージについてデバッグパッケージを作成するのが推奨されています。"
+"これは、ライブラリにリンクしている沢山のプログラムをデバッグする助けになる"
+"からです。一般的に言って、デバッグパッケージはすべてのプログラムに追加する"
+"必要はありません; これを行うとアーカイブが巨大なものになるでしょう。しかし、"
+"メンテナは、ユーザがデバッグ版のプログラムを頻繁に必要とするのに気づいた場合、"
+"デバッグパッケージを作るのに値するでしょう。インフラストラクチャの核となっている、"
+"apache や X サーバのようプログラムも、デバッグパッケージの良い作成候補です。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1873
+#, fuzzy
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 "
"lib/libfoo.so.1</filename> go in <filename>/usr/lib/debug/usr/lib/libfoo."
"so.1</filename>."
msgstr ""
+"デバッグパッケージのうちいくつかは、ライブラリあるいは他のバイナリの完全に"
+"特別なデバッグビルドを含むでしょうが、それらの大半は容量やビルドする時間を節約でき、"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1885
+#, fuzzy
msgid ""
"The debugging symbols can be extracted from an object file using "
"<command>objcopy --only-keep-debug</command>. Then the object file can be "
"<refentrytitle>objcopy</refentrytitle> <manvolnum>1</manvolnum> </"
"citerefentry> explains in detail how this works."
msgstr ""
+"デバッグシンボルは <command>objcopy --only-keep-debug</command> を使って"
+"オブジェクトファイルから展開できます。それからオブジェクトファイルは strip "
+"することができ、<command>objcopy --add-gnu-debuglink</command> がデバッグ"
+"シンボルファイルへのパスを指定するのに使われます。<citerefentry> "
+"<refentrytitle>objcopy</refentrytitle> <manvolnum>1</manvolnum> </citerefentry> "
+"で、これがどの様に動作するのかを詳細に説明しています。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1893
+#, fuzzy
msgid ""
"The <command>dh_strip</command> command in <systemitem role=\"package"
"\">debhelper</systemitem> supports creating debug packages, and can take "
"dbg-package=libfoo-dbg</command>, and add an entry to <filename>debian/"
"control</filename> for the debug package."
msgstr ""
+"<systemitem role=\"package\">debhelper</systemitem> 中の <command>"
+"dh_strip</command> コマンドが、デバッグパッケージの作成をサポートして、"
+"デバッグシンボルを分離するのに <command>objcopy</command> の利用を楽に"
+"してくれます。あなたのパッケージが <systemitem role=\"package\">debhelper"
+"</systemitem> を使っている場合、あなたがする必要があるのは <command>dh_strip "
+"--dbg-package=libfoo-dbg</command> を呼び出し、<filename>debian/control"
+"</filename> にデバッグパッケージのエントリを追加することだけです。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1900
"Note that the debug package should depend on the package that it provides "
"debugging symbols for, and this dependency should be versioned. For example:"
msgstr ""
+"デバッグパッケージは、そのパッケージがデバッグシンボルを提供するパッケージに依存"
+"する必要があり、この依存関係はバージョン指定が必要であるということに注意してください。"
+"以下のような例になります:"
# type: Content of: <chapter><section><section><screen>
#. type: Content of: <chapter><section><section><screen>
# 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 "ã\83¡ã\83³ã\83\86ã\83\8aã\82¹ã\82¯ã\83ªã\83\97ã\83\88のベストプラクティス"
+msgstr "ã\83¡ã\82¿ã\83\91ã\83\83ã\82±ã\83¼ã\82¸のベストプラクティス"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1910
"(built by the source packages <systemitem role=\"package\">meta-gnome2</"
"systemitem> and <systemitem role=\"package\">linux-latest</systemitem>)."
msgstr ""
+"メタパッケージは、evolve overtime なcoherent set のパッケージをインストール"
+"するのを楽にしてくれる、ほぼ空のパッケージです。そのセットの全パッケージに依存することで、"
+"これを実現しています。APT の力のおかげで、メタパッケージのメンテナは依存関係を調整すれば"
+"ユーザのシステムが自動的に追加パッケージを得ることができます。自動的にインストールされていて"
+"メタパッケージから落とされたパッケージは、削除候補としてマークされます (そして <command>"
+"aptitude</command> によって自動的に削除もされます)。<systemitem role=\"package\">"
+"gnome</systemitem> と <systemitem role=\"package\">linux-image-amd64"
+"</systemitem> は、メタパッケージの 2 つの例です (ソースパッケージ <systemitem "
+"role=\"package\">meta-gnome2</systemitem> and <systemitem role=\"package\">"
+"linux-latest</systemitem> から生成されています)。"
#. type: Content of: <chapter><section><section><para>
#: best-pkging-practices.dbk:1924
"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