Ian
Jaroslaw Kowalski wrote:
Can you add the category stuff or should I do it?
We need:
- a new property 'Category' for 'CustomFunctionSetAttribute' - changes to the function index to split functions by category - maybe we should place this information on each function's reference page
Jarek
----- Original Message ----- From: "Ian MacLean" <[EMAIL PROTECTED]>
Cc: "Jaroslaw Kowalski" <[EMAIL PROTECTED]>;
<[EMAIL PROTECTED]>
Sent: Wednesday, December 10, 2003 3:30 PM
Subject: Re: [nant-dev] Naming of documentation files
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
--
Ian MacLean, Developer, ActiveState, a division of Sophos
http://www.ActiveState.com
------------------------------------------------------- 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
