This patch (committed) updates the API docs for Arrays.asList() to note what happens
for a null argument (which is something I needed to know this morning):
2006-07-12 David Gilbert <[EMAIL PROTECTED]>
* java/util/Arrays.java
(asList): Updated API docs.
Regards,
Dave
Index: java/util/Arrays.java
===================================================================
RCS file: /sources/classpath/classpath/java/util/Arrays.java,v
retrieving revision 1.29
diff -u -r1.29 Arrays.java
--- java/util/Arrays.java 9 Jun 2006 17:02:32 -0000 1.29
+++ java/util/Arrays.java 12 Jul 2006 10:44:14 -0000
@@ -1,5 +1,5 @@
/* Arrays.java -- Utility class with methods to operate on arrays
- Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005
+ Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
Free Software Foundation, Inc.
This file is part of GNU Classpath.
@@ -2341,8 +2341,10 @@
* value modification. The returned list implements both Serializable and
* RandomAccess.
*
- * @param a the array to return a view of
+ * @param a the array to return a view of (<code>null</code> not permitted)
* @return a fixed-size list, changes to which "write through" to the array
+ *
+ * @throws NullPointerException if <code>a</code> is <code>null</code>.
* @see Serializable
* @see RandomAccess
* @see Arrays.ArrayList
