[Mono-list] Re: [Mono-docs-list] WebControls Documentation

[Gaurav Vaish]

----- Original Message -----
From: "Jason Diamond" <jason@injektilo.org>
To: <mono-list@ximian.com>
Sent: Friday, March 08, 2002 13:40
Subject: Re: [Mono-list] Re: [Mono-docs-list] WebControls Documentation


: That would totally work. It might be a pain to create those files, though.

    I see one problem when creating external doc files: what will serve as
delimiters to the properties? Either they have be something defined (new) or we
may have skeleton (read: stub) of the class. So, in the doc files, we may have:

/// ...details...about...class...
public class MyClass : Something
{
    /// details..more..
    public int Count { get; set; }
}

    Are there any other / more problems that are foreseen?

: What if we added XML documentation comments to the class library source
: files in English, let csc (or mcs) generate the XML documentation file, and
: then use that as a starting point to translate into other languages?

    Back to square one - I think, this is what we have been trying to avoid.


Cheers,
Gaurav Vaish
http://home.iitk.ac.in/student/gvaish
http://calendar.yahoo.com/mastergaurav
---------------------------------


:
: Jason
:
:
:
: _______________________________________________
: Mono-list maillist  -  Mono-list@ximian.com
: http://lists.ximian.com/mailman/listinfo/mono-list