Re: [PATCH] docs: process: changes.rst: Escape --version to fix Sphinx output
From: Jonathan Corbet <corbet@lwn.net>
Date: 2020-02-24 18:08:24
Also in:
lkml
From: Jonathan Corbet <corbet@lwn.net>
Date: 2020-02-24 18:08:24
Also in:
lkml
On Sun, 23 Feb 2020 23:22:27 +0100 Jonathan Neuschäfer [off-list ref] 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@gmx.net>
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