argra****@users*****
argra****@users*****
2012年 12月 19日 (水) 03:50:41 JST
Index: docs/modules/version-0.77/version/Internals.pod
diff -u docs/modules/version-0.77/version/Internals.pod:1.1 docs/modules/version-0.77/version/Internals.pod:1.2
--- docs/modules/version-0.77/version/Internals.pod:1.1 Thu Dec 6 00:52:42 2012
+++ docs/modules/version-0.77/version/Internals.pod Wed Dec 19 03:50:41 2012
@@ -9,8 +9,7 @@
=end original
-version::Internal - Perl extension for Version Objects
-(TBT)
+version::Internal - バージョンオブジェクトのための Perl エクステンション
=head1 DESCRIPTION
@@ -25,14 +24,15 @@
最近の全てのバージョンの Perl 用のオーバーロードされた
バージョンオブジェクト。
-This documents
-the internal data representation and underlying code for version.pm. See
-L<version.pod> for daily usage. This document is only useful for users
-writing a subclass of version.pm or interested in the gory details.
-(TBT)
+これは version.pm の内部データ表現と内在するコードについて文書化しています。
+普段の使用については L<version.pod> を参照してください。
+この文書は version.pm のサブクラスを書いたり内部の詳細に関心のある人にのみ
+有用です。
=head1 What IS a version
+(バージョンって何?)
+
=begin original
For the purposes of this module, a version "number" is a sequence of
@@ -99,8 +99,7 @@
使われているものです。
エクスポートされた L<qv()> 関数を使用すると、この種のバージョン
オブジェクトが生成されます。
-A leading 'v' character is now required and will warn if it missing.
-(TBT)
+先頭の 'v' 文字は今では必須であり、なければ警告されます。
=back
@@ -193,12 +192,10 @@
=end original
-IMPORTANT NOTE: As shown above, if your Decimal version contains more
-than 3 significant digits after the decimal place, it will be split on
-each multiple of 3, so 1.0003 is equivalent to v1.0.300, due to the need
-to remain compatible with Perl's own 5.005_03 == 5.5.30 interpretation.
-Any trailing zeros are ignored for mathematical comparison purposes.
-(TBT)
+重要な注意: 上述したように、10 進数バージョンで小数点の後に 3 桁を超える
+有効数字がある場合、3 桁毎に分割されるので、1.0003 は v1.0.300 と等価です;
+Perl 自身の 5.005_03 == 5.5.30 の解釈と互換性を維持するためです。
+数値比較のために末尾の 0 は無視されます。
=head2 Dotted-Decimal Versions
@@ -313,8 +310,12 @@
=head1 High level design
+(高レベルデザイン)
+
=head2 version objects
+(バージョンオブジェクト)
+
version.pm provides an overloaded version object that is designed to both
encapsulate the author's intended $VERSION assignment as well as make it
completely natural to use those objects as if they were numbers (e.g. for
@@ -929,13 +930,11 @@
=end original
-IMPORTANT NOTE: There is one exceptional cases shown in the above table
-where the "initializer" is not stringwise equivalent to the stringified
-representation. If you use the C<qv()> operator on a version without a
-leading 'v' B<and> with only a single decimal place, the stringified output
-will have a leading 'v', to preserve the sense. See the L<qv()> operator
-for more details.
-(TBT)
+重要な注意: 上述の表には「初期化子」が文字列化表現と文字列的に等価でない
+一つの例外があります。
+先頭の 'v' なし B<かつ> 小数点一つだけのバージョンで C<qv()> 演算子を
+使うと、文字列化出力は意味を保存するために先頭に 'v' が付きます。
+さらなる詳細については L<qv()> 演算子を参照してください。
=begin original
@@ -945,10 +944,8 @@
=end original
-IMPORTANT NOTE 2: Attempting to bypass the normal stringification rules by
-manually applying L<numify()> and L<normal()> will sometimes yield
-surprising results:
-(TBT)
+重要な注意 2: 手動で L<numify()> と L<normal()> を適用することで通常の
+文字列化規則を回避しようとすると、時々驚くべき結果になります:
print version->new(version->new("v1.0")->numify)->normal; # v1.0.0
@@ -960,10 +957,10 @@
=end original
-The reason for this is that the L<numify()> operator will turn "v1.0"
-into the equivalent string "1.000000". Forcing the outer version object
-to L<normal()> form will display the mathematically equivalent "v1.0.0".
-(TBT)
+この理由は、L<numify()> 演算子は "v1.0" を等価な文字列 "1.000000" に
+変えるからです。
+外側のバージョンオブジェクトの L<normal()> 形式への矯正は数値的に等価な
+"v1.0.0" が表示されます。
=begin original
@@ -972,9 +969,8 @@
=end original
-As the example in L<new()> shows, you can always create a copy of an
-existing version object with the same value by the very compact:
-(TBT)
+L<new()> の例が示しているように、いつでも既に存在するバージョン
+オブジェクトと同じ値でとても小さなコピーを作ることができます:
$v2 = $v1->new($v1);
@@ -985,9 +981,7 @@
=end original
-and be assured that both C<$v1> and C<$v2> will be completely equivalent,
-down to the same internal representation as well as stringification.
-(TBT)
+そして C<$v1> と C<$v2> は内部表現から文字列化に至るまで完全に等価です。
=back
@@ -1256,6 +1250,8 @@
=head1 EXPORT
+(エクスポート)
+
=begin original
qv - Dotted-Decimal Version initialization operator
@@ -1276,7 +1272,7 @@
Translate: Kenji Inoue <kenz****@oct*****> (0.70)
Update: SHIRAKATA Kentaro <argra****@ub32*****> (0.74-)
-Status: in progress
+Status: completed
=end meta