ドキュメントを生成する前にRDocをアップデートする場合は、
re RDocのアップデート - 祈れ、そして働け 〜 Ora et labora
とりあえず生成してみる
$ rdoc
.rbファイルがあるディレクトリに移動して、rdocコマンドを実行します。RDocを意識したマークアップをしていなくても、ソースコードとコメントを解析して、使えるドキュメントを生成してくれます。もしまったくコメントがなかった（マイガ!!）としても、ソースコードをからそれなりのドキュメントを生成してくれます。ドキュメントはカレントディレクトリに作成されたdocディレクトリに格納されます。
オプションを指定する
$ rdoc -c UTF-8 -t "Sample RDoc Document" -m README.rdoc
私がよく使うオプションの組み合わせです。
$ rdoc -c <文字コード> -t <タイトル> -m <デフォルトのページ> <対象ファイル>
対象ファイルにはドキュメントを生成する.rbファイルを指定します。ディレクトリを指定すれば、そのディレクトリ以下のすべての.rbファイルが対象になります。省略するとカレントディレクトリ以下のすべての.rbファイルが対象になります。
オプションの意味は次の通りです。
| -c <文字コード> | --charset=<文字コード> | 生成するHTMLの文字コードを指定します。ソースファイルの文字コードと同じものを指定してください。 |
|---|---|---|
| -t <タイトル> | --title=<タイトル> | 生成するHTMLのページタイトルを指定します。 |
| -m <デフォルトのページ> | --main=<デフォルトのページ> | スタートページを指定します。ファイル名かクラス名を指定してください。 |
その他に、次のようなオプションもあります。
| -a | --all | プライベートメソッドもドキュメントの対象に加えます。 |
|---|---|---|
| -e | --encoding=<文字コード> | 生成するHTMLの文字コードを指定します。ソースファイルの文字コードを、読み込み時に指定された文字コードに変換します。--charsetと同時に指定された場合は--encodingが優先されます。 |
| -w <タブ幅> | --tab-width=<タブ幅> | タブ幅を指定します。 |
| -N | --line-numbers | ソースコードに行番号を含める、らしいのですが、指定しても違いがないため、指定していません。 |
