[
http://jira.codehaus.org/browse/DOXIA-429?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=267425#action_267425
]
Lukas Theussl commented on DOXIA-429:
-------------------------------------
So all you want is reverse the order of NAME and URI? Why? The apt format is
defined the way it is, if you don't like it just use something else. I will
close this as 'Won't fix' unless there is some reasonable objection.
> Broken link syntax in APT
> -------------------------
>
> Key: DOXIA-429
> URL: http://jira.codehaus.org/browse/DOXIA-429
> Project: Maven Doxia
> Issue Type: Bug
> Components: Module - Apt
> Affects Versions: 1.2
> Reporter: Christian Schlichtherle
> Priority: Minor
>
> A common cause of frustration is APT's linking feature. Consider this
> example: You want to link to an external resource without a name for the
> link. So you do write:
> {noformat}
> {{http://truezip.java.net}}
> {noformat}
> Some time later you decide you would prefer a name for the link, but you
> cannot insert {name} like so:
> {noformat}
> {{{TrueZIP User Website}http://truezip.java.net}} // BROKEN!
> {noformat}
> Rather than this, you have to reverse the order and write:
> {noformat}
> {{{http://truezip.java.net}TrueZIP User Website}}
> {noformat}
> So the URI effectively moves from
> {noformat}
> {{URI}}{noformat}
> to
> {noformat}
> {{{URI}NAME}}
> {noformat}
> This is really annoying!
> I know you can't change this without breaking compatibility. So please
> provide a new linking feature, probably something like this:
> [[URI]] and [[[NAME]URI]] respectively.
--
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
