get rid of all the w3c dependencies

rbri · rbri · commit bd3fa8687e1c · 2018-12-22T19:06:58.000+01:00
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSCharsetRuleImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSCharsetRuleImpl.java
@@ -25,7 +25,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link AbstractCSSRuleImpl}.
+ * Implementation of CSSCharsetRule.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSFontFaceRuleImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSFontFaceRuleImpl.java
@@ -25,7 +25,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link CSSFontFaceRule}.
+ * Implementation of CSSFontFaceRule.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSImportRuleImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSImportRuleImpl.java
@@ -25,9 +25,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link CSSImportRule}.
- *
- * TODO: Implement getStyleSheet()
+ * Implementation of CSSImportRule.
  *
  * @author Ronald Brill
  */
@@ -125,7 +123,7 @@ public MediaListImpl getMedia() {
     }
 
     public CSSStyleSheetImpl getStyleSheet() {
-        return null;
+        return getParentStyleSheet();
     }
 
     @Override
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSMediaRuleImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSMediaRuleImpl.java
@@ -28,7 +28,7 @@
 import com.gargoylesoftware.css.util.ThrowCssExceptionErrorHandler;
 
 /**
- * Implementation of {@link CSSMediaRule}.
+ * Implementation of CSSMediaRule.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSPageRuleImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSPageRuleImpl.java
@@ -25,9 +25,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link CSSPageRule}.
- *
- * TODO: Implement setSelectorText()
+ * Implementation of CSSPageRule.
  *
  * @author Ronald Brill
  */
@@ -115,9 +113,6 @@ public String getSelectorText() {
         return pseudoPage_;
     }
 
-    public void setSelectorText(final String selectorText) throws DOMException {
-    }
-
     public CSSStyleDeclarationImpl getStyle() {
         return style_;
     }
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSRuleListImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSRuleListImpl.java
@@ -21,7 +21,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link CSSRuleList}.
+ * Implementation of CSSRuleList.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSStyleDeclarationImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSStyleDeclarationImpl.java
@@ -26,7 +26,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link CSSStyleDeclaration}.
+ * Implementation of CSSStyleDeclaration.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSStyleRuleImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSStyleRuleImpl.java
@@ -26,7 +26,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link CSSStyleRule}.
+ * Implementation of CSSStyleRule.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSStyleSheetImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSStyleSheetImpl.java
@@ -41,7 +41,7 @@
 import com.gargoylesoftware.css.util.ThrowCssExceptionErrorHandler;
 
 /**
- * Implementation of {@link CSSStyleSheet}.
+ * Implementation of CSSStyleSheet.
  *
  * @author Ronald Brill
  */
@@ -69,13 +69,17 @@ public String getType() {
         return "text/css";
     }
 
+    /**
+     * @return the disable state
+     */
     public boolean getDisabled() {
         return disabled_;
     }
 
     /**
      * We will need to respond more fully if a stylesheet is disabled, probably
      * by generating an event for the main application.
+     * @param disabled the new disabled
      */
     public void setDisabled(final boolean disabled) {
         disabled_ = disabled;
@@ -248,10 +252,16 @@ public void setMediaText(final String mediaText) {
         }
     }
 
+    /**
+     * @param ownerRule the new ownerRule
+     */
     public void setOwnerRule(final AbstractCSSRuleImpl ownerRule) {
         ownerRule_ = ownerRule;
     }
 
+    /**
+     * @param rules the new rules
+     */
     public void setCssRules(final CSSRuleListImpl rules) {
         cssRules_ = rules;
     }
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSStyleSheetListImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSStyleSheetListImpl.java
@@ -21,7 +21,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link StyleSheetList}.
+ * Implementation of StyleSheetList.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CSSUnknownRuleImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CSSUnknownRuleImpl.java
@@ -25,7 +25,7 @@
 import com.gargoylesoftware.css.util.LangUtils;
 
 /**
- * Implementation of {@link CSSUnknownRule}.
+ * Implementation of CSSUnknownRule.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/CounterImpl.java b/src/main/java/com/gargoylesoftware/css/dom/CounterImpl.java
@@ -22,7 +22,7 @@
 import com.gargoylesoftware.css.parser.LexicalUnit.LexicalUnitType;
 
 /**
- * Implementation of {@link Counter}.
+ * Implementation of Counter.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/MediaListImpl.java b/src/main/java/com/gargoylesoftware/css/dom/MediaListImpl.java
@@ -32,7 +32,7 @@
 import com.gargoylesoftware.css.util.ThrowCssExceptionErrorHandler;
 
 /**
- * Implements {@link MediaList}.
+ * Implementation of MediaList.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/dom/RGBColorImpl.java b/src/main/java/com/gargoylesoftware/css/dom/RGBColorImpl.java
@@ -22,7 +22,7 @@
 import com.gargoylesoftware.css.parser.LexicalUnit.LexicalUnitType;
 
 /**
- * Implementation of {@link RGBColor}.
+ * Implementation of RGBColor.
  *
  * @author Ronald Brill
  */
@@ -72,7 +72,7 @@ public RGBColorImpl(final LexicalUnit lu) throws DOMException {
     }
 
     /**
-     * Returns the red part.
+     * @return the red part.
      */
     public CSSValueImpl getRed() {
         return red_;
@@ -87,7 +87,7 @@ public void setRed(final CSSValueImpl red) {
     }
 
     /**
-     * Returns the green part.
+     * @return the green part.
      */
     public CSSValueImpl getGreen() {
         return green_;
@@ -102,7 +102,7 @@ public void setGreen(final CSSValueImpl green) {
     }
 
     /**
-     * Returns the blue part.
+     * @return the blue part.
      */
     public CSSValueImpl getBlue() {
         return blue_;
diff --git a/src/main/java/com/gargoylesoftware/css/dom/RectImpl.java b/src/main/java/com/gargoylesoftware/css/dom/RectImpl.java
@@ -22,7 +22,7 @@
 import com.gargoylesoftware.css.parser.LexicalUnit.LexicalUnitType;
 
 /**
- * Implementation of {@link Rect}.
+ * Implementation of Rect.
  *
  * @author Ronald Brill
  */
@@ -116,7 +116,7 @@ public RectImpl(final LexicalUnit lu) throws DOMException {
     }
 
     /**
-     * Returns the top part.
+     * @return the top part.
      */
     public CSSValueImpl getTop() {
         return top_;
@@ -131,7 +131,7 @@ public void setTop(final CSSValueImpl top) {
     }
 
     /**
-     * Returns the right part.
+     * @return the right part.
      */
     public CSSValueImpl getRight() {
         return right_;
@@ -146,7 +146,7 @@ public void setRight(final CSSValueImpl right) {
     }
 
     /**
-     * Returns the bottom part.
+     * @return the bottom part.
      */
     public CSSValueImpl getBottom() {
         return bottom_;
@@ -161,7 +161,7 @@ public void setBottom(final CSSValueImpl bottom) {
     }
 
     /**
-     * Returns the left part.
+     * @return the left part.
      */
     public CSSValueImpl getLeft() {
         return left_;
diff --git a/src/main/java/com/gargoylesoftware/css/parser/AbstractCSSParser.java b/src/main/java/com/gargoylesoftware/css/parser/AbstractCSSParser.java
@@ -583,6 +583,10 @@ protected int getLastNumPos(final String s) {
      * This could be done directly in the parser, but portions of the lexer would have to be moved
      * to the parser, meaning that the grammar would no longer match the standard grammar specified
      * by the W3C. This would make the parser and lexer much less maintainable.
+     *
+     * @param s the string to unescape
+     * @param unescapeDoubleQuotes if true unescape double quotes also
+     * @return the unescaped string
      */
     public String unescape(final String s, final boolean unescapeDoubleQuotes) {
         if (s == null) {
diff --git a/src/main/java/com/gargoylesoftware/css/parser/CssCharStream.java b/src/main/java/com/gargoylesoftware/css/parser/CssCharStream.java
@@ -259,7 +259,13 @@ public final void backup(int amount) {
       bufpos += bufsize;
   }
 
-  /** Constructor. */
+  /**
+   * Constructor.
+   * @param dstream the stream to read from
+   * @param startline startline
+   * @param startcolumn startcolumn
+   * @param buffersize buffersize
+   */
   public CssCharStream(java.io.Reader dstream, int startline, int startcolumn, int buffersize)
   {
     inputStream = dstream;
@@ -272,9 +278,13 @@ public CssCharStream(java.io.Reader dstream, int startline, int startcolumn, int
     bufcolumn = new int[buffersize];
   }
 
-  /** Constructor. */
-  public CssCharStream(java.io.Reader dstream, int startline,
-                                                          int startcolumn)
+  /**
+   * Constructor.
+   * @param dstream the stream to read from
+   * @param startline startline
+   * @param startcolumn startcolumn
+   */
+  public CssCharStream(java.io.Reader dstream, int startline, int startcolumn)
   {
     this(dstream, startline, startcolumn, 4096);
   }
@@ -316,6 +326,8 @@ public void Done()
 
   /**
    * Method to adjust line and column numbers for the start of a token.
+   * @param newLine the new line
+   * @param newCol the new column
    */
   public void adjustBeginLineColumn(int newLine, int newCol)
   {
diff --git a/src/main/java/com/gargoylesoftware/css/parser/media/MediaQueryList.java b/src/main/java/com/gargoylesoftware/css/parser/media/MediaQueryList.java
@@ -20,7 +20,7 @@
 import com.gargoylesoftware.css.parser.AbstractLocatable;
 
 /**
- * Implementation of {@link MediaQueryList}.
+ * Implementation of MediaQueryList.
  *
  * @author Ronald Brill
  */
diff --git a/src/main/java/com/gargoylesoftware/css/parser/selector/SelectorListImpl.java b/src/main/java/com/gargoylesoftware/css/parser/selector/SelectorListImpl.java
@@ -25,7 +25,7 @@
 import com.gargoylesoftware.css.parser.AbstractLocatable;
 
 /**
- * Implementation of {@link SelectorList}.
+ * Implementation of SelectorList.
  *
  * @author Ronald Brill
  */

Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,7 @@`
`25`	`25`	`import com.gargoylesoftware.css.util.LangUtils;`
`26`	`26`
`27`	`27`	`/**`
`28`		`- * Implementation of {@link AbstractCSSRuleImpl}.`
	`28`	`+ * Implementation of CSSCharsetRule.`
`29`	`29`	`*`
`30`	`30`	`* @author Ronald Brill`
`31`	`31`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -25,9 +25,7 @@`
`25`	`25`	`import com.gargoylesoftware.css.util.LangUtils;`
`26`	`26`
`27`	`27`	`/**`
`28`		`- * Implementation of {@link CSSImportRule}.`
`29`		`- *`
`30`		`- * TODO: Implement getStyleSheet()`
	`28`	`+ * Implementation of CSSImportRule.`
`31`	`29`	`*`
`32`	`30`	`* @author Ronald Brill`
`33`	`31`	`*/`
`@@ -125,7 +123,7 @@ public MediaListImpl getMedia() {`
`125`	`123`	`}`
`126`	`124`
`127`	`125`	`public CSSStyleSheetImpl getStyleSheet() {`
`128`		`- return null;`
	`126`	`+ return getParentStyleSheet();`
`129`	`127`	`}`
`130`	`128`
`131`	`129`	`@Override`
Original file line number	Diff line number	Diff line change
`@@ -28,7 +28,7 @@`
`28`	`28`	`import com.gargoylesoftware.css.util.ThrowCssExceptionErrorHandler;`
`29`	`29`
`30`	`30`	`/**`
`31`		`- * Implementation of {@link CSSMediaRule}.`
	`31`	`+ * Implementation of CSSMediaRule.`
`32`	`32`	`*`
`33`	`33`	`* @author Ronald Brill`
`34`	`34`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,7 @@`
`21`	`21`	`import com.gargoylesoftware.css.util.LangUtils;`
`22`	`22`
`23`	`23`	`/**`
`24`		`- * Implementation of {@link CSSRuleList}.`
	`24`	`+ * Implementation of CSSRuleList.`
`25`	`25`	`*`
`26`	`26`	`* @author Ronald Brill`
`27`	`27`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -26,7 +26,7 @@`
`26`	`26`	`import com.gargoylesoftware.css.util.LangUtils;`
`27`	`27`
`28`	`28`	`/**`
`29`		`- * Implementation of {@link CSSStyleDeclaration}.`
	`29`	`+ * Implementation of CSSStyleDeclaration.`
`30`	`30`	`*`
`31`	`31`	`* @author Ronald Brill`
`32`	`32`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -41,7 +41,7 @@`
`41`	`41`	`import com.gargoylesoftware.css.util.ThrowCssExceptionErrorHandler;`
`42`	`42`
`43`	`43`	`/**`
`44`		`- * Implementation of {@link CSSStyleSheet}.`
	`44`	`+ * Implementation of CSSStyleSheet.`
`45`	`45`	`*`
`46`	`46`	`* @author Ronald Brill`
`47`	`47`	`*/`
`@@ -69,13 +69,17 @@ public String getType() {`
`69`	`69`	`return "text/css";`
`70`	`70`	`}`
`71`	`71`
	`72`	`+ /**`
	`73`	`+ * @return the disable state`
	`74`	`+ */`
`72`	`75`	`public boolean getDisabled() {`
`73`	`76`	`return disabled_;`
`74`	`77`	`}`
`75`	`78`
`76`	`79`	`/**`
`77`	`80`	`* We will need to respond more fully if a stylesheet is disabled, probably`
`78`	`81`	`* by generating an event for the main application.`
	`82`	`+ * @param disabled the new disabled`
`79`	`83`	`*/`
`80`	`84`	`public void setDisabled(final boolean disabled) {`
`81`	`85`	`disabled_ = disabled;`
`@@ -248,10 +252,16 @@ public void setMediaText(final String mediaText) {`
`248`	`252`	`}`
`249`	`253`	`}`
`250`	`254`
	`255`	`+ /**`
	`256`	`+ * @param ownerRule the new ownerRule`
	`257`	`+ */`
`251`	`258`	`public void setOwnerRule(final AbstractCSSRuleImpl ownerRule) {`
`252`	`259`	`ownerRule_ = ownerRule;`
`253`	`260`	`}`
`254`	`261`
	`262`	`+ /**`
	`263`	`+ * @param rules the new rules`
	`264`	`+ */`
`255`	`265`	`public void setCssRules(final CSSRuleListImpl rules) {`
`256`	`266`	`cssRules_ = rules;`
`257`	`267`	`}`