stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8280738: Minor cleanup for HtmlStyle

Browse Source 
Reviewed-by: hannesw
This commit is contained in:
Jonathan Gibbons 2022-01-31 22:45:16 +00:00
parent 39165613aa
commit 74921e8422
1 changed files with 56 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

84
src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/markup/HtmlStyle.java
View File

@ -48,20 +48,14 @@ import java.util.regex.Pattern;
* or {@link javax.lang.model.element.Element "language model elements"}.
* The usage is made explicit when it is not clear from the surrounding context.
*
* @apiNote
* The stylized use of {@code editor-fold} comments and line comments (beginning {@code //})
* is to support extracting details of declarations with external tools. Edit with care!
*
* @see <a href="https://html.spec.whatwg.org/#classes">WhatWG: {@code class} attribute</a>
*/
public enum HtmlStyle {
/**
* The class of the {@code div} element containing a snippet element.
*/
snippetContainer,
/**
* The class of the {@code a} element to copy snippet content to the clipboard.
*/
snippetCopy,
//<editor-fold desc="navigation bar">
//
// The following constants are used for the main navigation bar that appears in the
@ -324,17 +318,6 @@ public enum HtmlStyle {
*/
propertyDetails,
/**
* The class for the list containing the {@code @see} tags of an element.
*/
seeList,
/**
* The class for the list containing the {@code @see} tags of an element
* when some of the tags have longer labels.
*/
seeListLong,
/**
* The class for a {@code section} element containing details of the
* serialized form of an element, on the "Serialized Form" page.
@ -391,6 +374,17 @@ public enum HtmlStyle {
*/
previewLabel,
/**
* The class for the list containing the {@code @see} tags of an element.
*/
seeList,
/**
* The class for the list containing the {@code @see} tags of an element
* when some of the tags have longer labels.
*/
seeListLong,
//</editor-fold>
//<editor-fold desc="tables">
@ -844,6 +838,44 @@ public enum HtmlStyle {
//</editor-fold>
//<editor-fold desc="snippets">
//
// The following constants are used for the contents of snippets.
// In addition, the translation of a snippet may use the class
// {@code language-LANG} where LANG is either specified explicitly
// by the "lang" attribute in a snippet tag, or can be inferred
// from the kind of an external snippet.
/**
* The class of the {@code pre} element presenting a snippet.
*/
snippet,
/**
* The class of the {@code div} element containing a snippet element.
*/
snippetContainer,
/**
* The class of the UI element to copy snippet content to the clipboard.
*/
snippetCopy,
/**
* The class of text highlighted with the type {@code bold}.
*/
bold,
/**
* The class of text highlighted with the type {@code italic}.
*/
italic,
/**
* The class of text highlighted with the type {@code highlighted}.
*/
highlighted,
//<editor-fold desc="miscellaneous">
//
// The following constants are used in various places across a variety of pages.
@ -908,7 +940,8 @@ public enum HtmlStyle {
inheritedList,
/**
* The class of an element that acts as a notification for an invalid tag.
* The class of an element that acts as a notification for an invalid tag
* or other invalid items.
*/
invalidTag,
@ -923,7 +956,7 @@ public enum HtmlStyle {
memberNameLink,
/**
* The class for a {@code dl} element containing serial UID information in
* The class of a {@code dl} element containing serial UID information in
* the serialized form page.
*/
nameValue,
@ -964,11 +997,6 @@ public enum HtmlStyle {
*/
sourceLineNo,
/**
* The class of the {@code pre} element presenting a snippet.
*/
snippet,
/**
* The class of an {@code a} element for a link to a class or interface.
*/