[ http://jira.codehaus.org/browse/DOXIA-429?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Dennis Lundberg updated DOXIA-429: ---------------------------------- Description: 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. was: 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. > 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