Too much spoils, too little does not satisfy

[gogotanaka]

Hi everyone at rdoc.

If there is anything wrong or this issue was already discussed, I'm so sorry.

Anyway, please look at this.

# This doc isn't generated.
define_method('foo1') do 
end

# This doc is generated.
def foo2; end if false

But I expect it should be .. ↓

# This doc should be generated.
define_method('foo1') do 
end

# This doc should not be generated.
def foo2; end if false

Is there any reason or difficult to do that?

I would appreciate it if you could tell me when you have a time.

Thank you.

[gogotanaka]

Actually, most people doesn't do like that...!

def foo2; end if false

[nobu]

If I write it, I would not expect the doc is generated.

[gogotanaka]

@nobu Thank you for reply, sorry for my poor English ...

I expect ...

# This doc should be generated.
define_method('foo1') do 
end

# This doc should not be generated.
def foo2; end if false

But current rdoc do the opposite of that↑.

Thank you.

[zzak]

This is because dynamic methods are not documentable in rdoc, so we must trick rdoc into thinking this method exists and documented here.

It would be nice to have dynamic methods as documentable, but rdoc doesn't yet know how. Please help teach RDoc how to read them if you'd like this ability.

[drbrain]

RDoc could learn define_method but if false is beyond RDoc's capability.

[gogotanaka]

@zzak @drbrain I'm so sorry for the delay. Actually it seems challenging and interesting staff, ok I'm gonna start to read you guys awesome codes at first. thanks.