[Ndoc-users] .Net 2.0 generics in XML doc comments

[Owen B. <ow...@bl...>]

I'm having some trouble with the various versions of NDoc I have 
installed to try to generate comments for the .Net 2.0 project I'm 
working on at the moment.

Both "NDoc 1.3.1 v15" and "NDoc 2005" seem to throw 
NDoc.Core.DocumenterException exceptions when I try to generate the 
comments (see http://plum.flirble.org/~owen/NDoc_1.3.1_v15.txt and 
http://plum.flirble.org/~owen/NDoc_2005.txt for stack traces)

This isn't really the reason I'm mailing however (though if someone 
wants to fix those or tell me what I'm doing wrong then please be my 
guest ;o)

What I really want to know is a problem caused by the apparent inability 
of Microsoft developers to write useful sample code.

I have a property of my class that returns a List<string>.  So far so 
good, but I have absolutely no idea how to write a <see cref=""/> tag 
for that type.  If I write <see cref="System.Collections.Generic.List<string>"/>
then I am completely unsurprised that Visual Studio tells me there's a 
problem, as the angle-brackets are obviously going to cause problems.

But what should I be writing?  :o)


Owen
-- 
Owen Blacker, London GB
Say no to ID cards: www.no2id.net
--
They that can give up essential liberty to obtain a little temporary
  safety deserve neither liberty nor safety --Benjamin Franklin, 1759