[
http://jira.codehaus.org/browse/DOXIA-89?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#action_97286
]
Jason van Zyl commented on DOXIA-89:
------------------------------------
If this incorporate using the current notation that would be fine.
> Doxia Macro syntax for xdoc sucks
> ---------------------------------
>
> Key: DOXIA-89
> URL: http://jira.codehaus.org/browse/DOXIA-89
> Project: doxia
> Issue Type: Bug
> Components: Core
> Affects Versions: 1.0-alpha-8
> Reporter: Henning Schmiedehausen
> Attachments: doxia-core.patch
>
>
> In the xdoc parser, Doxia uses <macro id="foo" /> to reference the 'foo'
> macro. This is an unfortunate choice because it allows each macro on each
> xdoc page only once (id must be unique).
> I'd suggest that this gets changed to e.g. macroName.
> Also, some macros (most prominently the snippet macro) might require an 'id'
> parameter, which not only clashes with the notation above but also leaves the
> problem that this id might clash with another id and can not be used twice on
> a page.
> I'd suggest that in a possible Doxia manual, the usage of an 'id' parameter
> is strongly discouraged.
> For the snippet macro, I'd suggest changing 'id' to 'snippetId'.
--
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
