javadoc arg file -tag name:a:"label" does not work
Hi. From the command line,
javadoc -tag todo:a:"To Do:" SomeClass.java
works fine. However, put -tag todo:a:"To Do:" in an arg file called options and
javadoc @options SomeClass.java
does not work. The message is:
javadoc: error - Illegal package name: "To Do:"
-tag todo:a:ToDo works in the arg file. It is the "" which cause the problem. Using single quotes does not help. Quotes work fine in other options such as -windowtitle, in the arg file.
Any suggestions? I'd really like to use an arg file!
[550 byte] By [
raineha] at [2007-10-3 0:22:37]
Thanks for the suggestions. No there's no space. And escaping didn't work. With the class
/**
* This is a class to trial tags in Javadoc.
* @since forever
* @fred.speak stuff
*/
public class TagTrialClass {
/**@fred.speak more stuff*/
public static void main (String[] args) {
System.out.println("A run of TagTrialClass");
}
}
this command works:
javadoc -windowtitle "A title" -tag fred.speak:a:"Fred says:" TagTrialClass.java
Copy and paste (so no typos) the options into a plain text file called options and the command
javadoc @options TagTrialClass.java
produces
javadoc: error - Illegal package name: "Fred says:"
Loading source file TagTrialClass.java...
1 error
There is no problem with the -windowtitle
-tag fred.speak:a:\"Fred says:\" in options produces a similar message except with:
.... Illegal package name: "Fred says:""
and
-tag fred.speak:a:\\"Fred says:\\" produces:
... Illegal package name: "Fred says:\"
-tag fred.speak:a:FredSpeak does work in options
I've tried all sorts of variations. A bug maybe? I guess I could delve into how the Standard Doclet parses the file but I'm but I'm busy writing my own!
I've done a little more investigation, and if I'm not doing something silly (the default option of course), and there is a bug, then I think it may be to do with how javadoc uses
com.sun.tools.javac.main.CommandLine.java
to process @file arguments.
I resist further exploration so I can get on with other things!
Hoping that I'm doing something obviously wrong, & someone out there will be kind enough to point it out.
