[jira] Commented: (DOXIA-89) Doxia Macro syntax for xdoc sucks

["Jason van Zyl (JIRA)" <ji...@codehaus.org>]

    [ 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