RDocに使用を試みましたが、
どうもうまくいきません。
最新に近い3.xを使うと、UTF-8で書いたコードが出力されません。
仕方がないので、一度Shift-JISに変換してからrdocにかけるスクリプトを書いたのですが、
これも妙に苦労する羽目になりました。
なぜBOMがついているものが混ざっているのか。
本来はつくはずがないものなので、Ruby側としては、そんなものはUTF-8じゃないから読めません、ということらしいです。
BOMなしで保存するしかないみたいですね。
そもそも、一度変換してからなどという方法でよいものかどうか。
もっと良い方法があっていいとは思うのですが。
なんかいい方法ないですかね。