RDoc has a number of subtle bugs relating to the order in which it processes files. The biggest reason for this is
that class/module structures are duplicated under each top level in which they are encountered. A better system would
have one class structure that is referenced from each top level.
For example, if RDoc sees:
def Foo.bar
end
in one file and
class Foo
end
in another, the first file will have a Foo module and the second will have a Foo class. This does get exposed by the
standard library, because classes often are defined across several C files. |
