[MCHANGES-285] SAXException parsing JIRA XML from JIRA 5.1 

- Document how the sorting of columns works when using JQL.

git-svn-id: https://svn.apache.org/repos/asf/maven/plugins/trunk@1380880 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/maven/plugin/jira/JiraMojo.java b/src/main/java/org/apache/maven/plugin/jira/JiraMojo.java
index 6b82c49..77ac538 100644
--- a/src/main/java/org/apache/maven/plugin/jira/JiraMojo.java
+++ b/src/main/java/org/apache/maven/plugin/jira/JiraMojo.java
@@ -218,7 +218,10 @@
      * sort column names in the reverse order. The handling of this changed
      * between JIRA 3 and JIRA 4. The current default value is suitable for
      * JIRA 3. This may change in the future, so please configure your sort
-     * column names in an order that works for your own JIRA version.
+     * column names in an order that works for your own JIRA version. If you
+     * use JQL, by setting the <code>useJql</code> parameter to
+     * <code>true</code>, then the order of the fields are in normal order
+     * again. Starting with JIRA 5.1 you have to use JQL.
      * </p>
      *
      * @since 2.0