[PATCH] Documentation: disable sub/superscript characters ^/~

From: Thomas Rast <trast@student.ethz.ch>
Date: Sep 16, 2008, 12:47 UTC
Message-ID: <1221569238-29263-1-git-send-email-trast@student.ethz.ch>
In-Reply-To: <7vy71s7b26.fsf@gitster.siamese.dyndns.org>

Disables the special meaning of ^ and ~ as per the Asciidoc FAQ,

  http://www.methods.co.nz/asciidoc/faq.html#_how_can_i_disable_a_quoted_text_substitution

Signed-off-by: Thomas Rast <trast@student.ethz.ch>

---

Junio C Hamano 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.

This seems to do the trick on 8.2.5 here.

Unfortunately, the changelog for 8.0 says that setting the quote character to an empty replacement is new in 8.0 (I can't test with 7.x), and I cannot find a way to make an 'if version >= 8' block. (Why does it have ifdef but no if?)

So maybe if someone sees a way to do this version-dependent, then we can combine the two approaches and work with both 7.x and 8.x.

- Thomas

 Documentation/asciidoc.conf |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/Documentation/asciidoc.conf b/Documentation/asciidoc.conf
index 40d43b7..37bf195 100644
--- a/Documentation/asciidoc.conf
+++ b/Documentation/asciidoc.conf
@@ -15,6 +15,11 @@ startsb=&#91;
 endsb=&#93;
 tilde=&#126;
 
+# disable sub/superscripts -- they collide with our ref notation
+[quotes]
+^=
+~=
+
 ifdef::backend-docbook[]
 [linkgit-inlinemacro]
 {0%{target}}

-- 
tg: (5ab2757..) t/doc-disable-tilde (depends on: next)