On Thu, 7 Aug 2003 01:25:47 +1000, Gavin Sinclair wrote:
> On Tuesday, August 5, 2003, 12:38:20 AM, Austin wrote:
>> It is *not* clear what will happen if there are multiple, conflicting
>> :main: tags (if you're generating the documentation for all of net/* at
>> once). Then again, I don't ever use file-level documentation.
> It is meaningless to have one :title: and/or :main: per file and then
> RDoc the whole directory. I think RDoc ignores it, albeit with a warning.
That's not bad, then.
As I mentioned: I don't tend to use or like "file-level" documentation,
preferring class-level documentation. I can see the point for some things,
but not others.
-austin
--
austin ziegler * austin@xxxxxxxxxxxxx * Toronto, ON, Canada
software designer * pragmatic programmer * 2003.08.06
* 19.46.21
|
