The document for the cvs target in NAnt 0.85 includes an attribute for "commandline" and another attribute for "command-line". At first, I thought this was another case of accidently documenting the same attribute twice as I had noticed in the documentation of the MailLogger properties.
However, I now think they are distinct. One applies to the global CVS options which are independent of any specific command while the other applies to CVS command-specific options. However, the choice of names is a human factors nightmare--and the descriptions just add to the fun. The "command-line" attribute is described as "The command line to use for the cvs command." OK, this sound like the command-specific options. This definition is supported by the fact that "command-line" is documented immediately following the required "command" attribute, making it look like they are related. But-- The "commandline" attribute is described as "Command-line [note the hyphen] arguments for the program. The command line [now it's a space] arguments are used to specify any cvs command options that are not available as attributes. These are appended after the command itself and are additive to whatever attributes are currently specified. The first sentence appears to support the idea that this attribute is for global optoins that apply to the entire program--then the second sentence comes along: "used to specify any cvs command options that are not available as attributes." Now THIS sentence makes it sound like we are talking about command-specific options again. The third sentence, "These are appended after the command itself..." again implies these are command-specific rather than global options. At the very least, the descriptions of these two attributes should be re-written, carefully drawing the distinction of which options are which. Better yet, the attribute names "command-line" and "commandline" should be deprecated in favor of less ambiguous names such as "globaloptions" and "commandoptions". Merrill ------------------------------------------------------- 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=4721&alloc_id=10040&op=click _______________________________________________ Nant-users mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/nant-users
