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

From: Avery Pennarun <apenwarr@gmail.com>
Date: Sep 16, 2008, 15:58 UTC
Message-ID: <32541b130809160858k3c019f6pdc4831c831e22b55@mail.gmail.com>
In-Reply-To: <7vy71s7b26.fsf@gitster.siamese.dyndns.org>

On Tue, Sep 16, 2008 at 4:24 AM, Junio C Hamano <gitster@pobox.com> wrote:

Show 25 quoted lines

> 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