>> This could be caused by the :nodoc: I have on Kernel in lib/yaml.rb.  Is
>> this causing destruction of Kernel docs generated elsewhere?  How do I
>> get RDoc to add docs for Kernel::y, but avoid overwriting the Kernel
>> definition itself?  Maybe JEGII or Gavin knows more?
>
>The only way I could answer is to try some techniques on a small test
>piece of code.  The question is not amenable to mere knowledge :)

module Foo
  # this is bar method
  def bar
		
  end
end

module Foo # :nodoc:
  # this is baz method
  def baz
		
  end
end

//////////////////

I feel it's reasonable if :nodoc: prevents document generation
in second module block only. (but I'm not familier with rdoc,
so maybe this is functionality...)