[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: dpkg man page (5) 査読依頼



たかはしもとのぶです。

From: Seiji Kaneko <skaneko@xxxxxxxxxxxx>
Date: Wed, 5 Oct 2011 22:11:51 +0900

> かねこです。5 だけざっと見ました。

ありがとうございます。一箇所だけ、ちょっと考え中ですが、他はなんらかの
形で反映しています。

# 10月から激務な部署に異動となってしまったので、かなりペースが落ちそうです。

------>8------------>8------------>8------------>8------------>8
--- 20110929ja.po.5.orig.txt	2011-10-05 19:29:32.000000000 +0900
+++ 20110929ja.po.5.txt	2011-10-05 22:01:05.000000000 +0900
@@ -114,10 +114,10 @@
 "dropped because the symbol really got added by the Debian specific change, "
 "then one should suffix the version with \"~\"."
 msgstr ""
-"シンボルファイルは、幾度かのリリースを通じてパッケージの発展がもたらされた"
-"場合のみ非常に有用なものとなる。メンテナは新しいシンボルが追加される度に"
-"ファイルを更新する必要があり、これにより関連付けられた最小のバージョンが"
-"実態に即したものとなる。この作業を適切に行うために、ビルドのログに含まれる"
+"シンボルファイルは、幾度かのリリースを通じたパッケージの発展を反映したものとなっている"
+"場合のみ非常に有用なものとなる。つまり、メンテナは新しいシンボルが追加される度に"
+"ファイルを更新し、これにより関連付けられた最小のバージョンが"
+"実態に即したものする必要がある。この作業を適切に行うために、ビルドのログに含まれる"
 "差分情報を用いることができる。

原文の趣旨を理解しきれていなかったことに加え、そもそも日本語も
ぎこちなかったので、以下のように直しました。

=====
"シンボルファイルは、リリースを重ねることによるパッケージの進化に追従してこそ、"
"はじめて有益なものとなる。つまり、メンテナは新しいシンボルが追加される度に"
"ファイルを更新し、これにより関連付けられた最小のバージョンを"
"実態に即したものとする必要がある。この作業を…
=====

> @@ -406,10 +406,10 @@
>  "B<ignore-blacklist>. It can be necessary for some low level toolchain "
>  "libraries like libgcc."
>  msgstr ""
> -"dpkg-gensymbols は、通常ツールチェインの詳細な実装に副作用をもたらすため、"
> +"dpkg-gensymbols は、通常ツールチェインの詳細な実装の副作用としてのみ存在するため、"
>  "シンボルファイル中に存在すべきではないシンボルからなる内部的なブラックリストを"
>  "持っている。

「通常」の係り先が曖昧という問題もありましたので、日本語的になめらかに
なるよう、否定表現をベースにして以下のように直してみました。なおその
直後の「本気で」は、そのまま頂きました。

"dpkg-gensymbols は、ツールチェインの詳細な実装の副作用以外では通常存在しないため、"
"シンボルファイル中に存在すべきではないシンボルからなる内部的なブラックリストを"
"持っている。

> @@ -474,7 +474,7 @@
>  "considered as new."
>  msgstr ""
>  "標準シンボルと異なり、パターンにはライブラリがエクスポートする複数の"
> -"シンボルが含まれうる。B<dpkg-gensymbols> は、シンボルファイルによって"
> +"実シンボルが含まれうる。B<dpkg-gensymbols> は、シンボルファイルによって"
>  "特定のシンボルと関連付けられてI<いない>各シンボルについて、パターンとの"
>  "マッチングを行う。最初にパターンにマッチした時点で、シンボルの基本的な"
>  "機能として、パターンのタグおよび属性が用いられる。パターンにマッチしなかった"

「実」が落ちていてすみませんでした。全体を見たところ、「実シンボル」、
「実際のシンボル」が混用されていたので、他の箇所も含めて 

real symbol → 実シンボル

に統一しています。

> @@ -594,7 +594,7 @@
>  "デコードされた名前が同じである場合もある。これは、例えば仮想継承でないサンク"
>  "シンボルに複雑な継承の設定が行われている場合や、大半のコンストラクタと"
>  "デストラクタについて言える (ただし、g++ は、これらに対して通常 2 つの実"
> -"シンボルを生成する)。ただし、こうした衝突が ABI レベルで発生しているもので"
> +"シンボルを生成する)。ただし、こうした衝突は ABI レベルで発生しているもので"
>  "あり、シンボルファイルの品質を低下させるものではない。"

直しました。指摘ありがとうございます。

>  #. type: Plain text
> @@ -752,7 +752,7 @@
>  msgstr ""
>  "一般的に、すべてのパターンはエイリアス (基本的な I<c++> と I<symver>) と"
>  "汎用パターン (I<regex> および任意の基本パターンの組み合わせ) という"
> -" 2 つのグループに大別される。基本的なエイリアスベースのパターンは (O(1)) で"
> +" 2 つのグループに大別される。基本的なエイリアスベースのパターンに対するマッチングは (O(1)) で"
>  "あるため高速であるが、

直しました。

> @@ -811,7 +811,7 @@
>  #: dpkg-gensymbols.1:319
>  msgid "The include directive may also be tagged like any symbol:"
>  msgstr ""
> -"include ディレクティブは任意のシンボルのタグに用いてもよい:"
> +"include ディレクティブは他のシンボル同様、タグを付加してもよい:"

以下のように直しました。誤訳すみません。

=====
"include ディレクティブには、他のシンボル同様タグを付加してもよい:"
=====

>  #. type: Plain text
>  #: dpkg-gensymbols.1:321
> @@ -915,7 +915,7 @@
>  "ideally, it uses symbol versioning to achieve ABI stability despite internal "
>  "changes and API extension;"
>  msgstr ""
> -"ABI の安定性を維持するため、内部的な変更と API の拡張を除き、シンボルの"
> +"理想的には、ABI の安定性を維持するため、内部的な変更と API の拡張を除き、シンボルの"
>  "バージョン管理が行われている。"

句点が多くなりすぎるので以下のようにしました。ちょっと最後が長いですが。

"理想的には、ABI の安定性を維持するため、内部的な変更と API の拡張を除
いてシンボルの"
"バージョン管理が行われている。"

>  #. type: Plain text
> @@ -1059,10 +1059,10 @@
>  "テンプレートモードで保存する。両者の主な違いは、テンプレートモードでは"
>  "シンボル名とタグの両方がオリジナルの形式のまま書き出されるのに対し、"
>  "互換モードでは、処理済みのシンボル名のみが書き出され、タグは削除される"
> -"点である。さらに、テンプレートモードではすべてのシンボルが、常にシンボル"
> +"点である。さらに、テンプレートモードでは、すべてのシンボルが常にシンボル"
>  "ファイルのテンプレートに書き込まれるのに対し、互換モードでは、シンボルの"
>  "一部が標準の I<deb-symbols(5)> ファイルに書き出される際に削除される場合が"
> -"ある (タグの処理ルールによる)。xxxxx"
> +"ある (タグの処理ルールによる)。"

たしかに句点の位置が微妙になってましたので、直しました。

>  #. type: TP
>  #: dpkg-gensymbols.1:410
> @@ -1080,12 +1080,12 @@
>  "new symbols have been introduced. Level 3 fails if some libraries have "
>  "disappeared. Level 4 fails if some libraries have been introduced."
>  msgstr ""
> -"生成されたシンボルファイルをベースとして用いたテンプレートファイルと比較する"
> +"生成されたシンボルファイルを、ベースとして用いたテンプレートファイルと比較する"
>  "際のチェック項目を定義する。デフォルトのレベルは 1 である。レベルを上げると"
>  "より低いレベルのチェック項目すべてに加えて、より多くのチェックが行われる。"
>  "レベル 0 を指定した場合、常に失敗しない。レベル 1 は、幾つかのシンボルが"
>  "消失した場合に失敗となる。レベル 2 は新しいシンボルが出現しても失敗となる。"
> -"レベル 3 はライブラリが消失すると失敗となる。レベル 4 はライブラリが出現した場合に
> も失敗となる。xxxxx"
> +"レベル 3 はライブラリが消失すると失敗となる。レベル 4 はライブラリが出現した場合に
> も失敗となる。"

直しました。ちょっと訳の意味が自分で取りきれていなかったので、xxxxx を
付けていました。

>  #. type: Plain text
>  #: dpkg-gensymbols.1:421
> @@ -1103,7 +1103,7 @@
>  "libraries or new/lost symbols. This option only disables informational "
>  "output but not the checks themselves (see I<-c> option)."
>  msgstr ""
> -"出力を抑止しする。生成されたシンボルファイルとベースとなったテンプレート"
> +"出力を抑止し、生成されたシンボルファイルとベースとなったテンプレート"
>  "ファイルとの差分を生成せず、新規の、もしくは消失したライブラリや、新規の、"
>  "もしくは消失したシンボルに関する警告も表示しない。このオプションは情報の"
>  "出力を抑止するのみであり、チェック自体は行われる (I<-c> オプションも"

直しました。

> @@ -1242,10 +1242,10 @@
>  "have to forward after a double dash."
>  msgstr ""
>  "こうした作業の多くは、メンテナスクリプト (B<preinst>, B<postinst>, "
> -"B<prerm>, B<postrm>) と連携した動作が求められる。ミスを避けるためには、"
> -"すべてのスクリプトに対して、単に同じ形式のスクリプト呼び出しを設定する。"
> -"またプログラムが環境変数 B<DPKG_MAINSCRIPT_NAME> と二重ダッシュの後に設定"
> -"されるメンテナスクリプトの引数とに基づいた挙動の調整を自動的に行う。xxxxx"
> +"B<prerm>, B<postrm>) 間の連携した動作が求められる。ミスを避けるために、"
> +"すべてのスクリプトに対して、単に同じ形式のスクリプト呼び出しを設定し、"
> +"プログラム側で環境変数 B<DPKG_MAINSCRIPT_NAME> と二重ダッシュの後に設定"
> +"して渡されるメンテナスクリプト固有の引数とに基づいた挙動の調整を自動的に行うように
> している。"

指摘ありがとうございます。頂いた通りに直しました。日本語的にはまだぎこ
ちないですが、おかげで意味が通るようになりました。

>  #. type: SH
>  #: dpkg-maintscript-helper.1:28
> @@ -1268,9 +1268,9 @@
> -"これには 2 つの大きな理由がある。1 つは conffile に想定外の事象があっても"
> -"削除されないようにして、、次のバージョンでそれを復活させることができる"
> -"ようにすることで、ユーザが施した変更を破棄したいという場合。もう 1 つ"
> +"これには 2 つの大きな理由がある。1 つは (パッケージ作成時に) conffile の指定を誤っ
> て落としてしまった場合にも"
> +"ユーザは施した変更を破棄したいとは思わないであろうから、設定を削除されないようにし
> ておき、次のバージョンでそれを復活させることができる"
> +"ようにするためである。もう 1 つ"
>  "は、パッケージが dpkg のメンテナンスする conffile をパッケージのメンテナスクリプト、"
>  "通常は debconf や ucf といったツールによって、メンテナンスされている"
>  "ファイルに移行することを可能とするためである。"

誤訳すみません (かなりめちゃくちゃでしたね)。以下のように直しました。

"これには 2 つの大きな理由がある。1 つは (パッケージ作成時に) conffile の"
"指定を誤って削除してしまった場合でも、ユーザとしては行った変更を破棄され"
"たくないであろうことを勘案し、設定を削除されないようにしておき、次のバージョンでそれを"
"復活させることができるようにするためである。もう 1 つは、dpkg がメンテ"
"ナンスする conffile を、パッケージのメンテナスクリプト、"
"通常は debconf や ucf といったツールによって、メンテナンスする"
"ファイルに移行することを可能とするためである。"

> @@ -1340,9 +1340,9 @@
>  "forwarded to the program after \"--\"."
>  msgstr ""
>  "I<conffile> は削除対象の conffile のファイル名であり、I<lastversion> は"
> -"conffile が含まれるパッケージの最後の (最新の) バージョン (もしくは"
> -"これが直ちに実装されなかった場合、廃止された xxxxx"
> -" conffile を削除する対象としていない最後のバージョン) である。"
> +"対象 conffile が含まれていたパッケージの最後の (最新の) バージョン (もしくは"
> +"その conffile の削除が (不要になった後) 直ちに実装されてはいなかった場合、"
> +"その conffile を削除の指示を行っていなかった最後のバージョン) である。"
>  "<lastversion> が空もしくは省略されていた場合、この処理はアップグレードの"
>  "たびに行われる。"
>  "I<package> はパッケージ名である。これは任意であり、"

※意味はほぼ取れましたが、ちょっと引っかかっているので、もう少しだけ考えます。

> @@ -1390,8 +1390,8 @@
>  "conffile のパスが変更された場合は、ユーザによる変更点もすべて移行する"
>  "必要がある。これは、B<preinst> スクリプトに簡単な変更を行うことで実現でき"
>  "そうに見えるが、その場合、ユーザが主体的に変更を行っていないにも"
> -"関わらず、dpkg はユーザに対して conffile の変更を受け入れるかどうかの"
> -"確認を行うこととなる。"
> +"関わらず、dpkg からユーザに対して conffile の変更を受け入れるかどうかの"
> +"確認が発生してしまう。"

直しました。

>  #. type: Plain text
>  #: dpkg-maintscript-helper.1:87
> @@ -1969,10 +1969,10 @@
>  msgstr ""
> -"あり、デフォルトである。これには Debian 制御情報 (B<deb-control>(5) "
> +"あり、デフォルトである。これには Debian 制御情報形式 (B<deb-control>(5) "
>  "を参照) に則った段落 1 つからなる。"
> -"複数のエントリが指定された場合、最後に指定したエントリに従って"
> -"フィールドが取得されるが、それ以外のエントリで記載されているフィールドは除く。xxxxx"
> +"複数のエントリが指定された場合、他に指示がなければほとんどのフィールドは最後に指定したエントリに従って"
> +"取得される。"

以下のように直しました。

"あり、デフォルトである。これには Debian 制御情報形式 (B<deb-control>(5) "
"を参照) に則った段落 1 つからなる。"
"複数のエントリが指定された場合、他に指示がない限り、ほとんどのフィールドは"
"最後に指定したエントリに従って取得される。"

> 直してませんけど、demangle はデコードではなくやっぱりデマングルだと
> おもう。マングル処理でぴんと来ない人が以降の説明読んでも分からない
> のでは。

了解です。他にコメントがなければ 

デコード / エンコード → デマングル / マングル

に直しておきます。

---
TAKAHASHI Motonobu <monyo@xxxxxxxxx>