[jira] (MCHANGES-257) Improve filter documentation

["Jared Fordham (JIRA)" <ji...@codehaus.org>]

    [ https://jira.codehaus.org/browse/MCHANGES-257?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=308380#comment-308380 ] 

Jared Fordham commented on MCHANGES-257:
----------------------------------------

A log message, warning / info, might also help users understand a configuration that they are attempting will not being honored.
                
> Improve filter documentation
> ----------------------------
>
>                 Key: MCHANGES-257
>                 URL: https://jira.codehaus.org/browse/MCHANGES-257
>             Project: Maven 2.x Changes Plugin
>          Issue Type: Improvement
>          Components: jira
>    Affects Versions: 2.5
>         Environment: http://maven.apache.org/plugins/maven-changes-plugin/jira-report-mojo.html#filter
>            Reporter: SebbASF
>
> [1] http://maven.apache.org/plugins/maven-changes-plugin/jira-report-mojo.html#filter
> and
> [2] http://maven.apache.org/plugins/maven-changes-plugin/examples/customizing-jira-report.html#Using_JIRA_syntax
> [1] says:
> bq. The filter parameter uses the same format of url parameters that is used in a JIRA search.
> However, it fails to mention that the first & needs to be omitted.
> And does not document what happens if used in conjunction with other forms of filter.
> [2] compares the Jira filter with the Maven-style filter.
> However, the Jira filter includes more than the Maven filter, as it can also be used to define sorting.
> Indeed it appears that the Jira filter overrids all the Maven filters and the sort column names

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://jira.codehaus.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira