我正在使用 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. 它们是什么意思?