summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorfukachan <fukachan>2001-04-23 14:33:54 +0000
committerfukachan <fukachan>2001-04-23 14:33:54 +0000
commit193f16fd4e9369b491330ae40568f6c91d6db523 (patch)
tree66d7342e5af19fc68acb573ea063ab9efedc5b8c
parentd1924da8fb827d37c620f6884360b7716e507611 (diff)
downloadfml8-193f16fd4e9369b491330ae40568f6c91d6db523.tar.gz
fml8-193f16fd4e9369b491330ae40568f6c91d6db523.tar.bz2
fml8-193f16fd4e9369b491330ae40568f6c91d6db523.zip
merge style idea to tutorial
-rw-r--r--fml/doc/ja/tutorial/fml-devel.sgml3
-rw-r--r--fml/doc/ja/tutorial/include.sgml4
-rw-r--r--fml/doc/ja/tutorial/programing_style.sgml (renamed from fml/doc/ja/htdocs/style.html)78
-rw-r--r--fml/doc/menubar.ja.html7
-rw-r--r--fml/doc/style.ja.html67
5 files changed, 55 insertions, 104 deletions
diff --git a/fml/doc/ja/tutorial/fml-devel.sgml b/fml/doc/ja/tutorial/fml-devel.sgml
index 333de248..71f0e7a6 100644
--- a/fml/doc/ja/tutorial/fml-devel.sgml
+++ b/fml/doc/ja/tutorial/fml-devel.sgml
@@ -6,7 +6,7 @@
This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above
to generate various output formats.
-$FML: fml-devel.sgml,v 1.2 2001/04/23 11:41:49 fukachan Exp $
+$FML: fml-devel.sgml,v 1.3 2001/04/23 14:14:01 fukachan Exp $
-->
<book>
@@ -60,6 +60,7 @@ $FML: fml-devel.sgml,v 1.2 2001/04/23 11:41:49 fukachan Exp $
<!-- 〜ここから後は付録〜 -->
+ <appendix id="programingstyle"> &programingstyle; </appendix>
<appendix id="terms"> &terms; </appendix>
<appendix id="docbook"> &docbook; </appendix>
diff --git a/fml/doc/ja/tutorial/include.sgml b/fml/doc/ja/tutorial/include.sgml
index e4c23675..1647cc95 100644
--- a/fml/doc/ja/tutorial/include.sgml
+++ b/fml/doc/ja/tutorial/include.sgml
@@ -7,7 +7,11 @@
<!entity intro SYSTEM "intro.sgml">
<!entity install SYSTEM "install.sgml">
<!entity bootloader SYSTEM "bootloader.sgml">
+<!entity programingstyle SYSTEM "programing_style.sgml">
<!entity reference SYSTEM "reference.sgml">
+
+
<!-- 画像 -->
<!entity architecture SYSTEM "architecture.gif" ndata gif>
+
diff --git a/fml/doc/ja/htdocs/style.html b/fml/doc/ja/tutorial/programing_style.sgml
index 39c89a6e..2a00206f 100644
--- a/fml/doc/ja/htdocs/style.html
+++ b/fml/doc/ja/tutorial/programing_style.sgml
@@ -1,67 +1,85 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<HTML>
-<HEAD>
<TITLE>
プログラミング・スタイル
</TITLE>
-<META http-equiv="Content-Type"
- content="text/html; charset=EUC-JP">
-</HEAD>
-<BODY BGCOLOR="#E6E6FA">
-<!-- ================== body =========================================== -->
-
-<CENTER>
+<para>
プログラミング・スタイル (原案のメモ(注: 単なる走り書き))
-</CENTER>
+</para>
-<P> <EM>基本的なスタイル</EM>
-<UL>
- <LI>
+<para>
+<itemizedlist>
+ <listitem>
+ <para>
+
Perl ではポリモーフィズムと実行時バインディングができることに
は重視すること。多重継承などに頭を使うより
ポリモーフィズムと実行時バインディングによる
コンポーネント指向ぽい方向性を模索する。
+ </para>
+
- <LI>
+ </listitem>
+
+ <listitem>
+ <para>
+
Perl 5 のパッケージを使った、オブジェクトぽい書き方は
変数自身が自分のパッケージを知っているので、
単にパッケージ修飾(例: :: )を使わなくてもよいくらいに
思う方がよい。
+ </para>
+
- <LI>
+ </listitem>
+
+ <listitem>
+ <para>
+
そのために、
再利用性と抽象度を高くしたインターフェイスは
オブジェクトぽい書きかたが良さそう。
+ </para>
+
- <LI>
+ </listitem>
+
+ <listitem>
+ <para>
+
perl 5 だと必然的にオブジェクトぽくなってしまうが、
オブジェクト、オブジェクト、オブジェクトし過ぎないように
バランス感覚に注意しよう。
+ </para>
+
- <LI>
+ </listitem>
+
+ <listitem>
+ <para>
+
他人のモジュールを使う場合はともかく、
自分達で書くモジュールでの
”深い”継承はできるだけ避けたい。
何でも深くすればよいというものではないでしょう。
-</UL>
-<P> <EM>メイン → モジュールの基本的な形の例:</EM>
+ </para>
+ </listitem>
+
+</itemizedlist>
+</para>
+
+
+<para>
libexec/ や libkern.pl にある関数は、
main:: に記述される部分は基本的なフローを記述している。
これらは基本的な枠組を示すものであるため、
$CurProc (C でいえば struct *curproc にあたるもの)
を受け渡す、構造化プログラミング的な書き方をしている。
- <PRE>
-
- </PRE>
+</para>
-<P> <EM>モジュール → モジュール </EM>
- <BR>
- しかし、そのひとつ下の層、そしてさらにその下では、
- 再利用性とポリモーフィズムに傾いた方がよさそうにおもえる。
-<!-- =================================================================== -->
-</BODY>
-</HTML>
+<para>
+ しかし、そのひとつ下の層、そしてさらにその下では、
+ 再利用性とポリモーフィズムに傾いた方がよさそうにおもえる。
+</para>
diff --git a/fml/doc/menubar.ja.html b/fml/doc/menubar.ja.html
index 843259f3..fc6d6197 100644
--- a/fml/doc/menubar.ja.html
+++ b/fml/doc/menubar.ja.html
@@ -78,7 +78,7 @@ fml5 (仮称) documents メニュー
</A>
<LI>
- <A HREF="../libexec/boot.ja.html" TARGET="right">
+ <A HREF="../../Documentation/ja/tutorial/bootloader.html" TARGET="right">
fml のブートの様子
</A>
@@ -126,11 +126,6 @@ fml5 (仮称) documents メニュー
</A>
<LI>
- <A HREF="style.ja.html" TARGET="right">
- プログラミングスタイル
- </A>
-
- <LI>
<A HREF="dirhier.ja.html" TARGET="right">
ディレクトリの階層構造
</A>
diff --git a/fml/doc/style.ja.html b/fml/doc/style.ja.html
deleted file mode 100644
index 39c89a6e..00000000
--- a/fml/doc/style.ja.html
+++ /dev/null
@@ -1,67 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<HTML>
-<HEAD>
-<TITLE>
-プログラミング・スタイル
-</TITLE>
-<META http-equiv="Content-Type"
- content="text/html; charset=EUC-JP">
-</HEAD>
-
-<BODY BGCOLOR="#E6E6FA">
-<!-- ================== body =========================================== -->
-
-<CENTER>
-プログラミング・スタイル (原案のメモ(注: 単なる走り書き))
-</CENTER>
-
-<P> <EM>基本的なスタイル</EM>
-<UL>
- <LI>
- Perl ではポリモーフィズムと実行時バインディングができることに
- は重視すること。多重継承などに頭を使うより
- ポリモーフィズムと実行時バインディングによる
- コンポーネント指向ぽい方向性を模索する。
-
- <LI>
- Perl 5 のパッケージを使った、オブジェクトぽい書き方は
- 変数自身が自分のパッケージを知っているので、
- 単にパッケージ修飾(例: :: )を使わなくてもよいくらいに
- 思う方がよい。
-
- <LI>
- そのために、
- 再利用性と抽象度を高くしたインターフェイスは
- オブジェクトぽい書きかたが良さそう。
-
- <LI>
- perl 5 だと必然的にオブジェクトぽくなってしまうが、
- オブジェクト、オブジェクト、オブジェクトし過ぎないように
- バランス感覚に注意しよう。
-
- <LI>
- 他人のモジュールを使う場合はともかく、
- 自分達で書くモジュールでの
- ”深い”継承はできるだけ避けたい。
- 何でも深くすればよいというものではないでしょう。
-</UL>
-
-<P> <EM>メイン → モジュールの基本的な形の例:</EM>
- libexec/ や libkern.pl にある関数は、
- main:: に記述される部分は基本的なフローを記述している。
- これらは基本的な枠組を示すものであるため、
- $CurProc (C でいえば struct *curproc にあたるもの)
- を受け渡す、構造化プログラミング的な書き方をしている。
- <PRE>
-
- </PRE>
-
-<P> <EM>モジュール → モジュール </EM>
- <BR>
- しかし、そのひとつ下の層、そしてさらにその下では、
- 再利用性とポリモーフィズムに傾いた方がよさそうにおもえる。
-
-
-<!-- =================================================================== -->
-</BODY>
-</HTML>