[
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