[Mono-list] Re: [Mono-hackers-list] Re: Patch for mcs
Gaurav Vaish
Gaurav Vaish <gaurav.vaish@gmail.com>
Mon, 1 Nov 2004 05:06:34 +0530
> Mhm, I cannot understand what you meant. What is (and should not be?)
> discarded? My patch handles usual "/** ... */" comments as well as
> those comments.
Well, you can only understand
/**
* <summary>This is ok</summary>
*/
but not this. It will complain...
/**
* Raw text is not ok.
*/
> Actually why I prefered XmlElement instead of raw string was to handle
> warnings embedded into the XML documentation. Having just a raw string
> in MemberCore is not sufficient.
Right. You point is well taken. Mine is just an extension.
> When it comes to that you're just using the common markup to
> csc /doc, why just not pipeline to ndoc(-console) or whatever?
Because they will not understand "extended" tags. My idea is to the
built the infrastructure like that of Doclet and Taglet, hence I
cannot simply pipeline.
> Well, such extensions should not be done with /doc switch. It should
> be available in different switch name, for example /docx.
That's what mcsdoc is. But for that to happen, I should be able to
get the raw comment, not XMLElement.
I hope that explains my bits.
--
Happy Hacking,
Gaurav
http://csdoc.sf.net
--------------------