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

[Atsushi Eno]

Hi Gaurav,

Hmm, I thought you're trying to create totally different
documentation feature ;-) I've been posting my patch to
mono-devel-list:
http://archive.neotonic.com/archive/mono-devel-list/messages/8531?noheader=1

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.

Thanks,
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?
>>
>>Miguel
>>
> 
> _______________________________________________
> Mono-hackers-list maillist  -  Mono-hackers-list@lists.ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-hackers-list
>