]> git.ipfire.org Git - thirdparty/kernel/stable.git/commit
docs: Restore "smart quotes" for quotes
authorAkira Yokosawa <akiyks@gmail.com>
Sun, 25 Feb 2024 09:46:00 +0000 (18:46 +0900)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Wed, 3 Apr 2024 13:28:22 +0000 (15:28 +0200)
commit66e2c41b0c80deab19904ce373c229c14080f3c4
treed9f8dbd5e660ace56c6b82e60a6c66eaa311171b
parentf77c8c1603bb7ddecb9fd82bf21372e6f3bb5bfb
docs: Restore "smart quotes" for quotes

[ Upstream commit fe2562582bffe675721e77e00b3bf5bfa1d7aeab ]

Commit eaae75754d81 ("docs: turn off "smart quotes" in the HTML build")
disabled conversion of quote marks along with that of dashes.
Despite the short summary, the change affects not only HTML build
but also other build targets including PDF.

However, as "smart quotes" had been enabled for more than half a
decade already, quite a few readers of HTML pages are likely expecting
conversions of "foo" -> “foo” and 'bar' -> ‘bar’.

Furthermore, in LaTeX typesetting convention, it is common to use
distinct marks for opening and closing quote marks.

To satisfy such readers' expectation, restore conversion of quotes
only by setting smartquotes_action [1].

Link: [1] https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-smartquotes_action
Cc: stable@vger.kernel.org # v6.4
Signed-off-by: Akira Yokosawa <akiyks@gmail.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20240225094600.65628-1-akiyks@gmail.com
Signed-off-by: Sasha Levin <sashal@kernel.org>
Documentation/conf.py