ruby - 如何为使用 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

在您的情况下，您会执行以下操作：

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

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

等等。