You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Henning Schmiedehausen (JIRA)" <ji...@codehaus.org> on 2007/01/04 09:18:09 UTC
[jira] Updated: (DOXIA-89) Doxia Macro syntax for xdoc sucks
[ http://jira.codehaus.org/browse/DOXIA-89?page=all ]
Henning Schmiedehausen updated DOXIA-89:
----------------------------------------
Attachment: doxia-core.patch
This patch changes the id in the xdoc parser to macroId and the id in the snippet macro to snippetId.
> 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