From patchwork Mon May 10 10:26:42 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Mauro Carvalho Chehab X-Patchwork-Id: 12247599 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-19.7 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6DD7BC43600 for ; Mon, 10 May 2021 10:35:02 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 3A8E76199C for ; Mon, 10 May 2021 10:35:02 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232108AbhEJKgE (ORCPT ); Mon, 10 May 2021 06:36:04 -0400 Received: from mail.kernel.org ([198.145.29.99]:41610 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232052AbhEJKcc (ORCPT ); Mon, 10 May 2021 06:32:32 -0400 Received: by mail.kernel.org (Postfix) with ESMTPSA id EBCF66192B; Mon, 10 May 2021 10:27:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1620642444; bh=a/lHErjxeq8Px/VYkN0n+YdbY/CWB8GjcIQuglK7QWg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=LZnWzXJrkHuG+yU9PYes9q1+5s/2e5Xyn6tkDeHreXPEftgwqghhmhsDb+c73Yhoc eCf8TPvbNZCR1aWKHy3/FNaiHambNIk5MPES2VOwVN2fzMO2hHeHDcBKzNbZV0MlhS gJ8EY8qicuv/m385ErxgkqXLdKb9AJdiD2+K2wgEX4UmF3JqqmFf6SvHzyGPIvh/3n AzlWVEK0ypbY1zS1XxDgoWpFKoQxPniOBFKPtJsrp869+SOV3Iz7hchM+qdn3vkRmV iDOaW1qwIXZx8lmTxeIIvwsbHeC0IHG8dWe3wMu727JXiWpKON8EnR4JazWpXdK3Xd a/DtpLT7Y2nUg== Received: by mail.kernel.org with local (Exim 4.94.2) (envelope-from ) id 1lg38D-000UQG-Pe; Mon, 10 May 2021 12:27:21 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Jonathan Corbet" , "Mark O'Donovan" , Jiri Kosina , Jonathan Cameron , Randy Dunlap , Srinivas Pandruvada , linux-iio@vger.kernel.org, linux-input@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 30/53] docs: hid: avoid using UTF-8 chars Date: Mon, 10 May 2021 12:26:42 +0200 Message-Id: X-Mailer: git-send-email 2.30.2 In-Reply-To: References: MIME-Version: 1.0 Sender: Mauro Carvalho Chehab Precedence: bulk List-ID: X-Mailing-List: linux-input@vger.kernel.org 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 Signed-off-by: Mauro Carvalho Chehab --- Documentation/hid/hid-sensor.rst | 70 ++++---- Documentation/hid/intel-ish-hid.rst | 246 ++++++++++++++-------------- 2 files changed, 158 insertions(+), 158 deletions(-) diff --git a/Documentation/hid/hid-sensor.rst b/Documentation/hid/hid-sensor.rst index c1c9b8d8dca6..b98d7a415cda 100644 --- a/Documentation/hid/hid-sensor.rst +++ b/Documentation/hid/hid-sensor.rst @@ -173,39 +173,39 @@ An example of this representation on sysfs:: /sys/devices/pci0000:00/INT33C2:00/i2c-0/i2c-INT33D1:00/0018:8086:09FA.0001/HID-SENSOR-2000e1.6.auto$ tree -R . - │   ├── enable_sensor - │   │   ├── feature-0-200316 - │   │   │   ├── feature-0-200316-maximum - │   │   │   ├── feature-0-200316-minimum - │   │   │   ├── feature-0-200316-name - │   │   │   ├── feature-0-200316-size - │   │   │   ├── feature-0-200316-unit-expo - │   │   │   ├── feature-0-200316-units - │   │   │   ├── feature-0-200316-value - │   │   ├── feature-1-200201 - │   │   │   ├── feature-1-200201-maximum - │   │   │   ├── feature-1-200201-minimum - │   │   │   ├── feature-1-200201-name - │   │   │   ├── feature-1-200201-size - │   │   │   ├── feature-1-200201-unit-expo - │   │   │   ├── feature-1-200201-units - │   │   │   ├── feature-1-200201-value - │   │   ├── input-0-200201 - │   │   │   ├── input-0-200201-maximum - │   │   │   ├── input-0-200201-minimum - │   │   │   ├── input-0-200201-name - │   │   │   ├── input-0-200201-size - │   │   │   ├── input-0-200201-unit-expo - │   │   │   ├── input-0-200201-units - │   │   │   ├── input-0-200201-value - │   │   ├── input-1-200202 - │   │   │   ├── input-1-200202-maximum - │   │   │   ├── input-1-200202-minimum - │   │   │   ├── input-1-200202-name - │   │   │   ├── input-1-200202-size - │   │   │   ├── input-1-200202-unit-expo - │   │   │   ├── input-1-200202-units - │   │   │   ├── input-1-200202-value + │ ├── enable_sensor + │ │ ├── feature-0-200316 + │ │ │ ├── feature-0-200316-maximum + │ │ │ ├── feature-0-200316-minimum + │ │ │ ├── feature-0-200316-name + │ │ │ ├── feature-0-200316-size + │ │ │ ├── feature-0-200316-unit-expo + │ │ │ ├── feature-0-200316-units + │ │ │ ├── feature-0-200316-value + │ │ ├── feature-1-200201 + │ │ │ ├── feature-1-200201-maximum + │ │ │ ├── feature-1-200201-minimum + │ │ │ ├── feature-1-200201-name + │ │ │ ├── feature-1-200201-size + │ │ │ ├── feature-1-200201-unit-expo + │ │ │ ├── feature-1-200201-units + │ │ │ ├── feature-1-200201-value + │ │ ├── input-0-200201 + │ │ │ ├── input-0-200201-maximum + │ │ │ ├── input-0-200201-minimum + │ │ │ ├── input-0-200201-name + │ │ │ ├── input-0-200201-size + │ │ │ ├── input-0-200201-unit-expo + │ │ │ ├── input-0-200201-units + │ │ │ ├── input-0-200201-value + │ │ ├── input-1-200202 + │ │ │ ├── input-1-200202-maximum + │ │ │ ├── input-1-200202-minimum + │ │ │ ├── input-1-200202-name + │ │ │ ├── input-1-200202-size + │ │ │ ├── input-1-200202-unit-expo + │ │ │ ├── input-1-200202-units + │ │ │ ├── input-1-200202-value Here there is a custom sensor with four fields: two feature and two inputs. Each field is represented by a set of attributes. All fields except the "value" @@ -234,8 +234,8 @@ Once enabled and powered on, sensor can report value using HID reports. These reports are pushed using misc device interface in a FIFO order:: /dev$ tree | grep HID-SENSOR-2000e1.6.auto - │   │   │   ├── 10:53 -> ../HID-SENSOR-2000e1.6.auto - │   ├── HID-SENSOR-2000e1.6.auto + │ │ │ ├── 10:53 -> ../HID-SENSOR-2000e1.6.auto + │ ├── HID-SENSOR-2000e1.6.auto Each report can be of variable length preceded by a header. This header consists of a 32-bit usage id, 64-bit time stamp and 32-bit length field of raw diff --git a/Documentation/hid/intel-ish-hid.rst b/Documentation/hid/intel-ish-hid.rst index 7a851252267a..a525cdefc937 100644 --- a/Documentation/hid/intel-ish-hid.rst +++ b/Documentation/hid/intel-ish-hid.rst @@ -355,133 +355,133 @@ To debug ISH, event tracing mechanism is used. To enable debug logs:: root@otcpl-ThinkPad-Yoga-260:~# tree -l /sys/bus/iio/devices/ /sys/bus/iio/devices/ ├── iio:device0 -> ../../../devices/0044:8086:22D8.0001/HID-SENSOR-200073.9.auto/iio:device0 - │   ├── buffer - │   │   ├── enable - │   │   ├── length - │   │   └── watermark + │ ├── buffer + │ │ ├── enable + │ │ ├── length + │ │ └── watermark ... - │   ├── in_accel_hysteresis - │   ├── in_accel_offset - │   ├── in_accel_sampling_frequency - │   ├── in_accel_scale - │   ├── in_accel_x_raw - │   ├── in_accel_y_raw - │   ├── in_accel_z_raw - │   ├── name - │   ├── scan_elements - │   │   ├── in_accel_x_en - │   │   ├── in_accel_x_index - │   │   ├── in_accel_x_type - │   │   ├── in_accel_y_en - │   │   ├── in_accel_y_index - │   │   ├── in_accel_y_type - │   │   ├── in_accel_z_en - │   │   ├── in_accel_z_index - │   │   └── in_accel_z_type + │ ├── in_accel_hysteresis + │ ├── in_accel_offset + │ ├── in_accel_sampling_frequency + │ ├── in_accel_scale + │ ├── in_accel_x_raw + │ ├── in_accel_y_raw + │ ├── in_accel_z_raw + │ ├── name + │ ├── scan_elements + │ │ ├── in_accel_x_en + │ │ ├── in_accel_x_index + │ │ ├── in_accel_x_type + │ │ ├── in_accel_y_en + │ │ ├── in_accel_y_index + │ │ ├── in_accel_y_type + │ │ ├── in_accel_z_en + │ │ ├── in_accel_z_index + │ │ └── in_accel_z_type ... - │   │   ├── devices - │   │   │   │   ├── buffer - │   │   │   │   │   ├── enable - │   │   │   │   │   ├── length - │   │   │   │   │   └── watermark - │   │   │   │   ├── dev - │   │   │   │   ├── in_intensity_both_raw - │   │   │   │   ├── in_intensity_hysteresis - │   │   │   │   ├── in_intensity_offset - │   │   │   │   ├── in_intensity_sampling_frequency - │   │   │   │   ├── in_intensity_scale - │   │   │   │   ├── name - │   │   │   │   ├── scan_elements - │   │   │   │   │   ├── in_intensity_both_en - │   │   │   │   │   ├── in_intensity_both_index - │   │   │   │   │   └── in_intensity_both_type - │   │   │   │   ├── trigger - │   │   │   │   │   └── current_trigger + │ │ ├── devices + │ │ │ │ ├── buffer + │ │ │ │ │ ├── enable + │ │ │ │ │ ├── length + │ │ │ │ │ └── watermark + │ │ │ │ ├── dev + │ │ │ │ ├── in_intensity_both_raw + │ │ │ │ ├── in_intensity_hysteresis + │ │ │ │ ├── in_intensity_offset + │ │ │ │ ├── in_intensity_sampling_frequency + │ │ │ │ ├── in_intensity_scale + │ │ │ │ ├── name + │ │ │ │ ├── scan_elements + │ │ │ │ │ ├── in_intensity_both_en + │ │ │ │ │ ├── in_intensity_both_index + │ │ │ │ │ └── in_intensity_both_type + │ │ │ │ ├── trigger + │ │ │ │ │ └── current_trigger ... - │   │   │   │   ├── buffer - │   │   │   │   │   ├── enable - │   │   │   │   │   ├── length - │   │   │   │   │   └── watermark - │   │   │   │   ├── dev - │   │   │   │   ├── in_magn_hysteresis - │   │   │   │   ├── in_magn_offset - │   │   │   │   ├── in_magn_sampling_frequency - │   │   │   │   ├── in_magn_scale - │   │   │   │   ├── in_magn_x_raw - │   │   │   │   ├── in_magn_y_raw - │   │   │   │   ├── in_magn_z_raw - │   │   │   │   ├── in_rot_from_north_magnetic_tilt_comp_raw - │   │   │   │   ├── in_rot_hysteresis - │   │   │   │   ├── in_rot_offset - │   │   │   │   ├── in_rot_sampling_frequency - │   │   │   │   ├── in_rot_scale - │   │   │   │   ├── name + │ │ │ │ ├── buffer + │ │ │ │ │ ├── enable + │ │ │ │ │ ├── length + │ │ │ │ │ └── watermark + │ │ │ │ ├── dev + │ │ │ │ ├── in_magn_hysteresis + │ │ │ │ ├── in_magn_offset + │ │ │ │ ├── in_magn_sampling_frequency + │ │ │ │ ├── in_magn_scale + │ │ │ │ ├── in_magn_x_raw + │ │ │ │ ├── in_magn_y_raw + │ │ │ │ ├── in_magn_z_raw + │ │ │ │ ├── in_rot_from_north_magnetic_tilt_comp_raw + │ │ │ │ ├── in_rot_hysteresis + │ │ │ │ ├── in_rot_offset + │ │ │ │ ├── in_rot_sampling_frequency + │ │ │ │ ├── in_rot_scale + │ │ │ │ ├── name ... - │   │   │   │   ├── scan_elements - │   │   │   │   │   ├── in_magn_x_en - │   │   │   │   │   ├── in_magn_x_index - │   │   │   │   │   ├── in_magn_x_type - │   │   │   │   │   ├── in_magn_y_en - │   │   │   │   │   ├── in_magn_y_index - │   │   │   │   │   ├── in_magn_y_type - │   │   │   │   │   ├── in_magn_z_en - │   │   │   │   │   ├── in_magn_z_index - │   │   │   │   │   ├── in_magn_z_type - │   │   │   │   │   ├── in_rot_from_north_magnetic_tilt_comp_en - │   │   │   │   │   ├── in_rot_from_north_magnetic_tilt_comp_index - │   │   │   │   │   └── in_rot_from_north_magnetic_tilt_comp_type - │   │   │   │   ├── trigger - │   │   │   │   │   └── current_trigger + │ │ │ │ ├── scan_elements + │ │ │ │ │ ├── in_magn_x_en + │ │ │ │ │ ├── in_magn_x_index + │ │ │ │ │ ├── in_magn_x_type + │ │ │ │ │ ├── in_magn_y_en + │ │ │ │ │ ├── in_magn_y_index + │ │ │ │ │ ├── in_magn_y_type + │ │ │ │ │ ├── in_magn_z_en + │ │ │ │ │ ├── in_magn_z_index + │ │ │ │ │ ├── in_magn_z_type + │ │ │ │ │ ├── in_rot_from_north_magnetic_tilt_comp_en + │ │ │ │ │ ├── in_rot_from_north_magnetic_tilt_comp_index + │ │ │ │ │ └── in_rot_from_north_magnetic_tilt_comp_type + │ │ │ │ ├── trigger + │ │ │ │ │ └── current_trigger ... - │   │   │   │   ├── buffer - │   │   │   │   │   ├── enable - │   │   │   │   │   ├── length - │   │   │   │   │   └── watermark - │   │   │   │   ├── dev - │   │   │   │   ├── in_anglvel_hysteresis - │   │   │   │   ├── in_anglvel_offset - │   │   │   │   ├── in_anglvel_sampling_frequency - │   │   │   │   ├── in_anglvel_scale - │   │   │   │   ├── in_anglvel_x_raw - │   │   │   │   ├── in_anglvel_y_raw - │   │   │   │   ├── in_anglvel_z_raw - │   │   │   │   ├── name - │   │   │   │   ├── scan_elements - │   │   │   │   │   ├── in_anglvel_x_en - │   │   │   │   │   ├── in_anglvel_x_index - │   │   │   │   │   ├── in_anglvel_x_type - │   │   │   │   │   ├── in_anglvel_y_en - │   │   │   │   │   ├── in_anglvel_y_index - │   │   │   │   │   ├── in_anglvel_y_type - │   │   │   │   │   ├── in_anglvel_z_en - │   │   │   │   │   ├── in_anglvel_z_index - │   │   │   │   │   └── in_anglvel_z_type - │   │   │   │   ├── trigger - │   │   │   │   │   └── current_trigger + │ │ │ │ ├── buffer + │ │ │ │ │ ├── enable + │ │ │ │ │ ├── length + │ │ │ │ │ └── watermark + │ │ │ │ ├── dev + │ │ │ │ ├── in_anglvel_hysteresis + │ │ │ │ ├── in_anglvel_offset + │ │ │ │ ├── in_anglvel_sampling_frequency + │ │ │ │ ├── in_anglvel_scale + │ │ │ │ ├── in_anglvel_x_raw + │ │ │ │ ├── in_anglvel_y_raw + │ │ │ │ ├── in_anglvel_z_raw + │ │ │ │ ├── name + │ │ │ │ ├── scan_elements + │ │ │ │ │ ├── in_anglvel_x_en + │ │ │ │ │ ├── in_anglvel_x_index + │ │ │ │ │ ├── in_anglvel_x_type + │ │ │ │ │ ├── in_anglvel_y_en + │ │ │ │ │ ├── in_anglvel_y_index + │ │ │ │ │ ├── in_anglvel_y_type + │ │ │ │ │ ├── in_anglvel_z_en + │ │ │ │ │ ├── in_anglvel_z_index + │ │ │ │ │ └── in_anglvel_z_type + │ │ │ │ ├── trigger + │ │ │ │ │ └── current_trigger ... - │   │   │   │   ├── buffer - │   │   │   │   │   ├── enable - │   │   │   │   │   ├── length - │   │   │   │   │   └── watermark - │   │   │   │   ├── dev - │   │   │   │   ├── in_anglvel_hysteresis - │   │   │   │   ├── in_anglvel_offset - │   │   │   │   ├── in_anglvel_sampling_frequency - │   │   │   │   ├── in_anglvel_scale - │   │   │   │   ├── in_anglvel_x_raw - │   │   │   │   ├── in_anglvel_y_raw - │   │   │   │   ├── in_anglvel_z_raw - │   │   │   │   ├── name - │   │   │   │   ├── scan_elements - │   │   │   │   │   ├── in_anglvel_x_en - │   │   │   │   │   ├── in_anglvel_x_index - │   │   │   │   │   ├── in_anglvel_x_type - │   │   │   │   │   ├── in_anglvel_y_en - │   │   │   │   │   ├── in_anglvel_y_index - │   │   │   │   │   ├── in_anglvel_y_type - │   │   │   │   │   ├── in_anglvel_z_en - │   │   │   │   │   ├── in_anglvel_z_index - │   │   │   │   │   └── in_anglvel_z_type - │   │   │   │   ├── trigger - │   │   │   │   │   └── current_trigger + │ │ │ │ ├── buffer + │ │ │ │ │ ├── enable + │ │ │ │ │ ├── length + │ │ │ │ │ └── watermark + │ │ │ │ ├── dev + │ │ │ │ ├── in_anglvel_hysteresis + │ │ │ │ ├── in_anglvel_offset + │ │ │ │ ├── in_anglvel_sampling_frequency + │ │ │ │ ├── in_anglvel_scale + │ │ │ │ ├── in_anglvel_x_raw + │ │ │ │ ├── in_anglvel_y_raw + │ │ │ │ ├── in_anglvel_z_raw + │ │ │ │ ├── name + │ │ │ │ ├── scan_elements + │ │ │ │ │ ├── in_anglvel_x_en + │ │ │ │ │ ├── in_anglvel_x_index + │ │ │ │ │ ├── in_anglvel_x_type + │ │ │ │ │ ├── in_anglvel_y_en + │ │ │ │ │ ├── in_anglvel_y_index + │ │ │ │ │ ├── in_anglvel_y_type + │ │ │ │ │ ├── in_anglvel_z_en + │ │ │ │ │ ├── in_anglvel_z_index + │ │ │ │ │ └── in_anglvel_z_type + │ │ │ │ ├── trigger + │ │ │ │ │ └── current_trigger ...