argra****@users*****
argra****@users*****
2011年 2月 7日 (月) 22:37:13 JST
Index: docs/perl/5.12.1/perlpodspec.pod diff -u docs/perl/5.12.1/perlpodspec.pod:1.2 docs/perl/5.12.1/perlpodspec.pod:1.3 --- docs/perl/5.12.1/perlpodspec.pod:1.2 Wed Sep 8 05:15:02 2010 +++ docs/perl/5.12.1/perlpodspec.pod Mon Feb 7 22:37:12 2011 @@ -3050,6 +3050,8 @@ =head1 About =over...=back Regions +(=over...=back 領域について) + =begin original "=over"..."=back" regions are used for various kinds of list-like @@ -3058,8 +3060,8 @@ =end original -"=over"..."=back" regions are used for various kinds of list-like -structures. (I use the term "region" here simply as a collective +"=over"..."=back" 領域は、様々な種類のリスト風の構造に使われます。 +(I use the term "region" here simply as a collective term for everything from the "=over" to the matching "=back".) (TBT) @@ -3138,11 +3140,10 @@ =end original -An "=over" ... "=back" region containing only "=item *" commands, -each followed by some number of ordinary/verbatim paragraphs, other -nested "=over" ... "=back" regions, "=for..." paragraphs, and -"=begin"..."=end" regions. -(TBT) +"=item *" 段落および、 +通常の段落、そのままの段落、ネストした +"=over" ... "=back" 領域、"=for..." 段落、"=begin"..."=end" コード +のいずれかが任意の数引き続いたもののみからなる "=over" ... "=back" 領域。 =begin original @@ -3153,11 +3154,11 @@ =end original -(Pod processors must tolerate a bare "=item" as if it were "=item -*".) Whether "*" is rendered as a literal asterisk, an "o", or as -some kind of real bullet character, is left up to the Pod formatter, -and may depend on the level of nesting. -(TBT) +(Pod プロセッサは、生の "=item" を、"=item *" であるかのように +扱わなければなりません。) +"*" をそのままアスタリスクとして表示するか、"o" を使うか、あるいは +ある種の実際の黒丸を使うかは Pod フォーマッタに任されていて、 +これはネストレベルに依存するかも知れません。 =item * @@ -3173,14 +3174,12 @@ =end original -An "=over" ... "=back" region containing only -C<m/\A=item\s+\d+\.?\s*\z/> paragraphs, each one (or each group of them) -followed by some number of ordinary/verbatim paragraphs, other nested -"=over" ... "=back" regions, "=for..." paragraphs, and/or -"=begin"..."=end" codes. Note that the numbers must start at 1 -in each section, and must proceed in order and without skipping -numbers. -(TBT) +C<m/\A=item\s+\d+\.?\s*\z/> 段落および、 +通常の段落、そのままの段落、ネストした +"=over" ... "=back" 領域、"=for..." 段落、"=begin"..."=end" コード +のいずれかが任意の数引き続いたもののみからなる "=over" ... "=back" 領域。 +各章の番号は 1 から始まり、省略されることなく続かなければならないことに +注意してください。 =begin original @@ -3189,9 +3188,8 @@ =end original -(Pod processors must tolerate lines like "=item 1" as if they were -"=item 1.", with the period.) -(TBT) +(Pod プロセッサは、"=item 1" のような行を、ピリオド付きの +"=item 1." であるかのように扱わなければなりません。) =item * @@ -3204,11 +3202,10 @@ =end original -An "=over" ... "=back" region containing only "=item [text]" -commands, each one (or each group of them) followed by some number of -ordinary/verbatim paragraphs, other nested "=over" ... "=back" -regions, or "=for..." paragraphs, and "=begin"..."=end" regions. -(TBT) +"=item [text]" 段落および、 +通常の段落、そのままの段落、ネストした +"=over" ... "=back" 領域、"=for..." 段落、"=begin"..."=end" コード +のいずれかが任意の数引き続いたもののみからなる "=over" ... "=back" 領域。 =begin original