FULL PRODUCT VERSION :
java version "1.5.0_03"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_03-b07)
Java HotSpot(TM) 64-Bit Server VM (build 1.5.0_03-b07, mixed mode)


ADDITIONAL OS VERSION INFORMATION :
Linux ws 2.6.11-gentoo-r5 #1 SMP Wed Apr 6 21:25:27 CEST 2005 x86_64 AMD Opteron(tm) Processor 242 AuthenticAMD GNU/Linux


EXTRA RELEVANT SYSTEM CONFIGURATION :
The directory containing the build directory is mounted over networking file system (v3).

A DESCRIPTION OF THE PROBLEM :
Running javadoc on an application with 136 Java files (310KB) takes very long when ran on a networking file system. When running javadoc with strace, it turns out it does an incredibly large amount of stat calls for package.html (over 24,000 total) for the various packages. Creating empty package.html files for all 10 packages reduces this number to near 0.

Running javadoc with time gave the following results (3x average):
Without package.html files:
real 0m43.225s
user 0m27.315s
sys 0m3.249s

With package.html files:
real 0m15.785s
user 0m28.344s
sys 0m0.936s

These tests were run on a dual Opteron 242 system with 2GB ram. Note the difference in real runtime. Without dummy package.html processing takes three takes as long. On a local partition the differences are also noticeable, but smaller. The number of stat calls remain about the same.

The application makes heavy use of interfaces an inheritance. It is possible that this influences the number of stat calls.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Run javadoc on a application that does not have any package.html files.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
The existence of package.html files should not influence the time it takes to run javadoc in a noticeable way.
ACTUAL -
The time it takes to run javadoc varries heavely with or without package.html files. Especially on networking file systems.

REPRODUCIBILITY :
This bug can be reproduced always.

CUSTOMER SUBMITTED WORKAROUND :
Creating empty package.html files improves performance considerably, avoiding almost all stat calls.
###@###.### 2005-07-12 18:41:50 GMT