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

Gaurav Vaish gvaish@iitk.ac.in
Fri, 8 Mar 2002 14:59:37 +0530

----- 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.

Gaurav Vaish

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