Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4628181
Votes 0
Synopsis stddoclet: Option -tag tagname:X must include taghead
Category doclet:tbd
Reported Against 1.4 , merlin-beta3
Release Fixed 1.4.2(mantis)
State 10-Fix Delivered, bug
Priority: 4-Low
Related Bugs
Submit Date 24-JAN-2002
Description
This bug has been fixed.
 xxxxx@xxxxx  2002-06-01




FULL PRODUCT VERSION :
java version "1.4.0-beta3"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-beta3-b84)
Java HotSpot(TM) Client VM (build 1.4.0-beta3-b84, mixed mode)

FULL OPERATING SYSTEM VERSION :
SunOS aloysius 5.8 Generic_108528-05 sun4u sparc
SUNW,Ultra-5_10



A DESCRIPTION OF THE PROBLEM :
May be simple doc bug.  Dox suggest that -tag name:X
is acceptable (cf http://java.sun.com/j2se/1.4/docs/tooldocs/solaris/javadoc.html#tag
).  However, -tag blahtag:X actually gets me:

javadoc: Error - blahtag:X is an invalid argument to the
-tag option...


This bug can be reproduced always.

CUSTOMER WORKAROUND :
Just make sure to provide a dummy taghead:
-tag blahtag:X:Quack
(Review ID: 138434) 
======================================================================
Work Around
As mentioned by the submitter, the workaround is to include any tag heading 
as the third term -- it will be ignored (not printed in the output) but will 
allow the option to suppress error messages.  For example, "Quack":

  -tag blahtag:X:Quack

 xxxxx@xxxxx  2002-10-17
Evaluation
This option:

  -tag beaninfo:X 

produces this error:

   javadoc: Error - beaninfo:X is an invalid argument to the -tag option...

 xxxxx@xxxxx  2002-03-25

I've added the -tag beaninfo:X tag to the J2SE hopper makefile, so this bug 
needs to be fixed for hopper
 xxxxx@xxxxx  2002-03-25

I made a counting error when parsing -tag arguments in the following format:

-tag <tagName>:X

I used the string tokenizer "new StringTokenizer(args[1], ":", true)" and
thought that the argument was 2 tokens.  It is actually 3 tokens because the ":"
is not thrown away.

This bug fix is pending review.
 xxxxx@xxxxx  2002-07-08
Comments
  
  Include a link with my name & email   

Submitted On 26-FEB-2002
jskeet
I've just run into this as well. The JavaDoc home page 
should mention this until it's fixed.


Submitted On 18-APR-2002
brucechapman
The workaround is to use -tag beaninfo:X:x   until -tag
beaninfo:X works



PLEASE NOTE: JDK6 is formerly known as Project Mustang