argra****@users*****
argra****@users*****
2013年 10月 1日 (火) 01:24:20 JST
Index: docs/perl/5.18.1/perlrun.pod
diff -u docs/perl/5.18.1/perlrun.pod:1.1 docs/perl/5.18.1/perlrun.pod:1.2
--- docs/perl/5.18.1/perlrun.pod:1.1 Tue Sep 17 23:17:40 2013
+++ docs/perl/5.18.1/perlrun.pod Tue Oct 1 01:24:20 2013
@@ -1186,12 +1186,11 @@
=end original
-extension が指定されないと、
-and your system supports it, the original
-I<file> is kept open without a name while the output is redirected to
-a new file with the original I<filename>. When perl exits, cleanly or not,
-the original I<file> is unlinked.
-(TBT)
+extension が指定されず、システムが対応しているなら、元の I<file> は名前なしで
+開いたままになる一方、出力は元の I<filename> の新しいファイルに
+リダイレクトされます。
+クリーンかどうかに関わらず、perl が終了した時点で、元の I<file> は
+アンリンクされます。
=begin original
@@ -2250,11 +2249,10 @@
特定の場所における F<version/archname/>, F<version/>, F<archname/> のような
アーキテクチャ依存とバージョン依存のディレクトリは、もしあれば自動的に
追加されます; この検索はインタプリタ起動時に行われます。
-In addition, any directories
-matching the entries in C<$Config{inc_version_list}> are added.
-(These typically would be for older compatible perl versions installed
-in the same directory tree.)
-(TBT)
+さらに、C<$Config{inc_version_list}> のエントリにマッチングするディレクトリが
+追加されます。
+(これらは典型的には同じディレクトリツリーにより古い互換性のある perl が
+インストールされている場合のためのものです)。
=begin original
@@ -2897,11 +2895,10 @@
=end original
-(Since Perl 5.8.1, new semantics in Perl 5.18.0) Used to override
-the randomization of Perl's internal hash function. The value is expressed
-in hexadecimal, and may include a leading 0x. Truncated patterns
-are treated as though they are suffixed with sufficient 0's as required.
-(TBT)
+(Perl 5.8.1 から; 新しい意味論は Perl 5.18.0 から)
+Perl の内部ハッシュ関数のランダム化をオーバーライドするために使います。
+値は 16 進数で表現され、先頭の 0x を含んでいてもかまいません。
+切りつめられたパターンは、必要な分の 0 が前置されているものとして扱われます。
=begin original
@@ -2911,10 +2908,9 @@
=end original
-If the option is provided, and C<PERL_PERTURB_KEYS> is NOT set, then
-a value of '0' implies C<PERL_PERTURB_KEYS=0> and any other value
-implies C<PERL_PERTURB_KEYS=2>.
-(TBT)
+オプションが指定されて、C<PERL_PERTURB_KEYS> が設定されていないと、
+値 '0' は C<PERL_PERTURB_KEYS=0> として扱い、その他の値は
+C<PERL_PERTURB_KEYS=2> として扱います。
=begin original
@@ -2953,12 +2949,11 @@
=end original
-(Since Perl 5.18.0) Set to C<"0"> or C<"NO"> then traversing keys
-will be repeatable from run to run for the same PERL_HASH_SEED.
-Insertion into a hash will not change the order, except to provide
-for more space in the hash. When combined with setting PERL_HASH_SEED
-this mode is as close to pre 5.18 behavior as you can get.
-(TBT)
+(Perl 5.18.0 から) C<"0"> または C<"NO"> を設定すると、同じ
+PERL_HASH_SEED でのキーの探索順序は毎回同じになります。
+ハッシュへの挿入は、ハッシュの容量が増える場合を除き、順序を変更しません。
+PERL_HASH_SEED を設定することと組み合わせると、可能な限り 5.18 より前の
+振る舞いに近づきます。
=begin original
@@ -2970,12 +2965,11 @@
=end original
-When set to C<"1"> or C<"RANDOM"> then traversing keys will be randomized.
-Every time a hash is inserted into the key order will change in a random
-fashion. The order may not be repeatable in a following program run
-even if the PERL_HASH_SEED has been specified. This is the default
-mode for perl.
-(TBT)
+C<"1"> または C<"RANDOM"> を設定すると、キーの探索はランダム化されます。
+ハッシュにキーが挿入される毎に、順序はランダムに変わります。
+順序は、PERL_HASH_SEED が指定されていても、プログラムを再び実行したときに
+再現できません。
+これは perl のデフォルトのモードです。
=begin original
@@ -2985,10 +2979,8 @@
=end original
-When set to C<"2"> or C<"DETERMINISTIC"> then inserting keys into a hash
-will cause the key order to change, but in a way that is repeatable
-from program run to program run.
-(TBT)
+C<"2"> または C<"DETERMINISTIC"> に設定すると、ハッシュへのキーの挿入によって
+キーの順序が変わりますが、プログラムを再び実行したときには再現可能です。
=begin original
@@ -2998,10 +2990,9 @@
=end original
-B<NOTE:> Use of this option is considered insecure, and is intended only
-for debugging non-deterministic behavior in Perl's hash function. Do
-not use it in production.
-(TBT)
+B<注意:> このオプションはセキュアではないと考えられていて、Perl のハッシュ関数の
+非決定的な振る舞いのデバッグ専用であることを意図しています。
+製品で使わないでください。
=begin original
@@ -3012,11 +3003,10 @@
=end original
-See L<perlsec/"Algorithmic Complexity Attacks"> and L</PERL_HASH_SEED>
-and L</PERL_HASH_SEED_DEBUG> for more information. You can get and set the
-key traversal mask for a specific hash by using the C<hash_traversal_mask()>
-function from L<Hash::Util>.
-(TBT)
+さらなる情報については L<perlsec/"Algorithmic Complexity Attacks">,
+L</PERL_HASH_SEED>, L</PERL_HASH_SEED_DEBUG> を参照してください。
+L<Hash::Util> にある C<hash_traversal_mask()> を使うことで、特定のハッシュに
+対するキー探索マスクを取得および設定できます。
=item PERL_HASH_SEED_DEBUG
X<PERL_HASH_SEED_DEBUG>