[ 
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

        

Reply via email to