青木です。

  In mail "[ruby-reference-manual:173] obsolete and deprecated methods"
  sheepman <sheepman@s...> wrote:

> こんにちは、sheepmanです。
> 
> obsolete だったり deprecated だったりするメソッドも
> エントリーに含めるのでしょうか。

はい。正式な API である、または API であったメソッドはすべて
含めてください。ひらたく言うと、public メソッドとモジュール
関数、定数はすべて書くということです。

例外としては、自分の書いたのから例を挙げると、FileUtils の
fu_world_writable などです。このメソッドはモジュール内部だけ
で使うことを想定しており、ユーザが呼び出すことは考えていません。
まあようするに private メソッドみたいなもんですね。そういう
事情が明らかな場合は含めなくて構いません。

それから、開発版で新しく追加されたものの、すぐになくなることが
決まっているようなメソッドも書く必要はありません。

--
青木峰郎

--
ML: ruby-reference-manual@m...
使い方: http://QuickML.com/