Specify sorting by q-value for getAcceptable*

svn path=/trunk/; revision=447
diff --git a/src/jsr311-api/src/javax/ws/rs/core/HttpHeaders.java b/src/jsr311-api/src/javax/ws/rs/core/HttpHeaders.java
index 7976190..f031b11 100644
--- a/src/jsr311-api/src/javax/ws/rs/core/HttpHeaders.java
+++ b/src/jsr311-api/src/javax/ws/rs/core/HttpHeaders.java
@@ -49,14 +49,16 @@
 
     /**
      * Get a list of media types that are acceptable for the response.
-     * @return a read-only list of requested response media types
+     * @return a read-only list of requested response media types sorted according
+     * to their q-value, with highest preference first.
      * @throws java.lang.IllegalStateException if called outside the scope of a request
      */
     public List<MediaType> getAcceptableMediaTypes();
     
     /**
      * Get a list of languages that are acceptable for the response.
-     * @return a read-only list of acceptable languages
+     * @return a read-only list of acceptable languages sorted according
+     * to their q-value, with highest preference first.
      * @throws java.lang.IllegalStateException if called outside the scope of a request
      */
     public List<Locale> getAcceptableLanguages();