maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andreas Sewe (JIRA)" <j...@codehaus.org>
Subject [jira] (MSITE-628) Format of report goal names for /project/menu/item/@ref not properly documented
Date Mon, 20 Aug 2012 07:51:21 GMT

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

Andreas Sewe commented on MSITE-628:
------------------------------------

Unfortunately, the anchor of the item I am referring to isn't unique (should we fixed as well),
so I can't provide you a link, only a description on how to get there: Go to http://maven.apache.org/doxia/doxia-sitetools/doxia-decoration-model/decoration.html;
the very last subsection of the page contains the offending description:

{quote}
A reference to a pre-defined menu item, such as a report (specified by the report goal name).
Any elements explicitly given override those from the pre-defined reference.
{quote}

Also, given that there are several attributes {{ref}} described on this page, it might be
worth keeping their descriptions in-sync (if they indeed support the same value set).
                
> Format of report goal names for /project/menu/item/@ref not properly documented
> -------------------------------------------------------------------------------
>
>                 Key: MSITE-628
>                 URL: https://jira.codehaus.org/browse/MSITE-628
>             Project: Maven 2.x and 3.x Site Plugin
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 3.0
>         Environment: Apache Maven 3.0.4 (r1232337; 2012-01-17 09:44:56+0100)
>            Reporter: Andreas Sewe
>            Priority: Minor
>
> This is probably just a documentation issue rather than a bug: I am unable (using Maven
3.0.4, {{maven-site-plugin}} 3.0) to set {{/project/menu/item/@ref}} such that the plugin
actually recognizes the reference:
> {quote}
> [WARNING] Unrecognised reference: 'project-info-reports:mailing-list'
> {quote}
> (Also, just {{mailing-list}} and {{maven-project-info-reports-plugin:mailing-list}} won't
work either.)
> The documentation in the XML Schema is unfortunately not very helpful:
> {quote}
> A reference to a pre-defined menu item, such as a report (specified by the report goal
name). Any elements explicitly given override those from the pre-defined reference.
> {quote}
> An example showing the proper _report goal name_ format would thus be a helpful addition
to the XML Schema.

--
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

        

Mime
View raw message