[Issue 2609] No documentation generated for destructor

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=2609



--- Comment #4 from Don <clugdbug at yahoo.com.au> 2010-03-29 13:08:33 PDT ---
(In reply to comment #3)
> The documentation for those functions should not be part of their interface
> presented to the user. That's why doc isn't generated for them.
> 
> It was a deliberate choice, not a bug. I'll mark it as an enhancement request.

I think that's a reasonable decision, but the spec should state that doc isn't
generated for them.

Eg, after:

If there is no documentation comment for a declaration, that declaration may
not appear in the output. To ensure it does appear in the output, put an empty
declaration comment for it.
+ Declarations which are not an explicit part of the interface do not have
documentation generated for them. These include:
+ invariant
+ postblit
+ destructor
+ static constructors and destructors
+ class info, type info, and module info

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------