Re: [PATCH] urls.txt: Use substitution to escape square brackets

From: Junio C Hamano <junkio@cox.net>
Date: Jul 14, 2006, 23:13 UTC
Message-ID: <7v8xmvok49.fsf@assigned-by-dhcp.cox.net>
In-Reply-To: <44B82243.20604@atoker.com>

Alp Toker <alp@atoker.com> writes:

Show 12 quoted lines

> Junio C Hamano wrote:
>>
>> Looks nicer.  Alp?  Does this work with your version of
>> asciidoc?
>
> I'm using asciidoc 7.0.2, which came with Ubuntu Dapper.
>
> The man page output now looks like this:
>
>        ·  ssh://[ # [user@] # ]host.xz/path/to/repo.git/
>        ·  ssh://[ # [user@] # ]host.xz/~user/path/to/repo.git/
>        ·  ssh://[ # [user@] # ]host.xz/~/path/to/repo.git

I got a bit inventive and removed the comments after #, which were in Jonas's version, when I tried it out. Maybe doing the same might help you, since I suspect the above '#' are coming from the comment part.

Show 8 quoted lines

> Out of the three patches,
>
>   (at) "ssh://[user@]host.xz/path/to/repo.git/"
>   (jc) "ssh://+++[user@+++]host.xz/path/to/repo.git/"
>   (jf) "ssh://{startsb}user@{endsb}host.xz/path/to/repo.git/"
>
> I'd say (at) is still most readable, not requiring +++ markup (jc) or
> hacks to asciidoc.conf (jf).

I do not think defining [attribute] is a hack; it is a documented feature.