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

[Miguel de Icaza]

Hello,

>    The patch feeds my NDoclet-Engine (ah, that's not a formal name).
> 
>    Basic infra (in very infancy) is at:
> 
>    http://cvs.sourceforge.net/viewcvs.py/csdoc/csdoc/src/mcsdoc/MCSDoc/
> 
>    Most of the code is what I moved from
> 
>    "csdoc/src/csdoc/MCSDoc" to "csdoc/src/mcsdoc/MCSDoc" and former
> code is around a year old.
> 
>    The idea, as I said, is not just a documentation tool but a
> documentation engine. And as such, I need the raw-comment.
> 
>    Still not clear? Hooh! I'll have to improve my English it seems :((

So is this a different file format?

In general, I do not think that having documentation inlined in the
source code is a good idea, I have outlined that in the past, and that
is why we are using a separate set of documents in Monodoc.

But in this world of imperfections we need to support all of that source
code that has been produced with inline documentation with the Microsoft
format.

I would love if we could transform those C# docs into ECMA XML docs for
one.

Are you planning a new format?  My bat sense is that this might not be a
great idea.

miguel.