foo_attr.rb

class Foo
  # @overload foo
  #   @return [FooObject]
  # @overload foo=(value)
  #   @param [String] value something with value
  #   @return [void]
  attr_accessor :foo

  # (don't document here)
  def foo=(val)
  end
end