Documenting attributes with Rdoc

Hello all,

I have written a Lib here that parses Flac files for information, and as
the ‘important’ stuff is written to various attributes I want to
document
their data structure, as some of them are quite complex and require
explanation. I cannot figure out how to get Rdoc to work with them.

I have them all in an attr_reader, and Rdoc finds them and puts an [R]
next to
them which I presume indicates they are readonly. That’s all good but
when I
add some documentation above the attr_reader Rdoc adds the same text to
all 8
of my attributes.

I thought that I would trying creating the attributes the long way, ie:

def foo
@foo
end

and document them that way, but when I do this Rdoc lumps them under
instance
methods, which is of course technically correct but I don’t want that, I
want
them listed under attributes.

How can I do this? Should I just document them under the main package
description?

thanks,
-d

On Sep 18, 2006, at 2:11 PM, darren kirby wrote:

How can I do this?

Docs for one…

attr_reader :one

Docs for two…

attr_reader :two

Etc…

Hope that helps.

James Edward G. II

quoth the James Edward G. II:

James Edward G. II

That’s perfect!

Thanks James,
-d