Details
-
Bug
-
Resolution: Fixed
-
P4
-
7
-
b77
-
generic
-
generic
Description
When an -overview file is included, the generated html incorrectly places the contents of the overview file inside nested <div> sections. The result is that the css defined formatting is incorrect for lists and list-style is "none" instead of "disc".
Nesting the overview content inside <div class="footer"><div class="subTitle"> changes the css context so that the included overview file does not use the default list attributes. Neither of these css classes seems relevant to the included overview content.
In contrast, the generated package-summary.html, does not include extra "footer" and "subTitle" <div>s.
The "<div class="block"> does not pose a problem.
With this overview.html:
<html>
<body>
<p>Test Overview</p>
<ul>
<li>bullet is missing; since css defines footer.ul as <b>list-style:none;</b>
</li>
</ul>
</body>
</html>
From the generated overview-summary.html, the relevant excerpt is:
XXXX <div class="footer">
<a name="overview_description">
<!-- -->
</a>
XXXX <div class="subTitle">
<div class="block"><p>Test Overview</p>
<ul>
<li>bullet is missing; since css defines footer.ul as <b>list-style:none;</b>
</li>
</ul>
</div>
XXXX </div>
XXXX</div>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
The generation of the divs is in: com.sun.tools.doclets.formats.html.PackageIndexWriter.addOverViewComment:200
and addOverview:214
Nesting the overview content inside <div class="footer"><div class="subTitle"> changes the css context so that the included overview file does not use the default list attributes. Neither of these css classes seems relevant to the included overview content.
In contrast, the generated package-summary.html, does not include extra "footer" and "subTitle" <div>s.
The "<div class="block"> does not pose a problem.
With this overview.html:
<html>
<body>
<p>Test Overview</p>
<ul>
<li>bullet is missing; since css defines footer.ul as <b>list-style:none;</b>
</li>
</ul>
</body>
</html>
From the generated overview-summary.html, the relevant excerpt is:
XXXX <div class="footer">
<a name="overview_description">
<!-- -->
</a>
XXXX <div class="subTitle">
<div class="block"><p>Test Overview</p>
<ul>
<li>bullet is missing; since css defines footer.ul as <b>list-style:none;</b>
</li>
</ul>
</div>
XXXX </div>
XXXX</div>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
The generation of the divs is in: com.sun.tools.doclets.formats.html.PackageIndexWriter.addOverViewComment:200
and addOverview:214