[perldocjp-cvs 122] CVS update: docs/modules/YAML-0.62/lib

Back to archive index

YAMASHINA Hio hio****@users*****
2006年 12月 20日 (水) 00:10:52 JST


Index: docs/modules/YAML-0.62/lib/YAML.pod
diff -u docs/modules/YAML-0.62/lib/YAML.pod:1.1 docs/modules/YAML-0.62/lib/YAML.pod:1.2
--- docs/modules/YAML-0.62/lib/YAML.pod:1.1	Sun Oct 22 20:36:09 2006
+++ docs/modules/YAML-0.62/lib/YAML.pod	Wed Dec 20 00:10:52 2006
@@ -89,7 +89,7 @@
 sorted by default. In addition, YAML supports several styles of scalar
 formatting for different types of data.
 
-YAML は複雑なデータ構造の外側の明確な意味を作ります. YAML が特別な
+YAML は複雑なデータ構造から明確な意味を作ります. YAML が特別な
 データダンプツールであることに気づくべきでしょう. データ構造は
 インデントを通して見渡せるし, 再帰データを扱うこともできます. 
 また, 項目キーはデフォルトでソートされます. 加えてデータの形式に
@@ -104,8 +104,8 @@
 why invent a new syntax for each one? And why subject users to the
 complexities of XML or native Perl code?
 
-YAML は設定ファイルの美しい構文から完全にデザインされています. 
-ほとんどすべてのプログラマは設定ファイルを必要としているでしょう. 
+YAMLは設定ファイルとして優れた構文となるように一からデザインされています.
+ほとんどすべてのプログラムは設定ファイルを必要としているでしょう. 
 そしてなぜ毎回新しい構文を発明しようとするのですか? なぜ XML の
 複雑さや Perl コードそのものに悩まされなければならないのですか?
 
@@ -124,8 +124,7 @@
 Java の直列化の
 必要性に見合うように設計されています. またこれらの言語間で相互に操作
 できるように設計されています. これは Perl が生成した YAML は Python で
-処理することが可能なことを意味し, さらに完全なデータ構造を返すことを
-保証します.
+処理することが可能なことを意味します.
 
 =item YAML is taint safe.
 
@@ -212,7 +211,7 @@
 異なる YAML モジュールの配布物では YAML.pm, YAML::Loader, 
 YAML::Dumper をサブクラス化して作ることが出来ます. 
 例えば YAML-Simple は, YAML::Simple, YAML::Dumper::Simple, 
-YAM::Loader::Simple から成ります.
+YAML::Loader::Simple から成ります.
 
 Why would there be more than one implementation of YAML? Well, despite
 YAML's offering of being a simple data format, YAML is actually very
@@ -252,7 +251,8 @@
 
 YAML::Lite のアピールポイントは, 人々が多く利用する, 
 そして小さく, 速く, 安定した, ピュアPerl形式として提案するだけに, 
-YAML を 90% に落としている点にあります.
+YAML を 90% に落としている点にあります. 
+YAML::Liteは, 自分にできない処理を求められると単にdieします.
 
 =item YAML::Syck
 
@@ -290,9 +290,9 @@
 
 YAML は水面下では完全にオブジェクト指向になっています. 
 幾つかの便利なトップレベル関数をエクスポートしており, その使い方は
-とても簡単です. これらの関数はあなたに変わってオブジェクト操作を
+とても簡単です. これらの関数はあなたに代わってオブジェクト操作を
 行っているだけです. もしオブジェクトAPIに直接アクセスしたいときは, 
-YAML::Dumper 及び YAML::Loader の土球面mとを参照してください.
+YAML::Dumper 及び YAML::Loader のドキュメントを参照してください.
 
 =head2 エクスポートされる関数.
 
@@ -507,7 +507,7 @@
 
 Tells YAML.pm whether or not to sort hash keys when storing a document. 
 
-YAML.pm がドキュメントの格納時にはっ主キーをソートするかどうかを
+YAML.pm がドキュメントの格納時にハッシュキーをソートするかどうかを
 設定します.
 
 YAML::Node objects can have their own sort order, which is usually what
@@ -583,9 +583,10 @@
 
 UseCode オプションは DumpCode と LoadCode の2つのオプションを一度に
 設定するショートカットです. UseCode に '1' を設定すると YAML.pm は
-Perl コードリファレンスを(B::Deparseをつかって) Perl で, そして
-メモリ上にロードするときには eval() を使います. その結果, 信頼できない
-コードをパースするために eval() を使うことになります.
+Perl コードリファレンスを(B::Deparseをつかって) Perl としてダンプ
+して, eval() を使ってメモリにロードして戻します. これがオプション
+扱いでなければならない理由は, 信頼できないコードをパースするために
+eval() を使うことは安心して行えることではないからです.
 
 =item DumpCode
 
@@ -594,7 +595,8 @@
 like Data::Dumper). If DumpCode is set to '1' or 'deparse', code
 references will be dumped as actual Perl code.
 
-YAML.pm が Perl コードリファレンスをシリアライズするかを設定します. 
+YAML.pm が Perl コードリファレンスをシリアライズするかどうか, 
+そしてそれをどのように行うかを設定します. 
 デフォルトでは YAML.pm はコードリファレンスをダミーのプレースホルダ
 としてダンプします (これは Data::Dumper とよく似ています). 
 もし DumpCode に '1' もしくは 'deparse' を設定しているのなら, 
@@ -637,9 +639,10 @@
 node. Sometimes you'll want all multiline scalars to use the 'block'
 style. If so, set this option to 1.
 
-YAML.pm が与えられたノードに対して最適なスカラー形式を推測するのを
-助けるために使います. 全ての複数行のスカラーは'ブロック'形式として
-扱いたいときにはこのオプションに 1 を設定します.
+YAML.pm は与えられたノードに対する最適なスカラー形式の推測に
+ヒューリスティックを使います. ですが全ての複数行のスカラーは
+'ブロック' 形式として扱いたい時もあるでしょう. そのような
+時にはこのオプションに 1 を設定します.
 
 NOTE: YAML's block style is akin to Perl's here-document. 
 
@@ -677,8 +680,8 @@
 to do this. This also may result in faster processing because the lookup
 overhead is by bypassed.
 
-時にはデータが再帰でない方が自然であれば, すべてのノードはすべて
-表現されてほしいでしょう. (すなわち元のコピーとして.) 
+時にはデータが再帰でない方が自然であると「知っている」時には,
+どのノードも完全に表現されてほしいでしょう. (すなわち元のコピーとして.) 
 $YAML::UseAliases に 0 を設定することでこれを行うことができます. 
 これは検索のオーバーヘッドをとばすことができるため処理が
 早くなることもあるでしょう.
@@ -834,9 +837,9 @@
 serialization should be transferred into or out of memory. For instance
 a Foo::Bar object would use the tag 'perl/Foo::Bar':
 
-これは型と似ています. これは特定の YAML ノード知り荒いぜーションが
-メモリの中もしくは外でどのように転送されるべきかを示します. 例えば
-Foo::Bar オブジェクトはタグ 'perl/Foo::Bar' を使います:
+これは型と似ています. これは特定の YAML ノードをシリアライズした
+ものがメモリの中もしくは外へどのように転送されるべきかを示します.
+例えば Foo::Bar オブジェクトはタグ 'perl/Foo::Bar' を使います:
 
     - !perl/Foo::Bar
         foo: 42
@@ -901,7 +904,7 @@
 optimum human readability.
 
 YAML にはスカラーを表現する幾つかのスタイルがあります. これは
-様々なデータは最適な可読性を得るために様々なフィーマットを必要とする
+様々なデータは最適な可読性を得るために様々なフォーマットを必要とする
 ためにとても重要なことです.
 
 =item plain scalar
@@ -979,7 +982,9 @@
 ending marker is required. The data is verbatim. No line folding.
 
 この最後の複数行形式は (全ての YAML データのように) スコープが
-インデントで指定される点を除いて Perl のヒアドキュメントと同様です.
+インデントで指定される点を除いて Perl のヒアドキュメントと同様です. 
+その為終わりの印は不要です. データは書いたままに扱われます. 
+行の畳み込みも行われません.
 
     - |
         QTY  DESC          PRICE  TOTAL
@@ -1047,7 +1052,7 @@
 For more information please refer to the immensely helpful YAML
 specification available at L<http://www.yaml.org/spec/>.
 
-より詳しい情報は L<http://www.yaml.org/spec/> にある巨大で役立つ
+より詳しい情報は L<http://www.yaml.org/spec/> にある非常に役に立つ
 YAML 仕様を参照してください.
 
 =head1 ysh - YAML シェル
@@ -1137,7 +1142,7 @@
 
 is resonsible for YAML.pm.
 
-は YAML.pm を resonsible しています(訳注:resonsibleて何?^^;)
+は YAML.pm の責任を担っています.
 
 The YAML serialization language is the result of years of collaboration
 between Oren Ben-Kiki, Clark Evans and Ingy dE<ouml>t Net. Several others


perldocjp-cvs メーリングリストの案内
Back to archive index