Jim,
How would this differ from using XML comments in the build files?
Clumsiness, or lack thereof.
XML comments are verbose and stand on a level with the elements they are supposed to be commenting on. Therefore, it's not always clear who they apply to.
Personally, there's a simple reason of correctness rather than nicety...
XML comments are not nestable. Therefore, if XML comments have been used to document a build file, then it becomes impossible to simply comment out a portion of the build file (usually for debugging, but also often for refactoring, to keep the old implementation nearby while testing) by enclosing it in a single XML comment.
-T
------------------------------------------------------- This SF.Net email is sponsored by BEA Weblogic Workshop FREE Java Enterprise J2EE developer tools! Get your free copy of BEA WebLogic Workshop 8.1 today. http://ads.osdn.com/?ad_id=5047&alloc_id=10808&op=click _______________________________________________ Nant-users mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/nant-users