Japanese wording update.

Submitted by:Yoshiteru Kageyama <kageyama@cig.nml.mot.com>
This commit is contained in:
Kazuo Horikawa 2000-11-20 18:49:54 +00:00
parent 8f47e65ff3
commit fdfe349bc3
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=8399

View file

@ -23,7 +23,7 @@
.\" SUCH DAMAGE.
.\"
.\" %FreeBSD: src/share/man/man7/style.perl.7,v 1.12 2000/10/19 18:18:35 joe Exp %
.\" jpman %Id: style.perl.7,v 1.2 2000/11/11 10:39:45 mistral Chk %
.\" jpman %Id: style.perl.7,v 1.3 2000/11/20 01:08:57 yt-kage Stab %
.\"
.Dd October 16, 2000
.Dt STYLE.PERL 7
@ -52,7 +52,8 @@
.Ed
.Pp
全てのスクリプトにはスクリプトの先頭に著作権ブロックと、
そのスクリプトが何をするものなのかを記述したコメントブロックを置くべきです。
そのスクリプトが何をするものなのかを記述したコメントブロックを置くべき
です。
.Bd -literal -offset 0i
#!/usr/bin/perl -w
@ -64,7 +65,8 @@
.Ed
全てのスクリプトは
.Fa strict
モジュールを使用して警告なしに動作しなければいけません。例えば:
モジュールを使用して警告なしに動作しなければいけません。例えば、
次のようにします:
.Bd -literal -offset 0i
#!/usr/bin/perl -w
@ -102,7 +104,7 @@
}
.Ed
.Pp
全ての変数は使用する前に定義するべきです; これは
全ての変数は使用する前に定義するべきですこれは
.Fa use strict
下で利用する場合は強制されます。
.Pp
@ -114,16 +116,17 @@
.Va $variable
を用いるべきです。
.Fa local
宣言はそれが必要とされる場面にのみ使用し、デフォルトでは使用しないべきです。
たくさんの perl4 スクリプトは
宣言はそれが必要とされる場面にのみ使用し、デフォルトでは使用すべきでは
ありません。
たくさんの perl4 スクリプトでは、
.Fa my
定義が perl5 以前には存在しなかったという理由で
.Fa local
を使用しています。
.Pp
多くの場合グローバル変数はコードの先頭で
多くの場合グローバル変数はコードの先頭で
.Fa vars
定義ブロックを使用して定義するべきです:
定義ブロックを使用して定義するべきです:
.Bd -literal -offset 0i
use vars qw($globalscalar @globalarray %globalhash);
.Ed
@ -163,7 +166,7 @@
.Nm perl
.Ar -wcT
.Ar script.pl
を通過させてください。また警告が生成されてはいけません。
を通過させてください。そのとき、警告が生成されてはいけません。
.Pp
インデントは 8 文字のタブです。
第 2 レベルのインデントは 4 文字のスペースです。
@ -176,8 +179,10 @@
.Ed
.Pp
空白文字を行末に追加してはいけません。
また、インデントを形成するためには、タブとその後にスペースのみを使用します。
タブが生み出す以上のスペースや、タブの前のスペースは使用しません。
また、インデントを形成するために、スペースの前にはタブのみを使用して
ください。
タブが生み出す以上のスペースおよびタブの前にスペースを使用しては
いけません。
.Pp
ブレースの開始は制御行の最後に置かれます。
else と elsif は直前の if または elsif ブロックの終了ブレースと
@ -211,15 +216,16 @@ else
}
.Ed
.Pp
可能な場所ではスクリプトは標準モジュールを使用し、
コードをその場に展開してはいけません。
このことを促進するために CPAN モジュールを基本システム
取り込むことが適している場合があるかもしれません。
可能な場所ではスクリプトは標準モジュールを使用し、
コードをその場に書き直してはいけません。
このことを促進するために CPAN モジュールを基本システム
取り込むことが適している場合があるかもしれません。
.Pp
適切な所では、
.Fa chop
ではなく
.Fa chomp
を使用すべき場所ではそのようにしてください。
を使用してください。
.Pp
可読性が増す場合には
.Fa if (! ... )
@ -235,7 +241,7 @@ else
.Xr perlstyle 1 ,
.Xr style 9
.Sh 歴史
このマニュアルページは
このマニュアルページは
.Tn FreeBSD
.Xr style 9