Re: [PATCH] Documentation: replace [^~] with escapes everywhere

["Avery Pennarun" <apenwarr@gmail.com>]

On Tue, Sep 16, 2008 at 4:24 AM, Junio C Hamano <gitster@pobox.com> wrote:
> Sorry, but this unfortunately does not seem to help asciidoc 8.2.5 on FC9
> at all, which is the combination used at k.org machine that feeds the
> html/man branches to everybody else.
>
> asciidoc 7.1.2 on Deb does not have the problem in git-bundle.html to
> begin with, but it does have the same issue in git-show-ref.html, which
> the patch does fix.
>
> diff --git a/Documentation/asciidoc.conf b/Documentation/asciidoc.conf
> index 40d43b7..8fcdb54 100644
> --- a/Documentation/asciidoc.conf
> +++ b/Documentation/asciidoc.conf
> @@ -15,6 +15,12 @@ startsb=&#91;
>  endsb=&#93;
>  tilde=&#126;
>
> +[replacements]
> +# Disable superscripts.
> +\^(.+?)\^=^\1^
> +# Disable subscripts.
> +~(.+?)~=~\1~
> +
>  ifdef::backend-docbook[]
>  [linkgit-inlinemacro]
>  {0%{target}}

Hmm, browsing around through a newer asciidoc package from Ubuntu, it
appears that in asciidoc 8, those lines are in an
"ifdef::asciidoc7compatible[]" section.  But the quoting mechanism in
8 appears to be improved.

Perhaps a section like this (guessing from the new
/etc/asciidoc/asciidoc.conf) will do the job instead (or in addition,
if we're trying to support both versions):

[quotes]
^=
~=


HTH.  I don't have a real system with asciidoc 8 installed, and now's
not a good time to risk breaking my asciidoc setup, so I definitely
can't test the above.

Have fun,

Avery