Bug 339912

Summary: GMCS: Generic XML cref attribute parsed incorrectly
Product: [Mono] Mono: Compilers Reporter: Mike Allen <mike.allen>
Component: C#Assignee: Mono Bugs <mono-bugs>
Status: RESOLVED DUPLICATE QA Contact: Mono Bugs <mono-bugs>
Severity: Normal    
Priority: P2 - High    
Version: 1.2   
Target Milestone: ---   
Hardware: i686   
OS: Windows XP   
Whiteboard:
Found By: Customer Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---
Attachments: Test1.cs sample file
Test2.cs sample file

Description Mike Allen 2007-11-07 18:01:47 UTC
Created attachment 182472 [details]
Test1.cs sample file

Description of Problem:

I'm using version 1.2.5.2 of the Mono gmcs compiler.

C# document comments allow references to generic classes in cref attributes
such as:

<see cref="G {T}" />

or, alternatively:

<see cref="G &lt;T&gt;" />

to refer to a generic class G <T>.

However, when the Mono C# compiler encounters such cref attributes, it
produces the following error message (CS1584):

XML comment on 'SomeClass' has syntactically incorrect cref attribute `G {T}'

or

XML comment on 'SomeClass' has syntactically incorrect cref attribute `G <T>'

respectively.

Steps to reproduce the problem:
1. Download the attached files Test1.cs and Test2.cs
2. Compile each file - individually - with the following options:

    gmcs -target:library -warn:4 -warnaserror -doc:Test1.xml Test1.cs

or

    gmcs -target:library -warn:4 -warnaserror -doc:Test2.xml Test2.cs

3. Examine output from compiler

Actual Results:

Test1.cs(17,18): error CS1584: XML comment on `Test.Test' has syntactically
incorrect cref attribute `G {T}'
Compilation failed: 1 error(s), 0 warnings

or

Test2.cs(17,18): error CS1584: XML comment on `Test.Test' has syntactically
incorrect cref attribute `G <T>'
Compilation failed: 1 error(s), 0 warnings
m

Expected Results:

No errors in either case.

How often does this happen? 

Every time.

Additional Information:

The same files with the same options compile, without error, with Microsoft
C# compiler (version 8.00.50727.42).
Comment 1 Mike Allen 2007-11-07 18:02:28 UTC
Created attachment 182474 [details]
Test2.cs sample file
Comment 2 Marek Safar 2008-09-26 10:00:38 UTC

*** This bug has been marked as a duplicate of bug 324680 ***