JDK-4628181 : stddoclet: Option -tag tagname:X must include taghead
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: linux,solaris_8
  • CPU: x86,sparc
  • Submitted: 2002-01-24
  • Updated: 2014-05-05
  • Resolved: 2002-10-25
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
1.4.2 mantisFixed
Description

Name: nt126004			Date: 01/24/2002


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) 
======================================================================

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mantis FIXED IN: mantis INTEGRATED IN: mantis mantis-b05
14-06-2004

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 ###@###.### 2002-10-17
17-10-2002

EVALUATION This option: -tag beaninfo:X produces this error: javadoc: Error - beaninfo:X is an invalid argument to the -tag option... ###@###.### 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 ###@###.### 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. ###@###.### 2002-07-08
08-07-2002

PUBLIC COMMENTS This bug has been fixed. ###@###.### 2002-06-01
01-06-2002