2005-11-13 Wolfgang Baer <WBaer@gmx.de>

	* javax/print/attribute/HashDocAttributeSet.java,
	* javax/print/attribute/HashPrintJobAttributeSet.java,
	* javax/print/attribute/HashPrintRequestAttributeSet.java,
	* javax/print/attribute/HashPrintServiceAttributeSet.java,
	Added class api docs and enhanced method api docs.

4 files changed, 56 insertions, 32 deletions

diff --git a/javax/print/attribute/HashDocAttributeSet.java b/javax/print/attribute/HashDocAttributeSet.java
index 1647ae2f9..2317db3bc 100644
--- a/javax/print/attribute/HashDocAttributeSet.java
+++ b/javax/print/attribute/HashDocAttributeSet.java
@@ -1,5 +1,5 @@
 /* HashDocAttributeSet.java -- 
-   Copyright (C) 2003 Free Software Foundation, Inc.
+   Copyright (C) 2003, 2005 Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -39,6 +39,10 @@ package javax.print.attribute;
 
 import java.io.Serializable;
 
+/**
+ * <code>HashDocAttributeSet</code> provides an implementation of
+ * {@link javax.print.attribute.DocAttributeSet}.
+ */
 public class HashDocAttributeSet extends HashAttributeSet
   implements DocAttributeSet, Serializable
 {
@@ -56,7 +60,7 @@ public class HashDocAttributeSet extends HashAttributeSet
    * Creates a <code>HashDocAttributeSet</code> object with the given
    * attribute in it.
    *
-   * @param attribute the attriute tu put into the attribute set
+   * @param attribute the attribute to put into the attribute set
    *
    * @exception NullPointerException if attribute is null
    */
@@ -69,9 +73,11 @@ public class HashDocAttributeSet extends HashAttributeSet
    * Creates a <code>HashDocAttributeSet</code> object with the given
    * attributes in it.
    *
-   * @param attributes the attributes to put into the attribute set
+   * @param attributes the array of attributes to put into the set. If
+   * <code>null</code> an empty set is created.
    *
-   * @exception NullPointerException if attributes is null
+   * @exception NullPointerException if one of the attributes of the given
+   * array is null.
    */
   public HashDocAttributeSet(DocAttribute[] attributes)
   {
@@ -79,11 +85,11 @@ public class HashDocAttributeSet extends HashAttributeSet
   }
 
   /**
-   * Creates a <code>HashDocAttributeSet</code> object with the given
-   * attributes in it.
-   *
-   * @param attributes the attributes to put into the attribute set
+   * Creates a <code>HashDocAttributeSet</code> object with the attributes
+   * of the given attributes set in it.
    *
+   * @param attributes the attributes set to put into the set. If 
+   * <code>null</code> an empty set is created.
    * @exception ClassCastException if any element of attributes is not
    * an instance of <code>DocAttribute</code>
    */
diff --git a/javax/print/attribute/HashPrintJobAttributeSet.java b/javax/print/attribute/HashPrintJobAttributeSet.java
index 84fa7ec5d..ac4c902c3 100644
--- a/javax/print/attribute/HashPrintJobAttributeSet.java
+++ b/javax/print/attribute/HashPrintJobAttributeSet.java
@@ -1,5 +1,5 @@
 /* HashPrintJobAttributeSet.java -- 
-   Copyright (C) 2003 Free Software Foundation, Inc.
+   Copyright (C) 2003, 2005 Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -39,6 +39,10 @@ package javax.print.attribute;
 
 import java.io.Serializable;
 
+/**
+ * <code>HashPrintJobAttributeSet</code> provides an implementation of
+ * {@link javax.print.attribute.PrintJobAttributeSet}.
+ */
 public class HashPrintJobAttributeSet extends HashAttributeSet
   implements Serializable, PrintJobAttributeSet
 {
@@ -56,7 +60,7 @@ public class HashPrintJobAttributeSet extends HashAttributeSet
    * Creates a <code>HashPrintJobAttributeSet</code> object with the given
    * attribute in it.
    *
-   * @param attribute the attriute tu put into the attribute set
+   * @param attribute the attribute to put into the attribute set
    *
    * @exception NullPointerException if attribute is null
    */
@@ -69,9 +73,11 @@ public class HashPrintJobAttributeSet extends HashAttributeSet
    * Creates a <code>HashPrintJobAttributeSet</code> object with the given
    * attributes in it.
    *
-   * @param attributes the attributes to put into the attribute set
+   * @param attributes the array of attributes to put into the set. If
+   * <code>null</code> an empty set is created.
    *
-   * @exception NullPointerException if attributes is null
+   * @exception NullPointerException if one of the attributes of the given
+   * array is null.
    */
   public HashPrintJobAttributeSet(PrintJobAttribute[] attributes)
   {
@@ -79,11 +85,11 @@ public class HashPrintJobAttributeSet extends HashAttributeSet
   }
   
   /**
-   * Creates a <code>HashPrintJobAttributeSet</code> object with the given
-   * attributes in it.
-   *
-   * @param attributes the attributes to put into the attribute set
+   * Creates a <code>HashPrintJobAttributeSet</code> object with the attributes
+   * of the given attributes set in it.
    *
+   * @param attributes the attributes set to put into the set. If 
+   * <code>null</code> an empty set is created.
    * @exception ClassCastException if any element of attributes is not
    * an instance of <code>PrintJobAttribute</code>
    */
diff --git a/javax/print/attribute/HashPrintRequestAttributeSet.java b/javax/print/attribute/HashPrintRequestAttributeSet.java
index 29a17861f..e74c0e00f 100644
--- a/javax/print/attribute/HashPrintRequestAttributeSet.java
+++ b/javax/print/attribute/HashPrintRequestAttributeSet.java
@@ -1,5 +1,5 @@
 /* HashPrintRequestAttributeSet.java -- 
-   Copyright (C) 2003 Free Software Foundation, Inc.
+   Copyright (C) 2003, 2005 Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -39,6 +39,10 @@ package javax.print.attribute;
 
 import java.io.Serializable;
 
+/**
+ * <code>HashPrintRequestAttributeSet</code> provides an implementation of
+ * {@link javax.print.attribute.PrintRequestAttributeSet}.
+ */
 public class HashPrintRequestAttributeSet extends HashAttributeSet
   implements Serializable, PrintRequestAttributeSet
 {
@@ -56,7 +60,7 @@ public class HashPrintRequestAttributeSet extends HashAttributeSet
    * Creates a <code>HashPrintRequestAttributeSet</code> object with the given
    * attribute in it.
    *
-   * @param attribute the attriute tu put into the attribute set
+   * @param attribute the attribute to put into the attribute set
    *
    * @exception NullPointerException if attribute is null
    */
@@ -69,9 +73,11 @@ public class HashPrintRequestAttributeSet extends HashAttributeSet
    * Creates a <code>HashPrintRequestAttributeSet</code> object with the given
    * attributes in it.
    *
-   * @param attributes the attributes to put into the attribute set
+   * @param attributes the array of attributes to put into the set. If
+   * <code>null</code> an empty set is created.
    *
-   * @exception NullPointerException if attributes is null
+   * @exception NullPointerException if one of the attributes of the given
+   * array is null.
    */
   public HashPrintRequestAttributeSet(PrintRequestAttribute[] attributes)
   {
@@ -79,11 +85,11 @@ public class HashPrintRequestAttributeSet extends HashAttributeSet
   }
   
   /**
-   * Creates a <code>HashPrintRequestAttributeSet</code> object with the given
-   * attributes in it.
-   *
-   * @param attributes the attributes to put into the attribute set
+   * Creates a <code>HashPrintRequestAttributeSet</code> object with the attributes
+   * of the given attributes set in it.
    *
+   * @param attributes the attributes set to put into the set. If 
+   * <code>null</code> an empty set is created.
    * @exception ClassCastException if any element of attributes is not
    * an instance of <code>PrintRequestAttribute</code>
    */
diff --git a/javax/print/attribute/HashPrintServiceAttributeSet.java b/javax/print/attribute/HashPrintServiceAttributeSet.java
index 60e12bff0..155514f2b 100644
--- a/javax/print/attribute/HashPrintServiceAttributeSet.java
+++ b/javax/print/attribute/HashPrintServiceAttributeSet.java
@@ -1,5 +1,5 @@
 /* HashPrintServiceAttributeSet.java -- 
-   Copyright (C) 2003 Free Software Foundation, Inc.
+   Copyright (C) 2003, 2005 Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -39,6 +39,10 @@ package javax.print.attribute;
 
 import java.io.Serializable;
 
+/**
+ * <code>HashPrintServiceAttributeSet</code> provides an implementation of
+ * {@link javax.print.attribute.PrintServiceAttributeSet}.
+ */
 public class HashPrintServiceAttributeSet extends HashAttributeSet
   implements Serializable, PrintServiceAttributeSet
 {
@@ -56,7 +60,7 @@ public class HashPrintServiceAttributeSet extends HashAttributeSet
    * Creates a <code>HashPrintServiceAttributeSet</code> object with the given
    * attribute in it.
    *
-   * @param attribute the attriute tu put into the attribute set
+   * @param attribute the attribute to put into the attribute set
    *
    * @exception NullPointerException if attribute is null
    */
@@ -69,9 +73,11 @@ public class HashPrintServiceAttributeSet extends HashAttributeSet
    * Creates a <code>HashPrintServiceAttributeSet</code> object with the given
    * attributes in it.
    *
-   * @param attributes the attributes to put into the attribute set
+   * @param attributes the array of attributes to put into the set. If
+   * <code>null</code> an empty set is created.
    *
-   * @exception NullPointerException if attributes is null
+   * @exception NullPointerException if one of the attributes of the given
+   * array is null.
    */
   public HashPrintServiceAttributeSet(PrintServiceAttribute[] attributes)
   {
@@ -79,11 +85,11 @@ public class HashPrintServiceAttributeSet extends HashAttributeSet
   }
   
   /**
-   * Creates a <code>HashPrintServiceAttributeSet</code> object with the given
-   * attributes in it.
-   *
-   * @param attributes the attributes to put into the attribute set
+   * Creates a <code>HashPrintServiceAttributeSet</code> object with the attributes
+   * of the given attributes set in it.
    *
+   * @param attributes the attributes set to put into the set. If 
+   * <code>null</code> an empty set is created.
    * @exception ClassCastException if any element of attributes is not
    * an instance of <code>PrintServiceAttribute</code>
    */