Re: [PATCH] docs: process: changes.rst: Escape --version to fix Sphinx output

From: Jonathan Corbet
Date: Mon Feb 24 2020 - 13:08:24 EST


On Sun, 23 Feb 2020 23:22:27 +0100
Jonathan NeuschÃfer <j.neuschaefer@xxxxxxx> wrote:

> Without double-backticks, Sphinx wrongly turns "--version" into
> "âversion" with a Unicode EN DASH (U+2013), that is visually easy to
> confuse with a single ASCII dash.
>
> Signed-off-by: Jonathan NeuschÃfer <j.neuschaefer@xxxxxxx>

This certainly seems worth addressing. But I would *really* rather find
a way to tell Sphinx not to do that rather than making all of these
tweaks - which we will certainly find ourselves having to do over and
over again. I can try to look into that in a bit, but if somebody were
to beat me to it ... :)

Thanks,

jon