0

我正在使用 RDoc 为我的 Ruby on Rails 3.0.7 应用程序编写文档。在应用程序lib文件夹中,我有以下内容:

module ModuleName
  class ModuleName::User < ActiveRecord::Base
    #'CONSTANT' documentation text
    CONSTANT = 'Test constant'

    #'method_name' documentation text
    def method_name
      ...
    end
  end
end

当我尝试为上面的代码生成文档时,RDoc 不会解析#'CONSTANT' documentation text#'method_name' documentation text,所以输出文档是空白的。

1.如何让RDoc考虑模块“上下文”中的注释代码?

如果我:doc:按如下方式使用指令,这将无济于事:

module ModuleName #:doc:
  class ModuleName::User < ActiveRecord::Base #:doc:
    #'CONSTANT' documentation text
    CONSTANT = 'Test constant' #:doc:

    #'method_name' documentation text
    def method_name #:doc:
      ...
    end
  end
end

我注意到我在Class\Module Index中有这些:

ModuleName
ModuleName::ModuleName
ModuleName::ModuleName::ModuleName
ModuleName::ModuleName::ModuleName::User

2. 它们是什么意思?

4

0 回答 0