From: Austin Ziegler <halostatue@...>
Date: 2005-04-28T05:44:58+09:00
Subject: Rdoc constants annoyances...

I'm wondering if others are experiencing these and if you've found a
way around it.

1. Constants that are defined in different branches are repeated:

      module Foo
        if RUBY_PLATFORM =~ /win32/
          BAR = 'win32'
        else
          BAR = 'other'
        end
      end

   This will result in two copies of Foo::BAR being documented
*separately* (that is, separate lines in the rdoc generated HTML). I
want them merged. Optionally, I want to have a single documented
version and suppress the documentation of the rest.

2. Constant values are displayed, resulting in garbage. I have a large
hash presented as a constant. I want a document comment for the
constant, but I don't want the values presented in the document. It
takes up a lot of space, and I can present it far better than rdoc's
automated form could ever do. How do I suppress the constant value
printing?

-austin
-- 
Austin Ziegler * halostatue@gmail.com
               * Alternate: austin@halostatue.ca