Example of using @method

example_rdoc.rb

module Stuff
  def create_dynamic_method
  end
end

class Foo
  extend Stuff
  # Tells you what is static
  #
  # @method static_method
  # @return [String]
  def static_method
    'static'
  end

  # Tells you what is dynamic
  #
  # @method dynamic_method
  # @return [String]
  create_dynamic_method :dynamic_method
end

That Ruby, will create RDoc that looks like this...

https://img.skitch.com/20111102-692wm4pw716n9eq1a76u9ee5h.jpg