Good work on the userdoc stuff for functions Jarek. I just built after syncing your checkins. It looks great - we just need to fill those doc comments in now. I can see that a category is needed though - that index page is looking pretty crowede already.

Ian MacLean wrote:

The category could also be implemented using a tag in the xml comments. The advantage with using an attribute property is that you can get the compiler to force the property to be set. Not too bothered either way.

Ian

Jaroslaw Kowalski wrote:

The next thing I'll look at is namespace support which would be somthing
like :


[CustomFunctionSet(NameSpaceUri="somenamespace", prefix="foo" )]



I suggest, that we included something like a category/description which
would be used to generate
the documentation.

[CustomFunctionSet(NameSpaceUri="somenamespace",
   Prefix="",
   Category="String Functions")]

[CustomFunctionSet(NameSpaceUri="somenamespace",
   Prefix="date",
   Category="Date/Time Functions")]

We could generate the "Function Index" page where functions would be
groupped by Category.

We'd have:

String Functions:

   length | description for length()
   substring | description for substring()
   startswith | description for length()

Date/Time Functions:

now | description for now()

and so on... What do you think?

Jarek





-------------------------------------------------------
This SF.net email is sponsored by: SF.net Giveback Program.
Does SourceForge.net help you be more productive?  Does it
help you create better code?  SHARE THE LOVE, and help us help
YOU!  Click Here: http://sourceforge.net/donate/
_______________________________________________
nant-developers mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/nant-developers

Reply via email to