I experimented with this. I put an HTML file at the root of my project source directory. I added a

 -overview MySummary.html

in the "additional options" of the Javadoc Wizard (in the Doclet options page). I right-clicked on the Javadoc node in the Project Pane and did a Make. I double-clicked on the index.html node under the Javadoc node.

The index.html page was generated with an "Overview" at the top of the page (next to the normal "Package" and "Class"), and all the HTML pages for the individual classes had an "Overview" hyperlink. At the bottom of the index.html was the actual content of MySummary.html. Looking at the source of index.html, I can see that allclasses-frame.html and overview-summary.html are being shown by index.html in separate frames.

Here is the Sun documentation:

"Specifies that javadoc should retrieve the text for the overview documentation from the "source" file specified by path\filename and place it on the Overview page (overview-summary.html). The path\filename is relative to the -sourcepath. "
"While you can use any name you want for filename and place it anywhere you want for path, a typical thing to do is to name it overview.html and place it in the source tree at the directory that contains the topmost package directories. In this location, no path is needed when documenting packages, since -sourcepath will point to this file."

http://java.sun.com/products/jdk/1.2/docs/tooldocs/win32/javadoc.html

2002-Apr-15 6:54am gyles19@visi.com