8264655: Minor internal doc comment cleanup

Reviewed-by: prappo

Author: jonathan-gibbons

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

@@ -48,7 +48,7 @@
  * or {@link javax.lang.model.element.Element "language model elements"}.
  * The usage is made explicit when it is not clear from the surrounding context.
  *
- * @see <a href="https://html.spec.whatwg.org/#classes>WhatWG: {@code class} attribute</a>
+ * @see <a href="https://html.spec.whatwg.org/#classes">WhatWG: {@code class} attribute</a>
  */
 public enum HtmlStyle {
     block,

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/markup/TagName.java

@@ -35,7 +35,7 @@
  *  This code and its internal interfaces are subject to change or
  *  deletion without notice.</b>
  *
- * @see <a href=""https://html.spec.whatwg.org/multipage/syntax.html#syntax-tag-name>WhatWG: Tag Name</a>
+ * @see <a href="https://html.spec.whatwg.org/multipage/syntax.html#syntax-tag-name">WhatWG: Tag Name</a>
  * @see <a href="https://www.w3.org/TR/html51/syntax.html#tag-name">HTML 5.1: Tag Name</a>
  */
 public enum TagName {

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/BaseConfiguration.java

@@ -84,7 +84,7 @@
  * Configure the output based on the options. Doclets should sub-class
  * BaseConfiguration, to configure and add their own options. This class contains
  * all user options which are supported by the standard doclet.
- * <p>
+ *
  * <p><b>This is NOT part of any supported API.
  * If you write code that depends on this, you do so at your own risk.
  * This code and its internal interfaces are subject to change or

src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclint/HtmlTag.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2010, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2010, 2021, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -40,20 +40,18 @@
 /**
  * Enum representing HTML tags.
  *
- * The intent of this class is to embody the semantics of W3C HTML 4.01
+ * The intent of this class is to embody the semantics of the current HTML standard,
  * to the extent supported/used by javadoc.
- * In time, we may wish to transition javadoc and doclint to using HTML 5.
  *
- * This is derivative of com.sun.tools.doclets.formats.html.markup.HtmlTag.
+ * This class is derivative of {@link jdk.javadoc.internal.doclets.formats.html.markup.TagName}.
  * Eventually, these two should be merged back together, and possibly made
  * public.
  *
- * @see <a href="http://www.w3.org/TR/REC-html40/">HTML 4.01 Specification</a>
+ * @see <a href="https://html.spec.whatwg.org/multipage/">HTML Living Standard</a>
  * @see <a href="http://www.w3.org/TR/html5/">HTML 5 Specification</a>
- * @see <a href="http://www.w3.org/TR/wai-aria/ ">WAI-ARIA Specification</a>
+ * @see <a href="http://www.w3.org/TR/REC-html40/">HTML 4.01 Specification</a>
+ * @see <a href="http://www.w3.org/TR/wai-aria/">WAI-ARIA Specification</a>
  * @see <a href="http://www.w3.org/TR/aria-in-html/#recommendations-table">WAI-ARIA Recommendations Table</a>
- * @author Bhavesh Patel
- * @author Jonathan Gibbons (revised)
  */
 public enum HtmlTag {
     A(BlockType.INLINE, EndKind.REQUIRED,
@@ -401,7 +399,7 @@ public boolean accepts(HtmlTag t) {
     /**
      * Enum representing the supportability of HTML element.
      */
-    public static enum ElemKind {
+    public enum ElemKind {
         OK,
         INVALID,
         OBSOLETE,
@@ -411,7 +409,7 @@ public static enum ElemKind {
     /**
      * Enum representing the type of HTML element.
      */
-    public static enum BlockType {
+    public enum BlockType {
         BLOCK,
         INLINE,
         LIST_ITEM,
@@ -422,20 +420,20 @@ public static enum BlockType {
     /**
      * Enum representing HTML end tag requirement.
      */
-    public static enum EndKind {
+    public enum EndKind {
         NONE,
         OPTIONAL,
         REQUIRED
     }
 
-    public static enum Flag {
+    public enum Flag {
         ACCEPTS_BLOCK,
         ACCEPTS_INLINE,
         EXPECT_CONTENT,
         NO_NEST
     }
 
-    public static enum Attr {
+    public enum Attr {
         ABBR,
         ALIGN,
         ALINK,
@@ -532,7 +530,7 @@ public String getText() {
         }
     }
 
-    public static enum AttrKind {
+    public enum AttrKind {
         OK,
         INVALID,
         OBSOLETE,