www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 194] New: DDoc: method-attributes ignored within templated class

reply d-bugmail puremagic.com writes:

           Summary: DDoc: method-attributes ignored within templated class
           Product: D
           Version: unspecified
          Platform: PC
        OS/Version: Windows
            Status: NEW
          Severity: major
          Priority: P2
         Component: DMD
        AssignedTo: bugzilla digitalmars.com
        ReportedBy: someidiot earthlink.net

DDoc usually respects method attributes with a class, ensuring that private
methods are not emitted, abstract methods are noted as such, and so on. 

This does not happen within a templated class: all methods are emitted
regardless, and keywords such as abstract, protected, private, etc are all
supressed from the output.

Marked as 'major' because the generated doc is simply invalid.

Jun 14 2006
parent d-bugmail puremagic.com writes:

------- Comment #1 from bugzilla digitalmars.com  2008-06-17 03:01 -------
I agree this is a bug. This is not an excuse, but an explanation: By the time
Ddoc runs, class members have been semantically analyzed, and so Ddoc knows
what attributes go with the class members. For class templates, however, they
don't get analyzed until they are instantiated, so when Ddoc looks at it the
attributes have not been computed yet. That's why they're absent.

Jun 17 2008