JDK-8236578 : Related to: JDK-8202961. Future removeal of --frames.
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 11
  • Priority: P4
  • Status: Closed
  • Resolution: Duplicate
  • Submitted: 2019-12-20
  • Updated: 2020-11-19
  • Resolved: 2019-12-24
Related Reports
Duplicate :  
Description
ADDITIONAL SYSTEM INFORMATION :
System independent problem

A DESCRIPTION OF THE PROBLEM :
The decision about removing left side navigation frame in future is FATAL. This was the most useful function which allowed to search what You were looking for, but You did not know a name of it nor a package it belongs to. It allowed to DISCOVER what is possible with JDK or other libraries. Try to use current style to browse JAVA-DOC for a library You don't know perfectly and You will see how much more clicks and scrolls it requires. Especially if it has HUGE overview file. Where is packages list now? No-where.

The search function does not pay back removing them and making them (if enabled) not scalable. Don't use HTML5 if it can't handle what HTML4 did. Browsers Ctlr-F did work better because it also searched a text.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Generate any JAVADOC and try to use it.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
1.Packages and classes list should be back.
2.There should be possibility to move frame borders.
3.Alternatively there should be an option to use old HTML4 doclet and it SHOULD be described in manual.
ACTUAL -
1.No packages and class list or dysfunctional list with --frames
2.Warning with --frames which worries me.

---------- BEGIN SOURCE ----------
Not needed.
---------- END SOURCE ----------

CUSTOMER SUBMITTED WORKAROUND :
Couldn't find any except of moving to doxygen what is painful.

FREQUENCY : always