YARD question: Documenting multiple attr_reader

gistfile1.rb

# This works:

# @return [String] This is attribute #1
attr_reader :attr1

# @return [Object] This is attribute #2
attr_reader :attr2

# But this won't:

# @attr_reader [String] attr1 This is attribute #1
# @attr_reader [Object] attr2 This is attribute #2
attr_reader :attr1, :attr2

This can now be done using the @!attribute directive:

# @!attribute [r] name
#   @return [String] The person's full name
#
# @!attribute [r] date_of_birth
#   @return [Date] The person's date of birth
class Person
  attr_reader :name, :date_of_birth

  def initialize(name, date_of_birth)
    @name = name
    @date_of_birth = date_of_birth
  end
end