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

From: Junio C Hamano <gitster@pobox.com>
Date: Sep 16, 2008, 08:24 UTC
Message-ID: <7vy71s7b26.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <32541b130809151710j59963af9id84b3c1553ec738d@mail.gmail.com>

"Avery Pennarun" <apenwarr@gmail.com> writes:

Show 21 quoted lines

> On Mon, Sep 15, 2008 at 8:05 PM, Thomas Rast <trast@student.ethz.ch> wrote:
>> Avery Pennarun wrote:
>>> Rather than uglifying all the documentation to work around the syntax,
>>> perhaps we just want to disable subscripts and superscripts
>>> altogether?  I can't really imagine the git documentation needing
>>> them.
>>>
>>> To do so, we can add these lines to asciidoc.conf (I just did this on
>>> another project yesterday, but I haven't tested in git.git):
>>>
>>> [replacements]
>>> # Disable superscripts.
>>> \^(.+?)\^=^\1^
>>> # Disable subscripts.
>>> ~(.+?)~=~\1~
>>
>> That's indeed a far superior solution.  I withdraw my patches in
>> favour of this.
>
> Er, do you mind submitting (and testing :)) a new patch that does it?
> I don't have time right now.

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}}