Bug ID: JDK-8215599 Remove support for javadoc "frames" mode

Versions (Unresolved/Resolved/Fixed)

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.

JDK 13
13 b15Fixed

The javadoc Standard Doclet has been moving away from the use of frames to navigate around the documentation to the use of javadoc Search.

In recent releases, we have been through a sequence of steps:
  1. Frames, no Search (up to JDK 8)
  2. Frames generated, but not displayed by default
  3. Frames not generated by default
In addition, we have taken steps to ensure that all navigation that could be done with frames can be done some other way, such as using Javadoc Search (assuming JavaScript is enabled) or via the index pages (when JavaScript is disabled.)

Now, the final step is to remove all support for frames in the generated documentation.

This will also mean removing the `--frames` option. The `--no-frames` option will be retained, but will effectively become a no-op.

URL: http://hg.openjdk.java.net/jdk/jdk/rev/4f9772f4403d User: pmuthuswamy Date: 2019-04-01 07:14:51 +0000

01-04-2019

When we remove support for frames, we might want to examine the mechanism to set the window title, which was required in the frames world, but which should not be required in a non-frames world. There may be more dead code we can remove in this area. Look (grep) for words like `includeScript` and `winTitle` in the source.

21-02-2019

The work should primarily consist of: * remove the --frames option * remove the corresponding field HtmlConfiguration.frames and references to it * remove the following files. $ find src/jdk.javadoc -name \*.java | grep Frame src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/PackageFrameWriter.java src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/FrameOutputWriter.java src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/AllClassesFrameWriter.java src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/ModuleIndexFrameWriter.java src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/ModulePackageIndexFrameWriter.java src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/ModuleFrameWriter.java src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/PackageIndexFrameWriter.java

19-12-2018

Blocks :	JDK-8215608 - Remove old javadoc features
CSR :	JDK-8215603 - Remove support for generating frames
Relates :	JDK-8268771 - javadoc -notimestamp option does not work on index.html
Relates :	JDK-8217013 - javadoc generates references to missing file overview-frame.html