argra****@users*****
argra****@users*****
2009年 7月 19日 (日) 03:18:07 JST
Index: docs/modules/Benchmark-1.10/Benchmark.pod
diff -u docs/modules/Benchmark-1.10/Benchmark.pod:1.2 docs/modules/Benchmark-1.10/Benchmark.pod:1.3
--- docs/modules/Benchmark-1.10/Benchmark.pod:1.2 Tue Jun 23 03:08:44 2009
+++ docs/modules/Benchmark-1.10/Benchmark.pod Sun Jul 19 03:18:07 2009
@@ -144,8 +144,8 @@
=end original
-C<$Benchmark::debug> フラグを設定することによって、デバッグを許可したり、
-許可を解除したりします:
+C<$Benchmark::debug> フラグを設定することによって、デバッグを有効にしたり、
+無効にしたりします:
debug Benchmark 1;
$t = timeit(10, ' 5 ** $Global ');
@@ -271,12 +271,10 @@
=end original
CPU 秒は B<最低> 時間であることに注意してください:
-CPU scheduling and
-other operating system factors may complicate the attempt so that a
-little bit more time is spent. The benchmark output will, however,
-also tell the number of C<$code> runs/second, which should be a more
-interesting number than the actually spent seconds.
-(TBT)
+CPU スケジューリングと、その他の OS の要素がこの試みを
+複雑にしているので、ほんのもう少し多くの時間が使われます。
+しかし、ベンチマーク出力は C<$code> の 1 秒当たりの実行数を表示します;
+これは実際にかかった時間より興味深い数字のはずです。
=begin original
@@ -297,11 +295,10 @@
=end original
-The CODEHASHREF is a reference to a hash containing names as keys
-and either a string to eval or a code reference for each value.
+CODEHASHREF は、キーとして名前、値として eval する文字列かコードリファレンスを
+含むハッシュへのリファレンスです。
CODEHASHREF のそれぞれの (KEY, VALUE) ペアについて、このルーチンが
呼び出されます
-(TBT)
timethis(COUNT, VALUE, KEY, STYLE)
@@ -369,14 +366,14 @@
=end original
STYLE は 'all', 'none', 'noc', 'nop', 'auto' のいずれかです。
-'all' shows
-each of the 5 times available ('wallclock' time, user time, system time,
-user time of children, and system time of children). 'noc' shows all
-except the two children times. 'nop' shows only wallclock and the
-two children times. 'auto' (the default) will act as 'all' unless
-the children times are both zero, in which case it acts as 'noc'.
-'none' prevents output.
-(TBT)
+'all' は利用可能な五つの時間(「壁時計」時間、ユーザ時間、
+システム時間、子プロセスのユーザ時間、子プロセスのシステム時間)を
+それぞれ表示します。
+'noc' は二つの子プロセスの時間以外の全てを表示します。
+'nop' は壁時計時間と二つの子プロセスの時間だけを表示します。
+'auto' (これがデフォルトです) は、子プロセスの時間が両方とも 0 の場合は
+'noc' として振る舞い、それ以外では 'all' として振る舞います。
+'none' は何も出力しません。
=begin original
@@ -437,9 +434,8 @@
=end original
-Optionally calls timethese(), then outputs comparison chart.
+状況に応じて timethese() を呼び出し、それから比較表を出力します。
これは:
-(TBT)
cmpthese( -1, { a => "++\$i", b => "\$i *= 2" } ) ;
@@ -462,9 +458,8 @@
=end original
-This chart is sorted from slowest to fastest, and shows the percent speed
-difference between each pair of tests.
-(TBT)
+この表は遅いものから早いものの順にソートされ、それぞれのテスト間の
+速度のさを百分率で表示します。
=begin original
@@ -472,8 +467,7 @@
=end original
-c<cmpthese> can also be passed the data structure that timethese() returns:
-(TBT)
+C<cmpthese> には timethese() が返すデータ構造体を渡すことも出来て:
$results = timethese( -1, { a => "++\$i", b => "\$i *= 2" } ) ;
cmpthese( $results );
@@ -486,10 +480,9 @@
=end original
-in case you want to see both sets of results.
-If the first argument is an unblessed hash reference,
-that is RESULTSHASHREF; otherwise that is COUNT.
-(TBT)
+両方の結果セットを見たいときに使えます。
+最初の引数が bless されていないハッシュリファレンスの場合、これは
+RESULTSHASHREF です; それ以外の場合はこれは COUNT です。
=begin original
@@ -499,7 +492,8 @@
=end original
Returns a reference to an ARRAY of rows, each row is an ARRAY of cells from the
-above chart, including labels. This:
+above chart, including labels.
+こうすると:
(TBT)
my $rows = cmpthese( -1, { a => '++$i', b => '$i *= 2' }, "none" );
@@ -510,7 +504,7 @@
=end original
-というのは以下のようなデータ構造を返します:
+以下のようなデータ構造を返します:
[
[ '', 'Rate', 'b', 'a' ],
@@ -526,10 +520,10 @@
=end original
-B<NOTE>: This result value differs from previous versions, which returned
-the C<timethese()> result structure. If you want that, just use the two
-statement C<timethese>...C<cmpthese> idiom shown above.
-(TBT)
+B<注意>: この結果値は、C<timethese()> の結果構造体を返していた
+以前のバージョンとは異なります。
+もしそれがほしいなら、上述した C<timethese>...C<cmpthese> の 2 文の
+記述法を使ってください。
=begin original
@@ -705,8 +699,8 @@
=end original
計算された空ループの実行時間は、繰り返しの数をキーとして、
-キャッシングされます。
-キャッシングは、以下のようなサブルーチンの呼び出しで制御できます:
+キャッシュされます。
+キャッシュ化は、以下のようなサブルーチンの呼び出しで制御できます:
clearcache($key);
clearallcache();
@@ -721,9 +715,8 @@
=end original
-Caching is off by default, as it can (usually slightly) decrease
-accuracy and does not usually noticably affect runtimes.
-(TBT)
+キャッシュ化はデフォルトではオフです; これは(普通はわずかですが)
+正確性を減少させ、普通はたいして実行時間に影響を与えないからです。
=head1 EXAMPLES