WORK AROUND

The only workaround that I know of is to write your own taglet instead
of using the -tag option. Here is what I would use:

import com.sun.tools.doclets.standard.tags.SimpleTaglet;

public class Foo extends SimpleTaglet {
   public Foo() {
     super("my-tag", "My Tag:", "a");
   }
}

Then, when you run Javadoc, use:

-taglet <qualified name of your taglet> -tagletpath <path to your taglet>

I don't have time to test this code, but I believe it will work.

-Jamie
                                     

PUBLIC COMMENTS

Fixed.  From now on, if you want to include a ":" in your taglet name, you cannot do so by using "-" as an alternate separator.  You must escape with "\".  Therefore, "-" can now be used in a taglet name.
###@###.### 2003-11-15

###@###.### wrote:

In other words:
> We no longer support dashes as seperators for the tag option.  The colon 
> is ALWAYS the seperator.  If the user wants a colon in their tag name, 
> they have to escape it using the back slash.
> For example:
>
> -tag ejb\:bean:Beah:a
>
> The above tag would work for this doc comment:
>
> /**
>  * Comment
>  *
>  * @ejb:bean
> */
>
> It was a bad idea to use an alternate seperator.  That just introduces a
> different bug.  I think escaping is the right fix.
>
> ###@###.### 
                                     

CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger
tiger-beta

FIXED IN:
tiger-beta

INTEGRATED IN:
tiger-b30
tiger-beta


                                     

EVALUATION

###@###.### wrote:

Here is the bug you are running into:

String seperator = args[1].indexOf(TagletManager.ALT_SIMPLE_TAGLET_OPT_SEPERATOR) == -1 ?
TagletManager.SIMPLE_TAGLET_OPT_SEPERATOR :
TagletManager.ALT_SIMPLE_TAGLET_OPT_SEPERATOR;

The doclet assumes that the seperator is "-" instead of ":".
This code was added in 1.4.2 t support tags like @my:tag.
I don't think anyone knew that people used tags like @my-tag.
This will have to be fixed in 1.5.

See the workaround.

###@###.### 2003-09-10

Fixed.
###@###.### 2003-11-15