Update Javadoc, note that isCompatible is commutative.

svn path=/trunk/; revision=465
diff --git a/src/jsr311-api/src/javax/ws/rs/core/MediaType.java b/src/jsr311-api/src/javax/ws/rs/core/MediaType.java
index c8cddc6..ca2328b 100644
--- a/src/jsr311-api/src/javax/ws/rs/core/MediaType.java
+++ b/src/jsr311-api/src/javax/ws/rs/core/MediaType.java
@@ -199,8 +199,8 @@
     /**
      * Check if this media type is compatible with another media type. E.g.
      * image/* is compatible with image/jpeg, image/png, etc. Media type
-     * parameters are ignored.
-     * @return true if other is a subtype of this media type, false otherwise.
+     * parameters are ignored. The function is commutative.
+     * @return true if the types are compatible, false otherwise.
      * @param other the media type to compare with
      */
     public boolean isCompatible(MediaType other) {