[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
--------------------