From: Jeff King <peff@peff.net>
Date: Mon, 03 Feb 2020 11:45:49 GMT
Subject: Re: [PATCH] git-filter-branch.txt: use {caret} for ^
Message-ID: <20200203114549.GA4157558@coredump.intra.peff.net>
In-Reply-To: <20200202193319.1966-1-martin.agren@gmail.com>

On Sun, Feb 02, 2020 at 08:33:19PM +0100, Martin Ågren wrote:

> In this paragraph, we have a few instances of the '^' character, which
> we give as "\^". This renders well with AsciiDoc ("^"), but Asciidoctor
> renders it literally as "\^". Dropping the backslashes renders fine
> with Asciidoctor, but not AsciiDoc... Let's use "{caret}" instead, to
> avoid these escaping problems.

Makes sense.

The source is pretty ugly to read both before and after, though. I
wonder if using a literal like `5*10^5` would be even nicer. That makes
the source pretty readable, and the output would put it in <tt> or
similar. Which maybe is a little funny, but kind of makes sense to me
typographically as a kind of "this is math" style.

-Peff