You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Christian Schlichtherle (JIRA)" <ji...@codehaus.org> on 2011/05/18 18:20:22 UTC

[jira] Commented: (DOXIA-429) Broken link syntax in APT

    [ 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