Details
-
Enhancement
-
Resolution: Fixed
-
P3
-
12
-
b03
Description
Currently, when processing HTML files in doc-files subdirectories, the standard doclet does one of two things:
1. The preferred action is to wrap the page with the standard header and footer (the navbar and copyright info, etc) The impl of this action is to take the content of the <body> tag and wrap it, *ignoring* any relevant info in the <head> tag, including any style info.
2. If the <head> tag has info like style info, the preferred action is *not* performed, and the page is just copied verbatim. This means that the navbar and info like the copyright is *not* added automatically.
The dual action is undesirable. A better solution would be to note any style info in the source document and to copy it to the new page. We need to decide whether the info should go before/after the info that might be added by the doclet. If we can copy info across, then there is no need for the fallback strategy in #2 above.
1. The preferred action is to wrap the page with the standard header and footer (the navbar and copyright info, etc) The impl of this action is to take the content of the <body> tag and wrap it, *ignoring* any relevant info in the <head> tag, including any style info.
2. If the <head> tag has info like style info, the preferred action is *not* performed, and the page is just copied verbatim. This means that the navbar and info like the copyright is *not* added automatically.
The dual action is undesirable. A better solution would be to note any style info in the source document and to copy it to the new page. We need to decide whether the info should go before/after the info that might be added by the doclet. If we can copy info across, then there is no need for the fallback strategy in #2 above.
Attachments
Issue Links
- relates to
-
JDK-8194953 doclet corrupts HTML files when adding navbar
-
- Resolved
-