argra****@users*****
argra****@users*****
2009年 6月 23日 (火) 03:08:44 JST
Index: docs/modules/Benchmark-1.10/Benchmark.pod
diff -u docs/modules/Benchmark-1.10/Benchmark.pod:1.1 docs/modules/Benchmark-1.10/Benchmark.pod:1.2
--- docs/modules/Benchmark-1.10/Benchmark.pod:1.1 Sun Jun 21 02:54:47 2009
+++ docs/modules/Benchmark-1.10/Benchmark.pod Tue Jun 23 03:08:44 2009
@@ -165,6 +165,8 @@
=head2 Standard Exports
+(標準エクスポート)
+
=begin original
The following routines will be exported into your namespace
@@ -211,12 +213,12 @@
=end original
-Time COUNT iterations of CODE. CODE may be a string to eval or a
-code reference; either way the CODE will run in the caller's package.
-Results will be printed to STDOUT as TITLE followed by the times.
-TITLE defaults to "timethis COUNT" if none is provided. STYLE
-determines the format of the output, as described for timestr() below.
-(TBT)
+CODE を COUNT 回繰り返した時間を計ります。
+CODE は eval する文字列か、コードリファレンスです;
+どちらの場合でも CODE は呼び出し側のパッケージで実行されます。
+結果は、TITLE に引き続いて時間、という形で STDOUT に出力されます。
+TITLE が指定されない場合、デフォルトは "timethis COUNT" です。
+STYLE は出力形式で、後述する timestr() に記述されています。
=begin original
@@ -226,10 +228,10 @@
=end original
-The COUNT can be zero or negative: this means the I<minimum number of
-CPU seconds> to run. A zero signifies the default of 3 seconds. For
-example to run at least for 10 seconds:
-(TBT)
+COUNT はゼロや負数も指定できます: これは、実行する I<CPU 秒の最低値> を
+意味します。
+ゼロはデフォルトの 3 秒を意味します。
+例えば、最低 10 秒実行するには:
timethis(-10, $code)
@@ -239,8 +241,7 @@
=end original
-or to run two pieces of code tests for at least 3 seconds:
-(TBT)
+あるいは、2 つのコードの断片を最低 3 秒実行するには:
timethese(0, { test1 => '...', test2 => '...'})
@@ -254,12 +255,10 @@
=end original
-CPU seconds is, in UNIX terms, the user time plus the system time of
-the process itself, as opposed to the real (wallclock) time and the
-time spent by the child processes. Less than 0.1 seconds is not
-accepted (-0.01 as the count, for example, will cause a fatal runtime
-exception).
-(TBT)
+CPU 秒は UNIX 用語で、実(時計)時間や子プロセスで使われた時間ではなく、
+プロセス自身のユーザー時間にシステム時間を加えたものです。
+0.1 秒より小さい値は指定できません (例えば、もし COUNT として -0.01 を
+指定すると、致命的ランタイム例外が発生します)。
=begin original
@@ -271,7 +270,8 @@
=end original
-Note that the CPU seconds is the B<minimum> time: CPU scheduling and
+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
@@ -299,8 +299,8 @@
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.
-For each (KEY, VALUE) pair in the CODEHASHREF, this routine will
-call
+CODEHASHREF のそれぞれの (KEY, VALUE) ペアについて、このルーチンが
+呼び出されます
(TBT)
timethis(COUNT, VALUE, KEY, STYLE)
@@ -338,9 +338,8 @@
=end original
-Returns the difference between two Benchmark times as a Benchmark
-object suitable for passing to timestr().
-(TBT)
+二つの Benchmark 時間の差を、timestr() に渡すのに適した
+Benchmark オブジェクトで返します。
=item timestr ( TIMEDIFF, [ STYLE, [ FORMAT ] ] )
@@ -352,10 +351,10 @@
=end original
-Returns a string that formats the times in the TIMEDIFF object in
-the requested STYLE. TIMEDIFF is expected to be a Benchmark object
-similar to that returned by timediff().
-(TBT)
+TIMEDIFF オブジェクトの時間を要求された STYLE で整形した
+文字列を返します。
+TIMEDIFF は timediff() で返されるのと同様の
+Benchmark オブジェクトであることを想定しています。
=begin original
@@ -369,7 +368,8 @@
=end original
-STYLE can be any of 'all', 'none', 'noc', 'nop' or 'auto'. 'all' shows
+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
@@ -385,14 +385,16 @@
=end original
-FORMAT is the L<printf(3)>-style format specifier (without the
-leading '%') to use to print the times. It defaults to '5.2f'.
-(TBT)
+FORMAT は、時間を表示するために使われる L<printf(3)>-形式のフォーマット指定子
+(先頭の '%' 抜き)です。
+デフォルトは '5.2f' です。
=back
=head2 Optional Exports
+(追加エクスポート)
+
=begin original
The following routines will be exported into your namespace
@@ -413,8 +415,7 @@
=end original
-Clear the cached time for COUNT rounds of the null loop.
-(TBT)
+キャッシュされている、空ループを COUNT 回回した時間をクリアします。
=item clearallcache ( )
@@ -436,7 +437,8 @@
=end original
-Optionally calls timethese(), then outputs comparison chart. This:
+Optionally calls timethese(), then outputs comparison chart.
+これは:
(TBT)
cmpthese( -1, { a => "++\$i", b => "\$i *= 2" } ) ;
@@ -591,9 +593,9 @@
=end original
-Disable caching of timings for the null loop. This will force Benchmark
-to recalculate these timings for each new piece of code timed.
-(TBT)
+空ループのための時間のキャッシュを無効にします。
+これにより、Benchmark にコードの時間を計る毎に空ループの時間を
+再計算することを強制します。
=item enablecache ( )
@@ -605,10 +607,9 @@
=end original
-Enable caching of timings for the null loop. The time taken for COUNT
-rounds of the null loop will be calculated only once for each
-different COUNT used.
-(TBT)
+空ループのための時間のキャッシュを有効にします。
+異なる COUNT が使われる毎に 1 回だけ、COUNT 回の空ループの所要時間が
+計算されます。
=item timesum ( T1, T2 )
@@ -619,9 +620,8 @@
=end original
-Returns the sum of two Benchmark times as a Benchmark object suitable
-for passing to timestr().
-(TBT)
+二つの Benchmark 時間の和を、timestr() に渡すのに適した
+Benchmark オブジェクトで返します。
=back
@@ -866,12 +866,6 @@
=head1 AUTHORS
-=begin original
-
-Jarkko Hietaniemi <F<jhi****@iki*****>>, Tim Bunce <F<Tim.B****@ig*****>>
-
-=end original
-
Jarkko Hietaniemi <F<jhi****@iki*****>>, Tim Bunce <F<Tim.B****@ig*****>>
=head1 MODIFICATION HISTORY
@@ -970,5 +964,13 @@
time consistently with style argument, default is 'all' not 'noc' any more.
(TBT)
+=begin meta
+
+Translate: 吉村 寿人 <JAE00****@nifty*****>
+Update: Kentaro Shirakata <argra****@ub32*****> (1.10)
+License: GPL or Artistic
+
+=end meta
+
=cut