jdk/src/share/classes/javax/swing/text/html/HTML.java
changeset 25148 1026dc322690
parent 24269 325ea76ea0e9
--- a/jdk/src/share/classes/javax/swing/text/html/HTML.java	Thu Jun 19 16:54:59 2014 +0400
+++ b/jdk/src/share/classes/javax/swing/text/html/HTML.java	Thu Jun 19 16:57:14 2014 +0400
@@ -156,79 +156,369 @@
 
         // --- Tag Names -----------------------------------
 
+        /**
+         * Tag <a>
+         */
         public static final Tag A = new Tag("a");
+
+        /**
+         * Tag <address>
+         */
         public static final Tag ADDRESS = new Tag("address");
+        /**
+         * Tag <applet>
+         */
         public static final Tag APPLET = new Tag("applet");
+
+        /**
+         * Tag <area>
+         */
         public static final Tag AREA = new Tag("area");
+
+        /**
+         * Tag <b>
+         */
         public static final Tag B = new Tag("b");
+
+        /**
+         * Tag <base>
+         */
         public static final Tag BASE = new Tag("base");
+
+        /**
+         * Tag <basefont>
+         */
         public static final Tag BASEFONT = new Tag("basefont");
+
+        /**
+         * Tag <big>
+         */
         public static final Tag BIG = new Tag("big");
+
+        /**
+         * Tag <blockquote>
+         */
         public static final Tag BLOCKQUOTE = new Tag("blockquote", true, true);
+
+        /**
+         * Tag <body>
+         */
         public static final Tag BODY = new Tag("body", true, true);
+
+        /**
+         * Tag <br>
+         */
         public static final Tag BR = new Tag("br", true, false);
+
+        /**
+         * Tag <caption>
+         */
         public static final Tag CAPTION = new Tag("caption");
+
+        /**
+         * Tag <center>
+         */
         public static final Tag CENTER = new Tag("center", true, false);
+
+        /**
+         * Tag <cite>
+         */
         public static final Tag CITE = new Tag("cite");
+
+        /**
+         * Tag <code>
+         */
         public static final Tag CODE = new Tag("code");
+
+        /**
+         * Tag <dd>
+         */
         public static final Tag DD = new Tag("dd", true, true);
+
+        /**
+         * Tag <dfn>
+         */
         public static final Tag DFN = new Tag("dfn");
+
+        /**
+         * Tag <dir>
+         */
         public static final Tag DIR = new Tag("dir", true, true);
+
+        /**
+         * Tag <div>
+         */
         public static final Tag DIV = new Tag("div", true, true);
+
+        /**
+         * Tag <dl>
+         */
         public static final Tag DL = new Tag("dl", true, true);
+
+        /**
+         * Tag <dt>
+         */
         public static final Tag DT = new Tag("dt", true, true);
+
+        /**
+         * Tag <em>
+         */
         public static final Tag EM = new Tag("em");
+
+        /**
+         * Tag <font>
+         */
         public static final Tag FONT = new Tag("font");
+
+        /**
+         * Tag <form>
+         */
         public static final Tag FORM = new Tag("form", true, false);
+
+        /**
+         * Tag <frame>
+         */
         public static final Tag FRAME = new Tag("frame");
+
+        /**
+         * Tag <frameset>
+         */
         public static final Tag FRAMESET = new Tag("frameset");
+
+        /**
+         * Tag <h1>
+         */
         public static final Tag H1 = new Tag("h1", true, true);
+
+        /**
+         * Tag <h2>
+         */
         public static final Tag H2 = new Tag("h2", true, true);
+
+        /**
+         * Tag <h3>
+         */
         public static final Tag H3 = new Tag("h3", true, true);
+
+        /**
+         * Tag <h4>
+         */
         public static final Tag H4 = new Tag("h4", true, true);
+
+        /**
+         * Tag <h5>
+         */
         public static final Tag H5 = new Tag("h5", true, true);
+
+        /**
+         * Tag <h6>
+         */
         public static final Tag H6 = new Tag("h6", true, true);
+
+        /**
+         * Tag <head>
+         */
         public static final Tag HEAD = new Tag("head", true, true);
+
+        /**
+         * Tag <hr>
+         */
         public static final Tag HR = new Tag("hr", true, false);
+
+        /**
+         * Tag <html>
+         */
         public static final Tag HTML = new Tag("html", true, false);
+
+        /**
+         * Tag <i>
+         */
         public static final Tag I = new Tag("i");
+
+        /**
+         * Tag <img>
+         */
         public static final Tag IMG = new Tag("img");
+
+        /**
+         * Tag <input>
+         */
         public static final Tag INPUT = new Tag("input");
+
+        /**
+         * Tag <isindex>
+         */
         public static final Tag ISINDEX = new Tag("isindex", true, false);
+
+        /**
+         * Tag <kbd>
+         */
         public static final Tag KBD = new Tag("kbd");
+
+        /**
+         * Tag <li>
+         */
         public static final Tag LI = new Tag("li", true, true);
+
+        /**
+         * Tag <link>
+         */
         public static final Tag LINK = new Tag("link");
+
+        /**
+         * Tag <map>
+         */
         public static final Tag MAP = new Tag("map");
+
+        /**
+         * Tag <menu>
+         */
         public static final Tag MENU = new Tag("menu", true, true);
+
+        /**
+         * Tag <meta>
+         */
         public static final Tag META = new Tag("meta");
         /*public*/ static final Tag NOBR = new Tag("nobr");
+
+        /**
+         * Tag <noframes>
+         */
         public static final Tag NOFRAMES = new Tag("noframes", true, true);
+
+        /**
+         * Tag <object>
+         */
         public static final Tag OBJECT = new Tag("object");
+
+        /**
+         * Tag <ol>
+         */
         public static final Tag OL = new Tag("ol", true, true);
+
+        /**
+         * Tag <option>
+         */
         public static final Tag OPTION = new Tag("option");
+
+        /**
+         * Tag <p>
+         */
         public static final Tag P = new Tag("p", true, true);
+
+        /**
+         * Tag <param>
+         */
         public static final Tag PARAM = new Tag("param");
+
+        /**
+         * Tag <pre>
+         */
         public static final Tag PRE = new Tag("pre", true, true);
+
+        /**
+         * Tag <samp>
+         */
         public static final Tag SAMP = new Tag("samp");
+
+        /**
+         * Tag <script>
+         */
         public static final Tag SCRIPT = new Tag("script");
+
+        /**
+         * Tag <select>
+         */
         public static final Tag SELECT = new Tag("select");
+
+        /**
+         * Tag <small>
+         */
         public static final Tag SMALL = new Tag("small");
+
+        /**
+         * Tag <span>
+         */
         public static final Tag SPAN = new Tag("span");
+
+        /**
+         * Tag <strike>
+         */
         public static final Tag STRIKE = new Tag("strike");
+
+        /**
+         * Tag <s>
+         */
         public static final Tag S = new Tag("s");
+
+        /**
+         * Tag <strong>
+         */
         public static final Tag STRONG = new Tag("strong");
+
+        /**
+         * Tag <style>
+         */
         public static final Tag STYLE = new Tag("style");
+
+        /**
+         * Tag <sub>
+         */
         public static final Tag SUB = new Tag("sub");
+
+        /**
+         * Tag <sup>
+         */
         public static final Tag SUP = new Tag("sup");
+
+        /**
+         * Tag <table>
+         */
         public static final Tag TABLE = new Tag("table", false, true);
+
+        /**
+         * Tag <td>
+         */
         public static final Tag TD = new Tag("td", true, true);
+
+        /**
+         * Tag <textarea>
+         */
         public static final Tag TEXTAREA = new Tag("textarea");
+
+        /**
+         * Tag <th>
+         */
         public static final Tag TH = new Tag("th", true, true);
+
+        /**
+         * Tag <title>
+         */
         public static final Tag TITLE = new Tag("title", true, true);
+
+        /**
+         * Tag <tr>
+         */
         public static final Tag TR = new Tag("tr", false, true);
+
+        /**
+         * Tag <tt>
+         */
         public static final Tag TT = new Tag("tt");
+
+        /**
+         * Tag <u>
+         */
         public static final Tag U = new Tag("u");
+
+        /**
+         * Tag <ul>
+         */
         public static final Tag UL = new Tag("ul", true, true);
+
+        /**
+         * Tag <var>
+         */
         public static final Tag VAR = new Tag("var");
 
         /**
@@ -281,6 +571,9 @@
         }
     }
 
+    /**
+     * Class represents unknown HTML tag.
+     */
     // There is no unique instance of UnknownTag, so we allow it to be
     // Serializable.
     @SuppressWarnings("serial") // Same-version serialization only
@@ -365,85 +658,405 @@
 
         private String name;
 
+
+        /**
+         * Attribute "size"
+         */
         public static final Attribute SIZE = new Attribute("size");
+
+        /**
+         * Attribute "color"
+         */
         public static final Attribute COLOR = new Attribute("color");
+
+        /**
+         * Attribute "clear"
+         */
         public static final Attribute CLEAR = new Attribute("clear");
+
+        /**
+         * Attribute "background"
+         */
         public static final Attribute BACKGROUND = new Attribute("background");
+
+        /**
+         * Attribute "bgcolor"
+         */
         public static final Attribute BGCOLOR = new Attribute("bgcolor");
+
+        /**
+         * Attribute "text"
+         */
         public static final Attribute TEXT = new Attribute("text");
+
+        /**
+         * Attribute "link"
+         */
         public static final Attribute LINK = new Attribute("link");
+
+        /**
+         * Attribute "vlink"
+         */
         public static final Attribute VLINK = new Attribute("vlink");
+
+        /**
+         * Attribute "alink"
+         */
         public static final Attribute ALINK = new Attribute("alink");
+
+        /**
+         * Attribute "width"
+         */
         public static final Attribute WIDTH = new Attribute("width");
+
+        /**
+         * Attribute "height"
+         */
         public static final Attribute HEIGHT = new Attribute("height");
+
+        /**
+         * Attribute "align"
+         */
         public static final Attribute ALIGN = new Attribute("align");
+
+        /**
+         * Attribute "name"
+         */
         public static final Attribute NAME = new Attribute("name");
+
+        /**
+         * Attribute "href"
+         */
         public static final Attribute HREF = new Attribute("href");
+
+        /**
+         * Attribute "rel"
+         */
         public static final Attribute REL = new Attribute("rel");
+
+        /**
+         * Attribute "rev"
+         */
         public static final Attribute REV = new Attribute("rev");
+
+        /**
+         * Attribute "title"
+         */
         public static final Attribute TITLE = new Attribute("title");
+
+        /**
+         * Attribute "target"
+         */
         public static final Attribute TARGET = new Attribute("target");
+
+        /**
+         * Attribute "shape"
+         */
         public static final Attribute SHAPE = new Attribute("shape");
+
+        /**
+         * Attribute "coords"
+         */
         public static final Attribute COORDS = new Attribute("coords");
+
+        /**
+         * Attribute "ismap"
+         */
         public static final Attribute ISMAP = new Attribute("ismap");
+
+        /**
+         * Attribute "nohref"
+         */
         public static final Attribute NOHREF = new Attribute("nohref");
+
+        /**
+         * Attribute "alt"
+         */
         public static final Attribute ALT = new Attribute("alt");
+
+        /**
+         * Attribute "id"
+         */
         public static final Attribute ID = new Attribute("id");
+
+        /**
+         * Attribute "src"
+         */
         public static final Attribute SRC = new Attribute("src");
+
+        /**
+         * Attribute "hspace"
+         */
         public static final Attribute HSPACE = new Attribute("hspace");
+
+        /**
+         * Attribute "vspace"
+         */
         public static final Attribute VSPACE = new Attribute("vspace");
+
+        /**
+         * Attribute "usemap"
+         */
         public static final Attribute USEMAP = new Attribute("usemap");
+
+        /**
+         * Attribute "lowsrc"
+         */
         public static final Attribute LOWSRC = new Attribute("lowsrc");
+
+        /**
+         * Attribute "codebase"
+         */
         public static final Attribute CODEBASE = new Attribute("codebase");
+
+        /**
+         * Attribute "code"
+         */
         public static final Attribute CODE = new Attribute("code");
+
+        /**
+         * Attribute "archive"
+         */
         public static final Attribute ARCHIVE = new Attribute("archive");
+
+        /**
+         * Attribute "value"
+         */
         public static final Attribute VALUE = new Attribute("value");
+
+        /**
+         * Attribute "valuetype"
+         */
         public static final Attribute VALUETYPE = new Attribute("valuetype");
+
+        /**
+         * Attribute "type"
+         */
         public static final Attribute TYPE = new Attribute("type");
+
+        /**
+         * Attribute "class"
+         */
         public static final Attribute CLASS = new Attribute("class");
+
+        /**
+         * Attribute "style"
+         */
         public static final Attribute STYLE = new Attribute("style");
+
+        /**
+         * Attribute "lang"
+         */
         public static final Attribute LANG = new Attribute("lang");
+
+        /**
+         * Attribute "face"
+         */
         public static final Attribute FACE = new Attribute("face");
+
+        /**
+         * Attribute "dir"
+         */
         public static final Attribute DIR = new Attribute("dir");
+
+        /**
+         * Attribute "declare"
+         */
         public static final Attribute DECLARE = new Attribute("declare");
+
+        /**
+         * Attribute "classid"
+         */
         public static final Attribute CLASSID = new Attribute("classid");
+
+        /**
+         * Attribute "data"
+         */
         public static final Attribute DATA = new Attribute("data");
+
+        /**
+         * Attribute "codetype"
+         */
         public static final Attribute CODETYPE = new Attribute("codetype");
+
+        /**
+         * Attribute "standby"
+         */
         public static final Attribute STANDBY = new Attribute("standby");
+
+        /**
+         * Attribute "border"
+         */
         public static final Attribute BORDER = new Attribute("border");
+
+        /**
+         * Attribute "shapes"
+         */
         public static final Attribute SHAPES = new Attribute("shapes");
+
+        /**
+         * Attribute "noshade"
+         */
         public static final Attribute NOSHADE = new Attribute("noshade");
+
+        /**
+         * Attribute "compact"
+         */
         public static final Attribute COMPACT = new Attribute("compact");
+
+        /**
+         * Attribute "start"
+         */
         public static final Attribute START = new Attribute("start");
+
+        /**
+         * Attribute "action"
+         */
         public static final Attribute ACTION = new Attribute("action");
+
+        /**
+         * Attribute "method"
+         */
         public static final Attribute METHOD = new Attribute("method");
+
+        /**
+         * Attribute "enctype"
+         */
         public static final Attribute ENCTYPE = new Attribute("enctype");
+
+        /**
+         * Attribute "checked"
+         */
         public static final Attribute CHECKED = new Attribute("checked");
+
+        /**
+         * Attribute "maxlength"
+         */
         public static final Attribute MAXLENGTH = new Attribute("maxlength");
+
+        /**
+         * Attribute "multiple"
+         */
         public static final Attribute MULTIPLE = new Attribute("multiple");
+
+        /**
+         * Attribute "selected"
+         */
         public static final Attribute SELECTED = new Attribute("selected");
+
+        /**
+         * Attribute "rows"
+         */
         public static final Attribute ROWS = new Attribute("rows");
+
+        /**
+         * Attribute "cols"
+         */
         public static final Attribute COLS = new Attribute("cols");
+
+        /**
+         * Attribute "dummy"
+         */
         public static final Attribute DUMMY = new Attribute("dummy");
+
+        /**
+         * Attribute "cellspacing"
+         */
         public static final Attribute CELLSPACING = new Attribute("cellspacing");
+
+        /**
+         * Attribute "cellpadding"
+         */
         public static final Attribute CELLPADDING = new Attribute("cellpadding");
+
+        /**
+         * Attribute "valign"
+         */
         public static final Attribute VALIGN = new Attribute("valign");
+
+        /**
+         * Attribute "halign"
+         */
         public static final Attribute HALIGN = new Attribute("halign");
+
+        /**
+         * Attribute "nowrap"
+         */
         public static final Attribute NOWRAP = new Attribute("nowrap");
+
+        /**
+         * Attribute "rowspan"
+         */
         public static final Attribute ROWSPAN = new Attribute("rowspan");
+
+        /**
+         * Attribute "colspan"
+         */
         public static final Attribute COLSPAN = new Attribute("colspan");
+
+        /**
+         * Attribute "prompt"
+         */
         public static final Attribute PROMPT = new Attribute("prompt");
+
+        /**
+         * Attribute "http-equiv"
+         */
         public static final Attribute HTTPEQUIV = new Attribute("http-equiv");
+
+        /**
+         * Attribute "content"
+         */
         public static final Attribute CONTENT = new Attribute("content");
+
+        /**
+         * Attribute "language"
+         */
         public static final Attribute LANGUAGE = new Attribute("language");
+
+        /**
+         * Attribute "version"
+         */
         public static final Attribute VERSION = new Attribute("version");
+
+        /**
+         * Attribute "n"
+         */
         public static final Attribute N = new Attribute("n");
+
+        /**
+         * Attribute "frameborder"
+         */
         public static final Attribute FRAMEBORDER = new Attribute("frameborder");
+
+        /**
+         * Attribute "marginwidth"
+         */
         public static final Attribute MARGINWIDTH = new Attribute("marginwidth");
+
+        /**
+         * Attribute "marginheight"
+         */
         public static final Attribute MARGINHEIGHT = new Attribute("marginheight");
+
+        /**
+         * Attribute "scrolling"
+         */
         public static final Attribute SCROLLING = new Attribute("scrolling");
+
+        /**
+         * Attribute "noresize"
+         */
         public static final Attribute NORESIZE = new Attribute("noresize");
+
+        /**
+         * Attribute "endtag"
+         */
         public static final Attribute ENDTAG = new Attribute("endtag");
+
+        /**
+         * Attribute "comment"
+         */
         public static final Attribute COMMENT = new Attribute("comment");
         static final Attribute MEDIA = new Attribute("media");
 
@@ -645,9 +1258,10 @@
         return value;
     }
 
-    //  This is used in cases where the value for the attribute has not
-    //  been specified.
-    //
+    /**
+     *  {@code NULL_ATTRIBUTE_VALUE} used in cases where the value for the attribute has not
+     *  been specified.
+     */
     public static final String NULL_ATTRIBUTE_VALUE = "#DEFAULT";
 
     // size determined similar to size of tagHashtable