[perldocjp-cvs 284] CVS update: docs/perl/5.10.0

アーカイブの一覧に戻る

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
 


perldocjp-cvs メーリングリストの案内
アーカイブの一覧に戻る