diff options
Diffstat (limited to 'fml/doc/ja/tutorial/internals/style.sgml')
| -rw-r--r-- | fml/doc/ja/tutorial/internals/style.sgml | 36 |
1 files changed, 21 insertions, 15 deletions
diff --git a/fml/doc/ja/tutorial/internals/style.sgml b/fml/doc/ja/tutorial/internals/style.sgml index b499b393..1e6acacd 100644 --- a/fml/doc/ja/tutorial/internals/style.sgml +++ b/fml/doc/ja/tutorial/internals/style.sgml @@ -1,5 +1,5 @@ <!-- - $FML: style.sgml,v 1.13 2004/10/06 09:07:40 fukachan Exp $ + $FML: style.sgml,v 1.14 2005/06/25 15:11:35 fukachan Exp $ --> @@ -9,13 +9,13 @@ </TITLE> <para> -ここでは、プログラミング上のいくつかの諸問題についてまとめます。 +本章は、プログラミング・スタイルに関する諸問題についてのメモです。 </para> <para> -FML.ORG のソフトウエアのコーディングスタイルについては +FML.ORG のソフトウエア・コーディング・スタイルの詳細は <ulink url="http://www.fml.org/software/FNF/"> -FNF +FNF (FML.ORG Natural Form) </ulink> を参照して下さい。 </para> @@ -29,19 +29,24 @@ FNF <para> default という単語をどこにはさむか？は悩ましいです。 -一番左に来る（たいてはい最初の _ までの）文字列部分は、 -大きな括りでのクラスを意味すると考えられます。 </para> <para> -たとえば article_* であれば記事関連の変数が全て article_ 以下に -定義されていると期待するでしょう。 +一般に、一番左に来る（たいてはい最初の _ までの）文字列部分は、 +大きな”くくり”でのクラスを意味すると考えられます。 </para> <para> -そう考えると、我々の場合は、default_* (つまり default クラスが存在する -と考える)より、「クラス_default_変数」ないしは「クラス_変数_default」 -というシンタックスの方が素直な分類方式のような気がします。 +たとえば article_* であれば記事関連の変数がすべて +article_* (article の右側に単語が続く変数群) +に定義されていると期待するでしょう。 +</para> + +<para> +そう考えると、 +default_* (つまり default クラスが存在すると考える)より、 +「クラス_default_変数」ないしは「クラス_変数_default」 +というシンタックスが素直に思えます。 </para> @@ -61,7 +66,7 @@ mail は「いわゆるメール」つまり messager/rfc822 形式のものです。 fml システムへ入力されるものも mail だし、出ていくものも mail です。 それらは mail から派生したサブクラスと考えられるため、 「PREFIX_mail_属性」形式に統一する方が良いでしょう。 -が、ものすごく厳密にやると、逆に、わけがわからないのでほどほどに。 +ただし、ものすごく厳密に行なうと、逆に、わけがわからないのでほどほどに。 </para> <para> @@ -182,7 +187,7 @@ use_変数 = yes か no var2 </screen> - </sect2> +</sect2> <sect2> @@ -193,7 +198,7 @@ use_変数 = yes か no <screen> プログラム_変数_属性 </screen> - </sect2> +</sect2> </sect1> @@ -265,6 +270,7 @@ Srting::is_japanese_string() <warning> <para> ログとして、原案のメモ(注: 単なる走り書き)をここに記録しておきます。 +読みづらいですが、失礼。 </para> </warning> @@ -309,7 +315,7 @@ Srting::is_japanese_string() <listitem> <para> - perl 5 だと必然的にオブジェクトぽくなってしまうが、 + Perl 5 だと必然的にオブジェクトぽくなってしまうが、 オブジェクト、オブジェクト、オブジェクトし過ぎないように バランス感覚に注意しよう。 </para> |