[ http://jira.codehaus.org/browse/DOXIA-429?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=267348#action_267348 ]
Christian Schlichtherle commented on DOXIA-429: ----------------------------------------------- The first example is shredded by JIRA and should read (cross fingers I now quote correctly): \{\{http://truezip.java.net\}\} > 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: > {{http://truezip.java.net}} > Some time later you decide you would prefer a name for the link, but you > cannot insert {name} like so: > {{{TrueZIP User Website}http://truezip.java.net}} // BROKEN! > Rather than this, you have to reverse the order and write: > {{{http://truezip.java.net}TrueZIP User Website}} > So the URI effectively moves from {{URI}} to {{{URI}NAME}}. 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