[Mono-bugs] [Bug 82006][Min] Changed - gmcs doesn't like generic types in XML comments

bugzilla-daemon at bugzilla.ximian.com bugzilla-daemon at bugzilla.ximian.com
Sun Aug 26 20:23:41 EDT 2007


Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

Changed by brian.nickel at gmail.com.

http://bugzilla.ximian.com/show_bug.cgi?id=82006

--- shadow/82006	2007-07-18 06:45:38.000000000 -0400
+++ shadow/82006.tmp.8622	2007-08-26 20:23:41.000000000 -0400
@@ -1,13 +1,13 @@
 Bug#: 82006
 Product: Mono: Compilers
 Version: 1.0
 OS: unknown
 OS Details: 
-Status: RESOLVED   
-Resolution: FIXED
+Status: REOPENED   
+Resolution: 
 Severity: Unknown
 Priority: Minor
 Component: C#
 AssignedTo: atsushi at ximian.com                            
 ReportedBy: brian.nickel at gmail.com               
 QAContact: mono-bugs at ximian.com
@@ -37,6 +37,23 @@
   <see
 cref="T:#$%>" />
 works i.e. nothing is checked when T: (or whatever x:) is specified.
 
 ------- Additional Comments From atsushi at ximian.com  2007-07-18 06:45 -------
 Fixed in svn.
+
+------- Additional Comments From brian.nickel at gmail.com  2007-08-26 20:23 -------
+I'm still having trouble compiling with: ListBase{string} and
+ListBase&lt;string&gt;
+
+According to the C# 3.0 (and I would assume 2.0) specification:
+
+The cref attribute can be attached to any tag to provide a reference
+to a code element. The documentation generator must verify that this
+code element exists. If the verification fails, the documentation
+generator issues a warning. When looking for a name described in a
+cref attribute, the documentation generator must respect namespace
+visibility according to using statements appearing within the source
+code. For code elements that are generic, the normal generic syntax
+(ie “List<T>”) cannot be used because it produces invalid XML. Braces
+can be used instead of brackets (ie “List{T}”), or the XML escape
+syntax can be used (ie “List&lt;T&gt;”).


More information about the mono-bugs mailing list