argra****@users*****
argra****@users*****
2008年 6月 26日 (木) 04:06:02 JST
Index: docs/perl/5.10.0/perlstyle.pod diff -u docs/perl/5.10.0/perlstyle.pod:1.1 docs/perl/5.10.0/perlstyle.pod:1.2 --- docs/perl/5.10.0/perlstyle.pod:1.1 Thu May 29 03:37:28 2008 +++ docs/perl/5.10.0/perlstyle.pod Thu Jun 26 04:06:01 2008 @@ -450,11 +450,11 @@ =end original -C<$gotit> のような短い識別子なら ok ですが、 in longer identifiers 単語を +C<$gotit> のような短い識別子なら ok ですが、より長い識別子の単語を 区切るにはアンダースコアを使用してください。 -一般的には、とくに英語のネイティブスピーカーでない人にとっては、C<$var_names_like_this> の方が C<$VarNamesLikeThis> より読みやすいです。 +一般的には、とくに英語のネイティブスピーカーでない人にとっては、 +C<$var_names_like_this> の方が C<$VarNamesLikeThis> より読みやすいです。 このルールは C<VAR_NAMES_LIKE_THIS> についても同様に当てはまります。 -(TBT) =begin original @@ -647,9 +647,9 @@ =end original -Try to document your code and use Pod formatting in a consistent way. Here -are commonly expected conventions: -(TBT) +あなたのコードを文書化して、一貫した方法で Pod フォーマットを使うように +努力してください。 +以下は広く想定されている慣習です: =over 4 @@ -664,11 +664,11 @@ =end original -use C<CE<lt>E<gt>> for function, variable and module names (and more -generally anything that can be considered part of code, like filehandles -or specific values). Note that function names are considered more readable -with parentheses after their name, that is C<function()>. -(TBT) +関数名、変数名、モジュール名(およびより一般的には、ファイルハンドルや +特定の値のような、コードの一部と考えられるもの)には C<CE<lt>E<gt>> を +使ってください。 +関数名は、C<function()> のように、名前の後ろにかっこを付けると +より読みやすくなると考えられています。 =item * @@ -678,8 +678,7 @@ =end original -use C<BE<lt>E<gt>> for commands names like B<cat> or B<grep>. -(TBT) +B<cat> や B<grep> のようなコマンド名には C<BE<lt>E<gt>> を使ってください。 =item * @@ -692,11 +691,11 @@ =end original -use C<FE<lt>E<gt>> or C<CE<lt>E<gt>> for file names. C<FE<lt>E<gt>> should -be the only Pod code for file names, but as most Pod formatters render it -as italic, Unix and Windows paths with their slashes and backslashes may -be less readable, and better rendered with C<CE<lt>E<gt>>. -(TBT) +ファイル名には C<FE<lt>E<gt>> か C<CE<lt>E<gt>> を使ってください。 +C<FE<lt>E<gt>> はファイル名のための唯一の Pod コードであるべきですが、 +ほとんどの Pod フォーマッタはこれをイタリック体で表示するため、 +Unix と Windows でパスに使われるスラッシュや逆スラッシュが読みにくいです; +C<CE<lt>E<gt>> はよりよく表示されます。 =back
