title: How-To Phi Document Writing
author: YOSHIDA Kazuhiro
mailto: moriq@moriq.com

1.1. Phi ドキュメントの書き方

いまのところ，配布ファイルの中にはもりきゅうが書いたドキュメントしかありません。

Phi ドキュメントは，基本的に %c:$(Delphi5)\Help\del5vcl.hlp% を Phi に合わせて書き換えたものになっています。

実装されているメソッドがドキュメントに書いてなかったり，ドキュメントに書いてあるメソッドが実装されてなかったり，ドキュメントと実装が食い違っていたりといったことは，確実にあります。 ^^; そのような間違いが見つかったら，是非 ap-list にてご報告ください。すばやい対処を心がけます。

1.1.1. 設計時と実行時

Delphi Help では「設計時」「実行時」という言葉が使われます。これは， Delphi IDE での言葉です。

Delphi Help の意味では， Phi は常に実行時です。設計時に当てはまる状態としては，エディタ上で記述している状態が考えられますが， Delphi Help で使われている「設計時」は，コンポーネントを視覚的に操作することを含みますから， Phi にはあてはまらない記述が多く含まれています。このような記述は削除しています。

1.1.1. procedure 起源のメソッドの返り値

基本的に， procedure は返り値が nil の function とみなします。しかしながら， procedure 起源であってもいくつかのメソッドはさまざまな理由から self を返したり arg1 ( 第 1 引数 ) を返したりします。

1.1.1. Boolean

「 true もしくは false 」を返すメソッドがあります。

「 true もしくは false 」と書くのは面倒なので， Ruby には Boolean というクラスはありませんが「 Boolean 」と書くことにしました。
