[Mono-list] Re: [Mono-hackers-list] Re: Patch for mcs

Atsushi Eno atsushi@ximian.com
Sun, 31 Oct 2004 17:28:03 +0900

Hi Gaurav,

Hmm, I thought you're trying to create totally different
documentation feature ;-) I've been posting my patch to

Actually my patch does handle /** ... */ style documentation. I mean,
it still does not handle some special formatting such as
  * Those asterisk characters are handled as nothing.

/doc patch TODO items are:

	- handle those special tokenization described above
	- need to warn documentation on incorrect locations
	- having raw strings rather than XmlElement (learned
	  from your patch ;-) It would also improve the code
	  tip that Marek suggested

But currently I think those improvements might not be so trivial,
so I was stopping this feature right now as it is.

Atsushi Eno

Gaurav Vaish wrote:
> Oh!
>    I haven't seen Atsushi's patches. Can I have a look at them?
> Atsushi,
>    It will not make a difference at all provided I am able to get the following:
> 1. Raw Documentation: You wrote that you handle XmlElement and the
> stuff. It is somehow possible to get the raw comment?
> 2. All comments, be it "///" or "/**" style.
>    Ok.. it won't matter if you collect just "///" comments. Adding
> support for "/**" will not be much task because I will need updation
> in only cs-tokenizer.cs
>     Can you let me know where can I find your patch / diff's? If
> there's any help / support, that I need I'd let you know. :-)
> Happy Hacking,
> Gaurav
> http://csdoc.sf.net
> http://gallery.mastergaurav.org
> -----------------------------------------
> On Sat, 30 Oct 2004 12:45:45 -0400, Miguel de Icaza <miguel@ximian.com> wrote:
>>Hello Gaurav,
>>>   Here's the latest diff.
>>>   Rest is same as in previous patch. However, in this I have a change
>>>in the definition of "enum_declaration" in cs-parser.jay:
>>We are very close to integrate Atushi's patches, as we have been working
>>to get his patches to a mature state for the past five months.
>>What is different between your code and Atsushi's?
> _______________________________________________
> Mono-hackers-list maillist  -  Mono-hackers-list@lists.ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-hackers-list