[
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
