package-summary for root package

Hi!

I had built the javadoc for a project, using "package.html" (was used a package template from Sun for creating a new package doc comment file). Those html files are placed at packages level.

All javadoc is generated fine, except for package-sumarry for the main index page.

This not contain the "Description" link and its contents.

What is wrong?

Thank you,

Florin

[426 byte] By [SuciuF] at [2007-9-26 7:16:33]
# 1
Is the package.html file in the correct place?It should be in the same directory as the source code files for that package.There should be one for each package that requires oneVince.
vjosullivan at 2007-7-1 17:03:43 > top of Java-index,Developer Tools,Debugging and Profiling Tool APIs...
# 2

Cumpulsory package.html is into directory structure...

I.e. the following package structure:

comRoot.com1.com2.com3....

com3 contains other packages

I can obtain the package comments for all packages except for comRoot package...

I was puted the "package.html" in comRoot folder(this package doesn't contain java sources)...

SuciuF at 2007-7-1 17:03:43 > top of Java-index,Developer Tools,Debugging and Profiling Tool APIs...
# 3

Javadoc currently ignores any package.html file located in a directory that contains no .java files.

This is feature request:

4492654 Want to use package.html file for packages that contain no classes

which you can vote for at:

http://developer.java.sun.com/developer/bugParade/bugs/4492654.html

This feature will not be in 1.4.

However, your original question seemed like it was looking for the top level page, which is defined by the -overview option.

The overview page contains a list of all packages, and an

overview.html file should summarize the set of packages.

-Doug Kramer

Javadoc team

dkramer at 2007-7-1 17:03:43 > top of Java-index,Developer Tools,Debugging and Profiling Tool APIs...