There is a regresssion from 1.3 to 1.4 while building javadoc for usermgr
in the AdminInstall tree (/ws/admininstall-81-gate).

Previously (in 1.3), the javadoc for usermgr worked without any problems.

I looked for API doc on java.sun.com for javadoc, 1.4 but could not find any.
Because of bug 4287699 (Implement javadoc on new compiler), I thought that
there may be important difference documented on 1.4

I tried compiling serveral permutations, and couldn't find "one" set of
html files that consistently caused this exception. (Individually, each
java package's javadoc built without any problems) It almost seems like the
size of the javadoc that we're compiling is causing the problem. (The makefile
can be seen at: /ws/admininstall-81-clone/src/bundled/app/mgapp/apps/com/sun/adm
in/docs/Makefile, line 33 lists the directory where the javadocs are being built
)

[See the comments section for the exception message]

It is also interesting to note that the performance seems much slower. It
takes 15 minutes to compile the usermgr javadoc. (as opposed to less than 5 minutes in 1.3) I'm running an Ultra 60 384 Meg of RAM (build 33 of solaris9)


I'm using jdk 1.4:
entropy (carrigan) 387 => /usr/java1.4/bin/java -version
java version "1.4.0-beta"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-beta-b54)
Java HotSpot(TM) Client VM (build 1.4beta-B54, mixed mode)
fentropy (carrigan) 388 => echo $JAVA_HOME
/usr/java1.4

I got the jdk from:
/net/jdk.eng/export/disk6/promoted/jdk/1.4/latest/binaries/solsparc

Below is the mail from our gatekeeper testing 1.4 in the admininstall build tree:

From: James Falkner <###@###.###>
X-Accept-Language: en
To: ###@###.###, ###@###.###
Subject: Java 1.4 issue # 2

All,

After a short break, we're back at it again. This one looked
like it might be spurious, but it's happened the past 10
out of 10 times I tried it (both sparc and x86). I'd
like the mgapp folks to file a java bug in the appropriate
manner (I can't remember the right cat/subcat or
keywords to raise the right flags for java bugs).

-jhf-

# pwd
/export/j4test/src/bundled/app/mgapp/apps/com/sun/admin/docs
yyz# /usr/java/bin/java -fullversion
java full version "1.4.0-beta-b55"
# make -e install
[... bunch of stuff deleted ...]
//usr/java/bin/javadoc -link api/common -sourcepath
/export/j4test/src/bundled/app/mgapp/apps -classpath

/export/j4test/src/../proto.sparc/usr/sadm/lib/wbem/cimapi.jar:/export/j4test/sr

c/../proto.sparc/usr/sadm/lib/xml.jar:/export/j4test/src/../proto.sparc/usr/sadm

/lib/wbem/providerutility.jar:/export/j4test/src/../proto.sparc/usr/sadm/lib/wbe

m/cimom.jar:/export/j4test/src/../proto.sparc/usr/sadm/lib/smcapi.jar://usr/java

/jre/lib/rt.jar://usr/java/lib/tools.jar:/export/j4test/src/../proto.sparc/jcbwt
360J.jar
-version -J-Xmx64m -d api/usermgr com.sun.admin.usermgr.client
com.sun.admin.usermgr.client.email com.sun.admin.usermgr.client.groups
com.sun.admin.usermgr.client.rbac com.sun.admin.usermgr.client.templates
com.sun.admin.usermgr.client.users com.sun.admin.usermgr.client.WBEMClient
com.sun.admin.usermgr.common com.sun.admin.usermgr.cli
com.sun.admin.usermgr.cli.group com.sun.admin.usermgr.cli.mail
com.sun.admin.usermgr.cli.user
[... bunch of stuff deleted ...]
Generating

api/usermgr/com/sun/admin/usermgr/common/UserMgrCliArgParsingException.html...

Generating
api/usermgr/com/sun/admin/usermgr/common/UserMgrCliHelpException.html...
Generating

api/usermgr/com/sun/admin/usermgr/common/UserMgrIDAlreadyInUseException.html...

Generating

api/usermgr/com/sun/admin/usermgr/common/UserMgrNameAlreadyInUseException.html..
.

javadoc: In doclet class com.sun.tools.doclets.standard.Standard, method
start has thrown an exception java.lang.reflect.InvocationTargetException
java.lang.ArrayIndexOutOfBoundsException
        at

com.sun.tools.doclets.standard.Standard.generateSerializedFormPage(Standard.java
:285)

        at
com.sun.tools.doclets.standard.Standard.startGeneration(Standard.java:152)
        at com.sun.tools.doclets.standard.Standard.start(Standard.java:40)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at

sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:30)

        at

sun.reflect.InflatableMethodAccessorImpl.invoke(InflatableMethodAccessorImpl.jav
a:46)

        at java.lang.reflect.Method.invoke(Method.java:306)
        at
com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:200)
        at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:102)

        at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:275)
        at com.sun.tools.javadoc.Start.begin(Start.java:110)
        at com.sun.tools.javadoc.Main.main(Main.java:35)
1 error
1 warning
*** Error code 1
make: Fatal error: Command failed for target `usermgr'

Note that there does not appear to be an workarounds.