ruby - Ruby/Rdoc 中的“未记录”常量

Question

以下代码被剪断：

# ansi console color constants
COLOR_BLACK = 0
COLOR_RED = 1
COLOR_GREEN = 2
COLOR_YELLOW = 3
COLOR_BLUE = 4
COLOR_MAGENTA = 5
COLOR_CYAN = 6
COLOR_WHITE = 7

# functional color aliases
COLOR_WARN = COLOR_YELLOW
COLOR_ALERT = COLOR_RED
COLOR_CONFIRM = COLOR_GREEN
COLOR_NOTE = COLOR_BLUE

被报告为 10 个未记录的常量。有没有办法在 RDoc 中“按组注释常量”？单独记录每个常量会有点愚蠢，我不想从 doc.xml 中省略它们。

Answer 1

在我建议实施一个:constlist:指令后，我从一个 rdoc 开发人员的每封邮件中得到以下答案，该指令将被COLOR_BLACK = 0简单地记录为COLOR_BLACK(0)：

我会看看我能做什么，但我可能无法将它添加到 RDoc 4.0，因为我的时间有限。

我想我可以通过使用单独的指令将常量放在一个部分（内部）中来完成这项工作，该指令也将它们标记为用于覆盖报告的记录。