Re: [PATCH] Documentation/process/changes: Escape --options to fix Sphinx output

From: Jonathan Corbet
Date: Thu Apr 20 2023 - 11:40:48 EST


Jonathan Corbet <corbet@xxxxxxx> writes:

> The right solution, if it is possible, is to convince Sphinx to stop
> messing with "--" altogether. Substituting em-dashes is of limited
> cosmetic value and, I think, is something we could do without.

Ah ... I get it now. We *did* disable this once by disabling the
"html_use_smartypants" option in conf.py. The Sphinx folks changed the
name of that option in the 1.6.6 release, though, silently turning that
behavior back on. It only took us five years to notice... I think I'll
just drop the attached patch into docs-next.

Thanks for bringing this up!

jon

------------8<-----------------