Re: [PATCH 06/53] docs: admin-guide: avoid using UTF-8 chars

From: Gabriel Krisman Bertazi
Date: Mon May 10 2021 - 14:40:17 EST


Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> writes:

> While UTF-8 characters can be used at the Linux documentation,
> the best is to use them only when ASCII doesn't offer a good replacement.
> So, replace the occurences of the following UTF-8 characters:
>
> - U+00a0 (' '): NO-BREAK SPACE
> - U+2013 ('–'): EN DASH
> - U+2014 ('—'): EM DASH
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
> ---
> Documentation/admin-guide/index.rst | 2 +-
> Documentation/admin-guide/module-signing.rst | 4 +-
> Documentation/admin-guide/ras.rst | 94 +++++++++----------
> .../admin-guide/reporting-issues.rst | 12 +--
> 4 files changed, 56 insertions(+), 56 deletions(-)

Hi Mauro,

This patch misses one occurrence of U+2014 in
Documentation/admin-guide/sysctl/kernel.rst:1288.

There are also countless occurrences in Documentation/, outside of
Documentation/admin-guide. I suppose another patch in the series, which
I didn't receive, will fix them?

These characters will just reappear elsewhere, eventually. I'm not sure
what is the gain here, other than minor consistence improvements. But we
should add a Warning during documentation generation (if there isn't one
already), to prevent them from spreading again.

--
Gabriel Krisman Bertazi