[Mono-bugs] [Bug 79706][Wis] Changed - gmcs /doc doesn't like generic types

[bugzilla-daemon at bugzilla.ximian.com]

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 jonpryor at vt.edu.

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

--- shadow/79706	2006-10-20 10:40:12.000000000 -0400
+++ shadow/79706.tmp.7234	2006-10-20 10:46:51.000000000 -0400
@@ -132,6 +132,35 @@
 hindrence (those comments are too wide).
 
 ------- Additional Comments From jonpryor at vt.edu  2006-10-20 10:40 -------
 Created an attachment (id=17876)
 CSC.EXE /doc output of gendoc.cs
 
+
+------- Additional Comments From jonpryor at vt.edu  2006-10-20 10:46 -------
+There is one oddity here: CSC.EXE behavior differs from Ecma-334, so
+I'm not sure which is correct.
+
+The difference is in generic methods, e.g.
+
+	public void UseList<U> (List<U> list) {}
+
+Ecma-334 suggests that the name of this should be:
+
+	M:Test.DocMe`1.UseList`1(System.Collections.Generic.List{``0})
+
+See annex E.3.2 "ID string examples", the Methods bullet, in which:
+
+	public MyList<T> GetValues<T>(T value) { … }
+
+becomes:
+
+	"M:Acme.UseList.getValues`1(``0)"
+
+However, CSC 2.0 generates:
+
+       M:Test.DocMe`1.UseList``1(System.Collections.Generic.List{``0})
+
+Note the extra ` in the method name, UseList`1 vs. UseList``1.
+
+Does anyone know which is correct?  Or is "whatever CSC does" the
+correct output?