如何為使用class_eval定義的方法添加RDoc文檔？

Question

我使用class_eval來更簡潔地定義一堆重復的方法，如下所示：

%w{greasy chunky bacon}.product(%w{flying sky poodle}).each do |a,b|
  class_eval "def #{a}_#{b}; do_something; end"
end

我希望所有生成的方法都包含在RDoc文檔中。 是否有RDoc指令“手動”將方法添加到類的方法列表中？ 我找不到一個。

Answer 1

請參閱RDoc::Parser::Ruby的RDoc文檔中的元編程方法和隱藏方法及屬性部分。

在你的情況下，你會做類似的事情：

##
# :method: greasy_flying
# Makes grease fly.

##
# :method: chunky_poodle
# This is a really gruesome method. Ewww!

等等。