Naked .. code-block:: bash in some places throughout docs

[posita]

Issue

From Overriding configuration from the command line:

Apparent source: #3111

This page appears to be generated from config.rst. I'm not quite sure what the problem is here, since some code blocks work, but others (perhaps those with only a single line) don't. It's interesting to note that GH's renderer suffers from the same problem.

So this may be a bug in Sphinx, but if a work-around is available (or maybe selecting an alternative Sphinx version fixes this), it is probably worth exploring for the sake of a polished experience for doc consumers.

[gaborbernat]

PR welcome 👍

[posita]

I don't know how to fix this. I tried tinkering with some obvious things, but nothing worked locally. It's more complicated than a trivial fix. Investigation seems to be involved, and I'm no longer familiar with Sphinx. I gave up on it a long time ago because of fighting with stuff like this.

If you want me to revert the portions of #3111 that led to the problem, then please reassign this to me. (That I can do.)

UPDATE: Nope. I see the problem now. See this comment.

[gaborbernat]

No we should fix it rather than revert it.

[posita]

Gah! I think I see the problem now (prior #3118 (comment) revised above). PR pending. Should be posted soon posted: #3120. Please reassign to me.