Watch, Follow, &
Connect with Us
Public Report
Report From: Delphi-BCB/Compiler/Delphi/Other Compiler    [ Add a report in this area ]  
Report #:  80254   Status: Open
--doc switch for the Delphi compiler and generics
Project:  Delphi Build #:  14.0.3539.24502
Version:    14.0 Submitted By:   Maciej Izak
Report Type:  Basic functionality failure Date Reported:  12/10/2009 4:31:05 PM
Severity:    Commonly encountered problem Last Updated: 3/20/2012 2:24:39 AM
Platform:    All platforms Internal Tracking #:   273996
Resolution: None (Resolution Comments) Resolved in Build: : None
Duplicate of:  None
Voting and Rating
Overall Rating: No Ratings Yet
0.00 out of 5
Total Votes: None
Description
[AEC]
losing data when is generating the documentation for the generic types.
Steps to Reproduce:
Set "Generate XML Documentation" in project   options (or set switch --doc). Paste any code with generics, for example:

  {! These data will be lost }
  TSomeClass<T> = class
    /// These data will be ok (almost)
    procedure SomeProc(a: integer); virtual; abstract;
  end;

in the generated xml file is missing "devnotes" tags for the comment "These data will be lost". Another strange element is generating twice the tags for type "TSomeClass":

<class name="TSomeClass`1">

and

<class name="TSomeClass<T>">

(the second is missing, even "devnotes" for "SomeProc").
Workarounds
None
Attachment
None
Comments

None

Server Response from: ETNACODE01