[MonoDevelop] Doc comments

Atsushi Eno atsushi at ximian.com
Fri Dec 9 11:50:16 EST 2005


Hi,

John Luke wrote:
> Atsushi Eno wrote:
>> You might want to reuse some code in cs2ecma.cs in monodoc, if you
>> are really interested in implementing it (though I dislike C# doc
>> comments as a kind of translator dude, I remember I wrote such code).
>>
> I know I'm jumping off topic, but why does this present a problem for 
> translators?

There is simply no built in support for localization in C# doc comments
and IF we include those translations in the sources as well, the lengthy
documentation will mess you. And if you split translation documents
out from the source, it won't reflect on-the-fly documentations for you.

When it comes to monodoc, we can at least theoretically use non-"en"
documentations as its basis (and it would be pretty simple to localize).

> Another possibility is to get the inline doc information with the 
> monodevelop parser.

Yes. Am not familiar with MD sources so I might misunderstand, but
since monodevelop has its own parser, so it would make much sense
to have its own doc comment support.

Atsushi Eno


More information about the Monodevelop-list mailing list