[ http://jira.codehaus.org/browse/DOXIASITETOOLS-51?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=255791#action_255791 ]
SebbASF commented on DOXIASITETOOLS-51: --------------------------------------- The link to [2] is entitled "XML Schema Reference for the site descriptor" which could be better worded, for example: "full reference for the site descriptor" > site.xml <custom> parameter and template variables not documented > ----------------------------------------------------------------- > > Key: DOXIASITETOOLS-51 > URL: http://jira.codehaus.org/browse/DOXIASITETOOLS-51 > Project: Maven Doxia Sitetools > Issue Type: Bug > Reporter: SebbASF > > There's no proper documentation on the Maven site descriptor "custom" tag. > It's not mentioned in the main documentation [1], and is only mentioned in > passing in [2] - which in turn is not referenced from [1] > Here are the full details from [2]: > custom DOM Custom configuration for use with customized > Velocity templates > The DOM reference above appears to be an instance of Xpp3Dom [3]. > Also, the Doxia code sets various context variables (in DefaultSiteRenderer > ?). > This should all be documented, along with some simple examples, and > referenced as necessary from the Maven site plugin documentation > [1] > http://maven.apache.org/plugins/maven-site-plugin/examples/sitedescriptor.html > [2] > http://maven.apache.org/doxia/doxia-sitetools/doxia-decoration-model/decoration.html > [3] > http://plexus.codehaus.org/plexus-utils/apidocs/org/codehaus/plexus/util/xml/Xpp3Dom.html -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira