javadoc fixes

Author: rbri

src/main/java/com/gargoylesoftware/css/parser/selector/DescendantSelector.java

@@ -24,6 +24,11 @@ public class DescendantSelector extends AbstractSelector implements Serializable
     private final Selector ancestorSelector_;
     private final SimpleSelector simpleSelector_;
 
+    /**
+     * Ctor.
+     * @param ancestorSelector the ancestor selector
+     * @param simpleSelector the simple selector
+     */
     public DescendantSelector(final Selector ancestorSelector, final SimpleSelector simpleSelector) {
         ancestorSelector_ = ancestorSelector;
         if (ancestorSelector != null) {
@@ -38,6 +43,9 @@ public SelectorType getSelectorType() {
         return SelectorType.DESCENDANT_SELECTOR;
     }
 
+    /**
+     * @return the anchestor selector
+     */
     public Selector getAncestorSelector() {
         return ancestorSelector_;
     }

src/main/java/com/gargoylesoftware/css/parser/selector/DirectAdjacentSelector.java

@@ -24,6 +24,11 @@ public class DirectAdjacentSelector extends AbstractSelector implements Serializ
     private final Selector selector_;  // child
     private final SimpleSelector simpleSelector_;
 
+    /**
+     * Ctor.
+     * @param child the child selector
+     * @param simpleSelector the simple selector
+     */
     public DirectAdjacentSelector(final Selector child, final SimpleSelector simpleSelector) {
         selector_ = child;
         if (child != null) {
@@ -37,6 +42,9 @@ public SelectorType getSelectorType() {
         return SelectorType.DIRECT_ADJACENT_SELECTOR;
     }
 
+    /**
+     * @return the selector
+     */
     public Selector getSelector() {
         return selector_;
     }

src/main/java/com/gargoylesoftware/css/parser/selector/ElementSelector.java

@@ -31,6 +31,11 @@ public class ElementSelector extends AbstractSelector implements SimpleSelector,
     private final String localNameLC_;
     private List<Condition> conditions_;
 
+    /**
+     * Ctor.
+     * @param localName the local name
+     * @param locator the locator
+     */
     public ElementSelector(final String localName, final Locator locator) {
         localName_ = localName;
         if (localName != null) {
@@ -53,14 +58,23 @@ public SimpleSelector getSimpleSelector() {
         return this;
     }
 
+    /**
+     * @return the local name
+     */
     public String getLocalName() {
         return localName_;
     }
 
+    /**
+     * @return the local name in lowercase
+     */
     public String getLocalNameLowerCase() {
         return localNameLC_;
     }
 
+    /**
+     * @return the element name
+     */
     public String getElementName() {
         final String localeName = getLocalName();
         if (localeName == null) {
@@ -69,10 +83,17 @@ public String getElementName() {
         return localeName;
     }
 
+    /**
+     * @return the conditions
+     */
     public List<Condition> getConditions() {
         return conditions_;
     }
 
+    /**
+     * Add a condition.
+     * @param condition the condition to be added
+     */
     public void addCondition(final Condition condition) {
         if (conditions_ == null) {
             conditions_ = new ArrayList<Condition>();
@@ -82,14 +103,14 @@ public void addCondition(final Condition condition) {
 
     @Override
     public String toString() {
-        String localeName = getElementName();
+        final StringBuffer result = new StringBuffer();
+        result.append(getElementName());
 
-        // TODO use StringBuilder
         if (conditions_ != null) {
             for (Condition condition : conditions_) {
-                localeName += condition.toString();
+                result.append(condition);
             }
         }
-        return localeName;
+        return result.toString();
     }
 }

src/main/java/com/gargoylesoftware/css/parser/selector/GeneralAdjacentSelector.java

@@ -24,6 +24,11 @@ public class GeneralAdjacentSelector extends AbstractSelector implements Seriali
     private final Selector selector_;
     private final SimpleSelector simpleSelector_;
 
+    /**
+     * Ctor.
+     * @param child the child selector
+     * @param simpleSelector the simple selector
+     */
     public GeneralAdjacentSelector(final Selector child, final SimpleSelector simpleSelector) {
         selector_ = child;
         if (child != null) {
@@ -37,6 +42,9 @@ public SelectorType getSelectorType() {
         return SelectorType.GENERAL_ADJACENT_SELECTOR;
     }
 
+    /**
+     * @return the selector
+     */
     public Selector getSelector() {
         return selector_;
     }

src/main/java/com/gargoylesoftware/css/parser/selector/PseudoElementSelector.java

@@ -27,6 +27,12 @@ public class PseudoElementSelector extends AbstractSelector implements SimpleSel
     private final String localName_;
     private final boolean doubleColon_;
 
+    /**
+     * Ctor.
+     * @param localName the local name
+     * @param locator the locator
+     * @param doubleColon double column flag
+     */
     public PseudoElementSelector(final String localName, final Locator locator, final boolean doubleColon) {
         localName_ = localName;
         setLocator(locator);
@@ -43,6 +49,9 @@ public SimpleSelector getSimpleSelector() {
         return this;
     }
 
+    /**
+     * @return the local name
+     */
     public String getLocalName() {
         return localName_;
     }