[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
Mon Aug 27 04:38:50 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-08-27 00:14:20.000000000 -0400
+++ shadow/82006.tmp.18427	2007-08-27 04:38:50.000000000 -0400
@@ -1,13 +1,13 @@
 Bug#: 82006
 Product: Mono: Compilers
 Version: 1.0
 OS: unknown
 OS Details: 
-Status: RESOLVED   
-Resolution: NOTABUG
+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
@@ -60,6 +60,47 @@
 
 ------- Additional Comments From atsushi at ximian.com  2007-08-27 00:14 -------
 Annex E. is just an informative section that we do not have to follow,
 so it is not a bug. I already wrote that without 'T:' it won't work
 (it is about csc. The msdn blog post or your interpretation of it is
 wrong).
+
+------- Additional Comments From brian.nickel at gmail.com  2007-08-27 04:38 -------
+Okay, I did a bit of testing on this, and it appears that csc has the
+following behavior. cref="IList{System.String}" == ERROR,
+cref="IList{T}" == SUCCESS. If the bad CREF is encountered, it will
+emit two warnings, CS1574 and CS1658.
+
+The following shows the difference between csc and gmcs behavior.
+
+Comment Line: /// <returns>A <see cref="IList&lt;System.String&gt;"
+/>.</returns>
+csc result:   CS1574 & CS1658
+
+gmcs result:  CS1584
+csc output:   <returns>A <see
+cref="!:IList&lt;System.String&gt;"/>.</returns>
+gmcs output:  <returns>A <see cref="!:IList&lt;System.String&gt;"
+/>.</returns>
+
+Comment Line: /// <returns>A <see cref="IList&lt;Foobar&gt;" />.</returns>
+csc result:   Success
+gmcs result:  CS1584
+csc output:   <returns>A <see
+cref="T:System.Collections.Generic.IList`1"/>.</returns>
+gmcs output:  <returns>A <see cref="!:IList&lt;Foobar&gt;" />.</returns>
+
+Comment Line: /// <returns>A <see cref="IList{System.String}"
+/>.</returns>
+csc result:   CS1574 & CS1658
+
+gmcs result:  CS1584
+csc output:   <returns>A <see
+cref="!:IList&lt;System.String&gt;"/>.</returns>
+gmcs output:  <returns>A <see cref="!:IList{System.String}" />.</returns>
+
+Comment Line: /// <returns>A <see cref="IList{Foobar}" />.</returns>
+csc result:   Success
+gmcs result:  CS1584
+csc output:   <returns>A <see
+cref="T:System.Collections.Generic.IList`1"/>.</returns>
+gmcs output:  <returns>A <see cref="!:IList{Foobar}" />.</returns>


More information about the mono-bugs mailing list