[PATCH v2 30/40] docs: ABI: Use ASCII subset instead of UTF-8 alternate symbols

From: Mauro Carvalho Chehab
Date: Wed May 12 2021 - 08:55:08 EST


The conversion tools used during DocBook/LaTeX/Markdown->ReST conversion
and some automatic rules which exists on certain text editors like
LibreOffice turned ASCII characters into some UTF-8 alternatives that
are better displayed on html and PDF.

While it is OK to use UTF-8 characters in Linux, it is better to
use the ASCII subset instead of using an UTF-8 equivalent character
as it makes life easier for tools like grep, and are easier to edit
with the some commonly used text/source code editors.

Also, Sphinx already do such conversion automatically outside literal blocks:
https://docutils.sourceforge.io/docs/user/smartquotes.html

So, replace the occurences of the following UTF-8 characters:

- U+2018 ('‘'): LEFT SINGLE QUOTATION MARK
- U+2019 ('’'): RIGHT SINGLE QUOTATION MARK

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
---
.../ABI/testing/sysfs-class-chromeos-driver-cros-ec-lightbar | 2 +-
Documentation/ABI/testing/sysfs-devices-platform-ipmi | 2 +-
Documentation/ABI/testing/sysfs-devices-platform-trackpoint | 2 +-
Documentation/ABI/testing/sysfs-devices-soc | 4 ++--
4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/Documentation/ABI/testing/sysfs-class-chromeos-driver-cros-ec-lightbar b/Documentation/ABI/testing/sysfs-class-chromeos-driver-cros-ec-lightbar
index 57a037791403..a7fb8f1169f2 100644
--- a/Documentation/ABI/testing/sysfs-class-chromeos-driver-cros-ec-lightbar
+++ b/Documentation/ABI/testing/sysfs-class-chromeos-driver-cros-ec-lightbar
@@ -29,7 +29,7 @@ KernelVersion: 4.2
Description:
This allows you to control each LED segment. If the
lightbar is already running one of the automatic
- sequences, you probably won’t see anything change because
+ sequences, you probably won't see anything change because
your color setting will be almost immediately replaced.
To get useful results, you should stop the lightbar
sequence first.
diff --git a/Documentation/ABI/testing/sysfs-devices-platform-ipmi b/Documentation/ABI/testing/sysfs-devices-platform-ipmi
index 07df0ddc0b69..3935cdedea0e 100644
--- a/Documentation/ABI/testing/sysfs-devices-platform-ipmi
+++ b/Documentation/ABI/testing/sysfs-devices-platform-ipmi
@@ -52,7 +52,7 @@ Date: Mar, 2006
KernelVersion: v2.6.17
Contact: openipmi-developer@xxxxxxxxxxxxxxxxxxxxx
Description:
- (RO) Lists the IPMI ‘logical device’ commands and functions
+ (RO) Lists the IPMI 'logical device' commands and functions
that the controller supports that are in addition to the
mandatory IPM and Application commands.

diff --git a/Documentation/ABI/testing/sysfs-devices-platform-trackpoint b/Documentation/ABI/testing/sysfs-devices-platform-trackpoint
index df11901a6b3d..82a38ac0435c 100644
--- a/Documentation/ABI/testing/sysfs-devices-platform-trackpoint
+++ b/Documentation/ABI/testing/sysfs-devices-platform-trackpoint
@@ -105,7 +105,7 @@ KernelVersion: 3.19
Contact: linux-input@xxxxxxxxxxxxxxx
Description:
(RW) This parameter controls the period of time to test for a
- ‘hands off’ condition (i.e. when no force is applied) before a
+ 'hands off' condition (i.e. when no force is applied) before a
drift (noise) calibration occurs.

IBM Trackpoints have a feature to compensate for drift by
diff --git a/Documentation/ABI/testing/sysfs-devices-soc b/Documentation/ABI/testing/sysfs-devices-soc
index ea999e292f11..7f90c6a44610 100644
--- a/Documentation/ABI/testing/sysfs-devices-soc
+++ b/Documentation/ABI/testing/sysfs-devices-soc
@@ -27,11 +27,11 @@ Description:
(e.g. DB8500).

On many of ARM based silicon with SMCCC v1.2+ compliant firmware
- this will contain the JEDEC JEP106 manufacturer’s identification
+ this will contain the JEDEC JEP106 manufacturer's identification
code. The format is "jep106:XXYY" where XX is identity code and
YY is continuation code.

- This manufacturer’s identification code is defined by one
+ This manufacturer's identification code is defined by one
or more eight (8) bit fields, each consisting of seven (7)
data bits plus one (1) odd parity bit. It is a single field,
limiting the possible number of vendors to 126. To expand
--
2.30.2