diff mbox series

[30/33] docs: ABI: cleanup several ABI documents

Message ID 95ef2cf3a58f4e50f17d9e58e0d9440ad14d0427.1603893146.git.mchehab+huawei@kernel.org
State New, archived
Headers show
Series None | expand

Commit Message

Mauro Carvalho Chehab Oct. 28, 2020, 2:23 p.m. UTC
There are some ABI documents that, while they don't generate
any warnings, they have issues when parsed by get_abi.pl script
on its output result.

Address them, in order to provide a clean output.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
---
 Documentation/ABI/obsolete/sysfs-class-dax    |   8 +-
 .../ABI/obsolete/sysfs-driver-hid-roccat-pyra |   3 +
 Documentation/ABI/removed/devfs               |   1 +
 Documentation/ABI/removed/raw1394             |   1 +
 Documentation/ABI/removed/sysfs-class-rfkill  |   2 +-
 Documentation/ABI/removed/video1394           |   1 +
 Documentation/ABI/stable/firewire-cdev        |  63 ++---
 Documentation/ABI/stable/sysfs-acpi-pmprofile |   4 +-
 Documentation/ABI/stable/sysfs-bus-w1         |   1 +
 Documentation/ABI/stable/sysfs-class-tpm      |   4 +-
 Documentation/ABI/stable/sysfs-driver-speakup |   4 +
 Documentation/ABI/testing/configfs-most       | 135 +++++++----
 .../ABI/testing/configfs-usb-gadget-ecm       |  12 +-
 .../ABI/testing/configfs-usb-gadget-eem       |  10 +-
 .../ABI/testing/configfs-usb-gadget-loopback  |   6 +-
 .../testing/configfs-usb-gadget-mass-storage  |  18 +-
 .../ABI/testing/configfs-usb-gadget-midi      |  14 +-
 .../ABI/testing/configfs-usb-gadget-printer   |   6 +-
 .../testing/configfs-usb-gadget-sourcesink    |  18 +-
 .../ABI/testing/configfs-usb-gadget-subset    |  10 +-
 .../ABI/testing/configfs-usb-gadget-uac2      |  14 +-
 .../ABI/testing/configfs-usb-gadget-uvc       |   2 +-
 .../ABI/testing/debugfs-cec-error-inj         |   2 +-
 .../ABI/testing/debugfs-driver-habanalabs     |  12 +-
 .../ABI/testing/debugfs-pfo-nx-crypto         |  28 +--
 Documentation/ABI/testing/debugfs-pktcdvd     |   2 +-
 .../ABI/testing/debugfs-turris-mox-rwtm       |  10 +-
 Documentation/ABI/testing/debugfs-wilco-ec    |  21 +-
 Documentation/ABI/testing/dell-smbios-wmi     |  32 +--
 Documentation/ABI/testing/gpio-cdev           |  13 +-
 Documentation/ABI/testing/procfs-diskstats    |   6 +-
 Documentation/ABI/testing/procfs-smaps_rollup |  48 ++--
 Documentation/ABI/testing/pstore              |  19 +-
 Documentation/ABI/testing/sysfs-block-rnbd    |   4 +-
 Documentation/ABI/testing/sysfs-bus-acpi      |   1 +
 .../testing/sysfs-bus-coresight-devices-etb10 |   5 +-
 Documentation/ABI/testing/sysfs-bus-css       |   3 +
 Documentation/ABI/testing/sysfs-bus-dfl       |   2 +
 .../sysfs-bus-event_source-devices-hv_24x7    |   6 +-
 .../sysfs-bus-event_source-devices-hv_gpci    |   7 +-
 Documentation/ABI/testing/sysfs-bus-fcoe      |  68 ++++--
 Documentation/ABI/testing/sysfs-bus-fsl-mc    |  12 +-
 .../ABI/testing/sysfs-bus-i2c-devices-fsa9480 |  26 +-
 Documentation/ABI/testing/sysfs-bus-i3c       |   2 +
 Documentation/ABI/testing/sysfs-bus-iio       |  19 +-
 .../ABI/testing/sysfs-bus-iio-adc-hi8435      |   5 +
 .../ABI/testing/sysfs-bus-iio-adc-stm32       |   3 +
 .../ABI/testing/sysfs-bus-iio-distance-srf08  |   7 +-
 .../testing/sysfs-bus-iio-frequency-ad9523    |   2 +
 .../testing/sysfs-bus-iio-frequency-adf4371   |  10 +-
 .../ABI/testing/sysfs-bus-iio-health-afe440x  |  12 +-
 .../ABI/testing/sysfs-bus-iio-light-isl29018  |   6 +-
 .../testing/sysfs-bus-intel_th-devices-gth    |  11 +-
 Documentation/ABI/testing/sysfs-bus-papr-pmem |  23 +-
 Documentation/ABI/testing/sysfs-bus-pci       |  22 +-
 .../ABI/testing/sysfs-bus-pci-devices-catpt   |   1 +
 .../testing/sysfs-bus-pci-drivers-ehci_hcd    |   4 +-
 Documentation/ABI/testing/sysfs-bus-rbd       |  37 ++-
 Documentation/ABI/testing/sysfs-bus-siox      |   3 +
 .../ABI/testing/sysfs-bus-thunderbolt         |  18 +-
 Documentation/ABI/testing/sysfs-bus-usb       |   2 +
 .../sysfs-class-backlight-driver-lm3533       |  26 +-
 Documentation/ABI/testing/sysfs-class-bdi     |   1 -
 .../ABI/testing/sysfs-class-chromeos          |  15 +-
 Documentation/ABI/testing/sysfs-class-cxl     |   8 +-
 Documentation/ABI/testing/sysfs-class-devlink |  30 ++-
 Documentation/ABI/testing/sysfs-class-extcon  |  34 +--
 .../ABI/testing/sysfs-class-fpga-manager      |   5 +-
 Documentation/ABI/testing/sysfs-class-gnss    |   2 +
 Documentation/ABI/testing/sysfs-class-led     |   1 +
 .../testing/sysfs-class-led-driver-el15203000 |  30 +--
 .../ABI/testing/sysfs-class-led-driver-lm3533 |  44 ++--
 .../ABI/testing/sysfs-class-led-flash         |  27 ++-
 .../testing/sysfs-class-led-trigger-netdev    |   7 +
 .../testing/sysfs-class-led-trigger-usbport   |   1 +
 .../ABI/testing/sysfs-class-leds-gt683r       |   8 +-
 Documentation/ABI/testing/sysfs-class-net     |  61 +++--
 .../ABI/testing/sysfs-class-net-cdc_ncm       |   6 +-
 .../ABI/testing/sysfs-class-net-phydev        |   2 +
 Documentation/ABI/testing/sysfs-class-pktcdvd |  36 +--
 Documentation/ABI/testing/sysfs-class-power   |  12 +-
 .../ABI/testing/sysfs-class-power-mp2629      |   1 +
 .../ABI/testing/sysfs-class-power-twl4030     |   4 +-
 Documentation/ABI/testing/sysfs-class-rapidio |  46 ++--
 .../ABI/testing/sysfs-class-regulator         |  36 +--
 .../ABI/testing/sysfs-class-remoteproc        |  14 +-
 ...ysfs-class-rtc-rtc0-device-rtc_calibration |   1 +
 Documentation/ABI/testing/sysfs-class-uwb_rc  |  13 +-
 .../ABI/testing/sysfs-class-watchdog          |   7 +-
 Documentation/ABI/testing/sysfs-dev           |   7 +-
 .../ABI/testing/sysfs-devices-mapping         |  41 ++--
 .../ABI/testing/sysfs-devices-memory          |  15 +-
 .../sysfs-devices-platform-_UDC_-gadget       |  10 +-
 .../ABI/testing/sysfs-devices-platform-ipmi   |  52 ++--
 .../ABI/testing/sysfs-devices-system-cpu      |   4 +-
 .../ABI/testing/sysfs-driver-hid-lenovo       |  10 +
 .../ABI/testing/sysfs-driver-hid-ntrig        |  13 +-
 .../ABI/testing/sysfs-driver-hid-roccat-kone  |  19 ++
 .../ABI/testing/sysfs-driver-hid-wiimote      |   1 +
 .../ABI/testing/sysfs-driver-input-exc3000    |   2 +
 .../ABI/testing/sysfs-driver-jz4780-efuse     |   6 +-
 .../ABI/testing/sysfs-driver-pciback          |   6 +-
 Documentation/ABI/testing/sysfs-driver-ufs    | 228 ++++++++++++++----
 .../ABI/testing/sysfs-driver-w1_ds28e17       |   3 +
 Documentation/ABI/testing/sysfs-firmware-acpi |  16 +-
 .../ABI/testing/sysfs-firmware-efi-esrt       |  28 ++-
 .../testing/sysfs-firmware-efi-runtime-map    |  14 +-
 .../ABI/testing/sysfs-firmware-qemu_fw_cfg    |  20 +-
 Documentation/ABI/testing/sysfs-firmware-sfi  |   6 +-
 .../ABI/testing/sysfs-firmware-sgi_uv         |   6 +-
 Documentation/ABI/testing/sysfs-fs-f2fs       |  48 ++--
 Documentation/ABI/testing/sysfs-kernel-mm-ksm |   5 +-
 Documentation/ABI/testing/sysfs-kernel-slab   |   3 +
 Documentation/ABI/testing/sysfs-module        |  17 +-
 .../ABI/testing/sysfs-platform-dell-laptop    |  10 +-
 .../ABI/testing/sysfs-platform-dell-smbios    |   4 +-
 .../testing/sysfs-platform-i2c-demux-pinctrl  |   4 +-
 Documentation/ABI/testing/sysfs-platform-kim  |   1 +
 .../testing/sysfs-platform-phy-rcar-gen3-usb2 |  10 +-
 .../ABI/testing/sysfs-platform-renesas_usb3   |  10 +-
 Documentation/ABI/testing/sysfs-power         |  21 +-
 Documentation/ABI/testing/sysfs-profiling     |   2 +-
 Documentation/ABI/testing/sysfs-wusb_cbaf     |   3 +-
 Documentation/ABI/testing/usb-charger-uevent  |  82 ++++---
 Documentation/ABI/testing/usb-uevent          |  32 +--
 scripts/get_abi.pl                            |   2 -
 126 files changed, 1323 insertions(+), 767 deletions(-)

Comments

Jonathan Cameron Oct. 29, 2020, 2:42 p.m. UTC | #1
On Wed, 28 Oct 2020 15:23:28 +0100
Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:

> There are some ABI documents that, while they don't generate
> any warnings, they have issues when parsed by get_abi.pl script
> on its output result.
> 
> Address them, in order to provide a clean output.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

All the IIO ones look sensible.  Thanks

Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for IIO

> ---
>  Documentation/ABI/obsolete/sysfs-class-dax    |   8 +-
>  .../ABI/obsolete/sysfs-driver-hid-roccat-pyra |   3 +
>  Documentation/ABI/removed/devfs               |   1 +
>  Documentation/ABI/removed/raw1394             |   1 +
>  Documentation/ABI/removed/sysfs-class-rfkill  |   2 +-
>  Documentation/ABI/removed/video1394           |   1 +
>  Documentation/ABI/stable/firewire-cdev        |  63 ++---
>  Documentation/ABI/stable/sysfs-acpi-pmprofile |   4 +-
>  Documentation/ABI/stable/sysfs-bus-w1         |   1 +
>  Documentation/ABI/stable/sysfs-class-tpm      |   4 +-
>  Documentation/ABI/stable/sysfs-driver-speakup |   4 +
>  Documentation/ABI/testing/configfs-most       | 135 +++++++----
>  .../ABI/testing/configfs-usb-gadget-ecm       |  12 +-
>  .../ABI/testing/configfs-usb-gadget-eem       |  10 +-
>  .../ABI/testing/configfs-usb-gadget-loopback  |   6 +-
>  .../testing/configfs-usb-gadget-mass-storage  |  18 +-
>  .../ABI/testing/configfs-usb-gadget-midi      |  14 +-
>  .../ABI/testing/configfs-usb-gadget-printer   |   6 +-
>  .../testing/configfs-usb-gadget-sourcesink    |  18 +-
>  .../ABI/testing/configfs-usb-gadget-subset    |  10 +-
>  .../ABI/testing/configfs-usb-gadget-uac2      |  14 +-
>  .../ABI/testing/configfs-usb-gadget-uvc       |   2 +-
>  .../ABI/testing/debugfs-cec-error-inj         |   2 +-
>  .../ABI/testing/debugfs-driver-habanalabs     |  12 +-
>  .../ABI/testing/debugfs-pfo-nx-crypto         |  28 +--
>  Documentation/ABI/testing/debugfs-pktcdvd     |   2 +-
>  .../ABI/testing/debugfs-turris-mox-rwtm       |  10 +-
>  Documentation/ABI/testing/debugfs-wilco-ec    |  21 +-
>  Documentation/ABI/testing/dell-smbios-wmi     |  32 +--
>  Documentation/ABI/testing/gpio-cdev           |  13 +-
>  Documentation/ABI/testing/procfs-diskstats    |   6 +-
>  Documentation/ABI/testing/procfs-smaps_rollup |  48 ++--
>  Documentation/ABI/testing/pstore              |  19 +-
>  Documentation/ABI/testing/sysfs-block-rnbd    |   4 +-
>  Documentation/ABI/testing/sysfs-bus-acpi      |   1 +
>  .../testing/sysfs-bus-coresight-devices-etb10 |   5 +-
>  Documentation/ABI/testing/sysfs-bus-css       |   3 +
>  Documentation/ABI/testing/sysfs-bus-dfl       |   2 +
>  .../sysfs-bus-event_source-devices-hv_24x7    |   6 +-
>  .../sysfs-bus-event_source-devices-hv_gpci    |   7 +-
>  Documentation/ABI/testing/sysfs-bus-fcoe      |  68 ++++--
>  Documentation/ABI/testing/sysfs-bus-fsl-mc    |  12 +-
>  .../ABI/testing/sysfs-bus-i2c-devices-fsa9480 |  26 +-
>  Documentation/ABI/testing/sysfs-bus-i3c       |   2 +
>  Documentation/ABI/testing/sysfs-bus-iio       |  19 +-
>  .../ABI/testing/sysfs-bus-iio-adc-hi8435      |   5 +
>  .../ABI/testing/sysfs-bus-iio-adc-stm32       |   3 +
>  .../ABI/testing/sysfs-bus-iio-distance-srf08  |   7 +-
>  .../testing/sysfs-bus-iio-frequency-ad9523    |   2 +
>  .../testing/sysfs-bus-iio-frequency-adf4371   |  10 +-
>  .../ABI/testing/sysfs-bus-iio-health-afe440x  |  12 +-
>  .../ABI/testing/sysfs-bus-iio-light-isl29018  |   6 +-
>  .../testing/sysfs-bus-intel_th-devices-gth    |  11 +-
>  Documentation/ABI/testing/sysfs-bus-papr-pmem |  23 +-
>  Documentation/ABI/testing/sysfs-bus-pci       |  22 +-
>  .../ABI/testing/sysfs-bus-pci-devices-catpt   |   1 +
>  .../testing/sysfs-bus-pci-drivers-ehci_hcd    |   4 +-
>  Documentation/ABI/testing/sysfs-bus-rbd       |  37 ++-
>  Documentation/ABI/testing/sysfs-bus-siox      |   3 +
>  .../ABI/testing/sysfs-bus-thunderbolt         |  18 +-
>  Documentation/ABI/testing/sysfs-bus-usb       |   2 +
>  .../sysfs-class-backlight-driver-lm3533       |  26 +-
>  Documentation/ABI/testing/sysfs-class-bdi     |   1 -
>  .../ABI/testing/sysfs-class-chromeos          |  15 +-
>  Documentation/ABI/testing/sysfs-class-cxl     |   8 +-
>  Documentation/ABI/testing/sysfs-class-devlink |  30 ++-
>  Documentation/ABI/testing/sysfs-class-extcon  |  34 +--
>  .../ABI/testing/sysfs-class-fpga-manager      |   5 +-
>  Documentation/ABI/testing/sysfs-class-gnss    |   2 +
>  Documentation/ABI/testing/sysfs-class-led     |   1 +
>  .../testing/sysfs-class-led-driver-el15203000 |  30 +--
>  .../ABI/testing/sysfs-class-led-driver-lm3533 |  44 ++--
>  .../ABI/testing/sysfs-class-led-flash         |  27 ++-
>  .../testing/sysfs-class-led-trigger-netdev    |   7 +
>  .../testing/sysfs-class-led-trigger-usbport   |   1 +
>  .../ABI/testing/sysfs-class-leds-gt683r       |   8 +-
>  Documentation/ABI/testing/sysfs-class-net     |  61 +++--
>  .../ABI/testing/sysfs-class-net-cdc_ncm       |   6 +-
>  .../ABI/testing/sysfs-class-net-phydev        |   2 +
>  Documentation/ABI/testing/sysfs-class-pktcdvd |  36 +--
>  Documentation/ABI/testing/sysfs-class-power   |  12 +-
>  .../ABI/testing/sysfs-class-power-mp2629      |   1 +
>  .../ABI/testing/sysfs-class-power-twl4030     |   4 +-
>  Documentation/ABI/testing/sysfs-class-rapidio |  46 ++--
>  .../ABI/testing/sysfs-class-regulator         |  36 +--
>  .../ABI/testing/sysfs-class-remoteproc        |  14 +-
>  ...ysfs-class-rtc-rtc0-device-rtc_calibration |   1 +
>  Documentation/ABI/testing/sysfs-class-uwb_rc  |  13 +-
>  .../ABI/testing/sysfs-class-watchdog          |   7 +-
>  Documentation/ABI/testing/sysfs-dev           |   7 +-
>  .../ABI/testing/sysfs-devices-mapping         |  41 ++--
>  .../ABI/testing/sysfs-devices-memory          |  15 +-
>  .../sysfs-devices-platform-_UDC_-gadget       |  10 +-
>  .../ABI/testing/sysfs-devices-platform-ipmi   |  52 ++--
>  .../ABI/testing/sysfs-devices-system-cpu      |   4 +-
>  .../ABI/testing/sysfs-driver-hid-lenovo       |  10 +
>  .../ABI/testing/sysfs-driver-hid-ntrig        |  13 +-
>  .../ABI/testing/sysfs-driver-hid-roccat-kone  |  19 ++
>  .../ABI/testing/sysfs-driver-hid-wiimote      |   1 +
>  .../ABI/testing/sysfs-driver-input-exc3000    |   2 +
>  .../ABI/testing/sysfs-driver-jz4780-efuse     |   6 +-
>  .../ABI/testing/sysfs-driver-pciback          |   6 +-
>  Documentation/ABI/testing/sysfs-driver-ufs    | 228 ++++++++++++++----
>  .../ABI/testing/sysfs-driver-w1_ds28e17       |   3 +
>  Documentation/ABI/testing/sysfs-firmware-acpi |  16 +-
>  .../ABI/testing/sysfs-firmware-efi-esrt       |  28 ++-
>  .../testing/sysfs-firmware-efi-runtime-map    |  14 +-
>  .../ABI/testing/sysfs-firmware-qemu_fw_cfg    |  20 +-
>  Documentation/ABI/testing/sysfs-firmware-sfi  |   6 +-
>  .../ABI/testing/sysfs-firmware-sgi_uv         |   6 +-
>  Documentation/ABI/testing/sysfs-fs-f2fs       |  48 ++--
>  Documentation/ABI/testing/sysfs-kernel-mm-ksm |   5 +-
>  Documentation/ABI/testing/sysfs-kernel-slab   |   3 +
>  Documentation/ABI/testing/sysfs-module        |  17 +-
>  .../ABI/testing/sysfs-platform-dell-laptop    |  10 +-
>  .../ABI/testing/sysfs-platform-dell-smbios    |   4 +-
>  .../testing/sysfs-platform-i2c-demux-pinctrl  |   4 +-
>  Documentation/ABI/testing/sysfs-platform-kim  |   1 +
>  .../testing/sysfs-platform-phy-rcar-gen3-usb2 |  10 +-
>  .../ABI/testing/sysfs-platform-renesas_usb3   |  10 +-
>  Documentation/ABI/testing/sysfs-power         |  21 +-
>  Documentation/ABI/testing/sysfs-profiling     |   2 +-
>  Documentation/ABI/testing/sysfs-wusb_cbaf     |   3 +-
>  Documentation/ABI/testing/usb-charger-uevent  |  82 ++++---
>  Documentation/ABI/testing/usb-uevent          |  32 +--
>  scripts/get_abi.pl                            |   2 -
>  126 files changed, 1323 insertions(+), 767 deletions(-)
> 
> diff --git a/Documentation/ABI/obsolete/sysfs-class-dax b/Documentation/ABI/obsolete/sysfs-class-dax
> index 2cb9fc5e8bd1..0faf1354cd05 100644
> --- a/Documentation/ABI/obsolete/sysfs-class-dax
> +++ b/Documentation/ABI/obsolete/sysfs-class-dax
> @@ -8,11 +8,11 @@ Description:	Device DAX is the device-centric analogue of Filesystem
>  		system.  Device DAX is strict, precise and predictable.
>  		Specifically this interface:
>  
> -		1/ Guarantees fault granularity with respect to a given
> -		page size (pte, pmd, or pud) set at configuration time.
> +		1. Guarantees fault granularity with respect to a given
> +		   page size (pte, pmd, or pud) set at configuration time.
>  
> -		2/ Enforces deterministic behavior by being strict about
> -		what fault scenarios are supported.
> +		2. Enforces deterministic behavior by being strict about
> +		   what fault scenarios are supported.
>  
>  		The /sys/class/dax/ interface enumerates all the
>  		device-dax instances in the system. The ABI is
> diff --git a/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra b/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
> index 5d41ebadf15e..66545c587a64 100644
> --- a/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
> +++ b/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
> @@ -7,10 +7,13 @@ Description:	It is possible to switch the cpi setting of the mouse with the
>  		setting reported by the mouse. This number has to be further
>  		processed to receive the real dpi value:
>  
> +		===== ====
>  		VALUE DPI
> +		===== ====
>  		1     400
>  		2     800
>  		4     1600
> +		===== ====
>  
>  		This file is readonly.
>  		Has never been used. If bookkeeping is done, it's done in userland tools.
> diff --git a/Documentation/ABI/removed/devfs b/Documentation/ABI/removed/devfs
> index 0020c49933c4..24fb35adf277 100644
> --- a/Documentation/ABI/removed/devfs
> +++ b/Documentation/ABI/removed/devfs
> @@ -5,6 +5,7 @@ Description:
>  	devfs has been unmaintained for a number of years, has unfixable
>  	races, contains a naming policy within the kernel that is
>  	against the LSB, and can be replaced by using udev.
> +
>  	The files fs/devfs/*, include/linux/devfs_fs*.h were removed,
>  	along with the assorted devfs function calls throughout the
>  	kernel tree.
> diff --git a/Documentation/ABI/removed/raw1394 b/Documentation/ABI/removed/raw1394
> index ec333e676322..9ec7ec493920 100644
> --- a/Documentation/ABI/removed/raw1394
> +++ b/Documentation/ABI/removed/raw1394
> @@ -7,6 +7,7 @@ Description:
>  	to implement sensible device security policies, and its low level
>  	of abstraction that required userspace clients to duplicate much
>  	of the kernel's ieee1394 core functionality.
> +
>  	Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of
>  	firewire-core.
>  
> diff --git a/Documentation/ABI/removed/sysfs-class-rfkill b/Documentation/ABI/removed/sysfs-class-rfkill
> index 9c08c7f98ffb..f25174eafd55 100644
> --- a/Documentation/ABI/removed/sysfs-class-rfkill
> +++ b/Documentation/ABI/removed/sysfs-class-rfkill
> @@ -10,4 +10,4 @@ Description:	This file was deprecated because there no longer was a way to
>  		claim just control over a single rfkill instance.
>  		This file was scheduled to be removed in 2012, and was removed
>  		in 2016.
> -Values: 	0: Kernel handles events
> +Values:		0: Kernel handles events
> diff --git a/Documentation/ABI/removed/video1394 b/Documentation/ABI/removed/video1394
> index c39c25aee77b..1905d35a6619 100644
> --- a/Documentation/ABI/removed/video1394
> +++ b/Documentation/ABI/removed/video1394
> @@ -8,6 +8,7 @@ Description:
>  	performance issues in its first generation.  Any video1394 user had
>  	to use raw1394 + libraw1394 too because video1394 did not provide
>  	asynchronous I/O for device discovery and configuration.
> +
>  	Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of
>  	firewire-core.
>  
> diff --git a/Documentation/ABI/stable/firewire-cdev b/Documentation/ABI/stable/firewire-cdev
> index c9e8ff026154..261f85b13154 100644
> --- a/Documentation/ABI/stable/firewire-cdev
> +++ b/Documentation/ABI/stable/firewire-cdev
> @@ -16,6 +16,7 @@ Description:
>  		different scope:
>  
>  		  - The 1394 node which is associated with the file:
> +
>  			  - Asynchronous request transmission
>  			  - Get the Configuration ROM
>  			  - Query node ID
> @@ -23,6 +24,7 @@ Description:
>  			    and local node
>  
>  		  - The 1394 bus (i.e. "card") to which the node is attached to:
> +
>  			  - Isochronous stream transmission and reception
>  			  - Asynchronous stream transmission and reception
>  			  - Asynchronous broadcast request transmission
> @@ -35,6 +37,7 @@ Description:
>  			  - Bus reset initiation, bus reset event reception
>  
>  		  - All 1394 buses:
> +
>  			  - Allocation of IEEE 1212 address ranges on the local
>  			    link layers, reception of inbound requests to such
>  			    an address range, asynchronous response transmission
> @@ -59,50 +62,50 @@ Description:
>  		The following file operations are supported:
>  
>  		open(2)
> -		Currently the only useful flags are O_RDWR.
> +		    Currently the only useful flags are O_RDWR.
>  
>  		ioctl(2)
> -		Initiate various actions.  Some take immediate effect, others
> -		are performed asynchronously while or after the ioctl returns.
> -		See the inline documentation in <linux/firewire-cdev.h> for
> -		descriptions of all ioctls.
> +		    Initiate various actions.  Some take immediate effect, others
> +		    are performed asynchronously while or after the ioctl returns.
> +		    See the inline documentation in <linux/firewire-cdev.h> for
> +		    descriptions of all ioctls.
>  
>  		poll(2), select(2), epoll_wait(2) etc.
> -		Watch for events to become available to be read.
> +		    Watch for events to become available to be read.
>  
>  		read(2)
> -		Receive various events.  There are solicited events like
> -		outbound asynchronous transaction completion or isochronous
> -		buffer completion, and unsolicited events such as bus resets,
> -		request reception, or PHY packet reception.  Always use a read
> -		buffer which is large enough to receive the largest event that
> -		could ever arrive.  See <linux/firewire-cdev.h> for descriptions
> -		of all event types and for which ioctls affect reception of
> -		events.
> +		    Receive various events.  There are solicited events like
> +		    outbound asynchronous transaction completion or isochronous
> +		    buffer completion, and unsolicited events such as bus resets,
> +		    request reception, or PHY packet reception.  Always use a read
> +		    buffer which is large enough to receive the largest event that
> +		    could ever arrive.  See <linux/firewire-cdev.h> for descriptions
> +		    of all event types and for which ioctls affect reception of
> +		    events.
>  
>  		mmap(2)
> -		Allocate a DMA buffer for isochronous reception or transmission
> -		and map it into the process address space.  The arguments should
> -		be used as follows:  addr = NULL, length = the desired buffer
> -		size, i.e. number of packets times size of largest packet,
> -		prot = at least PROT_READ for reception and at least PROT_WRITE
> -		for transmission, flags = MAP_SHARED, fd = the handle to the
> -		/dev/fw*, offset = 0.
> +		    Allocate a DMA buffer for isochronous reception or transmission
> +		    and map it into the process address space.  The arguments should
> +		    be used as follows:  addr = NULL, length = the desired buffer
> +		    size, i.e. number of packets times size of largest packet,
> +		    prot = at least PROT_READ for reception and at least PROT_WRITE
> +		    for transmission, flags = MAP_SHARED, fd = the handle to the
> +		    /dev/fw*, offset = 0.
>  
>  		Isochronous reception works in packet-per-buffer fashion except
>  		for multichannel reception which works in buffer-fill mode.
>  
>  		munmap(2)
> -		Unmap the isochronous I/O buffer from the process address space.
> +		    Unmap the isochronous I/O buffer from the process address space.
>  
>  		close(2)
> -		Besides stopping and freeing I/O contexts that were associated
> -		with the file descriptor, back out any changes to the local
> -		nodes' Configuration ROM.  Deallocate isochronous channels and
> -		bandwidth at the IRM that were marked for kernel-assisted
> -		re- and deallocation.
> +		    Besides stopping and freeing I/O contexts that were associated
> +		    with the file descriptor, back out any changes to the local
> +		    nodes' Configuration ROM.  Deallocate isochronous channels and
> +		    bandwidth at the IRM that were marked for kernel-assisted
> +		    re- and deallocation.
>  
> -Users:		libraw1394
> -		libdc1394
> -		libhinawa
> +Users:		libraw1394;
> +		libdc1394;
> +		libhinawa;
>  		tools like linux-firewire-utils, fwhack, ...
> diff --git a/Documentation/ABI/stable/sysfs-acpi-pmprofile b/Documentation/ABI/stable/sysfs-acpi-pmprofile
> index fd97d22b677f..2d6314f0e4e4 100644
> --- a/Documentation/ABI/stable/sysfs-acpi-pmprofile
> +++ b/Documentation/ABI/stable/sysfs-acpi-pmprofile
> @@ -1,8 +1,8 @@
> -What: 		/sys/firmware/acpi/pm_profile
> +What:		/sys/firmware/acpi/pm_profile
>  Date:		03-Nov-2011
>  KernelVersion:	v3.2
>  Contact:	linux-acpi@vger.kernel.org
> -Description: 	The ACPI pm_profile sysfs interface exports the platform
> +Description:	The ACPI pm_profile sysfs interface exports the platform
>  		power management (and performance) requirement expectations
>  		as provided by BIOS. The integer value is directly passed as
>  		retrieved from the FADT ACPI table.
> diff --git a/Documentation/ABI/stable/sysfs-bus-w1 b/Documentation/ABI/stable/sysfs-bus-w1
> index 992dfb183ed0..5cd5e872bcae 100644
> --- a/Documentation/ABI/stable/sysfs-bus-w1
> +++ b/Documentation/ABI/stable/sysfs-bus-w1
> @@ -6,6 +6,7 @@ Description:	Bus scanning interval, microseconds component.
>  		control systems are attached/generate presence for as short as
>  		100 ms - hence the tens-to-hundreds milliseconds scan intervals
>  		are required.
> +
>  		see Documentation/w1/w1-generic.rst for detailed information.
>  Users:		any user space application which wants to know bus scanning
>  		interval
> diff --git a/Documentation/ABI/stable/sysfs-class-tpm b/Documentation/ABI/stable/sysfs-class-tpm
> index ec464cf7861a..91ca63ec7581 100644
> --- a/Documentation/ABI/stable/sysfs-class-tpm
> +++ b/Documentation/ABI/stable/sysfs-class-tpm
> @@ -191,6 +191,6 @@ Contact:	linux-integrity@vger.kernel.org
>  Description:	The "tpm_version_major" property shows the TCG spec major version
>  		implemented by the TPM device.
>  
> -		Example output:
> +		Example output::
>  
> -		2
> +		  2
> diff --git a/Documentation/ABI/stable/sysfs-driver-speakup b/Documentation/ABI/stable/sysfs-driver-speakup
> index c6a32c434ce9..792f58ba327d 100644
> --- a/Documentation/ABI/stable/sysfs-driver-speakup
> +++ b/Documentation/ABI/stable/sysfs-driver-speakup
> @@ -69,6 +69,7 @@ Description:	Controls if typing interrupts output from speakup. With
>  		speakup if for example
>  		the say screen command is used before the
>  		entire screen  is read.
> +
>  		With no_interrupt set to one, if the say
>  		screen command is used, and one then types on the keyboard,
>  		speakup will continue to say the whole screen regardless until
> @@ -215,8 +216,10 @@ Description:	This file contains names for key states.
>  		Again, these are part of the help system.  For instance, if you
>  		had pressed speakup + keypad 3, you would hear:
>  		"speakup keypad 3 is go to bottom edge."
> +
>  		The speakup key is depressed, so the name of the key state is
>  		speakup.
> +
>  		This part of the message comes from the states collection.
>  
>  What:		/sys/accessibility/speakup/i18n/characters
> @@ -297,6 +300,7 @@ KernelVersion:	2.6
>  Contact:	speakup@linux-speakup.org
>  Description:	Controls if punctuation is spoken by speakup, or by the
>  		synthesizer.
> +
>  		For example, speakup speaks ">" as "greater", while
>  		the espeak synthesizer used by the soft driver speaks "greater
>  		than". Zero lets speakup speak the punctuation. One lets the
> diff --git a/Documentation/ABI/testing/configfs-most b/Documentation/ABI/testing/configfs-most
> index ed67a4d9f6d6..bc6b8bd18da4 100644
> --- a/Documentation/ABI/testing/configfs-most
> +++ b/Documentation/ABI/testing/configfs-most
> @@ -15,22 +15,28 @@ KernelVersion:  5.2
>  Description:
>  		The attributes:
>  
> -		buffer_size	configure the buffer size for this channel
> +		buffer_size
> +				configure the buffer size for this channel
>  
> -		subbuffer_size	configure the sub-buffer size for this channel
> +		subbuffer_size
> +				configure the sub-buffer size for this channel
>  				(needed for synchronous and isochrnous data)
>  
>  
> -		num_buffers	configure number of buffers used for this
> +		num_buffers
> +				configure number of buffers used for this
>  				channel
>  
> -		datatype	configure type of data that will travel over
> +		datatype
> +				configure type of data that will travel over
>  				this channel
>  
> -		direction	configure whether this link will be an input
> +		direction
> +				configure whether this link will be an input
>  				or output
>  
> -		dbr_size	configure DBR data buffer size (this is used
> +		dbr_size
> +				configure DBR data buffer size (this is used
>  				for MediaLB communication only)
>  
>  		packets_per_xact
> @@ -39,18 +45,23 @@ Description:
>  				transmitted via USB (this is used for USB
>  				communication only)
>  
> -		device		name of the device the link is to be attached to
> +		device
> +				name of the device the link is to be attached to
>  
> -		channel		name of the channel the link is to be attached to
> +		channel
> +				name of the channel the link is to be attached to
>  
> -		comp_params	pass parameters needed by some components
> +		comp_params
> +				pass parameters needed by some components
>  
> -		create_link	write '1' to this attribute to trigger the
> +		create_link
> +				write '1' to this attribute to trigger the
>  				creation of the link. In case of speculative
>  				configuration, the creation is post-poned until
>  				a physical device is being attached to the bus.
>  
> -		destroy_link	write '1' to this attribute to destroy an
> +		destroy_link
> +				write '1' to this attribute to destroy an
>  				active link
>  
>  What: 		/sys/kernel/config/most_video/<link>
> @@ -59,22 +70,28 @@ KernelVersion:  5.2
>  Description:
>  		The attributes:
>  
> -		buffer_size	configure the buffer size for this channel
> +		buffer_size
> +				configure the buffer size for this channel
>  
> -		subbuffer_size	configure the sub-buffer size for this channel
> +		subbuffer_size
> +				configure the sub-buffer size for this channel
>  				(needed for synchronous and isochrnous data)
>  
>  
> -		num_buffers	configure number of buffers used for this
> +		num_buffers
> +				configure number of buffers used for this
>  				channel
>  
> -		datatype	configure type of data that will travel over
> +		datatype
> +				configure type of data that will travel over
>  				this channel
>  
> -		direction	configure whether this link will be an input
> +		direction
> +				configure whether this link will be an input
>  				or output
>  
> -		dbr_size	configure DBR data buffer size (this is used
> +		dbr_size
> +				configure DBR data buffer size (this is used
>  				for MediaLB communication only)
>  
>  		packets_per_xact
> @@ -83,18 +100,23 @@ Description:
>  				transmitted via USB (this is used for USB
>  				communication only)
>  
> -		device		name of the device the link is to be attached to
> +		device
> +				name of the device the link is to be attached to
>  
> -		channel		name of the channel the link is to be attached to
> +		channel
> +				name of the channel the link is to be attached to
>  
> -		comp_params	pass parameters needed by some components
> +		comp_params
> +				pass parameters needed by some components
>  
> -		create_link	write '1' to this attribute to trigger the
> +		create_link
> +				write '1' to this attribute to trigger the
>  				creation of the link. In case of speculative
>  				configuration, the creation is post-poned until
>  				a physical device is being attached to the bus.
>  
> -		destroy_link	write '1' to this attribute to destroy an
> +		destroy_link
> +				write '1' to this attribute to destroy an
>  				active link
>  
>  What: 		/sys/kernel/config/most_net/<link>
> @@ -103,22 +125,28 @@ KernelVersion:  5.2
>  Description:
>  		The attributes:
>  
> -		buffer_size	configure the buffer size for this channel
> +		buffer_size
> +				configure the buffer size for this channel
>  
> -		subbuffer_size	configure the sub-buffer size for this channel
> +		subbuffer_size
> +				configure the sub-buffer size for this channel
>  				(needed for synchronous and isochrnous data)
>  
>  
> -		num_buffers	configure number of buffers used for this
> +		num_buffers
> +				configure number of buffers used for this
>  				channel
>  
> -		datatype	configure type of data that will travel over
> +		datatype
> +				configure type of data that will travel over
>  				this channel
>  
> -		direction	configure whether this link will be an input
> +		direction
> +				configure whether this link will be an input
>  				or output
>  
> -		dbr_size	configure DBR data buffer size (this is used
> +		dbr_size
> +				configure DBR data buffer size (this is used
>  				for MediaLB communication only)
>  
>  		packets_per_xact
> @@ -127,18 +155,23 @@ Description:
>  				transmitted via USB (this is used for USB
>  				communication only)
>  
> -		device		name of the device the link is to be attached to
> +		device
> +				name of the device the link is to be attached to
>  
> -		channel		name of the channel the link is to be attached to
> +		channel
> +				name of the channel the link is to be attached to
>  
> -		comp_params	pass parameters needed by some components
> +		comp_params
> +				pass parameters needed by some components
>  
> -		create_link	write '1' to this attribute to trigger the
> +		create_link
> +				write '1' to this attribute to trigger the
>  				creation of the link. In case of speculative
>  				configuration, the creation is post-poned until
>  				a physical device is being attached to the bus.
>  
> -		destroy_link	write '1' to this attribute to destroy an
> +		destroy_link
> +				write '1' to this attribute to destroy an
>  				active link
>  
>  What: 		/sys/kernel/config/most_sound/<card>
> @@ -147,7 +180,8 @@ KernelVersion:  5.2
>  Description:
>  		The attributes:
>  
> -		create_card	write '1' to this attribute to trigger the
> +		create_card
> +				write '1' to this attribute to trigger the
>                                  registration of the sound card with the ALSA
>  				subsystem.
>  
> @@ -157,22 +191,28 @@ KernelVersion:  5.2
>  Description:
>  		The attributes:
>  
> -		buffer_size	configure the buffer size for this channel
> +		buffer_size
> +				configure the buffer size for this channel
>  
> -		subbuffer_size	configure the sub-buffer size for this channel
> +		subbuffer_size
> +				configure the sub-buffer size for this channel
>  				(needed for synchronous and isochrnous data)
>  
>  
> -		num_buffers	configure number of buffers used for this
> +		num_buffers
> +				configure number of buffers used for this
>  				channel
>  
> -		datatype	configure type of data that will travel over
> +		datatype
> +				configure type of data that will travel over
>  				this channel
>  
> -		direction	configure whether this link will be an input
> +		direction
> +				configure whether this link will be an input
>  				or output
>  
> -		dbr_size	configure DBR data buffer size (this is used
> +		dbr_size
> +				configure DBR data buffer size (this is used
>  				for MediaLB communication only)
>  
>  		packets_per_xact
> @@ -181,16 +221,21 @@ Description:
>  				transmitted via USB (this is used for USB
>  				communication only)
>  
> -		device		name of the device the link is to be attached to
> +		device
> +				name of the device the link is to be attached to
>  
> -		channel		name of the channel the link is to be attached to
> +		channel
> +				name of the channel the link is to be attached to
>  
> -		comp_params	pass parameters needed by some components
> +		comp_params
> +				pass parameters needed by some components
>  
> -		create_link	write '1' to this attribute to trigger the
> +		create_link
> +				write '1' to this attribute to trigger the
>  				creation of the link. In case of speculative
>  				configuration, the creation is post-poned until
>  				a physical device is being attached to the bus.
>  
> -		destroy_link	write '1' to this attribute to destroy an
> +		destroy_link
> +				write '1' to this attribute to destroy an
>  				active link
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-ecm b/Documentation/ABI/testing/configfs-usb-gadget-ecm
> index 0addf7704b4c..272bc1e4ce2e 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-ecm
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-ecm
> @@ -4,13 +4,17 @@ KernelVersion:	3.11
>  Description:
>  		The attributes:
>  
> -		ifname		- network device interface name associated with
> +		ifname
> +			      - network device interface name associated with
>  				this function instance
> -		qmult		- queue length multiplier for high and
> +		qmult	
> +			      - queue length multiplier for high and
>  				super speed
> -		host_addr	- MAC address of host's end of this
> +		host_addr
> +			      - MAC address of host's end of this
>  				Ethernet over USB link
> -		dev_addr	- MAC address of device's end of this
> +		dev_addr
> +			      - MAC address of device's end of this
>  				Ethernet over USB link
>  
>  
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-eem b/Documentation/ABI/testing/configfs-usb-gadget-eem
> index a4c57158fcde..178c3d5fb647 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-eem
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-eem
> @@ -4,11 +4,13 @@ KernelVersion:	3.11
>  Description:
>  		The attributes:
>  
> -		ifname		- network device interface name associated with
> +		==========	=============================================
> +		ifname		network device interface name associated with
>  				this function instance
> -		qmult		- queue length multiplier for high and
> +		qmult		queue length multiplier for high and
>  				super speed
> -		host_addr	- MAC address of host's end of this
> +		host_addr	MAC address of host's end of this
>  				Ethernet over USB link
> -		dev_addr	- MAC address of device's end of this
> +		dev_addr	MAC address of device's end of this
>  				Ethernet over USB link
> +		==========	=============================================
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-loopback b/Documentation/ABI/testing/configfs-usb-gadget-loopback
> index 06beefbcf061..e6c6ba5ac7ff 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-loopback
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-loopback
> @@ -4,5 +4,7 @@ KernelVersion:	3.13
>  Description:
>  		The attributes:
>  
> -		qlen		- depth of loopback queue
> -		buflen		- buffer length
> +		=======		=======================
> +		qlen		depth of loopback queue
> +		buflen		buffer length
> +		=======		=======================
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-mass-storage b/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
> index 9931fb0d63ba..c86b63a7bb43 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
> @@ -4,12 +4,14 @@ KernelVersion:	3.13
>  Description:
>  		The attributes:
>  
> -		stall		- Set to permit function to halt bulk endpoints.
> +		===========	==============================================
> +		stall		Set to permit function to halt bulk endpoints.
>  				Disabled on some USB devices known not to work
>  				correctly. You should set it to true.
> -		num_buffers	- Number of pipeline buffers. Valid numbers
> +		num_buffers	Number of pipeline buffers. Valid numbers
>  				are 2..4. Available only if
>  				CONFIG_USB_GADGET_DEBUG_FILES is set.
> +		===========	==============================================
>  
>  What:		/config/usb-gadget/gadget/functions/mass_storage.name/lun.name
>  Date:		Oct 2013
> @@ -17,15 +19,17 @@ KernelVersion:	3.13
>  Description:
>  		The attributes:
>  
> -		file		- The path to the backing file for the LUN.
> +		===========	==============================================
> +		file		The path to the backing file for the LUN.
>  				Required if LUN is not marked as removable.
> -		ro		- Flag specifying access to the LUN shall be
> +		ro		Flag specifying access to the LUN shall be
>  				read-only. This is implied if CD-ROM emulation
>  				is enabled as well as when it was impossible
>  				to open "filename" in R/W mode.
> -		removable	- Flag specifying that LUN shall be indicated as
> +		removable	Flag specifying that LUN shall be indicated as
>  				being removable.
> -		cdrom		- Flag specifying that LUN shall be reported as
> +		cdrom		Flag specifying that LUN shall be reported as
>  				being a CD-ROM.
> -		nofua		- Flag specifying that FUA flag
> +		nofua		Flag specifying that FUA flag
>  				in SCSI WRITE(10,12)
> +		===========	==============================================
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-midi b/Documentation/ABI/testing/configfs-usb-gadget-midi
> index 6b341df7249c..07389cddd51a 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-midi
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-midi
> @@ -4,9 +4,11 @@ KernelVersion:	3.19
>  Description:
>  		The attributes:
>  
> -		index		- index value for the USB MIDI adapter
> -		id		- ID string for the USB MIDI adapter
> -		buflen		- MIDI buffer length
> -		qlen		- USB read request queue length
> -		in_ports	- number of MIDI input ports
> -		out_ports	- number of MIDI output ports
> +		==========	====================================
> +		index		index value for the USB MIDI adapter
> +		id		ID string for the USB MIDI adapter
> +		buflen		MIDI buffer length
> +		qlen		USB read request queue length
> +		in_ports	number of MIDI input ports
> +		out_ports	number of MIDI output ports
> +		==========	====================================
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-printer b/Documentation/ABI/testing/configfs-usb-gadget-printer
> index 6b0714e3c605..7aa731bac2da 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-printer
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-printer
> @@ -4,6 +4,8 @@ KernelVersion:	4.1
>  Description:
>  		The attributes:
>  
> -		pnp_string	- Data to be passed to the host in pnp string
> -		q_len		- Number of requests per endpoint
> +		==========      ===========================================
> +		pnp_string	Data to be passed to the host in pnp string
> +		q_len		Number of requests per endpoint
> +		==========      ===========================================
>  
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-sourcesink b/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
> index f56335af2d88..1f3d31b607b7 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
> @@ -4,11 +4,13 @@ KernelVersion:	3.13
>  Description:
>  		The attributes:
>  
> -		pattern		- 0 (all zeros), 1 (mod63), 2 (none)
> -		isoc_interval	- 1..16
> -		isoc_maxpacket	- 0 - 1023 (fs), 0 - 1024 (hs/ss)
> -		isoc_mult	- 0..2 (hs/ss only)
> -		isoc_maxburst	- 0..15 (ss only)
> -		buflen		- buffer length
> -		bulk_qlen	- depth of queue for bulk
> -		iso_qlen	- depth of queue for iso
> +		==============    ==================================
> +		pattern		  0 (all zeros), 1 (mod63), 2 (none)
> +		isoc_interval	  1..16
> +		isoc_maxpacket	  0 - 1023 (fs), 0 - 1024 (hs/ss)
> +		isoc_mult	  0..2 (hs/ss only)
> +		isoc_maxburst	  0..15 (ss only)
> +		buflen		  buffer length
> +		bulk_qlen	  depth of queue for bulk
> +		iso_qlen	  depth of queue for iso
> +		==============    ==================================
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-subset b/Documentation/ABI/testing/configfs-usb-gadget-subset
> index 9373e2c51ea4..0061b864351f 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-subset
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-subset
> @@ -4,11 +4,13 @@ KernelVersion:	3.11
>  Description:
>  		The attributes:
>  
> -		ifname		- network device interface name associated with
> +		==========	=============================================
> +		ifname		network device interface name associated with
>  				this function instance
> -		qmult		- queue length multiplier for high and
> +		qmult		queue length multiplier for high and
>  				super speed
> -		host_addr	- MAC address of host's end of this
> +		host_addr	MAC address of host's end of this
>  				Ethernet over USB link
> -		dev_addr	- MAC address of device's end of this
> +		dev_addr	MAC address of device's end of this
>  				Ethernet over USB link
> +		==========	=============================================
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-uac2 b/Documentation/ABI/testing/configfs-usb-gadget-uac2
> index 2bfdd4efa9bd..d4356c8b8cd6 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-uac2
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-uac2
> @@ -4,9 +4,11 @@ KernelVersion:	3.18
>  Description:
>  		The attributes:
>  
> -		c_chmask - capture channel mask
> -		c_srate - capture sampling rate
> -		c_ssize - capture sample size (bytes)
> -		p_chmask - playback channel mask
> -		p_srate - playback sampling rate
> -		p_ssize - playback sample size (bytes)
> +		=========  ============================
> +		c_chmask   capture channel mask
> +		c_srate    capture sampling rate
> +		c_ssize    capture sample size (bytes)
> +		p_chmask   playback channel mask
> +		p_srate    playback sampling rate
> +		p_ssize    playback sample size (bytes)
> +		=========  ============================
> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-uvc b/Documentation/ABI/testing/configfs-usb-gadget-uvc
> index cee81b0347bb..ac5e11af79a8 100644
> --- a/Documentation/ABI/testing/configfs-usb-gadget-uvc
> +++ b/Documentation/ABI/testing/configfs-usb-gadget-uvc
> @@ -55,7 +55,7 @@ Description:	Default output terminal descriptors
>  
>  		==============	=============================================
>  		iTerminal	index of string descriptor
> -		bSourceID 	id of the terminal to which this terminal
> +		bSourceID	id of the terminal to which this terminal
>  				is connected
>  		bAssocTerminal	id of the input terminal to which this output
>  				terminal is associated
> diff --git a/Documentation/ABI/testing/debugfs-cec-error-inj b/Documentation/ABI/testing/debugfs-cec-error-inj
> index 5afcd78fbdb7..8debcb08a3b5 100644
> --- a/Documentation/ABI/testing/debugfs-cec-error-inj
> +++ b/Documentation/ABI/testing/debugfs-cec-error-inj
> @@ -23,7 +23,7 @@ error injections without having to know the details of the driver-specific
>  commands.
>  
>  Note that the output of 'error-inj' shall be valid as input to 'error-inj'.
> -So this must work:
> +So this must work::
>  
>  	$ cat error-inj >einj.txt
>  	$ cat einj.txt >error-inj
> diff --git a/Documentation/ABI/testing/debugfs-driver-habanalabs b/Documentation/ABI/testing/debugfs-driver-habanalabs
> index 2e9ae311e02d..c5d678d39144 100644
> --- a/Documentation/ABI/testing/debugfs-driver-habanalabs
> +++ b/Documentation/ABI/testing/debugfs-driver-habanalabs
> @@ -20,9 +20,13 @@ Description:    Allow the root user to disable/enable in runtime the clock
>                  The user can supply a bitmask value, each bit represents
>                  a different engine to disable/enable its clock gating feature.
>                  The bitmask is composed of 20 bits:
> -                0  -  7 : DMA channels
> -                8  - 11 : MME engines
> -                12 - 19 : TPC engines
> +
> +		=======   ============
> +                0  -  7   DMA channels
> +                8  - 11   MME engines
> +                12 - 19   TPC engines
> +		=======   ============
> +
>                  The bit's location of a specific engine can be determined
>                  using (1 << GAUDI_ENGINE_ID_*). GAUDI_ENGINE_ID_* values
>                  are defined in uapi habanalabs.h file in enum gaudi_engine_id
> @@ -59,6 +63,7 @@ Description:    Allows the root user to read or write directly through the
>                  the generic Linux user-space PCI mapping) because the DDR bar
>                  is very small compared to the DDR memory and only the driver can
>                  move the bar before and after the transaction.
> +
>                  If the IOMMU is disabled, it also allows the root user to read
>                  or write from the host a device VA of a host mapped memory
>  
> @@ -73,6 +78,7 @@ Description:    Allows the root user to read or write 64 bit data directly
>                  the generic Linux user-space PCI mapping) because the DDR bar
>                  is very small compared to the DDR memory and only the driver can
>                  move the bar before and after the transaction.
> +
>                  If the IOMMU is disabled, it also allows the root user to read
>                  or write from the host a device VA of a host mapped memory
>  
> diff --git a/Documentation/ABI/testing/debugfs-pfo-nx-crypto b/Documentation/ABI/testing/debugfs-pfo-nx-crypto
> index 685d5a448423..f75a655c1531 100644
> --- a/Documentation/ABI/testing/debugfs-pfo-nx-crypto
> +++ b/Documentation/ABI/testing/debugfs-pfo-nx-crypto
> @@ -4,42 +4,42 @@ KernelVersion:	3.4
>  Contact:	Kent Yoder <key@linux.vnet.ibm.com>
>  Description:
>  
> -  These debugfs interfaces are built by the nx-crypto driver, built in
> +These debugfs interfaces are built by the nx-crypto driver, built in
>  arch/powerpc/crypto/nx.
>  
>  Error Detection
>  ===============
>  
>  errors:
> -- A u32 providing a total count of errors since the driver was loaded. The
> -only errors counted here are those returned from the hcall, H_COP_OP.
> +  A u32 providing a total count of errors since the driver was loaded. The
> +  only errors counted here are those returned from the hcall, H_COP_OP.
>  
>  last_error:
> -- The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not
> -recorded here (the hcall will retry until -EBUSY goes away).
> +  The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not
> +  recorded here (the hcall will retry until -EBUSY goes away).
>  
>  last_error_pid:
> -- The process ID of the process who received the most recent error from the
> -hcall.
> +  The process ID of the process who received the most recent error from the
> +  hcall.
>  
>  Device Use
>  ==========
>  
>  aes_bytes:
> -- The total number of bytes encrypted using AES in any of the driver's
> -supported modes.
> +  The total number of bytes encrypted using AES in any of the driver's
> +  supported modes.
>  
>  aes_ops:
> -- The total number of AES operations submitted to the hardware.
> +  The total number of AES operations submitted to the hardware.
>  
>  sha256_bytes:
> -- The total number of bytes hashed by the hardware using SHA-256.
> +  The total number of bytes hashed by the hardware using SHA-256.
>  
>  sha256_ops:
> -- The total number of SHA-256 operations submitted to the hardware.
> +  The total number of SHA-256 operations submitted to the hardware.
>  
>  sha512_bytes:
> -- The total number of bytes hashed by the hardware using SHA-512.
> +  The total number of bytes hashed by the hardware using SHA-512.
>  
>  sha512_ops:
> -- The total number of SHA-512 operations submitted to the hardware.
> +  The total number of SHA-512 operations submitted to the hardware.
> diff --git a/Documentation/ABI/testing/debugfs-pktcdvd b/Documentation/ABI/testing/debugfs-pktcdvd
> index 787907d70462..f6f65a4faea0 100644
> --- a/Documentation/ABI/testing/debugfs-pktcdvd
> +++ b/Documentation/ABI/testing/debugfs-pktcdvd
> @@ -10,7 +10,7 @@ these files in debugfs:
>  /sys/kernel/debug/pktcdvd/pktcdvd[0-7]/
>  
>      ====            ====== ====================================
> -    info            (0444) Lots of driver statistics and infos.
> +    info            0444   Lots of driver statistics and infos.
>      ====            ====== ====================================
>  
>  Example::
> diff --git a/Documentation/ABI/testing/debugfs-turris-mox-rwtm b/Documentation/ABI/testing/debugfs-turris-mox-rwtm
> index c8f7dadd591c..ad08f535af3b 100644
> --- a/Documentation/ABI/testing/debugfs-turris-mox-rwtm
> +++ b/Documentation/ABI/testing/debugfs-turris-mox-rwtm
> @@ -2,10 +2,12 @@ What:		/sys/kernel/debug/turris-mox-rwtm/do_sign
>  Date:		Jun 2020
>  KernelVersion:	5.8
>  Contact:	Marek Behún <marek.behun@nic.cz>
> -Description:	(W)
> -		    Message to sign with the ECDSA private key stored in
> +Description:
> +
> +		=== ===========================================================
> +		(W) Message to sign with the ECDSA private key stored in
>  		    device's OTP. The message must be exactly 64 bytes (since
>  		    this is intended for SHA-512 hashes).
> -		(R)
> -		    The resulting signature, 136 bytes. This contains the R and
> +		(R) The resulting signature, 136 bytes. This contains the R and
>  		    S values of the ECDSA signature, both in big-endian format.
> +		=== ===========================================================
> diff --git a/Documentation/ABI/testing/debugfs-wilco-ec b/Documentation/ABI/testing/debugfs-wilco-ec
> index 9d8d9d2def5b..682e3c09ef4d 100644
> --- a/Documentation/ABI/testing/debugfs-wilco-ec
> +++ b/Documentation/ABI/testing/debugfs-wilco-ec
> @@ -27,16 +27,17 @@ Description:
>  		for writing, two for the type and at least a single byte of
>  		data.
>  
> -		Example:
> -		// Request EC info type 3 (EC firmware build date)
> -		// Corresponds with sending type 0x00f0 with
> -		// MBOX = [38, 00, 03, 00]
> -		$ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw
> -		// View the result. The decoded ASCII result "12/21/18" is
> -		// included after the raw hex.
> -		// Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...]
> -		$ cat /sys/kernel/debug/wilco_ec/raw
> -		00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00  ..12/21/18.8...
> +		Example::
> +
> +		    // Request EC info type 3 (EC firmware build date)
> +		    // Corresponds with sending type 0x00f0 with
> +		    // MBOX = [38, 00, 03, 00]
> +		    $ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw
> +		    // View the result. The decoded ASCII result "12/21/18" is
> +		    // included after the raw hex.
> +		    // Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...]
> +		    $ cat /sys/kernel/debug/wilco_ec/raw
> +		    00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00  ..12/21/18.8...
>  
>  		Note that the first 16 bytes of the received MBOX[] will be
>  		printed, even if some of the data is junk, and skipping bytes
> diff --git a/Documentation/ABI/testing/dell-smbios-wmi b/Documentation/ABI/testing/dell-smbios-wmi
> index fc919ce16008..5f3a0dc67050 100644
> --- a/Documentation/ABI/testing/dell-smbios-wmi
> +++ b/Documentation/ABI/testing/dell-smbios-wmi
> @@ -10,29 +10,29 @@ Description:
>  		<uapi/linux/wmi.h>
>  
>  		1) To perform an SMBIOS call from userspace, you'll need to
> -		first determine the minimum size of the calling interface
> -		buffer for your machine.
> -		Platforms that contain larger buffers can return larger
> -		objects from the system firmware.
> -		Commonly this size is either 4k or 32k.
> +		   first determine the minimum size of the calling interface
> +		   buffer for your machine.
> +		   Platforms that contain larger buffers can return larger
> +		   objects from the system firmware.
> +		   Commonly this size is either 4k or 32k.
>  
> -		To determine the size of the buffer read() a u64 dword from
> -		the WMI character device /dev/wmi/dell-smbios.
> +		   To determine the size of the buffer read() a u64 dword from
> +		   the WMI character device /dev/wmi/dell-smbios.
>  
>  		2) After you've determined the minimum size of the calling
> -		interface buffer, you can allocate a structure that represents
> -		the structure documented above.
> +		   interface buffer, you can allocate a structure that represents
> +		   the structure documented above.
>  
>  		3) In the 'length' object store the size of the buffer you
> -		determined above and allocated.
> +		   determined above and allocated.
>  
>  		4) In this buffer object, prepare as necessary for the SMBIOS
> -		call you're interested in.  Typically SMBIOS buffers have
> -		"class", "select", and "input" defined to values that coincide
> -		with the data you are interested in.
> -		Documenting class/select/input values is outside of the scope
> -		of this documentation. Check with the libsmbios project for
> -		further documentation on these values.
> +		   call you're interested in.  Typically SMBIOS buffers have
> +		   "class", "select", and "input" defined to values that coincide
> +		   with the data you are interested in.
> +		   Documenting class/select/input values is outside of the scope
> +		   of this documentation. Check with the libsmbios project for
> +		   further documentation on these values.
>  
>  		6) Run the call by using ioctl() as described in the header.
>  
> diff --git a/Documentation/ABI/testing/gpio-cdev b/Documentation/ABI/testing/gpio-cdev
> index 7b265fbb47e3..66bdcd188b6c 100644
> --- a/Documentation/ABI/testing/gpio-cdev
> +++ b/Documentation/ABI/testing/gpio-cdev
> @@ -12,15 +12,16 @@ Description:
>  		The following file operations are supported:
>  
>  		open(2)
> -		Currently the only useful flags are O_RDWR.
> +		  Currently the only useful flags are O_RDWR.
>  
>  		ioctl(2)
> -		Initiate various actions.
> -		See the inline documentation in [include/uapi]<linux/gpio.h>
> -		for descriptions of all ioctls.
> +		  Initiate various actions.
> +
> +		  See the inline documentation in [include/uapi]<linux/gpio.h>
> +		  for descriptions of all ioctls.
>  
>  		close(2)
> -		Stops and free up the I/O contexts that was associated
> -		with the file descriptor.
> +		  Stops and free up the I/O contexts that was associated
> +		  with the file descriptor.
>  
>  Users:		TBD
> diff --git a/Documentation/ABI/testing/procfs-diskstats b/Documentation/ABI/testing/procfs-diskstats
> index df5a3a8c1edf..e58d641443d3 100644
> --- a/Documentation/ABI/testing/procfs-diskstats
> +++ b/Documentation/ABI/testing/procfs-diskstats
> @@ -35,7 +35,9 @@ Description:
>  
>  		Kernel 5.5+ appends two more fields for flush requests:
>  
> -		19 - flush requests completed successfully
> -		20 - time spent flushing
> +		==  =====================================
> +		19  flush requests completed successfully
> +		20  time spent flushing
> +		==  =====================================
>  
>  		For more details refer to Documentation/admin-guide/iostats.rst
> diff --git a/Documentation/ABI/testing/procfs-smaps_rollup b/Documentation/ABI/testing/procfs-smaps_rollup
> index 046978193368..a4e31c465194 100644
> --- a/Documentation/ABI/testing/procfs-smaps_rollup
> +++ b/Documentation/ABI/testing/procfs-smaps_rollup
> @@ -14,28 +14,28 @@ Description:
>  		For more details, see Documentation/filesystems/proc.rst
>  		and the procfs man page.
>  
> -		Typical output looks like this:
> +		Typical output looks like this::
>  
> -		00100000-ff709000 ---p 00000000 00:00 0		 [rollup]
> -		Size:               1192 kB
> -		KernelPageSize:        4 kB
> -		MMUPageSize:           4 kB
> -		Rss:		     884 kB
> -		Pss:		     385 kB
> -		Pss_Anon:	     301 kB
> -		Pss_File:	      80 kB
> -		Pss_Shmem:	       4 kB
> -		Shared_Clean:	     696 kB
> -		Shared_Dirty:	       0 kB
> -		Private_Clean:	     120 kB
> -		Private_Dirty:	      68 kB
> -		Referenced:	     884 kB
> -		Anonymous:	      68 kB
> -		LazyFree:	       0 kB
> -		AnonHugePages:	       0 kB
> -		ShmemPmdMapped:	       0 kB
> -		Shared_Hugetlb:	       0 kB
> -		Private_Hugetlb:       0 kB
> -		Swap:		       0 kB
> -		SwapPss:	       0 kB
> -		Locked:		     385 kB
> +			00100000-ff709000 ---p 00000000 00:00 0		 [rollup]
> +			Size:               1192 kB
> +			KernelPageSize:        4 kB
> +			MMUPageSize:           4 kB
> +			Rss:		     884 kB
> +			Pss:		     385 kB
> +			Pss_Anon:	     301 kB
> +			Pss_File:	      80 kB
> +			Pss_Shmem:	       4 kB
> +			Shared_Clean:	     696 kB
> +			Shared_Dirty:	       0 kB
> +			Private_Clean:	     120 kB
> +			Private_Dirty:	      68 kB
> +			Referenced:	     884 kB
> +			Anonymous:	      68 kB
> +			LazyFree:	       0 kB
> +			AnonHugePages:	       0 kB
> +			ShmemPmdMapped:	       0 kB
> +			Shared_Hugetlb:	       0 kB
> +			Private_Hugetlb:       0 kB
> +			Swap:		       0 kB
> +			SwapPss:	       0 kB
> +			Locked:		     385 kB
> diff --git a/Documentation/ABI/testing/pstore b/Documentation/ABI/testing/pstore
> index d45209abdb1b..5b02540781a2 100644
> --- a/Documentation/ABI/testing/pstore
> +++ b/Documentation/ABI/testing/pstore
> @@ -9,25 +9,25 @@ Description:	Generic interface to platform dependent persistent storage.
>  		provide a generic interface to show records captured in
>  		the dying moments.  In the case of a panic the last part
>  		of the console log is captured, but other interesting
> -		data can also be saved.
> +		data can also be saved::
>  
> -		# mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore
> +		    # mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore
>  
> -		$ ls -l /sys/fs/pstore/
> -		total 0
> -		-r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
> +		    $ ls -l /sys/fs/pstore/
> +		    total 0
> +		    -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
>  
>  		Different users of this interface will result in different
>  		filename prefixes.  Currently two are defined:
>  
> -		"dmesg"	- saved console log
> -		"mce"	- architecture dependent data from fatal h/w error
> +		- "dmesg" - saved console log
> +		- "mce"   - architecture dependent data from fatal h/w error
>  
>  		Once the information in a file has been read, removing
>  		the file will signal to the underlying persistent storage
> -		device that it can reclaim the space for later re-use.
> +		device that it can reclaim the space for later re-use::
>  
> -		$ rm /sys/fs/pstore/dmesg-erst-1
> +		    $ rm /sys/fs/pstore/dmesg-erst-1
>  
>  		The expectation is that all files in /sys/fs/pstore/
>  		will be saved elsewhere and erased from persistent store
> @@ -44,4 +44,3 @@ Description:	Generic interface to platform dependent persistent storage.
>  		backends are available, the preferred backend may be
>  		set by passing the pstore.backend= argument to the kernel at
>  		boot time.
> -
> diff --git a/Documentation/ABI/testing/sysfs-block-rnbd b/Documentation/ABI/testing/sysfs-block-rnbd
> index 8f070b47f361..14a6fe9422b3 100644
> --- a/Documentation/ABI/testing/sysfs-block-rnbd
> +++ b/Documentation/ABI/testing/sysfs-block-rnbd
> @@ -9,9 +9,9 @@ Description:	To unmap a volume, "normal" or "force" has to be written to:
>  		is using the device.  When "force" is used, the device is also unmapped
>  		when device is in use.  All I/Os that are in progress will fail.
>  
> -		Example:
> +		Example::
>  
> -		# echo "normal" > /sys/block/rnbd0/rnbd/unmap_device
> +		  # echo "normal" > /sys/block/rnbd0/rnbd/unmap_device
>  
>  What:		/sys/block/rnbd<N>/rnbd/state
>  Date:		Feb 2020
> diff --git a/Documentation/ABI/testing/sysfs-bus-acpi b/Documentation/ABI/testing/sysfs-bus-acpi
> index c78603497b97..58abacf59b2a 100644
> --- a/Documentation/ABI/testing/sysfs-bus-acpi
> +++ b/Documentation/ABI/testing/sysfs-bus-acpi
> @@ -5,6 +5,7 @@ Description:
>  		This attribute indicates the full path of ACPI namespace
>  		object associated with the device object.  For example,
>  		\_SB_.PCI0.
> +
>  		This file is not present for device objects representing
>  		fixed ACPI hardware features (like power and sleep
>  		buttons).
> diff --git a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10 b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
> index b5f526081711..3e92cbd3fd83 100644
> --- a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
> +++ b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
> @@ -4,7 +4,10 @@ KernelVersion:	3.19
>  Contact:	Mathieu Poirier <mathieu.poirier@linaro.org>
>  Description:	(RW) Add/remove a sink from a trace path.  There can be multiple
>  		source for a single sink.
> -		ex: echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink
> +
> +		ex::
> +
> +		  echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink
>  
>  What:		/sys/bus/coresight/devices/<memory_map>.etb/trigger_cntr
>  Date:		November 2014
> diff --git a/Documentation/ABI/testing/sysfs-bus-css b/Documentation/ABI/testing/sysfs-bus-css
> index 966f8504bd7b..12a733fe357f 100644
> --- a/Documentation/ABI/testing/sysfs-bus-css
> +++ b/Documentation/ABI/testing/sysfs-bus-css
> @@ -20,6 +20,7 @@ Contact:	Cornelia Huck <cornelia.huck@de.ibm.com>
>  Description:	Contains the ids of the channel paths used by this
>  		subchannel, as reported by the channel subsystem
>  		during subchannel recognition.
> +
>  		Note: This is an I/O-subchannel specific attribute.
>  Users:		s390-tools, HAL
>  
> @@ -31,6 +32,7 @@ Description:	Contains the PIM/PAM/POM values, as reported by the
>  		channel subsystem when last queried by the common I/O
>  		layer (this implies that this attribute is not necessarily
>  		in sync with the values current in the channel subsystem).
> +
>  		Note: This is an I/O-subchannel specific attribute.
>  Users:		s390-tools, HAL
>  
> @@ -53,6 +55,7 @@ Description:	This file allows the driver for a device to be specified. When
>  		opt-out of driver binding using a driver_override name such as
>  		"none".  Only a single driver may be specified in the override,
>  		there is no support for parsing delimiters.
> +
>  		Note that unlike the mechanism of the same name for pci, this
>  		file does not allow to override basic matching rules. I.e.,
>  		the driver must still match the subchannel type of the device.
> diff --git a/Documentation/ABI/testing/sysfs-bus-dfl b/Documentation/ABI/testing/sysfs-bus-dfl
> index 23543be904f2..b0265ab17200 100644
> --- a/Documentation/ABI/testing/sysfs-bus-dfl
> +++ b/Documentation/ABI/testing/sysfs-bus-dfl
> @@ -4,6 +4,7 @@ KernelVersion:	5.10
>  Contact:	Xu Yilun <yilun.xu@intel.com>
>  Description:	Read-only. It returns type of DFL FIU of the device. Now DFL
>  		supports 2 FIU types, 0 for FME, 1 for PORT.
> +
>  		Format: 0x%x
>  
>  What:		/sys/bus/dfl/devices/dfl_dev.X/feature_id
> @@ -12,4 +13,5 @@ KernelVersion:	5.10
>  Contact:	Xu Yilun <yilun.xu@intel.com>
>  Description:	Read-only. It returns feature identifier local to its DFL FIU
>  		type.
> +
>  		Format: 0x%x
> diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7 b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
> index 2273627df190..de390a010af8 100644
> --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
> +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
> @@ -7,7 +7,7 @@ Description:    Read-only. Attribute group to describe the magic bits
>  
>                  Each attribute under this group defines a bit range of the
>                  perf_event_attr.config. All supported attributes are listed
> -                below.
> +                below::
>  
>  				chip = "config:16-31"
>  				core  = "config:16-31"
> @@ -16,9 +16,9 @@ Description:    Read-only. Attribute group to describe the magic bits
>  				offset = "config:32-63"
>  				vcpu = "config:16-31"
>  
> -               For example,
> +                For example::
>  
> -		PM_PB_CYC =  "domain=1,offset=0x80,chip=?,lpar=0x0"
> +		  PM_PB_CYC =  "domain=1,offset=0x80,chip=?,lpar=0x0"
>  
>  		In this event, '?' after chip specifies that
>  		this value will be provided by user while running this event.
> diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
> index 6a023b42486c..12e2bf92783f 100644
> --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
> +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
> @@ -7,7 +7,7 @@ Description:    Read-only. Attribute group to describe the magic bits
>  
>                  Each attribute under this group defines a bit range of the
>                  perf_event_attr.config. All supported attributes are listed
> -                below.
> +                below::
>  
>  				counter_info_version  = "config:16-23"
>  				length  = "config:24-31"
> @@ -20,9 +20,9 @@ Description:    Read-only. Attribute group to describe the magic bits
>  				secondary_index = "config:0-15"
>  				starting_index = "config:32-63"
>  
> -               For example,
> +                For example::
>  
> -		processor_core_utilization_instructions_completed = "request=0x94,
> +		  processor_core_utilization_instructions_completed = "request=0x94,
>  					phys_processor_idx=?,counter_info_version=0x8,
>  					length=8,offset=0x18"
>  
> @@ -36,6 +36,7 @@ Description:
>  		'0' if the hypervisor is configured to forbid access to event
>  		counters being accumulated by other guests and to physical
>  		domain event counters.
> +
>  		'1' if that access is allowed.
>  
>  What:		/sys/bus/event_source/devices/hv_gpci/interface/ga
> diff --git a/Documentation/ABI/testing/sysfs-bus-fcoe b/Documentation/ABI/testing/sysfs-bus-fcoe
> index 657df13b100d..8fe787cc4ab7 100644
> --- a/Documentation/ABI/testing/sysfs-bus-fcoe
> +++ b/Documentation/ABI/testing/sysfs-bus-fcoe
> @@ -3,16 +3,19 @@ Date:		August 2012
>  KernelVersion:	TBD
>  Contact:	Robert Love <robert.w.love@intel.com>, devel@open-fcoe.org
>  Description:	The FCoE bus. Attributes in this directory are control interfaces.
> +
>  Attributes:
>  
> -	ctlr_create: 'FCoE Controller' instance creation interface. Writing an
> +	ctlr_create:
> +		     'FCoE Controller' instance creation interface. Writing an
>  		     <ifname> to this file will allocate and populate sysfs with a
>  		     fcoe_ctlr_device (ctlr_X). The user can then configure any
>  		     per-port settings and finally write to the fcoe_ctlr_device's
>  		     'start' attribute to begin the kernel's discovery and login
>  		     process.
>  
> -	ctlr_destroy: 'FCoE Controller' instance removal interface. Writing a
> +	ctlr_destroy:
> +		       'FCoE Controller' instance removal interface. Writing a
>  		       fcoe_ctlr_device's sysfs name to this file will log the
>  		       fcoe_ctlr_device out of the fabric or otherwise connected
>  		       FCoE devices. It will also free all kernel memory allocated
> @@ -32,11 +35,13 @@ Description:	'FCoE Controller' instances on the fcoe bus.
>  
>  Attributes:
>  
> -	fcf_dev_loss_tmo: Device loss timeout period (see below). Changing
> +	fcf_dev_loss_tmo:
> +			  Device loss timeout period (see below). Changing
>  			  this value will change the dev_loss_tmo for all
>  			  FCFs discovered by this controller.
>  
> -	mode:		  Display or change the FCoE Controller's mode. Possible
> +	mode:
> +			  Display or change the FCoE Controller's mode. Possible
>  			  modes are 'Fabric' and 'VN2VN'. If a FCoE Controller
>  			  is started in 'Fabric' mode then FIP FCF discovery is
>  			  initiated and ultimately a fabric login is attempted.
> @@ -44,23 +49,30 @@ Attributes:
>  			  FIP VN2VN discovery and login is performed. A FCoE
>  			  Controller only supports one mode at a time.
>  
> -	enabled:	  Whether an FCoE controller is enabled or disabled.
> +	enabled:
> +			  Whether an FCoE controller is enabled or disabled.
>  			  0 if disabled, 1 if enabled. Writing either 0 or 1
>  			  to this file will enable or disable the FCoE controller.
>  
> -	lesb/link_fail:   Link Error Status Block (LESB) link failure count.
> +	lesb/link_fail:
> +			  Link Error Status Block (LESB) link failure count.
>  
> -	lesb/vlink_fail:  Link Error Status Block (LESB) virtual link
> +	lesb/vlink_fail:
> +		          Link Error Status Block (LESB) virtual link
>  			  failure count.
>  
> -	lesb/miss_fka:    Link Error Status Block (LESB) missed FCoE
> +	lesb/miss_fka:
> +			  Link Error Status Block (LESB) missed FCoE
>  			  Initialization Protocol (FIP) Keep-Alives (FKA).
>  
> -	lesb/symb_err:    Link Error Status Block (LESB) symbolic error count.
> +	lesb/symb_err:
> +			  Link Error Status Block (LESB) symbolic error count.
>  
> -	lesb/err_block:   Link Error Status Block (LESB) block error count.
> +	lesb/err_block:
> +			  Link Error Status Block (LESB) block error count.
>  
> -	lesb/fcs_error:   Link Error Status Block (LESB) Fibre Channel
> +	lesb/fcs_error:
> +			  Link Error Status Block (LESB) Fibre Channel
>  			  Services error count.
>  
>  Notes: ctlr_X (global increment starting at 0)
> @@ -75,31 +87,41 @@ Description:	'FCoE FCF' instances on the fcoe bus. A FCF is a Fibre Channel
>  		Fibre Channel frames into a FC fabric. It can also take
>  		outbound FC frames and pack them in Ethernet packets to
>  		be sent to their destination on the Ethernet segment.
> +
>  Attributes:
>  
> -	fabric_name: Identifies the fabric that the FCF services.
> +	fabric_name:
> +		     Identifies the fabric that the FCF services.
>  
> -	switch_name: Identifies the FCF.
> +	switch_name:
> +		     Identifies the FCF.
>  
> -	priority:    The switch's priority amongst other FCFs on the same
> +	priority:
> +		     The switch's priority amongst other FCFs on the same
>  		     fabric.
>  
> -	selected:    1 indicates that the switch has been selected for use;
> +	selected:
> +		     1 indicates that the switch has been selected for use;
>  		     0 indicates that the switch will not be used.
>  
> -	fc_map:      The Fibre Channel MAP
> +	fc_map:
> +		     The Fibre Channel MAP
>  
> -	vfid:	     The Virtual Fabric ID
> +	vfid:
> +		     The Virtual Fabric ID
>  
> -	mac:         The FCF's MAC address
> +	mac:
> +		     The FCF's MAC address
>  
> -	fka_period:  The FIP Keep-Alive period
> +	fka_period:
> +		     The FIP Keep-Alive period
>  
>  	fabric_state: The internal kernel state
> -		      "Unknown" - Initialization value
> -		      "Disconnected" - No link to the FCF/fabric
> -		      "Connected" - Host is connected to the FCF
> -		      "Deleted" - FCF is being removed from the system
> +
> +		      - "Unknown" - Initialization value
> +		      - "Disconnected" - No link to the FCF/fabric
> +		      - "Connected" - Host is connected to the FCF
> +		      - "Deleted" - FCF is being removed from the system
>  
>  	dev_loss_tmo: The device loss timeout period for this FCF.
>  
> diff --git a/Documentation/ABI/testing/sysfs-bus-fsl-mc b/Documentation/ABI/testing/sysfs-bus-fsl-mc
> index 80256b8b4f26..bf3c6af6ad89 100644
> --- a/Documentation/ABI/testing/sysfs-bus-fsl-mc
> +++ b/Documentation/ABI/testing/sysfs-bus-fsl-mc
> @@ -6,8 +6,10 @@ Description:
>  		the driver to attempt to bind to the device found at
>  		this location. The format for the location is Object.Id
>  		and is the same as found in /sys/bus/fsl-mc/devices/.
> -                For example:
> -		# echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind
> +
> +                For example::
> +
> +		  # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind
>  
>  What:		/sys/bus/fsl-mc/drivers/.../unbind
>  Date:		December 2016
> @@ -17,5 +19,7 @@ Description:
>  		driver to attempt to unbind from the device found at
>  		this location. The format for the location is Object.Id
>  		and is the same as found in /sys/bus/fsl-mc/devices/.
> -                For example:
> -		# echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind
> +
> +                For example::
> +
> +		  # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind
> diff --git a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480 b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
> index 9de269bb0ae5..42dfc9399d2d 100644
> --- a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
> +++ b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
> @@ -3,19 +3,25 @@ Date:		February 2011
>  Contact:	Minkyu Kang <mk7.kang@samsung.com>
>  Description:
>  		show what device is attached
> -		NONE - no device
> -		USB - USB device is attached
> -		UART - UART is attached
> -		CHARGER - Charger is attaced
> -		JIG - JIG is attached
> +
> +		=======  ======================
> +		NONE     no device
> +		USB      USB device is attached
> +		UART     UART is attached
> +		CHARGER  Charger is attaced
> +		JIG      JIG is attached
> +		=======  ======================
>  
>  What:		/sys/bus/i2c/devices/.../switch
>  Date:		February 2011
>  Contact:	Minkyu Kang <mk7.kang@samsung.com>
>  Description:
>  		show or set the state of manual switch
> -		VAUDIO - switch to VAUDIO path
> -		UART - switch to UART path
> -		AUDIO - switch to AUDIO path
> -		DHOST - switch to DHOST path
> -		AUTO - switch automatically by device
> +
> +		=======  ==============================
> +		VAUDIO   switch to VAUDIO path
> +		UART     switch to UART path
> +		AUDIO    switch to AUDIO path
> +		DHOST    switch to DHOST path
> +		AUTO     switch automatically by device
> +		=======  ==============================
> diff --git a/Documentation/ABI/testing/sysfs-bus-i3c b/Documentation/ABI/testing/sysfs-bus-i3c
> index 2f332ec36f82..1f4a2662335b 100644
> --- a/Documentation/ABI/testing/sysfs-bus-i3c
> +++ b/Documentation/ABI/testing/sysfs-bus-i3c
> @@ -84,6 +84,7 @@ Description:
>  		by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
>  		See the I3C specification for more details about these HDR
>  		modes.
> +
>  		This entry describes the HDRCAP of the master controller
>  		driving the bus.
>  
> @@ -135,6 +136,7 @@ Description:
>  		Expose the HDR (High Data Rate) capabilities of a device.
>  		Returns a list of supported HDR mode, each element is separated
>  		by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
> +
>  		See the I3C specification for more details about these HDR
>  		modes.
>  
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
> index e3df71987eff..df42bed09f25 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio
> +++ b/Documentation/ABI/testing/sysfs-bus-iio
> @@ -15,6 +15,7 @@ Description:
>  		based on hardware generated events (e.g. data ready) or
>  		provided by a separate driver for other hardware (e.g.
>  		periodic timer, GPIO or high resolution timer).
> +
>  		Contains trigger type specific elements. These do not
>  		generalize well and hence are not documented in this file.
>  		X is the IIO index of the trigger.
> @@ -666,6 +667,7 @@ Description:
>  		<type>[Y][_name]_<raw|input>_thresh_falling_value may take
>  		different values, but the device can only enable both thresholds
>  		or neither.
> +
>  		Note the driver will assume the last p events requested are
>  		to be enabled where p is how many it supports (which may vary
>  		depending on the exact set requested. So if you want to be
> @@ -720,6 +722,7 @@ Description:
>  		<type>[Y][_name]_<raw|input>_roc_falling_value may take
>  		different values, but the device can only enable both rate of
>  		change thresholds or neither.
> +
>  		Note the driver will assume the last p events requested are
>  		to be enabled where p is however many it supports (which may
>  		vary depending on the exact set requested. So if you want to be
> @@ -775,9 +778,11 @@ Description:
>  		Specifies the value of threshold that the device is comparing
>  		against for the events enabled by
>  		<type>Y[_name]_thresh[_rising|falling]_en.
> +
>  		If separate attributes exist for the two directions, but
>  		direction is not specified for this attribute, then a single
>  		threshold value applies to both directions.
> +
>  		The raw or input element of the name indicates whether the
>  		value is in raw device units or in processed units (as _raw
>  		and _input do on sysfs direct channel read attributes).
> @@ -860,6 +865,7 @@ Description:
>  		If separate attributes exist for the two directions, but
>  		direction is not specified for this attribute, then a single
>  		hysteresis value applies to both directions.
> +
>  		For falling events the hysteresis is added to the _value attribute for
>  		this event to get the upper threshold for when the event goes back to
>  		normal, for rising events the hysteresis is subtracted from the _value
> @@ -906,6 +912,7 @@ Description:
>  		Specifies the value of rate of change threshold that the
>  		device is comparing against for the events enabled by
>  		<type>[Y][_name]_roc[_rising|falling]_en.
> +
>  		If separate attributes exist for the two directions,
>  		but direction is not specified for this attribute,
>  		then a single threshold value applies to both directions.
> @@ -1305,6 +1312,7 @@ Description:
>  		Proximity measurement indicating that some
>  		object is near the sensor, usually by observing
>  		reflectivity of infrared or ultrasound emitted.
> +
>  		Often these sensors are unit less and as such conversion
>  		to SI units is not possible. Higher proximity measurements
>  		indicate closer objects, and vice versa. Units after
> @@ -1450,9 +1458,12 @@ Contact:	linux-iio@vger.kernel.org
>  Description:
>  		A single positive integer specifying the maximum number of scan
>  		elements to wait for.
> +
>  		Poll will block until the watermark is reached.
> +
>  		Blocking read will wait until the minimum between the requested
>  		read amount or the low water mark is available.
> +
>  		Non-blocking read will retrieve the available samples from the
>  		buffer even if there are less samples then watermark level. This
>  		allows the application to block on poll with a timeout and read
> @@ -1481,11 +1492,13 @@ Description:
>  		device settings allows it (e.g. if a trigger is set that samples
>  		data differently that the hardware fifo does then hardware fifo
>  		will not enabled).
> +
>  		If the hardware fifo is enabled and the level of the hardware
>  		fifo reaches the hardware fifo watermark level the device will
>  		flush its hardware fifo to the device buffer. Doing a non
>  		blocking read on the device when no samples are present in the
>  		device buffer will also force a flush.
> +
>  		When the hardware fifo is enabled there is no need to use a
>  		trigger to use buffer mode since the watermark settings
>  		guarantees that the hardware fifo is flushed to the device
> @@ -1523,6 +1536,7 @@ Description:
>  		A single positive integer specifying the minimum watermark level
>  		for the hardware fifo of this device. If the device does not
>  		have a hardware fifo this entry is not present.
> +
>  		If the user sets buffer/watermark to a value less than this one,
>  		then the hardware watermark will remain unset.
>  
> @@ -1533,6 +1547,7 @@ Description:
>  		A single positive integer specifying the maximum watermark level
>  		for the hardware fifo of this device. If the device does not
>  		have a hardware fifo this entry is not present.
> +
>  		If the user sets buffer/watermark to a value greater than this
>  		one, then the hardware watermark will be capped at this value.
>  
> @@ -1544,6 +1559,7 @@ Description:
>  		levels for the hardware fifo. This entry is optional and if it
>  		is not present it means that all the values between
>  		hwfifo_watermark_min and hwfifo_watermark_max are supported.
> +
>  		If the user sets buffer/watermark to a value greater than
>  		hwfifo_watermak_min but not equal to any of the values in this
>  		list, the driver will chose an appropriate value for the
> @@ -1605,7 +1621,8 @@ KernelVersion:	4.1.0
>  Contact:	linux-iio@vger.kernel.org
>  Description:
>  		'1' (enable) or '0' (disable) specifying the enable
> -		of heater function. Same reading values apply
> +		of heater function. Same reading values apply.
> +
>  		This ABI is especially applicable for humidity sensors
>  		to heatup the device and get rid of any condensation
>  		in some humidity environment
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435 b/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
> index f30b4c424fb6..4b01150af397 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
> @@ -19,9 +19,11 @@ Description:
>  		is separately set for "GND-Open" and "Supply-Open" modes.
>  		Channels 0..31 have common low threshold values, but could have different
>  		sensing_modes.
> +
>  		The low voltage threshold range is between 2..21V.
>  		Hysteresis between low and high thresholds can not be lower then 2 and
>  		can not be odd.
> +
>  		If falling threshold results hysteresis to odd value then rising
>  		threshold is automatically subtracted by one.
>  
> @@ -34,10 +36,13 @@ Description:
>  		this value then the threshold rising event is pushed.
>  		Depending on in_voltageY_sensing_mode the high voltage threshold
>  		is separately set for "GND-Open" and "Supply-Open" modes.
> +
>  		Channels 0..31 have common high threshold values, but could have different
>  		sensing_modes.
> +
>  		The high voltage threshold range is between 3..22V.
>  		Hysteresis between low and high thresholds can not be lower then 2 and
>  		can not be odd.
> +
>  		If rising threshold results hysteresis to odd value then falling
>  		threshold is automatically appended by one.
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32 b/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
> index efe4c85e3c8b..1975c7a1af34 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
> @@ -5,10 +5,13 @@ Description:
>  		The STM32 ADC can be configured to use external trigger sources
>  		(e.g. timers, pwm or exti gpio). Then, it can be tuned to start
>  		conversions on external trigger by either:
> +
>  		- "rising-edge"
>  		- "falling-edge"
>  		- "both-edges".
> +
>  		Reading returns current trigger polarity.
> +
>  		Writing value before enabling conversions sets trigger polarity.
>  
>  What:		/sys/bus/iio/devices/triggerX/trigger_polarity_available
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
> index a133fd8d081a..40df5c9fef99 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
> @@ -15,8 +15,11 @@ Description:
>  		first object echoed in meters. Default value is 6.020.
>  		This setting limits the time the driver is waiting for a
>  		echo.
> +
>  		Showing the range of available values is represented as the
>  		minimum value, the step and the maximum value, all enclosed
>  		in square brackets.
> -		Example:
> -		[0.043 0.043 11.008]
> +
> +		Example::
> +
> +			[0.043 0.043 11.008]
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
> index a91aeabe7b24..d065cda7dd96 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
> @@ -8,7 +8,9 @@ KernelVersion:	3.4.0
>  Contact:	linux-iio@vger.kernel.org
>  Description:
>  		Reading returns either '1' or '0'.
> +
>  		'1' means that the clock in question is present.
> +
>  		'0' means that the clock is missing.
>  
>  What:		/sys/bus/iio/devices/iio:deviceX/pllY_locked
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> index 302de64cb424..544548ee794c 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> @@ -27,12 +27,12 @@ What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_name
>  KernelVersion:
>  Contact:	linux-iio@vger.kernel.org
>  Description:
> -		Reading returns the datasheet name for channel Y:
> +		Reading returns the datasheet name for channel Y::
>  
> -		out_altvoltage0_name: RF8x
> -		out_altvoltage1_name: RFAUX8x
> -		out_altvoltage2_name: RF16x
> -		out_altvoltage3_name: RF32x
> +		  out_altvoltage0_name: RF8x
> +		  out_altvoltage1_name: RFAUX8x
> +		  out_altvoltage2_name: RF16x
> +		  out_altvoltage3_name: RF32x
>  
>  What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
>  KernelVersion:
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x b/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
> index 6adba9058b22..66b621f10223 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
> @@ -6,10 +6,14 @@ Description:
>  		Get measured values from the ADC for these stages. Y is the
>  		specific stage number corresponding to datasheet stage names
>  		as follows:
> -		1 -> LED2
> -		2 -> ALED2/LED3
> -		3 -> LED1
> -		4 -> ALED1/LED4
> +
> +		== ==========
> +		1  LED2
> +		2  ALED2/LED3
> +		3  LED1
> +		4  ALED1/LED4
> +		== ==========
> +
>  		Note that channels 5 and 6 represent LED2-ALED2 and LED1-ALED1
>  		respectively which simply helper channels containing the
>  		calculated difference in the value of stage 1 - 2 and 3 - 4.
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018 b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> index f0ce0a0476ea..220206a20d98 100644
> --- a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> @@ -15,5 +15,7 @@ Description:
>  		Scheme 0 has wider dynamic range, Scheme 1 proximity detection
>  		is less affected by the ambient IR noise variation.
>  
> -		0 Sensing IR from LED and ambient
> -		1 Sensing IR from LED with ambient IR rejection
> +		== =============================================
> +		0  Sensing IR from LED and ambient
> +		1  Sensing IR from LED with ambient IR rejection
> +		== =============================================
> diff --git a/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth b/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth
> index 22d0843849a8..b7b2278fe042 100644
> --- a/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth
> +++ b/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth
> @@ -10,10 +10,13 @@ Date:		June 2015
>  KernelVersion:	4.3
>  Contact:	Alexander Shishkin <alexander.shishkin@linux.intel.com>
>  Description:	(RO) Output port type:
> -		  0: not present,
> -		  1: MSU (Memory Storage Unit)
> -		  2: CTP (Common Trace Port)
> -		  4: PTI (MIPI PTI).
> +
> +		 ==  =========================
> +		  0  not present,
> +		  1  MSU (Memory Storage Unit)
> +		  2  CTP (Common Trace Port)
> +		  4  PTI (MIPI PTI).
> +		 ==  =========================
>  
>  What:		/sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_drop
>  Date:		June 2015
> diff --git a/Documentation/ABI/testing/sysfs-bus-papr-pmem b/Documentation/ABI/testing/sysfs-bus-papr-pmem
> index c1a67275c43f..8316c33862a0 100644
> --- a/Documentation/ABI/testing/sysfs-bus-papr-pmem
> +++ b/Documentation/ABI/testing/sysfs-bus-papr-pmem
> @@ -11,19 +11,26 @@ Description:
>  		at 'Documentation/powerpc/papr_hcalls.rst' . Below are
>  		the flags reported in this sysfs file:
>  
> -		* "not_armed"	: Indicates that NVDIMM contents will not
> +		* "not_armed"
> +				  Indicates that NVDIMM contents will not
>  				  survive a power cycle.
> -		* "flush_fail"	: Indicates that NVDIMM contents
> +		* "flush_fail"
> +				  Indicates that NVDIMM contents
>  				  couldn't be flushed during last
>  				  shut-down event.
> -		* "restore_fail": Indicates that NVDIMM contents
> +		* "restore_fail"
> +				  Indicates that NVDIMM contents
>  				  couldn't be restored during NVDIMM
>  				  initialization.
> -		* "encrypted"	: NVDIMM contents are encrypted.
> -		* "smart_notify": There is health event for the NVDIMM.
> -		* "scrubbed"	: Indicating that contents of the
> +		* "encrypted"
> +				  NVDIMM contents are encrypted.
> +		* "smart_notify"
> +				  There is health event for the NVDIMM.
> +		* "scrubbed"
> +				  Indicating that contents of the
>  				  NVDIMM have been scrubbed.
> -		* "locked"	: Indicating that NVDIMM contents cant
> +		* "locked"
> +				  Indicating that NVDIMM contents cant
>  				  be modified until next power cycle.
>  
>  What:		/sys/bus/nd/devices/nmemX/papr/perf_stats
> @@ -51,4 +58,4 @@ Description:
>  		* "MedWDur " : Media Write Duration
>  		* "CchRHCnt" : Cache Read Hit Count
>  		* "CchWHCnt" : Cache Write Hit Count
> -		* "FastWCnt" : Fast Write Count
> \ No newline at end of file
> +		* "FastWCnt" : Fast Write Count
> diff --git a/Documentation/ABI/testing/sysfs-bus-pci b/Documentation/ABI/testing/sysfs-bus-pci
> index 450296cc7948..77ad9ec3c801 100644
> --- a/Documentation/ABI/testing/sysfs-bus-pci
> +++ b/Documentation/ABI/testing/sysfs-bus-pci
> @@ -7,8 +7,10 @@ Description:
>  		this location.	This is useful for overriding default
>  		bindings.  The format for the location is: DDDD:BB:DD.F.
>  		That is Domain:Bus:Device.Function and is the same as
> -		found in /sys/bus/pci/devices/.  For example:
> -		# echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind
> +		found in /sys/bus/pci/devices/.  For example::
> +
> +		  # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind
> +
>  		(Note: kernels before 2.6.28 may require echo -n).
>  
>  What:		/sys/bus/pci/drivers/.../unbind
> @@ -20,8 +22,10 @@ Description:
>  		this location.	This may be useful when overriding default
>  		bindings.  The format for the location is: DDDD:BB:DD.F.
>  		That is Domain:Bus:Device.Function and is the same as
> -		found in /sys/bus/pci/devices/. For example:
> -		# echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind
> +		found in /sys/bus/pci/devices/. For example::
> +
> +		  # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind
> +
>  		(Note: kernels before 2.6.28 may require echo -n).
>  
>  What:		/sys/bus/pci/drivers/.../new_id
> @@ -38,8 +42,9 @@ Description:
>  		Class, Class Mask, and Private Driver Data.  The Vendor ID
>  		and Device ID fields are required, the rest are optional.
>  		Upon successfully adding an ID, the driver will probe
> -		for the device and attempt to bind to it.  For example:
> -		# echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id
> +		for the device and attempt to bind to it.  For example::
> +
> +		  # echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id
>  
>  What:		/sys/bus/pci/drivers/.../remove_id
>  Date:		February 2009
> @@ -54,8 +59,9 @@ Description:
>  		required, the rest are optional.  After successfully
>  		removing an ID, the driver will no longer support the
>  		device.  This is useful to ensure auto probing won't
> -		match the driver to the device.  For example:
> -		# echo "8086 10f5" > /sys/bus/pci/drivers/foo/remove_id
> +		match the driver to the device.  For example::
> +
> +		  # echo "8086 10f5" > /sys/bus/pci/drivers/foo/remove_id
>  
>  What:		/sys/bus/pci/rescan
>  Date:		January 2009
> diff --git a/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt b/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt
> index 8a200f4eefbd..f85db86d63e8 100644
> --- a/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt
> +++ b/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt
> @@ -4,6 +4,7 @@ Contact:	Cezary Rojewski <cezary.rojewski@intel.com>
>  Description:
>  		Version of AudioDSP firmware ASoC catpt driver is
>  		communicating with.
> +
>  		Format: %d.%d.%d.%d, type:major:minor:build.
>  
>  What:		/sys/devices/pci0000:00/<dev>/fw_info
> diff --git a/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd b/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd
> index 60c60fa624b2..c90d97a80855 100644
> --- a/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd
> +++ b/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd
> @@ -21,11 +21,11 @@ Description:
>  		number returns the port to normal operation.
>  
>  		For example: To force the high-speed device attached to
> -		port 4 on bus 2 to run at full speed:
> +		port 4 on bus 2 to run at full speed::
>  
>  			echo 4 >/sys/bus/usb/devices/usb2/../companion
>  
> -		To return the port to high-speed operation:
> +		To return the port to high-speed operation::
>  
>  			echo -4 >/sys/bus/usb/devices/usb2/../companion
>  
> diff --git a/Documentation/ABI/testing/sysfs-bus-rbd b/Documentation/ABI/testing/sysfs-bus-rbd
> index cc30bee8b5f4..417a2fe21be1 100644
> --- a/Documentation/ABI/testing/sysfs-bus-rbd
> +++ b/Documentation/ABI/testing/sysfs-bus-rbd
> @@ -7,6 +7,8 @@ Description:
>  
>  		Usage: <mon ip addr> <options> <pool name> <rbd image name> [<snap name>]
>  
> +		Example::
> +
>  		 $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add
>  
>  		The snapshot name can be "-" or omitted to map the image
> @@ -23,6 +25,8 @@ Description:
>  
>  		Usage: <dev-id> [force]
>  
> +		Example::
> +
>  		 $ echo 2 > /sys/bus/rbd/remove
>  
>  		Optional "force" argument which when passed will wait for
> @@ -80,26 +84,29 @@ Date:		Oct, 2010
>  KernelVersion:	v2.6.37
>  Contact:	Sage Weil <sage@newdream.net>
>  Description:
> -		size:		(RO) The size (in bytes) of the mapped block
> +
> +		==============	================================================
> +		size		(RO) The size (in bytes) of the mapped block
>  				device.
>  
> -		major:		(RO) The block device major number.
> +		major		(RO) The block device major number.
>  
> -		client_id:	(RO) The ceph unique client id that was assigned
> +		client_id	(RO) The ceph unique client id that was assigned
>  				for this specific session.
>  
> -		pool:		(RO) The name of the storage pool where this rbd
> +		pool		(RO) The name of the storage pool where this rbd
>  				image resides. An rbd image name is unique
>  				within its pool.
>  
> -		name:		(RO) The name of the rbd image.
> +		name		(RO) The name of the rbd image.
>  
> -		refresh:	(WO) Writing to this file will reread the image
> +		refresh		(WO) Writing to this file will reread the image
>  				header data and set all relevant data structures
>  				accordingly.
>  
> -		current_snap:	(RO) The current snapshot for which the device
> +		current_snap	(RO) The current snapshot for which the device
>  				is mapped.
> +		==============	================================================
>  
>  
>  What:		/sys/bus/rbd/devices/<dev-id>/pool_id
> @@ -117,11 +124,13 @@ Date:		Oct, 2012
>  KernelVersion:	v3.7
>  Contact:	Sage Weil <sage@newdream.net>
>  Description:
> -		image_id:	(RO) The unique id for the rbd image. (For rbd
> +		=========	===============================================
> +		image_id	(RO) The unique id for the rbd image. (For rbd
>  				image format 1 this is empty.)
>  
> -		features:	(RO) A hexadecimal encoding of the feature bits
> +		features	(RO) A hexadecimal encoding of the feature bits
>  				for this image.
> +		=========	===============================================
>  
>  
>  What:		/sys/bus/rbd/devices/<dev-id>/parent
> @@ -149,14 +158,16 @@ Date:		Aug, 2016
>  KernelVersion:	v4.9
>  Contact:	Sage Weil <sage@newdream.net>
>  Description:
> -		snap_id:	(RO) The current snapshot's id.
> +		============	================================================
> +		snap_id		(RO) The current snapshot's id.
>  
> -		config_info:	(RO) The string written into
> +		config_info	(RO) The string written into
>  				/sys/bus/rbd/add{,_single_major}.
>  
> -		cluster_fsid:	(RO) The ceph cluster UUID.
> +		cluster_fsid	(RO) The ceph cluster UUID.
>  
> -		client_addr:	(RO) The ceph unique client
> +		client_addr	(RO) The ceph unique client
>  				entity_addr_t (address + nonce). The format is
>  				<address>:<port>/<nonce>: '1.2.3.4:1234/5678' or
>  				'[1:2:3:4:5:6:7:8]:1234/5678'.
> +		============	================================================
> diff --git a/Documentation/ABI/testing/sysfs-bus-siox b/Documentation/ABI/testing/sysfs-bus-siox
> index c2a403f20b90..50e80238f30d 100644
> --- a/Documentation/ABI/testing/sysfs-bus-siox
> +++ b/Documentation/ABI/testing/sysfs-bus-siox
> @@ -8,6 +8,7 @@ Description:
>  		When the file contains a "1" the bus is operated and periodically
>  		does a push-pull cycle to write and read data from the
>  		connected devices.
> +
>  		When writing a "0" or "1" the bus moves to the described state.
>  
>  What:		/sys/bus/siox/devices/siox-X/device_add
> @@ -21,8 +22,10 @@ Description:
>  		to add a new device dynamically. <type> is the name that is used to match
>  		to a driver (similar to the platform bus). <inbytes> and <outbytes> define
>  		the length of the input and output shift register in bytes respectively.
> +
>  		<statustype> defines the 4 bit device type that is check to identify connection
>  		problems.
> +
>  		The new device is added to the end of the existing chain.
>  
>  What:		/sys/bus/siox/devices/siox-X/device_remove
> diff --git a/Documentation/ABI/testing/sysfs-bus-thunderbolt b/Documentation/ABI/testing/sysfs-bus-thunderbolt
> index 171127294674..0b4ab9e4b8f4 100644
> --- a/Documentation/ABI/testing/sysfs-bus-thunderbolt
> +++ b/Documentation/ABI/testing/sysfs-bus-thunderbolt
> @@ -193,10 +193,11 @@ Description:	When new NVM image is written to the non-active NVM
>  		verification fails an error code is returned instead.
>  
>  		This file will accept writing values "1" or "2"
> +
>  		- Writing "1" will flush the image to the storage
> -		area and authenticate the image in one action.
> +		  area and authenticate the image in one action.
>  		- Writing "2" will run some basic validation on the image
> -		and flush it to the storage area.
> +		  and flush it to the storage area.
>  
>  		When read holds status of the last authentication
>  		operation if an error occurred during the process. This
> @@ -213,9 +214,11 @@ Description:	This contains name of the property directory the XDomain
>  		question. Following directories are already reserved by
>  		the Apple XDomain specification:
>  
> -		network:  IP/ethernet over Thunderbolt
> -		targetdm: Target disk mode protocol over Thunderbolt
> -		extdisp:  External display mode protocol over Thunderbolt
> +		========  ===============================================
> +		network   IP/ethernet over Thunderbolt
> +		targetdm  Target disk mode protocol over Thunderbolt
> +		extdisp   External display mode protocol over Thunderbolt
> +		========  ===============================================
>  
>  What:		/sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias
>  Date:		Jan 2018
> @@ -293,7 +296,8 @@ Description:	For supported devices, automatically authenticate the new Thunderbo
>  		image when the device is disconnected from the host system.
>  
>  		This file will accept writing values "1" or "2"
> +
>  		- Writing "1" will flush the image to the storage
> -		area and prepare the device for authentication on disconnect.
> +		  area and prepare the device for authentication on disconnect.
>  		- Writing "2" will run some basic validation on the image
> -		and flush it to the storage area.
> +		  and flush it to the storage area.
> diff --git a/Documentation/ABI/testing/sysfs-bus-usb b/Documentation/ABI/testing/sysfs-bus-usb
> index e449b8374f6a..bf2c1968525f 100644
> --- a/Documentation/ABI/testing/sysfs-bus-usb
> +++ b/Documentation/ABI/testing/sysfs-bus-usb
> @@ -9,6 +9,7 @@ Description:
>  		by writing INTERFACE to /sys/bus/usb/drivers_probe
>  		This allows to avoid side-effects with drivers
>  		that need multiple interfaces.
> +
>  		A deauthorized interface cannot be probed or claimed.
>  
>  What:		/sys/bus/usb/devices/usbX/interface_authorized_default
> @@ -216,6 +217,7 @@ Description:
>  		 - Bit 0 of this field selects the "old" enumeration scheme,
>  		   as it is considerably faster (it only causes one USB reset
>  		   instead of 2).
> +
>  		   The old enumeration scheme can also be selected globally
>  		   using /sys/module/usbcore/parameters/old_scheme_first, but
>  		   it is often not desirable as the new scheme was introduced to
> diff --git a/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533 b/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533
> index c0e0a9ae7b3d..8251e78abc49 100644
> --- a/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533
> +++ b/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533
> @@ -6,8 +6,10 @@ Description:
>  		Get the ALS output channel used as input in
>  		ALS-current-control mode (0, 1), where:
>  
> -		0 - out_current0 (backlight 0)
> -		1 - out_current1 (backlight 1)
> +		==  ==========================
> +		0   out_current0 (backlight 0)
> +		1   out_current1 (backlight 1)
> +		==  ==========================
>  
>  What:		/sys/class/backlight/<backlight>/als_en
>  Date:		May 2012
> @@ -30,8 +32,10 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>  Description:
>  		Set the brightness-mapping mode (0, 1), where:
>  
> -		0 - exponential mode
> -		1 - linear mode
> +		==  ================
> +		0   exponential mode
> +		1   linear mode
> +		==  ================
>  
>  What:		/sys/class/backlight/<backlight>/pwm
>  Date:		April 2012
> @@ -40,9 +44,11 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>  Description:
>  		Set the PWM-input control mask (5 bits), where:
>  
> -		bit 5 - PWM-input enabled in Zone 4
> -		bit 4 - PWM-input enabled in Zone 3
> -		bit 3 - PWM-input enabled in Zone 2
> -		bit 2 - PWM-input enabled in Zone 1
> -		bit 1 - PWM-input enabled in Zone 0
> -		bit 0 - PWM-input enabled
> +		=====   ===========================
> +		bit 5   PWM-input enabled in Zone 4
> +		bit 4   PWM-input enabled in Zone 3
> +		bit 3   PWM-input enabled in Zone 2
> +		bit 2   PWM-input enabled in Zone 1
> +		bit 1   PWM-input enabled in Zone 0
> +		bit 0   PWM-input enabled
> +		=====   ===========================
> diff --git a/Documentation/ABI/testing/sysfs-class-bdi b/Documentation/ABI/testing/sysfs-class-bdi
> index d773d5697cf5..5402bd74ba43 100644
> --- a/Documentation/ABI/testing/sysfs-class-bdi
> +++ b/Documentation/ABI/testing/sysfs-class-bdi
> @@ -24,7 +24,6 @@ default
>  	filesystems which do not provide their own BDI.
>  
>  Files under /sys/class/bdi/<bdi>/
> ----------------------------------
>  
>  read_ahead_kb (read-write)
>  
> diff --git a/Documentation/ABI/testing/sysfs-class-chromeos b/Documentation/ABI/testing/sysfs-class-chromeos
> index 5819699d66ec..74ece942722e 100644
> --- a/Documentation/ABI/testing/sysfs-class-chromeos
> +++ b/Documentation/ABI/testing/sysfs-class-chromeos
> @@ -17,13 +17,14 @@ Date:		August 2015
>  KernelVersion:	4.2
>  Description:
>  		Tell the EC to reboot in various ways. Options are:
> -		"cancel": Cancel a pending reboot.
> -		"ro": Jump to RO without rebooting.
> -		"rw": Jump to RW without rebooting.
> -		"cold": Cold reboot.
> -		"disable-jump": Disable jump until next reboot.
> -		"hibernate": Hibernate the EC.
> -		"at-shutdown": Reboot after an AP shutdown.
> +
> +		- "cancel": Cancel a pending reboot.
> +		- "ro": Jump to RO without rebooting.
> +		- "rw": Jump to RW without rebooting.
> +		- "cold": Cold reboot.
> +		- "disable-jump": Disable jump until next reboot.
> +		- "hibernate": Hibernate the EC.
> +		- "at-shutdown": Reboot after an AP shutdown.
>  
>  What:		/sys/class/chromeos/<ec-device-name>/version
>  Date:		August 2015
> diff --git a/Documentation/ABI/testing/sysfs-class-cxl b/Documentation/ABI/testing/sysfs-class-cxl
> index a6f51a104c44..818f55970efb 100644
> --- a/Documentation/ABI/testing/sysfs-class-cxl
> +++ b/Documentation/ABI/testing/sysfs-class-cxl
> @@ -217,6 +217,7 @@ Description:    read/write
>                  card.  A power cycle is required to load the image.
>                  "none" could be useful for debugging because the trace arrays
>                  are preserved.
> +
>                  "user" and "factory" means PERST will cause either the user or
>                  user or factory image to be loaded.
>                  Default is to reload on PERST whichever image the card has
> @@ -240,8 +241,11 @@ Contact:	linuxppc-dev@lists.ozlabs.org
>  Description:	read/write
>  		Trust that when an image is reloaded via PERST, it will not
>  		have changed.
> -		0 = don't trust, the image may be different (default)
> -		1 = trust that the image will not change.
> +
> +		==  =================================================
> +		0   don't trust, the image may be different (default)
> +		1   trust that the image will not change.
> +		==  =================================================
>  Users:		https://github.com/ibm-capi/libcxl
>  
>  What:           /sys/class/cxl/<card>/psl_timebase_synced
> diff --git a/Documentation/ABI/testing/sysfs-class-devlink b/Documentation/ABI/testing/sysfs-class-devlink
> index 64791b65c9a3..b662f747c83e 100644
> --- a/Documentation/ABI/testing/sysfs-class-devlink
> +++ b/Documentation/ABI/testing/sysfs-class-devlink
> @@ -18,9 +18,9 @@ Description:
>  
>  		This will be one of the following strings:
>  
> -		'consumer unbind'
> -		'supplier unbind'
> -		'never'
> +		- 'consumer unbind'
> +		- 'supplier unbind'
> +		- 'never'
>  
>  		'consumer unbind' means the device link will be removed when
>  		the consumer's driver is unbound from the consumer device.
> @@ -49,8 +49,10 @@ Description:
>  
>  		This will be one of the following strings:
>  
> -		'0' - Does not affect runtime power management
> -		'1' - Affects runtime power management
> +		===   ========================================
> +		'0'   Does not affect runtime power management
> +		'1'   Affects runtime power management
> +		===   ========================================
>  
>  What:		/sys/class/devlink/.../status
>  Date:		May 2020
> @@ -68,13 +70,13 @@ Description:
>  
>  		This will be one of the following strings:
>  
> -		'not tracked'
> -		'dormant'
> -		'available'
> -		'consumer probing'
> -		'active'
> -		'supplier unbinding'
> -		'unknown'
> +		- 'not tracked'
> +		- 'dormant'
> +		- 'available'
> +		- 'consumer probing'
> +		- 'active'
> +		- 'supplier unbinding'
> +		- 'unknown'
>  
>  		'not tracked' means this device link does not track the status
>  		and has no impact on the binding, unbinding and syncing the
> @@ -114,8 +116,10 @@ Description:
>  
>  		This will be one of the following strings:
>  
> +		===  ================================
>  		'0'
> -		'1' - Affects runtime power management
> +		'1'  Affects runtime power management
> +		===  ================================
>  
>  		'0' means the device link can affect other device behaviors
>  		like binding/unbinding, suspend/resume, runtime power
> diff --git a/Documentation/ABI/testing/sysfs-class-extcon b/Documentation/ABI/testing/sysfs-class-extcon
> index 57a726232912..fde0fecd5de9 100644
> --- a/Documentation/ABI/testing/sysfs-class-extcon
> +++ b/Documentation/ABI/testing/sysfs-class-extcon
> @@ -39,19 +39,22 @@ Description:
>  		callback.
>  
>  		If the default callback for showing function is used, the
> -		format is like this:
> -		# cat state
> -		USB_OTG=1
> -		HDMI=0
> -		TA=1
> -		EAR_JACK=0
> -		#
> +		format is like this::
> +
> +		    # cat state
> +		    USB_OTG=1
> +		    HDMI=0
> +		    TA=1
> +		    EAR_JACK=0
> +		    #
> +
>  		In this example, the extcon device has USB_OTG and TA
>  		cables attached and HDMI and EAR_JACK cables detached.
>  
>  		In order to update the state of an extcon device, enter a hex
> -		state number starting with 0x:
> -		# echo 0xHEX > state
> +		state number starting with 0x::
> +
> +		    # echo 0xHEX > state
>  
>  		This updates the whole state of the extcon device.
>  		Inputs of all the methods are required to meet the
> @@ -84,12 +87,13 @@ Contact:	MyungJoo Ham <myungjoo.ham@samsung.com>
>  Description:
>  		Shows the relations of mutually exclusiveness. For example,
>  		if the mutually_exclusive array of extcon device is
> -		{0x3, 0x5, 0xC, 0x0}, then the output is:
> -		# ls mutually_exclusive/
> -		0x3
> -		0x5
> -		0xc
> -		#
> +		{0x3, 0x5, 0xC, 0x0}, then the output is::
> +
> +		    # ls mutually_exclusive/
> +		    0x3
> +		    0x5
> +		    0xc
> +		    #
>  
>  		Note that mutually_exclusive is a sub-directory of the extcon
>  		device and the file names under the mutually_exclusive
> diff --git a/Documentation/ABI/testing/sysfs-class-fpga-manager b/Documentation/ABI/testing/sysfs-class-fpga-manager
> index 5284fa33d4c5..d78689c357a5 100644
> --- a/Documentation/ABI/testing/sysfs-class-fpga-manager
> +++ b/Documentation/ABI/testing/sysfs-class-fpga-manager
> @@ -28,8 +28,7 @@ Description:	Read fpga manager state as a string.
>  		* firmware request	= firmware class request in progress
>  		* firmware request error = firmware request failed
>  		* write init		= preparing FPGA for programming
> -		* write init error	= Error while preparing FPGA for
> -					  programming
> +		* write init error	= Error while preparing FPGA for programming
>  		* write			= FPGA ready to receive image data
>  		* write error		= Error while programming
>  		* write complete	= Doing post programming steps
> @@ -47,7 +46,7 @@ Description:	Read fpga manager status as a string.
>  		programming errors to userspace. This is a list of strings for
>  		the supported status.
>  
> -		* reconfig operation error 	- invalid operations detected by
> +		* reconfig operation error	- invalid operations detected by
>  						  reconfiguration hardware.
>  						  e.g. start reconfiguration
>  						  with errors not cleared
> diff --git a/Documentation/ABI/testing/sysfs-class-gnss b/Documentation/ABI/testing/sysfs-class-gnss
> index 2467b6900eae..c8553d972edd 100644
> --- a/Documentation/ABI/testing/sysfs-class-gnss
> +++ b/Documentation/ABI/testing/sysfs-class-gnss
> @@ -6,9 +6,11 @@ Description:
>  		The GNSS receiver type. The currently identified types reflect
>  		the protocol(s) supported by the receiver:
>  
> +			======		===========
>  			"NMEA"		NMEA 0183
>  			"SiRF"		SiRF Binary
>  			"UBX"		UBX
> +			======		===========
>  
>  		Note that also non-"NMEA" type receivers typically support a
>  		subset of NMEA 0183 with vendor extensions (e.g. to allow
> diff --git a/Documentation/ABI/testing/sysfs-class-led b/Documentation/ABI/testing/sysfs-class-led
> index 65e040978f73..0ed5c2629c6f 100644
> --- a/Documentation/ABI/testing/sysfs-class-led
> +++ b/Documentation/ABI/testing/sysfs-class-led
> @@ -47,6 +47,7 @@ Contact:	Richard Purdie <rpurdie@rpsys.net>
>  Description:
>  		Set the trigger for this LED. A trigger is a kernel based source
>  		of LED events.
> +
>  		You can change triggers in a similar manner to the way an IO
>  		scheduler is chosen. Trigger specific parameters can appear in
>  		/sys/class/leds/<led> once a given trigger is selected. For
> diff --git a/Documentation/ABI/testing/sysfs-class-led-driver-el15203000 b/Documentation/ABI/testing/sysfs-class-led-driver-el15203000
> index 69befe947d7e..da546e86deb5 100644
> --- a/Documentation/ABI/testing/sysfs-class-led-driver-el15203000
> +++ b/Documentation/ABI/testing/sysfs-class-led-driver-el15203000
> @@ -27,23 +27,23 @@ Description:
>  
>  			^
>  			|
> -		    0 On -|----+                   +----+                   +---
> +		  0 On -|----+                   +----+                   +---
>  			|    |                   |    |                   |
>  		    Off-|    +-------------------+    +-------------------+
>  			|
> -		    1 On -|    +----+                   +----+
> +		  1 On -|    +----+                   +----+
>  			|    |    |                   |    |
>  		    Off |----+    +-------------------+    +------------------
>  			|
> -		    2 On -|         +----+                   +----+
> +		  2 On -|         +----+                   +----+
>  			|         |    |                   |    |
>  		    Off-|---------+    +-------------------+    +-------------
>  			|
> -		    3 On -|              +----+                   +----+
> +		  3 On -|              +----+                   +----+
>  			|              |    |                   |    |
>  		    Off-|--------------+    +-------------------+    +--------
>  			|
> -		    4 On -|                   +----+                   +----+
> +		  4 On -|                   +----+                   +----+
>  			|                   |    |                   |    |
>  		    Off-|-------------------+    +-------------------+    +---
>  			|
> @@ -55,23 +55,23 @@ Description:
>  
>  			^
>  			|
> -		    0 On -|    +-------------------+    +-------------------+
> +		  0 On -|    +-------------------+    +-------------------+
>  			|    |                   |    |                   |
>  		    Off-|----+                   +----+                   +---
>  			|
> -		    1 On -|----+    +-------------------+    +------------------
> +		  1 On -|----+    +-------------------+    +------------------
>  			|    |    |                   |    |
>  		    Off |    +----+                   +----+
>  			|
> -		    2 On -|---------+    +-------------------+    +-------------
> +		  2 On -|---------+    +-------------------+    +-------------
>  			|         |    |                   |    |
>  		    Off-|         +----+                   +----+
>  			|
> -		    3 On -|--------------+    +-------------------+    +--------
> +		  3 On -|--------------+    +-------------------+    +--------
>  			|              |    |                   |    |
>  		    Off-|              +----+                   +----+
>  			|
> -		    4 On -|-------------------+    +-------------------+    +---
> +		  4 On -|-------------------+    +-------------------+    +---
>  			|                   |    |                   |    |
>  		    Off-|                   +----+                   +----+
>  			|
> @@ -83,23 +83,23 @@ Description:
>  
>  			^
>  			|
> -		    0 On -|----+                                       +--------
> +		  0 On -|----+                                       +--------
>  			|    |                                       |
>  		    Off-|    +---------------------------------------+
>  			|
> -		    1 On -|    +----+                             +----+
> +		  1 On -|    +----+                             +----+
>  			|    |    |                             |    |
>  		    Off |----+    +-----------------------------+    +--------
>  			|
> -		    2 On -|         +----+                   +----+
> +		  2 On -|         +----+                   +----+
>  			|         |    |                   |    |
>  		    Off-|---------+    +-------------------+    +-------------
>  			|
> -		    3 On -|              +----+         +----+
> +		  3 On -|              +----+         +----+
>  			|              |    |         |    |
>  		    Off-|--------------+    +---------+    +------------------
>  			|
> -		    4 On -|                   +---------+
> +		  4 On -|                   +---------+
>  			|                   |         |
>  		    Off-|-------------------+         +-----------------------
>  			|
> diff --git a/Documentation/ABI/testing/sysfs-class-led-driver-lm3533 b/Documentation/ABI/testing/sysfs-class-led-driver-lm3533
> index e4c89b261546..e38a835d0a85 100644
> --- a/Documentation/ABI/testing/sysfs-class-led-driver-lm3533
> +++ b/Documentation/ABI/testing/sysfs-class-led-driver-lm3533
> @@ -6,8 +6,10 @@ Description:
>  		Set the ALS output channel to use as input in
>  		ALS-current-control mode (1, 2), where:
>  
> -		1 - out_current1
> -		2 - out_current2
> +		==  ============
> +		1   out_current1
> +		2   out_current2
> +		==  ============
>  
>  What:		/sys/class/leds/<led>/als_en
>  Date:		May 2012
> @@ -24,14 +26,16 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>  Description:
>  		Set the pattern generator fall and rise times (0..7), where:
>  
> -		0 - 2048 us
> -		1 - 262 ms
> -		2 - 524 ms
> -		3 - 1.049 s
> -		4 - 2.097 s
> -		5 - 4.194 s
> -		6 - 8.389 s
> -		7 - 16.78 s
> +		==  =======
> +		0   2048 us
> +		1   262 ms
> +		2   524 ms
> +		3   1.049 s
> +		4   2.097 s
> +		5   4.194 s
> +		6   8.389 s
> +		7   16.78 s
> +		==  =======
>  
>  What:		/sys/class/leds/<led>/id
>  Date:		April 2012
> @@ -47,8 +51,10 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>  Description:
>  		Set the brightness-mapping mode (0, 1), where:
>  
> -		0 - exponential mode
> -		1 - linear mode
> +		==  ================
> +		0   exponential mode
> +		1   linear mode
> +		==  ================
>  
>  What:		/sys/class/leds/<led>/pwm
>  Date:		April 2012
> @@ -57,9 +63,11 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>  Description:
>  		Set the PWM-input control mask (5 bits), where:
>  
> -		bit 5 - PWM-input enabled in Zone 4
> -		bit 4 - PWM-input enabled in Zone 3
> -		bit 3 - PWM-input enabled in Zone 2
> -		bit 2 - PWM-input enabled in Zone 1
> -		bit 1 - PWM-input enabled in Zone 0
> -		bit 0 - PWM-input enabled
> +		=====  ===========================
> +		bit 5  PWM-input enabled in Zone 4
> +		bit 4  PWM-input enabled in Zone 3
> +		bit 3  PWM-input enabled in Zone 2
> +		bit 2  PWM-input enabled in Zone 1
> +		bit 1  PWM-input enabled in Zone 0
> +		bit 0  PWM-input enabled
> +		=====  ===========================
> diff --git a/Documentation/ABI/testing/sysfs-class-led-flash b/Documentation/ABI/testing/sysfs-class-led-flash
> index 220a0270b47b..11e5677c3672 100644
> --- a/Documentation/ABI/testing/sysfs-class-led-flash
> +++ b/Documentation/ABI/testing/sysfs-class-led-flash
> @@ -55,26 +55,35 @@ Description:	read only
>  		Flash faults are re-read after strobing the flash. Possible
>  		flash faults:
>  
> -		* led-over-voltage - flash controller voltage to the flash LED
> +		* led-over-voltage
> +			flash controller voltage to the flash LED
>  			has exceeded the limit specific to the flash controller
> -		* flash-timeout-exceeded - the flash strobe was still on when
> +		* flash-timeout-exceeded
> +			the flash strobe was still on when
>  			the timeout set by the user has expired; not all flash
>  			controllers may set this in all such conditions
> -		* controller-over-temperature - the flash controller has
> +		* controller-over-temperature
> +			the flash controller has
>  			overheated
> -		* controller-short-circuit - the short circuit protection
> +		* controller-short-circuit
> +			the short circuit protection
>  			of the flash controller has been triggered
> -		* led-power-supply-over-current - current in the LED power
> +		* led-power-supply-over-current
> +			current in the LED power
>  			supply has exceeded the limit specific to the flash
>  			controller
> -		* indicator-led-fault - the flash controller has detected
> +		* indicator-led-fault
> +			the flash controller has detected
>  			a short or open circuit condition on the indicator LED
> -		* led-under-voltage - flash controller voltage to the flash
> +		* led-under-voltage
> +			flash controller voltage to the flash
>  			LED has been below the minimum limit specific to
>  			the flash
> -		* controller-under-voltage - the input voltage of the flash
> +		* controller-under-voltage
> +			the input voltage of the flash
>  			controller is below the limit under which strobing the
>  			flash at full current will not be possible;
>  			the condition persists until this flag is no longer set
> -		* led-over-temperature - the temperature of the LED has exceeded
> +		* led-over-temperature
> +			the temperature of the LED has exceeded
>  			its allowed upper limit
> diff --git a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
> index 451af6d6768c..646540950e38 100644
> --- a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
> +++ b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
> @@ -19,18 +19,23 @@ KernelVersion:	4.16
>  Contact:	linux-leds@vger.kernel.org
>  Description:
>  		Signal the link state of the named network device.
> +
>  		If set to 0 (default), the LED's normal state is off.
> +
>  		If set to 1, the LED's normal state reflects the link state
>  		of the named network device.
>  		Setting this value also immediately changes the LED state.
>  
> +
>  What:		/sys/class/leds/<led>/tx
>  Date:		Dec 2017
>  KernelVersion:	4.16
>  Contact:	linux-leds@vger.kernel.org
>  Description:
>  		Signal transmission of data on the named network device.
> +
>  		If set to 0 (default), the LED will not blink on transmission.
> +
>  		If set to 1, the LED will blink for the milliseconds specified
>  		in interval to signal transmission.
>  
> @@ -40,6 +45,8 @@ KernelVersion:	4.16
>  Contact:	linux-leds@vger.kernel.org
>  Description:
>  		Signal reception of data on the named network device.
> +
>  		If set to 0 (default), the LED will not blink on reception.
> +
>  		If set to 1, the LED will blink for the milliseconds specified
>  		in interval to signal reception.
> diff --git a/Documentation/ABI/testing/sysfs-class-led-trigger-usbport b/Documentation/ABI/testing/sysfs-class-led-trigger-usbport
> index f440e690daef..eb81152b8348 100644
> --- a/Documentation/ABI/testing/sysfs-class-led-trigger-usbport
> +++ b/Documentation/ABI/testing/sysfs-class-led-trigger-usbport
> @@ -8,5 +8,6 @@ Description:
>  		selected for the USB port trigger. Selecting ports makes trigger
>  		observing them for any connected devices and lighting on LED if
>  		there are any.
> +
>  		Echoing "1" value selects USB port. Echoing "0" unselects it.
>  		Current state can be also read.
> diff --git a/Documentation/ABI/testing/sysfs-class-leds-gt683r b/Documentation/ABI/testing/sysfs-class-leds-gt683r
> index 6adab27f646e..b57ffb26e722 100644
> --- a/Documentation/ABI/testing/sysfs-class-leds-gt683r
> +++ b/Documentation/ABI/testing/sysfs-class-leds-gt683r
> @@ -7,9 +7,11 @@ Description:
>  		of one LED will update the mode of its two sibling devices as
>  		well. Possible values are:
>  
> -		0 - normal
> -		1 - audio
> -		2 - breathing
> +		==  =========
> +		0   normal
> +		1   audio
> +		2   breathing
> +		==  =========
>  
>  		Normal: LEDs are fully on when enabled
>  		Audio:  LEDs brightness depends on sound level
> diff --git a/Documentation/ABI/testing/sysfs-class-net b/Documentation/ABI/testing/sysfs-class-net
> index 3b404577f380..7670012ae9b6 100644
> --- a/Documentation/ABI/testing/sysfs-class-net
> +++ b/Documentation/ABI/testing/sysfs-class-net
> @@ -4,10 +4,13 @@ KernelVersion:	3.17
>  Contact:	netdev@vger.kernel.org
>  Description:
>  		Indicates the name assignment type. Possible values are:
> -		1: enumerated by the kernel, possibly in an unpredictable way
> -		2: predictably named by the kernel
> -		3: named by userspace
> -		4: renamed
> +
> +		== ==========================================================
> +		1  enumerated by the kernel, possibly in an unpredictable way
> +		2  predictably named by the kernel
> +		3  named by userspace
> +		4  renamed
> +		== ==========================================================
>  
>  What:		/sys/class/net/<iface>/addr_assign_type
>  Date:		July 2010
> @@ -15,10 +18,13 @@ KernelVersion:	3.2
>  Contact:	netdev@vger.kernel.org
>  Description:
>  		Indicates the address assignment type. Possible values are:
> -		0: permanent address
> -		1: randomly generated
> -		2: stolen from another device
> -		3: set using dev_set_mac_address
> +
> +		== =============================
> +		0  permanent address
> +		1  randomly generated
> +		2  stolen from another device
> +		3  set using dev_set_mac_address
> +		== =============================
>  
>  What:		/sys/class/net/<iface>/addr_len
>  Date:		April 2005
> @@ -51,9 +57,12 @@ Description:
>  		Default value 0 does not forward any link local frames.
>  
>  		Restricted bits:
> -		0: 01-80-C2-00-00-00 Bridge Group Address used for STP
> -		1: 01-80-C2-00-00-01 (MAC Control) 802.3 used for MAC PAUSE
> -		2: 01-80-C2-00-00-02 (Link Aggregation) 802.3ad
> +
> +		== ========================================================
> +		0  01-80-C2-00-00-00 Bridge Group Address used for STP
> +		1  01-80-C2-00-00-01 (MAC Control) 802.3 used for MAC PAUSE
> +		2  01-80-C2-00-00-02 (Link Aggregation) 802.3ad
> +		== ========================================================
>  
>  		Any values not setting these bits can be used. Take special
>  		care when forwarding control frames e.g. 802.1X-PAE or LLDP.
> @@ -74,8 +83,11 @@ Contact:	netdev@vger.kernel.org
>  Description:
>  		Indicates the current physical link state of the interface.
>  		Posssible values are:
> -		0: physical link is down
> -		1: physical link is up
> +
> +		== =====================
> +		0  physical link is down
> +		1  physical link is up
> +		== =====================
>  
>  		Note: some special devices, e.g: bonding and team drivers will
>  		allow this attribute to be written to force a link state for
> @@ -131,8 +143,11 @@ Contact:	netdev@vger.kernel.org
>  Description:
>  		Indicates whether the interface is under test. Possible
>  		values are:
> -		0: interface is not being tested
> -		1: interface is being tested
> +
> +		== =============================
> +		0  interface is not being tested
> +		1  interface is being tested
> +		== =============================
>  
>  		When an interface is under test, it cannot be expected
>  		to pass packets as normal.
> @@ -144,8 +159,11 @@ Contact:	netdev@vger.kernel.org
>  Description:
>  		Indicates the interface latest or current duplex value. Possible
>  		values are:
> -		half: half duplex
> -		full: full duplex
> +
> +		====  ===========
> +		half  half duplex
> +		full  full duplex
> +		====  ===========
>  
>  		Note: This attribute is only valid for interfaces that implement
>  		the ethtool get_link_ksettings method (mostly Ethernet).
> @@ -196,8 +214,11 @@ Description:
>  		Indicates the interface link mode, as a decimal number. This
>  		attribute should be used in conjunction with 'dormant' attribute
>  		to determine the interface usability. Possible values:
> -		0: default link mode
> -		1: dormant link mode
> +
> +		==  =================
> +		0   default link mode
> +		1   dormant link mode
> +		==  =================
>  
>  What:		/sys/class/net/<iface>/mtu
>  Date:		April 2005
> @@ -226,7 +247,9 @@ KernelVersion:	2.6.17
>  Contact:	netdev@vger.kernel.org
>  Description:
>  		Indicates the interface RFC2863 operational state as a string.
> +
>  		Possible values are:
> +
>  		"unknown", "notpresent", "down", "lowerlayerdown", "testing",
>  		"dormant", "up".
>  
> diff --git a/Documentation/ABI/testing/sysfs-class-net-cdc_ncm b/Documentation/ABI/testing/sysfs-class-net-cdc_ncm
> index f7be0e88b139..06416d0e163d 100644
> --- a/Documentation/ABI/testing/sysfs-class-net-cdc_ncm
> +++ b/Documentation/ABI/testing/sysfs-class-net-cdc_ncm
> @@ -91,9 +91,9 @@ Date:		May 2014
>  KernelVersion:	3.16
>  Contact:	Bjørn Mork <bjorn@mork.no>
>  Description:
> -		Bit 0: 16-bit NTB supported (set to 1)
> -		Bit 1: 32-bit NTB supported
> -		Bits 2 – 15: reserved (reset to zero; must be ignored by host)
> +		- Bit 0: 16-bit NTB supported (set to 1)
> +		- Bit 1: 32-bit NTB supported
> +		- Bits 2 – 15: reserved (reset to zero; must be ignored by host)
>  
>  What:		/sys/class/net/<iface>/cdc_ncm/dwNtbInMaxSize
>  Date:		May 2014
> diff --git a/Documentation/ABI/testing/sysfs-class-net-phydev b/Documentation/ABI/testing/sysfs-class-net-phydev
> index 206cbf538b59..40ced0ea4316 100644
> --- a/Documentation/ABI/testing/sysfs-class-net-phydev
> +++ b/Documentation/ABI/testing/sysfs-class-net-phydev
> @@ -35,7 +35,9 @@ Description:
>  		Ethernet driver during bus enumeration, encoded in string.
>  		This interface mode is used to configure the Ethernet MAC with the
>  		appropriate mode for its data lines to the PHY hardware.
> +
>  		Possible values are:
> +
>  		<empty> (not available), mii, gmii, sgmii, tbi, rev-mii,
>  		rmii, rgmii, rgmii-id, rgmii-rxid, rgmii-txid, rtbi, smii
>  		xgmii, moca, qsgmii, trgmii, 1000base-x, 2500base-x, rxaui,
> diff --git a/Documentation/ABI/testing/sysfs-class-pktcdvd b/Documentation/ABI/testing/sysfs-class-pktcdvd
> index dde4f26d0780..ba1ce626591d 100644
> --- a/Documentation/ABI/testing/sysfs-class-pktcdvd
> +++ b/Documentation/ABI/testing/sysfs-class-pktcdvd
> @@ -11,15 +11,17 @@ KernelVersion:	2.6.20
>  Contact:	Thomas Maier <balagi@justmail.de>
>  Description:
>  
> -		add:		(WO) Write a block device id (major:minor) to
> +		==========	==============================================
> +		add		(WO) Write a block device id (major:minor) to
>  				create a new pktcdvd device and map it to the
>  				block device.
>  
> -		remove:		(WO) Write the pktcdvd device id (major:minor)
> +		remove		(WO) Write the pktcdvd device id (major:minor)
>  				to remove the pktcdvd device.
>  
> -		device_map:	(RO) Shows the device mapping in format:
> +		device_map	(RO) Shows the device mapping in format:
>  				pktcdvd[0-7] <pktdevid> <blkdevid>
> +		==========	==============================================
>  
>  
>  What:		/sys/class/pktcdvd/pktcdvd[0-7]/dev
> @@ -65,29 +67,31 @@ Date:		Oct. 2006
>  KernelVersion:	2.6.20
>  Contact:	Thomas Maier <balagi@justmail.de>
>  Description:
> -		size:		(RO) Contains the size of the bio write queue.
> +		==============	================================================
> +		size		(RO) Contains the size of the bio write queue.
>  
> -		congestion_off:	(RW) If bio write queue size is below this mark,
> +		congestion_off	(RW) If bio write queue size is below this mark,
>  				accept new bio requests from the block layer.
>  
> -		congestion_on:	(RW) If bio write queue size is higher as this
> +		congestion_on	(RW) If bio write queue size is higher as this
>  				mark, do no longer accept bio write requests
>  				from the block layer and wait till the pktcdvd
>  				device has processed enough bio's so that bio
>  				write queue size is below congestion off mark.
>  				A value of <= 0 disables congestion control.
> +		==============	================================================
>  
>  
>  Example:
>  --------
> -To use the pktcdvd sysfs interface directly, you can do:
> +To use the pktcdvd sysfs interface directly, you can do::
>  
> -# create a new pktcdvd device mapped to /dev/hdc
> -echo "22:0" >/sys/class/pktcdvd/add
> -cat /sys/class/pktcdvd/device_map
> -# assuming device pktcdvd0 was created, look at stat's
> -cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written
> -# print the device id of the mapped block device
> -fgrep pktcdvd0 /sys/class/pktcdvd/device_map
> -# remove device, using pktcdvd0 device id   253:0
> -echo "253:0" >/sys/class/pktcdvd/remove
> +    # create a new pktcdvd device mapped to /dev/hdc
> +    echo "22:0" >/sys/class/pktcdvd/add
> +    cat /sys/class/pktcdvd/device_map
> +    # assuming device pktcdvd0 was created, look at stat's
> +    cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written
> +    # print the device id of the mapped block device
> +    fgrep pktcdvd0 /sys/class/pktcdvd/device_map
> +    # remove device, using pktcdvd0 device id   253:0
> +    echo "253:0" >/sys/class/pktcdvd/remove
> diff --git a/Documentation/ABI/testing/sysfs-class-power b/Documentation/ABI/testing/sysfs-class-power
> index d4319a04c302..d68ad528a8e5 100644
> --- a/Documentation/ABI/testing/sysfs-class-power
> +++ b/Documentation/ABI/testing/sysfs-class-power
> @@ -43,7 +43,9 @@ Date:		May 2007
>  Contact:	linux-pm@vger.kernel.org
>  Description:
>  		Fine grain representation of battery capacity.
> +
>  		Access: Read
> +
>  		Valid values: 0 - 100 (percent)
>  
>  What:		/sys/class/power_supply/<supply_name>/capacity_alert_max
> @@ -58,6 +60,7 @@ Description:
>  		low).
>  
>  		Access: Read, Write
> +
>  		Valid values: 0 - 100 (percent)
>  
>  What:		/sys/class/power_supply/<supply_name>/capacity_alert_min
> @@ -88,6 +91,7 @@ Description:
>  		completely useless.
>  
>  		Access: Read
> +
>  		Valid values: 0 - 100 (percent)
>  
>  What:		/sys/class/power_supply/<supply_name>/capacity_level
> @@ -111,6 +115,7 @@ Description:
>  		which they average readings to smooth out the reported value.
>  
>  		Access: Read
> +
>  		Valid values: Represented in microamps. Negative values are used
>  		for discharging batteries, positive values for charging batteries.
>  
> @@ -131,6 +136,7 @@ Description:
>  		This value is not averaged/smoothed.
>  
>  		Access: Read
> +
>  		Valid values: Represented in microamps. Negative values are used
>  		for discharging batteries, positive values for charging batteries.
>  
> @@ -383,7 +389,7 @@ Description:
>  
>  **USB Properties**
>  
> -What: 		/sys/class/power_supply/<supply_name>/current_avg
> +What:		/sys/class/power_supply/<supply_name>/current_avg
>  Date:		May 2007
>  Contact:	linux-pm@vger.kernel.org
>  Description:
> @@ -449,6 +455,7 @@ Description:
>  		solved using power limit use input_voltage_limit.
>  
>  		Access: Read, Write
> +
>  		Valid values: Represented in microvolts
>  
>  What:		/sys/class/power_supply/<supply_name>/input_power_limit
> @@ -462,6 +469,7 @@ Description:
>  		limit only for problems that can be solved using power limit.
>  
>  		Access: Read, Write
> +
>  		Valid values: Represented in microwatts
>  
>  What:		/sys/class/power_supply/<supply_name>/online,
> @@ -747,6 +755,7 @@ Description:
>  		manufactured.
>  
>  		Access: Read
> +
>  		Valid values: Reported as integer
>  
>  What:		/sys/class/power_supply/<supply_name>/manufacture_month
> @@ -756,6 +765,7 @@ Description:
>  		Reports the month when the device has been manufactured.
>  
>  		Access: Read
> +
>  		Valid values: 1-12
>  
>  What:		/sys/class/power_supply/<supply_name>/manufacture_day
> diff --git a/Documentation/ABI/testing/sysfs-class-power-mp2629 b/Documentation/ABI/testing/sysfs-class-power-mp2629
> index 327a07e22805..914d67caac0d 100644
> --- a/Documentation/ABI/testing/sysfs-class-power-mp2629
> +++ b/Documentation/ABI/testing/sysfs-class-power-mp2629
> @@ -5,4 +5,5 @@ Description:
>  		Represents a battery impedance compensation to accelerate charging.
>  
>                  Access: Read, Write
> +
>                  Valid values: Represented in milli-ohms. Valid range is [0, 140].
> diff --git a/Documentation/ABI/testing/sysfs-class-power-twl4030 b/Documentation/ABI/testing/sysfs-class-power-twl4030
> index 7ac36dba87bc..b52f7023f8ba 100644
> --- a/Documentation/ABI/testing/sysfs-class-power-twl4030
> +++ b/Documentation/ABI/testing/sysfs-class-power-twl4030
> @@ -6,9 +6,9 @@ Description:
>  	Possible values are:
>  
>  		=============	===========================================
> -		"auto" 		draw power as appropriate for detected
> +		"auto"		draw power as appropriate for detected
>  				power source and battery status.
> -		"off"  		do not draw any power.
> +		"off"		do not draw any power.
>  		"continuous"	activate mode described as "linear" in
>  				TWL data sheets.  This uses whatever
>  				current is available and doesn't switch off
> diff --git a/Documentation/ABI/testing/sysfs-class-rapidio b/Documentation/ABI/testing/sysfs-class-rapidio
> index 8716beeb16c1..19aefb21b639 100644
> --- a/Documentation/ABI/testing/sysfs-class-rapidio
> +++ b/Documentation/ABI/testing/sysfs-class-rapidio
> @@ -6,6 +6,7 @@ Description:
>  		The /sys/class/rapidio_port subdirectory contains individual
>  		subdirectories named as "rapidioN" where N = mport ID registered
>  		with RapidIO subsystem.
> +
>  		NOTE: An mport ID is not a RapidIO destination ID assigned to a
>  		given local mport device.
>  
> @@ -16,7 +17,9 @@ Contact:	Matt Porter <mporter@kernel.crashing.org>,
>  		Alexandre Bounine <alexandre.bounine@idt.com>
>  Description:
>  		(RO) reports RapidIO common transport system size:
> +
>  		0 = small (8-bit destination ID, max. 256 devices),
> +
>  		1 = large (16-bit destination ID, max. 65536 devices).
>  
>  What:		/sys/class/rapidio_port/rapidioN/port_destid
> @@ -25,31 +28,32 @@ KernelVersion:	v3.15
>  Contact:	Matt Porter <mporter@kernel.crashing.org>,
>  		Alexandre Bounine <alexandre.bounine@idt.com>
>  Description:
> -		(RO) reports RapidIO destination ID assigned to the given
> -		RapidIO mport device. If value 0xFFFFFFFF is returned this means
> -		that no valid destination ID have been assigned to the mport
> -		(yet). Normally, before enumeration/discovery have been executed
> -		only fabric enumerating mports have a valid destination ID
> -		assigned to them using "hdid=..." rapidio module parameter.
> +
> +(RO) reports RapidIO destination ID assigned to the given
> +RapidIO mport device. If value 0xFFFFFFFF is returned this means
> +that no valid destination ID have been assigned to the mport
> +(yet). Normally, before enumeration/discovery have been executed
> +only fabric enumerating mports have a valid destination ID
> +assigned to them using "hdid=..." rapidio module parameter.
>  
>  After enumeration or discovery was performed for a given mport device,
>  the corresponding subdirectory will also contain subdirectories for each
>  child RapidIO device connected to the mport.
>  
>  The example below shows mport device subdirectory with several child RapidIO
> -devices attached to it.
> +devices attached to it::
>  
> -[rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l
> -total 0
> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0001
> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0004
> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0007
> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0002
> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0003
> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0005
> -lrwxrwxrwx 1 root root    0 Feb 11 15:11 device -> ../../../0000:01:00.0
> --r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid
> -drwxr-xr-x 2 root root    0 Feb 11 15:11 power
> -lrwxrwxrwx 1 root root    0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port
> --r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size
> --rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent
> +    [rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l
> +    total 0
> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0001
> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0004
> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0007
> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0002
> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0003
> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0005
> +    lrwxrwxrwx 1 root root    0 Feb 11 15:11 device -> ../../../0000:01:00.0
> +    -r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid
> +    drwxr-xr-x 2 root root    0 Feb 11 15:11 power
> +    lrwxrwxrwx 1 root root    0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port
> +    -r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size
> +    -rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent
> diff --git a/Documentation/ABI/testing/sysfs-class-regulator b/Documentation/ABI/testing/sysfs-class-regulator
> index bc578bc60628..8516f08806dd 100644
> --- a/Documentation/ABI/testing/sysfs-class-regulator
> +++ b/Documentation/ABI/testing/sysfs-class-regulator
> @@ -35,13 +35,13 @@ Description:
>  
>  		This will be one of the following strings:
>  
> -			off
> -			on
> -			error
> -			fast
> -			normal
> -			idle
> -			standby
> +			- off
> +			- on
> +			- error
> +			- fast
> +			- normal
> +			- idle
> +			- standby
>  
>  		"off" means the regulator is not supplying power to the
>  		system.
> @@ -74,9 +74,9 @@ Description:
>  
>  		This will be one of the following strings:
>  
> -		'voltage'
> -		'current'
> -		'unknown'
> +		- 'voltage'
> +		- 'current'
> +		- 'unknown'
>  
>  		'voltage' means the regulator output voltage can be controlled
>  		by software.
> @@ -129,11 +129,11 @@ Description:
>  
>  		The opmode value can be one of the following strings:
>  
> -		'fast'
> -		'normal'
> -		'idle'
> -		'standby'
> -		'unknown'
> +		- 'fast'
> +		- 'normal'
> +		- 'idle'
> +		- 'standby'
> +		- 'unknown'
>  
>  		The modes are described in include/linux/regulator/consumer.h
>  
> @@ -360,9 +360,9 @@ Description:
>  
>  		This will be one of the following strings:
>  
> -		'enabled'
> -		'disabled'
> -		'unknown'
> +		- 'enabled'
> +		- 'disabled'
> +		- 'unknown'
>  
>  		'enabled' means the regulator is in bypass mode.
>  
> diff --git a/Documentation/ABI/testing/sysfs-class-remoteproc b/Documentation/ABI/testing/sysfs-class-remoteproc
> index 066b9b6f4924..0c9ee55098b8 100644
> --- a/Documentation/ABI/testing/sysfs-class-remoteproc
> +++ b/Documentation/ABI/testing/sysfs-class-remoteproc
> @@ -16,11 +16,11 @@ Description:	Remote processor state
>  
>  		Reports the state of the remote processor, which will be one of:
>  
> -		"offline"
> -		"suspended"
> -		"running"
> -		"crashed"
> -		"invalid"
> +		- "offline"
> +		- "suspended"
> +		- "running"
> +		- "crashed"
> +		- "invalid"
>  
>  		"offline" means the remote processor is powered off.
>  
> @@ -38,8 +38,8 @@ Description:	Remote processor state
>  		Writing this file controls the state of the remote processor.
>  		The following states can be written:
>  
> -		"start"
> -		"stop"
> +		- "start"
> +		- "stop"
>  
>  		Writing "start" will attempt to start the processor running the
>  		firmware indicated by, or written to,
> diff --git a/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration b/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration
> index ec950c93e5c6..ee8ed6494a01 100644
> --- a/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration
> +++ b/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration
> @@ -7,6 +7,7 @@ Description:    Attribute for calibrating ST-Ericsson AB8500 Real Time Clock
>                  calibrate the AB8500.s 32KHz Real Time Clock.
>                  Every 60 seconds the AB8500 will correct the RTC's value
>                  by adding to it the value of this attribute.
> +
>                  The range of the attribute is -127 to +127 in units of
>                  30.5 micro-seconds (half-parts-per-million of the 32KHz clock)
>  Users:          The /vendor/st-ericsson/base_utilities/core/rtc_calibration
> diff --git a/Documentation/ABI/testing/sysfs-class-uwb_rc b/Documentation/ABI/testing/sysfs-class-uwb_rc
> index a0578751c1e3..6c5dcad21e19 100644
> --- a/Documentation/ABI/testing/sysfs-class-uwb_rc
> +++ b/Documentation/ABI/testing/sysfs-class-uwb_rc
> @@ -66,11 +66,14 @@ Description:
>                  <channel> <type> [<bpst offset>]
>  
>                  to start (or stop) scanning on a channel.  <type> is one of:
> -                    0 - scan
> -                    1 - scan outside BP
> -                    2 - scan while inactive
> -                    3 - scanning disabled
> -                    4 - scan (with start time of <bpst offset>)
> +
> +		   ==   =======================================
> +                    0   scan
> +                    1   scan outside BP
> +                    2   scan while inactive
> +                    3   scanning disabled
> +                    4   scan (with start time of <bpst offset>)
> +		   ==   =======================================
>  
>  What:           /sys/class/uwb_rc/uwbN/mac_address
>  Date:           July 2008
> diff --git a/Documentation/ABI/testing/sysfs-class-watchdog b/Documentation/ABI/testing/sysfs-class-watchdog
> index 9860a8b2ba75..585caecda3a5 100644
> --- a/Documentation/ABI/testing/sysfs-class-watchdog
> +++ b/Documentation/ABI/testing/sysfs-class-watchdog
> @@ -91,10 +91,13 @@ Description:
>  		h/w strapping (for WDT2 only).
>  
>  		At alternate flash the 'access_cs0' sysfs node provides:
> -			ast2400: a way to get access to the primary SPI flash
> +
> +			ast2400:
> +				a way to get access to the primary SPI flash
>  				chip at CS0 after booting from the alternate
>  				chip at CS1.
> -			ast2500: a way to restore the normal address mapping
> +			ast2500:
> +				a way to restore the normal address mapping
>  				from (CS0->CS1, CS1->CS0) to (CS0->CS0,
>  				CS1->CS1).
>  
> diff --git a/Documentation/ABI/testing/sysfs-dev b/Documentation/ABI/testing/sysfs-dev
> index a9f2b8b0530f..d1739063e762 100644
> --- a/Documentation/ABI/testing/sysfs-dev
> +++ b/Documentation/ABI/testing/sysfs-dev
> @@ -9,9 +9,10 @@ Description:	The /sys/dev tree provides a method to look up the sysfs
>  		the form "<major>:<minor>".  These links point to the
>  		corresponding sysfs path for the given device.
>  
> -		Example:
> -		$ readlink /sys/dev/block/8:32
> -		../../block/sdc
> +		Example::
> +
> +		  $ readlink /sys/dev/block/8:32
> +		  ../../block/sdc
>  
>  		Entries in /sys/dev/char and /sys/dev/block will be
>  		dynamically created and destroyed as devices enter and
> diff --git a/Documentation/ABI/testing/sysfs-devices-mapping b/Documentation/ABI/testing/sysfs-devices-mapping
> index 490ccfd67f12..8d202bac9394 100644
> --- a/Documentation/ABI/testing/sysfs-devices-mapping
> +++ b/Documentation/ABI/testing/sysfs-devices-mapping
> @@ -8,26 +8,27 @@ Description:
>                  block.
>                  For example, on 4-die Xeon platform with up to 6 IIO stacks per
>                  die and, therefore, 6 IIO PMON blocks per die, the mapping of
> -                IIO PMON block 0 exposes as the following:
> +                IIO PMON block 0 exposes as the following::
>  
> -                $ ls /sys/devices/uncore_iio_0/die*
> -                -r--r--r-- /sys/devices/uncore_iio_0/die0
> -                -r--r--r-- /sys/devices/uncore_iio_0/die1
> -                -r--r--r-- /sys/devices/uncore_iio_0/die2
> -                -r--r--r-- /sys/devices/uncore_iio_0/die3
> +		    $ ls /sys/devices/uncore_iio_0/die*
> +		    -r--r--r-- /sys/devices/uncore_iio_0/die0
> +		    -r--r--r-- /sys/devices/uncore_iio_0/die1
> +		    -r--r--r-- /sys/devices/uncore_iio_0/die2
> +		    -r--r--r-- /sys/devices/uncore_iio_0/die3
>  
> -                $ tail /sys/devices/uncore_iio_0/die*
> -                ==> /sys/devices/uncore_iio_0/die0 <==  
> -                0000:00
> -                ==> /sys/devices/uncore_iio_0/die1 <==  
> -                0000:40
> -                ==> /sys/devices/uncore_iio_0/die2 <==  
> -                0000:80
> -                ==> /sys/devices/uncore_iio_0/die3 <==  
> -                0000:c0
> +		    $ tail /sys/devices/uncore_iio_0/die*
> +		    ==> /sys/devices/uncore_iio_0/die0 <==
> +		    0000:00
> +		    ==> /sys/devices/uncore_iio_0/die1 <==
> +		    0000:40
> +		    ==> /sys/devices/uncore_iio_0/die2 <==
> +		    0000:80
> +		    ==> /sys/devices/uncore_iio_0/die3 <==
> +		    0000:c0
>  
> -                Which means:
> -                IIO PMU 0 on die 0 belongs to PCI RP on bus 0x00, domain 0x0000
> -                IIO PMU 0 on die 1 belongs to PCI RP on bus 0x40, domain 0x0000
> -                IIO PMU 0 on die 2 belongs to PCI RP on bus 0x80, domain 0x0000
> -                IIO PMU 0 on die 3 belongs to PCI RP on bus 0xc0, domain 0x0000
> +                Which means::
> +
> +		    IIO PMU 0 on die 0 belongs to PCI RP on bus 0x00, domain 0x0000
> +		    IIO PMU 0 on die 1 belongs to PCI RP on bus 0x40, domain 0x0000
> +		    IIO PMU 0 on die 2 belongs to PCI RP on bus 0x80, domain 0x0000
> +		    IIO PMU 0 on die 3 belongs to PCI RP on bus 0xc0, domain 0x0000
> diff --git a/Documentation/ABI/testing/sysfs-devices-memory b/Documentation/ABI/testing/sysfs-devices-memory
> index deef3b5723cf..2da2b1fba2c1 100644
> --- a/Documentation/ABI/testing/sysfs-devices-memory
> +++ b/Documentation/ABI/testing/sysfs-devices-memory
> @@ -47,16 +47,19 @@ Description:
>  		online/offline state of the memory section.  When written,
>  		root can toggle the the online/offline state of a removable
>  		memory section (see removable file description above)
> -		using the following commands.
> -		# echo online > /sys/devices/system/memory/memoryX/state
> -		# echo offline > /sys/devices/system/memory/memoryX/state
> +		using the following commands::
> +
> +		  # echo online > /sys/devices/system/memory/memoryX/state
> +		  # echo offline > /sys/devices/system/memory/memoryX/state
>  
>  		For example, if /sys/devices/system/memory/memory22/removable
>  		contains a value of 1 and
>  		/sys/devices/system/memory/memory22/state contains the
>  		string "online" the following command can be executed by
> -		by root to offline that section.
> -		# echo offline > /sys/devices/system/memory/memory22/state
> +		by root to offline that section::
> +
> +		  # echo offline > /sys/devices/system/memory/memory22/state
> +
>  Users:		hotplug memory remove tools
>  		http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils
>  
> @@ -78,6 +81,7 @@ Description:
>  
>  		For example, the following symbolic link is created for
>  		memory section 9 on node0:
> +
>  		/sys/devices/system/memory/memory9/node0 -> ../../node/node0
>  
>  
> @@ -90,4 +94,5 @@ Description:
>  		points to the corresponding /sys/devices/system/memory/memoryY
>  		memory section directory.  For example, the following symbolic
>  		link is created for memory section 9 on node0.
> +
>  		/sys/devices/system/node/node0/memory9 -> ../../memory/memory9
> diff --git a/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget b/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget
> index d548eaac230a..40f29a01fd14 100644
> --- a/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget
> +++ b/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget
> @@ -3,8 +3,9 @@ Date:		April 2010
>  Contact:	Fabien Chouteau <fabien.chouteau@barco.com>
>  Description:
>  		Show the suspend state of an USB composite gadget.
> -		1 -> suspended
> -		0 -> resumed
> +
> +		- 1 -> suspended
> +		- 0 -> resumed
>  
>  		(_UDC_ is the name of the USB Device Controller driver)
>  
> @@ -17,5 +18,6 @@ Description:
>  		Storage mode.
>  
>  		Possible values are:
> -			1 -> ignore the FUA flag
> -			0 -> obey the FUA flag
> +
> +			- 1 -> ignore the FUA flag
> +			- 0 -> obey the FUA flag
> diff --git a/Documentation/ABI/testing/sysfs-devices-platform-ipmi b/Documentation/ABI/testing/sysfs-devices-platform-ipmi
> index afb5db856e1c..07df0ddc0b69 100644
> --- a/Documentation/ABI/testing/sysfs-devices-platform-ipmi
> +++ b/Documentation/ABI/testing/sysfs-devices-platform-ipmi
> @@ -123,38 +123,40 @@ KernelVersion:	v4.15
>  Contact:	openipmi-developer@lists.sourceforge.net
>  Description:
>  
> -		idles:			(RO) Number of times the interface was
> +		======================	========================================
> +		idles			(RO) Number of times the interface was
>  					idle while being polled.
>  
> -		watchdog_pretimeouts:	(RO) Number of watchdog pretimeouts.
> +		watchdog_pretimeouts	(RO) Number of watchdog pretimeouts.
>  
> -		complete_transactions:	(RO) Number of completed messages.
> +		complete_transactions	(RO) Number of completed messages.
>  
> -		events:			(RO) Number of IPMI events received from
> +		events			(RO) Number of IPMI events received from
>  					the hardware.
>  
> -		interrupts:		(RO) Number of interrupts the driver
> +		interrupts		(RO) Number of interrupts the driver
>  					handled.
>  
> -		hosed_count:		(RO) Number of times the hardware didn't
> +		hosed_count		(RO) Number of times the hardware didn't
>  					follow the state machine.
>  
> -		long_timeouts:		(RO) Number of times the driver
> +		long_timeouts		(RO) Number of times the driver
>  					requested a timer while nothing was in
>  					progress.
>  
> -		flag_fetches:		(RO) Number of times the driver
> +		flag_fetches		(RO) Number of times the driver
>  					requested flags from the hardware.
>  
> -		attentions:		(RO) Number of time the driver got an
> +		attentions		(RO) Number of time the driver got an
>  					ATTN from the hardware.
>  
> -		incoming_messages:	(RO) Number of asynchronous messages
> +		incoming_messages	(RO) Number of asynchronous messages
>  					received.
>  
> -		short_timeouts:		(RO) Number of times the driver
> +		short_timeouts		(RO) Number of times the driver
>  					requested a timer while an operation was
>  					in progress.
> +		======================	========================================
>  
>  
>  What:		/sys/devices/platform/ipmi_si.*/interrupts_enabled
> @@ -201,38 +203,40 @@ Date:		Sep, 2017
>  KernelVersion:	v4.15
>  Contact:	openipmi-developer@lists.sourceforge.net
>  Description:
> -		hosed:			(RO) Number of times the hardware didn't
> +		======================	========================================
> +		hosed			(RO) Number of times the hardware didn't
>  					follow the state machine.
>  
> -		alerts:			(RO) Number of alerts received.
> +		alerts			(RO) Number of alerts received.
>  
> -		sent_messages:		(RO) Number of total messages sent.
> +		sent_messages		(RO) Number of total messages sent.
>  
> -		sent_message_parts:	(RO) Number of message parts sent.
> +		sent_message_parts	(RO) Number of message parts sent.
>  					Messages may be broken into parts if
>  					they are long.
>  
> -		received_messages:	(RO) Number of message responses
> +		received_messages	(RO) Number of message responses
>  					received.
>  
> -		received_message_parts: (RO) Number of message fragments
> +		received_message_parts	(RO) Number of message fragments
>  					received.
>  
> -		events:			(RO) Number of received events.
> +		events			(RO) Number of received events.
>  
> -		watchdog_pretimeouts:	(RO) Number of watchdog pretimeouts.
> +		watchdog_pretimeouts	(RO) Number of watchdog pretimeouts.
>  
> -		flag_fetches:		(RO) Number of times a flag fetch was
> +		flag_fetches		(RO) Number of times a flag fetch was
>  					requested.
>  
> -		send_retries:		(RO) Number of time a message was
> +		send_retries		(RO) Number of time a message was
>  					retried.
>  
> -		receive_retries:	(RO) Number of times the receive of a
> +		receive_retries		(RO) Number of times the receive of a
>  					message was retried.
>  
> -		send_errors:		(RO) Number of times the send of a
> +		send_errors		(RO) Number of times the send of a
>  					message failed.
>  
> -		receive_errors:		(RO) Number of errors in receiving
> +		receive_errors		(RO) Number of errors in receiving
>  					messages.
> +		======================	========================================
> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
> index 274c337ec6a9..1a04ca8162ad 100644
> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
> @@ -169,7 +169,7 @@ Description:
>  			      observed CPU idle duration was too short for it
>  			      (a count).
>  
> -		below: 	 (RO) Number of times this state was entered, but the
> +		below:	 (RO) Number of times this state was entered, but the
>  			      observed CPU idle duration was too long for it
>  			      (a count).
>  		======== ==== =================================================
> @@ -601,7 +601,7 @@ Description:	Secure Virtual Machine
>  		Facility in POWER9 and newer processors. i.e., it is a Secure
>  		Virtual Machine.
>  
> -What: 		/sys/devices/system/cpu/cpuX/purr
> +What:		/sys/devices/system/cpu/cpuX/purr
>  Date:		Apr 2005
>  Contact:	Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
>  Description:	PURR ticks for this CPU since the system boot.
> diff --git a/Documentation/ABI/testing/sysfs-driver-hid-lenovo b/Documentation/ABI/testing/sysfs-driver-hid-lenovo
> index 53a0725962e1..aee85ca1f6be 100644
> --- a/Documentation/ABI/testing/sysfs-driver-hid-lenovo
> +++ b/Documentation/ABI/testing/sysfs-driver-hid-lenovo
> @@ -3,14 +3,18 @@ Date:		July 2011
>  Contact:	linux-input@vger.kernel.org
>  Description:	This controls if mouse clicks should be generated if the trackpoint is quickly pressed. How fast this press has to be
>  		is being controlled by press_speed.
> +
>  		Values are 0 or 1.
> +
>  		Applies to Thinkpad USB Keyboard with TrackPoint.
>  
>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/dragging
>  Date:		July 2011
>  Contact:	linux-input@vger.kernel.org
>  Description:	If this setting is enabled, it is possible to do dragging by pressing the trackpoint. This requires press_to_select to be enabled.
> +
>  		Values are 0 or 1.
> +
>  		Applies to Thinkpad USB Keyboard with TrackPoint.
>  
>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/release_to_select
> @@ -25,7 +29,9 @@ Date:		July 2011
>  Contact:	linux-input@vger.kernel.org
>  Description:	This setting controls if the mouse click events generated by pressing the trackpoint (if press_to_select is enabled) generate
>  		a left or right mouse button click.
> +
>  		Values are 0 or 1.
> +
>  		Applies to Thinkpad USB Keyboard with TrackPoint.
>  
>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/sensitivity
> @@ -39,12 +45,16 @@ What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-
>  Date:		July 2011
>  Contact:	linux-input@vger.kernel.org
>  Description:	This setting controls how fast the trackpoint needs to be pressed to generate a mouse click if press_to_select is enabled.
> +
>  		Values are decimal integers from 1 (slowest) to 255 (fastest).
> +
>  		Applies to Thinkpad USB Keyboard with TrackPoint.
>  
>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/fn_lock
>  Date:		July 2014
>  Contact:	linux-input@vger.kernel.org
>  Description:	This setting controls whether Fn Lock is enabled on the keyboard (i.e. if F1 is Mute or F1)
> +
>  		Values are 0 or 1
> +
>  		Applies to ThinkPad Compact (USB|Bluetooth) Keyboard with TrackPoint.
> diff --git a/Documentation/ABI/testing/sysfs-driver-hid-ntrig b/Documentation/ABI/testing/sysfs-driver-hid-ntrig
> index e574a5625efe..0e323a5cec6c 100644
> --- a/Documentation/ABI/testing/sysfs-driver-hid-ntrig
> +++ b/Documentation/ABI/testing/sysfs-driver-hid-ntrig
> @@ -29,12 +29,13 @@ Contact:	linux-input@vger.kernel.org
>  Description:
>  		Threholds to override activation slack.
>  
> -		activation_width:	(RW) Width threshold to immediately
> +		=================	=====================================
> +		activation_width	(RW) Width threshold to immediately
>  					start processing touch events.
>  
> -		activation_height:	(RW) Height threshold to immediately
> +		activation_height	(RW) Height threshold to immediately
>  					start processing touch events.
> -
> +		=================	=====================================
>  
>  What:		/sys/bus/hid/drivers/ntrig/<dev>/min_width
>  What:		/sys/bus/hid/drivers/ntrig/<dev>/min_height
> @@ -44,11 +45,13 @@ Contact:	linux-input@vger.kernel.org
>  Description:
>  		Minimum size contact accepted.
>  
> -		min_width:	(RW) Minimum touch contact width to decide
> +		==========	===========================================
> +		min_width	(RW) Minimum touch contact width to decide
>  				activation and activity.
>  
> -		min_height:	(RW) Minimum touch contact height to decide
> +		min_height	(RW) Minimum touch contact height to decide
>  				activation and activity.
> +		==========	===========================================
>  
>  
>  What:		/sys/bus/hid/drivers/ntrig/<dev>/sensor_physical_width
> diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone
> index 8f7982c70d72..11cd9bf0ad18 100644
> --- a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone
> +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone
> @@ -3,17 +3,21 @@ Date:		March 2010
>  Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
>  Description:	It is possible to switch the dpi setting of the mouse with the
>  		press of a button.
> +
>  		When read, this file returns the raw number of the actual dpi
>  		setting reported by the mouse. This number has to be further
>  		processed to receive the real dpi value:
>  
> +		===== =====
>  		VALUE DPI
> +		===== =====
>  		1     800
>  		2     1200
>  		3     1600
>  		4     2000
>  		5     2400
>  		6     3200
> +		===== =====
>  
>  		This file is readonly.
>  Users:		http://roccat.sourceforge.net
> @@ -22,6 +26,7 @@ What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-
>  Date:		March 2010
>  Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
>  Description:	When read, this file returns the number of the actual profile.
> +
>  		This file is readonly.
>  Users:		http://roccat.sourceforge.net
>  
> @@ -33,6 +38,7 @@ Description:	When read, this file returns the raw integer version number of the
>  		further usage in other programs. To receive the real version
>  		number the decimal point has to be shifted 2 positions to the
>  		left. E.g. a returned value of 138 means 1.38
> +
>  		This file is readonly.
>  Users:		http://roccat.sourceforge.net
>  
> @@ -43,10 +49,13 @@ Description:	The mouse can store 5 profiles which can be switched by the
>                  press of a button. A profile holds information like button
>                  mappings, sensitivity, the colors of the 5 leds and light
>                  effects.
> +
>                  When read, these files return the respective profile. The
>                  returned data is 975 bytes in size.
> +
>  		When written, this file lets one write the respective profile
>  		data back to the mouse. The data has to be 975 bytes long.
> +
>  		The mouse will reject invalid data, whereas the profile number
>  		stored in the profile doesn't need to fit the number of the
>  		store.
> @@ -58,6 +67,7 @@ Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
>  Description:	When read, this file returns the settings stored in the mouse.
>  		The size of the data is 36 bytes and holds information like the
>  		startup_profile, tcu state and calibration_data.
> +
>  		When written, this file lets write settings back to the mouse.
>  		The data has to be 36 bytes long. The mouse will reject invalid
>  		data.
> @@ -67,8 +77,10 @@ What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-
>  Date:		March 2010
>  Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
>  Description:	The integer value of this attribute ranges from 1 to 5.
> +
>                  When read, this attribute returns the number of the profile
>                  that's active when the mouse is powered on.
> +
>  		When written, this file sets the number of the startup profile
>  		and the mouse activates this profile immediately.
>  Users:		http://roccat.sourceforge.net
> @@ -80,9 +92,12 @@ Description:	The mouse has a "Tracking Control Unit" which lets the user
>  		calibrate the laser power to fit the mousepad surface.
>  		When read, this file returns the current state of the TCU,
>  		where 0 means off and 1 means on.
> +
>  		Writing 0 in this file will switch the TCU off.
> +
>  		Writing 1 in this file will start the calibration which takes
>  		around 6 seconds to complete and activates the TCU.
> +
>  Users:		http://roccat.sourceforge.net
>  
>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/weight
> @@ -93,14 +108,18 @@ Description:	The mouse can be equipped with one of four supplied weights
>  		and its value can be read out. When read, this file returns the
>  		raw value returned by the mouse which eases further processing
>  		in other software.
> +
>  		The values map to the weights as follows:
>  
> +		===== ======
>  		VALUE WEIGHT
> +		===== ======
>  		0     none
>  		1     5g
>  		2     10g
>  		3     15g
>  		4     20g
> +		===== ======
>  
>  		This file is readonly.
>  Users:		http://roccat.sourceforge.net
> diff --git a/Documentation/ABI/testing/sysfs-driver-hid-wiimote b/Documentation/ABI/testing/sysfs-driver-hid-wiimote
> index cd7b82a5c27d..3bf43d9dcdfe 100644
> --- a/Documentation/ABI/testing/sysfs-driver-hid-wiimote
> +++ b/Documentation/ABI/testing/sysfs-driver-hid-wiimote
> @@ -20,6 +20,7 @@ Description:	This file contains the currently connected and initialized
>  		the official Nintendo Nunchuck extension and classic is the
>  		Nintendo Classic Controller extension. The motionp extension can
>  		be combined with the other two.
> +
>  		Starting with kernel-version 3.11 Motion Plus hotplugging is
>  		supported and if detected, it's no longer reported as static
>  		extension. You will get uevent notifications for the motion-plus
> diff --git a/Documentation/ABI/testing/sysfs-driver-input-exc3000 b/Documentation/ABI/testing/sysfs-driver-input-exc3000
> index 3d316d54f81c..cd7c578aef2c 100644
> --- a/Documentation/ABI/testing/sysfs-driver-input-exc3000
> +++ b/Documentation/ABI/testing/sysfs-driver-input-exc3000
> @@ -4,6 +4,7 @@ Contact:	linux-input@vger.kernel.org
>  Description:    Reports the firmware version provided by the touchscreen, for example "00_T6" on a EXC80H60
>  
>  		Access: Read
> +
>  		Valid values: Represented as string
>  
>  What:		/sys/bus/i2c/devices/xxx/model
> @@ -12,4 +13,5 @@ Contact:	linux-input@vger.kernel.org
>  Description:    Reports the model identification provided by the touchscreen, for example "Orion_1320" on a EXC80H60
>  
>  		Access: Read
> +
>  		Valid values: Represented as string
> diff --git a/Documentation/ABI/testing/sysfs-driver-jz4780-efuse b/Documentation/ABI/testing/sysfs-driver-jz4780-efuse
> index bb6f5d6ceea0..4cf595d681e6 100644
> --- a/Documentation/ABI/testing/sysfs-driver-jz4780-efuse
> +++ b/Documentation/ABI/testing/sysfs-driver-jz4780-efuse
> @@ -4,7 +4,9 @@ Contact:	PrasannaKumar Muralidharan <prasannatsmkumar@gmail.com>
>  Description:	read-only access to the efuse on the Ingenic JZ4780 SoC
>  		The SoC has a one time programmable 8K efuse that is
>  		split into segments. The driver supports read only.
> -		The segments are
> +		The segments are:
> +
> +		===== ======== =================
>  		0x000   64 bit Random Number
>  		0x008  128 bit Ingenic Chip ID
>  		0x018  128 bit Customer ID
> @@ -12,5 +14,7 @@ Description:	read-only access to the efuse on the Ingenic JZ4780 SoC
>  		0x1E0    8 bit Protect Segment
>  		0x1E1 2296 bit HDMI Key
>  		0x300 2048 bit Security boot key
> +		===== ======== =================
> +
>  Users:		any user space application which wants to read the Chip
>  		and Customer ID
> diff --git a/Documentation/ABI/testing/sysfs-driver-pciback b/Documentation/ABI/testing/sysfs-driver-pciback
> index 73308c2b81b0..49f5fd0c8bbd 100644
> --- a/Documentation/ABI/testing/sysfs-driver-pciback
> +++ b/Documentation/ABI/testing/sysfs-driver-pciback
> @@ -7,8 +7,10 @@ Description:
>                  the format of DDDD:BB:DD.F-REG:SIZE:MASK will allow the guest
>                  to write and read from the PCI device. That is Domain:Bus:
>                  Device.Function-Register:Size:Mask (Domain is optional).
> -                For example:
> -                #echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks
> +                For example::
> +
> +                  #echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks
> +
>                  will allow the guest to read and write to the configuration
>                  register 0x0E.
>  
> diff --git a/Documentation/ABI/testing/sysfs-driver-ufs b/Documentation/ABI/testing/sysfs-driver-ufs
> index d1a352194d2e..adc0d0e91607 100644
> --- a/Documentation/ABI/testing/sysfs-driver-ufs
> +++ b/Documentation/ABI/testing/sysfs-driver-ufs
> @@ -18,6 +18,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the device type. This is one of the UFS
>  		device descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_class
> @@ -26,6 +27,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the device class. This is one of the UFS
>  		device descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_sub_class
> @@ -34,6 +36,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the UFS storage subclass. This is one of
>  		the UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/protocol
> @@ -43,6 +46,7 @@ Description:	This file shows the protocol supported by an UFS device.
>  		This is one of the UFS device descriptor parameters.
>  		The full information about the descriptor could be found
>  		at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_luns
> @@ -51,6 +55,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows number of logical units. This is one of
>  		the UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_wluns
> @@ -60,6 +65,7 @@ Description:	This file shows number of well known logical units.
>  		This is one of the UFS device descriptor parameters.
>  		The full information about the descriptor could be found
>  		at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/boot_enable
> @@ -69,6 +75,7 @@ Description:	This file shows value that indicates whether the device is
>  		enabled for boot. This is one of the UFS device descriptor
>  		parameters. The full information about the descriptor could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/descriptor_access_enable
> @@ -79,6 +86,7 @@ Description:	This file shows value that indicates whether the device
>  		of the boot sequence. This is one of the UFS device descriptor
>  		parameters. The full information about the descriptor could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_power_mode
> @@ -88,6 +96,7 @@ Description:	This file shows value that defines the power mode after
>  		device initialization or hardware reset. This is one of
>  		the UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/high_priority_lun
> @@ -96,6 +105,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the high priority lun. This is one of
>  		the UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/secure_removal_type
> @@ -104,6 +114,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the secure removal type. This is one of
>  		the UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/support_security_lun
> @@ -113,6 +124,7 @@ Description:	This file shows whether the security lun is supported.
>  		This is one of the UFS device descriptor parameters.
>  		The full information about the descriptor could be found
>  		at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/bkops_termination_latency
> @@ -122,6 +134,7 @@ Description:	This file shows the background operations termination
>  		latency. This is one of the UFS device descriptor parameters.
>  		The full information about the descriptor could be found
>  		at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_active_icc_level
> @@ -130,6 +143,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the initial active ICC level. This is one
>  		of the UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/specification_version
> @@ -138,6 +152,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the specification version. This is one
>  		of the UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturing_date
> @@ -147,6 +162,7 @@ Description:	This file shows the manufacturing date in BCD format.
>  		This is one of the UFS device descriptor parameters.
>  		The full information about the descriptor could be found
>  		at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturer_id
> @@ -155,6 +171,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the manufacturee ID. This is one of the
>  		UFS device descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtt_capability
> @@ -164,6 +181,7 @@ Description:	This file shows the maximum number of outstanding RTTs
>  		supported by the device. This is one of the UFS device
>  		descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtc_update
> @@ -173,6 +191,7 @@ Description:	This file shows the frequency and method of the realtime
>  		clock update. This is one of the UFS device descriptor
>  		parameters. The full information about the descriptor
>  		could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/ufs_features
> @@ -182,6 +201,7 @@ Description:	This file shows which features are supported by the device.
>  		This is one of the UFS device descriptor parameters.
>  		The full information about the descriptor could be
>  		found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/ffu_timeout
> @@ -190,6 +210,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the FFU timeout. This is one of the
>  		UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/queue_depth
> @@ -198,6 +219,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the device queue depth. This is one of the
>  		UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_version
> @@ -206,6 +228,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the device version. This is one of the
>  		UFS device descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_secure_wpa
> @@ -215,6 +238,7 @@ Description:	This file shows number of secure write protect areas
>  		supported by the device. This is one of the UFS device
>  		descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_max_data_size
> @@ -225,6 +249,7 @@ Description:	This file shows the maximum amount of data that may be
>  		This is one of the UFS device descriptor parameters.
>  		The full information about the descriptor could be found
>  		at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_state_timeout
> @@ -234,6 +259,7 @@ Description:	This file shows the command maximum timeout for a change
>  		in PSA state. This is one of the UFS device descriptor
>  		parameters. The full information about the descriptor could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -244,6 +270,7 @@ Description:	This file shows the MIPI UniPro version number in BCD format.
>  		This is one of the UFS interconnect descriptor parameters.
>  		The full information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/mphy_version
> @@ -253,6 +280,7 @@ Description:	This file shows the MIPI M-PHY version number in BCD format.
>  		This is one of the UFS interconnect descriptor parameters.
>  		The full information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -264,6 +292,7 @@ Description:	This file shows the total memory quantity available to
>  		of the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_luns
> @@ -273,6 +302,7 @@ Description:	This file shows the maximum number of logical units
>  		supported by the UFS device. This is one of the UFS
>  		geometry descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/segment_size
> @@ -281,6 +311,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the segment size. This is one of the UFS
>  		geometry descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/allocation_unit_size
> @@ -289,6 +320,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the allocation unit size. This is one of
>  		the UFS geometry descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/min_addressable_block_size
> @@ -298,6 +330,7 @@ Description:	This file shows the minimum addressable block size. This
>  		is one of the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at UFS
>  		specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_read_block_size
> @@ -307,6 +340,7 @@ Description:	This file shows the optimal read block size. This is one
>  		of the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at UFS
>  		specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_write_block_size
> @@ -316,6 +350,7 @@ Description:	This file shows the optimal write block size. This is one
>  		of the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at UFS
>  		specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_in_buffer_size
> @@ -325,6 +360,7 @@ Description:	This file shows the maximum data-in buffer size. This
>  		is one of the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at UFS
>  		specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_out_buffer_size
> @@ -334,6 +370,7 @@ Description:	This file shows the maximum data-out buffer size. This
>  		is one of the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at UFS
>  		specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/rpmb_rw_size
> @@ -343,6 +380,7 @@ Description:	This file shows the maximum number of RPMB frames allowed
>  		in Security Protocol In/Out. This is one of the UFS geometry
>  		descriptor parameters. The full information about the
>  		descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/dyn_capacity_resource_policy
> @@ -352,6 +390,7 @@ Description:	This file shows the dynamic capacity resource policy. This
>  		is one of the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/data_ordering
> @@ -361,6 +400,7 @@ Description:	This file shows support for out-of-order data transfer.
>  		This is one of the UFS geometry descriptor parameters.
>  		The full information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_contexts
> @@ -370,6 +410,7 @@ Description:	This file shows maximum available number of contexts which
>  		are supported by the device. This is one of the UFS geometry
>  		descriptor parameters. The full information about the
>  		descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_unit_size
> @@ -378,6 +419,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows system data tag unit size. This is one of
>  		the UFS geometry descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_resource_size
> @@ -388,6 +430,7 @@ Description:	This file shows maximum storage area size allocated by
>  		This is one of the UFS geometry descriptor parameters.
>  		The full information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/secure_removal_types
> @@ -397,6 +440,7 @@ Description:	This file shows supported secure removal types. This is
>  		one of the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/memory_types
> @@ -406,6 +450,7 @@ Description:	This file shows supported memory types. This is one of
>  		the UFS geometry descriptor parameters. The full
>  		information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_max_alloc_units
> @@ -416,6 +461,7 @@ Description:	This file shows the maximum number of allocation units for
>  		enhanced type 1-4). This is one of the UFS geometry
>  		descriptor parameters. The full information about the
>  		descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_capacity_adjustment_factor
> @@ -426,6 +472,7 @@ Description:	This file shows the memory capacity adjustment factor for
>  		enhanced type 1-4). This is one of the UFS geometry
>  		descriptor parameters. The full information about the
>  		descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -436,6 +483,7 @@ Description:	This file shows preend of life information. This is one
>  		of the UFS health descriptor parameters. The full
>  		information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_a
> @@ -445,6 +493,7 @@ Description:	This file shows indication of the device life time
>  		(method a). This is one of the UFS health descriptor
>  		parameters. The full information about the descriptor
>  		could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_b
> @@ -454,6 +503,7 @@ Description:	This file shows indication of the device life time
>  		(method b). This is one of the UFS health descriptor
>  		parameters. The full information about the descriptor
>  		could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -464,6 +514,7 @@ Description:	This file shows maximum VCC, VCCQ and VCCQ2 value for
>  		active ICC levels from 0 to 15. This is one of the UFS
>  		power descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -473,6 +524,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file contains a device manufactureer name string.
>  		The full information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_name
> @@ -480,6 +532,7 @@ Date:		February 2018
>  Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file contains a product name string. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/string_descriptors/oem_id
> @@ -487,6 +540,7 @@ Date:		February 2018
>  Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file contains a OEM ID string. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/string_descriptors/serial_number
> @@ -495,6 +549,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file contains a device serial number string. The full
>  		information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_revision
> @@ -503,6 +558,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file contains a product revision string. The full
>  		information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -512,6 +568,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows boot LUN information. This is one of
>  		the UFS unit descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/lun_write_protect
> @@ -520,6 +577,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows LUN write protection status. This is one of
>  		the UFS unit descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/lun_queue_depth
> @@ -528,6 +586,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows LUN queue depth. This is one of the UFS
>  		unit descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/psa_sensitive
> @@ -536,6 +595,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows PSA sensitivity. This is one of the UFS
>  		unit descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/lun_memory_type
> @@ -544,6 +604,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows LUN memory type. This is one of the UFS
>  		unit descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/data_reliability
> @@ -553,6 +614,7 @@ Description:	This file defines the device behavior when a power failure
>  		occurs during a write operation. This is one of the UFS
>  		unit descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/logical_block_size
> @@ -562,6 +624,7 @@ Description:	This file shows the size of addressable logical blocks
>  		(calculated as an exponent with base 2). This is one of
>  		the UFS unit descriptor parameters. The full information about
>  		the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/logical_block_count
> @@ -571,6 +634,7 @@ Description:	This file shows total number of addressable logical blocks.
>  		This is one of the UFS unit descriptor parameters. The full
>  		information about the descriptor could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/erase_block_size
> @@ -579,6 +643,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the erase block size. This is one of
>  		the UFS unit descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/provisioning_type
> @@ -587,6 +652,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the thin provisioning type. This is one of
>  		the UFS unit descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/physical_memory_resourse_count
> @@ -595,6 +661,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the total physical memory resources. This is
>  		one of the UFS unit descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/context_capabilities
> @@ -603,6 +670,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the context capabilities. This is one of
>  		the UFS unit descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/large_unit_granularity
> @@ -611,6 +679,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the granularity of the LUN. This is one of
>  		the UFS unit descriptor parameters. The full information
>  		about the descriptor could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -619,6 +688,7 @@ Date:		February 2018
>  Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the device init status. The full information
>  		about the flag could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/permanent_wpe
> @@ -627,6 +697,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows whether permanent write protection is enabled.
>  		The full information about the flag could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/power_on_wpe
> @@ -636,6 +707,7 @@ Description:	This file shows whether write protection is enabled on all
>  		logical units configured as power on write protected. The
>  		full information about the flag could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/bkops_enable
> @@ -644,6 +716,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows whether the device background operations are
>  		enabled. The full information about the flag could be
>  		found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/life_span_mode_enable
> @@ -652,6 +725,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows whether the device life span mode is enabled.
>  		The full information about the flag could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/phy_resource_removal
> @@ -660,6 +734,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows whether physical resource removal is enable.
>  		The full information about the flag could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/busy_rtc
> @@ -668,6 +743,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows whether the device is executing internal
>  		operation related to real time clock. The full information
>  		about the flag could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/disable_fw_update
> @@ -676,6 +752,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows whether the device FW update is permanently
>  		disabled. The full information about the flag could be found
>  		at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -685,6 +762,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the boot lun enabled UFS device attribute.
>  		The full information about the attribute could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/current_power_mode
> @@ -693,6 +771,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the current power mode UFS device attribute.
>  		The full information about the attribute could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/active_icc_level
> @@ -701,6 +780,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the active icc level UFS device attribute.
>  		The full information about the attribute could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/ooo_data_enabled
> @@ -709,6 +789,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the out of order data transfer enabled UFS
>  		device attribute. The full information about the attribute
>  		could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/bkops_status
> @@ -717,6 +798,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the background operations status UFS device
>  		attribute. The full information about the attribute could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/purge_status
> @@ -725,6 +807,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the purge operation status UFS device
>  		attribute. The full information about the attribute could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/max_data_in_size
> @@ -733,6 +816,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the maximum data size in a DATA IN
>  		UPIU. The full information about the attribute could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/max_data_out_size
> @@ -741,6 +825,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file shows the maximum number of bytes that can be
>  		requested with a READY TO TRANSFER UPIU. The full information
>  		about the attribute could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/reference_clock_frequency
> @@ -749,6 +834,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the reference clock frequency UFS device
>  		attribute. The full information about the attribute could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/configuration_descriptor_lock
> @@ -765,6 +851,7 @@ Description:	This file provides the maximum current number of
>  		outstanding RTTs in device that is allowed. The full
>  		information about the attribute could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_control
> @@ -773,6 +860,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the exception event control UFS device
>  		attribute. The full information about the attribute could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_status
> @@ -781,6 +869,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the exception event status UFS device
>  		attribute. The full information about the attribute could
>  		be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/ffu_status
> @@ -789,6 +878,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file provides the ffu status UFS device attribute.
>  		The full information about the attribute could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/psa_state
> @@ -796,6 +886,7 @@ Date:		February 2018
>  Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>  Description:	This file show the PSA feature status. The full information
>  		about the attribute could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/psa_data_size
> @@ -805,6 +896,7 @@ Description:	This file shows the amount of data that the host plans to
>  		load to all logical units in pre-soldering state.
>  		The full information about the attribute could be found at
>  		UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -815,6 +907,7 @@ Description:	This file shows the The amount of physical memory needed
>  		to be removed from the physical memory resources pool of
>  		the particular logical unit. The full information about
>  		the attribute could be found at UFS specifications 2.1.
> +
>  		The file is read only.
>  
>  
> @@ -824,24 +917,28 @@ Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>  Description:	This entry could be used to set or show the UFS device
>  		runtime power management level. The current driver
>  		implementation supports 6 levels with next target states:
> -		0 - an UFS device will stay active, an UIC link will
> -		stay active
> -		1 - an UFS device will stay active, an UIC link will
> -		hibernate
> -		2 - an UFS device will moved to sleep, an UIC link will
> -		stay active
> -		3 - an UFS device will moved to sleep, an UIC link will
> -		hibernate
> -		4 - an UFS device will be powered off, an UIC link will
> -		hibernate
> -		5 - an UFS device will be powered off, an UIC link will
> -		be powered off
> +
> +		==  ====================================================
> +		0   an UFS device will stay active, an UIC link will
> +		    stay active
> +		1   an UFS device will stay active, an UIC link will
> +		    hibernate
> +		2   an UFS device will moved to sleep, an UIC link will
> +		    stay active
> +		3   an UFS device will moved to sleep, an UIC link will
> +		    hibernate
> +		4   an UFS device will be powered off, an UIC link will
> +		    hibernate
> +		5   an UFS device will be powered off, an UIC link will
> +		    be powered off
> +		==  ====================================================
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/rpm_target_dev_state
>  Date:		February 2018
>  Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>  Description:	This entry shows the target power mode of an UFS device
>  		for the chosen runtime power management level.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/rpm_target_link_state
> @@ -849,6 +946,7 @@ Date:		February 2018
>  Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>  Description:	This entry shows the target state of an UFS UIC link
>  		for the chosen runtime power management level.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/spm_lvl
> @@ -857,24 +955,28 @@ Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>  Description:	This entry could be used to set or show the UFS device
>  		system power management level. The current driver
>  		implementation supports 6 levels with next target states:
> -		0 - an UFS device will stay active, an UIC link will
> -		stay active
> -		1 - an UFS device will stay active, an UIC link will
> -		hibernate
> -		2 - an UFS device will moved to sleep, an UIC link will
> -		stay active
> -		3 - an UFS device will moved to sleep, an UIC link will
> -		hibernate
> -		4 - an UFS device will be powered off, an UIC link will
> -		hibernate
> -		5 - an UFS device will be powered off, an UIC link will
> -		be powered off
> +
> +		==  ====================================================
> +		0   an UFS device will stay active, an UIC link will
> +		    stay active
> +		1   an UFS device will stay active, an UIC link will
> +		    hibernate
> +		2   an UFS device will moved to sleep, an UIC link will
> +		    stay active
> +		3   an UFS device will moved to sleep, an UIC link will
> +		    hibernate
> +		4   an UFS device will be powered off, an UIC link will
> +		    hibernate
> +		5   an UFS device will be powered off, an UIC link will
> +		    be powered off
> +		==  ====================================================
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/spm_target_dev_state
>  Date:		February 2018
>  Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>  Description:	This entry shows the target power mode of an UFS device
>  		for the chosen system power management level.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/spm_target_link_state
> @@ -882,18 +984,21 @@ Date:		February 2018
>  Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>  Description:	This entry shows the target state of an UFS UIC link
>  		for the chosen system power management level.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_presv_us_en
>  Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows if preserve user-space was configured
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_shared_alloc_units
>  Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the shared allocated units of WB buffer
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_type
> @@ -901,6 +1006,7 @@ Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the configured WB type.
>  		0x1 for shared buffer mode. 0x0 for dedicated buffer mode.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_buff_cap_adj
> @@ -910,6 +1016,7 @@ Description:	This entry shows the total user-space decrease in shared
>  		buffer mode.
>  		The value of this parameter is 3 for TLC NAND when SLC mode
>  		is used as WriteBooster Buffer. 2 for MLC NAND.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_alloc_units
> @@ -917,6 +1024,7 @@ Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the Maximum total WriteBooster Buffer size
>  		which is supported by the entire device.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_wb_luns
> @@ -924,6 +1032,7 @@ Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the maximum number of luns that can support
>  		WriteBooster.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_red_type
> @@ -937,46 +1046,59 @@ Description:	The supportability of user space reduction mode
>  		preserve user space type.
>  		02h: Device can be configured in either user space
>  		reduction type or preserve user space type.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_wb_type
>  Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	The supportability of WriteBooster Buffer type.
> -		00h: LU based WriteBooster Buffer configuration
> -		01h: Single shared WriteBooster Buffer
> -		configuration
> -		02h: Supporting both LU based WriteBooster
> -		Buffer and Single shared WriteBooster Buffer
> -		configuration
> +
> +		===  ==========================================================
> +		00h  LU based WriteBooster Buffer configuration
> +		01h  Single shared WriteBooster Buffer configuration
> +		02h  Supporting both LU based WriteBooster.
> +		     Buffer and Single shared WriteBooster Buffer configuration
> +		===  ==========================================================
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/wb_enable
>  Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the status of WriteBooster.
> -		0: WriteBooster is not enabled.
> -		1: WriteBooster is enabled
> +
> +		== ============================
> +		0  WriteBooster is not enabled.
> +		1  WriteBooster is enabled
> +		== ============================
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_en
>  Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows if flush is enabled.
> -		0: Flush operation is not performed.
> -		1: Flush operation is performed.
> +
> +		== =================================
> +		0  Flush operation is not performed.
> +		1  Flush operation is performed.
> +		== =================================
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_during_h8
>  Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	Flush WriteBooster Buffer during hibernate state.
> -		0: Device is not allowed to flush the
> -		WriteBooster Buffer during link hibernate
> -		state.
> -		1: Device is allowed to flush the
> -		WriteBooster Buffer during link hibernate
> -		state
> +
> +		== =================================================
> +		0  Device is not allowed to flush the
> +		   WriteBooster Buffer during link hibernate state.
> +		1  Device is allowed to flush the
> +		   WriteBooster Buffer during link hibernate state.
> +		== =================================================
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/wb_avail_buf
> @@ -984,23 +1106,30 @@ Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the amount of unused WriteBooster buffer
>  		available.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/wb_cur_buf
>  Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the amount of unused current buffer.
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/wb_flush_status
>  Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the flush operation status.
> -		00h: idle
> -		01h: Flush operation in progress
> -		02h: Flush operation stopped prematurely.
> -		03h: Flush operation completed successfully
> -		04h: Flush operation general failure
> +
> +
> +		===  ======================================
> +		00h  idle
> +		01h  Flush operation in progress
> +		02h  Flush operation stopped prematurely.
> +		03h  Flush operation completed successfully
> +		04h  Flush operation general failure
> +		===  ======================================
> +
>  		The file is read only.
>  
>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/wb_life_time_est
> @@ -1008,9 +1137,13 @@ Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows an indication of the WriteBooster Buffer
>  		lifetime based on the amount of performed program/erase cycles
> -		01h: 0% - 10% WriteBooster Buffer life time used
> +
> +		===  =============================================
> +		01h  0% - 10% WriteBooster Buffer life time used
>  		...
> -		0Ah: 90% - 100% WriteBooster Buffer life time used
> +		0Ah  90% - 100% WriteBooster Buffer life time used
> +		===  =============================================
> +
>  		The file is read only.
>  
>  What:		/sys/class/scsi_device/*/device/unit_descriptor/wb_buf_alloc_units
> @@ -1018,4 +1151,5 @@ Date:		June 2020
>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>  Description:	This entry shows the configured size of WriteBooster buffer.
>  		0400h corresponds to 4GB.
> +
>  		The file is read only.
> diff --git a/Documentation/ABI/testing/sysfs-driver-w1_ds28e17 b/Documentation/ABI/testing/sysfs-driver-w1_ds28e17
> index d301e7017afe..e92aba4eb594 100644
> --- a/Documentation/ABI/testing/sysfs-driver-w1_ds28e17
> +++ b/Documentation/ABI/testing/sysfs-driver-w1_ds28e17
> @@ -5,7 +5,9 @@ Contact:	Jan Kandziora <jjj@gmx.de>
>  Description:	When written, this file sets the I2C speed on the connected
>  		DS28E17 chip. When read, it reads the current setting from
>  		the DS28E17 chip.
> +
>  		Valid values: 100, 400, 900 [kBaud].
> +
>  		Default 100, can be set by w1_ds28e17.speed= module parameter.
>  Users:		w1_ds28e17 driver
>  
> @@ -17,5 +19,6 @@ Description:	When written, this file sets the multiplier used to calculate
>  		the busy timeout for I2C operations on the connected DS28E17
>  		chip. When read, returns the current setting.
>  		Valid values: 1 to 9.
> +
>  		Default 1, can be set by w1_ds28e17.stretch= module parameter.
>  Users:		w1_ds28e17 driver
> diff --git a/Documentation/ABI/testing/sysfs-firmware-acpi b/Documentation/ABI/testing/sysfs-firmware-acpi
> index e4afc2538210..b16d30a71709 100644
> --- a/Documentation/ABI/testing/sysfs-firmware-acpi
> +++ b/Documentation/ABI/testing/sysfs-firmware-acpi
> @@ -81,11 +81,11 @@ Description:
>  		  $ cd /sys/firmware/acpi/interrupts
>  		  $ grep . *
>  		  error:	     0
> -		  ff_gbl_lock:	   0   enable
> -		  ff_pmtimer:	  0  invalid
> -		  ff_pwr_btn:	  0   enable
> -		  ff_rt_clk:	 2  disable
> -		  ff_slp_btn:	  0  invalid
> +		  ff_gbl_lock:	     0   enable
> +		  ff_pmtimer:	     0  invalid
> +		  ff_pwr_btn:	     0   enable
> +		  ff_rt_clk:	     2  disable
> +		  ff_slp_btn:	     0  invalid
>  		  gpe00:	     0	invalid
>  		  gpe01:	     0	 enable
>  		  gpe02:	   108	 enable
> @@ -118,9 +118,9 @@ Description:
>  		  gpe1D:	     0	invalid
>  		  gpe1E:	     0	invalid
>  		  gpe1F:	     0	invalid
> -		  gpe_all:    1192
> -		  sci:	1194
> -		  sci_not:     0
> +		  gpe_all:	  1192
> +		  sci:		  1194
> +		  sci_not:	     0
>  
>  		===========  ==================================================
>  		sci	     The number of times the ACPI SCI
> diff --git a/Documentation/ABI/testing/sysfs-firmware-efi-esrt b/Documentation/ABI/testing/sysfs-firmware-efi-esrt
> index 6e431d1a4e79..31b57676d4ad 100644
> --- a/Documentation/ABI/testing/sysfs-firmware-efi-esrt
> +++ b/Documentation/ABI/testing/sysfs-firmware-efi-esrt
> @@ -35,10 +35,13 @@ What:		/sys/firmware/efi/esrt/entries/entry$N/fw_type
>  Date:		February 2015
>  Contact:	Peter Jones <pjones@redhat.com>
>  Description:	What kind of firmware entry this is:
> -		0 - Unknown
> -		1 - System Firmware
> -		2 - Device Firmware
> -		3 - UEFI Driver
> +
> +		==  ===============
> +		0   Unknown
> +		1   System Firmware
> +		2   Device Firmware
> +		3   UEFI Driver
> +		==  ===============
>  
>  What:		/sys/firmware/efi/esrt/entries/entry$N/fw_class
>  Date:		February 2015
> @@ -71,11 +74,14 @@ Date:		February 2015
>  Contact:	Peter Jones <pjones@redhat.com>
>  Description:	The result of the last firmware update attempt for the
>  		firmware resource entry.
> -		0 - Success
> -		1 - Insufficient resources
> -		2 - Incorrect version
> -		3 - Invalid format
> -		4 - Authentication error
> -		5 - AC power event
> -		6 - Battery power event
> +
> +		==  ======================
> +		0   Success
> +		1   Insufficient resources
> +		2   Incorrect version
> +		3   Invalid format
> +		4   Authentication error
> +		5   AC power event
> +		6   Battery power event
> +		==  ======================
>  
> diff --git a/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map b/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map
> index c61b9b348e99..9c4d581be396 100644
> --- a/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map
> +++ b/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map
> @@ -14,7 +14,7 @@ Description:	Switching efi runtime services to virtual mode requires
>  		/sys/firmware/efi/runtime-map/ is the directory the kernel
>  		exports that information in.
>  
> -		subdirectories are named with the number of the memory range:
> +		subdirectories are named with the number of the memory range::
>  
>  			/sys/firmware/efi/runtime-map/0
>  			/sys/firmware/efi/runtime-map/1
> @@ -24,11 +24,13 @@ Description:	Switching efi runtime services to virtual mode requires
>  
>  		Each subdirectory contains five files:
>  
> -		attribute : The attributes of the memory range.
> -		num_pages : The size of the memory range in pages.
> -		phys_addr : The physical address of the memory range.
> -		type      : The type of the memory range.
> -		virt_addr : The virtual address of the memory range.
> +		=========   =========================================
> +		attribute   The attributes of the memory range.
> +		num_pages   The size of the memory range in pages.
> +		phys_addr   The physical address of the memory range.
> +		type        The type of the memory range.
> +		virt_addr   The virtual address of the memory range.
> +		=========   =========================================
>  
>  		Above values are all hexadecimal numbers with the '0x' prefix.
>  Users:		Kexec
> diff --git a/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg b/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg
> index 011dda4f8e8a..ee0d6dbc810e 100644
> --- a/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg
> +++ b/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg
> @@ -15,7 +15,7 @@ Description:
>  		to the fw_cfg device can be found in "docs/specs/fw_cfg.txt"
>  		in the QEMU source tree.
>  
> -		=== SysFS fw_cfg Interface ===
> +		**SysFS fw_cfg Interface**
>  
>  		The fw_cfg sysfs interface described in this document is only
>  		intended to display discoverable blobs (i.e., those registered
> @@ -31,7 +31,7 @@ Description:
>  
>  			/sys/firmware/qemu_fw_cfg/rev
>  
> -		--- Discoverable fw_cfg blobs by selector key ---
> +		**Discoverable fw_cfg blobs by selector key**
>  
>  		All discoverable blobs listed in the fw_cfg file directory are
>  		displayed as entries named after their unique selector key
> @@ -45,24 +45,26 @@ Description:
>  		Each such fw_cfg sysfs entry has the following values exported
>  		as attributes:
>  
> -		name  	: The 56-byte nul-terminated ASCII string used as the
> +		====	  ====================================================
> +		name	  The 56-byte nul-terminated ASCII string used as the
>  			  blob's 'file name' in the fw_cfg directory.
> -		size  	: The length of the blob, as given in the fw_cfg
> +		size	  The length of the blob, as given in the fw_cfg
>  			  directory.
> -		key	: The value of the blob's selector key as given in the
> +		key	  The value of the blob's selector key as given in the
>  			  fw_cfg directory. This value is the same as used in
>  			  the parent directory name.
> -		raw	: The raw bytes of the blob, obtained by selecting the
> +		raw	  The raw bytes of the blob, obtained by selecting the
>  			  entry via the control register, and reading a number
>  			  of bytes equal to the blob size from the data
>  			  register.
> +		====	  ====================================================
>  
> -		--- Listing fw_cfg blobs by file name ---
> +		**Listing fw_cfg blobs by file name**
>  
>  		While the fw_cfg device does not impose any specific naming
>  		convention on the blobs registered in the file directory,
>  		QEMU developers have traditionally used path name semantics
> -		to give each blob a descriptive name. For example:
> +		to give each blob a descriptive name. For example::
>  
>  			"bootorder"
>  			"genroms/kvmvapic.bin"
> @@ -81,7 +83,7 @@ Description:
>  		of directories matching the path name components of fw_cfg
>  		blob names, ending in symlinks to the by_key entry for each
>  		"basename", as illustrated below (assume current directory is
> -		/sys/firmware):
> +		/sys/firmware)::
>  
>  		    qemu_fw_cfg/by_name/bootorder -> ../by_key/38
>  		    qemu_fw_cfg/by_name/etc/e820 -> ../../by_key/35
> diff --git a/Documentation/ABI/testing/sysfs-firmware-sfi b/Documentation/ABI/testing/sysfs-firmware-sfi
> index 4be7d44aeacf..5210e0f06ddb 100644
> --- a/Documentation/ABI/testing/sysfs-firmware-sfi
> +++ b/Documentation/ABI/testing/sysfs-firmware-sfi
> @@ -9,7 +9,7 @@ Description:
>  		http://simplefirmware.org/documentation
>  
>  		While the tables are used by the kernel, user-space
> -		can observe them this way:
> +		can observe them this way::
>  
> -		# cd /sys/firmware/sfi/tables
> -		# cat $TABLENAME > $TABLENAME.bin
> +		  # cd /sys/firmware/sfi/tables
> +		  # cat $TABLENAME > $TABLENAME.bin
> diff --git a/Documentation/ABI/testing/sysfs-firmware-sgi_uv b/Documentation/ABI/testing/sysfs-firmware-sgi_uv
> index 4573fd4b7876..66800baab096 100644
> --- a/Documentation/ABI/testing/sysfs-firmware-sgi_uv
> +++ b/Documentation/ABI/testing/sysfs-firmware-sgi_uv
> @@ -5,7 +5,7 @@ Description:
>  		The /sys/firmware/sgi_uv directory contains information
>  		about the SGI UV platform.
>  
> -		Under that directory are a number of files:
> +		Under that directory are a number of files::
>  
>  			partition_id
>  			coherence_id
> @@ -14,7 +14,7 @@ Description:
>  		SGI UV systems can be partitioned into multiple physical
>  		machines, which each partition running a unique copy
>  		of the operating system.  Each partition will have a unique
> -		partition id.  To display the partition id, use the command:
> +		partition id.  To display the partition id, use the command::
>  
>  			cat /sys/firmware/sgi_uv/partition_id
>  
> @@ -22,6 +22,6 @@ Description:
>  		A partitioned SGI UV system can have one or more coherence
>  		domain.  The coherence id indicates which coherence domain
>  		this partition is in.  To display the coherence id, use the
> -		command:
> +		command::
>  
>  			cat /sys/firmware/sgi_uv/coherence_id
> diff --git a/Documentation/ABI/testing/sysfs-fs-f2fs b/Documentation/ABI/testing/sysfs-fs-f2fs
> index 834d0becae6d..67b3ed8e8c2f 100644
> --- a/Documentation/ABI/testing/sysfs-fs-f2fs
> +++ b/Documentation/ABI/testing/sysfs-fs-f2fs
> @@ -20,10 +20,13 @@ What:		/sys/fs/f2fs/<disk>/gc_idle
>  Date:		July 2013
>  Contact:	"Namjae Jeon" <namjae.jeon@samsung.com>
>  Description:	Controls the victim selection policy for garbage collection.
> -		Setting gc_idle = 0(default) will disable this option. Setting
> -		gc_idle = 1 will select the Cost Benefit approach & setting
> -		gc_idle = 2 will select the greedy approach & setting
> -		gc_idle = 3 will select the age-threshold based approach.
> +		Setting gc_idle = 0(default) will disable this option. Setting:
> +
> +		===========  ===============================================
> +		gc_idle = 1  will select the Cost Benefit approach & setting
> +		gc_idle = 2  will select the greedy approach & setting
> +		gc_idle = 3  will select the age-threshold based approach.
> +		===========  ===============================================
>  
>  What:		/sys/fs/f2fs/<disk>/reclaim_segments
>  Date:		October 2013
> @@ -46,10 +49,17 @@ Date:		November 2013
>  Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
>  Description:	Controls the in-place-update policy.
>  		updates in f2fs. User can set:
> -		0x01: F2FS_IPU_FORCE, 0x02: F2FS_IPU_SSR,
> -		0x04: F2FS_IPU_UTIL,  0x08: F2FS_IPU_SSR_UTIL,
> -		0x10: F2FS_IPU_FSYNC, 0x20: F2FS_IPU_ASYNC,
> -		0x40: F2FS_IPU_NOCACHE.
> +
> +		====  =================
> +		0x01  F2FS_IPU_FORCE
> +		0x02  F2FS_IPU_SSR
> +		0x04  F2FS_IPU_UTIL
> +		0x08  F2FS_IPU_SSR_UTIL
> +		0x10  F2FS_IPU_FSYNC
> +		0x20  F2FS_IPU_ASYNC,
> +		0x40  F2FS_IPU_NOCACHE
> +		====  =================
> +
>  		Refer segment.h for details.
>  
>  What:		/sys/fs/f2fs/<disk>/min_ipu_util
> @@ -332,18 +342,28 @@ Date:		April 2020
>  Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
>  Description:	Give a way to attach REQ_META|FUA to data writes
>  		given temperature-based bits. Now the bits indicate:
> -		*      REQ_META     |      REQ_FUA      |
> -		*    5 |    4 |   3 |    2 |    1 |   0 |
> -		* Cold | Warm | Hot | Cold | Warm | Hot |
> +
> +		+-------------------+-------------------+
> +		|      REQ_META     |      REQ_FUA      |
> +		+------+------+-----+------+------+-----+
> +		|    5 |    4 |   3 |    2 |    1 |   0 |
> +		+------+------+-----+------+------+-----+
> +		| Cold | Warm | Hot | Cold | Warm | Hot |
> +		+------+------+-----+------+------+-----+
>  
>  What:		/sys/fs/f2fs/<disk>/node_io_flag
>  Date:		June 2020
>  Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
>  Description:	Give a way to attach REQ_META|FUA to node writes
>  		given temperature-based bits. Now the bits indicate:
> -		*      REQ_META     |      REQ_FUA      |
> -		*    5 |    4 |   3 |    2 |    1 |   0 |
> -		* Cold | Warm | Hot | Cold | Warm | Hot |
> +
> +		+-------------------+-------------------+
> +		|      REQ_META     |      REQ_FUA      |
> +		+------+------+-----+------+------+-----+
> +		|    5 |    4 |   3 |    2 |    1 |   0 |
> +		+------+------+-----+------+------+-----+
> +		| Cold | Warm | Hot | Cold | Warm | Hot |
> +		+------+------+-----+------+------+-----+
>  
>  What:		/sys/fs/f2fs/<disk>/iostat_period_ms
>  Date:		April 2020
> diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-ksm b/Documentation/ABI/testing/sysfs-kernel-mm-ksm
> index dfc13244cda3..1c9bed5595f5 100644
> --- a/Documentation/ABI/testing/sysfs-kernel-mm-ksm
> +++ b/Documentation/ABI/testing/sysfs-kernel-mm-ksm
> @@ -34,8 +34,9 @@ Description:	Kernel Samepage Merging daemon sysfs interface
>  		in a tree.
>  
>  		run: write 0 to disable ksm, read 0 while ksm is disabled.
> -			write 1 to run ksm, read 1 while ksm is running.
> -			write 2 to disable ksm and unmerge all its pages.
> +
> +			- write 1 to run ksm, read 1 while ksm is running.
> +			- write 2 to disable ksm and unmerge all its pages.
>  
>  		sleep_millisecs: how many milliseconds ksm should sleep between
>  		scans.
> diff --git a/Documentation/ABI/testing/sysfs-kernel-slab b/Documentation/ABI/testing/sysfs-kernel-slab
> index ed35833ad7f0..c9f12baf8baa 100644
> --- a/Documentation/ABI/testing/sysfs-kernel-slab
> +++ b/Documentation/ABI/testing/sysfs-kernel-slab
> @@ -346,6 +346,7 @@ Description:
>  		number of objects per slab.  If a slab cannot be allocated
>  		because of fragmentation, SLUB will retry with the minimum order
>  		possible depending on its characteristics.
> +
>  		When debug_guardpage_minorder=N (N > 0) parameter is specified
>  		(see Documentation/admin-guide/kernel-parameters.rst), the minimum possible
>  		order is used and this sysfs entry can not be used to change
> @@ -361,6 +362,7 @@ Description:
>  		new slab has not been possible at the cache's order and instead
>  		fallen back to its minimum possible order.  It can be written to
>  		clear the current count.
> +
>  		Available when CONFIG_SLUB_STATS is enabled.
>  
>  What:		/sys/kernel/slab/cache/partial
> @@ -410,6 +412,7 @@ Description:
>  		slab from a remote node as opposed to allocating a new slab on
>  		the local node.  This reduces the amount of wasted memory over
>  		the entire system but can be expensive.
> +
>  		Available when CONFIG_NUMA is enabled.
>  
>  What:		/sys/kernel/slab/cache/sanity_checks
> diff --git a/Documentation/ABI/testing/sysfs-module b/Documentation/ABI/testing/sysfs-module
> index 0aac02e7fb0e..353c0db5bc1f 100644
> --- a/Documentation/ABI/testing/sysfs-module
> +++ b/Documentation/ABI/testing/sysfs-module
> @@ -17,14 +17,15 @@ KernelVersion:	3.1
>  Contact:	Kirill Smelkov <kirr@mns.spb.ru>
>  Description:	Maximum time allowed for periodic transfers per microframe (μs)
>  
> -		[ USB 2.0 sets maximum allowed time for periodic transfers per
> +		Note:
> +		  USB 2.0 sets maximum allowed time for periodic transfers per
>  		  microframe to be 80%, that is 100 microseconds out of 125
>  		  microseconds (full microframe).
>  
>  		  However there are cases, when 80% max isochronous bandwidth is
>  		  too limiting. For example two video streams could require 110
>  		  microseconds of isochronous bandwidth per microframe to work
> -		  together. ]
> +		  together. 
>  
>  		Through this setting it is possible to raise the limit so that
>  		the host controller would allow allocating more than 100
> @@ -45,8 +46,10 @@ Date:		Jan 2012
>  KernelVersion:»·3.3
>  Contact:	Kay Sievers <kay.sievers@vrfy.org>
>  Description:	Module taint flags:
> -			P - proprietary module
> -			O - out-of-tree module
> -			F - force-loaded module
> -			C - staging driver module
> -			E - unsigned module
> +			==  =====================
> +			P   proprietary module
> +			O   out-of-tree module
> +			F   force-loaded module
> +			C   staging driver module
> +			E   unsigned module
> +			==  =====================
> diff --git a/Documentation/ABI/testing/sysfs-platform-dell-laptop b/Documentation/ABI/testing/sysfs-platform-dell-laptop
> index 9b917c7453de..82bcfe9df66e 100644
> --- a/Documentation/ABI/testing/sysfs-platform-dell-laptop
> +++ b/Documentation/ABI/testing/sysfs-platform-dell-laptop
> @@ -34,9 +34,12 @@ Description:
>  		this file. To disable a trigger, write its name preceded
>  		by '-' instead.
>  
> -		For example, to enable the keyboard as trigger run:
> +		For example, to enable the keyboard as trigger run::
> +
>  		    echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
> -		To disable it:
> +
> +		To disable it::
> +
>  		    echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
>  
>  		Note that not all the available triggers can be configured.
> @@ -57,7 +60,8 @@ Description:
>  		with any the above units. If no unit is specified, the value
>  		is assumed to be expressed in seconds.
>  
> -		For example, to set the timeout to 10 minutes run:
> +		For example, to set the timeout to 10 minutes run::
> +
>  		    echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout
>  
>  		Note that when this file is read, the returned value might be
> diff --git a/Documentation/ABI/testing/sysfs-platform-dell-smbios b/Documentation/ABI/testing/sysfs-platform-dell-smbios
> index 205d3b6361e0..e6e0f7f834a7 100644
> --- a/Documentation/ABI/testing/sysfs-platform-dell-smbios
> +++ b/Documentation/ABI/testing/sysfs-platform-dell-smbios
> @@ -13,8 +13,8 @@ Description:
>  		For example the token ID "5" would be available
>  		as the following attributes:
>  
> -		0005_location
> -		0005_value
> +		- 0005_location
> +		- 0005_value
>  
>  		Tokens will vary from machine to machine, and
>  		only tokens available on that machine will be
> diff --git a/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl b/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl
> index c394b808be19..b6a138b50d99 100644
> --- a/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl
> +++ b/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl
> @@ -5,9 +5,9 @@ Contact:	Wolfram Sang <wsa+renesas@sang-engineering.com>
>  Description:
>  		Reading the file will give you a list of masters which can be
>  		selected for a demultiplexed bus. The format is
> -		"<index>:<name>". Example from a Renesas Lager board:
> +		"<index>:<name>". Example from a Renesas Lager board::
>  
> -		0:/i2c@e6500000 1:/i2c@e6508000
> +		  0:/i2c@e6500000 1:/i2c@e6508000
>  
>  What:		/sys/devices/platform/<i2c-demux-name>/current_master
>  Date:		January 2016
> diff --git a/Documentation/ABI/testing/sysfs-platform-kim b/Documentation/ABI/testing/sysfs-platform-kim
> index c1653271872a..a7f81de68046 100644
> --- a/Documentation/ABI/testing/sysfs-platform-kim
> +++ b/Documentation/ABI/testing/sysfs-platform-kim
> @@ -5,6 +5,7 @@ Contact:	"Pavan Savoy" <pavan_savoy@ti.com>
>  Description:
>  		Name of the UART device at which the WL128x chip
>  		is connected. example: "/dev/ttyS0".
> +
>  		The device name flows down to architecture specific board
>  		initialization file from the SFI/ATAGS bootloader
>  		firmware. The name exposed is read from the user-space
> diff --git a/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2 b/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2
> index 6212697bbf6f..bc510ccc37a7 100644
> --- a/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2
> +++ b/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2
> @@ -7,9 +7,11 @@ Description:
>  		The file can show/change the phy mode for role swap of usb.
>  
>  		Write the following strings to change the mode:
> -		 "host" - switching mode from peripheral to host.
> -		 "peripheral" - switching mode from host to peripheral.
> +
> +		 - "host" - switching mode from peripheral to host.
> +		 - "peripheral" - switching mode from host to peripheral.
>  
>  		Read the file, then it shows the following strings:
> -		 "host" - The mode is host now.
> -		 "peripheral" - The mode is peripheral now.
> +
> +		 - "host" - The mode is host now.
> +		 - "peripheral" - The mode is peripheral now.
> diff --git a/Documentation/ABI/testing/sysfs-platform-renesas_usb3 b/Documentation/ABI/testing/sysfs-platform-renesas_usb3
> index 5621c15d5dc0..8af5b9c3fabb 100644
> --- a/Documentation/ABI/testing/sysfs-platform-renesas_usb3
> +++ b/Documentation/ABI/testing/sysfs-platform-renesas_usb3
> @@ -7,9 +7,11 @@ Description:
>  		The file can show/change the drd mode of usb.
>  
>  		Write the following string to change the mode:
> -		 "host" - switching mode from peripheral to host.
> -		 "peripheral" - switching mode from host to peripheral.
> +
> +		- "host" - switching mode from peripheral to host.
> +		- "peripheral" - switching mode from host to peripheral.
>  
>  		Read the file, then it shows the following strings:
> -		 "host" - The mode is host now.
> -		 "peripheral" - The mode is peripheral now.
> +		
> +		- "host" - The mode is host now.
> +		- "peripheral" - The mode is peripheral now.
> diff --git a/Documentation/ABI/testing/sysfs-power b/Documentation/ABI/testing/sysfs-power
> index 5e6ead29124c..51c0f578bfce 100644
> --- a/Documentation/ABI/testing/sysfs-power
> +++ b/Documentation/ABI/testing/sysfs-power
> @@ -47,14 +47,18 @@ Description:
>  		suspend-to-disk mechanism.  Reading from this file returns
>  		the name of the method by which the system will be put to
>  		sleep on the next suspend.  There are four methods supported:
> +
>  		'firmware' - means that the memory image will be saved to disk
>  		by some firmware, in which case we also assume that the
>  		firmware will handle the system suspend.
> +
>  		'platform' - the memory image will be saved by the kernel and
>  		the system will be put to sleep by the platform driver (e.g.
>  		ACPI or other PM registers).
> +
>  		'shutdown' - the memory image will be saved by the kernel and
>  		the system will be powered off.
> +
>  		'reboot' - the memory image will be saved by the kernel and
>  		the system will be rebooted.
>  
> @@ -74,12 +78,12 @@ Description:
>  		The suspend-to-disk method may be chosen by writing to this
>  		file one of the accepted strings:
>  
> -		'firmware'
> -		'platform'
> -		'shutdown'
> -		'reboot'
> -		'testproc'
> -		'test'
> +		- 'firmware'
> +		- 'platform'
> +		- 'shutdown'
> +		- 'reboot'
> +		- 'testproc'
> +		- 'test'
>  
>  		It will only change to 'firmware' or 'platform' if the system
>  		supports that.
> @@ -114,9 +118,9 @@ Description:
>  		string representing a nonzero integer into it.
>  
>  		To use this debugging feature you should attempt to suspend
> -		the machine, then reboot it and run
> +		the machine, then reboot it and run::
>  
> -		dmesg -s 1000000 | grep 'hash matches'
> +		  dmesg -s 1000000 | grep 'hash matches'
>  
>  		If you do not get any matches (or they appear to be false
>  		positives), it is possible that the last PM event point
> @@ -244,6 +248,7 @@ Description:
>  		wakeup sources created with the help of /sys/power/wake_lock.
>  		When a string is written to /sys/power/wake_unlock, it will be
>  		assumed to represent the name of a wakeup source to deactivate.
> +
>  		If a wakeup source object of that name exists and is active at
>  		the moment, it will be deactivated.
>  
> diff --git a/Documentation/ABI/testing/sysfs-profiling b/Documentation/ABI/testing/sysfs-profiling
> index 8a8e466eb2c0..e39dd3a0ceef 100644
> --- a/Documentation/ABI/testing/sysfs-profiling
> +++ b/Documentation/ABI/testing/sysfs-profiling
> @@ -5,7 +5,7 @@ Description:
>  		/sys/kernel/profiling is the runtime equivalent
>  		of the boot-time profile= option.
>  
> -		You can get the same effect running:
> +		You can get the same effect running::
>  
>  			echo 2 > /sys/kernel/profiling
>  
> diff --git a/Documentation/ABI/testing/sysfs-wusb_cbaf b/Documentation/ABI/testing/sysfs-wusb_cbaf
> index a99c5f86a37a..2969d3694ec0 100644
> --- a/Documentation/ABI/testing/sysfs-wusb_cbaf
> +++ b/Documentation/ABI/testing/sysfs-wusb_cbaf
> @@ -45,7 +45,8 @@ Description:
>                  7. Device is unplugged.
>  
>                  References:
> -                  [WUSB-AM] Association Models Supplement to the
> +                  [WUSB-AM]
> +			    Association Models Supplement to the
>                              Certified Wireless Universal Serial Bus
>                              Specification, version 1.0.
>  
> diff --git a/Documentation/ABI/testing/usb-charger-uevent b/Documentation/ABI/testing/usb-charger-uevent
> index 419a92dd0d86..1db89b0cf80f 100644
> --- a/Documentation/ABI/testing/usb-charger-uevent
> +++ b/Documentation/ABI/testing/usb-charger-uevent
> @@ -3,44 +3,52 @@ Date:		2020-01-14
>  KernelVersion:	5.6
>  Contact:	linux-usb@vger.kernel.org
>  Description:	There are two USB charger states:
> -		USB_CHARGER_ABSENT
> -		USB_CHARGER_PRESENT
> +
> +		- USB_CHARGER_ABSENT
> +		- USB_CHARGER_PRESENT
> +
>  		There are five USB charger types:
> -		USB_CHARGER_UNKNOWN_TYPE: Charger type is unknown
> -		USB_CHARGER_SDP_TYPE: Standard Downstream Port
> -		USB_CHARGER_CDP_TYPE: Charging Downstream Port
> -		USB_CHARGER_DCP_TYPE: Dedicated Charging Port
> -		USB_CHARGER_ACA_TYPE: Accessory Charging Adapter
> +
> +		========================  ==========================
> +		USB_CHARGER_UNKNOWN_TYPE  Charger type is unknown
> +		USB_CHARGER_SDP_TYPE      Standard Downstream Port
> +		USB_CHARGER_CDP_TYPE      Charging Downstream Port
> +		USB_CHARGER_DCP_TYPE      Dedicated Charging Port
> +		USB_CHARGER_ACA_TYPE      Accessory Charging Adapter
> +		========================  ==========================
> +
>  		https://www.usb.org/document-library/battery-charging-v12-spec-and-adopters-agreement
>  
> -		Here are two examples taken using udevadm monitor -p when
> -		USB charger is online:
> -		UDEV  change   /devices/soc0/usbphynop1 (platform)
> -		ACTION=change
> -		DEVPATH=/devices/soc0/usbphynop1
> -		DRIVER=usb_phy_generic
> -		MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
> -		OF_COMPATIBLE_0=usb-nop-xceiv
> -		OF_COMPATIBLE_N=1
> -		OF_FULLNAME=/usbphynop1
> -		OF_NAME=usbphynop1
> -		SEQNUM=2493
> -		SUBSYSTEM=platform
> -		USB_CHARGER_STATE=USB_CHARGER_PRESENT
> -		USB_CHARGER_TYPE=USB_CHARGER_SDP_TYPE
> -		USEC_INITIALIZED=227422826
> +		Here are two examples taken using ``udevadm monitor -p`` when
> +		USB charger is online::
>  
> -		USB charger is offline:
> -		KERNEL change   /devices/soc0/usbphynop1 (platform)
> -		ACTION=change
> -		DEVPATH=/devices/soc0/usbphynop1
> -		DRIVER=usb_phy_generic
> -		MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
> -		OF_COMPATIBLE_0=usb-nop-xceiv
> -		OF_COMPATIBLE_N=1
> -		OF_FULLNAME=/usbphynop1
> -		OF_NAME=usbphynop1
> -		SEQNUM=2494
> -		SUBSYSTEM=platform
> -		USB_CHARGER_STATE=USB_CHARGER_ABSENT
> -		USB_CHARGER_TYPE=USB_CHARGER_UNKNOWN_TYPE
> +		    UDEV  change   /devices/soc0/usbphynop1 (platform)
> +		    ACTION=change
> +		    DEVPATH=/devices/soc0/usbphynop1
> +		    DRIVER=usb_phy_generic
> +		    MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
> +		    OF_COMPATIBLE_0=usb-nop-xceiv
> +		    OF_COMPATIBLE_N=1
> +		    OF_FULLNAME=/usbphynop1
> +		    OF_NAME=usbphynop1
> +		    SEQNUM=2493
> +		    SUBSYSTEM=platform
> +		    USB_CHARGER_STATE=USB_CHARGER_PRESENT
> +		    USB_CHARGER_TYPE=USB_CHARGER_SDP_TYPE
> +		    USEC_INITIALIZED=227422826
> +
> +		USB charger is offline::
> +
> +		    KERNEL change   /devices/soc0/usbphynop1 (platform)
> +		    ACTION=change
> +		    DEVPATH=/devices/soc0/usbphynop1
> +		    DRIVER=usb_phy_generic
> +		    MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
> +		    OF_COMPATIBLE_0=usb-nop-xceiv
> +		    OF_COMPATIBLE_N=1
> +		    OF_FULLNAME=/usbphynop1
> +		    OF_NAME=usbphynop1
> +		    SEQNUM=2494
> +		    SUBSYSTEM=platform
> +		    USB_CHARGER_STATE=USB_CHARGER_ABSENT
> +		    USB_CHARGER_TYPE=USB_CHARGER_UNKNOWN_TYPE
> diff --git a/Documentation/ABI/testing/usb-uevent b/Documentation/ABI/testing/usb-uevent
> index d35c3cad892c..2b8eca4bf2b1 100644
> --- a/Documentation/ABI/testing/usb-uevent
> +++ b/Documentation/ABI/testing/usb-uevent
> @@ -6,22 +6,22 @@ Description:	When the USB Host Controller has entered a state where it is no
>  		longer functional a uevent will be raised. The uevent will
>  		contain ACTION=offline and ERROR=DEAD.
>  
> -		Here is an example taken using udevadm monitor -p:
> +		Here is an example taken using udevadm monitor -p::
>  
> -		KERNEL[130.428945] offline  /devices/pci0000:00/0000:00:10.0/usb2 (usb)
> -		ACTION=offline
> -		BUSNUM=002
> -		DEVNAME=/dev/bus/usb/002/001
> -		DEVNUM=001
> -		DEVPATH=/devices/pci0000:00/0000:00:10.0/usb2
> -		DEVTYPE=usb_device
> -		DRIVER=usb
> -		ERROR=DEAD
> -		MAJOR=189
> -		MINOR=128
> -		PRODUCT=1d6b/2/414
> -		SEQNUM=2168
> -		SUBSYSTEM=usb
> -		TYPE=9/0/1
> +		    KERNEL[130.428945] offline  /devices/pci0000:00/0000:00:10.0/usb2 (usb)
> +		    ACTION=offline
> +		    BUSNUM=002
> +		    DEVNAME=/dev/bus/usb/002/001
> +		    DEVNUM=001
> +		    DEVPATH=/devices/pci0000:00/0000:00:10.0/usb2
> +		    DEVTYPE=usb_device
> +		    DRIVER=usb
> +		    ERROR=DEAD
> +		    MAJOR=189
> +		    MINOR=128
> +		    PRODUCT=1d6b/2/414
> +		    SEQNUM=2168
> +		    SUBSYSTEM=usb
> +		    TYPE=9/0/1
>  
>  Users:		chromium-os-dev@chromium.org
> diff --git a/scripts/get_abi.pl b/scripts/get_abi.pl
> index 413349789145..bdef3e5c35c7 100755
> --- a/scripts/get_abi.pl
> +++ b/scripts/get_abi.pl
> @@ -316,8 +316,6 @@ sub output_rest {
>  				$len = length($name) if (length($name) > $len);
>  			}
>  
> -			print "What:\n\n";
> -
>  			print "+-" . "-" x $len . "-+\n";
>  			foreach my $name (@names) {
>  				printf "| %s", $name . " " x ($len - length($name)) . " |\n";
kajoljain Oct. 29, 2020, 3:29 p.m. UTC | #2
On 10/29/20 8:12 PM, Jonathan Cameron wrote:
> On Wed, 28 Oct 2020 15:23:28 +0100
> Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> 
>> There are some ABI documents that, while they don't generate
>> any warnings, they have issues when parsed by get_abi.pl script
>> on its output result.
>>
>> Address them, in order to provide a clean output.
>>
>> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
> 
> All the IIO ones look sensible.  Thanks
> 
> Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for IIO

Those nit changes for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7 looks fine to me.

Reviewed-By: Kajol Jain<kjain@linux.ibm.com>

Thanks,
Kajol Jain

> 
>> ---
>>  Documentation/ABI/obsolete/sysfs-class-dax    |   8 +-
>>  .../ABI/obsolete/sysfs-driver-hid-roccat-pyra |   3 +
>>  Documentation/ABI/removed/devfs               |   1 +
>>  Documentation/ABI/removed/raw1394             |   1 +
>>  Documentation/ABI/removed/sysfs-class-rfkill  |   2 +-
>>  Documentation/ABI/removed/video1394           |   1 +
>>  Documentation/ABI/stable/firewire-cdev        |  63 ++---
>>  Documentation/ABI/stable/sysfs-acpi-pmprofile |   4 +-
>>  Documentation/ABI/stable/sysfs-bus-w1         |   1 +
>>  Documentation/ABI/stable/sysfs-class-tpm      |   4 +-
>>  Documentation/ABI/stable/sysfs-driver-speakup |   4 +
>>  Documentation/ABI/testing/configfs-most       | 135 +++++++----
>>  .../ABI/testing/configfs-usb-gadget-ecm       |  12 +-
>>  .../ABI/testing/configfs-usb-gadget-eem       |  10 +-
>>  .../ABI/testing/configfs-usb-gadget-loopback  |   6 +-
>>  .../testing/configfs-usb-gadget-mass-storage  |  18 +-
>>  .../ABI/testing/configfs-usb-gadget-midi      |  14 +-
>>  .../ABI/testing/configfs-usb-gadget-printer   |   6 +-
>>  .../testing/configfs-usb-gadget-sourcesink    |  18 +-
>>  .../ABI/testing/configfs-usb-gadget-subset    |  10 +-
>>  .../ABI/testing/configfs-usb-gadget-uac2      |  14 +-
>>  .../ABI/testing/configfs-usb-gadget-uvc       |   2 +-
>>  .../ABI/testing/debugfs-cec-error-inj         |   2 +-
>>  .../ABI/testing/debugfs-driver-habanalabs     |  12 +-
>>  .../ABI/testing/debugfs-pfo-nx-crypto         |  28 +--
>>  Documentation/ABI/testing/debugfs-pktcdvd     |   2 +-
>>  .../ABI/testing/debugfs-turris-mox-rwtm       |  10 +-
>>  Documentation/ABI/testing/debugfs-wilco-ec    |  21 +-
>>  Documentation/ABI/testing/dell-smbios-wmi     |  32 +--
>>  Documentation/ABI/testing/gpio-cdev           |  13 +-
>>  Documentation/ABI/testing/procfs-diskstats    |   6 +-
>>  Documentation/ABI/testing/procfs-smaps_rollup |  48 ++--
>>  Documentation/ABI/testing/pstore              |  19 +-
>>  Documentation/ABI/testing/sysfs-block-rnbd    |   4 +-
>>  Documentation/ABI/testing/sysfs-bus-acpi      |   1 +
>>  .../testing/sysfs-bus-coresight-devices-etb10 |   5 +-
>>  Documentation/ABI/testing/sysfs-bus-css       |   3 +
>>  Documentation/ABI/testing/sysfs-bus-dfl       |   2 +
>>  .../sysfs-bus-event_source-devices-hv_24x7    |   6 +-
>>  .../sysfs-bus-event_source-devices-hv_gpci    |   7 +-
>>  Documentation/ABI/testing/sysfs-bus-fcoe      |  68 ++++--
>>  Documentation/ABI/testing/sysfs-bus-fsl-mc    |  12 +-
>>  .../ABI/testing/sysfs-bus-i2c-devices-fsa9480 |  26 +-
>>  Documentation/ABI/testing/sysfs-bus-i3c       |   2 +
>>  Documentation/ABI/testing/sysfs-bus-iio       |  19 +-
>>  .../ABI/testing/sysfs-bus-iio-adc-hi8435      |   5 +
>>  .../ABI/testing/sysfs-bus-iio-adc-stm32       |   3 +
>>  .../ABI/testing/sysfs-bus-iio-distance-srf08  |   7 +-
>>  .../testing/sysfs-bus-iio-frequency-ad9523    |   2 +
>>  .../testing/sysfs-bus-iio-frequency-adf4371   |  10 +-
>>  .../ABI/testing/sysfs-bus-iio-health-afe440x  |  12 +-
>>  .../ABI/testing/sysfs-bus-iio-light-isl29018  |   6 +-
>>  .../testing/sysfs-bus-intel_th-devices-gth    |  11 +-
>>  Documentation/ABI/testing/sysfs-bus-papr-pmem |  23 +-
>>  Documentation/ABI/testing/sysfs-bus-pci       |  22 +-
>>  .../ABI/testing/sysfs-bus-pci-devices-catpt   |   1 +
>>  .../testing/sysfs-bus-pci-drivers-ehci_hcd    |   4 +-
>>  Documentation/ABI/testing/sysfs-bus-rbd       |  37 ++-
>>  Documentation/ABI/testing/sysfs-bus-siox      |   3 +
>>  .../ABI/testing/sysfs-bus-thunderbolt         |  18 +-
>>  Documentation/ABI/testing/sysfs-bus-usb       |   2 +
>>  .../sysfs-class-backlight-driver-lm3533       |  26 +-
>>  Documentation/ABI/testing/sysfs-class-bdi     |   1 -
>>  .../ABI/testing/sysfs-class-chromeos          |  15 +-
>>  Documentation/ABI/testing/sysfs-class-cxl     |   8 +-
>>  Documentation/ABI/testing/sysfs-class-devlink |  30 ++-
>>  Documentation/ABI/testing/sysfs-class-extcon  |  34 +--
>>  .../ABI/testing/sysfs-class-fpga-manager      |   5 +-
>>  Documentation/ABI/testing/sysfs-class-gnss    |   2 +
>>  Documentation/ABI/testing/sysfs-class-led     |   1 +
>>  .../testing/sysfs-class-led-driver-el15203000 |  30 +--
>>  .../ABI/testing/sysfs-class-led-driver-lm3533 |  44 ++--
>>  .../ABI/testing/sysfs-class-led-flash         |  27 ++-
>>  .../testing/sysfs-class-led-trigger-netdev    |   7 +
>>  .../testing/sysfs-class-led-trigger-usbport   |   1 +
>>  .../ABI/testing/sysfs-class-leds-gt683r       |   8 +-
>>  Documentation/ABI/testing/sysfs-class-net     |  61 +++--
>>  .../ABI/testing/sysfs-class-net-cdc_ncm       |   6 +-
>>  .../ABI/testing/sysfs-class-net-phydev        |   2 +
>>  Documentation/ABI/testing/sysfs-class-pktcdvd |  36 +--
>>  Documentation/ABI/testing/sysfs-class-power   |  12 +-
>>  .../ABI/testing/sysfs-class-power-mp2629      |   1 +
>>  .../ABI/testing/sysfs-class-power-twl4030     |   4 +-
>>  Documentation/ABI/testing/sysfs-class-rapidio |  46 ++--
>>  .../ABI/testing/sysfs-class-regulator         |  36 +--
>>  .../ABI/testing/sysfs-class-remoteproc        |  14 +-
>>  ...ysfs-class-rtc-rtc0-device-rtc_calibration |   1 +
>>  Documentation/ABI/testing/sysfs-class-uwb_rc  |  13 +-
>>  .../ABI/testing/sysfs-class-watchdog          |   7 +-
>>  Documentation/ABI/testing/sysfs-dev           |   7 +-
>>  .../ABI/testing/sysfs-devices-mapping         |  41 ++--
>>  .../ABI/testing/sysfs-devices-memory          |  15 +-
>>  .../sysfs-devices-platform-_UDC_-gadget       |  10 +-
>>  .../ABI/testing/sysfs-devices-platform-ipmi   |  52 ++--
>>  .../ABI/testing/sysfs-devices-system-cpu      |   4 +-
>>  .../ABI/testing/sysfs-driver-hid-lenovo       |  10 +
>>  .../ABI/testing/sysfs-driver-hid-ntrig        |  13 +-
>>  .../ABI/testing/sysfs-driver-hid-roccat-kone  |  19 ++
>>  .../ABI/testing/sysfs-driver-hid-wiimote      |   1 +
>>  .../ABI/testing/sysfs-driver-input-exc3000    |   2 +
>>  .../ABI/testing/sysfs-driver-jz4780-efuse     |   6 +-
>>  .../ABI/testing/sysfs-driver-pciback          |   6 +-
>>  Documentation/ABI/testing/sysfs-driver-ufs    | 228 ++++++++++++++----
>>  .../ABI/testing/sysfs-driver-w1_ds28e17       |   3 +
>>  Documentation/ABI/testing/sysfs-firmware-acpi |  16 +-
>>  .../ABI/testing/sysfs-firmware-efi-esrt       |  28 ++-
>>  .../testing/sysfs-firmware-efi-runtime-map    |  14 +-
>>  .../ABI/testing/sysfs-firmware-qemu_fw_cfg    |  20 +-
>>  Documentation/ABI/testing/sysfs-firmware-sfi  |   6 +-
>>  .../ABI/testing/sysfs-firmware-sgi_uv         |   6 +-
>>  Documentation/ABI/testing/sysfs-fs-f2fs       |  48 ++--
>>  Documentation/ABI/testing/sysfs-kernel-mm-ksm |   5 +-
>>  Documentation/ABI/testing/sysfs-kernel-slab   |   3 +
>>  Documentation/ABI/testing/sysfs-module        |  17 +-
>>  .../ABI/testing/sysfs-platform-dell-laptop    |  10 +-
>>  .../ABI/testing/sysfs-platform-dell-smbios    |   4 +-
>>  .../testing/sysfs-platform-i2c-demux-pinctrl  |   4 +-
>>  Documentation/ABI/testing/sysfs-platform-kim  |   1 +
>>  .../testing/sysfs-platform-phy-rcar-gen3-usb2 |  10 +-
>>  .../ABI/testing/sysfs-platform-renesas_usb3   |  10 +-
>>  Documentation/ABI/testing/sysfs-power         |  21 +-
>>  Documentation/ABI/testing/sysfs-profiling     |   2 +-
>>  Documentation/ABI/testing/sysfs-wusb_cbaf     |   3 +-
>>  Documentation/ABI/testing/usb-charger-uevent  |  82 ++++---
>>  Documentation/ABI/testing/usb-uevent          |  32 +--
>>  scripts/get_abi.pl                            |   2 -
>>  126 files changed, 1323 insertions(+), 767 deletions(-)
>>
>> diff --git a/Documentation/ABI/obsolete/sysfs-class-dax b/Documentation/ABI/obsolete/sysfs-class-dax
>> index 2cb9fc5e8bd1..0faf1354cd05 100644
>> --- a/Documentation/ABI/obsolete/sysfs-class-dax
>> +++ b/Documentation/ABI/obsolete/sysfs-class-dax
>> @@ -8,11 +8,11 @@ Description:	Device DAX is the device-centric analogue of Filesystem
>>  		system.  Device DAX is strict, precise and predictable.
>>  		Specifically this interface:
>>  
>> -		1/ Guarantees fault granularity with respect to a given
>> -		page size (pte, pmd, or pud) set at configuration time.
>> +		1. Guarantees fault granularity with respect to a given
>> +		   page size (pte, pmd, or pud) set at configuration time.
>>  
>> -		2/ Enforces deterministic behavior by being strict about
>> -		what fault scenarios are supported.
>> +		2. Enforces deterministic behavior by being strict about
>> +		   what fault scenarios are supported.
>>  
>>  		The /sys/class/dax/ interface enumerates all the
>>  		device-dax instances in the system. The ABI is
>> diff --git a/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra b/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
>> index 5d41ebadf15e..66545c587a64 100644
>> --- a/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
>> +++ b/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
>> @@ -7,10 +7,13 @@ Description:	It is possible to switch the cpi setting of the mouse with the
>>  		setting reported by the mouse. This number has to be further
>>  		processed to receive the real dpi value:
>>  
>> +		===== ====
>>  		VALUE DPI
>> +		===== ====
>>  		1     400
>>  		2     800
>>  		4     1600
>> +		===== ====
>>  
>>  		This file is readonly.
>>  		Has never been used. If bookkeeping is done, it's done in userland tools.
>> diff --git a/Documentation/ABI/removed/devfs b/Documentation/ABI/removed/devfs
>> index 0020c49933c4..24fb35adf277 100644
>> --- a/Documentation/ABI/removed/devfs
>> +++ b/Documentation/ABI/removed/devfs
>> @@ -5,6 +5,7 @@ Description:
>>  	devfs has been unmaintained for a number of years, has unfixable
>>  	races, contains a naming policy within the kernel that is
>>  	against the LSB, and can be replaced by using udev.
>> +
>>  	The files fs/devfs/*, include/linux/devfs_fs*.h were removed,
>>  	along with the assorted devfs function calls throughout the
>>  	kernel tree.
>> diff --git a/Documentation/ABI/removed/raw1394 b/Documentation/ABI/removed/raw1394
>> index ec333e676322..9ec7ec493920 100644
>> --- a/Documentation/ABI/removed/raw1394
>> +++ b/Documentation/ABI/removed/raw1394
>> @@ -7,6 +7,7 @@ Description:
>>  	to implement sensible device security policies, and its low level
>>  	of abstraction that required userspace clients to duplicate much
>>  	of the kernel's ieee1394 core functionality.
>> +
>>  	Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of
>>  	firewire-core.
>>  
>> diff --git a/Documentation/ABI/removed/sysfs-class-rfkill b/Documentation/ABI/removed/sysfs-class-rfkill
>> index 9c08c7f98ffb..f25174eafd55 100644
>> --- a/Documentation/ABI/removed/sysfs-class-rfkill
>> +++ b/Documentation/ABI/removed/sysfs-class-rfkill
>> @@ -10,4 +10,4 @@ Description:	This file was deprecated because there no longer was a way to
>>  		claim just control over a single rfkill instance.
>>  		This file was scheduled to be removed in 2012, and was removed
>>  		in 2016.
>> -Values: 	0: Kernel handles events
>> +Values:		0: Kernel handles events
>> diff --git a/Documentation/ABI/removed/video1394 b/Documentation/ABI/removed/video1394
>> index c39c25aee77b..1905d35a6619 100644
>> --- a/Documentation/ABI/removed/video1394
>> +++ b/Documentation/ABI/removed/video1394
>> @@ -8,6 +8,7 @@ Description:
>>  	performance issues in its first generation.  Any video1394 user had
>>  	to use raw1394 + libraw1394 too because video1394 did not provide
>>  	asynchronous I/O for device discovery and configuration.
>> +
>>  	Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of
>>  	firewire-core.
>>  
>> diff --git a/Documentation/ABI/stable/firewire-cdev b/Documentation/ABI/stable/firewire-cdev
>> index c9e8ff026154..261f85b13154 100644
>> --- a/Documentation/ABI/stable/firewire-cdev
>> +++ b/Documentation/ABI/stable/firewire-cdev
>> @@ -16,6 +16,7 @@ Description:
>>  		different scope:
>>  
>>  		  - The 1394 node which is associated with the file:
>> +
>>  			  - Asynchronous request transmission
>>  			  - Get the Configuration ROM
>>  			  - Query node ID
>> @@ -23,6 +24,7 @@ Description:
>>  			    and local node
>>  
>>  		  - The 1394 bus (i.e. "card") to which the node is attached to:
>> +
>>  			  - Isochronous stream transmission and reception
>>  			  - Asynchronous stream transmission and reception
>>  			  - Asynchronous broadcast request transmission
>> @@ -35,6 +37,7 @@ Description:
>>  			  - Bus reset initiation, bus reset event reception
>>  
>>  		  - All 1394 buses:
>> +
>>  			  - Allocation of IEEE 1212 address ranges on the local
>>  			    link layers, reception of inbound requests to such
>>  			    an address range, asynchronous response transmission
>> @@ -59,50 +62,50 @@ Description:
>>  		The following file operations are supported:
>>  
>>  		open(2)
>> -		Currently the only useful flags are O_RDWR.
>> +		    Currently the only useful flags are O_RDWR.
>>  
>>  		ioctl(2)
>> -		Initiate various actions.  Some take immediate effect, others
>> -		are performed asynchronously while or after the ioctl returns.
>> -		See the inline documentation in <linux/firewire-cdev.h> for
>> -		descriptions of all ioctls.
>> +		    Initiate various actions.  Some take immediate effect, others
>> +		    are performed asynchronously while or after the ioctl returns.
>> +		    See the inline documentation in <linux/firewire-cdev.h> for
>> +		    descriptions of all ioctls.
>>  
>>  		poll(2), select(2), epoll_wait(2) etc.
>> -		Watch for events to become available to be read.
>> +		    Watch for events to become available to be read.
>>  
>>  		read(2)
>> -		Receive various events.  There are solicited events like
>> -		outbound asynchronous transaction completion or isochronous
>> -		buffer completion, and unsolicited events such as bus resets,
>> -		request reception, or PHY packet reception.  Always use a read
>> -		buffer which is large enough to receive the largest event that
>> -		could ever arrive.  See <linux/firewire-cdev.h> for descriptions
>> -		of all event types and for which ioctls affect reception of
>> -		events.
>> +		    Receive various events.  There are solicited events like
>> +		    outbound asynchronous transaction completion or isochronous
>> +		    buffer completion, and unsolicited events such as bus resets,
>> +		    request reception, or PHY packet reception.  Always use a read
>> +		    buffer which is large enough to receive the largest event that
>> +		    could ever arrive.  See <linux/firewire-cdev.h> for descriptions
>> +		    of all event types and for which ioctls affect reception of
>> +		    events.
>>  
>>  		mmap(2)
>> -		Allocate a DMA buffer for isochronous reception or transmission
>> -		and map it into the process address space.  The arguments should
>> -		be used as follows:  addr = NULL, length = the desired buffer
>> -		size, i.e. number of packets times size of largest packet,
>> -		prot = at least PROT_READ for reception and at least PROT_WRITE
>> -		for transmission, flags = MAP_SHARED, fd = the handle to the
>> -		/dev/fw*, offset = 0.
>> +		    Allocate a DMA buffer for isochronous reception or transmission
>> +		    and map it into the process address space.  The arguments should
>> +		    be used as follows:  addr = NULL, length = the desired buffer
>> +		    size, i.e. number of packets times size of largest packet,
>> +		    prot = at least PROT_READ for reception and at least PROT_WRITE
>> +		    for transmission, flags = MAP_SHARED, fd = the handle to the
>> +		    /dev/fw*, offset = 0.
>>  
>>  		Isochronous reception works in packet-per-buffer fashion except
>>  		for multichannel reception which works in buffer-fill mode.
>>  
>>  		munmap(2)
>> -		Unmap the isochronous I/O buffer from the process address space.
>> +		    Unmap the isochronous I/O buffer from the process address space.
>>  
>>  		close(2)
>> -		Besides stopping and freeing I/O contexts that were associated
>> -		with the file descriptor, back out any changes to the local
>> -		nodes' Configuration ROM.  Deallocate isochronous channels and
>> -		bandwidth at the IRM that were marked for kernel-assisted
>> -		re- and deallocation.
>> +		    Besides stopping and freeing I/O contexts that were associated
>> +		    with the file descriptor, back out any changes to the local
>> +		    nodes' Configuration ROM.  Deallocate isochronous channels and
>> +		    bandwidth at the IRM that were marked for kernel-assisted
>> +		    re- and deallocation.
>>  
>> -Users:		libraw1394
>> -		libdc1394
>> -		libhinawa
>> +Users:		libraw1394;
>> +		libdc1394;
>> +		libhinawa;
>>  		tools like linux-firewire-utils, fwhack, ...
>> diff --git a/Documentation/ABI/stable/sysfs-acpi-pmprofile b/Documentation/ABI/stable/sysfs-acpi-pmprofile
>> index fd97d22b677f..2d6314f0e4e4 100644
>> --- a/Documentation/ABI/stable/sysfs-acpi-pmprofile
>> +++ b/Documentation/ABI/stable/sysfs-acpi-pmprofile
>> @@ -1,8 +1,8 @@
>> -What: 		/sys/firmware/acpi/pm_profile
>> +What:		/sys/firmware/acpi/pm_profile
>>  Date:		03-Nov-2011
>>  KernelVersion:	v3.2
>>  Contact:	linux-acpi@vger.kernel.org
>> -Description: 	The ACPI pm_profile sysfs interface exports the platform
>> +Description:	The ACPI pm_profile sysfs interface exports the platform
>>  		power management (and performance) requirement expectations
>>  		as provided by BIOS. The integer value is directly passed as
>>  		retrieved from the FADT ACPI table.
>> diff --git a/Documentation/ABI/stable/sysfs-bus-w1 b/Documentation/ABI/stable/sysfs-bus-w1
>> index 992dfb183ed0..5cd5e872bcae 100644
>> --- a/Documentation/ABI/stable/sysfs-bus-w1
>> +++ b/Documentation/ABI/stable/sysfs-bus-w1
>> @@ -6,6 +6,7 @@ Description:	Bus scanning interval, microseconds component.
>>  		control systems are attached/generate presence for as short as
>>  		100 ms - hence the tens-to-hundreds milliseconds scan intervals
>>  		are required.
>> +
>>  		see Documentation/w1/w1-generic.rst for detailed information.
>>  Users:		any user space application which wants to know bus scanning
>>  		interval
>> diff --git a/Documentation/ABI/stable/sysfs-class-tpm b/Documentation/ABI/stable/sysfs-class-tpm
>> index ec464cf7861a..91ca63ec7581 100644
>> --- a/Documentation/ABI/stable/sysfs-class-tpm
>> +++ b/Documentation/ABI/stable/sysfs-class-tpm
>> @@ -191,6 +191,6 @@ Contact:	linux-integrity@vger.kernel.org
>>  Description:	The "tpm_version_major" property shows the TCG spec major version
>>  		implemented by the TPM device.
>>  
>> -		Example output:
>> +		Example output::
>>  
>> -		2
>> +		  2
>> diff --git a/Documentation/ABI/stable/sysfs-driver-speakup b/Documentation/ABI/stable/sysfs-driver-speakup
>> index c6a32c434ce9..792f58ba327d 100644
>> --- a/Documentation/ABI/stable/sysfs-driver-speakup
>> +++ b/Documentation/ABI/stable/sysfs-driver-speakup
>> @@ -69,6 +69,7 @@ Description:	Controls if typing interrupts output from speakup. With
>>  		speakup if for example
>>  		the say screen command is used before the
>>  		entire screen  is read.
>> +
>>  		With no_interrupt set to one, if the say
>>  		screen command is used, and one then types on the keyboard,
>>  		speakup will continue to say the whole screen regardless until
>> @@ -215,8 +216,10 @@ Description:	This file contains names for key states.
>>  		Again, these are part of the help system.  For instance, if you
>>  		had pressed speakup + keypad 3, you would hear:
>>  		"speakup keypad 3 is go to bottom edge."
>> +
>>  		The speakup key is depressed, so the name of the key state is
>>  		speakup.
>> +
>>  		This part of the message comes from the states collection.
>>  
>>  What:		/sys/accessibility/speakup/i18n/characters
>> @@ -297,6 +300,7 @@ KernelVersion:	2.6
>>  Contact:	speakup@linux-speakup.org
>>  Description:	Controls if punctuation is spoken by speakup, or by the
>>  		synthesizer.
>> +
>>  		For example, speakup speaks ">" as "greater", while
>>  		the espeak synthesizer used by the soft driver speaks "greater
>>  		than". Zero lets speakup speak the punctuation. One lets the
>> diff --git a/Documentation/ABI/testing/configfs-most b/Documentation/ABI/testing/configfs-most
>> index ed67a4d9f6d6..bc6b8bd18da4 100644
>> --- a/Documentation/ABI/testing/configfs-most
>> +++ b/Documentation/ABI/testing/configfs-most
>> @@ -15,22 +15,28 @@ KernelVersion:  5.2
>>  Description:
>>  		The attributes:
>>  
>> -		buffer_size	configure the buffer size for this channel
>> +		buffer_size
>> +				configure the buffer size for this channel
>>  
>> -		subbuffer_size	configure the sub-buffer size for this channel
>> +		subbuffer_size
>> +				configure the sub-buffer size for this channel
>>  				(needed for synchronous and isochrnous data)
>>  
>>  
>> -		num_buffers	configure number of buffers used for this
>> +		num_buffers
>> +				configure number of buffers used for this
>>  				channel
>>  
>> -		datatype	configure type of data that will travel over
>> +		datatype
>> +				configure type of data that will travel over
>>  				this channel
>>  
>> -		direction	configure whether this link will be an input
>> +		direction
>> +				configure whether this link will be an input
>>  				or output
>>  
>> -		dbr_size	configure DBR data buffer size (this is used
>> +		dbr_size
>> +				configure DBR data buffer size (this is used
>>  				for MediaLB communication only)
>>  
>>  		packets_per_xact
>> @@ -39,18 +45,23 @@ Description:
>>  				transmitted via USB (this is used for USB
>>  				communication only)
>>  
>> -		device		name of the device the link is to be attached to
>> +		device
>> +				name of the device the link is to be attached to
>>  
>> -		channel		name of the channel the link is to be attached to
>> +		channel
>> +				name of the channel the link is to be attached to
>>  
>> -		comp_params	pass parameters needed by some components
>> +		comp_params
>> +				pass parameters needed by some components
>>  
>> -		create_link	write '1' to this attribute to trigger the
>> +		create_link
>> +				write '1' to this attribute to trigger the
>>  				creation of the link. In case of speculative
>>  				configuration, the creation is post-poned until
>>  				a physical device is being attached to the bus.
>>  
>> -		destroy_link	write '1' to this attribute to destroy an
>> +		destroy_link
>> +				write '1' to this attribute to destroy an
>>  				active link
>>  
>>  What: 		/sys/kernel/config/most_video/<link>
>> @@ -59,22 +70,28 @@ KernelVersion:  5.2
>>  Description:
>>  		The attributes:
>>  
>> -		buffer_size	configure the buffer size for this channel
>> +		buffer_size
>> +				configure the buffer size for this channel
>>  
>> -		subbuffer_size	configure the sub-buffer size for this channel
>> +		subbuffer_size
>> +				configure the sub-buffer size for this channel
>>  				(needed for synchronous and isochrnous data)
>>  
>>  
>> -		num_buffers	configure number of buffers used for this
>> +		num_buffers
>> +				configure number of buffers used for this
>>  				channel
>>  
>> -		datatype	configure type of data that will travel over
>> +		datatype
>> +				configure type of data that will travel over
>>  				this channel
>>  
>> -		direction	configure whether this link will be an input
>> +		direction
>> +				configure whether this link will be an input
>>  				or output
>>  
>> -		dbr_size	configure DBR data buffer size (this is used
>> +		dbr_size
>> +				configure DBR data buffer size (this is used
>>  				for MediaLB communication only)
>>  
>>  		packets_per_xact
>> @@ -83,18 +100,23 @@ Description:
>>  				transmitted via USB (this is used for USB
>>  				communication only)
>>  
>> -		device		name of the device the link is to be attached to
>> +		device
>> +				name of the device the link is to be attached to
>>  
>> -		channel		name of the channel the link is to be attached to
>> +		channel
>> +				name of the channel the link is to be attached to
>>  
>> -		comp_params	pass parameters needed by some components
>> +		comp_params
>> +				pass parameters needed by some components
>>  
>> -		create_link	write '1' to this attribute to trigger the
>> +		create_link
>> +				write '1' to this attribute to trigger the
>>  				creation of the link. In case of speculative
>>  				configuration, the creation is post-poned until
>>  				a physical device is being attached to the bus.
>>  
>> -		destroy_link	write '1' to this attribute to destroy an
>> +		destroy_link
>> +				write '1' to this attribute to destroy an
>>  				active link
>>  
>>  What: 		/sys/kernel/config/most_net/<link>
>> @@ -103,22 +125,28 @@ KernelVersion:  5.2
>>  Description:
>>  		The attributes:
>>  
>> -		buffer_size	configure the buffer size for this channel
>> +		buffer_size
>> +				configure the buffer size for this channel
>>  
>> -		subbuffer_size	configure the sub-buffer size for this channel
>> +		subbuffer_size
>> +				configure the sub-buffer size for this channel
>>  				(needed for synchronous and isochrnous data)
>>  
>>  
>> -		num_buffers	configure number of buffers used for this
>> +		num_buffers
>> +				configure number of buffers used for this
>>  				channel
>>  
>> -		datatype	configure type of data that will travel over
>> +		datatype
>> +				configure type of data that will travel over
>>  				this channel
>>  
>> -		direction	configure whether this link will be an input
>> +		direction
>> +				configure whether this link will be an input
>>  				or output
>>  
>> -		dbr_size	configure DBR data buffer size (this is used
>> +		dbr_size
>> +				configure DBR data buffer size (this is used
>>  				for MediaLB communication only)
>>  
>>  		packets_per_xact
>> @@ -127,18 +155,23 @@ Description:
>>  				transmitted via USB (this is used for USB
>>  				communication only)
>>  
>> -		device		name of the device the link is to be attached to
>> +		device
>> +				name of the device the link is to be attached to
>>  
>> -		channel		name of the channel the link is to be attached to
>> +		channel
>> +				name of the channel the link is to be attached to
>>  
>> -		comp_params	pass parameters needed by some components
>> +		comp_params
>> +				pass parameters needed by some components
>>  
>> -		create_link	write '1' to this attribute to trigger the
>> +		create_link
>> +				write '1' to this attribute to trigger the
>>  				creation of the link. In case of speculative
>>  				configuration, the creation is post-poned until
>>  				a physical device is being attached to the bus.
>>  
>> -		destroy_link	write '1' to this attribute to destroy an
>> +		destroy_link
>> +				write '1' to this attribute to destroy an
>>  				active link
>>  
>>  What: 		/sys/kernel/config/most_sound/<card>
>> @@ -147,7 +180,8 @@ KernelVersion:  5.2
>>  Description:
>>  		The attributes:
>>  
>> -		create_card	write '1' to this attribute to trigger the
>> +		create_card
>> +				write '1' to this attribute to trigger the
>>                                  registration of the sound card with the ALSA
>>  				subsystem.
>>  
>> @@ -157,22 +191,28 @@ KernelVersion:  5.2
>>  Description:
>>  		The attributes:
>>  
>> -		buffer_size	configure the buffer size for this channel
>> +		buffer_size
>> +				configure the buffer size for this channel
>>  
>> -		subbuffer_size	configure the sub-buffer size for this channel
>> +		subbuffer_size
>> +				configure the sub-buffer size for this channel
>>  				(needed for synchronous and isochrnous data)
>>  
>>  
>> -		num_buffers	configure number of buffers used for this
>> +		num_buffers
>> +				configure number of buffers used for this
>>  				channel
>>  
>> -		datatype	configure type of data that will travel over
>> +		datatype
>> +				configure type of data that will travel over
>>  				this channel
>>  
>> -		direction	configure whether this link will be an input
>> +		direction
>> +				configure whether this link will be an input
>>  				or output
>>  
>> -		dbr_size	configure DBR data buffer size (this is used
>> +		dbr_size
>> +				configure DBR data buffer size (this is used
>>  				for MediaLB communication only)
>>  
>>  		packets_per_xact
>> @@ -181,16 +221,21 @@ Description:
>>  				transmitted via USB (this is used for USB
>>  				communication only)
>>  
>> -		device		name of the device the link is to be attached to
>> +		device
>> +				name of the device the link is to be attached to
>>  
>> -		channel		name of the channel the link is to be attached to
>> +		channel
>> +				name of the channel the link is to be attached to
>>  
>> -		comp_params	pass parameters needed by some components
>> +		comp_params
>> +				pass parameters needed by some components
>>  
>> -		create_link	write '1' to this attribute to trigger the
>> +		create_link
>> +				write '1' to this attribute to trigger the
>>  				creation of the link. In case of speculative
>>  				configuration, the creation is post-poned until
>>  				a physical device is being attached to the bus.
>>  
>> -		destroy_link	write '1' to this attribute to destroy an
>> +		destroy_link
>> +				write '1' to this attribute to destroy an
>>  				active link
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-ecm b/Documentation/ABI/testing/configfs-usb-gadget-ecm
>> index 0addf7704b4c..272bc1e4ce2e 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-ecm
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-ecm
>> @@ -4,13 +4,17 @@ KernelVersion:	3.11
>>  Description:
>>  		The attributes:
>>  
>> -		ifname		- network device interface name associated with
>> +		ifname
>> +			      - network device interface name associated with
>>  				this function instance
>> -		qmult		- queue length multiplier for high and
>> +		qmult	
>> +			      - queue length multiplier for high and
>>  				super speed
>> -		host_addr	- MAC address of host's end of this
>> +		host_addr
>> +			      - MAC address of host's end of this
>>  				Ethernet over USB link
>> -		dev_addr	- MAC address of device's end of this
>> +		dev_addr
>> +			      - MAC address of device's end of this
>>  				Ethernet over USB link
>>  
>>  
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-eem b/Documentation/ABI/testing/configfs-usb-gadget-eem
>> index a4c57158fcde..178c3d5fb647 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-eem
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-eem
>> @@ -4,11 +4,13 @@ KernelVersion:	3.11
>>  Description:
>>  		The attributes:
>>  
>> -		ifname		- network device interface name associated with
>> +		==========	=============================================
>> +		ifname		network device interface name associated with
>>  				this function instance
>> -		qmult		- queue length multiplier for high and
>> +		qmult		queue length multiplier for high and
>>  				super speed
>> -		host_addr	- MAC address of host's end of this
>> +		host_addr	MAC address of host's end of this
>>  				Ethernet over USB link
>> -		dev_addr	- MAC address of device's end of this
>> +		dev_addr	MAC address of device's end of this
>>  				Ethernet over USB link
>> +		==========	=============================================
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-loopback b/Documentation/ABI/testing/configfs-usb-gadget-loopback
>> index 06beefbcf061..e6c6ba5ac7ff 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-loopback
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-loopback
>> @@ -4,5 +4,7 @@ KernelVersion:	3.13
>>  Description:
>>  		The attributes:
>>  
>> -		qlen		- depth of loopback queue
>> -		buflen		- buffer length
>> +		=======		=======================
>> +		qlen		depth of loopback queue
>> +		buflen		buffer length
>> +		=======		=======================
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-mass-storage b/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
>> index 9931fb0d63ba..c86b63a7bb43 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
>> @@ -4,12 +4,14 @@ KernelVersion:	3.13
>>  Description:
>>  		The attributes:
>>  
>> -		stall		- Set to permit function to halt bulk endpoints.
>> +		===========	==============================================
>> +		stall		Set to permit function to halt bulk endpoints.
>>  				Disabled on some USB devices known not to work
>>  				correctly. You should set it to true.
>> -		num_buffers	- Number of pipeline buffers. Valid numbers
>> +		num_buffers	Number of pipeline buffers. Valid numbers
>>  				are 2..4. Available only if
>>  				CONFIG_USB_GADGET_DEBUG_FILES is set.
>> +		===========	==============================================
>>  
>>  What:		/config/usb-gadget/gadget/functions/mass_storage.name/lun.name
>>  Date:		Oct 2013
>> @@ -17,15 +19,17 @@ KernelVersion:	3.13
>>  Description:
>>  		The attributes:
>>  
>> -		file		- The path to the backing file for the LUN.
>> +		===========	==============================================
>> +		file		The path to the backing file for the LUN.
>>  				Required if LUN is not marked as removable.
>> -		ro		- Flag specifying access to the LUN shall be
>> +		ro		Flag specifying access to the LUN shall be
>>  				read-only. This is implied if CD-ROM emulation
>>  				is enabled as well as when it was impossible
>>  				to open "filename" in R/W mode.
>> -		removable	- Flag specifying that LUN shall be indicated as
>> +		removable	Flag specifying that LUN shall be indicated as
>>  				being removable.
>> -		cdrom		- Flag specifying that LUN shall be reported as
>> +		cdrom		Flag specifying that LUN shall be reported as
>>  				being a CD-ROM.
>> -		nofua		- Flag specifying that FUA flag
>> +		nofua		Flag specifying that FUA flag
>>  				in SCSI WRITE(10,12)
>> +		===========	==============================================
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-midi b/Documentation/ABI/testing/configfs-usb-gadget-midi
>> index 6b341df7249c..07389cddd51a 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-midi
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-midi
>> @@ -4,9 +4,11 @@ KernelVersion:	3.19
>>  Description:
>>  		The attributes:
>>  
>> -		index		- index value for the USB MIDI adapter
>> -		id		- ID string for the USB MIDI adapter
>> -		buflen		- MIDI buffer length
>> -		qlen		- USB read request queue length
>> -		in_ports	- number of MIDI input ports
>> -		out_ports	- number of MIDI output ports
>> +		==========	====================================
>> +		index		index value for the USB MIDI adapter
>> +		id		ID string for the USB MIDI adapter
>> +		buflen		MIDI buffer length
>> +		qlen		USB read request queue length
>> +		in_ports	number of MIDI input ports
>> +		out_ports	number of MIDI output ports
>> +		==========	====================================
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-printer b/Documentation/ABI/testing/configfs-usb-gadget-printer
>> index 6b0714e3c605..7aa731bac2da 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-printer
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-printer
>> @@ -4,6 +4,8 @@ KernelVersion:	4.1
>>  Description:
>>  		The attributes:
>>  
>> -		pnp_string	- Data to be passed to the host in pnp string
>> -		q_len		- Number of requests per endpoint
>> +		==========      ===========================================
>> +		pnp_string	Data to be passed to the host in pnp string
>> +		q_len		Number of requests per endpoint
>> +		==========      ===========================================
>>  
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-sourcesink b/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
>> index f56335af2d88..1f3d31b607b7 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
>> @@ -4,11 +4,13 @@ KernelVersion:	3.13
>>  Description:
>>  		The attributes:
>>  
>> -		pattern		- 0 (all zeros), 1 (mod63), 2 (none)
>> -		isoc_interval	- 1..16
>> -		isoc_maxpacket	- 0 - 1023 (fs), 0 - 1024 (hs/ss)
>> -		isoc_mult	- 0..2 (hs/ss only)
>> -		isoc_maxburst	- 0..15 (ss only)
>> -		buflen		- buffer length
>> -		bulk_qlen	- depth of queue for bulk
>> -		iso_qlen	- depth of queue for iso
>> +		==============    ==================================
>> +		pattern		  0 (all zeros), 1 (mod63), 2 (none)
>> +		isoc_interval	  1..16
>> +		isoc_maxpacket	  0 - 1023 (fs), 0 - 1024 (hs/ss)
>> +		isoc_mult	  0..2 (hs/ss only)
>> +		isoc_maxburst	  0..15 (ss only)
>> +		buflen		  buffer length
>> +		bulk_qlen	  depth of queue for bulk
>> +		iso_qlen	  depth of queue for iso
>> +		==============    ==================================
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-subset b/Documentation/ABI/testing/configfs-usb-gadget-subset
>> index 9373e2c51ea4..0061b864351f 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-subset
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-subset
>> @@ -4,11 +4,13 @@ KernelVersion:	3.11
>>  Description:
>>  		The attributes:
>>  
>> -		ifname		- network device interface name associated with
>> +		==========	=============================================
>> +		ifname		network device interface name associated with
>>  				this function instance
>> -		qmult		- queue length multiplier for high and
>> +		qmult		queue length multiplier for high and
>>  				super speed
>> -		host_addr	- MAC address of host's end of this
>> +		host_addr	MAC address of host's end of this
>>  				Ethernet over USB link
>> -		dev_addr	- MAC address of device's end of this
>> +		dev_addr	MAC address of device's end of this
>>  				Ethernet over USB link
>> +		==========	=============================================
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-uac2 b/Documentation/ABI/testing/configfs-usb-gadget-uac2
>> index 2bfdd4efa9bd..d4356c8b8cd6 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-uac2
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-uac2
>> @@ -4,9 +4,11 @@ KernelVersion:	3.18
>>  Description:
>>  		The attributes:
>>  
>> -		c_chmask - capture channel mask
>> -		c_srate - capture sampling rate
>> -		c_ssize - capture sample size (bytes)
>> -		p_chmask - playback channel mask
>> -		p_srate - playback sampling rate
>> -		p_ssize - playback sample size (bytes)
>> +		=========  ============================
>> +		c_chmask   capture channel mask
>> +		c_srate    capture sampling rate
>> +		c_ssize    capture sample size (bytes)
>> +		p_chmask   playback channel mask
>> +		p_srate    playback sampling rate
>> +		p_ssize    playback sample size (bytes)
>> +		=========  ============================
>> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-uvc b/Documentation/ABI/testing/configfs-usb-gadget-uvc
>> index cee81b0347bb..ac5e11af79a8 100644
>> --- a/Documentation/ABI/testing/configfs-usb-gadget-uvc
>> +++ b/Documentation/ABI/testing/configfs-usb-gadget-uvc
>> @@ -55,7 +55,7 @@ Description:	Default output terminal descriptors
>>  
>>  		==============	=============================================
>>  		iTerminal	index of string descriptor
>> -		bSourceID 	id of the terminal to which this terminal
>> +		bSourceID	id of the terminal to which this terminal
>>  				is connected
>>  		bAssocTerminal	id of the input terminal to which this output
>>  				terminal is associated
>> diff --git a/Documentation/ABI/testing/debugfs-cec-error-inj b/Documentation/ABI/testing/debugfs-cec-error-inj
>> index 5afcd78fbdb7..8debcb08a3b5 100644
>> --- a/Documentation/ABI/testing/debugfs-cec-error-inj
>> +++ b/Documentation/ABI/testing/debugfs-cec-error-inj
>> @@ -23,7 +23,7 @@ error injections without having to know the details of the driver-specific
>>  commands.
>>  
>>  Note that the output of 'error-inj' shall be valid as input to 'error-inj'.
>> -So this must work:
>> +So this must work::
>>  
>>  	$ cat error-inj >einj.txt
>>  	$ cat einj.txt >error-inj
>> diff --git a/Documentation/ABI/testing/debugfs-driver-habanalabs b/Documentation/ABI/testing/debugfs-driver-habanalabs
>> index 2e9ae311e02d..c5d678d39144 100644
>> --- a/Documentation/ABI/testing/debugfs-driver-habanalabs
>> +++ b/Documentation/ABI/testing/debugfs-driver-habanalabs
>> @@ -20,9 +20,13 @@ Description:    Allow the root user to disable/enable in runtime the clock
>>                  The user can supply a bitmask value, each bit represents
>>                  a different engine to disable/enable its clock gating feature.
>>                  The bitmask is composed of 20 bits:
>> -                0  -  7 : DMA channels
>> -                8  - 11 : MME engines
>> -                12 - 19 : TPC engines
>> +
>> +		=======   ============
>> +                0  -  7   DMA channels
>> +                8  - 11   MME engines
>> +                12 - 19   TPC engines
>> +		=======   ============
>> +
>>                  The bit's location of a specific engine can be determined
>>                  using (1 << GAUDI_ENGINE_ID_*). GAUDI_ENGINE_ID_* values
>>                  are defined in uapi habanalabs.h file in enum gaudi_engine_id
>> @@ -59,6 +63,7 @@ Description:    Allows the root user to read or write directly through the
>>                  the generic Linux user-space PCI mapping) because the DDR bar
>>                  is very small compared to the DDR memory and only the driver can
>>                  move the bar before and after the transaction.
>> +
>>                  If the IOMMU is disabled, it also allows the root user to read
>>                  or write from the host a device VA of a host mapped memory
>>  
>> @@ -73,6 +78,7 @@ Description:    Allows the root user to read or write 64 bit data directly
>>                  the generic Linux user-space PCI mapping) because the DDR bar
>>                  is very small compared to the DDR memory and only the driver can
>>                  move the bar before and after the transaction.
>> +
>>                  If the IOMMU is disabled, it also allows the root user to read
>>                  or write from the host a device VA of a host mapped memory
>>  
>> diff --git a/Documentation/ABI/testing/debugfs-pfo-nx-crypto b/Documentation/ABI/testing/debugfs-pfo-nx-crypto
>> index 685d5a448423..f75a655c1531 100644
>> --- a/Documentation/ABI/testing/debugfs-pfo-nx-crypto
>> +++ b/Documentation/ABI/testing/debugfs-pfo-nx-crypto
>> @@ -4,42 +4,42 @@ KernelVersion:	3.4
>>  Contact:	Kent Yoder <key@linux.vnet.ibm.com>
>>  Description:
>>  
>> -  These debugfs interfaces are built by the nx-crypto driver, built in
>> +These debugfs interfaces are built by the nx-crypto driver, built in
>>  arch/powerpc/crypto/nx.
>>  
>>  Error Detection
>>  ===============
>>  
>>  errors:
>> -- A u32 providing a total count of errors since the driver was loaded. The
>> -only errors counted here are those returned from the hcall, H_COP_OP.
>> +  A u32 providing a total count of errors since the driver was loaded. The
>> +  only errors counted here are those returned from the hcall, H_COP_OP.
>>  
>>  last_error:
>> -- The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not
>> -recorded here (the hcall will retry until -EBUSY goes away).
>> +  The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not
>> +  recorded here (the hcall will retry until -EBUSY goes away).
>>  
>>  last_error_pid:
>> -- The process ID of the process who received the most recent error from the
>> -hcall.
>> +  The process ID of the process who received the most recent error from the
>> +  hcall.
>>  
>>  Device Use
>>  ==========
>>  
>>  aes_bytes:
>> -- The total number of bytes encrypted using AES in any of the driver's
>> -supported modes.
>> +  The total number of bytes encrypted using AES in any of the driver's
>> +  supported modes.
>>  
>>  aes_ops:
>> -- The total number of AES operations submitted to the hardware.
>> +  The total number of AES operations submitted to the hardware.
>>  
>>  sha256_bytes:
>> -- The total number of bytes hashed by the hardware using SHA-256.
>> +  The total number of bytes hashed by the hardware using SHA-256.
>>  
>>  sha256_ops:
>> -- The total number of SHA-256 operations submitted to the hardware.
>> +  The total number of SHA-256 operations submitted to the hardware.
>>  
>>  sha512_bytes:
>> -- The total number of bytes hashed by the hardware using SHA-512.
>> +  The total number of bytes hashed by the hardware using SHA-512.
>>  
>>  sha512_ops:
>> -- The total number of SHA-512 operations submitted to the hardware.
>> +  The total number of SHA-512 operations submitted to the hardware.
>> diff --git a/Documentation/ABI/testing/debugfs-pktcdvd b/Documentation/ABI/testing/debugfs-pktcdvd
>> index 787907d70462..f6f65a4faea0 100644
>> --- a/Documentation/ABI/testing/debugfs-pktcdvd
>> +++ b/Documentation/ABI/testing/debugfs-pktcdvd
>> @@ -10,7 +10,7 @@ these files in debugfs:
>>  /sys/kernel/debug/pktcdvd/pktcdvd[0-7]/
>>  
>>      ====            ====== ====================================
>> -    info            (0444) Lots of driver statistics and infos.
>> +    info            0444   Lots of driver statistics and infos.
>>      ====            ====== ====================================
>>  
>>  Example::
>> diff --git a/Documentation/ABI/testing/debugfs-turris-mox-rwtm b/Documentation/ABI/testing/debugfs-turris-mox-rwtm
>> index c8f7dadd591c..ad08f535af3b 100644
>> --- a/Documentation/ABI/testing/debugfs-turris-mox-rwtm
>> +++ b/Documentation/ABI/testing/debugfs-turris-mox-rwtm
>> @@ -2,10 +2,12 @@ What:		/sys/kernel/debug/turris-mox-rwtm/do_sign
>>  Date:		Jun 2020
>>  KernelVersion:	5.8
>>  Contact:	Marek Behún <marek.behun@nic.cz>
>> -Description:	(W)
>> -		    Message to sign with the ECDSA private key stored in
>> +Description:
>> +
>> +		=== ===========================================================
>> +		(W) Message to sign with the ECDSA private key stored in
>>  		    device's OTP. The message must be exactly 64 bytes (since
>>  		    this is intended for SHA-512 hashes).
>> -		(R)
>> -		    The resulting signature, 136 bytes. This contains the R and
>> +		(R) The resulting signature, 136 bytes. This contains the R and
>>  		    S values of the ECDSA signature, both in big-endian format.
>> +		=== ===========================================================
>> diff --git a/Documentation/ABI/testing/debugfs-wilco-ec b/Documentation/ABI/testing/debugfs-wilco-ec
>> index 9d8d9d2def5b..682e3c09ef4d 100644
>> --- a/Documentation/ABI/testing/debugfs-wilco-ec
>> +++ b/Documentation/ABI/testing/debugfs-wilco-ec
>> @@ -27,16 +27,17 @@ Description:
>>  		for writing, two for the type and at least a single byte of
>>  		data.
>>  
>> -		Example:
>> -		// Request EC info type 3 (EC firmware build date)
>> -		// Corresponds with sending type 0x00f0 with
>> -		// MBOX = [38, 00, 03, 00]
>> -		$ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw
>> -		// View the result. The decoded ASCII result "12/21/18" is
>> -		// included after the raw hex.
>> -		// Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...]
>> -		$ cat /sys/kernel/debug/wilco_ec/raw
>> -		00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00  ..12/21/18.8...
>> +		Example::
>> +
>> +		    // Request EC info type 3 (EC firmware build date)
>> +		    // Corresponds with sending type 0x00f0 with
>> +		    // MBOX = [38, 00, 03, 00]
>> +		    $ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw
>> +		    // View the result. The decoded ASCII result "12/21/18" is
>> +		    // included after the raw hex.
>> +		    // Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...]
>> +		    $ cat /sys/kernel/debug/wilco_ec/raw
>> +		    00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00  ..12/21/18.8...
>>  
>>  		Note that the first 16 bytes of the received MBOX[] will be
>>  		printed, even if some of the data is junk, and skipping bytes
>> diff --git a/Documentation/ABI/testing/dell-smbios-wmi b/Documentation/ABI/testing/dell-smbios-wmi
>> index fc919ce16008..5f3a0dc67050 100644
>> --- a/Documentation/ABI/testing/dell-smbios-wmi
>> +++ b/Documentation/ABI/testing/dell-smbios-wmi
>> @@ -10,29 +10,29 @@ Description:
>>  		<uapi/linux/wmi.h>
>>  
>>  		1) To perform an SMBIOS call from userspace, you'll need to
>> -		first determine the minimum size of the calling interface
>> -		buffer for your machine.
>> -		Platforms that contain larger buffers can return larger
>> -		objects from the system firmware.
>> -		Commonly this size is either 4k or 32k.
>> +		   first determine the minimum size of the calling interface
>> +		   buffer for your machine.
>> +		   Platforms that contain larger buffers can return larger
>> +		   objects from the system firmware.
>> +		   Commonly this size is either 4k or 32k.
>>  
>> -		To determine the size of the buffer read() a u64 dword from
>> -		the WMI character device /dev/wmi/dell-smbios.
>> +		   To determine the size of the buffer read() a u64 dword from
>> +		   the WMI character device /dev/wmi/dell-smbios.
>>  
>>  		2) After you've determined the minimum size of the calling
>> -		interface buffer, you can allocate a structure that represents
>> -		the structure documented above.
>> +		   interface buffer, you can allocate a structure that represents
>> +		   the structure documented above.
>>  
>>  		3) In the 'length' object store the size of the buffer you
>> -		determined above and allocated.
>> +		   determined above and allocated.
>>  
>>  		4) In this buffer object, prepare as necessary for the SMBIOS
>> -		call you're interested in.  Typically SMBIOS buffers have
>> -		"class", "select", and "input" defined to values that coincide
>> -		with the data you are interested in.
>> -		Documenting class/select/input values is outside of the scope
>> -		of this documentation. Check with the libsmbios project for
>> -		further documentation on these values.
>> +		   call you're interested in.  Typically SMBIOS buffers have
>> +		   "class", "select", and "input" defined to values that coincide
>> +		   with the data you are interested in.
>> +		   Documenting class/select/input values is outside of the scope
>> +		   of this documentation. Check with the libsmbios project for
>> +		   further documentation on these values.
>>  
>>  		6) Run the call by using ioctl() as described in the header.
>>  
>> diff --git a/Documentation/ABI/testing/gpio-cdev b/Documentation/ABI/testing/gpio-cdev
>> index 7b265fbb47e3..66bdcd188b6c 100644
>> --- a/Documentation/ABI/testing/gpio-cdev
>> +++ b/Documentation/ABI/testing/gpio-cdev
>> @@ -12,15 +12,16 @@ Description:
>>  		The following file operations are supported:
>>  
>>  		open(2)
>> -		Currently the only useful flags are O_RDWR.
>> +		  Currently the only useful flags are O_RDWR.
>>  
>>  		ioctl(2)
>> -		Initiate various actions.
>> -		See the inline documentation in [include/uapi]<linux/gpio.h>
>> -		for descriptions of all ioctls.
>> +		  Initiate various actions.
>> +
>> +		  See the inline documentation in [include/uapi]<linux/gpio.h>
>> +		  for descriptions of all ioctls.
>>  
>>  		close(2)
>> -		Stops and free up the I/O contexts that was associated
>> -		with the file descriptor.
>> +		  Stops and free up the I/O contexts that was associated
>> +		  with the file descriptor.
>>  
>>  Users:		TBD
>> diff --git a/Documentation/ABI/testing/procfs-diskstats b/Documentation/ABI/testing/procfs-diskstats
>> index df5a3a8c1edf..e58d641443d3 100644
>> --- a/Documentation/ABI/testing/procfs-diskstats
>> +++ b/Documentation/ABI/testing/procfs-diskstats
>> @@ -35,7 +35,9 @@ Description:
>>  
>>  		Kernel 5.5+ appends two more fields for flush requests:
>>  
>> -		19 - flush requests completed successfully
>> -		20 - time spent flushing
>> +		==  =====================================
>> +		19  flush requests completed successfully
>> +		20  time spent flushing
>> +		==  =====================================
>>  
>>  		For more details refer to Documentation/admin-guide/iostats.rst
>> diff --git a/Documentation/ABI/testing/procfs-smaps_rollup b/Documentation/ABI/testing/procfs-smaps_rollup
>> index 046978193368..a4e31c465194 100644
>> --- a/Documentation/ABI/testing/procfs-smaps_rollup
>> +++ b/Documentation/ABI/testing/procfs-smaps_rollup
>> @@ -14,28 +14,28 @@ Description:
>>  		For more details, see Documentation/filesystems/proc.rst
>>  		and the procfs man page.
>>  
>> -		Typical output looks like this:
>> +		Typical output looks like this::
>>  
>> -		00100000-ff709000 ---p 00000000 00:00 0		 [rollup]
>> -		Size:               1192 kB
>> -		KernelPageSize:        4 kB
>> -		MMUPageSize:           4 kB
>> -		Rss:		     884 kB
>> -		Pss:		     385 kB
>> -		Pss_Anon:	     301 kB
>> -		Pss_File:	      80 kB
>> -		Pss_Shmem:	       4 kB
>> -		Shared_Clean:	     696 kB
>> -		Shared_Dirty:	       0 kB
>> -		Private_Clean:	     120 kB
>> -		Private_Dirty:	      68 kB
>> -		Referenced:	     884 kB
>> -		Anonymous:	      68 kB
>> -		LazyFree:	       0 kB
>> -		AnonHugePages:	       0 kB
>> -		ShmemPmdMapped:	       0 kB
>> -		Shared_Hugetlb:	       0 kB
>> -		Private_Hugetlb:       0 kB
>> -		Swap:		       0 kB
>> -		SwapPss:	       0 kB
>> -		Locked:		     385 kB
>> +			00100000-ff709000 ---p 00000000 00:00 0		 [rollup]
>> +			Size:               1192 kB
>> +			KernelPageSize:        4 kB
>> +			MMUPageSize:           4 kB
>> +			Rss:		     884 kB
>> +			Pss:		     385 kB
>> +			Pss_Anon:	     301 kB
>> +			Pss_File:	      80 kB
>> +			Pss_Shmem:	       4 kB
>> +			Shared_Clean:	     696 kB
>> +			Shared_Dirty:	       0 kB
>> +			Private_Clean:	     120 kB
>> +			Private_Dirty:	      68 kB
>> +			Referenced:	     884 kB
>> +			Anonymous:	      68 kB
>> +			LazyFree:	       0 kB
>> +			AnonHugePages:	       0 kB
>> +			ShmemPmdMapped:	       0 kB
>> +			Shared_Hugetlb:	       0 kB
>> +			Private_Hugetlb:       0 kB
>> +			Swap:		       0 kB
>> +			SwapPss:	       0 kB
>> +			Locked:		     385 kB
>> diff --git a/Documentation/ABI/testing/pstore b/Documentation/ABI/testing/pstore
>> index d45209abdb1b..5b02540781a2 100644
>> --- a/Documentation/ABI/testing/pstore
>> +++ b/Documentation/ABI/testing/pstore
>> @@ -9,25 +9,25 @@ Description:	Generic interface to platform dependent persistent storage.
>>  		provide a generic interface to show records captured in
>>  		the dying moments.  In the case of a panic the last part
>>  		of the console log is captured, but other interesting
>> -		data can also be saved.
>> +		data can also be saved::
>>  
>> -		# mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore
>> +		    # mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore
>>  
>> -		$ ls -l /sys/fs/pstore/
>> -		total 0
>> -		-r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
>> +		    $ ls -l /sys/fs/pstore/
>> +		    total 0
>> +		    -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
>>  
>>  		Different users of this interface will result in different
>>  		filename prefixes.  Currently two are defined:
>>  
>> -		"dmesg"	- saved console log
>> -		"mce"	- architecture dependent data from fatal h/w error
>> +		- "dmesg" - saved console log
>> +		- "mce"   - architecture dependent data from fatal h/w error
>>  
>>  		Once the information in a file has been read, removing
>>  		the file will signal to the underlying persistent storage
>> -		device that it can reclaim the space for later re-use.
>> +		device that it can reclaim the space for later re-use::
>>  
>> -		$ rm /sys/fs/pstore/dmesg-erst-1
>> +		    $ rm /sys/fs/pstore/dmesg-erst-1
>>  
>>  		The expectation is that all files in /sys/fs/pstore/
>>  		will be saved elsewhere and erased from persistent store
>> @@ -44,4 +44,3 @@ Description:	Generic interface to platform dependent persistent storage.
>>  		backends are available, the preferred backend may be
>>  		set by passing the pstore.backend= argument to the kernel at
>>  		boot time.
>> -
>> diff --git a/Documentation/ABI/testing/sysfs-block-rnbd b/Documentation/ABI/testing/sysfs-block-rnbd
>> index 8f070b47f361..14a6fe9422b3 100644
>> --- a/Documentation/ABI/testing/sysfs-block-rnbd
>> +++ b/Documentation/ABI/testing/sysfs-block-rnbd
>> @@ -9,9 +9,9 @@ Description:	To unmap a volume, "normal" or "force" has to be written to:
>>  		is using the device.  When "force" is used, the device is also unmapped
>>  		when device is in use.  All I/Os that are in progress will fail.
>>  
>> -		Example:
>> +		Example::
>>  
>> -		# echo "normal" > /sys/block/rnbd0/rnbd/unmap_device
>> +		  # echo "normal" > /sys/block/rnbd0/rnbd/unmap_device
>>  
>>  What:		/sys/block/rnbd<N>/rnbd/state
>>  Date:		Feb 2020
>> diff --git a/Documentation/ABI/testing/sysfs-bus-acpi b/Documentation/ABI/testing/sysfs-bus-acpi
>> index c78603497b97..58abacf59b2a 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-acpi
>> +++ b/Documentation/ABI/testing/sysfs-bus-acpi
>> @@ -5,6 +5,7 @@ Description:
>>  		This attribute indicates the full path of ACPI namespace
>>  		object associated with the device object.  For example,
>>  		\_SB_.PCI0.
>> +
>>  		This file is not present for device objects representing
>>  		fixed ACPI hardware features (like power and sleep
>>  		buttons).
>> diff --git a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10 b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
>> index b5f526081711..3e92cbd3fd83 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
>> +++ b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
>> @@ -4,7 +4,10 @@ KernelVersion:	3.19
>>  Contact:	Mathieu Poirier <mathieu.poirier@linaro.org>
>>  Description:	(RW) Add/remove a sink from a trace path.  There can be multiple
>>  		source for a single sink.
>> -		ex: echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink
>> +
>> +		ex::
>> +
>> +		  echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink
>>  
>>  What:		/sys/bus/coresight/devices/<memory_map>.etb/trigger_cntr
>>  Date:		November 2014
>> diff --git a/Documentation/ABI/testing/sysfs-bus-css b/Documentation/ABI/testing/sysfs-bus-css
>> index 966f8504bd7b..12a733fe357f 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-css
>> +++ b/Documentation/ABI/testing/sysfs-bus-css
>> @@ -20,6 +20,7 @@ Contact:	Cornelia Huck <cornelia.huck@de.ibm.com>
>>  Description:	Contains the ids of the channel paths used by this
>>  		subchannel, as reported by the channel subsystem
>>  		during subchannel recognition.
>> +
>>  		Note: This is an I/O-subchannel specific attribute.
>>  Users:		s390-tools, HAL
>>  
>> @@ -31,6 +32,7 @@ Description:	Contains the PIM/PAM/POM values, as reported by the
>>  		channel subsystem when last queried by the common I/O
>>  		layer (this implies that this attribute is not necessarily
>>  		in sync with the values current in the channel subsystem).
>> +
>>  		Note: This is an I/O-subchannel specific attribute.
>>  Users:		s390-tools, HAL
>>  
>> @@ -53,6 +55,7 @@ Description:	This file allows the driver for a device to be specified. When
>>  		opt-out of driver binding using a driver_override name such as
>>  		"none".  Only a single driver may be specified in the override,
>>  		there is no support for parsing delimiters.
>> +
>>  		Note that unlike the mechanism of the same name for pci, this
>>  		file does not allow to override basic matching rules. I.e.,
>>  		the driver must still match the subchannel type of the device.
>> diff --git a/Documentation/ABI/testing/sysfs-bus-dfl b/Documentation/ABI/testing/sysfs-bus-dfl
>> index 23543be904f2..b0265ab17200 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-dfl
>> +++ b/Documentation/ABI/testing/sysfs-bus-dfl
>> @@ -4,6 +4,7 @@ KernelVersion:	5.10
>>  Contact:	Xu Yilun <yilun.xu@intel.com>
>>  Description:	Read-only. It returns type of DFL FIU of the device. Now DFL
>>  		supports 2 FIU types, 0 for FME, 1 for PORT.
>> +
>>  		Format: 0x%x
>>  
>>  What:		/sys/bus/dfl/devices/dfl_dev.X/feature_id
>> @@ -12,4 +13,5 @@ KernelVersion:	5.10
>>  Contact:	Xu Yilun <yilun.xu@intel.com>
>>  Description:	Read-only. It returns feature identifier local to its DFL FIU
>>  		type.
>> +
>>  		Format: 0x%x
>> diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7 b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
>> index 2273627df190..de390a010af8 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
>> +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
>> @@ -7,7 +7,7 @@ Description:    Read-only. Attribute group to describe the magic bits
>>  
>>                  Each attribute under this group defines a bit range of the
>>                  perf_event_attr.config. All supported attributes are listed
>> -                below.
>> +                below::
>>  
>>  				chip = "config:16-31"
>>  				core  = "config:16-31"
>> @@ -16,9 +16,9 @@ Description:    Read-only. Attribute group to describe the magic bits
>>  				offset = "config:32-63"
>>  				vcpu = "config:16-31"
>>  
>> -               For example,
>> +                For example::
>>  
>> -		PM_PB_CYC =  "domain=1,offset=0x80,chip=?,lpar=0x0"
>> +		  PM_PB_CYC =  "domain=1,offset=0x80,chip=?,lpar=0x0"
>>  
>>  		In this event, '?' after chip specifies that
>>  		this value will be provided by user while running this event.
>> diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
>> index 6a023b42486c..12e2bf92783f 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
>> +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
>> @@ -7,7 +7,7 @@ Description:    Read-only. Attribute group to describe the magic bits
>>  
>>                  Each attribute under this group defines a bit range of the
>>                  perf_event_attr.config. All supported attributes are listed
>> -                below.
>> +                below::
>>  
>>  				counter_info_version  = "config:16-23"
>>  				length  = "config:24-31"
>> @@ -20,9 +20,9 @@ Description:    Read-only. Attribute group to describe the magic bits
>>  				secondary_index = "config:0-15"
>>  				starting_index = "config:32-63"
>>  
>> -               For example,
>> +                For example::
>>  
>> -		processor_core_utilization_instructions_completed = "request=0x94,
>> +		  processor_core_utilization_instructions_completed = "request=0x94,
>>  					phys_processor_idx=?,counter_info_version=0x8,
>>  					length=8,offset=0x18"
>>  
>> @@ -36,6 +36,7 @@ Description:
>>  		'0' if the hypervisor is configured to forbid access to event
>>  		counters being accumulated by other guests and to physical
>>  		domain event counters.
>> +
>>  		'1' if that access is allowed.
>>  
>>  What:		/sys/bus/event_source/devices/hv_gpci/interface/ga
>> diff --git a/Documentation/ABI/testing/sysfs-bus-fcoe b/Documentation/ABI/testing/sysfs-bus-fcoe
>> index 657df13b100d..8fe787cc4ab7 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-fcoe
>> +++ b/Documentation/ABI/testing/sysfs-bus-fcoe
>> @@ -3,16 +3,19 @@ Date:		August 2012
>>  KernelVersion:	TBD
>>  Contact:	Robert Love <robert.w.love@intel.com>, devel@open-fcoe.org
>>  Description:	The FCoE bus. Attributes in this directory are control interfaces.
>> +
>>  Attributes:
>>  
>> -	ctlr_create: 'FCoE Controller' instance creation interface. Writing an
>> +	ctlr_create:
>> +		     'FCoE Controller' instance creation interface. Writing an
>>  		     <ifname> to this file will allocate and populate sysfs with a
>>  		     fcoe_ctlr_device (ctlr_X). The user can then configure any
>>  		     per-port settings and finally write to the fcoe_ctlr_device's
>>  		     'start' attribute to begin the kernel's discovery and login
>>  		     process.
>>  
>> -	ctlr_destroy: 'FCoE Controller' instance removal interface. Writing a
>> +	ctlr_destroy:
>> +		       'FCoE Controller' instance removal interface. Writing a
>>  		       fcoe_ctlr_device's sysfs name to this file will log the
>>  		       fcoe_ctlr_device out of the fabric or otherwise connected
>>  		       FCoE devices. It will also free all kernel memory allocated
>> @@ -32,11 +35,13 @@ Description:	'FCoE Controller' instances on the fcoe bus.
>>  
>>  Attributes:
>>  
>> -	fcf_dev_loss_tmo: Device loss timeout period (see below). Changing
>> +	fcf_dev_loss_tmo:
>> +			  Device loss timeout period (see below). Changing
>>  			  this value will change the dev_loss_tmo for all
>>  			  FCFs discovered by this controller.
>>  
>> -	mode:		  Display or change the FCoE Controller's mode. Possible
>> +	mode:
>> +			  Display or change the FCoE Controller's mode. Possible
>>  			  modes are 'Fabric' and 'VN2VN'. If a FCoE Controller
>>  			  is started in 'Fabric' mode then FIP FCF discovery is
>>  			  initiated and ultimately a fabric login is attempted.
>> @@ -44,23 +49,30 @@ Attributes:
>>  			  FIP VN2VN discovery and login is performed. A FCoE
>>  			  Controller only supports one mode at a time.
>>  
>> -	enabled:	  Whether an FCoE controller is enabled or disabled.
>> +	enabled:
>> +			  Whether an FCoE controller is enabled or disabled.
>>  			  0 if disabled, 1 if enabled. Writing either 0 or 1
>>  			  to this file will enable or disable the FCoE controller.
>>  
>> -	lesb/link_fail:   Link Error Status Block (LESB) link failure count.
>> +	lesb/link_fail:
>> +			  Link Error Status Block (LESB) link failure count.
>>  
>> -	lesb/vlink_fail:  Link Error Status Block (LESB) virtual link
>> +	lesb/vlink_fail:
>> +		          Link Error Status Block (LESB) virtual link
>>  			  failure count.
>>  
>> -	lesb/miss_fka:    Link Error Status Block (LESB) missed FCoE
>> +	lesb/miss_fka:
>> +			  Link Error Status Block (LESB) missed FCoE
>>  			  Initialization Protocol (FIP) Keep-Alives (FKA).
>>  
>> -	lesb/symb_err:    Link Error Status Block (LESB) symbolic error count.
>> +	lesb/symb_err:
>> +			  Link Error Status Block (LESB) symbolic error count.
>>  
>> -	lesb/err_block:   Link Error Status Block (LESB) block error count.
>> +	lesb/err_block:
>> +			  Link Error Status Block (LESB) block error count.
>>  
>> -	lesb/fcs_error:   Link Error Status Block (LESB) Fibre Channel
>> +	lesb/fcs_error:
>> +			  Link Error Status Block (LESB) Fibre Channel
>>  			  Services error count.
>>  
>>  Notes: ctlr_X (global increment starting at 0)
>> @@ -75,31 +87,41 @@ Description:	'FCoE FCF' instances on the fcoe bus. A FCF is a Fibre Channel
>>  		Fibre Channel frames into a FC fabric. It can also take
>>  		outbound FC frames and pack them in Ethernet packets to
>>  		be sent to their destination on the Ethernet segment.
>> +
>>  Attributes:
>>  
>> -	fabric_name: Identifies the fabric that the FCF services.
>> +	fabric_name:
>> +		     Identifies the fabric that the FCF services.
>>  
>> -	switch_name: Identifies the FCF.
>> +	switch_name:
>> +		     Identifies the FCF.
>>  
>> -	priority:    The switch's priority amongst other FCFs on the same
>> +	priority:
>> +		     The switch's priority amongst other FCFs on the same
>>  		     fabric.
>>  
>> -	selected:    1 indicates that the switch has been selected for use;
>> +	selected:
>> +		     1 indicates that the switch has been selected for use;
>>  		     0 indicates that the switch will not be used.
>>  
>> -	fc_map:      The Fibre Channel MAP
>> +	fc_map:
>> +		     The Fibre Channel MAP
>>  
>> -	vfid:	     The Virtual Fabric ID
>> +	vfid:
>> +		     The Virtual Fabric ID
>>  
>> -	mac:         The FCF's MAC address
>> +	mac:
>> +		     The FCF's MAC address
>>  
>> -	fka_period:  The FIP Keep-Alive period
>> +	fka_period:
>> +		     The FIP Keep-Alive period
>>  
>>  	fabric_state: The internal kernel state
>> -		      "Unknown" - Initialization value
>> -		      "Disconnected" - No link to the FCF/fabric
>> -		      "Connected" - Host is connected to the FCF
>> -		      "Deleted" - FCF is being removed from the system
>> +
>> +		      - "Unknown" - Initialization value
>> +		      - "Disconnected" - No link to the FCF/fabric
>> +		      - "Connected" - Host is connected to the FCF
>> +		      - "Deleted" - FCF is being removed from the system
>>  
>>  	dev_loss_tmo: The device loss timeout period for this FCF.
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-bus-fsl-mc b/Documentation/ABI/testing/sysfs-bus-fsl-mc
>> index 80256b8b4f26..bf3c6af6ad89 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-fsl-mc
>> +++ b/Documentation/ABI/testing/sysfs-bus-fsl-mc
>> @@ -6,8 +6,10 @@ Description:
>>  		the driver to attempt to bind to the device found at
>>  		this location. The format for the location is Object.Id
>>  		and is the same as found in /sys/bus/fsl-mc/devices/.
>> -                For example:
>> -		# echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind
>> +
>> +                For example::
>> +
>> +		  # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind
>>  
>>  What:		/sys/bus/fsl-mc/drivers/.../unbind
>>  Date:		December 2016
>> @@ -17,5 +19,7 @@ Description:
>>  		driver to attempt to unbind from the device found at
>>  		this location. The format for the location is Object.Id
>>  		and is the same as found in /sys/bus/fsl-mc/devices/.
>> -                For example:
>> -		# echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind
>> +
>> +                For example::
>> +
>> +		  # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind
>> diff --git a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480 b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
>> index 9de269bb0ae5..42dfc9399d2d 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
>> +++ b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
>> @@ -3,19 +3,25 @@ Date:		February 2011
>>  Contact:	Minkyu Kang <mk7.kang@samsung.com>
>>  Description:
>>  		show what device is attached
>> -		NONE - no device
>> -		USB - USB device is attached
>> -		UART - UART is attached
>> -		CHARGER - Charger is attaced
>> -		JIG - JIG is attached
>> +
>> +		=======  ======================
>> +		NONE     no device
>> +		USB      USB device is attached
>> +		UART     UART is attached
>> +		CHARGER  Charger is attaced
>> +		JIG      JIG is attached
>> +		=======  ======================
>>  
>>  What:		/sys/bus/i2c/devices/.../switch
>>  Date:		February 2011
>>  Contact:	Minkyu Kang <mk7.kang@samsung.com>
>>  Description:
>>  		show or set the state of manual switch
>> -		VAUDIO - switch to VAUDIO path
>> -		UART - switch to UART path
>> -		AUDIO - switch to AUDIO path
>> -		DHOST - switch to DHOST path
>> -		AUTO - switch automatically by device
>> +
>> +		=======  ==============================
>> +		VAUDIO   switch to VAUDIO path
>> +		UART     switch to UART path
>> +		AUDIO    switch to AUDIO path
>> +		DHOST    switch to DHOST path
>> +		AUTO     switch automatically by device
>> +		=======  ==============================
>> diff --git a/Documentation/ABI/testing/sysfs-bus-i3c b/Documentation/ABI/testing/sysfs-bus-i3c
>> index 2f332ec36f82..1f4a2662335b 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-i3c
>> +++ b/Documentation/ABI/testing/sysfs-bus-i3c
>> @@ -84,6 +84,7 @@ Description:
>>  		by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
>>  		See the I3C specification for more details about these HDR
>>  		modes.
>> +
>>  		This entry describes the HDRCAP of the master controller
>>  		driving the bus.
>>  
>> @@ -135,6 +136,7 @@ Description:
>>  		Expose the HDR (High Data Rate) capabilities of a device.
>>  		Returns a list of supported HDR mode, each element is separated
>>  		by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
>> +
>>  		See the I3C specification for more details about these HDR
>>  		modes.
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
>> index e3df71987eff..df42bed09f25 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-iio
>> +++ b/Documentation/ABI/testing/sysfs-bus-iio
>> @@ -15,6 +15,7 @@ Description:
>>  		based on hardware generated events (e.g. data ready) or
>>  		provided by a separate driver for other hardware (e.g.
>>  		periodic timer, GPIO or high resolution timer).
>> +
>>  		Contains trigger type specific elements. These do not
>>  		generalize well and hence are not documented in this file.
>>  		X is the IIO index of the trigger.
>> @@ -666,6 +667,7 @@ Description:
>>  		<type>[Y][_name]_<raw|input>_thresh_falling_value may take
>>  		different values, but the device can only enable both thresholds
>>  		or neither.
>> +
>>  		Note the driver will assume the last p events requested are
>>  		to be enabled where p is how many it supports (which may vary
>>  		depending on the exact set requested. So if you want to be
>> @@ -720,6 +722,7 @@ Description:
>>  		<type>[Y][_name]_<raw|input>_roc_falling_value may take
>>  		different values, but the device can only enable both rate of
>>  		change thresholds or neither.
>> +
>>  		Note the driver will assume the last p events requested are
>>  		to be enabled where p is however many it supports (which may
>>  		vary depending on the exact set requested. So if you want to be
>> @@ -775,9 +778,11 @@ Description:
>>  		Specifies the value of threshold that the device is comparing
>>  		against for the events enabled by
>>  		<type>Y[_name]_thresh[_rising|falling]_en.
>> +
>>  		If separate attributes exist for the two directions, but
>>  		direction is not specified for this attribute, then a single
>>  		threshold value applies to both directions.
>> +
>>  		The raw or input element of the name indicates whether the
>>  		value is in raw device units or in processed units (as _raw
>>  		and _input do on sysfs direct channel read attributes).
>> @@ -860,6 +865,7 @@ Description:
>>  		If separate attributes exist for the two directions, but
>>  		direction is not specified for this attribute, then a single
>>  		hysteresis value applies to both directions.
>> +
>>  		For falling events the hysteresis is added to the _value attribute for
>>  		this event to get the upper threshold for when the event goes back to
>>  		normal, for rising events the hysteresis is subtracted from the _value
>> @@ -906,6 +912,7 @@ Description:
>>  		Specifies the value of rate of change threshold that the
>>  		device is comparing against for the events enabled by
>>  		<type>[Y][_name]_roc[_rising|falling]_en.
>> +
>>  		If separate attributes exist for the two directions,
>>  		but direction is not specified for this attribute,
>>  		then a single threshold value applies to both directions.
>> @@ -1305,6 +1312,7 @@ Description:
>>  		Proximity measurement indicating that some
>>  		object is near the sensor, usually by observing
>>  		reflectivity of infrared or ultrasound emitted.
>> +
>>  		Often these sensors are unit less and as such conversion
>>  		to SI units is not possible. Higher proximity measurements
>>  		indicate closer objects, and vice versa. Units after
>> @@ -1450,9 +1458,12 @@ Contact:	linux-iio@vger.kernel.org
>>  Description:
>>  		A single positive integer specifying the maximum number of scan
>>  		elements to wait for.
>> +
>>  		Poll will block until the watermark is reached.
>> +
>>  		Blocking read will wait until the minimum between the requested
>>  		read amount or the low water mark is available.
>> +
>>  		Non-blocking read will retrieve the available samples from the
>>  		buffer even if there are less samples then watermark level. This
>>  		allows the application to block on poll with a timeout and read
>> @@ -1481,11 +1492,13 @@ Description:
>>  		device settings allows it (e.g. if a trigger is set that samples
>>  		data differently that the hardware fifo does then hardware fifo
>>  		will not enabled).
>> +
>>  		If the hardware fifo is enabled and the level of the hardware
>>  		fifo reaches the hardware fifo watermark level the device will
>>  		flush its hardware fifo to the device buffer. Doing a non
>>  		blocking read on the device when no samples are present in the
>>  		device buffer will also force a flush.
>> +
>>  		When the hardware fifo is enabled there is no need to use a
>>  		trigger to use buffer mode since the watermark settings
>>  		guarantees that the hardware fifo is flushed to the device
>> @@ -1523,6 +1536,7 @@ Description:
>>  		A single positive integer specifying the minimum watermark level
>>  		for the hardware fifo of this device. If the device does not
>>  		have a hardware fifo this entry is not present.
>> +
>>  		If the user sets buffer/watermark to a value less than this one,
>>  		then the hardware watermark will remain unset.
>>  
>> @@ -1533,6 +1547,7 @@ Description:
>>  		A single positive integer specifying the maximum watermark level
>>  		for the hardware fifo of this device. If the device does not
>>  		have a hardware fifo this entry is not present.
>> +
>>  		If the user sets buffer/watermark to a value greater than this
>>  		one, then the hardware watermark will be capped at this value.
>>  
>> @@ -1544,6 +1559,7 @@ Description:
>>  		levels for the hardware fifo. This entry is optional and if it
>>  		is not present it means that all the values between
>>  		hwfifo_watermark_min and hwfifo_watermark_max are supported.
>> +
>>  		If the user sets buffer/watermark to a value greater than
>>  		hwfifo_watermak_min but not equal to any of the values in this
>>  		list, the driver will chose an appropriate value for the
>> @@ -1605,7 +1621,8 @@ KernelVersion:	4.1.0
>>  Contact:	linux-iio@vger.kernel.org
>>  Description:
>>  		'1' (enable) or '0' (disable) specifying the enable
>> -		of heater function. Same reading values apply
>> +		of heater function. Same reading values apply.
>> +
>>  		This ABI is especially applicable for humidity sensors
>>  		to heatup the device and get rid of any condensation
>>  		in some humidity environment
>> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435 b/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
>> index f30b4c424fb6..4b01150af397 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
>> +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
>> @@ -19,9 +19,11 @@ Description:
>>  		is separately set for "GND-Open" and "Supply-Open" modes.
>>  		Channels 0..31 have common low threshold values, but could have different
>>  		sensing_modes.
>> +
>>  		The low voltage threshold range is between 2..21V.
>>  		Hysteresis between low and high thresholds can not be lower then 2 and
>>  		can not be odd.
>> +
>>  		If falling threshold results hysteresis to odd value then rising
>>  		threshold is automatically subtracted by one.
>>  
>> @@ -34,10 +36,13 @@ Description:
>>  		this value then the threshold rising event is pushed.
>>  		Depending on in_voltageY_sensing_mode the high voltage threshold
>>  		is separately set for "GND-Open" and "Supply-Open" modes.
>> +
>>  		Channels 0..31 have common high threshold values, but could have different
>>  		sensing_modes.
>> +
>>  		The high voltage threshold range is between 3..22V.
>>  		Hysteresis between low and high thresholds can not be lower then 2 and
>>  		can not be odd.
>> +
>>  		If rising threshold results hysteresis to odd value then falling
>>  		threshold is automatically appended by one.
>> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32 b/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
>> index efe4c85e3c8b..1975c7a1af34 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
>> +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
>> @@ -5,10 +5,13 @@ Description:
>>  		The STM32 ADC can be configured to use external trigger sources
>>  		(e.g. timers, pwm or exti gpio). Then, it can be tuned to start
>>  		conversions on external trigger by either:
>> +
>>  		- "rising-edge"
>>  		- "falling-edge"
>>  		- "both-edges".
>> +
>>  		Reading returns current trigger polarity.
>> +
>>  		Writing value before enabling conversions sets trigger polarity.
>>  
>>  What:		/sys/bus/iio/devices/triggerX/trigger_polarity_available
>> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
>> index a133fd8d081a..40df5c9fef99 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
>> +++ b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
>> @@ -15,8 +15,11 @@ Description:
>>  		first object echoed in meters. Default value is 6.020.
>>  		This setting limits the time the driver is waiting for a
>>  		echo.
>> +
>>  		Showing the range of available values is represented as the
>>  		minimum value, the step and the maximum value, all enclosed
>>  		in square brackets.
>> -		Example:
>> -		[0.043 0.043 11.008]
>> +
>> +		Example::
>> +
>> +			[0.043 0.043 11.008]
>> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
>> index a91aeabe7b24..d065cda7dd96 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
>> +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
>> @@ -8,7 +8,9 @@ KernelVersion:	3.4.0
>>  Contact:	linux-iio@vger.kernel.org
>>  Description:
>>  		Reading returns either '1' or '0'.
>> +
>>  		'1' means that the clock in question is present.
>> +
>>  		'0' means that the clock is missing.
>>  
>>  What:		/sys/bus/iio/devices/iio:deviceX/pllY_locked
>> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
>> index 302de64cb424..544548ee794c 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
>> +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
>> @@ -27,12 +27,12 @@ What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_name
>>  KernelVersion:
>>  Contact:	linux-iio@vger.kernel.org
>>  Description:
>> -		Reading returns the datasheet name for channel Y:
>> +		Reading returns the datasheet name for channel Y::
>>  
>> -		out_altvoltage0_name: RF8x
>> -		out_altvoltage1_name: RFAUX8x
>> -		out_altvoltage2_name: RF16x
>> -		out_altvoltage3_name: RF32x
>> +		  out_altvoltage0_name: RF8x
>> +		  out_altvoltage1_name: RFAUX8x
>> +		  out_altvoltage2_name: RF16x
>> +		  out_altvoltage3_name: RF32x
>>  
>>  What:		/sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
>>  KernelVersion:
>> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x b/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
>> index 6adba9058b22..66b621f10223 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
>> +++ b/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
>> @@ -6,10 +6,14 @@ Description:
>>  		Get measured values from the ADC for these stages. Y is the
>>  		specific stage number corresponding to datasheet stage names
>>  		as follows:
>> -		1 -> LED2
>> -		2 -> ALED2/LED3
>> -		3 -> LED1
>> -		4 -> ALED1/LED4
>> +
>> +		== ==========
>> +		1  LED2
>> +		2  ALED2/LED3
>> +		3  LED1
>> +		4  ALED1/LED4
>> +		== ==========
>> +
>>  		Note that channels 5 and 6 represent LED2-ALED2 and LED1-ALED1
>>  		respectively which simply helper channels containing the
>>  		calculated difference in the value of stage 1 - 2 and 3 - 4.
>> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018 b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
>> index f0ce0a0476ea..220206a20d98 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
>> +++ b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
>> @@ -15,5 +15,7 @@ Description:
>>  		Scheme 0 has wider dynamic range, Scheme 1 proximity detection
>>  		is less affected by the ambient IR noise variation.
>>  
>> -		0 Sensing IR from LED and ambient
>> -		1 Sensing IR from LED with ambient IR rejection
>> +		== =============================================
>> +		0  Sensing IR from LED and ambient
>> +		1  Sensing IR from LED with ambient IR rejection
>> +		== =============================================
>> diff --git a/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth b/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth
>> index 22d0843849a8..b7b2278fe042 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth
>> +++ b/Documentation/ABI/testing/sysfs-bus-intel_th-devices-gth
>> @@ -10,10 +10,13 @@ Date:		June 2015
>>  KernelVersion:	4.3
>>  Contact:	Alexander Shishkin <alexander.shishkin@linux.intel.com>
>>  Description:	(RO) Output port type:
>> -		  0: not present,
>> -		  1: MSU (Memory Storage Unit)
>> -		  2: CTP (Common Trace Port)
>> -		  4: PTI (MIPI PTI).
>> +
>> +		 ==  =========================
>> +		  0  not present,
>> +		  1  MSU (Memory Storage Unit)
>> +		  2  CTP (Common Trace Port)
>> +		  4  PTI (MIPI PTI).
>> +		 ==  =========================
>>  
>>  What:		/sys/bus/intel_th/devices/<intel_th_id>-gth/outputs/[0-7]_drop
>>  Date:		June 2015
>> diff --git a/Documentation/ABI/testing/sysfs-bus-papr-pmem b/Documentation/ABI/testing/sysfs-bus-papr-pmem
>> index c1a67275c43f..8316c33862a0 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-papr-pmem
>> +++ b/Documentation/ABI/testing/sysfs-bus-papr-pmem
>> @@ -11,19 +11,26 @@ Description:
>>  		at 'Documentation/powerpc/papr_hcalls.rst' . Below are
>>  		the flags reported in this sysfs file:
>>  
>> -		* "not_armed"	: Indicates that NVDIMM contents will not
>> +		* "not_armed"
>> +				  Indicates that NVDIMM contents will not
>>  				  survive a power cycle.
>> -		* "flush_fail"	: Indicates that NVDIMM contents
>> +		* "flush_fail"
>> +				  Indicates that NVDIMM contents
>>  				  couldn't be flushed during last
>>  				  shut-down event.
>> -		* "restore_fail": Indicates that NVDIMM contents
>> +		* "restore_fail"
>> +				  Indicates that NVDIMM contents
>>  				  couldn't be restored during NVDIMM
>>  				  initialization.
>> -		* "encrypted"	: NVDIMM contents are encrypted.
>> -		* "smart_notify": There is health event for the NVDIMM.
>> -		* "scrubbed"	: Indicating that contents of the
>> +		* "encrypted"
>> +				  NVDIMM contents are encrypted.
>> +		* "smart_notify"
>> +				  There is health event for the NVDIMM.
>> +		* "scrubbed"
>> +				  Indicating that contents of the
>>  				  NVDIMM have been scrubbed.
>> -		* "locked"	: Indicating that NVDIMM contents cant
>> +		* "locked"
>> +				  Indicating that NVDIMM contents cant
>>  				  be modified until next power cycle.
>>  
>>  What:		/sys/bus/nd/devices/nmemX/papr/perf_stats
>> @@ -51,4 +58,4 @@ Description:
>>  		* "MedWDur " : Media Write Duration
>>  		* "CchRHCnt" : Cache Read Hit Count
>>  		* "CchWHCnt" : Cache Write Hit Count
>> -		* "FastWCnt" : Fast Write Count
>> \ No newline at end of file
>> +		* "FastWCnt" : Fast Write Count
>> diff --git a/Documentation/ABI/testing/sysfs-bus-pci b/Documentation/ABI/testing/sysfs-bus-pci
>> index 450296cc7948..77ad9ec3c801 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-pci
>> +++ b/Documentation/ABI/testing/sysfs-bus-pci
>> @@ -7,8 +7,10 @@ Description:
>>  		this location.	This is useful for overriding default
>>  		bindings.  The format for the location is: DDDD:BB:DD.F.
>>  		That is Domain:Bus:Device.Function and is the same as
>> -		found in /sys/bus/pci/devices/.  For example:
>> -		# echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind
>> +		found in /sys/bus/pci/devices/.  For example::
>> +
>> +		  # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/bind
>> +
>>  		(Note: kernels before 2.6.28 may require echo -n).
>>  
>>  What:		/sys/bus/pci/drivers/.../unbind
>> @@ -20,8 +22,10 @@ Description:
>>  		this location.	This may be useful when overriding default
>>  		bindings.  The format for the location is: DDDD:BB:DD.F.
>>  		That is Domain:Bus:Device.Function and is the same as
>> -		found in /sys/bus/pci/devices/. For example:
>> -		# echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind
>> +		found in /sys/bus/pci/devices/. For example::
>> +
>> +		  # echo 0000:00:19.0 > /sys/bus/pci/drivers/foo/unbind
>> +
>>  		(Note: kernels before 2.6.28 may require echo -n).
>>  
>>  What:		/sys/bus/pci/drivers/.../new_id
>> @@ -38,8 +42,9 @@ Description:
>>  		Class, Class Mask, and Private Driver Data.  The Vendor ID
>>  		and Device ID fields are required, the rest are optional.
>>  		Upon successfully adding an ID, the driver will probe
>> -		for the device and attempt to bind to it.  For example:
>> -		# echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id
>> +		for the device and attempt to bind to it.  For example::
>> +
>> +		  # echo "8086 10f5" > /sys/bus/pci/drivers/foo/new_id
>>  
>>  What:		/sys/bus/pci/drivers/.../remove_id
>>  Date:		February 2009
>> @@ -54,8 +59,9 @@ Description:
>>  		required, the rest are optional.  After successfully
>>  		removing an ID, the driver will no longer support the
>>  		device.  This is useful to ensure auto probing won't
>> -		match the driver to the device.  For example:
>> -		# echo "8086 10f5" > /sys/bus/pci/drivers/foo/remove_id
>> +		match the driver to the device.  For example::
>> +
>> +		  # echo "8086 10f5" > /sys/bus/pci/drivers/foo/remove_id
>>  
>>  What:		/sys/bus/pci/rescan
>>  Date:		January 2009
>> diff --git a/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt b/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt
>> index 8a200f4eefbd..f85db86d63e8 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt
>> +++ b/Documentation/ABI/testing/sysfs-bus-pci-devices-catpt
>> @@ -4,6 +4,7 @@ Contact:	Cezary Rojewski <cezary.rojewski@intel.com>
>>  Description:
>>  		Version of AudioDSP firmware ASoC catpt driver is
>>  		communicating with.
>> +
>>  		Format: %d.%d.%d.%d, type:major:minor:build.
>>  
>>  What:		/sys/devices/pci0000:00/<dev>/fw_info
>> diff --git a/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd b/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd
>> index 60c60fa624b2..c90d97a80855 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd
>> +++ b/Documentation/ABI/testing/sysfs-bus-pci-drivers-ehci_hcd
>> @@ -21,11 +21,11 @@ Description:
>>  		number returns the port to normal operation.
>>  
>>  		For example: To force the high-speed device attached to
>> -		port 4 on bus 2 to run at full speed:
>> +		port 4 on bus 2 to run at full speed::
>>  
>>  			echo 4 >/sys/bus/usb/devices/usb2/../companion
>>  
>> -		To return the port to high-speed operation:
>> +		To return the port to high-speed operation::
>>  
>>  			echo -4 >/sys/bus/usb/devices/usb2/../companion
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-bus-rbd b/Documentation/ABI/testing/sysfs-bus-rbd
>> index cc30bee8b5f4..417a2fe21be1 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-rbd
>> +++ b/Documentation/ABI/testing/sysfs-bus-rbd
>> @@ -7,6 +7,8 @@ Description:
>>  
>>  		Usage: <mon ip addr> <options> <pool name> <rbd image name> [<snap name>]
>>  
>> +		Example::
>> +
>>  		 $ echo "192.168.0.1 name=admin rbd foo" > /sys/bus/rbd/add
>>  
>>  		The snapshot name can be "-" or omitted to map the image
>> @@ -23,6 +25,8 @@ Description:
>>  
>>  		Usage: <dev-id> [force]
>>  
>> +		Example::
>> +
>>  		 $ echo 2 > /sys/bus/rbd/remove
>>  
>>  		Optional "force" argument which when passed will wait for
>> @@ -80,26 +84,29 @@ Date:		Oct, 2010
>>  KernelVersion:	v2.6.37
>>  Contact:	Sage Weil <sage@newdream.net>
>>  Description:
>> -		size:		(RO) The size (in bytes) of the mapped block
>> +
>> +		==============	================================================
>> +		size		(RO) The size (in bytes) of the mapped block
>>  				device.
>>  
>> -		major:		(RO) The block device major number.
>> +		major		(RO) The block device major number.
>>  
>> -		client_id:	(RO) The ceph unique client id that was assigned
>> +		client_id	(RO) The ceph unique client id that was assigned
>>  				for this specific session.
>>  
>> -		pool:		(RO) The name of the storage pool where this rbd
>> +		pool		(RO) The name of the storage pool where this rbd
>>  				image resides. An rbd image name is unique
>>  				within its pool.
>>  
>> -		name:		(RO) The name of the rbd image.
>> +		name		(RO) The name of the rbd image.
>>  
>> -		refresh:	(WO) Writing to this file will reread the image
>> +		refresh		(WO) Writing to this file will reread the image
>>  				header data and set all relevant data structures
>>  				accordingly.
>>  
>> -		current_snap:	(RO) The current snapshot for which the device
>> +		current_snap	(RO) The current snapshot for which the device
>>  				is mapped.
>> +		==============	================================================
>>  
>>  
>>  What:		/sys/bus/rbd/devices/<dev-id>/pool_id
>> @@ -117,11 +124,13 @@ Date:		Oct, 2012
>>  KernelVersion:	v3.7
>>  Contact:	Sage Weil <sage@newdream.net>
>>  Description:
>> -		image_id:	(RO) The unique id for the rbd image. (For rbd
>> +		=========	===============================================
>> +		image_id	(RO) The unique id for the rbd image. (For rbd
>>  				image format 1 this is empty.)
>>  
>> -		features:	(RO) A hexadecimal encoding of the feature bits
>> +		features	(RO) A hexadecimal encoding of the feature bits
>>  				for this image.
>> +		=========	===============================================
>>  
>>  
>>  What:		/sys/bus/rbd/devices/<dev-id>/parent
>> @@ -149,14 +158,16 @@ Date:		Aug, 2016
>>  KernelVersion:	v4.9
>>  Contact:	Sage Weil <sage@newdream.net>
>>  Description:
>> -		snap_id:	(RO) The current snapshot's id.
>> +		============	================================================
>> +		snap_id		(RO) The current snapshot's id.
>>  
>> -		config_info:	(RO) The string written into
>> +		config_info	(RO) The string written into
>>  				/sys/bus/rbd/add{,_single_major}.
>>  
>> -		cluster_fsid:	(RO) The ceph cluster UUID.
>> +		cluster_fsid	(RO) The ceph cluster UUID.
>>  
>> -		client_addr:	(RO) The ceph unique client
>> +		client_addr	(RO) The ceph unique client
>>  				entity_addr_t (address + nonce). The format is
>>  				<address>:<port>/<nonce>: '1.2.3.4:1234/5678' or
>>  				'[1:2:3:4:5:6:7:8]:1234/5678'.
>> +		============	================================================
>> diff --git a/Documentation/ABI/testing/sysfs-bus-siox b/Documentation/ABI/testing/sysfs-bus-siox
>> index c2a403f20b90..50e80238f30d 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-siox
>> +++ b/Documentation/ABI/testing/sysfs-bus-siox
>> @@ -8,6 +8,7 @@ Description:
>>  		When the file contains a "1" the bus is operated and periodically
>>  		does a push-pull cycle to write and read data from the
>>  		connected devices.
>> +
>>  		When writing a "0" or "1" the bus moves to the described state.
>>  
>>  What:		/sys/bus/siox/devices/siox-X/device_add
>> @@ -21,8 +22,10 @@ Description:
>>  		to add a new device dynamically. <type> is the name that is used to match
>>  		to a driver (similar to the platform bus). <inbytes> and <outbytes> define
>>  		the length of the input and output shift register in bytes respectively.
>> +
>>  		<statustype> defines the 4 bit device type that is check to identify connection
>>  		problems.
>> +
>>  		The new device is added to the end of the existing chain.
>>  
>>  What:		/sys/bus/siox/devices/siox-X/device_remove
>> diff --git a/Documentation/ABI/testing/sysfs-bus-thunderbolt b/Documentation/ABI/testing/sysfs-bus-thunderbolt
>> index 171127294674..0b4ab9e4b8f4 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-thunderbolt
>> +++ b/Documentation/ABI/testing/sysfs-bus-thunderbolt
>> @@ -193,10 +193,11 @@ Description:	When new NVM image is written to the non-active NVM
>>  		verification fails an error code is returned instead.
>>  
>>  		This file will accept writing values "1" or "2"
>> +
>>  		- Writing "1" will flush the image to the storage
>> -		area and authenticate the image in one action.
>> +		  area and authenticate the image in one action.
>>  		- Writing "2" will run some basic validation on the image
>> -		and flush it to the storage area.
>> +		  and flush it to the storage area.
>>  
>>  		When read holds status of the last authentication
>>  		operation if an error occurred during the process. This
>> @@ -213,9 +214,11 @@ Description:	This contains name of the property directory the XDomain
>>  		question. Following directories are already reserved by
>>  		the Apple XDomain specification:
>>  
>> -		network:  IP/ethernet over Thunderbolt
>> -		targetdm: Target disk mode protocol over Thunderbolt
>> -		extdisp:  External display mode protocol over Thunderbolt
>> +		========  ===============================================
>> +		network   IP/ethernet over Thunderbolt
>> +		targetdm  Target disk mode protocol over Thunderbolt
>> +		extdisp   External display mode protocol over Thunderbolt
>> +		========  ===============================================
>>  
>>  What:		/sys/bus/thunderbolt/devices/<xdomain>.<service>/modalias
>>  Date:		Jan 2018
>> @@ -293,7 +296,8 @@ Description:	For supported devices, automatically authenticate the new Thunderbo
>>  		image when the device is disconnected from the host system.
>>  
>>  		This file will accept writing values "1" or "2"
>> +
>>  		- Writing "1" will flush the image to the storage
>> -		area and prepare the device for authentication on disconnect.
>> +		  area and prepare the device for authentication on disconnect.
>>  		- Writing "2" will run some basic validation on the image
>> -		and flush it to the storage area.
>> +		  and flush it to the storage area.
>> diff --git a/Documentation/ABI/testing/sysfs-bus-usb b/Documentation/ABI/testing/sysfs-bus-usb
>> index e449b8374f6a..bf2c1968525f 100644
>> --- a/Documentation/ABI/testing/sysfs-bus-usb
>> +++ b/Documentation/ABI/testing/sysfs-bus-usb
>> @@ -9,6 +9,7 @@ Description:
>>  		by writing INTERFACE to /sys/bus/usb/drivers_probe
>>  		This allows to avoid side-effects with drivers
>>  		that need multiple interfaces.
>> +
>>  		A deauthorized interface cannot be probed or claimed.
>>  
>>  What:		/sys/bus/usb/devices/usbX/interface_authorized_default
>> @@ -216,6 +217,7 @@ Description:
>>  		 - Bit 0 of this field selects the "old" enumeration scheme,
>>  		   as it is considerably faster (it only causes one USB reset
>>  		   instead of 2).
>> +
>>  		   The old enumeration scheme can also be selected globally
>>  		   using /sys/module/usbcore/parameters/old_scheme_first, but
>>  		   it is often not desirable as the new scheme was introduced to
>> diff --git a/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533 b/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533
>> index c0e0a9ae7b3d..8251e78abc49 100644
>> --- a/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533
>> +++ b/Documentation/ABI/testing/sysfs-class-backlight-driver-lm3533
>> @@ -6,8 +6,10 @@ Description:
>>  		Get the ALS output channel used as input in
>>  		ALS-current-control mode (0, 1), where:
>>  
>> -		0 - out_current0 (backlight 0)
>> -		1 - out_current1 (backlight 1)
>> +		==  ==========================
>> +		0   out_current0 (backlight 0)
>> +		1   out_current1 (backlight 1)
>> +		==  ==========================
>>  
>>  What:		/sys/class/backlight/<backlight>/als_en
>>  Date:		May 2012
>> @@ -30,8 +32,10 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>>  Description:
>>  		Set the brightness-mapping mode (0, 1), where:
>>  
>> -		0 - exponential mode
>> -		1 - linear mode
>> +		==  ================
>> +		0   exponential mode
>> +		1   linear mode
>> +		==  ================
>>  
>>  What:		/sys/class/backlight/<backlight>/pwm
>>  Date:		April 2012
>> @@ -40,9 +44,11 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>>  Description:
>>  		Set the PWM-input control mask (5 bits), where:
>>  
>> -		bit 5 - PWM-input enabled in Zone 4
>> -		bit 4 - PWM-input enabled in Zone 3
>> -		bit 3 - PWM-input enabled in Zone 2
>> -		bit 2 - PWM-input enabled in Zone 1
>> -		bit 1 - PWM-input enabled in Zone 0
>> -		bit 0 - PWM-input enabled
>> +		=====   ===========================
>> +		bit 5   PWM-input enabled in Zone 4
>> +		bit 4   PWM-input enabled in Zone 3
>> +		bit 3   PWM-input enabled in Zone 2
>> +		bit 2   PWM-input enabled in Zone 1
>> +		bit 1   PWM-input enabled in Zone 0
>> +		bit 0   PWM-input enabled
>> +		=====   ===========================
>> diff --git a/Documentation/ABI/testing/sysfs-class-bdi b/Documentation/ABI/testing/sysfs-class-bdi
>> index d773d5697cf5..5402bd74ba43 100644
>> --- a/Documentation/ABI/testing/sysfs-class-bdi
>> +++ b/Documentation/ABI/testing/sysfs-class-bdi
>> @@ -24,7 +24,6 @@ default
>>  	filesystems which do not provide their own BDI.
>>  
>>  Files under /sys/class/bdi/<bdi>/
>> ----------------------------------
>>  
>>  read_ahead_kb (read-write)
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-class-chromeos b/Documentation/ABI/testing/sysfs-class-chromeos
>> index 5819699d66ec..74ece942722e 100644
>> --- a/Documentation/ABI/testing/sysfs-class-chromeos
>> +++ b/Documentation/ABI/testing/sysfs-class-chromeos
>> @@ -17,13 +17,14 @@ Date:		August 2015
>>  KernelVersion:	4.2
>>  Description:
>>  		Tell the EC to reboot in various ways. Options are:
>> -		"cancel": Cancel a pending reboot.
>> -		"ro": Jump to RO without rebooting.
>> -		"rw": Jump to RW without rebooting.
>> -		"cold": Cold reboot.
>> -		"disable-jump": Disable jump until next reboot.
>> -		"hibernate": Hibernate the EC.
>> -		"at-shutdown": Reboot after an AP shutdown.
>> +
>> +		- "cancel": Cancel a pending reboot.
>> +		- "ro": Jump to RO without rebooting.
>> +		- "rw": Jump to RW without rebooting.
>> +		- "cold": Cold reboot.
>> +		- "disable-jump": Disable jump until next reboot.
>> +		- "hibernate": Hibernate the EC.
>> +		- "at-shutdown": Reboot after an AP shutdown.
>>  
>>  What:		/sys/class/chromeos/<ec-device-name>/version
>>  Date:		August 2015
>> diff --git a/Documentation/ABI/testing/sysfs-class-cxl b/Documentation/ABI/testing/sysfs-class-cxl
>> index a6f51a104c44..818f55970efb 100644
>> --- a/Documentation/ABI/testing/sysfs-class-cxl
>> +++ b/Documentation/ABI/testing/sysfs-class-cxl
>> @@ -217,6 +217,7 @@ Description:    read/write
>>                  card.  A power cycle is required to load the image.
>>                  "none" could be useful for debugging because the trace arrays
>>                  are preserved.
>> +
>>                  "user" and "factory" means PERST will cause either the user or
>>                  user or factory image to be loaded.
>>                  Default is to reload on PERST whichever image the card has
>> @@ -240,8 +241,11 @@ Contact:	linuxppc-dev@lists.ozlabs.org
>>  Description:	read/write
>>  		Trust that when an image is reloaded via PERST, it will not
>>  		have changed.
>> -		0 = don't trust, the image may be different (default)
>> -		1 = trust that the image will not change.
>> +
>> +		==  =================================================
>> +		0   don't trust, the image may be different (default)
>> +		1   trust that the image will not change.
>> +		==  =================================================
>>  Users:		https://github.com/ibm-capi/libcxl
>>  
>>  What:           /sys/class/cxl/<card>/psl_timebase_synced
>> diff --git a/Documentation/ABI/testing/sysfs-class-devlink b/Documentation/ABI/testing/sysfs-class-devlink
>> index 64791b65c9a3..b662f747c83e 100644
>> --- a/Documentation/ABI/testing/sysfs-class-devlink
>> +++ b/Documentation/ABI/testing/sysfs-class-devlink
>> @@ -18,9 +18,9 @@ Description:
>>  
>>  		This will be one of the following strings:
>>  
>> -		'consumer unbind'
>> -		'supplier unbind'
>> -		'never'
>> +		- 'consumer unbind'
>> +		- 'supplier unbind'
>> +		- 'never'
>>  
>>  		'consumer unbind' means the device link will be removed when
>>  		the consumer's driver is unbound from the consumer device.
>> @@ -49,8 +49,10 @@ Description:
>>  
>>  		This will be one of the following strings:
>>  
>> -		'0' - Does not affect runtime power management
>> -		'1' - Affects runtime power management
>> +		===   ========================================
>> +		'0'   Does not affect runtime power management
>> +		'1'   Affects runtime power management
>> +		===   ========================================
>>  
>>  What:		/sys/class/devlink/.../status
>>  Date:		May 2020
>> @@ -68,13 +70,13 @@ Description:
>>  
>>  		This will be one of the following strings:
>>  
>> -		'not tracked'
>> -		'dormant'
>> -		'available'
>> -		'consumer probing'
>> -		'active'
>> -		'supplier unbinding'
>> -		'unknown'
>> +		- 'not tracked'
>> +		- 'dormant'
>> +		- 'available'
>> +		- 'consumer probing'
>> +		- 'active'
>> +		- 'supplier unbinding'
>> +		- 'unknown'
>>  
>>  		'not tracked' means this device link does not track the status
>>  		and has no impact on the binding, unbinding and syncing the
>> @@ -114,8 +116,10 @@ Description:
>>  
>>  		This will be one of the following strings:
>>  
>> +		===  ================================
>>  		'0'
>> -		'1' - Affects runtime power management
>> +		'1'  Affects runtime power management
>> +		===  ================================
>>  
>>  		'0' means the device link can affect other device behaviors
>>  		like binding/unbinding, suspend/resume, runtime power
>> diff --git a/Documentation/ABI/testing/sysfs-class-extcon b/Documentation/ABI/testing/sysfs-class-extcon
>> index 57a726232912..fde0fecd5de9 100644
>> --- a/Documentation/ABI/testing/sysfs-class-extcon
>> +++ b/Documentation/ABI/testing/sysfs-class-extcon
>> @@ -39,19 +39,22 @@ Description:
>>  		callback.
>>  
>>  		If the default callback for showing function is used, the
>> -		format is like this:
>> -		# cat state
>> -		USB_OTG=1
>> -		HDMI=0
>> -		TA=1
>> -		EAR_JACK=0
>> -		#
>> +		format is like this::
>> +
>> +		    # cat state
>> +		    USB_OTG=1
>> +		    HDMI=0
>> +		    TA=1
>> +		    EAR_JACK=0
>> +		    #
>> +
>>  		In this example, the extcon device has USB_OTG and TA
>>  		cables attached and HDMI and EAR_JACK cables detached.
>>  
>>  		In order to update the state of an extcon device, enter a hex
>> -		state number starting with 0x:
>> -		# echo 0xHEX > state
>> +		state number starting with 0x::
>> +
>> +		    # echo 0xHEX > state
>>  
>>  		This updates the whole state of the extcon device.
>>  		Inputs of all the methods are required to meet the
>> @@ -84,12 +87,13 @@ Contact:	MyungJoo Ham <myungjoo.ham@samsung.com>
>>  Description:
>>  		Shows the relations of mutually exclusiveness. For example,
>>  		if the mutually_exclusive array of extcon device is
>> -		{0x3, 0x5, 0xC, 0x0}, then the output is:
>> -		# ls mutually_exclusive/
>> -		0x3
>> -		0x5
>> -		0xc
>> -		#
>> +		{0x3, 0x5, 0xC, 0x0}, then the output is::
>> +
>> +		    # ls mutually_exclusive/
>> +		    0x3
>> +		    0x5
>> +		    0xc
>> +		    #
>>  
>>  		Note that mutually_exclusive is a sub-directory of the extcon
>>  		device and the file names under the mutually_exclusive
>> diff --git a/Documentation/ABI/testing/sysfs-class-fpga-manager b/Documentation/ABI/testing/sysfs-class-fpga-manager
>> index 5284fa33d4c5..d78689c357a5 100644
>> --- a/Documentation/ABI/testing/sysfs-class-fpga-manager
>> +++ b/Documentation/ABI/testing/sysfs-class-fpga-manager
>> @@ -28,8 +28,7 @@ Description:	Read fpga manager state as a string.
>>  		* firmware request	= firmware class request in progress
>>  		* firmware request error = firmware request failed
>>  		* write init		= preparing FPGA for programming
>> -		* write init error	= Error while preparing FPGA for
>> -					  programming
>> +		* write init error	= Error while preparing FPGA for programming
>>  		* write			= FPGA ready to receive image data
>>  		* write error		= Error while programming
>>  		* write complete	= Doing post programming steps
>> @@ -47,7 +46,7 @@ Description:	Read fpga manager status as a string.
>>  		programming errors to userspace. This is a list of strings for
>>  		the supported status.
>>  
>> -		* reconfig operation error 	- invalid operations detected by
>> +		* reconfig operation error	- invalid operations detected by
>>  						  reconfiguration hardware.
>>  						  e.g. start reconfiguration
>>  						  with errors not cleared
>> diff --git a/Documentation/ABI/testing/sysfs-class-gnss b/Documentation/ABI/testing/sysfs-class-gnss
>> index 2467b6900eae..c8553d972edd 100644
>> --- a/Documentation/ABI/testing/sysfs-class-gnss
>> +++ b/Documentation/ABI/testing/sysfs-class-gnss
>> @@ -6,9 +6,11 @@ Description:
>>  		The GNSS receiver type. The currently identified types reflect
>>  		the protocol(s) supported by the receiver:
>>  
>> +			======		===========
>>  			"NMEA"		NMEA 0183
>>  			"SiRF"		SiRF Binary
>>  			"UBX"		UBX
>> +			======		===========
>>  
>>  		Note that also non-"NMEA" type receivers typically support a
>>  		subset of NMEA 0183 with vendor extensions (e.g. to allow
>> diff --git a/Documentation/ABI/testing/sysfs-class-led b/Documentation/ABI/testing/sysfs-class-led
>> index 65e040978f73..0ed5c2629c6f 100644
>> --- a/Documentation/ABI/testing/sysfs-class-led
>> +++ b/Documentation/ABI/testing/sysfs-class-led
>> @@ -47,6 +47,7 @@ Contact:	Richard Purdie <rpurdie@rpsys.net>
>>  Description:
>>  		Set the trigger for this LED. A trigger is a kernel based source
>>  		of LED events.
>> +
>>  		You can change triggers in a similar manner to the way an IO
>>  		scheduler is chosen. Trigger specific parameters can appear in
>>  		/sys/class/leds/<led> once a given trigger is selected. For
>> diff --git a/Documentation/ABI/testing/sysfs-class-led-driver-el15203000 b/Documentation/ABI/testing/sysfs-class-led-driver-el15203000
>> index 69befe947d7e..da546e86deb5 100644
>> --- a/Documentation/ABI/testing/sysfs-class-led-driver-el15203000
>> +++ b/Documentation/ABI/testing/sysfs-class-led-driver-el15203000
>> @@ -27,23 +27,23 @@ Description:
>>  
>>  			^
>>  			|
>> -		    0 On -|----+                   +----+                   +---
>> +		  0 On -|----+                   +----+                   +---
>>  			|    |                   |    |                   |
>>  		    Off-|    +-------------------+    +-------------------+
>>  			|
>> -		    1 On -|    +----+                   +----+
>> +		  1 On -|    +----+                   +----+
>>  			|    |    |                   |    |
>>  		    Off |----+    +-------------------+    +------------------
>>  			|
>> -		    2 On -|         +----+                   +----+
>> +		  2 On -|         +----+                   +----+
>>  			|         |    |                   |    |
>>  		    Off-|---------+    +-------------------+    +-------------
>>  			|
>> -		    3 On -|              +----+                   +----+
>> +		  3 On -|              +----+                   +----+
>>  			|              |    |                   |    |
>>  		    Off-|--------------+    +-------------------+    +--------
>>  			|
>> -		    4 On -|                   +----+                   +----+
>> +		  4 On -|                   +----+                   +----+
>>  			|                   |    |                   |    |
>>  		    Off-|-------------------+    +-------------------+    +---
>>  			|
>> @@ -55,23 +55,23 @@ Description:
>>  
>>  			^
>>  			|
>> -		    0 On -|    +-------------------+    +-------------------+
>> +		  0 On -|    +-------------------+    +-------------------+
>>  			|    |                   |    |                   |
>>  		    Off-|----+                   +----+                   +---
>>  			|
>> -		    1 On -|----+    +-------------------+    +------------------
>> +		  1 On -|----+    +-------------------+    +------------------
>>  			|    |    |                   |    |
>>  		    Off |    +----+                   +----+
>>  			|
>> -		    2 On -|---------+    +-------------------+    +-------------
>> +		  2 On -|---------+    +-------------------+    +-------------
>>  			|         |    |                   |    |
>>  		    Off-|         +----+                   +----+
>>  			|
>> -		    3 On -|--------------+    +-------------------+    +--------
>> +		  3 On -|--------------+    +-------------------+    +--------
>>  			|              |    |                   |    |
>>  		    Off-|              +----+                   +----+
>>  			|
>> -		    4 On -|-------------------+    +-------------------+    +---
>> +		  4 On -|-------------------+    +-------------------+    +---
>>  			|                   |    |                   |    |
>>  		    Off-|                   +----+                   +----+
>>  			|
>> @@ -83,23 +83,23 @@ Description:
>>  
>>  			^
>>  			|
>> -		    0 On -|----+                                       +--------
>> +		  0 On -|----+                                       +--------
>>  			|    |                                       |
>>  		    Off-|    +---------------------------------------+
>>  			|
>> -		    1 On -|    +----+                             +----+
>> +		  1 On -|    +----+                             +----+
>>  			|    |    |                             |    |
>>  		    Off |----+    +-----------------------------+    +--------
>>  			|
>> -		    2 On -|         +----+                   +----+
>> +		  2 On -|         +----+                   +----+
>>  			|         |    |                   |    |
>>  		    Off-|---------+    +-------------------+    +-------------
>>  			|
>> -		    3 On -|              +----+         +----+
>> +		  3 On -|              +----+         +----+
>>  			|              |    |         |    |
>>  		    Off-|--------------+    +---------+    +------------------
>>  			|
>> -		    4 On -|                   +---------+
>> +		  4 On -|                   +---------+
>>  			|                   |         |
>>  		    Off-|-------------------+         +-----------------------
>>  			|
>> diff --git a/Documentation/ABI/testing/sysfs-class-led-driver-lm3533 b/Documentation/ABI/testing/sysfs-class-led-driver-lm3533
>> index e4c89b261546..e38a835d0a85 100644
>> --- a/Documentation/ABI/testing/sysfs-class-led-driver-lm3533
>> +++ b/Documentation/ABI/testing/sysfs-class-led-driver-lm3533
>> @@ -6,8 +6,10 @@ Description:
>>  		Set the ALS output channel to use as input in
>>  		ALS-current-control mode (1, 2), where:
>>  
>> -		1 - out_current1
>> -		2 - out_current2
>> +		==  ============
>> +		1   out_current1
>> +		2   out_current2
>> +		==  ============
>>  
>>  What:		/sys/class/leds/<led>/als_en
>>  Date:		May 2012
>> @@ -24,14 +26,16 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>>  Description:
>>  		Set the pattern generator fall and rise times (0..7), where:
>>  
>> -		0 - 2048 us
>> -		1 - 262 ms
>> -		2 - 524 ms
>> -		3 - 1.049 s
>> -		4 - 2.097 s
>> -		5 - 4.194 s
>> -		6 - 8.389 s
>> -		7 - 16.78 s
>> +		==  =======
>> +		0   2048 us
>> +		1   262 ms
>> +		2   524 ms
>> +		3   1.049 s
>> +		4   2.097 s
>> +		5   4.194 s
>> +		6   8.389 s
>> +		7   16.78 s
>> +		==  =======
>>  
>>  What:		/sys/class/leds/<led>/id
>>  Date:		April 2012
>> @@ -47,8 +51,10 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>>  Description:
>>  		Set the brightness-mapping mode (0, 1), where:
>>  
>> -		0 - exponential mode
>> -		1 - linear mode
>> +		==  ================
>> +		0   exponential mode
>> +		1   linear mode
>> +		==  ================
>>  
>>  What:		/sys/class/leds/<led>/pwm
>>  Date:		April 2012
>> @@ -57,9 +63,11 @@ Contact:	Johan Hovold <jhovold@gmail.com>
>>  Description:
>>  		Set the PWM-input control mask (5 bits), where:
>>  
>> -		bit 5 - PWM-input enabled in Zone 4
>> -		bit 4 - PWM-input enabled in Zone 3
>> -		bit 3 - PWM-input enabled in Zone 2
>> -		bit 2 - PWM-input enabled in Zone 1
>> -		bit 1 - PWM-input enabled in Zone 0
>> -		bit 0 - PWM-input enabled
>> +		=====  ===========================
>> +		bit 5  PWM-input enabled in Zone 4
>> +		bit 4  PWM-input enabled in Zone 3
>> +		bit 3  PWM-input enabled in Zone 2
>> +		bit 2  PWM-input enabled in Zone 1
>> +		bit 1  PWM-input enabled in Zone 0
>> +		bit 0  PWM-input enabled
>> +		=====  ===========================
>> diff --git a/Documentation/ABI/testing/sysfs-class-led-flash b/Documentation/ABI/testing/sysfs-class-led-flash
>> index 220a0270b47b..11e5677c3672 100644
>> --- a/Documentation/ABI/testing/sysfs-class-led-flash
>> +++ b/Documentation/ABI/testing/sysfs-class-led-flash
>> @@ -55,26 +55,35 @@ Description:	read only
>>  		Flash faults are re-read after strobing the flash. Possible
>>  		flash faults:
>>  
>> -		* led-over-voltage - flash controller voltage to the flash LED
>> +		* led-over-voltage
>> +			flash controller voltage to the flash LED
>>  			has exceeded the limit specific to the flash controller
>> -		* flash-timeout-exceeded - the flash strobe was still on when
>> +		* flash-timeout-exceeded
>> +			the flash strobe was still on when
>>  			the timeout set by the user has expired; not all flash
>>  			controllers may set this in all such conditions
>> -		* controller-over-temperature - the flash controller has
>> +		* controller-over-temperature
>> +			the flash controller has
>>  			overheated
>> -		* controller-short-circuit - the short circuit protection
>> +		* controller-short-circuit
>> +			the short circuit protection
>>  			of the flash controller has been triggered
>> -		* led-power-supply-over-current - current in the LED power
>> +		* led-power-supply-over-current
>> +			current in the LED power
>>  			supply has exceeded the limit specific to the flash
>>  			controller
>> -		* indicator-led-fault - the flash controller has detected
>> +		* indicator-led-fault
>> +			the flash controller has detected
>>  			a short or open circuit condition on the indicator LED
>> -		* led-under-voltage - flash controller voltage to the flash
>> +		* led-under-voltage
>> +			flash controller voltage to the flash
>>  			LED has been below the minimum limit specific to
>>  			the flash
>> -		* controller-under-voltage - the input voltage of the flash
>> +		* controller-under-voltage
>> +			the input voltage of the flash
>>  			controller is below the limit under which strobing the
>>  			flash at full current will not be possible;
>>  			the condition persists until this flag is no longer set
>> -		* led-over-temperature - the temperature of the LED has exceeded
>> +		* led-over-temperature
>> +			the temperature of the LED has exceeded
>>  			its allowed upper limit
>> diff --git a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
>> index 451af6d6768c..646540950e38 100644
>> --- a/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
>> +++ b/Documentation/ABI/testing/sysfs-class-led-trigger-netdev
>> @@ -19,18 +19,23 @@ KernelVersion:	4.16
>>  Contact:	linux-leds@vger.kernel.org
>>  Description:
>>  		Signal the link state of the named network device.
>> +
>>  		If set to 0 (default), the LED's normal state is off.
>> +
>>  		If set to 1, the LED's normal state reflects the link state
>>  		of the named network device.
>>  		Setting this value also immediately changes the LED state.
>>  
>> +
>>  What:		/sys/class/leds/<led>/tx
>>  Date:		Dec 2017
>>  KernelVersion:	4.16
>>  Contact:	linux-leds@vger.kernel.org
>>  Description:
>>  		Signal transmission of data on the named network device.
>> +
>>  		If set to 0 (default), the LED will not blink on transmission.
>> +
>>  		If set to 1, the LED will blink for the milliseconds specified
>>  		in interval to signal transmission.
>>  
>> @@ -40,6 +45,8 @@ KernelVersion:	4.16
>>  Contact:	linux-leds@vger.kernel.org
>>  Description:
>>  		Signal reception of data on the named network device.
>> +
>>  		If set to 0 (default), the LED will not blink on reception.
>> +
>>  		If set to 1, the LED will blink for the milliseconds specified
>>  		in interval to signal reception.
>> diff --git a/Documentation/ABI/testing/sysfs-class-led-trigger-usbport b/Documentation/ABI/testing/sysfs-class-led-trigger-usbport
>> index f440e690daef..eb81152b8348 100644
>> --- a/Documentation/ABI/testing/sysfs-class-led-trigger-usbport
>> +++ b/Documentation/ABI/testing/sysfs-class-led-trigger-usbport
>> @@ -8,5 +8,6 @@ Description:
>>  		selected for the USB port trigger. Selecting ports makes trigger
>>  		observing them for any connected devices and lighting on LED if
>>  		there are any.
>> +
>>  		Echoing "1" value selects USB port. Echoing "0" unselects it.
>>  		Current state can be also read.
>> diff --git a/Documentation/ABI/testing/sysfs-class-leds-gt683r b/Documentation/ABI/testing/sysfs-class-leds-gt683r
>> index 6adab27f646e..b57ffb26e722 100644
>> --- a/Documentation/ABI/testing/sysfs-class-leds-gt683r
>> +++ b/Documentation/ABI/testing/sysfs-class-leds-gt683r
>> @@ -7,9 +7,11 @@ Description:
>>  		of one LED will update the mode of its two sibling devices as
>>  		well. Possible values are:
>>  
>> -		0 - normal
>> -		1 - audio
>> -		2 - breathing
>> +		==  =========
>> +		0   normal
>> +		1   audio
>> +		2   breathing
>> +		==  =========
>>  
>>  		Normal: LEDs are fully on when enabled
>>  		Audio:  LEDs brightness depends on sound level
>> diff --git a/Documentation/ABI/testing/sysfs-class-net b/Documentation/ABI/testing/sysfs-class-net
>> index 3b404577f380..7670012ae9b6 100644
>> --- a/Documentation/ABI/testing/sysfs-class-net
>> +++ b/Documentation/ABI/testing/sysfs-class-net
>> @@ -4,10 +4,13 @@ KernelVersion:	3.17
>>  Contact:	netdev@vger.kernel.org
>>  Description:
>>  		Indicates the name assignment type. Possible values are:
>> -		1: enumerated by the kernel, possibly in an unpredictable way
>> -		2: predictably named by the kernel
>> -		3: named by userspace
>> -		4: renamed
>> +
>> +		== ==========================================================
>> +		1  enumerated by the kernel, possibly in an unpredictable way
>> +		2  predictably named by the kernel
>> +		3  named by userspace
>> +		4  renamed
>> +		== ==========================================================
>>  
>>  What:		/sys/class/net/<iface>/addr_assign_type
>>  Date:		July 2010
>> @@ -15,10 +18,13 @@ KernelVersion:	3.2
>>  Contact:	netdev@vger.kernel.org
>>  Description:
>>  		Indicates the address assignment type. Possible values are:
>> -		0: permanent address
>> -		1: randomly generated
>> -		2: stolen from another device
>> -		3: set using dev_set_mac_address
>> +
>> +		== =============================
>> +		0  permanent address
>> +		1  randomly generated
>> +		2  stolen from another device
>> +		3  set using dev_set_mac_address
>> +		== =============================
>>  
>>  What:		/sys/class/net/<iface>/addr_len
>>  Date:		April 2005
>> @@ -51,9 +57,12 @@ Description:
>>  		Default value 0 does not forward any link local frames.
>>  
>>  		Restricted bits:
>> -		0: 01-80-C2-00-00-00 Bridge Group Address used for STP
>> -		1: 01-80-C2-00-00-01 (MAC Control) 802.3 used for MAC PAUSE
>> -		2: 01-80-C2-00-00-02 (Link Aggregation) 802.3ad
>> +
>> +		== ========================================================
>> +		0  01-80-C2-00-00-00 Bridge Group Address used for STP
>> +		1  01-80-C2-00-00-01 (MAC Control) 802.3 used for MAC PAUSE
>> +		2  01-80-C2-00-00-02 (Link Aggregation) 802.3ad
>> +		== ========================================================
>>  
>>  		Any values not setting these bits can be used. Take special
>>  		care when forwarding control frames e.g. 802.1X-PAE or LLDP.
>> @@ -74,8 +83,11 @@ Contact:	netdev@vger.kernel.org
>>  Description:
>>  		Indicates the current physical link state of the interface.
>>  		Posssible values are:
>> -		0: physical link is down
>> -		1: physical link is up
>> +
>> +		== =====================
>> +		0  physical link is down
>> +		1  physical link is up
>> +		== =====================
>>  
>>  		Note: some special devices, e.g: bonding and team drivers will
>>  		allow this attribute to be written to force a link state for
>> @@ -131,8 +143,11 @@ Contact:	netdev@vger.kernel.org
>>  Description:
>>  		Indicates whether the interface is under test. Possible
>>  		values are:
>> -		0: interface is not being tested
>> -		1: interface is being tested
>> +
>> +		== =============================
>> +		0  interface is not being tested
>> +		1  interface is being tested
>> +		== =============================
>>  
>>  		When an interface is under test, it cannot be expected
>>  		to pass packets as normal.
>> @@ -144,8 +159,11 @@ Contact:	netdev@vger.kernel.org
>>  Description:
>>  		Indicates the interface latest or current duplex value. Possible
>>  		values are:
>> -		half: half duplex
>> -		full: full duplex
>> +
>> +		====  ===========
>> +		half  half duplex
>> +		full  full duplex
>> +		====  ===========
>>  
>>  		Note: This attribute is only valid for interfaces that implement
>>  		the ethtool get_link_ksettings method (mostly Ethernet).
>> @@ -196,8 +214,11 @@ Description:
>>  		Indicates the interface link mode, as a decimal number. This
>>  		attribute should be used in conjunction with 'dormant' attribute
>>  		to determine the interface usability. Possible values:
>> -		0: default link mode
>> -		1: dormant link mode
>> +
>> +		==  =================
>> +		0   default link mode
>> +		1   dormant link mode
>> +		==  =================
>>  
>>  What:		/sys/class/net/<iface>/mtu
>>  Date:		April 2005
>> @@ -226,7 +247,9 @@ KernelVersion:	2.6.17
>>  Contact:	netdev@vger.kernel.org
>>  Description:
>>  		Indicates the interface RFC2863 operational state as a string.
>> +
>>  		Possible values are:
>> +
>>  		"unknown", "notpresent", "down", "lowerlayerdown", "testing",
>>  		"dormant", "up".
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-class-net-cdc_ncm b/Documentation/ABI/testing/sysfs-class-net-cdc_ncm
>> index f7be0e88b139..06416d0e163d 100644
>> --- a/Documentation/ABI/testing/sysfs-class-net-cdc_ncm
>> +++ b/Documentation/ABI/testing/sysfs-class-net-cdc_ncm
>> @@ -91,9 +91,9 @@ Date:		May 2014
>>  KernelVersion:	3.16
>>  Contact:	Bjørn Mork <bjorn@mork.no>
>>  Description:
>> -		Bit 0: 16-bit NTB supported (set to 1)
>> -		Bit 1: 32-bit NTB supported
>> -		Bits 2 – 15: reserved (reset to zero; must be ignored by host)
>> +		- Bit 0: 16-bit NTB supported (set to 1)
>> +		- Bit 1: 32-bit NTB supported
>> +		- Bits 2 – 15: reserved (reset to zero; must be ignored by host)
>>  
>>  What:		/sys/class/net/<iface>/cdc_ncm/dwNtbInMaxSize
>>  Date:		May 2014
>> diff --git a/Documentation/ABI/testing/sysfs-class-net-phydev b/Documentation/ABI/testing/sysfs-class-net-phydev
>> index 206cbf538b59..40ced0ea4316 100644
>> --- a/Documentation/ABI/testing/sysfs-class-net-phydev
>> +++ b/Documentation/ABI/testing/sysfs-class-net-phydev
>> @@ -35,7 +35,9 @@ Description:
>>  		Ethernet driver during bus enumeration, encoded in string.
>>  		This interface mode is used to configure the Ethernet MAC with the
>>  		appropriate mode for its data lines to the PHY hardware.
>> +
>>  		Possible values are:
>> +
>>  		<empty> (not available), mii, gmii, sgmii, tbi, rev-mii,
>>  		rmii, rgmii, rgmii-id, rgmii-rxid, rgmii-txid, rtbi, smii
>>  		xgmii, moca, qsgmii, trgmii, 1000base-x, 2500base-x, rxaui,
>> diff --git a/Documentation/ABI/testing/sysfs-class-pktcdvd b/Documentation/ABI/testing/sysfs-class-pktcdvd
>> index dde4f26d0780..ba1ce626591d 100644
>> --- a/Documentation/ABI/testing/sysfs-class-pktcdvd
>> +++ b/Documentation/ABI/testing/sysfs-class-pktcdvd
>> @@ -11,15 +11,17 @@ KernelVersion:	2.6.20
>>  Contact:	Thomas Maier <balagi@justmail.de>
>>  Description:
>>  
>> -		add:		(WO) Write a block device id (major:minor) to
>> +		==========	==============================================
>> +		add		(WO) Write a block device id (major:minor) to
>>  				create a new pktcdvd device and map it to the
>>  				block device.
>>  
>> -		remove:		(WO) Write the pktcdvd device id (major:minor)
>> +		remove		(WO) Write the pktcdvd device id (major:minor)
>>  				to remove the pktcdvd device.
>>  
>> -		device_map:	(RO) Shows the device mapping in format:
>> +		device_map	(RO) Shows the device mapping in format:
>>  				pktcdvd[0-7] <pktdevid> <blkdevid>
>> +		==========	==============================================
>>  
>>  
>>  What:		/sys/class/pktcdvd/pktcdvd[0-7]/dev
>> @@ -65,29 +67,31 @@ Date:		Oct. 2006
>>  KernelVersion:	2.6.20
>>  Contact:	Thomas Maier <balagi@justmail.de>
>>  Description:
>> -		size:		(RO) Contains the size of the bio write queue.
>> +		==============	================================================
>> +		size		(RO) Contains the size of the bio write queue.
>>  
>> -		congestion_off:	(RW) If bio write queue size is below this mark,
>> +		congestion_off	(RW) If bio write queue size is below this mark,
>>  				accept new bio requests from the block layer.
>>  
>> -		congestion_on:	(RW) If bio write queue size is higher as this
>> +		congestion_on	(RW) If bio write queue size is higher as this
>>  				mark, do no longer accept bio write requests
>>  				from the block layer and wait till the pktcdvd
>>  				device has processed enough bio's so that bio
>>  				write queue size is below congestion off mark.
>>  				A value of <= 0 disables congestion control.
>> +		==============	================================================
>>  
>>  
>>  Example:
>>  --------
>> -To use the pktcdvd sysfs interface directly, you can do:
>> +To use the pktcdvd sysfs interface directly, you can do::
>>  
>> -# create a new pktcdvd device mapped to /dev/hdc
>> -echo "22:0" >/sys/class/pktcdvd/add
>> -cat /sys/class/pktcdvd/device_map
>> -# assuming device pktcdvd0 was created, look at stat's
>> -cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written
>> -# print the device id of the mapped block device
>> -fgrep pktcdvd0 /sys/class/pktcdvd/device_map
>> -# remove device, using pktcdvd0 device id   253:0
>> -echo "253:0" >/sys/class/pktcdvd/remove
>> +    # create a new pktcdvd device mapped to /dev/hdc
>> +    echo "22:0" >/sys/class/pktcdvd/add
>> +    cat /sys/class/pktcdvd/device_map
>> +    # assuming device pktcdvd0 was created, look at stat's
>> +    cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written
>> +    # print the device id of the mapped block device
>> +    fgrep pktcdvd0 /sys/class/pktcdvd/device_map
>> +    # remove device, using pktcdvd0 device id   253:0
>> +    echo "253:0" >/sys/class/pktcdvd/remove
>> diff --git a/Documentation/ABI/testing/sysfs-class-power b/Documentation/ABI/testing/sysfs-class-power
>> index d4319a04c302..d68ad528a8e5 100644
>> --- a/Documentation/ABI/testing/sysfs-class-power
>> +++ b/Documentation/ABI/testing/sysfs-class-power
>> @@ -43,7 +43,9 @@ Date:		May 2007
>>  Contact:	linux-pm@vger.kernel.org
>>  Description:
>>  		Fine grain representation of battery capacity.
>> +
>>  		Access: Read
>> +
>>  		Valid values: 0 - 100 (percent)
>>  
>>  What:		/sys/class/power_supply/<supply_name>/capacity_alert_max
>> @@ -58,6 +60,7 @@ Description:
>>  		low).
>>  
>>  		Access: Read, Write
>> +
>>  		Valid values: 0 - 100 (percent)
>>  
>>  What:		/sys/class/power_supply/<supply_name>/capacity_alert_min
>> @@ -88,6 +91,7 @@ Description:
>>  		completely useless.
>>  
>>  		Access: Read
>> +
>>  		Valid values: 0 - 100 (percent)
>>  
>>  What:		/sys/class/power_supply/<supply_name>/capacity_level
>> @@ -111,6 +115,7 @@ Description:
>>  		which they average readings to smooth out the reported value.
>>  
>>  		Access: Read
>> +
>>  		Valid values: Represented in microamps. Negative values are used
>>  		for discharging batteries, positive values for charging batteries.
>>  
>> @@ -131,6 +136,7 @@ Description:
>>  		This value is not averaged/smoothed.
>>  
>>  		Access: Read
>> +
>>  		Valid values: Represented in microamps. Negative values are used
>>  		for discharging batteries, positive values for charging batteries.
>>  
>> @@ -383,7 +389,7 @@ Description:
>>  
>>  **USB Properties**
>>  
>> -What: 		/sys/class/power_supply/<supply_name>/current_avg
>> +What:		/sys/class/power_supply/<supply_name>/current_avg
>>  Date:		May 2007
>>  Contact:	linux-pm@vger.kernel.org
>>  Description:
>> @@ -449,6 +455,7 @@ Description:
>>  		solved using power limit use input_voltage_limit.
>>  
>>  		Access: Read, Write
>> +
>>  		Valid values: Represented in microvolts
>>  
>>  What:		/sys/class/power_supply/<supply_name>/input_power_limit
>> @@ -462,6 +469,7 @@ Description:
>>  		limit only for problems that can be solved using power limit.
>>  
>>  		Access: Read, Write
>> +
>>  		Valid values: Represented in microwatts
>>  
>>  What:		/sys/class/power_supply/<supply_name>/online,
>> @@ -747,6 +755,7 @@ Description:
>>  		manufactured.
>>  
>>  		Access: Read
>> +
>>  		Valid values: Reported as integer
>>  
>>  What:		/sys/class/power_supply/<supply_name>/manufacture_month
>> @@ -756,6 +765,7 @@ Description:
>>  		Reports the month when the device has been manufactured.
>>  
>>  		Access: Read
>> +
>>  		Valid values: 1-12
>>  
>>  What:		/sys/class/power_supply/<supply_name>/manufacture_day
>> diff --git a/Documentation/ABI/testing/sysfs-class-power-mp2629 b/Documentation/ABI/testing/sysfs-class-power-mp2629
>> index 327a07e22805..914d67caac0d 100644
>> --- a/Documentation/ABI/testing/sysfs-class-power-mp2629
>> +++ b/Documentation/ABI/testing/sysfs-class-power-mp2629
>> @@ -5,4 +5,5 @@ Description:
>>  		Represents a battery impedance compensation to accelerate charging.
>>  
>>                  Access: Read, Write
>> +
>>                  Valid values: Represented in milli-ohms. Valid range is [0, 140].
>> diff --git a/Documentation/ABI/testing/sysfs-class-power-twl4030 b/Documentation/ABI/testing/sysfs-class-power-twl4030
>> index 7ac36dba87bc..b52f7023f8ba 100644
>> --- a/Documentation/ABI/testing/sysfs-class-power-twl4030
>> +++ b/Documentation/ABI/testing/sysfs-class-power-twl4030
>> @@ -6,9 +6,9 @@ Description:
>>  	Possible values are:
>>  
>>  		=============	===========================================
>> -		"auto" 		draw power as appropriate for detected
>> +		"auto"		draw power as appropriate for detected
>>  				power source and battery status.
>> -		"off"  		do not draw any power.
>> +		"off"		do not draw any power.
>>  		"continuous"	activate mode described as "linear" in
>>  				TWL data sheets.  This uses whatever
>>  				current is available and doesn't switch off
>> diff --git a/Documentation/ABI/testing/sysfs-class-rapidio b/Documentation/ABI/testing/sysfs-class-rapidio
>> index 8716beeb16c1..19aefb21b639 100644
>> --- a/Documentation/ABI/testing/sysfs-class-rapidio
>> +++ b/Documentation/ABI/testing/sysfs-class-rapidio
>> @@ -6,6 +6,7 @@ Description:
>>  		The /sys/class/rapidio_port subdirectory contains individual
>>  		subdirectories named as "rapidioN" where N = mport ID registered
>>  		with RapidIO subsystem.
>> +
>>  		NOTE: An mport ID is not a RapidIO destination ID assigned to a
>>  		given local mport device.
>>  
>> @@ -16,7 +17,9 @@ Contact:	Matt Porter <mporter@kernel.crashing.org>,
>>  		Alexandre Bounine <alexandre.bounine@idt.com>
>>  Description:
>>  		(RO) reports RapidIO common transport system size:
>> +
>>  		0 = small (8-bit destination ID, max. 256 devices),
>> +
>>  		1 = large (16-bit destination ID, max. 65536 devices).
>>  
>>  What:		/sys/class/rapidio_port/rapidioN/port_destid
>> @@ -25,31 +28,32 @@ KernelVersion:	v3.15
>>  Contact:	Matt Porter <mporter@kernel.crashing.org>,
>>  		Alexandre Bounine <alexandre.bounine@idt.com>
>>  Description:
>> -		(RO) reports RapidIO destination ID assigned to the given
>> -		RapidIO mport device. If value 0xFFFFFFFF is returned this means
>> -		that no valid destination ID have been assigned to the mport
>> -		(yet). Normally, before enumeration/discovery have been executed
>> -		only fabric enumerating mports have a valid destination ID
>> -		assigned to them using "hdid=..." rapidio module parameter.
>> +
>> +(RO) reports RapidIO destination ID assigned to the given
>> +RapidIO mport device. If value 0xFFFFFFFF is returned this means
>> +that no valid destination ID have been assigned to the mport
>> +(yet). Normally, before enumeration/discovery have been executed
>> +only fabric enumerating mports have a valid destination ID
>> +assigned to them using "hdid=..." rapidio module parameter.
>>  
>>  After enumeration or discovery was performed for a given mport device,
>>  the corresponding subdirectory will also contain subdirectories for each
>>  child RapidIO device connected to the mport.
>>  
>>  The example below shows mport device subdirectory with several child RapidIO
>> -devices attached to it.
>> +devices attached to it::
>>  
>> -[rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l
>> -total 0
>> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0001
>> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0004
>> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0007
>> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0002
>> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0003
>> -drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0005
>> -lrwxrwxrwx 1 root root    0 Feb 11 15:11 device -> ../../../0000:01:00.0
>> --r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid
>> -drwxr-xr-x 2 root root    0 Feb 11 15:11 power
>> -lrwxrwxrwx 1 root root    0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port
>> --r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size
>> --rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent
>> +    [rio@rapidio ~]$ ls /sys/class/rapidio_port/rapidio0/ -l
>> +    total 0
>> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0001
>> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0004
>> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:e:0007
>> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0002
>> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0003
>> +    drwxr-xr-x 3 root root    0 Feb 11 15:10 00:s:0005
>> +    lrwxrwxrwx 1 root root    0 Feb 11 15:11 device -> ../../../0000:01:00.0
>> +    -r--r--r-- 1 root root 4096 Feb 11 15:11 port_destid
>> +    drwxr-xr-x 2 root root    0 Feb 11 15:11 power
>> +    lrwxrwxrwx 1 root root    0 Feb 11 15:04 subsystem -> ../../../../../../class/rapidio_port
>> +    -r--r--r-- 1 root root 4096 Feb 11 15:11 sys_size
>> +    -rw-r--r-- 1 root root 4096 Feb 11 15:04 uevent
>> diff --git a/Documentation/ABI/testing/sysfs-class-regulator b/Documentation/ABI/testing/sysfs-class-regulator
>> index bc578bc60628..8516f08806dd 100644
>> --- a/Documentation/ABI/testing/sysfs-class-regulator
>> +++ b/Documentation/ABI/testing/sysfs-class-regulator
>> @@ -35,13 +35,13 @@ Description:
>>  
>>  		This will be one of the following strings:
>>  
>> -			off
>> -			on
>> -			error
>> -			fast
>> -			normal
>> -			idle
>> -			standby
>> +			- off
>> +			- on
>> +			- error
>> +			- fast
>> +			- normal
>> +			- idle
>> +			- standby
>>  
>>  		"off" means the regulator is not supplying power to the
>>  		system.
>> @@ -74,9 +74,9 @@ Description:
>>  
>>  		This will be one of the following strings:
>>  
>> -		'voltage'
>> -		'current'
>> -		'unknown'
>> +		- 'voltage'
>> +		- 'current'
>> +		- 'unknown'
>>  
>>  		'voltage' means the regulator output voltage can be controlled
>>  		by software.
>> @@ -129,11 +129,11 @@ Description:
>>  
>>  		The opmode value can be one of the following strings:
>>  
>> -		'fast'
>> -		'normal'
>> -		'idle'
>> -		'standby'
>> -		'unknown'
>> +		- 'fast'
>> +		- 'normal'
>> +		- 'idle'
>> +		- 'standby'
>> +		- 'unknown'
>>  
>>  		The modes are described in include/linux/regulator/consumer.h
>>  
>> @@ -360,9 +360,9 @@ Description:
>>  
>>  		This will be one of the following strings:
>>  
>> -		'enabled'
>> -		'disabled'
>> -		'unknown'
>> +		- 'enabled'
>> +		- 'disabled'
>> +		- 'unknown'
>>  
>>  		'enabled' means the regulator is in bypass mode.
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-class-remoteproc b/Documentation/ABI/testing/sysfs-class-remoteproc
>> index 066b9b6f4924..0c9ee55098b8 100644
>> --- a/Documentation/ABI/testing/sysfs-class-remoteproc
>> +++ b/Documentation/ABI/testing/sysfs-class-remoteproc
>> @@ -16,11 +16,11 @@ Description:	Remote processor state
>>  
>>  		Reports the state of the remote processor, which will be one of:
>>  
>> -		"offline"
>> -		"suspended"
>> -		"running"
>> -		"crashed"
>> -		"invalid"
>> +		- "offline"
>> +		- "suspended"
>> +		- "running"
>> +		- "crashed"
>> +		- "invalid"
>>  
>>  		"offline" means the remote processor is powered off.
>>  
>> @@ -38,8 +38,8 @@ Description:	Remote processor state
>>  		Writing this file controls the state of the remote processor.
>>  		The following states can be written:
>>  
>> -		"start"
>> -		"stop"
>> +		- "start"
>> +		- "stop"
>>  
>>  		Writing "start" will attempt to start the processor running the
>>  		firmware indicated by, or written to,
>> diff --git a/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration b/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration
>> index ec950c93e5c6..ee8ed6494a01 100644
>> --- a/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration
>> +++ b/Documentation/ABI/testing/sysfs-class-rtc-rtc0-device-rtc_calibration
>> @@ -7,6 +7,7 @@ Description:    Attribute for calibrating ST-Ericsson AB8500 Real Time Clock
>>                  calibrate the AB8500.s 32KHz Real Time Clock.
>>                  Every 60 seconds the AB8500 will correct the RTC's value
>>                  by adding to it the value of this attribute.
>> +
>>                  The range of the attribute is -127 to +127 in units of
>>                  30.5 micro-seconds (half-parts-per-million of the 32KHz clock)
>>  Users:          The /vendor/st-ericsson/base_utilities/core/rtc_calibration
>> diff --git a/Documentation/ABI/testing/sysfs-class-uwb_rc b/Documentation/ABI/testing/sysfs-class-uwb_rc
>> index a0578751c1e3..6c5dcad21e19 100644
>> --- a/Documentation/ABI/testing/sysfs-class-uwb_rc
>> +++ b/Documentation/ABI/testing/sysfs-class-uwb_rc
>> @@ -66,11 +66,14 @@ Description:
>>                  <channel> <type> [<bpst offset>]
>>  
>>                  to start (or stop) scanning on a channel.  <type> is one of:
>> -                    0 - scan
>> -                    1 - scan outside BP
>> -                    2 - scan while inactive
>> -                    3 - scanning disabled
>> -                    4 - scan (with start time of <bpst offset>)
>> +
>> +		   ==   =======================================
>> +                    0   scan
>> +                    1   scan outside BP
>> +                    2   scan while inactive
>> +                    3   scanning disabled
>> +                    4   scan (with start time of <bpst offset>)
>> +		   ==   =======================================
>>  
>>  What:           /sys/class/uwb_rc/uwbN/mac_address
>>  Date:           July 2008
>> diff --git a/Documentation/ABI/testing/sysfs-class-watchdog b/Documentation/ABI/testing/sysfs-class-watchdog
>> index 9860a8b2ba75..585caecda3a5 100644
>> --- a/Documentation/ABI/testing/sysfs-class-watchdog
>> +++ b/Documentation/ABI/testing/sysfs-class-watchdog
>> @@ -91,10 +91,13 @@ Description:
>>  		h/w strapping (for WDT2 only).
>>  
>>  		At alternate flash the 'access_cs0' sysfs node provides:
>> -			ast2400: a way to get access to the primary SPI flash
>> +
>> +			ast2400:
>> +				a way to get access to the primary SPI flash
>>  				chip at CS0 after booting from the alternate
>>  				chip at CS1.
>> -			ast2500: a way to restore the normal address mapping
>> +			ast2500:
>> +				a way to restore the normal address mapping
>>  				from (CS0->CS1, CS1->CS0) to (CS0->CS0,
>>  				CS1->CS1).
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-dev b/Documentation/ABI/testing/sysfs-dev
>> index a9f2b8b0530f..d1739063e762 100644
>> --- a/Documentation/ABI/testing/sysfs-dev
>> +++ b/Documentation/ABI/testing/sysfs-dev
>> @@ -9,9 +9,10 @@ Description:	The /sys/dev tree provides a method to look up the sysfs
>>  		the form "<major>:<minor>".  These links point to the
>>  		corresponding sysfs path for the given device.
>>  
>> -		Example:
>> -		$ readlink /sys/dev/block/8:32
>> -		../../block/sdc
>> +		Example::
>> +
>> +		  $ readlink /sys/dev/block/8:32
>> +		  ../../block/sdc
>>  
>>  		Entries in /sys/dev/char and /sys/dev/block will be
>>  		dynamically created and destroyed as devices enter and
>> diff --git a/Documentation/ABI/testing/sysfs-devices-mapping b/Documentation/ABI/testing/sysfs-devices-mapping
>> index 490ccfd67f12..8d202bac9394 100644
>> --- a/Documentation/ABI/testing/sysfs-devices-mapping
>> +++ b/Documentation/ABI/testing/sysfs-devices-mapping
>> @@ -8,26 +8,27 @@ Description:
>>                  block.
>>                  For example, on 4-die Xeon platform with up to 6 IIO stacks per
>>                  die and, therefore, 6 IIO PMON blocks per die, the mapping of
>> -                IIO PMON block 0 exposes as the following:
>> +                IIO PMON block 0 exposes as the following::
>>  
>> -                $ ls /sys/devices/uncore_iio_0/die*
>> -                -r--r--r-- /sys/devices/uncore_iio_0/die0
>> -                -r--r--r-- /sys/devices/uncore_iio_0/die1
>> -                -r--r--r-- /sys/devices/uncore_iio_0/die2
>> -                -r--r--r-- /sys/devices/uncore_iio_0/die3
>> +		    $ ls /sys/devices/uncore_iio_0/die*
>> +		    -r--r--r-- /sys/devices/uncore_iio_0/die0
>> +		    -r--r--r-- /sys/devices/uncore_iio_0/die1
>> +		    -r--r--r-- /sys/devices/uncore_iio_0/die2
>> +		    -r--r--r-- /sys/devices/uncore_iio_0/die3
>>  
>> -                $ tail /sys/devices/uncore_iio_0/die*
>> -                ==> /sys/devices/uncore_iio_0/die0 <==  
>> -                0000:00
>> -                ==> /sys/devices/uncore_iio_0/die1 <==  
>> -                0000:40
>> -                ==> /sys/devices/uncore_iio_0/die2 <==  
>> -                0000:80
>> -                ==> /sys/devices/uncore_iio_0/die3 <==  
>> -                0000:c0
>> +		    $ tail /sys/devices/uncore_iio_0/die*
>> +		    ==> /sys/devices/uncore_iio_0/die0 <==
>> +		    0000:00
>> +		    ==> /sys/devices/uncore_iio_0/die1 <==
>> +		    0000:40
>> +		    ==> /sys/devices/uncore_iio_0/die2 <==
>> +		    0000:80
>> +		    ==> /sys/devices/uncore_iio_0/die3 <==
>> +		    0000:c0
>>  
>> -                Which means:
>> -                IIO PMU 0 on die 0 belongs to PCI RP on bus 0x00, domain 0x0000
>> -                IIO PMU 0 on die 1 belongs to PCI RP on bus 0x40, domain 0x0000
>> -                IIO PMU 0 on die 2 belongs to PCI RP on bus 0x80, domain 0x0000
>> -                IIO PMU 0 on die 3 belongs to PCI RP on bus 0xc0, domain 0x0000
>> +                Which means::
>> +
>> +		    IIO PMU 0 on die 0 belongs to PCI RP on bus 0x00, domain 0x0000
>> +		    IIO PMU 0 on die 1 belongs to PCI RP on bus 0x40, domain 0x0000
>> +		    IIO PMU 0 on die 2 belongs to PCI RP on bus 0x80, domain 0x0000
>> +		    IIO PMU 0 on die 3 belongs to PCI RP on bus 0xc0, domain 0x0000
>> diff --git a/Documentation/ABI/testing/sysfs-devices-memory b/Documentation/ABI/testing/sysfs-devices-memory
>> index deef3b5723cf..2da2b1fba2c1 100644
>> --- a/Documentation/ABI/testing/sysfs-devices-memory
>> +++ b/Documentation/ABI/testing/sysfs-devices-memory
>> @@ -47,16 +47,19 @@ Description:
>>  		online/offline state of the memory section.  When written,
>>  		root can toggle the the online/offline state of a removable
>>  		memory section (see removable file description above)
>> -		using the following commands.
>> -		# echo online > /sys/devices/system/memory/memoryX/state
>> -		# echo offline > /sys/devices/system/memory/memoryX/state
>> +		using the following commands::
>> +
>> +		  # echo online > /sys/devices/system/memory/memoryX/state
>> +		  # echo offline > /sys/devices/system/memory/memoryX/state
>>  
>>  		For example, if /sys/devices/system/memory/memory22/removable
>>  		contains a value of 1 and
>>  		/sys/devices/system/memory/memory22/state contains the
>>  		string "online" the following command can be executed by
>> -		by root to offline that section.
>> -		# echo offline > /sys/devices/system/memory/memory22/state
>> +		by root to offline that section::
>> +
>> +		  # echo offline > /sys/devices/system/memory/memory22/state
>> +
>>  Users:		hotplug memory remove tools
>>  		http://www.ibm.com/developerworks/wikis/display/LinuxP/powerpc-utils
>>  
>> @@ -78,6 +81,7 @@ Description:
>>  
>>  		For example, the following symbolic link is created for
>>  		memory section 9 on node0:
>> +
>>  		/sys/devices/system/memory/memory9/node0 -> ../../node/node0
>>  
>>  
>> @@ -90,4 +94,5 @@ Description:
>>  		points to the corresponding /sys/devices/system/memory/memoryY
>>  		memory section directory.  For example, the following symbolic
>>  		link is created for memory section 9 on node0.
>> +
>>  		/sys/devices/system/node/node0/memory9 -> ../../memory/memory9
>> diff --git a/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget b/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget
>> index d548eaac230a..40f29a01fd14 100644
>> --- a/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget
>> +++ b/Documentation/ABI/testing/sysfs-devices-platform-_UDC_-gadget
>> @@ -3,8 +3,9 @@ Date:		April 2010
>>  Contact:	Fabien Chouteau <fabien.chouteau@barco.com>
>>  Description:
>>  		Show the suspend state of an USB composite gadget.
>> -		1 -> suspended
>> -		0 -> resumed
>> +
>> +		- 1 -> suspended
>> +		- 0 -> resumed
>>  
>>  		(_UDC_ is the name of the USB Device Controller driver)
>>  
>> @@ -17,5 +18,6 @@ Description:
>>  		Storage mode.
>>  
>>  		Possible values are:
>> -			1 -> ignore the FUA flag
>> -			0 -> obey the FUA flag
>> +
>> +			- 1 -> ignore the FUA flag
>> +			- 0 -> obey the FUA flag
>> diff --git a/Documentation/ABI/testing/sysfs-devices-platform-ipmi b/Documentation/ABI/testing/sysfs-devices-platform-ipmi
>> index afb5db856e1c..07df0ddc0b69 100644
>> --- a/Documentation/ABI/testing/sysfs-devices-platform-ipmi
>> +++ b/Documentation/ABI/testing/sysfs-devices-platform-ipmi
>> @@ -123,38 +123,40 @@ KernelVersion:	v4.15
>>  Contact:	openipmi-developer@lists.sourceforge.net
>>  Description:
>>  
>> -		idles:			(RO) Number of times the interface was
>> +		======================	========================================
>> +		idles			(RO) Number of times the interface was
>>  					idle while being polled.
>>  
>> -		watchdog_pretimeouts:	(RO) Number of watchdog pretimeouts.
>> +		watchdog_pretimeouts	(RO) Number of watchdog pretimeouts.
>>  
>> -		complete_transactions:	(RO) Number of completed messages.
>> +		complete_transactions	(RO) Number of completed messages.
>>  
>> -		events:			(RO) Number of IPMI events received from
>> +		events			(RO) Number of IPMI events received from
>>  					the hardware.
>>  
>> -		interrupts:		(RO) Number of interrupts the driver
>> +		interrupts		(RO) Number of interrupts the driver
>>  					handled.
>>  
>> -		hosed_count:		(RO) Number of times the hardware didn't
>> +		hosed_count		(RO) Number of times the hardware didn't
>>  					follow the state machine.
>>  
>> -		long_timeouts:		(RO) Number of times the driver
>> +		long_timeouts		(RO) Number of times the driver
>>  					requested a timer while nothing was in
>>  					progress.
>>  
>> -		flag_fetches:		(RO) Number of times the driver
>> +		flag_fetches		(RO) Number of times the driver
>>  					requested flags from the hardware.
>>  
>> -		attentions:		(RO) Number of time the driver got an
>> +		attentions		(RO) Number of time the driver got an
>>  					ATTN from the hardware.
>>  
>> -		incoming_messages:	(RO) Number of asynchronous messages
>> +		incoming_messages	(RO) Number of asynchronous messages
>>  					received.
>>  
>> -		short_timeouts:		(RO) Number of times the driver
>> +		short_timeouts		(RO) Number of times the driver
>>  					requested a timer while an operation was
>>  					in progress.
>> +		======================	========================================
>>  
>>  
>>  What:		/sys/devices/platform/ipmi_si.*/interrupts_enabled
>> @@ -201,38 +203,40 @@ Date:		Sep, 2017
>>  KernelVersion:	v4.15
>>  Contact:	openipmi-developer@lists.sourceforge.net
>>  Description:
>> -		hosed:			(RO) Number of times the hardware didn't
>> +		======================	========================================
>> +		hosed			(RO) Number of times the hardware didn't
>>  					follow the state machine.
>>  
>> -		alerts:			(RO) Number of alerts received.
>> +		alerts			(RO) Number of alerts received.
>>  
>> -		sent_messages:		(RO) Number of total messages sent.
>> +		sent_messages		(RO) Number of total messages sent.
>>  
>> -		sent_message_parts:	(RO) Number of message parts sent.
>> +		sent_message_parts	(RO) Number of message parts sent.
>>  					Messages may be broken into parts if
>>  					they are long.
>>  
>> -		received_messages:	(RO) Number of message responses
>> +		received_messages	(RO) Number of message responses
>>  					received.
>>  
>> -		received_message_parts: (RO) Number of message fragments
>> +		received_message_parts	(RO) Number of message fragments
>>  					received.
>>  
>> -		events:			(RO) Number of received events.
>> +		events			(RO) Number of received events.
>>  
>> -		watchdog_pretimeouts:	(RO) Number of watchdog pretimeouts.
>> +		watchdog_pretimeouts	(RO) Number of watchdog pretimeouts.
>>  
>> -		flag_fetches:		(RO) Number of times a flag fetch was
>> +		flag_fetches		(RO) Number of times a flag fetch was
>>  					requested.
>>  
>> -		send_retries:		(RO) Number of time a message was
>> +		send_retries		(RO) Number of time a message was
>>  					retried.
>>  
>> -		receive_retries:	(RO) Number of times the receive of a
>> +		receive_retries		(RO) Number of times the receive of a
>>  					message was retried.
>>  
>> -		send_errors:		(RO) Number of times the send of a
>> +		send_errors		(RO) Number of times the send of a
>>  					message failed.
>>  
>> -		receive_errors:		(RO) Number of errors in receiving
>> +		receive_errors		(RO) Number of errors in receiving
>>  					messages.
>> +		======================	========================================
>> diff --git a/Documentation/ABI/testing/sysfs-devices-system-cpu b/Documentation/ABI/testing/sysfs-devices-system-cpu
>> index 274c337ec6a9..1a04ca8162ad 100644
>> --- a/Documentation/ABI/testing/sysfs-devices-system-cpu
>> +++ b/Documentation/ABI/testing/sysfs-devices-system-cpu
>> @@ -169,7 +169,7 @@ Description:
>>  			      observed CPU idle duration was too short for it
>>  			      (a count).
>>  
>> -		below: 	 (RO) Number of times this state was entered, but the
>> +		below:	 (RO) Number of times this state was entered, but the
>>  			      observed CPU idle duration was too long for it
>>  			      (a count).
>>  		======== ==== =================================================
>> @@ -601,7 +601,7 @@ Description:	Secure Virtual Machine
>>  		Facility in POWER9 and newer processors. i.e., it is a Secure
>>  		Virtual Machine.
>>  
>> -What: 		/sys/devices/system/cpu/cpuX/purr
>> +What:		/sys/devices/system/cpu/cpuX/purr
>>  Date:		Apr 2005
>>  Contact:	Linux for PowerPC mailing list <linuxppc-dev@ozlabs.org>
>>  Description:	PURR ticks for this CPU since the system boot.
>> diff --git a/Documentation/ABI/testing/sysfs-driver-hid-lenovo b/Documentation/ABI/testing/sysfs-driver-hid-lenovo
>> index 53a0725962e1..aee85ca1f6be 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-hid-lenovo
>> +++ b/Documentation/ABI/testing/sysfs-driver-hid-lenovo
>> @@ -3,14 +3,18 @@ Date:		July 2011
>>  Contact:	linux-input@vger.kernel.org
>>  Description:	This controls if mouse clicks should be generated if the trackpoint is quickly pressed. How fast this press has to be
>>  		is being controlled by press_speed.
>> +
>>  		Values are 0 or 1.
>> +
>>  		Applies to Thinkpad USB Keyboard with TrackPoint.
>>  
>>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/dragging
>>  Date:		July 2011
>>  Contact:	linux-input@vger.kernel.org
>>  Description:	If this setting is enabled, it is possible to do dragging by pressing the trackpoint. This requires press_to_select to be enabled.
>> +
>>  		Values are 0 or 1.
>> +
>>  		Applies to Thinkpad USB Keyboard with TrackPoint.
>>  
>>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/release_to_select
>> @@ -25,7 +29,9 @@ Date:		July 2011
>>  Contact:	linux-input@vger.kernel.org
>>  Description:	This setting controls if the mouse click events generated by pressing the trackpoint (if press_to_select is enabled) generate
>>  		a left or right mouse button click.
>> +
>>  		Values are 0 or 1.
>> +
>>  		Applies to Thinkpad USB Keyboard with TrackPoint.
>>  
>>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/sensitivity
>> @@ -39,12 +45,16 @@ What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-
>>  Date:		July 2011
>>  Contact:	linux-input@vger.kernel.org
>>  Description:	This setting controls how fast the trackpoint needs to be pressed to generate a mouse click if press_to_select is enabled.
>> +
>>  		Values are decimal integers from 1 (slowest) to 255 (fastest).
>> +
>>  		Applies to Thinkpad USB Keyboard with TrackPoint.
>>  
>>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/fn_lock
>>  Date:		July 2014
>>  Contact:	linux-input@vger.kernel.org
>>  Description:	This setting controls whether Fn Lock is enabled on the keyboard (i.e. if F1 is Mute or F1)
>> +
>>  		Values are 0 or 1
>> +
>>  		Applies to ThinkPad Compact (USB|Bluetooth) Keyboard with TrackPoint.
>> diff --git a/Documentation/ABI/testing/sysfs-driver-hid-ntrig b/Documentation/ABI/testing/sysfs-driver-hid-ntrig
>> index e574a5625efe..0e323a5cec6c 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-hid-ntrig
>> +++ b/Documentation/ABI/testing/sysfs-driver-hid-ntrig
>> @@ -29,12 +29,13 @@ Contact:	linux-input@vger.kernel.org
>>  Description:
>>  		Threholds to override activation slack.
>>  
>> -		activation_width:	(RW) Width threshold to immediately
>> +		=================	=====================================
>> +		activation_width	(RW) Width threshold to immediately
>>  					start processing touch events.
>>  
>> -		activation_height:	(RW) Height threshold to immediately
>> +		activation_height	(RW) Height threshold to immediately
>>  					start processing touch events.
>> -
>> +		=================	=====================================
>>  
>>  What:		/sys/bus/hid/drivers/ntrig/<dev>/min_width
>>  What:		/sys/bus/hid/drivers/ntrig/<dev>/min_height
>> @@ -44,11 +45,13 @@ Contact:	linux-input@vger.kernel.org
>>  Description:
>>  		Minimum size contact accepted.
>>  
>> -		min_width:	(RW) Minimum touch contact width to decide
>> +		==========	===========================================
>> +		min_width	(RW) Minimum touch contact width to decide
>>  				activation and activity.
>>  
>> -		min_height:	(RW) Minimum touch contact height to decide
>> +		min_height	(RW) Minimum touch contact height to decide
>>  				activation and activity.
>> +		==========	===========================================
>>  
>>  
>>  What:		/sys/bus/hid/drivers/ntrig/<dev>/sensor_physical_width
>> diff --git a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone
>> index 8f7982c70d72..11cd9bf0ad18 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone
>> +++ b/Documentation/ABI/testing/sysfs-driver-hid-roccat-kone
>> @@ -3,17 +3,21 @@ Date:		March 2010
>>  Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
>>  Description:	It is possible to switch the dpi setting of the mouse with the
>>  		press of a button.
>> +
>>  		When read, this file returns the raw number of the actual dpi
>>  		setting reported by the mouse. This number has to be further
>>  		processed to receive the real dpi value:
>>  
>> +		===== =====
>>  		VALUE DPI
>> +		===== =====
>>  		1     800
>>  		2     1200
>>  		3     1600
>>  		4     2000
>>  		5     2400
>>  		6     3200
>> +		===== =====
>>  
>>  		This file is readonly.
>>  Users:		http://roccat.sourceforge.net
>> @@ -22,6 +26,7 @@ What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-
>>  Date:		March 2010
>>  Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
>>  Description:	When read, this file returns the number of the actual profile.
>> +
>>  		This file is readonly.
>>  Users:		http://roccat.sourceforge.net
>>  
>> @@ -33,6 +38,7 @@ Description:	When read, this file returns the raw integer version number of the
>>  		further usage in other programs. To receive the real version
>>  		number the decimal point has to be shifted 2 positions to the
>>  		left. E.g. a returned value of 138 means 1.38
>> +
>>  		This file is readonly.
>>  Users:		http://roccat.sourceforge.net
>>  
>> @@ -43,10 +49,13 @@ Description:	The mouse can store 5 profiles which can be switched by the
>>                  press of a button. A profile holds information like button
>>                  mappings, sensitivity, the colors of the 5 leds and light
>>                  effects.
>> +
>>                  When read, these files return the respective profile. The
>>                  returned data is 975 bytes in size.
>> +
>>  		When written, this file lets one write the respective profile
>>  		data back to the mouse. The data has to be 975 bytes long.
>> +
>>  		The mouse will reject invalid data, whereas the profile number
>>  		stored in the profile doesn't need to fit the number of the
>>  		store.
>> @@ -58,6 +67,7 @@ Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
>>  Description:	When read, this file returns the settings stored in the mouse.
>>  		The size of the data is 36 bytes and holds information like the
>>  		startup_profile, tcu state and calibration_data.
>> +
>>  		When written, this file lets write settings back to the mouse.
>>  		The data has to be 36 bytes long. The mouse will reject invalid
>>  		data.
>> @@ -67,8 +77,10 @@ What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-
>>  Date:		March 2010
>>  Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
>>  Description:	The integer value of this attribute ranges from 1 to 5.
>> +
>>                  When read, this attribute returns the number of the profile
>>                  that's active when the mouse is powered on.
>> +
>>  		When written, this file sets the number of the startup profile
>>  		and the mouse activates this profile immediately.
>>  Users:		http://roccat.sourceforge.net
>> @@ -80,9 +92,12 @@ Description:	The mouse has a "Tracking Control Unit" which lets the user
>>  		calibrate the laser power to fit the mousepad surface.
>>  		When read, this file returns the current state of the TCU,
>>  		where 0 means off and 1 means on.
>> +
>>  		Writing 0 in this file will switch the TCU off.
>> +
>>  		Writing 1 in this file will start the calibration which takes
>>  		around 6 seconds to complete and activates the TCU.
>> +
>>  Users:		http://roccat.sourceforge.net
>>  
>>  What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kone/roccatkone<minor>/weight
>> @@ -93,14 +108,18 @@ Description:	The mouse can be equipped with one of four supplied weights
>>  		and its value can be read out. When read, this file returns the
>>  		raw value returned by the mouse which eases further processing
>>  		in other software.
>> +
>>  		The values map to the weights as follows:
>>  
>> +		===== ======
>>  		VALUE WEIGHT
>> +		===== ======
>>  		0     none
>>  		1     5g
>>  		2     10g
>>  		3     15g
>>  		4     20g
>> +		===== ======
>>  
>>  		This file is readonly.
>>  Users:		http://roccat.sourceforge.net
>> diff --git a/Documentation/ABI/testing/sysfs-driver-hid-wiimote b/Documentation/ABI/testing/sysfs-driver-hid-wiimote
>> index cd7b82a5c27d..3bf43d9dcdfe 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-hid-wiimote
>> +++ b/Documentation/ABI/testing/sysfs-driver-hid-wiimote
>> @@ -20,6 +20,7 @@ Description:	This file contains the currently connected and initialized
>>  		the official Nintendo Nunchuck extension and classic is the
>>  		Nintendo Classic Controller extension. The motionp extension can
>>  		be combined with the other two.
>> +
>>  		Starting with kernel-version 3.11 Motion Plus hotplugging is
>>  		supported and if detected, it's no longer reported as static
>>  		extension. You will get uevent notifications for the motion-plus
>> diff --git a/Documentation/ABI/testing/sysfs-driver-input-exc3000 b/Documentation/ABI/testing/sysfs-driver-input-exc3000
>> index 3d316d54f81c..cd7c578aef2c 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-input-exc3000
>> +++ b/Documentation/ABI/testing/sysfs-driver-input-exc3000
>> @@ -4,6 +4,7 @@ Contact:	linux-input@vger.kernel.org
>>  Description:    Reports the firmware version provided by the touchscreen, for example "00_T6" on a EXC80H60
>>  
>>  		Access: Read
>> +
>>  		Valid values: Represented as string
>>  
>>  What:		/sys/bus/i2c/devices/xxx/model
>> @@ -12,4 +13,5 @@ Contact:	linux-input@vger.kernel.org
>>  Description:    Reports the model identification provided by the touchscreen, for example "Orion_1320" on a EXC80H60
>>  
>>  		Access: Read
>> +
>>  		Valid values: Represented as string
>> diff --git a/Documentation/ABI/testing/sysfs-driver-jz4780-efuse b/Documentation/ABI/testing/sysfs-driver-jz4780-efuse
>> index bb6f5d6ceea0..4cf595d681e6 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-jz4780-efuse
>> +++ b/Documentation/ABI/testing/sysfs-driver-jz4780-efuse
>> @@ -4,7 +4,9 @@ Contact:	PrasannaKumar Muralidharan <prasannatsmkumar@gmail.com>
>>  Description:	read-only access to the efuse on the Ingenic JZ4780 SoC
>>  		The SoC has a one time programmable 8K efuse that is
>>  		split into segments. The driver supports read only.
>> -		The segments are
>> +		The segments are:
>> +
>> +		===== ======== =================
>>  		0x000   64 bit Random Number
>>  		0x008  128 bit Ingenic Chip ID
>>  		0x018  128 bit Customer ID
>> @@ -12,5 +14,7 @@ Description:	read-only access to the efuse on the Ingenic JZ4780 SoC
>>  		0x1E0    8 bit Protect Segment
>>  		0x1E1 2296 bit HDMI Key
>>  		0x300 2048 bit Security boot key
>> +		===== ======== =================
>> +
>>  Users:		any user space application which wants to read the Chip
>>  		and Customer ID
>> diff --git a/Documentation/ABI/testing/sysfs-driver-pciback b/Documentation/ABI/testing/sysfs-driver-pciback
>> index 73308c2b81b0..49f5fd0c8bbd 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-pciback
>> +++ b/Documentation/ABI/testing/sysfs-driver-pciback
>> @@ -7,8 +7,10 @@ Description:
>>                  the format of DDDD:BB:DD.F-REG:SIZE:MASK will allow the guest
>>                  to write and read from the PCI device. That is Domain:Bus:
>>                  Device.Function-Register:Size:Mask (Domain is optional).
>> -                For example:
>> -                #echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks
>> +                For example::
>> +
>> +                  #echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks
>> +
>>                  will allow the guest to read and write to the configuration
>>                  register 0x0E.
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-driver-ufs b/Documentation/ABI/testing/sysfs-driver-ufs
>> index d1a352194d2e..adc0d0e91607 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-ufs
>> +++ b/Documentation/ABI/testing/sysfs-driver-ufs
>> @@ -18,6 +18,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the device type. This is one of the UFS
>>  		device descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_class
>> @@ -26,6 +27,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the device class. This is one of the UFS
>>  		device descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_sub_class
>> @@ -34,6 +36,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the UFS storage subclass. This is one of
>>  		the UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/protocol
>> @@ -43,6 +46,7 @@ Description:	This file shows the protocol supported by an UFS device.
>>  		This is one of the UFS device descriptor parameters.
>>  		The full information about the descriptor could be found
>>  		at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_luns
>> @@ -51,6 +55,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows number of logical units. This is one of
>>  		the UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_wluns
>> @@ -60,6 +65,7 @@ Description:	This file shows number of well known logical units.
>>  		This is one of the UFS device descriptor parameters.
>>  		The full information about the descriptor could be found
>>  		at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/boot_enable
>> @@ -69,6 +75,7 @@ Description:	This file shows value that indicates whether the device is
>>  		enabled for boot. This is one of the UFS device descriptor
>>  		parameters. The full information about the descriptor could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/descriptor_access_enable
>> @@ -79,6 +86,7 @@ Description:	This file shows value that indicates whether the device
>>  		of the boot sequence. This is one of the UFS device descriptor
>>  		parameters. The full information about the descriptor could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_power_mode
>> @@ -88,6 +96,7 @@ Description:	This file shows value that defines the power mode after
>>  		device initialization or hardware reset. This is one of
>>  		the UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/high_priority_lun
>> @@ -96,6 +105,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the high priority lun. This is one of
>>  		the UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/secure_removal_type
>> @@ -104,6 +114,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the secure removal type. This is one of
>>  		the UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/support_security_lun
>> @@ -113,6 +124,7 @@ Description:	This file shows whether the security lun is supported.
>>  		This is one of the UFS device descriptor parameters.
>>  		The full information about the descriptor could be found
>>  		at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/bkops_termination_latency
>> @@ -122,6 +134,7 @@ Description:	This file shows the background operations termination
>>  		latency. This is one of the UFS device descriptor parameters.
>>  		The full information about the descriptor could be found
>>  		at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/initial_active_icc_level
>> @@ -130,6 +143,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the initial active ICC level. This is one
>>  		of the UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/specification_version
>> @@ -138,6 +152,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the specification version. This is one
>>  		of the UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturing_date
>> @@ -147,6 +162,7 @@ Description:	This file shows the manufacturing date in BCD format.
>>  		This is one of the UFS device descriptor parameters.
>>  		The full information about the descriptor could be found
>>  		at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/manufacturer_id
>> @@ -155,6 +171,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the manufacturee ID. This is one of the
>>  		UFS device descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtt_capability
>> @@ -164,6 +181,7 @@ Description:	This file shows the maximum number of outstanding RTTs
>>  		supported by the device. This is one of the UFS device
>>  		descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/rtc_update
>> @@ -173,6 +191,7 @@ Description:	This file shows the frequency and method of the realtime
>>  		clock update. This is one of the UFS device descriptor
>>  		parameters. The full information about the descriptor
>>  		could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/ufs_features
>> @@ -182,6 +201,7 @@ Description:	This file shows which features are supported by the device.
>>  		This is one of the UFS device descriptor parameters.
>>  		The full information about the descriptor could be
>>  		found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/ffu_timeout
>> @@ -190,6 +210,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the FFU timeout. This is one of the
>>  		UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/queue_depth
>> @@ -198,6 +219,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the device queue depth. This is one of the
>>  		UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/device_version
>> @@ -206,6 +228,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the device version. This is one of the
>>  		UFS device descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/number_of_secure_wpa
>> @@ -215,6 +238,7 @@ Description:	This file shows number of secure write protect areas
>>  		supported by the device. This is one of the UFS device
>>  		descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_max_data_size
>> @@ -225,6 +249,7 @@ Description:	This file shows the maximum amount of data that may be
>>  		This is one of the UFS device descriptor parameters.
>>  		The full information about the descriptor could be found
>>  		at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/psa_state_timeout
>> @@ -234,6 +259,7 @@ Description:	This file shows the command maximum timeout for a change
>>  		in PSA state. This is one of the UFS device descriptor
>>  		parameters. The full information about the descriptor could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -244,6 +270,7 @@ Description:	This file shows the MIPI UniPro version number in BCD format.
>>  		This is one of the UFS interconnect descriptor parameters.
>>  		The full information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/interconnect_descriptor/mphy_version
>> @@ -253,6 +280,7 @@ Description:	This file shows the MIPI M-PHY version number in BCD format.
>>  		This is one of the UFS interconnect descriptor parameters.
>>  		The full information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -264,6 +292,7 @@ Description:	This file shows the total memory quantity available to
>>  		of the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_luns
>> @@ -273,6 +302,7 @@ Description:	This file shows the maximum number of logical units
>>  		supported by the UFS device. This is one of the UFS
>>  		geometry descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/segment_size
>> @@ -281,6 +311,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the segment size. This is one of the UFS
>>  		geometry descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/allocation_unit_size
>> @@ -289,6 +320,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the allocation unit size. This is one of
>>  		the UFS geometry descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/min_addressable_block_size
>> @@ -298,6 +330,7 @@ Description:	This file shows the minimum addressable block size. This
>>  		is one of the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at UFS
>>  		specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_read_block_size
>> @@ -307,6 +340,7 @@ Description:	This file shows the optimal read block size. This is one
>>  		of the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at UFS
>>  		specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/optimal_write_block_size
>> @@ -316,6 +350,7 @@ Description:	This file shows the optimal write block size. This is one
>>  		of the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at UFS
>>  		specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_in_buffer_size
>> @@ -325,6 +360,7 @@ Description:	This file shows the maximum data-in buffer size. This
>>  		is one of the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at UFS
>>  		specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_out_buffer_size
>> @@ -334,6 +370,7 @@ Description:	This file shows the maximum data-out buffer size. This
>>  		is one of the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at UFS
>>  		specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/rpmb_rw_size
>> @@ -343,6 +380,7 @@ Description:	This file shows the maximum number of RPMB frames allowed
>>  		in Security Protocol In/Out. This is one of the UFS geometry
>>  		descriptor parameters. The full information about the
>>  		descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/dyn_capacity_resource_policy
>> @@ -352,6 +390,7 @@ Description:	This file shows the dynamic capacity resource policy. This
>>  		is one of the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/data_ordering
>> @@ -361,6 +400,7 @@ Description:	This file shows support for out-of-order data transfer.
>>  		This is one of the UFS geometry descriptor parameters.
>>  		The full information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/max_number_of_contexts
>> @@ -370,6 +410,7 @@ Description:	This file shows maximum available number of contexts which
>>  		are supported by the device. This is one of the UFS geometry
>>  		descriptor parameters. The full information about the
>>  		descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_unit_size
>> @@ -378,6 +419,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows system data tag unit size. This is one of
>>  		the UFS geometry descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/sys_data_tag_resource_size
>> @@ -388,6 +430,7 @@ Description:	This file shows maximum storage area size allocated by
>>  		This is one of the UFS geometry descriptor parameters.
>>  		The full information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/secure_removal_types
>> @@ -397,6 +440,7 @@ Description:	This file shows supported secure removal types. This is
>>  		one of the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/memory_types
>> @@ -406,6 +450,7 @@ Description:	This file shows supported memory types. This is one of
>>  		the UFS geometry descriptor parameters. The full
>>  		information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_max_alloc_units
>> @@ -416,6 +461,7 @@ Description:	This file shows the maximum number of allocation units for
>>  		enhanced type 1-4). This is one of the UFS geometry
>>  		descriptor parameters. The full information about the
>>  		descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/*_memory_capacity_adjustment_factor
>> @@ -426,6 +472,7 @@ Description:	This file shows the memory capacity adjustment factor for
>>  		enhanced type 1-4). This is one of the UFS geometry
>>  		descriptor parameters. The full information about the
>>  		descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -436,6 +483,7 @@ Description:	This file shows preend of life information. This is one
>>  		of the UFS health descriptor parameters. The full
>>  		information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_a
>> @@ -445,6 +493,7 @@ Description:	This file shows indication of the device life time
>>  		(method a). This is one of the UFS health descriptor
>>  		parameters. The full information about the descriptor
>>  		could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/health_descriptor/life_time_estimation_b
>> @@ -454,6 +503,7 @@ Description:	This file shows indication of the device life time
>>  		(method b). This is one of the UFS health descriptor
>>  		parameters. The full information about the descriptor
>>  		could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -464,6 +514,7 @@ Description:	This file shows maximum VCC, VCCQ and VCCQ2 value for
>>  		active ICC levels from 0 to 15. This is one of the UFS
>>  		power descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -473,6 +524,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file contains a device manufactureer name string.
>>  		The full information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_name
>> @@ -480,6 +532,7 @@ Date:		February 2018
>>  Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file contains a product name string. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/string_descriptors/oem_id
>> @@ -487,6 +540,7 @@ Date:		February 2018
>>  Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file contains a OEM ID string. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/string_descriptors/serial_number
>> @@ -495,6 +549,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file contains a device serial number string. The full
>>  		information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_revision
>> @@ -503,6 +558,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file contains a product revision string. The full
>>  		information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -512,6 +568,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows boot LUN information. This is one of
>>  		the UFS unit descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/lun_write_protect
>> @@ -520,6 +577,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows LUN write protection status. This is one of
>>  		the UFS unit descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/lun_queue_depth
>> @@ -528,6 +586,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows LUN queue depth. This is one of the UFS
>>  		unit descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/psa_sensitive
>> @@ -536,6 +595,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows PSA sensitivity. This is one of the UFS
>>  		unit descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/lun_memory_type
>> @@ -544,6 +604,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows LUN memory type. This is one of the UFS
>>  		unit descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/data_reliability
>> @@ -553,6 +614,7 @@ Description:	This file defines the device behavior when a power failure
>>  		occurs during a write operation. This is one of the UFS
>>  		unit descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/logical_block_size
>> @@ -562,6 +624,7 @@ Description:	This file shows the size of addressable logical blocks
>>  		(calculated as an exponent with base 2). This is one of
>>  		the UFS unit descriptor parameters. The full information about
>>  		the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/logical_block_count
>> @@ -571,6 +634,7 @@ Description:	This file shows total number of addressable logical blocks.
>>  		This is one of the UFS unit descriptor parameters. The full
>>  		information about the descriptor could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/erase_block_size
>> @@ -579,6 +643,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the erase block size. This is one of
>>  		the UFS unit descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/provisioning_type
>> @@ -587,6 +652,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the thin provisioning type. This is one of
>>  		the UFS unit descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/physical_memory_resourse_count
>> @@ -595,6 +661,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the total physical memory resources. This is
>>  		one of the UFS unit descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/context_capabilities
>> @@ -603,6 +670,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the context capabilities. This is one of
>>  		the UFS unit descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/large_unit_granularity
>> @@ -611,6 +679,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the granularity of the LUN. This is one of
>>  		the UFS unit descriptor parameters. The full information
>>  		about the descriptor could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -619,6 +688,7 @@ Date:		February 2018
>>  Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the device init status. The full information
>>  		about the flag could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/permanent_wpe
>> @@ -627,6 +697,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows whether permanent write protection is enabled.
>>  		The full information about the flag could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/power_on_wpe
>> @@ -636,6 +707,7 @@ Description:	This file shows whether write protection is enabled on all
>>  		logical units configured as power on write protected. The
>>  		full information about the flag could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/bkops_enable
>> @@ -644,6 +716,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows whether the device background operations are
>>  		enabled. The full information about the flag could be
>>  		found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/life_span_mode_enable
>> @@ -652,6 +725,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows whether the device life span mode is enabled.
>>  		The full information about the flag could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/phy_resource_removal
>> @@ -660,6 +734,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows whether physical resource removal is enable.
>>  		The full information about the flag could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/busy_rtc
>> @@ -668,6 +743,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows whether the device is executing internal
>>  		operation related to real time clock. The full information
>>  		about the flag could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/disable_fw_update
>> @@ -676,6 +752,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows whether the device FW update is permanently
>>  		disabled. The full information about the flag could be found
>>  		at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -685,6 +762,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the boot lun enabled UFS device attribute.
>>  		The full information about the attribute could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/current_power_mode
>> @@ -693,6 +771,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the current power mode UFS device attribute.
>>  		The full information about the attribute could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/active_icc_level
>> @@ -701,6 +780,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the active icc level UFS device attribute.
>>  		The full information about the attribute could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/ooo_data_enabled
>> @@ -709,6 +789,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the out of order data transfer enabled UFS
>>  		device attribute. The full information about the attribute
>>  		could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/bkops_status
>> @@ -717,6 +798,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the background operations status UFS device
>>  		attribute. The full information about the attribute could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/purge_status
>> @@ -725,6 +807,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the purge operation status UFS device
>>  		attribute. The full information about the attribute could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/max_data_in_size
>> @@ -733,6 +816,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the maximum data size in a DATA IN
>>  		UPIU. The full information about the attribute could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/max_data_out_size
>> @@ -741,6 +825,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file shows the maximum number of bytes that can be
>>  		requested with a READY TO TRANSFER UPIU. The full information
>>  		about the attribute could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/reference_clock_frequency
>> @@ -749,6 +834,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the reference clock frequency UFS device
>>  		attribute. The full information about the attribute could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/configuration_descriptor_lock
>> @@ -765,6 +851,7 @@ Description:	This file provides the maximum current number of
>>  		outstanding RTTs in device that is allowed. The full
>>  		information about the attribute could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_control
>> @@ -773,6 +860,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the exception event control UFS device
>>  		attribute. The full information about the attribute could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/exception_event_status
>> @@ -781,6 +869,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the exception event status UFS device
>>  		attribute. The full information about the attribute could
>>  		be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/ffu_status
>> @@ -789,6 +878,7 @@ Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file provides the ffu status UFS device attribute.
>>  		The full information about the attribute could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/psa_state
>> @@ -796,6 +886,7 @@ Date:		February 2018
>>  Contact:	Stanislav Nijnikov <stanislav.nijnikov@wdc.com>
>>  Description:	This file show the PSA feature status. The full information
>>  		about the attribute could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/psa_data_size
>> @@ -805,6 +896,7 @@ Description:	This file shows the amount of data that the host plans to
>>  		load to all logical units in pre-soldering state.
>>  		The full information about the attribute could be found at
>>  		UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -815,6 +907,7 @@ Description:	This file shows the The amount of physical memory needed
>>  		to be removed from the physical memory resources pool of
>>  		the particular logical unit. The full information about
>>  		the attribute could be found at UFS specifications 2.1.
>> +
>>  		The file is read only.
>>  
>>  
>> @@ -824,24 +917,28 @@ Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>>  Description:	This entry could be used to set or show the UFS device
>>  		runtime power management level. The current driver
>>  		implementation supports 6 levels with next target states:
>> -		0 - an UFS device will stay active, an UIC link will
>> -		stay active
>> -		1 - an UFS device will stay active, an UIC link will
>> -		hibernate
>> -		2 - an UFS device will moved to sleep, an UIC link will
>> -		stay active
>> -		3 - an UFS device will moved to sleep, an UIC link will
>> -		hibernate
>> -		4 - an UFS device will be powered off, an UIC link will
>> -		hibernate
>> -		5 - an UFS device will be powered off, an UIC link will
>> -		be powered off
>> +
>> +		==  ====================================================
>> +		0   an UFS device will stay active, an UIC link will
>> +		    stay active
>> +		1   an UFS device will stay active, an UIC link will
>> +		    hibernate
>> +		2   an UFS device will moved to sleep, an UIC link will
>> +		    stay active
>> +		3   an UFS device will moved to sleep, an UIC link will
>> +		    hibernate
>> +		4   an UFS device will be powered off, an UIC link will
>> +		    hibernate
>> +		5   an UFS device will be powered off, an UIC link will
>> +		    be powered off
>> +		==  ====================================================
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/rpm_target_dev_state
>>  Date:		February 2018
>>  Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>>  Description:	This entry shows the target power mode of an UFS device
>>  		for the chosen runtime power management level.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/rpm_target_link_state
>> @@ -849,6 +946,7 @@ Date:		February 2018
>>  Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>>  Description:	This entry shows the target state of an UFS UIC link
>>  		for the chosen runtime power management level.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/spm_lvl
>> @@ -857,24 +955,28 @@ Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>>  Description:	This entry could be used to set or show the UFS device
>>  		system power management level. The current driver
>>  		implementation supports 6 levels with next target states:
>> -		0 - an UFS device will stay active, an UIC link will
>> -		stay active
>> -		1 - an UFS device will stay active, an UIC link will
>> -		hibernate
>> -		2 - an UFS device will moved to sleep, an UIC link will
>> -		stay active
>> -		3 - an UFS device will moved to sleep, an UIC link will
>> -		hibernate
>> -		4 - an UFS device will be powered off, an UIC link will
>> -		hibernate
>> -		5 - an UFS device will be powered off, an UIC link will
>> -		be powered off
>> +
>> +		==  ====================================================
>> +		0   an UFS device will stay active, an UIC link will
>> +		    stay active
>> +		1   an UFS device will stay active, an UIC link will
>> +		    hibernate
>> +		2   an UFS device will moved to sleep, an UIC link will
>> +		    stay active
>> +		3   an UFS device will moved to sleep, an UIC link will
>> +		    hibernate
>> +		4   an UFS device will be powered off, an UIC link will
>> +		    hibernate
>> +		5   an UFS device will be powered off, an UIC link will
>> +		    be powered off
>> +		==  ====================================================
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/spm_target_dev_state
>>  Date:		February 2018
>>  Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>>  Description:	This entry shows the target power mode of an UFS device
>>  		for the chosen system power management level.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/spm_target_link_state
>> @@ -882,18 +984,21 @@ Date:		February 2018
>>  Contact:	Subhash Jadavani <subhashj@codeaurora.org>
>>  Description:	This entry shows the target state of an UFS UIC link
>>  		for the chosen system power management level.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_presv_us_en
>>  Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows if preserve user-space was configured
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_shared_alloc_units
>>  Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the shared allocated units of WB buffer
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/device_descriptor/wb_type
>> @@ -901,6 +1006,7 @@ Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the configured WB type.
>>  		0x1 for shared buffer mode. 0x0 for dedicated buffer mode.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_buff_cap_adj
>> @@ -910,6 +1016,7 @@ Description:	This entry shows the total user-space decrease in shared
>>  		buffer mode.
>>  		The value of this parameter is 3 for TLC NAND when SLC mode
>>  		is used as WriteBooster Buffer. 2 for MLC NAND.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_alloc_units
>> @@ -917,6 +1024,7 @@ Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the Maximum total WriteBooster Buffer size
>>  		which is supported by the entire device.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_max_wb_luns
>> @@ -924,6 +1032,7 @@ Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the maximum number of luns that can support
>>  		WriteBooster.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_red_type
>> @@ -937,46 +1046,59 @@ Description:	The supportability of user space reduction mode
>>  		preserve user space type.
>>  		02h: Device can be configured in either user space
>>  		reduction type or preserve user space type.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/geometry_descriptor/wb_sup_wb_type
>>  Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	The supportability of WriteBooster Buffer type.
>> -		00h: LU based WriteBooster Buffer configuration
>> -		01h: Single shared WriteBooster Buffer
>> -		configuration
>> -		02h: Supporting both LU based WriteBooster
>> -		Buffer and Single shared WriteBooster Buffer
>> -		configuration
>> +
>> +		===  ==========================================================
>> +		00h  LU based WriteBooster Buffer configuration
>> +		01h  Single shared WriteBooster Buffer configuration
>> +		02h  Supporting both LU based WriteBooster.
>> +		     Buffer and Single shared WriteBooster Buffer configuration
>> +		===  ==========================================================
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/wb_enable
>>  Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the status of WriteBooster.
>> -		0: WriteBooster is not enabled.
>> -		1: WriteBooster is enabled
>> +
>> +		== ============================
>> +		0  WriteBooster is not enabled.
>> +		1  WriteBooster is enabled
>> +		== ============================
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_en
>>  Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows if flush is enabled.
>> -		0: Flush operation is not performed.
>> -		1: Flush operation is performed.
>> +
>> +		== =================================
>> +		0  Flush operation is not performed.
>> +		1  Flush operation is performed.
>> +		== =================================
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/flags/wb_flush_during_h8
>>  Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	Flush WriteBooster Buffer during hibernate state.
>> -		0: Device is not allowed to flush the
>> -		WriteBooster Buffer during link hibernate
>> -		state.
>> -		1: Device is allowed to flush the
>> -		WriteBooster Buffer during link hibernate
>> -		state
>> +
>> +		== =================================================
>> +		0  Device is not allowed to flush the
>> +		   WriteBooster Buffer during link hibernate state.
>> +		1  Device is allowed to flush the
>> +		   WriteBooster Buffer during link hibernate state.
>> +		== =================================================
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/wb_avail_buf
>> @@ -984,23 +1106,30 @@ Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the amount of unused WriteBooster buffer
>>  		available.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/wb_cur_buf
>>  Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the amount of unused current buffer.
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/wb_flush_status
>>  Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the flush operation status.
>> -		00h: idle
>> -		01h: Flush operation in progress
>> -		02h: Flush operation stopped prematurely.
>> -		03h: Flush operation completed successfully
>> -		04h: Flush operation general failure
>> +
>> +
>> +		===  ======================================
>> +		00h  idle
>> +		01h  Flush operation in progress
>> +		02h  Flush operation stopped prematurely.
>> +		03h  Flush operation completed successfully
>> +		04h  Flush operation general failure
>> +		===  ======================================
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/bus/platform/drivers/ufshcd/*/attributes/wb_life_time_est
>> @@ -1008,9 +1137,13 @@ Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows an indication of the WriteBooster Buffer
>>  		lifetime based on the amount of performed program/erase cycles
>> -		01h: 0% - 10% WriteBooster Buffer life time used
>> +
>> +		===  =============================================
>> +		01h  0% - 10% WriteBooster Buffer life time used
>>  		...
>> -		0Ah: 90% - 100% WriteBooster Buffer life time used
>> +		0Ah  90% - 100% WriteBooster Buffer life time used
>> +		===  =============================================
>> +
>>  		The file is read only.
>>  
>>  What:		/sys/class/scsi_device/*/device/unit_descriptor/wb_buf_alloc_units
>> @@ -1018,4 +1151,5 @@ Date:		June 2020
>>  Contact:	Asutosh Das <asutoshd@codeaurora.org>
>>  Description:	This entry shows the configured size of WriteBooster buffer.
>>  		0400h corresponds to 4GB.
>> +
>>  		The file is read only.
>> diff --git a/Documentation/ABI/testing/sysfs-driver-w1_ds28e17 b/Documentation/ABI/testing/sysfs-driver-w1_ds28e17
>> index d301e7017afe..e92aba4eb594 100644
>> --- a/Documentation/ABI/testing/sysfs-driver-w1_ds28e17
>> +++ b/Documentation/ABI/testing/sysfs-driver-w1_ds28e17
>> @@ -5,7 +5,9 @@ Contact:	Jan Kandziora <jjj@gmx.de>
>>  Description:	When written, this file sets the I2C speed on the connected
>>  		DS28E17 chip. When read, it reads the current setting from
>>  		the DS28E17 chip.
>> +
>>  		Valid values: 100, 400, 900 [kBaud].
>> +
>>  		Default 100, can be set by w1_ds28e17.speed= module parameter.
>>  Users:		w1_ds28e17 driver
>>  
>> @@ -17,5 +19,6 @@ Description:	When written, this file sets the multiplier used to calculate
>>  		the busy timeout for I2C operations on the connected DS28E17
>>  		chip. When read, returns the current setting.
>>  		Valid values: 1 to 9.
>> +
>>  		Default 1, can be set by w1_ds28e17.stretch= module parameter.
>>  Users:		w1_ds28e17 driver
>> diff --git a/Documentation/ABI/testing/sysfs-firmware-acpi b/Documentation/ABI/testing/sysfs-firmware-acpi
>> index e4afc2538210..b16d30a71709 100644
>> --- a/Documentation/ABI/testing/sysfs-firmware-acpi
>> +++ b/Documentation/ABI/testing/sysfs-firmware-acpi
>> @@ -81,11 +81,11 @@ Description:
>>  		  $ cd /sys/firmware/acpi/interrupts
>>  		  $ grep . *
>>  		  error:	     0
>> -		  ff_gbl_lock:	   0   enable
>> -		  ff_pmtimer:	  0  invalid
>> -		  ff_pwr_btn:	  0   enable
>> -		  ff_rt_clk:	 2  disable
>> -		  ff_slp_btn:	  0  invalid
>> +		  ff_gbl_lock:	     0   enable
>> +		  ff_pmtimer:	     0  invalid
>> +		  ff_pwr_btn:	     0   enable
>> +		  ff_rt_clk:	     2  disable
>> +		  ff_slp_btn:	     0  invalid
>>  		  gpe00:	     0	invalid
>>  		  gpe01:	     0	 enable
>>  		  gpe02:	   108	 enable
>> @@ -118,9 +118,9 @@ Description:
>>  		  gpe1D:	     0	invalid
>>  		  gpe1E:	     0	invalid
>>  		  gpe1F:	     0	invalid
>> -		  gpe_all:    1192
>> -		  sci:	1194
>> -		  sci_not:     0
>> +		  gpe_all:	  1192
>> +		  sci:		  1194
>> +		  sci_not:	     0
>>  
>>  		===========  ==================================================
>>  		sci	     The number of times the ACPI SCI
>> diff --git a/Documentation/ABI/testing/sysfs-firmware-efi-esrt b/Documentation/ABI/testing/sysfs-firmware-efi-esrt
>> index 6e431d1a4e79..31b57676d4ad 100644
>> --- a/Documentation/ABI/testing/sysfs-firmware-efi-esrt
>> +++ b/Documentation/ABI/testing/sysfs-firmware-efi-esrt
>> @@ -35,10 +35,13 @@ What:		/sys/firmware/efi/esrt/entries/entry$N/fw_type
>>  Date:		February 2015
>>  Contact:	Peter Jones <pjones@redhat.com>
>>  Description:	What kind of firmware entry this is:
>> -		0 - Unknown
>> -		1 - System Firmware
>> -		2 - Device Firmware
>> -		3 - UEFI Driver
>> +
>> +		==  ===============
>> +		0   Unknown
>> +		1   System Firmware
>> +		2   Device Firmware
>> +		3   UEFI Driver
>> +		==  ===============
>>  
>>  What:		/sys/firmware/efi/esrt/entries/entry$N/fw_class
>>  Date:		February 2015
>> @@ -71,11 +74,14 @@ Date:		February 2015
>>  Contact:	Peter Jones <pjones@redhat.com>
>>  Description:	The result of the last firmware update attempt for the
>>  		firmware resource entry.
>> -		0 - Success
>> -		1 - Insufficient resources
>> -		2 - Incorrect version
>> -		3 - Invalid format
>> -		4 - Authentication error
>> -		5 - AC power event
>> -		6 - Battery power event
>> +
>> +		==  ======================
>> +		0   Success
>> +		1   Insufficient resources
>> +		2   Incorrect version
>> +		3   Invalid format
>> +		4   Authentication error
>> +		5   AC power event
>> +		6   Battery power event
>> +		==  ======================
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map b/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map
>> index c61b9b348e99..9c4d581be396 100644
>> --- a/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map
>> +++ b/Documentation/ABI/testing/sysfs-firmware-efi-runtime-map
>> @@ -14,7 +14,7 @@ Description:	Switching efi runtime services to virtual mode requires
>>  		/sys/firmware/efi/runtime-map/ is the directory the kernel
>>  		exports that information in.
>>  
>> -		subdirectories are named with the number of the memory range:
>> +		subdirectories are named with the number of the memory range::
>>  
>>  			/sys/firmware/efi/runtime-map/0
>>  			/sys/firmware/efi/runtime-map/1
>> @@ -24,11 +24,13 @@ Description:	Switching efi runtime services to virtual mode requires
>>  
>>  		Each subdirectory contains five files:
>>  
>> -		attribute : The attributes of the memory range.
>> -		num_pages : The size of the memory range in pages.
>> -		phys_addr : The physical address of the memory range.
>> -		type      : The type of the memory range.
>> -		virt_addr : The virtual address of the memory range.
>> +		=========   =========================================
>> +		attribute   The attributes of the memory range.
>> +		num_pages   The size of the memory range in pages.
>> +		phys_addr   The physical address of the memory range.
>> +		type        The type of the memory range.
>> +		virt_addr   The virtual address of the memory range.
>> +		=========   =========================================
>>  
>>  		Above values are all hexadecimal numbers with the '0x' prefix.
>>  Users:		Kexec
>> diff --git a/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg b/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg
>> index 011dda4f8e8a..ee0d6dbc810e 100644
>> --- a/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg
>> +++ b/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg
>> @@ -15,7 +15,7 @@ Description:
>>  		to the fw_cfg device can be found in "docs/specs/fw_cfg.txt"
>>  		in the QEMU source tree.
>>  
>> -		=== SysFS fw_cfg Interface ===
>> +		**SysFS fw_cfg Interface**
>>  
>>  		The fw_cfg sysfs interface described in this document is only
>>  		intended to display discoverable blobs (i.e., those registered
>> @@ -31,7 +31,7 @@ Description:
>>  
>>  			/sys/firmware/qemu_fw_cfg/rev
>>  
>> -		--- Discoverable fw_cfg blobs by selector key ---
>> +		**Discoverable fw_cfg blobs by selector key**
>>  
>>  		All discoverable blobs listed in the fw_cfg file directory are
>>  		displayed as entries named after their unique selector key
>> @@ -45,24 +45,26 @@ Description:
>>  		Each such fw_cfg sysfs entry has the following values exported
>>  		as attributes:
>>  
>> -		name  	: The 56-byte nul-terminated ASCII string used as the
>> +		====	  ====================================================
>> +		name	  The 56-byte nul-terminated ASCII string used as the
>>  			  blob's 'file name' in the fw_cfg directory.
>> -		size  	: The length of the blob, as given in the fw_cfg
>> +		size	  The length of the blob, as given in the fw_cfg
>>  			  directory.
>> -		key	: The value of the blob's selector key as given in the
>> +		key	  The value of the blob's selector key as given in the
>>  			  fw_cfg directory. This value is the same as used in
>>  			  the parent directory name.
>> -		raw	: The raw bytes of the blob, obtained by selecting the
>> +		raw	  The raw bytes of the blob, obtained by selecting the
>>  			  entry via the control register, and reading a number
>>  			  of bytes equal to the blob size from the data
>>  			  register.
>> +		====	  ====================================================
>>  
>> -		--- Listing fw_cfg blobs by file name ---
>> +		**Listing fw_cfg blobs by file name**
>>  
>>  		While the fw_cfg device does not impose any specific naming
>>  		convention on the blobs registered in the file directory,
>>  		QEMU developers have traditionally used path name semantics
>> -		to give each blob a descriptive name. For example:
>> +		to give each blob a descriptive name. For example::
>>  
>>  			"bootorder"
>>  			"genroms/kvmvapic.bin"
>> @@ -81,7 +83,7 @@ Description:
>>  		of directories matching the path name components of fw_cfg
>>  		blob names, ending in symlinks to the by_key entry for each
>>  		"basename", as illustrated below (assume current directory is
>> -		/sys/firmware):
>> +		/sys/firmware)::
>>  
>>  		    qemu_fw_cfg/by_name/bootorder -> ../by_key/38
>>  		    qemu_fw_cfg/by_name/etc/e820 -> ../../by_key/35
>> diff --git a/Documentation/ABI/testing/sysfs-firmware-sfi b/Documentation/ABI/testing/sysfs-firmware-sfi
>> index 4be7d44aeacf..5210e0f06ddb 100644
>> --- a/Documentation/ABI/testing/sysfs-firmware-sfi
>> +++ b/Documentation/ABI/testing/sysfs-firmware-sfi
>> @@ -9,7 +9,7 @@ Description:
>>  		http://simplefirmware.org/documentation
>>  
>>  		While the tables are used by the kernel, user-space
>> -		can observe them this way:
>> +		can observe them this way::
>>  
>> -		# cd /sys/firmware/sfi/tables
>> -		# cat $TABLENAME > $TABLENAME.bin
>> +		  # cd /sys/firmware/sfi/tables
>> +		  # cat $TABLENAME > $TABLENAME.bin
>> diff --git a/Documentation/ABI/testing/sysfs-firmware-sgi_uv b/Documentation/ABI/testing/sysfs-firmware-sgi_uv
>> index 4573fd4b7876..66800baab096 100644
>> --- a/Documentation/ABI/testing/sysfs-firmware-sgi_uv
>> +++ b/Documentation/ABI/testing/sysfs-firmware-sgi_uv
>> @@ -5,7 +5,7 @@ Description:
>>  		The /sys/firmware/sgi_uv directory contains information
>>  		about the SGI UV platform.
>>  
>> -		Under that directory are a number of files:
>> +		Under that directory are a number of files::
>>  
>>  			partition_id
>>  			coherence_id
>> @@ -14,7 +14,7 @@ Description:
>>  		SGI UV systems can be partitioned into multiple physical
>>  		machines, which each partition running a unique copy
>>  		of the operating system.  Each partition will have a unique
>> -		partition id.  To display the partition id, use the command:
>> +		partition id.  To display the partition id, use the command::
>>  
>>  			cat /sys/firmware/sgi_uv/partition_id
>>  
>> @@ -22,6 +22,6 @@ Description:
>>  		A partitioned SGI UV system can have one or more coherence
>>  		domain.  The coherence id indicates which coherence domain
>>  		this partition is in.  To display the coherence id, use the
>> -		command:
>> +		command::
>>  
>>  			cat /sys/firmware/sgi_uv/coherence_id
>> diff --git a/Documentation/ABI/testing/sysfs-fs-f2fs b/Documentation/ABI/testing/sysfs-fs-f2fs
>> index 834d0becae6d..67b3ed8e8c2f 100644
>> --- a/Documentation/ABI/testing/sysfs-fs-f2fs
>> +++ b/Documentation/ABI/testing/sysfs-fs-f2fs
>> @@ -20,10 +20,13 @@ What:		/sys/fs/f2fs/<disk>/gc_idle
>>  Date:		July 2013
>>  Contact:	"Namjae Jeon" <namjae.jeon@samsung.com>
>>  Description:	Controls the victim selection policy for garbage collection.
>> -		Setting gc_idle = 0(default) will disable this option. Setting
>> -		gc_idle = 1 will select the Cost Benefit approach & setting
>> -		gc_idle = 2 will select the greedy approach & setting
>> -		gc_idle = 3 will select the age-threshold based approach.
>> +		Setting gc_idle = 0(default) will disable this option. Setting:
>> +
>> +		===========  ===============================================
>> +		gc_idle = 1  will select the Cost Benefit approach & setting
>> +		gc_idle = 2  will select the greedy approach & setting
>> +		gc_idle = 3  will select the age-threshold based approach.
>> +		===========  ===============================================
>>  
>>  What:		/sys/fs/f2fs/<disk>/reclaim_segments
>>  Date:		October 2013
>> @@ -46,10 +49,17 @@ Date:		November 2013
>>  Contact:	"Jaegeuk Kim" <jaegeuk.kim@samsung.com>
>>  Description:	Controls the in-place-update policy.
>>  		updates in f2fs. User can set:
>> -		0x01: F2FS_IPU_FORCE, 0x02: F2FS_IPU_SSR,
>> -		0x04: F2FS_IPU_UTIL,  0x08: F2FS_IPU_SSR_UTIL,
>> -		0x10: F2FS_IPU_FSYNC, 0x20: F2FS_IPU_ASYNC,
>> -		0x40: F2FS_IPU_NOCACHE.
>> +
>> +		====  =================
>> +		0x01  F2FS_IPU_FORCE
>> +		0x02  F2FS_IPU_SSR
>> +		0x04  F2FS_IPU_UTIL
>> +		0x08  F2FS_IPU_SSR_UTIL
>> +		0x10  F2FS_IPU_FSYNC
>> +		0x20  F2FS_IPU_ASYNC,
>> +		0x40  F2FS_IPU_NOCACHE
>> +		====  =================
>> +
>>  		Refer segment.h for details.
>>  
>>  What:		/sys/fs/f2fs/<disk>/min_ipu_util
>> @@ -332,18 +342,28 @@ Date:		April 2020
>>  Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
>>  Description:	Give a way to attach REQ_META|FUA to data writes
>>  		given temperature-based bits. Now the bits indicate:
>> -		*      REQ_META     |      REQ_FUA      |
>> -		*    5 |    4 |   3 |    2 |    1 |   0 |
>> -		* Cold | Warm | Hot | Cold | Warm | Hot |
>> +
>> +		+-------------------+-------------------+
>> +		|      REQ_META     |      REQ_FUA      |
>> +		+------+------+-----+------+------+-----+
>> +		|    5 |    4 |   3 |    2 |    1 |   0 |
>> +		+------+------+-----+------+------+-----+
>> +		| Cold | Warm | Hot | Cold | Warm | Hot |
>> +		+------+------+-----+------+------+-----+
>>  
>>  What:		/sys/fs/f2fs/<disk>/node_io_flag
>>  Date:		June 2020
>>  Contact:	"Jaegeuk Kim" <jaegeuk@kernel.org>
>>  Description:	Give a way to attach REQ_META|FUA to node writes
>>  		given temperature-based bits. Now the bits indicate:
>> -		*      REQ_META     |      REQ_FUA      |
>> -		*    5 |    4 |   3 |    2 |    1 |   0 |
>> -		* Cold | Warm | Hot | Cold | Warm | Hot |
>> +
>> +		+-------------------+-------------------+
>> +		|      REQ_META     |      REQ_FUA      |
>> +		+------+------+-----+------+------+-----+
>> +		|    5 |    4 |   3 |    2 |    1 |   0 |
>> +		+------+------+-----+------+------+-----+
>> +		| Cold | Warm | Hot | Cold | Warm | Hot |
>> +		+------+------+-----+------+------+-----+
>>  
>>  What:		/sys/fs/f2fs/<disk>/iostat_period_ms
>>  Date:		April 2020
>> diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-ksm b/Documentation/ABI/testing/sysfs-kernel-mm-ksm
>> index dfc13244cda3..1c9bed5595f5 100644
>> --- a/Documentation/ABI/testing/sysfs-kernel-mm-ksm
>> +++ b/Documentation/ABI/testing/sysfs-kernel-mm-ksm
>> @@ -34,8 +34,9 @@ Description:	Kernel Samepage Merging daemon sysfs interface
>>  		in a tree.
>>  
>>  		run: write 0 to disable ksm, read 0 while ksm is disabled.
>> -			write 1 to run ksm, read 1 while ksm is running.
>> -			write 2 to disable ksm and unmerge all its pages.
>> +
>> +			- write 1 to run ksm, read 1 while ksm is running.
>> +			- write 2 to disable ksm and unmerge all its pages.
>>  
>>  		sleep_millisecs: how many milliseconds ksm should sleep between
>>  		scans.
>> diff --git a/Documentation/ABI/testing/sysfs-kernel-slab b/Documentation/ABI/testing/sysfs-kernel-slab
>> index ed35833ad7f0..c9f12baf8baa 100644
>> --- a/Documentation/ABI/testing/sysfs-kernel-slab
>> +++ b/Documentation/ABI/testing/sysfs-kernel-slab
>> @@ -346,6 +346,7 @@ Description:
>>  		number of objects per slab.  If a slab cannot be allocated
>>  		because of fragmentation, SLUB will retry with the minimum order
>>  		possible depending on its characteristics.
>> +
>>  		When debug_guardpage_minorder=N (N > 0) parameter is specified
>>  		(see Documentation/admin-guide/kernel-parameters.rst), the minimum possible
>>  		order is used and this sysfs entry can not be used to change
>> @@ -361,6 +362,7 @@ Description:
>>  		new slab has not been possible at the cache's order and instead
>>  		fallen back to its minimum possible order.  It can be written to
>>  		clear the current count.
>> +
>>  		Available when CONFIG_SLUB_STATS is enabled.
>>  
>>  What:		/sys/kernel/slab/cache/partial
>> @@ -410,6 +412,7 @@ Description:
>>  		slab from a remote node as opposed to allocating a new slab on
>>  		the local node.  This reduces the amount of wasted memory over
>>  		the entire system but can be expensive.
>> +
>>  		Available when CONFIG_NUMA is enabled.
>>  
>>  What:		/sys/kernel/slab/cache/sanity_checks
>> diff --git a/Documentation/ABI/testing/sysfs-module b/Documentation/ABI/testing/sysfs-module
>> index 0aac02e7fb0e..353c0db5bc1f 100644
>> --- a/Documentation/ABI/testing/sysfs-module
>> +++ b/Documentation/ABI/testing/sysfs-module
>> @@ -17,14 +17,15 @@ KernelVersion:	3.1
>>  Contact:	Kirill Smelkov <kirr@mns.spb.ru>
>>  Description:	Maximum time allowed for periodic transfers per microframe (μs)
>>  
>> -		[ USB 2.0 sets maximum allowed time for periodic transfers per
>> +		Note:
>> +		  USB 2.0 sets maximum allowed time for periodic transfers per
>>  		  microframe to be 80%, that is 100 microseconds out of 125
>>  		  microseconds (full microframe).
>>  
>>  		  However there are cases, when 80% max isochronous bandwidth is
>>  		  too limiting. For example two video streams could require 110
>>  		  microseconds of isochronous bandwidth per microframe to work
>> -		  together. ]
>> +		  together. 
>>  
>>  		Through this setting it is possible to raise the limit so that
>>  		the host controller would allow allocating more than 100
>> @@ -45,8 +46,10 @@ Date:		Jan 2012
>>  KernelVersion:»·3.3
>>  Contact:	Kay Sievers <kay.sievers@vrfy.org>
>>  Description:	Module taint flags:
>> -			P - proprietary module
>> -			O - out-of-tree module
>> -			F - force-loaded module
>> -			C - staging driver module
>> -			E - unsigned module
>> +			==  =====================
>> +			P   proprietary module
>> +			O   out-of-tree module
>> +			F   force-loaded module
>> +			C   staging driver module
>> +			E   unsigned module
>> +			==  =====================
>> diff --git a/Documentation/ABI/testing/sysfs-platform-dell-laptop b/Documentation/ABI/testing/sysfs-platform-dell-laptop
>> index 9b917c7453de..82bcfe9df66e 100644
>> --- a/Documentation/ABI/testing/sysfs-platform-dell-laptop
>> +++ b/Documentation/ABI/testing/sysfs-platform-dell-laptop
>> @@ -34,9 +34,12 @@ Description:
>>  		this file. To disable a trigger, write its name preceded
>>  		by '-' instead.
>>  
>> -		For example, to enable the keyboard as trigger run:
>> +		For example, to enable the keyboard as trigger run::
>> +
>>  		    echo +keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
>> -		To disable it:
>> +
>> +		To disable it::
>> +
>>  		    echo -keyboard > /sys/class/leds/dell::kbd_backlight/start_triggers
>>  
>>  		Note that not all the available triggers can be configured.
>> @@ -57,7 +60,8 @@ Description:
>>  		with any the above units. If no unit is specified, the value
>>  		is assumed to be expressed in seconds.
>>  
>> -		For example, to set the timeout to 10 minutes run:
>> +		For example, to set the timeout to 10 minutes run::
>> +
>>  		    echo 10m > /sys/class/leds/dell::kbd_backlight/stop_timeout
>>  
>>  		Note that when this file is read, the returned value might be
>> diff --git a/Documentation/ABI/testing/sysfs-platform-dell-smbios b/Documentation/ABI/testing/sysfs-platform-dell-smbios
>> index 205d3b6361e0..e6e0f7f834a7 100644
>> --- a/Documentation/ABI/testing/sysfs-platform-dell-smbios
>> +++ b/Documentation/ABI/testing/sysfs-platform-dell-smbios
>> @@ -13,8 +13,8 @@ Description:
>>  		For example the token ID "5" would be available
>>  		as the following attributes:
>>  
>> -		0005_location
>> -		0005_value
>> +		- 0005_location
>> +		- 0005_value
>>  
>>  		Tokens will vary from machine to machine, and
>>  		only tokens available on that machine will be
>> diff --git a/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl b/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl
>> index c394b808be19..b6a138b50d99 100644
>> --- a/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl
>> +++ b/Documentation/ABI/testing/sysfs-platform-i2c-demux-pinctrl
>> @@ -5,9 +5,9 @@ Contact:	Wolfram Sang <wsa+renesas@sang-engineering.com>
>>  Description:
>>  		Reading the file will give you a list of masters which can be
>>  		selected for a demultiplexed bus. The format is
>> -		"<index>:<name>". Example from a Renesas Lager board:
>> +		"<index>:<name>". Example from a Renesas Lager board::
>>  
>> -		0:/i2c@e6500000 1:/i2c@e6508000
>> +		  0:/i2c@e6500000 1:/i2c@e6508000
>>  
>>  What:		/sys/devices/platform/<i2c-demux-name>/current_master
>>  Date:		January 2016
>> diff --git a/Documentation/ABI/testing/sysfs-platform-kim b/Documentation/ABI/testing/sysfs-platform-kim
>> index c1653271872a..a7f81de68046 100644
>> --- a/Documentation/ABI/testing/sysfs-platform-kim
>> +++ b/Documentation/ABI/testing/sysfs-platform-kim
>> @@ -5,6 +5,7 @@ Contact:	"Pavan Savoy" <pavan_savoy@ti.com>
>>  Description:
>>  		Name of the UART device at which the WL128x chip
>>  		is connected. example: "/dev/ttyS0".
>> +
>>  		The device name flows down to architecture specific board
>>  		initialization file from the SFI/ATAGS bootloader
>>  		firmware. The name exposed is read from the user-space
>> diff --git a/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2 b/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2
>> index 6212697bbf6f..bc510ccc37a7 100644
>> --- a/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2
>> +++ b/Documentation/ABI/testing/sysfs-platform-phy-rcar-gen3-usb2
>> @@ -7,9 +7,11 @@ Description:
>>  		The file can show/change the phy mode for role swap of usb.
>>  
>>  		Write the following strings to change the mode:
>> -		 "host" - switching mode from peripheral to host.
>> -		 "peripheral" - switching mode from host to peripheral.
>> +
>> +		 - "host" - switching mode from peripheral to host.
>> +		 - "peripheral" - switching mode from host to peripheral.
>>  
>>  		Read the file, then it shows the following strings:
>> -		 "host" - The mode is host now.
>> -		 "peripheral" - The mode is peripheral now.
>> +
>> +		 - "host" - The mode is host now.
>> +		 - "peripheral" - The mode is peripheral now.
>> diff --git a/Documentation/ABI/testing/sysfs-platform-renesas_usb3 b/Documentation/ABI/testing/sysfs-platform-renesas_usb3
>> index 5621c15d5dc0..8af5b9c3fabb 100644
>> --- a/Documentation/ABI/testing/sysfs-platform-renesas_usb3
>> +++ b/Documentation/ABI/testing/sysfs-platform-renesas_usb3
>> @@ -7,9 +7,11 @@ Description:
>>  		The file can show/change the drd mode of usb.
>>  
>>  		Write the following string to change the mode:
>> -		 "host" - switching mode from peripheral to host.
>> -		 "peripheral" - switching mode from host to peripheral.
>> +
>> +		- "host" - switching mode from peripheral to host.
>> +		- "peripheral" - switching mode from host to peripheral.
>>  
>>  		Read the file, then it shows the following strings:
>> -		 "host" - The mode is host now.
>> -		 "peripheral" - The mode is peripheral now.
>> +		
>> +		- "host" - The mode is host now.
>> +		- "peripheral" - The mode is peripheral now.
>> diff --git a/Documentation/ABI/testing/sysfs-power b/Documentation/ABI/testing/sysfs-power
>> index 5e6ead29124c..51c0f578bfce 100644
>> --- a/Documentation/ABI/testing/sysfs-power
>> +++ b/Documentation/ABI/testing/sysfs-power
>> @@ -47,14 +47,18 @@ Description:
>>  		suspend-to-disk mechanism.  Reading from this file returns
>>  		the name of the method by which the system will be put to
>>  		sleep on the next suspend.  There are four methods supported:
>> +
>>  		'firmware' - means that the memory image will be saved to disk
>>  		by some firmware, in which case we also assume that the
>>  		firmware will handle the system suspend.
>> +
>>  		'platform' - the memory image will be saved by the kernel and
>>  		the system will be put to sleep by the platform driver (e.g.
>>  		ACPI or other PM registers).
>> +
>>  		'shutdown' - the memory image will be saved by the kernel and
>>  		the system will be powered off.
>> +
>>  		'reboot' - the memory image will be saved by the kernel and
>>  		the system will be rebooted.
>>  
>> @@ -74,12 +78,12 @@ Description:
>>  		The suspend-to-disk method may be chosen by writing to this
>>  		file one of the accepted strings:
>>  
>> -		'firmware'
>> -		'platform'
>> -		'shutdown'
>> -		'reboot'
>> -		'testproc'
>> -		'test'
>> +		- 'firmware'
>> +		- 'platform'
>> +		- 'shutdown'
>> +		- 'reboot'
>> +		- 'testproc'
>> +		- 'test'
>>  
>>  		It will only change to 'firmware' or 'platform' if the system
>>  		supports that.
>> @@ -114,9 +118,9 @@ Description:
>>  		string representing a nonzero integer into it.
>>  
>>  		To use this debugging feature you should attempt to suspend
>> -		the machine, then reboot it and run
>> +		the machine, then reboot it and run::
>>  
>> -		dmesg -s 1000000 | grep 'hash matches'
>> +		  dmesg -s 1000000 | grep 'hash matches'
>>  
>>  		If you do not get any matches (or they appear to be false
>>  		positives), it is possible that the last PM event point
>> @@ -244,6 +248,7 @@ Description:
>>  		wakeup sources created with the help of /sys/power/wake_lock.
>>  		When a string is written to /sys/power/wake_unlock, it will be
>>  		assumed to represent the name of a wakeup source to deactivate.
>> +
>>  		If a wakeup source object of that name exists and is active at
>>  		the moment, it will be deactivated.
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-profiling b/Documentation/ABI/testing/sysfs-profiling
>> index 8a8e466eb2c0..e39dd3a0ceef 100644
>> --- a/Documentation/ABI/testing/sysfs-profiling
>> +++ b/Documentation/ABI/testing/sysfs-profiling
>> @@ -5,7 +5,7 @@ Description:
>>  		/sys/kernel/profiling is the runtime equivalent
>>  		of the boot-time profile= option.
>>  
>> -		You can get the same effect running:
>> +		You can get the same effect running::
>>  
>>  			echo 2 > /sys/kernel/profiling
>>  
>> diff --git a/Documentation/ABI/testing/sysfs-wusb_cbaf b/Documentation/ABI/testing/sysfs-wusb_cbaf
>> index a99c5f86a37a..2969d3694ec0 100644
>> --- a/Documentation/ABI/testing/sysfs-wusb_cbaf
>> +++ b/Documentation/ABI/testing/sysfs-wusb_cbaf
>> @@ -45,7 +45,8 @@ Description:
>>                  7. Device is unplugged.
>>  
>>                  References:
>> -                  [WUSB-AM] Association Models Supplement to the
>> +                  [WUSB-AM]
>> +			    Association Models Supplement to the
>>                              Certified Wireless Universal Serial Bus
>>                              Specification, version 1.0.
>>  
>> diff --git a/Documentation/ABI/testing/usb-charger-uevent b/Documentation/ABI/testing/usb-charger-uevent
>> index 419a92dd0d86..1db89b0cf80f 100644
>> --- a/Documentation/ABI/testing/usb-charger-uevent
>> +++ b/Documentation/ABI/testing/usb-charger-uevent
>> @@ -3,44 +3,52 @@ Date:		2020-01-14
>>  KernelVersion:	5.6
>>  Contact:	linux-usb@vger.kernel.org
>>  Description:	There are two USB charger states:
>> -		USB_CHARGER_ABSENT
>> -		USB_CHARGER_PRESENT
>> +
>> +		- USB_CHARGER_ABSENT
>> +		- USB_CHARGER_PRESENT
>> +
>>  		There are five USB charger types:
>> -		USB_CHARGER_UNKNOWN_TYPE: Charger type is unknown
>> -		USB_CHARGER_SDP_TYPE: Standard Downstream Port
>> -		USB_CHARGER_CDP_TYPE: Charging Downstream Port
>> -		USB_CHARGER_DCP_TYPE: Dedicated Charging Port
>> -		USB_CHARGER_ACA_TYPE: Accessory Charging Adapter
>> +
>> +		========================  ==========================
>> +		USB_CHARGER_UNKNOWN_TYPE  Charger type is unknown
>> +		USB_CHARGER_SDP_TYPE      Standard Downstream Port
>> +		USB_CHARGER_CDP_TYPE      Charging Downstream Port
>> +		USB_CHARGER_DCP_TYPE      Dedicated Charging Port
>> +		USB_CHARGER_ACA_TYPE      Accessory Charging Adapter
>> +		========================  ==========================
>> +
>>  		https://www.usb.org/document-library/battery-charging-v12-spec-and-adopters-agreement
>>  
>> -		Here are two examples taken using udevadm monitor -p when
>> -		USB charger is online:
>> -		UDEV  change   /devices/soc0/usbphynop1 (platform)
>> -		ACTION=change
>> -		DEVPATH=/devices/soc0/usbphynop1
>> -		DRIVER=usb_phy_generic
>> -		MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
>> -		OF_COMPATIBLE_0=usb-nop-xceiv
>> -		OF_COMPATIBLE_N=1
>> -		OF_FULLNAME=/usbphynop1
>> -		OF_NAME=usbphynop1
>> -		SEQNUM=2493
>> -		SUBSYSTEM=platform
>> -		USB_CHARGER_STATE=USB_CHARGER_PRESENT
>> -		USB_CHARGER_TYPE=USB_CHARGER_SDP_TYPE
>> -		USEC_INITIALIZED=227422826
>> +		Here are two examples taken using ``udevadm monitor -p`` when
>> +		USB charger is online::
>>  
>> -		USB charger is offline:
>> -		KERNEL change   /devices/soc0/usbphynop1 (platform)
>> -		ACTION=change
>> -		DEVPATH=/devices/soc0/usbphynop1
>> -		DRIVER=usb_phy_generic
>> -		MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
>> -		OF_COMPATIBLE_0=usb-nop-xceiv
>> -		OF_COMPATIBLE_N=1
>> -		OF_FULLNAME=/usbphynop1
>> -		OF_NAME=usbphynop1
>> -		SEQNUM=2494
>> -		SUBSYSTEM=platform
>> -		USB_CHARGER_STATE=USB_CHARGER_ABSENT
>> -		USB_CHARGER_TYPE=USB_CHARGER_UNKNOWN_TYPE
>> +		    UDEV  change   /devices/soc0/usbphynop1 (platform)
>> +		    ACTION=change
>> +		    DEVPATH=/devices/soc0/usbphynop1
>> +		    DRIVER=usb_phy_generic
>> +		    MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
>> +		    OF_COMPATIBLE_0=usb-nop-xceiv
>> +		    OF_COMPATIBLE_N=1
>> +		    OF_FULLNAME=/usbphynop1
>> +		    OF_NAME=usbphynop1
>> +		    SEQNUM=2493
>> +		    SUBSYSTEM=platform
>> +		    USB_CHARGER_STATE=USB_CHARGER_PRESENT
>> +		    USB_CHARGER_TYPE=USB_CHARGER_SDP_TYPE
>> +		    USEC_INITIALIZED=227422826
>> +
>> +		USB charger is offline::
>> +
>> +		    KERNEL change   /devices/soc0/usbphynop1 (platform)
>> +		    ACTION=change
>> +		    DEVPATH=/devices/soc0/usbphynop1
>> +		    DRIVER=usb_phy_generic
>> +		    MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
>> +		    OF_COMPATIBLE_0=usb-nop-xceiv
>> +		    OF_COMPATIBLE_N=1
>> +		    OF_FULLNAME=/usbphynop1
>> +		    OF_NAME=usbphynop1
>> +		    SEQNUM=2494
>> +		    SUBSYSTEM=platform
>> +		    USB_CHARGER_STATE=USB_CHARGER_ABSENT
>> +		    USB_CHARGER_TYPE=USB_CHARGER_UNKNOWN_TYPE
>> diff --git a/Documentation/ABI/testing/usb-uevent b/Documentation/ABI/testing/usb-uevent
>> index d35c3cad892c..2b8eca4bf2b1 100644
>> --- a/Documentation/ABI/testing/usb-uevent
>> +++ b/Documentation/ABI/testing/usb-uevent
>> @@ -6,22 +6,22 @@ Description:	When the USB Host Controller has entered a state where it is no
>>  		longer functional a uevent will be raised. The uevent will
>>  		contain ACTION=offline and ERROR=DEAD.
>>  
>> -		Here is an example taken using udevadm monitor -p:
>> +		Here is an example taken using udevadm monitor -p::
>>  
>> -		KERNEL[130.428945] offline  /devices/pci0000:00/0000:00:10.0/usb2 (usb)
>> -		ACTION=offline
>> -		BUSNUM=002
>> -		DEVNAME=/dev/bus/usb/002/001
>> -		DEVNUM=001
>> -		DEVPATH=/devices/pci0000:00/0000:00:10.0/usb2
>> -		DEVTYPE=usb_device
>> -		DRIVER=usb
>> -		ERROR=DEAD
>> -		MAJOR=189
>> -		MINOR=128
>> -		PRODUCT=1d6b/2/414
>> -		SEQNUM=2168
>> -		SUBSYSTEM=usb
>> -		TYPE=9/0/1
>> +		    KERNEL[130.428945] offline  /devices/pci0000:00/0000:00:10.0/usb2 (usb)
>> +		    ACTION=offline
>> +		    BUSNUM=002
>> +		    DEVNAME=/dev/bus/usb/002/001
>> +		    DEVNUM=001
>> +		    DEVPATH=/devices/pci0000:00/0000:00:10.0/usb2
>> +		    DEVTYPE=usb_device
>> +		    DRIVER=usb
>> +		    ERROR=DEAD
>> +		    MAJOR=189
>> +		    MINOR=128
>> +		    PRODUCT=1d6b/2/414
>> +		    SEQNUM=2168
>> +		    SUBSYSTEM=usb
>> +		    TYPE=9/0/1
>>  
>>  Users:		chromium-os-dev@chromium.org
>> diff --git a/scripts/get_abi.pl b/scripts/get_abi.pl
>> index 413349789145..bdef3e5c35c7 100755
>> --- a/scripts/get_abi.pl
>> +++ b/scripts/get_abi.pl
>> @@ -316,8 +316,6 @@ sub output_rest {
>>  				$len = length($name) if (length($name) > $len);
>>  			}
>>  
>> -			print "What:\n\n";
>> -
>>  			print "+-" . "-" x $len . "-+\n";
>>  			foreach my $name (@names) {
>>  				printf "| %s", $name . " " x ($len - length($name)) . " |\n";
>
Oded Gabbay Oct. 29, 2020, 4:14 p.m. UTC | #3
On Thu, Oct 29, 2020 at 5:30 PM kajoljain <kjain@linux.ibm.com> wrote:
>
>
>
> On 10/29/20 8:12 PM, Jonathan Cameron wrote:
> > On Wed, 28 Oct 2020 15:23:28 +0100
> > Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> >
> >> There are some ABI documents that, while they don't generate
> >> any warnings, they have issues when parsed by get_abi.pl script
> >> on its output result.
> >>
> >> Address them, in order to provide a clean output.
> >>
> >> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
> >
> > All the IIO ones look sensible.  Thanks
> >
> > Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for IIO
>
> Those nit changes for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7 looks fine to me.
>
> Reviewed-By: Kajol Jain<kjain@linux.ibm.com>
>
> Thanks,
> Kajol Jain

Habanalabs changes looks fine
Acked-by: Oded Gabbay <oded.gabbay@gmail.com>

>
> >
> >> ---
> >>  Documentation/ABI/obsolete/sysfs-class-dax    |   8 +-
> >>  .../ABI/obsolete/sysfs-driver-hid-roccat-pyra |   3 +
> >>  Documentation/ABI/removed/devfs               |   1 +
> >>  Documentation/ABI/removed/raw1394             |   1 +
> >>  Documentation/ABI/removed/sysfs-class-rfkill  |   2 +-
> >>  Documentation/ABI/removed/video1394           |   1 +
> >>  Documentation/ABI/stable/firewire-cdev        |  63 ++---
> >>  Documentation/ABI/stable/sysfs-acpi-pmprofile |   4 +-
> >>  Documentation/ABI/stable/sysfs-bus-w1         |   1 +
> >>  Documentation/ABI/stable/sysfs-class-tpm      |   4 +-
> >>  Documentation/ABI/stable/sysfs-driver-speakup |   4 +
> >>  Documentation/ABI/testing/configfs-most       | 135 +++++++----
> >>  .../ABI/testing/configfs-usb-gadget-ecm       |  12 +-
> >>  .../ABI/testing/configfs-usb-gadget-eem       |  10 +-
> >>  .../ABI/testing/configfs-usb-gadget-loopback  |   6 +-
> >>  .../testing/configfs-usb-gadget-mass-storage  |  18 +-
> >>  .../ABI/testing/configfs-usb-gadget-midi      |  14 +-
> >>  .../ABI/testing/configfs-usb-gadget-printer   |   6 +-
> >>  .../testing/configfs-usb-gadget-sourcesink    |  18 +-
> >>  .../ABI/testing/configfs-usb-gadget-subset    |  10 +-
> >>  .../ABI/testing/configfs-usb-gadget-uac2      |  14 +-
> >>  .../ABI/testing/configfs-usb-gadget-uvc       |   2 +-
> >>  .../ABI/testing/debugfs-cec-error-inj         |   2 +-
> >>  .../ABI/testing/debugfs-driver-habanalabs     |  12 +-
> >>  .../ABI/testing/debugfs-pfo-nx-crypto         |  28 +--
> >>  Documentation/ABI/testing/debugfs-pktcdvd     |   2 +-
> >>  .../ABI/testing/debugfs-turris-mox-rwtm       |  10 +-
> >>  Documentation/ABI/testing/debugfs-wilco-ec    |  21 +-
> >>  Documentation/ABI/testing/dell-smbios-wmi     |  32 +--
> >>  Documentation/ABI/testing/gpio-cdev           |  13 +-
> >>  Documentation/ABI/testing/procfs-diskstats    |   6 +-
> >>  Documentation/ABI/testing/procfs-smaps_rollup |  48 ++--
> >>  Documentation/ABI/testing/pstore              |  19 +-
> >>  Documentation/ABI/testing/sysfs-block-rnbd    |   4 +-
> >>  Documentation/ABI/testing/sysfs-bus-acpi      |   1 +
> >>  .../testing/sysfs-bus-coresight-devices-etb10 |   5 +-
> >>  Documentation/ABI/testing/sysfs-bus-css       |   3 +
> >>  Documentation/ABI/testing/sysfs-bus-dfl       |   2 +
> >>  .../sysfs-bus-event_source-devices-hv_24x7    |   6 +-
> >>  .../sysfs-bus-event_source-devices-hv_gpci    |   7 +-
> >>  Documentation/ABI/testing/sysfs-bus-fcoe      |  68 ++++--
> >>  Documentation/ABI/testing/sysfs-bus-fsl-mc    |  12 +-
> >>  .../ABI/testing/sysfs-bus-i2c-devices-fsa9480 |  26 +-
> >>  Documentation/ABI/testing/sysfs-bus-i3c       |   2 +
> >>  Documentation/ABI/testing/sysfs-bus-iio       |  19 +-
> >>  .../ABI/testing/sysfs-bus-iio-adc-hi8435      |   5 +
> >>  .../ABI/testing/sysfs-bus-iio-adc-stm32       |   3 +
> >>  .../ABI/testing/sysfs-bus-iio-distance-srf08  |   7 +-
> >>  .../testing/sysfs-bus-iio-frequency-ad9523    |   2 +
> >>  .../testing/sysfs-bus-iio-frequency-adf4371   |  10 +-
> >>  .../ABI/testing/sysfs-bus-iio-health-afe440x  |  12 +-
> >>  .../ABI/testing/sysfs-bus-iio-light-isl29018  |   6 +-
> >>  .../testing/sysfs-bus-intel_th-devices-gth    |  11 +-
> >>  Documentation/ABI/testing/sysfs-bus-papr-pmem |  23 +-
> >>  Documentation/ABI/testing/sysfs-bus-pci       |  22 +-
> >>  .../ABI/testing/sysfs-bus-pci-devices-catpt   |   1 +
> >>  .../testing/sysfs-bus-pci-drivers-ehci_hcd    |   4 +-
> >>  Documentation/ABI/testing/sysfs-bus-rbd       |  37 ++-
> >>  Documentation/ABI/testing/sysfs-bus-siox      |   3 +
> >>  .../ABI/testing/sysfs-bus-thunderbolt         |  18 +-
> >>  Documentation/ABI/testing/sysfs-bus-usb       |   2 +
> >>  .../sysfs-class-backlight-driver-lm3533       |  26 +-
> >>  Documentation/ABI/testing/sysfs-class-bdi     |   1 -
> >>  .../ABI/testing/sysfs-class-chromeos          |  15 +-
> >>  Documentation/ABI/testing/sysfs-class-cxl     |   8 +-
> >>  Documentation/ABI/testing/sysfs-class-devlink |  30 ++-
> >>  Documentation/ABI/testing/sysfs-class-extcon  |  34 +--
> >>  .../ABI/testing/sysfs-class-fpga-manager      |   5 +-
> >>  Documentation/ABI/testing/sysfs-class-gnss    |   2 +
> >>  Documentation/ABI/testing/sysfs-class-led     |   1 +
> >>  .../testing/sysfs-class-led-driver-el15203000 |  30 +--
> >>  .../ABI/testing/sysfs-class-led-driver-lm3533 |  44 ++--
> >>  .../ABI/testing/sysfs-class-led-flash         |  27 ++-
> >>  .../testing/sysfs-class-led-trigger-netdev    |   7 +
> >>  .../testing/sysfs-class-led-trigger-usbport   |   1 +
> >>  .../ABI/testing/sysfs-class-leds-gt683r       |   8 +-
> >>  Documentation/ABI/testing/sysfs-class-net     |  61 +++--
> >>  .../ABI/testing/sysfs-class-net-cdc_ncm       |   6 +-
> >>  .../ABI/testing/sysfs-class-net-phydev        |   2 +
> >>  Documentation/ABI/testing/sysfs-class-pktcdvd |  36 +--
> >>  Documentation/ABI/testing/sysfs-class-power   |  12 +-
> >>  .../ABI/testing/sysfs-class-power-mp2629      |   1 +
> >>  .../ABI/testing/sysfs-class-power-twl4030     |   4 +-
> >>  Documentation/ABI/testing/sysfs-class-rapidio |  46 ++--
> >>  .../ABI/testing/sysfs-class-regulator         |  36 +--
> >>  .../ABI/testing/sysfs-class-remoteproc        |  14 +-
> >>  ...ysfs-class-rtc-rtc0-device-rtc_calibration |   1 +
> >>  Documentation/ABI/testing/sysfs-class-uwb_rc  |  13 +-
> >>  .../ABI/testing/sysfs-class-watchdog          |   7 +-
> >>  Documentation/ABI/testing/sysfs-dev           |   7 +-
> >>  .../ABI/testing/sysfs-devices-mapping         |  41 ++--
> >>  .../ABI/testing/sysfs-devices-memory          |  15 +-
> >>  .../sysfs-devices-platform-_UDC_-gadget       |  10 +-
> >>  .../ABI/testing/sysfs-devices-platform-ipmi   |  52 ++--
> >>  .../ABI/testing/sysfs-devices-system-cpu      |   4 +-
> >>  .../ABI/testing/sysfs-driver-hid-lenovo       |  10 +
> >>  .../ABI/testing/sysfs-driver-hid-ntrig        |  13 +-
> >>  .../ABI/testing/sysfs-driver-hid-roccat-kone  |  19 ++
> >>  .../ABI/testing/sysfs-driver-hid-wiimote      |   1 +
> >>  .../ABI/testing/sysfs-driver-input-exc3000    |   2 +
> >>  .../ABI/testing/sysfs-driver-jz4780-efuse     |   6 +-
> >>  .../ABI/testing/sysfs-driver-pciback          |   6 +-
> >>  Documentation/ABI/testing/sysfs-driver-ufs    | 228 ++++++++++++++----
> >>  .../ABI/testing/sysfs-driver-w1_ds28e17       |   3 +
> >>  Documentation/ABI/testing/sysfs-firmware-acpi |  16 +-
> >>  .../ABI/testing/sysfs-firmware-efi-esrt       |  28 ++-
> >>  .../testing/sysfs-firmware-efi-runtime-map    |  14 +-
> >>  .../ABI/testing/sysfs-firmware-qemu_fw_cfg    |  20 +-
> >>  Documentation/ABI/testing/sysfs-firmware-sfi  |   6 +-
> >>  .../ABI/testing/sysfs-firmware-sgi_uv         |   6 +-
> >>  Documentation/ABI/testing/sysfs-fs-f2fs       |  48 ++--
> >>  Documentation/ABI/testing/sysfs-kernel-mm-ksm |   5 +-
> >>  Documentation/ABI/testing/sysfs-kernel-slab   |   3 +
> >>  Documentation/ABI/testing/sysfs-module        |  17 +-
> >>  .../ABI/testing/sysfs-platform-dell-laptop    |  10 +-
> >>  .../ABI/testing/sysfs-platform-dell-smbios    |   4 +-
> >>  .../testing/sysfs-platform-i2c-demux-pinctrl  |   4 +-
> >>  Documentation/ABI/testing/sysfs-platform-kim  |   1 +
> >>  .../testing/sysfs-platform-phy-rcar-gen3-usb2 |  10 +-
> >>  .../ABI/testing/sysfs-platform-renesas_usb3   |  10 +-
> >>  Documentation/ABI/testing/sysfs-power         |  21 +-
> >>  Documentation/ABI/testing/sysfs-profiling     |   2 +-
> >>  Documentation/ABI/testing/sysfs-wusb_cbaf     |   3 +-
> >>  Documentation/ABI/testing/usb-charger-uevent  |  82 ++++---
> >>  Documentation/ABI/testing/usb-uevent          |  32 +--
> >>  scripts/get_abi.pl                            |   2 -
> >>  126 files changed, 1323 insertions(+), 767 deletions(-)
> >>
> >> diff --git a/Documentation/ABI/obsolete/sysfs-class-dax b/Documentation/ABI/obsolete/sysfs-class-dax
> >> index 2cb9fc5e8bd1..0faf1354cd05 100644
> >> --- a/Documentation/ABI/obsolete/sysfs-class-dax
> >> +++ b/Documentation/ABI/obsolete/sysfs-class-dax
> >> @@ -8,11 +8,11 @@ Description:       Device DAX is the device-centric analogue of Filesystem
> >>              system.  Device DAX is strict, precise and predictable.
> >>              Specifically this interface:
> >>
> >> -            1/ Guarantees fault granularity with respect to a given
> >> -            page size (pte, pmd, or pud) set at configuration time.
> >> +            1. Guarantees fault granularity with respect to a given
> >> +               page size (pte, pmd, or pud) set at configuration time.
> >>
> >> -            2/ Enforces deterministic behavior by being strict about
> >> -            what fault scenarios are supported.
> >> +            2. Enforces deterministic behavior by being strict about
> >> +               what fault scenarios are supported.
> >>
> >>              The /sys/class/dax/ interface enumerates all the
> >>              device-dax instances in the system. The ABI is
> >> diff --git a/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra b/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
> >> index 5d41ebadf15e..66545c587a64 100644
> >> --- a/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
> >> +++ b/Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
> >> @@ -7,10 +7,13 @@ Description:       It is possible to switch the cpi setting of the mouse with the
> >>              setting reported by the mouse. This number has to be further
> >>              processed to receive the real dpi value:
> >>
> >> +            ===== ====
> >>              VALUE DPI
> >> +            ===== ====
> >>              1     400
> >>              2     800
> >>              4     1600
> >> +            ===== ====
> >>
> >>              This file is readonly.
> >>              Has never been used. If bookkeeping is done, it's done in userland tools.
> >> diff --git a/Documentation/ABI/removed/devfs b/Documentation/ABI/removed/devfs
> >> index 0020c49933c4..24fb35adf277 100644
> >> --- a/Documentation/ABI/removed/devfs
> >> +++ b/Documentation/ABI/removed/devfs
> >> @@ -5,6 +5,7 @@ Description:
> >>      devfs has been unmaintained for a number of years, has unfixable
> >>      races, contains a naming policy within the kernel that is
> >>      against the LSB, and can be replaced by using udev.
> >> +
> >>      The files fs/devfs/*, include/linux/devfs_fs*.h were removed,
> >>      along with the assorted devfs function calls throughout the
> >>      kernel tree.
> >> diff --git a/Documentation/ABI/removed/raw1394 b/Documentation/ABI/removed/raw1394
> >> index ec333e676322..9ec7ec493920 100644
> >> --- a/Documentation/ABI/removed/raw1394
> >> +++ b/Documentation/ABI/removed/raw1394
> >> @@ -7,6 +7,7 @@ Description:
> >>      to implement sensible device security policies, and its low level
> >>      of abstraction that required userspace clients to duplicate much
> >>      of the kernel's ieee1394 core functionality.
> >> +
> >>      Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of
> >>      firewire-core.
> >>
> >> diff --git a/Documentation/ABI/removed/sysfs-class-rfkill b/Documentation/ABI/removed/sysfs-class-rfkill
> >> index 9c08c7f98ffb..f25174eafd55 100644
> >> --- a/Documentation/ABI/removed/sysfs-class-rfkill
> >> +++ b/Documentation/ABI/removed/sysfs-class-rfkill
> >> @@ -10,4 +10,4 @@ Description:       This file was deprecated because there no longer was a way to
> >>              claim just control over a single rfkill instance.
> >>              This file was scheduled to be removed in 2012, and was removed
> >>              in 2016.
> >> -Values:     0: Kernel handles events
> >> +Values:             0: Kernel handles events
> >> diff --git a/Documentation/ABI/removed/video1394 b/Documentation/ABI/removed/video1394
> >> index c39c25aee77b..1905d35a6619 100644
> >> --- a/Documentation/ABI/removed/video1394
> >> +++ b/Documentation/ABI/removed/video1394
> >> @@ -8,6 +8,7 @@ Description:
> >>      performance issues in its first generation.  Any video1394 user had
> >>      to use raw1394 + libraw1394 too because video1394 did not provide
> >>      asynchronous I/O for device discovery and configuration.
> >> +
> >>      Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of
> >>      firewire-core.
> >>
> >> diff --git a/Documentation/ABI/stable/firewire-cdev b/Documentation/ABI/stable/firewire-cdev
> >> index c9e8ff026154..261f85b13154 100644
> >> --- a/Documentation/ABI/stable/firewire-cdev
> >> +++ b/Documentation/ABI/stable/firewire-cdev
> >> @@ -16,6 +16,7 @@ Description:
> >>              different scope:
> >>
> >>                - The 1394 node which is associated with the file:
> >> +
> >>                        - Asynchronous request transmission
> >>                        - Get the Configuration ROM
> >>                        - Query node ID
> >> @@ -23,6 +24,7 @@ Description:
> >>                          and local node
> >>
> >>                - The 1394 bus (i.e. "card") to which the node is attached to:
> >> +
> >>                        - Isochronous stream transmission and reception
> >>                        - Asynchronous stream transmission and reception
> >>                        - Asynchronous broadcast request transmission
> >> @@ -35,6 +37,7 @@ Description:
> >>                        - Bus reset initiation, bus reset event reception
> >>
> >>                - All 1394 buses:
> >> +
> >>                        - Allocation of IEEE 1212 address ranges on the local
> >>                          link layers, reception of inbound requests to such
> >>                          an address range, asynchronous response transmission
> >> @@ -59,50 +62,50 @@ Description:
> >>              The following file operations are supported:
> >>
> >>              open(2)
> >> -            Currently the only useful flags are O_RDWR.
> >> +                Currently the only useful flags are O_RDWR.
> >>
> >>              ioctl(2)
> >> -            Initiate various actions.  Some take immediate effect, others
> >> -            are performed asynchronously while or after the ioctl returns.
> >> -            See the inline documentation in <linux/firewire-cdev.h> for
> >> -            descriptions of all ioctls.
> >> +                Initiate various actions.  Some take immediate effect, others
> >> +                are performed asynchronously while or after the ioctl returns.
> >> +                See the inline documentation in <linux/firewire-cdev.h> for
> >> +                descriptions of all ioctls.
> >>
> >>              poll(2), select(2), epoll_wait(2) etc.
> >> -            Watch for events to become available to be read.
> >> +                Watch for events to become available to be read.
> >>
> >>              read(2)
> >> -            Receive various events.  There are solicited events like
> >> -            outbound asynchronous transaction completion or isochronous
> >> -            buffer completion, and unsolicited events such as bus resets,
> >> -            request reception, or PHY packet reception.  Always use a read
> >> -            buffer which is large enough to receive the largest event that
> >> -            could ever arrive.  See <linux/firewire-cdev.h> for descriptions
> >> -            of all event types and for which ioctls affect reception of
> >> -            events.
> >> +                Receive various events.  There are solicited events like
> >> +                outbound asynchronous transaction completion or isochronous
> >> +                buffer completion, and unsolicited events such as bus resets,
> >> +                request reception, or PHY packet reception.  Always use a read
> >> +                buffer which is large enough to receive the largest event that
> >> +                could ever arrive.  See <linux/firewire-cdev.h> for descriptions
> >> +                of all event types and for which ioctls affect reception of
> >> +                events.
> >>
> >>              mmap(2)
> >> -            Allocate a DMA buffer for isochronous reception or transmission
> >> -            and map it into the process address space.  The arguments should
> >> -            be used as follows:  addr = NULL, length = the desired buffer
> >> -            size, i.e. number of packets times size of largest packet,
> >> -            prot = at least PROT_READ for reception and at least PROT_WRITE
> >> -            for transmission, flags = MAP_SHARED, fd = the handle to the
> >> -            /dev/fw*, offset = 0.
> >> +                Allocate a DMA buffer for isochronous reception or transmission
> >> +                and map it into the process address space.  The arguments should
> >> +                be used as follows:  addr = NULL, length = the desired buffer
> >> +                size, i.e. number of packets times size of largest packet,
> >> +                prot = at least PROT_READ for reception and at least PROT_WRITE
> >> +                for transmission, flags = MAP_SHARED, fd = the handle to the
> >> +                /dev/fw*, offset = 0.
> >>
> >>              Isochronous reception works in packet-per-buffer fashion except
> >>              for multichannel reception which works in buffer-fill mode.
> >>
> >>              munmap(2)
> >> -            Unmap the isochronous I/O buffer from the process address space.
> >> +                Unmap the isochronous I/O buffer from the process address space.
> >>
> >>              close(2)
> >> -            Besides stopping and freeing I/O contexts that were associated
> >> -            with the file descriptor, back out any changes to the local
> >> -            nodes' Configuration ROM.  Deallocate isochronous channels and
> >> -            bandwidth at the IRM that were marked for kernel-assisted
> >> -            re- and deallocation.
> >> +                Besides stopping and freeing I/O contexts that were associated
> >> +                with the file descriptor, back out any changes to the local
> >> +                nodes' Configuration ROM.  Deallocate isochronous channels and
> >> +                bandwidth at the IRM that were marked for kernel-assisted
> >> +                re- and deallocation.
> >>
> >> -Users:              libraw1394
> >> -            libdc1394
> >> -            libhinawa
> >> +Users:              libraw1394;
> >> +            libdc1394;
> >> +            libhinawa;
> >>              tools like linux-firewire-utils, fwhack, ...
> >> diff --git a/Documentation/ABI/stable/sysfs-acpi-pmprofile b/Documentation/ABI/stable/sysfs-acpi-pmprofile
> >> index fd97d22b677f..2d6314f0e4e4 100644
> >> --- a/Documentation/ABI/stable/sysfs-acpi-pmprofile
> >> +++ b/Documentation/ABI/stable/sysfs-acpi-pmprofile
> >> @@ -1,8 +1,8 @@
> >> -What:               /sys/firmware/acpi/pm_profile
> >> +What:               /sys/firmware/acpi/pm_profile
> >>  Date:               03-Nov-2011
> >>  KernelVersion:      v3.2
> >>  Contact:    linux-acpi@vger.kernel.org
> >> -Description:        The ACPI pm_profile sysfs interface exports the platform
> >> +Description:        The ACPI pm_profile sysfs interface exports the platform
> >>              power management (and performance) requirement expectations
> >>              as provided by BIOS. The integer value is directly passed as
> >>              retrieved from the FADT ACPI table.
> >> diff --git a/Documentation/ABI/stable/sysfs-bus-w1 b/Documentation/ABI/stable/sysfs-bus-w1
> >> index 992dfb183ed0..5cd5e872bcae 100644
> >> --- a/Documentation/ABI/stable/sysfs-bus-w1
> >> +++ b/Documentation/ABI/stable/sysfs-bus-w1
> >> @@ -6,6 +6,7 @@ Description: Bus scanning interval, microseconds component.
> >>              control systems are attached/generate presence for as short as
> >>              100 ms - hence the tens-to-hundreds milliseconds scan intervals
> >>              are required.
> >> +
> >>              see Documentation/w1/w1-generic.rst for detailed information.
> >>  Users:              any user space application which wants to know bus scanning
> >>              interval
> >> diff --git a/Documentation/ABI/stable/sysfs-class-tpm b/Documentation/ABI/stable/sysfs-class-tpm
> >> index ec464cf7861a..91ca63ec7581 100644
> >> --- a/Documentation/ABI/stable/sysfs-class-tpm
> >> +++ b/Documentation/ABI/stable/sysfs-class-tpm
> >> @@ -191,6 +191,6 @@ Contact: linux-integrity@vger.kernel.org
> >>  Description:        The "tpm_version_major" property shows the TCG spec major version
> >>              implemented by the TPM device.
> >>
> >> -            Example output:
> >> +            Example output::
> >>
> >> -            2
> >> +              2
> >> diff --git a/Documentation/ABI/stable/sysfs-driver-speakup b/Documentation/ABI/stable/sysfs-driver-speakup
> >> index c6a32c434ce9..792f58ba327d 100644
> >> --- a/Documentation/ABI/stable/sysfs-driver-speakup
> >> +++ b/Documentation/ABI/stable/sysfs-driver-speakup
> >> @@ -69,6 +69,7 @@ Description:       Controls if typing interrupts output from speakup. With
> >>              speakup if for example
> >>              the say screen command is used before the
> >>              entire screen  is read.
> >> +
> >>              With no_interrupt set to one, if the say
> >>              screen command is used, and one then types on the keyboard,
> >>              speakup will continue to say the whole screen regardless until
> >> @@ -215,8 +216,10 @@ Description:    This file contains names for key states.
> >>              Again, these are part of the help system.  For instance, if you
> >>              had pressed speakup + keypad 3, you would hear:
> >>              "speakup keypad 3 is go to bottom edge."
> >> +
> >>              The speakup key is depressed, so the name of the key state is
> >>              speakup.
> >> +
> >>              This part of the message comes from the states collection.
> >>
> >>  What:               /sys/accessibility/speakup/i18n/characters
> >> @@ -297,6 +300,7 @@ KernelVersion:   2.6
> >>  Contact:    speakup@linux-speakup.org
> >>  Description:        Controls if punctuation is spoken by speakup, or by the
> >>              synthesizer.
> >> +
> >>              For example, speakup speaks ">" as "greater", while
> >>              the espeak synthesizer used by the soft driver speaks "greater
> >>              than". Zero lets speakup speak the punctuation. One lets the
> >> diff --git a/Documentation/ABI/testing/configfs-most b/Documentation/ABI/testing/configfs-most
> >> index ed67a4d9f6d6..bc6b8bd18da4 100644
> >> --- a/Documentation/ABI/testing/configfs-most
> >> +++ b/Documentation/ABI/testing/configfs-most
> >> @@ -15,22 +15,28 @@ KernelVersion:  5.2
> >>  Description:
> >>              The attributes:
> >>
> >> -            buffer_size     configure the buffer size for this channel
> >> +            buffer_size
> >> +                            configure the buffer size for this channel
> >>
> >> -            subbuffer_size  configure the sub-buffer size for this channel
> >> +            subbuffer_size
> >> +                            configure the sub-buffer size for this channel
> >>                              (needed for synchronous and isochrnous data)
> >>
> >>
> >> -            num_buffers     configure number of buffers used for this
> >> +            num_buffers
> >> +                            configure number of buffers used for this
> >>                              channel
> >>
> >> -            datatype        configure type of data that will travel over
> >> +            datatype
> >> +                            configure type of data that will travel over
> >>                              this channel
> >>
> >> -            direction       configure whether this link will be an input
> >> +            direction
> >> +                            configure whether this link will be an input
> >>                              or output
> >>
> >> -            dbr_size        configure DBR data buffer size (this is used
> >> +            dbr_size
> >> +                            configure DBR data buffer size (this is used
> >>                              for MediaLB communication only)
> >>
> >>              packets_per_xact
> >> @@ -39,18 +45,23 @@ Description:
> >>                              transmitted via USB (this is used for USB
> >>                              communication only)
> >>
> >> -            device          name of the device the link is to be attached to
> >> +            device
> >> +                            name of the device the link is to be attached to
> >>
> >> -            channel         name of the channel the link is to be attached to
> >> +            channel
> >> +                            name of the channel the link is to be attached to
> >>
> >> -            comp_params     pass parameters needed by some components
> >> +            comp_params
> >> +                            pass parameters needed by some components
> >>
> >> -            create_link     write '1' to this attribute to trigger the
> >> +            create_link
> >> +                            write '1' to this attribute to trigger the
> >>                              creation of the link. In case of speculative
> >>                              configuration, the creation is post-poned until
> >>                              a physical device is being attached to the bus.
> >>
> >> -            destroy_link    write '1' to this attribute to destroy an
> >> +            destroy_link
> >> +                            write '1' to this attribute to destroy an
> >>                              active link
> >>
> >>  What:               /sys/kernel/config/most_video/<link>
> >> @@ -59,22 +70,28 @@ KernelVersion:  5.2
> >>  Description:
> >>              The attributes:
> >>
> >> -            buffer_size     configure the buffer size for this channel
> >> +            buffer_size
> >> +                            configure the buffer size for this channel
> >>
> >> -            subbuffer_size  configure the sub-buffer size for this channel
> >> +            subbuffer_size
> >> +                            configure the sub-buffer size for this channel
> >>                              (needed for synchronous and isochrnous data)
> >>
> >>
> >> -            num_buffers     configure number of buffers used for this
> >> +            num_buffers
> >> +                            configure number of buffers used for this
> >>                              channel
> >>
> >> -            datatype        configure type of data that will travel over
> >> +            datatype
> >> +                            configure type of data that will travel over
> >>                              this channel
> >>
> >> -            direction       configure whether this link will be an input
> >> +            direction
> >> +                            configure whether this link will be an input
> >>                              or output
> >>
> >> -            dbr_size        configure DBR data buffer size (this is used
> >> +            dbr_size
> >> +                            configure DBR data buffer size (this is used
> >>                              for MediaLB communication only)
> >>
> >>              packets_per_xact
> >> @@ -83,18 +100,23 @@ Description:
> >>                              transmitted via USB (this is used for USB
> >>                              communication only)
> >>
> >> -            device          name of the device the link is to be attached to
> >> +            device
> >> +                            name of the device the link is to be attached to
> >>
> >> -            channel         name of the channel the link is to be attached to
> >> +            channel
> >> +                            name of the channel the link is to be attached to
> >>
> >> -            comp_params     pass parameters needed by some components
> >> +            comp_params
> >> +                            pass parameters needed by some components
> >>
> >> -            create_link     write '1' to this attribute to trigger the
> >> +            create_link
> >> +                            write '1' to this attribute to trigger the
> >>                              creation of the link. In case of speculative
> >>                              configuration, the creation is post-poned until
> >>                              a physical device is being attached to the bus.
> >>
> >> -            destroy_link    write '1' to this attribute to destroy an
> >> +            destroy_link
> >> +                            write '1' to this attribute to destroy an
> >>                              active link
> >>
> >>  What:               /sys/kernel/config/most_net/<link>
> >> @@ -103,22 +125,28 @@ KernelVersion:  5.2
> >>  Description:
> >>              The attributes:
> >>
> >> -            buffer_size     configure the buffer size for this channel
> >> +            buffer_size
> >> +                            configure the buffer size for this channel
> >>
> >> -            subbuffer_size  configure the sub-buffer size for this channel
> >> +            subbuffer_size
> >> +                            configure the sub-buffer size for this channel
> >>                              (needed for synchronous and isochrnous data)
> >>
> >>
> >> -            num_buffers     configure number of buffers used for this
> >> +            num_buffers
> >> +                            configure number of buffers used for this
> >>                              channel
> >>
> >> -            datatype        configure type of data that will travel over
> >> +            datatype
> >> +                            configure type of data that will travel over
> >>                              this channel
> >>
> >> -            direction       configure whether this link will be an input
> >> +            direction
> >> +                            configure whether this link will be an input
> >>                              or output
> >>
> >> -            dbr_size        configure DBR data buffer size (this is used
> >> +            dbr_size
> >> +                            configure DBR data buffer size (this is used
> >>                              for MediaLB communication only)
> >>
> >>              packets_per_xact
> >> @@ -127,18 +155,23 @@ Description:
> >>                              transmitted via USB (this is used for USB
> >>                              communication only)
> >>
> >> -            device          name of the device the link is to be attached to
> >> +            device
> >> +                            name of the device the link is to be attached to
> >>
> >> -            channel         name of the channel the link is to be attached to
> >> +            channel
> >> +                            name of the channel the link is to be attached to
> >>
> >> -            comp_params     pass parameters needed by some components
> >> +            comp_params
> >> +                            pass parameters needed by some components
> >>
> >> -            create_link     write '1' to this attribute to trigger the
> >> +            create_link
> >> +                            write '1' to this attribute to trigger the
> >>                              creation of the link. In case of speculative
> >>                              configuration, the creation is post-poned until
> >>                              a physical device is being attached to the bus.
> >>
> >> -            destroy_link    write '1' to this attribute to destroy an
> >> +            destroy_link
> >> +                            write '1' to this attribute to destroy an
> >>                              active link
> >>
> >>  What:               /sys/kernel/config/most_sound/<card>
> >> @@ -147,7 +180,8 @@ KernelVersion:  5.2
> >>  Description:
> >>              The attributes:
> >>
> >> -            create_card     write '1' to this attribute to trigger the
> >> +            create_card
> >> +                            write '1' to this attribute to trigger the
> >>                                  registration of the sound card with the ALSA
> >>                              subsystem.
> >>
> >> @@ -157,22 +191,28 @@ KernelVersion:  5.2
> >>  Description:
> >>              The attributes:
> >>
> >> -            buffer_size     configure the buffer size for this channel
> >> +            buffer_size
> >> +                            configure the buffer size for this channel
> >>
> >> -            subbuffer_size  configure the sub-buffer size for this channel
> >> +            subbuffer_size
> >> +                            configure the sub-buffer size for this channel
> >>                              (needed for synchronous and isochrnous data)
> >>
> >>
> >> -            num_buffers     configure number of buffers used for this
> >> +            num_buffers
> >> +                            configure number of buffers used for this
> >>                              channel
> >>
> >> -            datatype        configure type of data that will travel over
> >> +            datatype
> >> +                            configure type of data that will travel over
> >>                              this channel
> >>
> >> -            direction       configure whether this link will be an input
> >> +            direction
> >> +                            configure whether this link will be an input
> >>                              or output
> >>
> >> -            dbr_size        configure DBR data buffer size (this is used
> >> +            dbr_size
> >> +                            configure DBR data buffer size (this is used
> >>                              for MediaLB communication only)
> >>
> >>              packets_per_xact
> >> @@ -181,16 +221,21 @@ Description:
> >>                              transmitted via USB (this is used for USB
> >>                              communication only)
> >>
> >> -            device          name of the device the link is to be attached to
> >> +            device
> >> +                            name of the device the link is to be attached to
> >>
> >> -            channel         name of the channel the link is to be attached to
> >> +            channel
> >> +                            name of the channel the link is to be attached to
> >>
> >> -            comp_params     pass parameters needed by some components
> >> +            comp_params
> >> +                            pass parameters needed by some components
> >>
> >> -            create_link     write '1' to this attribute to trigger the
> >> +            create_link
> >> +                            write '1' to this attribute to trigger the
> >>                              creation of the link. In case of speculative
> >>                              configuration, the creation is post-poned until
> >>                              a physical device is being attached to the bus.
> >>
> >> -            destroy_link    write '1' to this attribute to destroy an
> >> +            destroy_link
> >> +                            write '1' to this attribute to destroy an
> >>                              active link
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-ecm b/Documentation/ABI/testing/configfs-usb-gadget-ecm
> >> index 0addf7704b4c..272bc1e4ce2e 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-ecm
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-ecm
> >> @@ -4,13 +4,17 @@ KernelVersion:     3.11
> >>  Description:
> >>              The attributes:
> >>
> >> -            ifname          - network device interface name associated with
> >> +            ifname
> >> +                          - network device interface name associated with
> >>                              this function instance
> >> -            qmult           - queue length multiplier for high and
> >> +            qmult
> >> +                          - queue length multiplier for high and
> >>                              super speed
> >> -            host_addr       - MAC address of host's end of this
> >> +            host_addr
> >> +                          - MAC address of host's end of this
> >>                              Ethernet over USB link
> >> -            dev_addr        - MAC address of device's end of this
> >> +            dev_addr
> >> +                          - MAC address of device's end of this
> >>                              Ethernet over USB link
> >>
> >>
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-eem b/Documentation/ABI/testing/configfs-usb-gadget-eem
> >> index a4c57158fcde..178c3d5fb647 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-eem
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-eem
> >> @@ -4,11 +4,13 @@ KernelVersion:     3.11
> >>  Description:
> >>              The attributes:
> >>
> >> -            ifname          - network device interface name associated with
> >> +            ==========      =============================================
> >> +            ifname          network device interface name associated with
> >>                              this function instance
> >> -            qmult           - queue length multiplier for high and
> >> +            qmult           queue length multiplier for high and
> >>                              super speed
> >> -            host_addr       - MAC address of host's end of this
> >> +            host_addr       MAC address of host's end of this
> >>                              Ethernet over USB link
> >> -            dev_addr        - MAC address of device's end of this
> >> +            dev_addr        MAC address of device's end of this
> >>                              Ethernet over USB link
> >> +            ==========      =============================================
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-loopback b/Documentation/ABI/testing/configfs-usb-gadget-loopback
> >> index 06beefbcf061..e6c6ba5ac7ff 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-loopback
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-loopback
> >> @@ -4,5 +4,7 @@ KernelVersion:       3.13
> >>  Description:
> >>              The attributes:
> >>
> >> -            qlen            - depth of loopback queue
> >> -            buflen          - buffer length
> >> +            =======         =======================
> >> +            qlen            depth of loopback queue
> >> +            buflen          buffer length
> >> +            =======         =======================
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-mass-storage b/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
> >> index 9931fb0d63ba..c86b63a7bb43 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-mass-storage
> >> @@ -4,12 +4,14 @@ KernelVersion:     3.13
> >>  Description:
> >>              The attributes:
> >>
> >> -            stall           - Set to permit function to halt bulk endpoints.
> >> +            ===========     ==============================================
> >> +            stall           Set to permit function to halt bulk endpoints.
> >>                              Disabled on some USB devices known not to work
> >>                              correctly. You should set it to true.
> >> -            num_buffers     - Number of pipeline buffers. Valid numbers
> >> +            num_buffers     Number of pipeline buffers. Valid numbers
> >>                              are 2..4. Available only if
> >>                              CONFIG_USB_GADGET_DEBUG_FILES is set.
> >> +            ===========     ==============================================
> >>
> >>  What:               /config/usb-gadget/gadget/functions/mass_storage.name/lun.name
> >>  Date:               Oct 2013
> >> @@ -17,15 +19,17 @@ KernelVersion:   3.13
> >>  Description:
> >>              The attributes:
> >>
> >> -            file            - The path to the backing file for the LUN.
> >> +            ===========     ==============================================
> >> +            file            The path to the backing file for the LUN.
> >>                              Required if LUN is not marked as removable.
> >> -            ro              - Flag specifying access to the LUN shall be
> >> +            ro              Flag specifying access to the LUN shall be
> >>                              read-only. This is implied if CD-ROM emulation
> >>                              is enabled as well as when it was impossible
> >>                              to open "filename" in R/W mode.
> >> -            removable       - Flag specifying that LUN shall be indicated as
> >> +            removable       Flag specifying that LUN shall be indicated as
> >>                              being removable.
> >> -            cdrom           - Flag specifying that LUN shall be reported as
> >> +            cdrom           Flag specifying that LUN shall be reported as
> >>                              being a CD-ROM.
> >> -            nofua           - Flag specifying that FUA flag
> >> +            nofua           Flag specifying that FUA flag
> >>                              in SCSI WRITE(10,12)
> >> +            ===========     ==============================================
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-midi b/Documentation/ABI/testing/configfs-usb-gadget-midi
> >> index 6b341df7249c..07389cddd51a 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-midi
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-midi
> >> @@ -4,9 +4,11 @@ KernelVersion:      3.19
> >>  Description:
> >>              The attributes:
> >>
> >> -            index           - index value for the USB MIDI adapter
> >> -            id              - ID string for the USB MIDI adapter
> >> -            buflen          - MIDI buffer length
> >> -            qlen            - USB read request queue length
> >> -            in_ports        - number of MIDI input ports
> >> -            out_ports       - number of MIDI output ports
> >> +            ==========      ====================================
> >> +            index           index value for the USB MIDI adapter
> >> +            id              ID string for the USB MIDI adapter
> >> +            buflen          MIDI buffer length
> >> +            qlen            USB read request queue length
> >> +            in_ports        number of MIDI input ports
> >> +            out_ports       number of MIDI output ports
> >> +            ==========      ====================================
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-printer b/Documentation/ABI/testing/configfs-usb-gadget-printer
> >> index 6b0714e3c605..7aa731bac2da 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-printer
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-printer
> >> @@ -4,6 +4,8 @@ KernelVersion:       4.1
> >>  Description:
> >>              The attributes:
> >>
> >> -            pnp_string      - Data to be passed to the host in pnp string
> >> -            q_len           - Number of requests per endpoint
> >> +            ==========      ===========================================
> >> +            pnp_string      Data to be passed to the host in pnp string
> >> +            q_len           Number of requests per endpoint
> >> +            ==========      ===========================================
> >>
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-sourcesink b/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
> >> index f56335af2d88..1f3d31b607b7 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-sourcesink
> >> @@ -4,11 +4,13 @@ KernelVersion:     3.13
> >>  Description:
> >>              The attributes:
> >>
> >> -            pattern         - 0 (all zeros), 1 (mod63), 2 (none)
> >> -            isoc_interval   - 1..16
> >> -            isoc_maxpacket  - 0 - 1023 (fs), 0 - 1024 (hs/ss)
> >> -            isoc_mult       - 0..2 (hs/ss only)
> >> -            isoc_maxburst   - 0..15 (ss only)
> >> -            buflen          - buffer length
> >> -            bulk_qlen       - depth of queue for bulk
> >> -            iso_qlen        - depth of queue for iso
> >> +            ==============    ==================================
> >> +            pattern           0 (all zeros), 1 (mod63), 2 (none)
> >> +            isoc_interval     1..16
> >> +            isoc_maxpacket    0 - 1023 (fs), 0 - 1024 (hs/ss)
> >> +            isoc_mult         0..2 (hs/ss only)
> >> +            isoc_maxburst     0..15 (ss only)
> >> +            buflen            buffer length
> >> +            bulk_qlen         depth of queue for bulk
> >> +            iso_qlen          depth of queue for iso
> >> +            ==============    ==================================
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-subset b/Documentation/ABI/testing/configfs-usb-gadget-subset
> >> index 9373e2c51ea4..0061b864351f 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-subset
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-subset
> >> @@ -4,11 +4,13 @@ KernelVersion:     3.11
> >>  Description:
> >>              The attributes:
> >>
> >> -            ifname          - network device interface name associated with
> >> +            ==========      =============================================
> >> +            ifname          network device interface name associated with
> >>                              this function instance
> >> -            qmult           - queue length multiplier for high and
> >> +            qmult           queue length multiplier for high and
> >>                              super speed
> >> -            host_addr       - MAC address of host's end of this
> >> +            host_addr       MAC address of host's end of this
> >>                              Ethernet over USB link
> >> -            dev_addr        - MAC address of device's end of this
> >> +            dev_addr        MAC address of device's end of this
> >>                              Ethernet over USB link
> >> +            ==========      =============================================
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-uac2 b/Documentation/ABI/testing/configfs-usb-gadget-uac2
> >> index 2bfdd4efa9bd..d4356c8b8cd6 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-uac2
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-uac2
> >> @@ -4,9 +4,11 @@ KernelVersion:      3.18
> >>  Description:
> >>              The attributes:
> >>
> >> -            c_chmask - capture channel mask
> >> -            c_srate - capture sampling rate
> >> -            c_ssize - capture sample size (bytes)
> >> -            p_chmask - playback channel mask
> >> -            p_srate - playback sampling rate
> >> -            p_ssize - playback sample size (bytes)
> >> +            =========  ============================
> >> +            c_chmask   capture channel mask
> >> +            c_srate    capture sampling rate
> >> +            c_ssize    capture sample size (bytes)
> >> +            p_chmask   playback channel mask
> >> +            p_srate    playback sampling rate
> >> +            p_ssize    playback sample size (bytes)
> >> +            =========  ============================
> >> diff --git a/Documentation/ABI/testing/configfs-usb-gadget-uvc b/Documentation/ABI/testing/configfs-usb-gadget-uvc
> >> index cee81b0347bb..ac5e11af79a8 100644
> >> --- a/Documentation/ABI/testing/configfs-usb-gadget-uvc
> >> +++ b/Documentation/ABI/testing/configfs-usb-gadget-uvc
> >> @@ -55,7 +55,7 @@ Description:       Default output terminal descriptors
> >>
> >>              ==============  =============================================
> >>              iTerminal       index of string descriptor
> >> -            bSourceID       id of the terminal to which this terminal
> >> +            bSourceID       id of the terminal to which this terminal
> >>                              is connected
> >>              bAssocTerminal  id of the input terminal to which this output
> >>                              terminal is associated
> >> diff --git a/Documentation/ABI/testing/debugfs-cec-error-inj b/Documentation/ABI/testing/debugfs-cec-error-inj
> >> index 5afcd78fbdb7..8debcb08a3b5 100644
> >> --- a/Documentation/ABI/testing/debugfs-cec-error-inj
> >> +++ b/Documentation/ABI/testing/debugfs-cec-error-inj
> >> @@ -23,7 +23,7 @@ error injections without having to know the details of the driver-specific
> >>  commands.
> >>
> >>  Note that the output of 'error-inj' shall be valid as input to 'error-inj'.
> >> -So this must work:
> >> +So this must work::
> >>
> >>      $ cat error-inj >einj.txt
> >>      $ cat einj.txt >error-inj
> >> diff --git a/Documentation/ABI/testing/debugfs-driver-habanalabs b/Documentation/ABI/testing/debugfs-driver-habanalabs
> >> index 2e9ae311e02d..c5d678d39144 100644
> >> --- a/Documentation/ABI/testing/debugfs-driver-habanalabs
> >> +++ b/Documentation/ABI/testing/debugfs-driver-habanalabs
> >> @@ -20,9 +20,13 @@ Description:    Allow the root user to disable/enable in runtime the clock
> >>                  The user can supply a bitmask value, each bit represents
> >>                  a different engine to disable/enable its clock gating feature.
> >>                  The bitmask is composed of 20 bits:
> >> -                0  -  7 : DMA channels
> >> -                8  - 11 : MME engines
> >> -                12 - 19 : TPC engines
> >> +
> >> +            =======   ============
> >> +                0  -  7   DMA channels
> >> +                8  - 11   MME engines
> >> +                12 - 19   TPC engines
> >> +            =======   ============
> >> +
> >>                  The bit's location of a specific engine can be determined
> >>                  using (1 << GAUDI_ENGINE_ID_*). GAUDI_ENGINE_ID_* values
> >>                  are defined in uapi habanalabs.h file in enum gaudi_engine_id
> >> @@ -59,6 +63,7 @@ Description:    Allows the root user to read or write directly through the
> >>                  the generic Linux user-space PCI mapping) because the DDR bar
> >>                  is very small compared to the DDR memory and only the driver can
> >>                  move the bar before and after the transaction.
> >> +
> >>                  If the IOMMU is disabled, it also allows the root user to read
> >>                  or write from the host a device VA of a host mapped memory
> >>
> >> @@ -73,6 +78,7 @@ Description:    Allows the root user to read or write 64 bit data directly
> >>                  the generic Linux user-space PCI mapping) because the DDR bar
> >>                  is very small compared to the DDR memory and only the driver can
> >>                  move the bar before and after the transaction.
> >> +
> >>                  If the IOMMU is disabled, it also allows the root user to read
> >>                  or write from the host a device VA of a host mapped memory
> >>
> >> diff --git a/Documentation/ABI/testing/debugfs-pfo-nx-crypto b/Documentation/ABI/testing/debugfs-pfo-nx-crypto
> >> index 685d5a448423..f75a655c1531 100644
> >> --- a/Documentation/ABI/testing/debugfs-pfo-nx-crypto
> >> +++ b/Documentation/ABI/testing/debugfs-pfo-nx-crypto
> >> @@ -4,42 +4,42 @@ KernelVersion:     3.4
> >>  Contact:    Kent Yoder <key@linux.vnet.ibm.com>
> >>  Description:
> >>
> >> -  These debugfs interfaces are built by the nx-crypto driver, built in
> >> +These debugfs interfaces are built by the nx-crypto driver, built in
> >>  arch/powerpc/crypto/nx.
> >>
> >>  Error Detection
> >>  ===============
> >>
> >>  errors:
> >> -- A u32 providing a total count of errors since the driver was loaded. The
> >> -only errors counted here are those returned from the hcall, H_COP_OP.
> >> +  A u32 providing a total count of errors since the driver was loaded. The
> >> +  only errors counted here are those returned from the hcall, H_COP_OP.
> >>
> >>  last_error:
> >> -- The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not
> >> -recorded here (the hcall will retry until -EBUSY goes away).
> >> +  The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not
> >> +  recorded here (the hcall will retry until -EBUSY goes away).
> >>
> >>  last_error_pid:
> >> -- The process ID of the process who received the most recent error from the
> >> -hcall.
> >> +  The process ID of the process who received the most recent error from the
> >> +  hcall.
> >>
> >>  Device Use
> >>  ==========
> >>
> >>  aes_bytes:
> >> -- The total number of bytes encrypted using AES in any of the driver's
> >> -supported modes.
> >> +  The total number of bytes encrypted using AES in any of the driver's
> >> +  supported modes.
> >>
> >>  aes_ops:
> >> -- The total number of AES operations submitted to the hardware.
> >> +  The total number of AES operations submitted to the hardware.
> >>
> >>  sha256_bytes:
> >> -- The total number of bytes hashed by the hardware using SHA-256.
> >> +  The total number of bytes hashed by the hardware using SHA-256.
> >>
> >>  sha256_ops:
> >> -- The total number of SHA-256 operations submitted to the hardware.
> >> +  The total number of SHA-256 operations submitted to the hardware.
> >>
> >>  sha512_bytes:
> >> -- The total number of bytes hashed by the hardware using SHA-512.
> >> +  The total number of bytes hashed by the hardware using SHA-512.
> >>
> >>  sha512_ops:
> >> -- The total number of SHA-512 operations submitted to the hardware.
> >> +  The total number of SHA-512 operations submitted to the hardware.
> >> diff --git a/Documentation/ABI/testing/debugfs-pktcdvd b/Documentation/ABI/testing/debugfs-pktcdvd
> >> index 787907d70462..f6f65a4faea0 100644
> >> --- a/Documentation/ABI/testing/debugfs-pktcdvd
> >> +++ b/Documentation/ABI/testing/debugfs-pktcdvd
> >> @@ -10,7 +10,7 @@ these files in debugfs:
> >>  /sys/kernel/debug/pktcdvd/pktcdvd[0-7]/
> >>
> >>      ====            ====== ====================================
> >> -    info            (0444) Lots of driver statistics and infos.
> >> +    info            0444   Lots of driver statistics and infos.
> >>      ====            ====== ====================================
> >>
> >>  Example::
> >> diff --git a/Documentation/ABI/testing/debugfs-turris-mox-rwtm b/Documentation/ABI/testing/debugfs-turris-mox-rwtm
> >> index c8f7dadd591c..ad08f535af3b 100644
> >> --- a/Documentation/ABI/testing/debugfs-turris-mox-rwtm
> >> +++ b/Documentation/ABI/testing/debugfs-turris-mox-rwtm
> >> @@ -2,10 +2,12 @@ What:              /sys/kernel/debug/turris-mox-rwtm/do_sign
> >>  Date:               Jun 2020
> >>  KernelVersion:      5.8
> >>  Contact:    Marek Behún <marek.behun@nic.cz>
> >> -Description:        (W)
> >> -                Message to sign with the ECDSA private key stored in
> >> +Description:
> >> +
> >> +            === ===========================================================
> >> +            (W) Message to sign with the ECDSA private key stored in
> >>                  device's OTP. The message must be exactly 64 bytes (since
> >>                  this is intended for SHA-512 hashes).
> >> -            (R)
> >> -                The resulting signature, 136 bytes. This contains the R and
> >> +            (R) The resulting signature, 136 bytes. This contains the R and
> >>                  S values of the ECDSA signature, both in big-endian format.
> >> +            === ===========================================================
> >> diff --git a/Documentation/ABI/testing/debugfs-wilco-ec b/Documentation/ABI/testing/debugfs-wilco-ec
> >> index 9d8d9d2def5b..682e3c09ef4d 100644
> >> --- a/Documentation/ABI/testing/debugfs-wilco-ec
> >> +++ b/Documentation/ABI/testing/debugfs-wilco-ec
> >> @@ -27,16 +27,17 @@ Description:
> >>              for writing, two for the type and at least a single byte of
> >>              data.
> >>
> >> -            Example:
> >> -            // Request EC info type 3 (EC firmware build date)
> >> -            // Corresponds with sending type 0x00f0 with
> >> -            // MBOX = [38, 00, 03, 00]
> >> -            $ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw
> >> -            // View the result. The decoded ASCII result "12/21/18" is
> >> -            // included after the raw hex.
> >> -            // Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...]
> >> -            $ cat /sys/kernel/debug/wilco_ec/raw
> >> -            00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00  ..12/21/18.8...
> >> +            Example::
> >> +
> >> +                // Request EC info type 3 (EC firmware build date)
> >> +                // Corresponds with sending type 0x00f0 with
> >> +                // MBOX = [38, 00, 03, 00]
> >> +                $ echo 00 f0 38 00 03 00 > /sys/kernel/debug/wilco_ec/raw
> >> +                // View the result. The decoded ASCII result "12/21/18" is
> >> +                // included after the raw hex.
> >> +                // Corresponds with MBOX = [00, 00, 31, 32, 2f, 32, 31, 38, ...]
> >> +                $ cat /sys/kernel/debug/wilco_ec/raw
> >> +                00 00 31 32 2f 32 31 2f 31 38 00 38 00 01 00 2f 00  ..12/21/18.8...
> >>
> >>              Note that the first 16 bytes of the received MBOX[] will be
> >>              printed, even if some of the data is junk, and skipping bytes
> >> diff --git a/Documentation/ABI/testing/dell-smbios-wmi b/Documentation/ABI/testing/dell-smbios-wmi
> >> index fc919ce16008..5f3a0dc67050 100644
> >> --- a/Documentation/ABI/testing/dell-smbios-wmi
> >> +++ b/Documentation/ABI/testing/dell-smbios-wmi
> >> @@ -10,29 +10,29 @@ Description:
> >>              <uapi/linux/wmi.h>
> >>
> >>              1) To perform an SMBIOS call from userspace, you'll need to
> >> -            first determine the minimum size of the calling interface
> >> -            buffer for your machine.
> >> -            Platforms that contain larger buffers can return larger
> >> -            objects from the system firmware.
> >> -            Commonly this size is either 4k or 32k.
> >> +               first determine the minimum size of the calling interface
> >> +               buffer for your machine.
> >> +               Platforms that contain larger buffers can return larger
> >> +               objects from the system firmware.
> >> +               Commonly this size is either 4k or 32k.
> >>
> >> -            To determine the size of the buffer read() a u64 dword from
> >> -            the WMI character device /dev/wmi/dell-smbios.
> >> +               To determine the size of the buffer read() a u64 dword from
> >> +               the WMI character device /dev/wmi/dell-smbios.
> >>
> >>              2) After you've determined the minimum size of the calling
> >> -            interface buffer, you can allocate a structure that represents
> >> -            the structure documented above.
> >> +               interface buffer, you can allocate a structure that represents
> >> +               the structure documented above.
> >>
> >>              3) In the 'length' object store the size of the buffer you
> >> -            determined above and allocated.
> >> +               determined above and allocated.
> >>
> >>              4) In this buffer object, prepare as necessary for the SMBIOS
> >> -            call you're interested in.  Typically SMBIOS buffers have
> >> -            "class", "select", and "input" defined to values that coincide
> >> -            with the data you are interested in.
> >> -            Documenting class/select/input values is outside of the scope
> >> -            of this documentation. Check with the libsmbios project for
> >> -            further documentation on these values.
> >> +               call you're interested in.  Typically SMBIOS buffers have
> >> +               "class", "select", and "input" defined to values that coincide
> >> +               with the data you are interested in.
> >> +               Documenting class/select/input values is outside of the scope
> >> +               of this documentation. Check with the libsmbios project for
> >> +               further documentation on these values.
> >>
> >>              6) Run the call by using ioctl() as described in the header.
> >>
> >> diff --git a/Documentation/ABI/testing/gpio-cdev b/Documentation/ABI/testing/gpio-cdev
> >> index 7b265fbb47e3..66bdcd188b6c 100644
> >> --- a/Documentation/ABI/testing/gpio-cdev
> >> +++ b/Documentation/ABI/testing/gpio-cdev
> >> @@ -12,15 +12,16 @@ Description:
> >>              The following file operations are supported:
> >>
> >>              open(2)
> >> -            Currently the only useful flags are O_RDWR.
> >> +              Currently the only useful flags are O_RDWR.
> >>
> >>              ioctl(2)
> >> -            Initiate various actions.
> >> -            See the inline documentation in [include/uapi]<linux/gpio.h>
> >> -            for descriptions of all ioctls.
> >> +              Initiate various actions.
> >> +
> >> +              See the inline documentation in [include/uapi]<linux/gpio.h>
> >> +              for descriptions of all ioctls.
> >>
> >>              close(2)
> >> -            Stops and free up the I/O contexts that was associated
> >> -            with the file descriptor.
> >> +              Stops and free up the I/O contexts that was associated
> >> +              with the file descriptor.
> >>
> >>  Users:              TBD
> >> diff --git a/Documentation/ABI/testing/procfs-diskstats b/Documentation/ABI/testing/procfs-diskstats
> >> index df5a3a8c1edf..e58d641443d3 100644
> >> --- a/Documentation/ABI/testing/procfs-diskstats
> >> +++ b/Documentation/ABI/testing/procfs-diskstats
> >> @@ -35,7 +35,9 @@ Description:
> >>
> >>              Kernel 5.5+ appends two more fields for flush requests:
> >>
> >> -            19 - flush requests completed successfully
> >> -            20 - time spent flushing
> >> +            ==  =====================================
> >> +            19  flush requests completed successfully
> >> +            20  time spent flushing
> >> +            ==  =====================================
> >>
> >>              For more details refer to Documentation/admin-guide/iostats.rst
> >> diff --git a/Documentation/ABI/testing/procfs-smaps_rollup b/Documentation/ABI/testing/procfs-smaps_rollup
> >> index 046978193368..a4e31c465194 100644
> >> --- a/Documentation/ABI/testing/procfs-smaps_rollup
> >> +++ b/Documentation/ABI/testing/procfs-smaps_rollup
> >> @@ -14,28 +14,28 @@ Description:
> >>              For more details, see Documentation/filesystems/proc.rst
> >>              and the procfs man page.
> >>
> >> -            Typical output looks like this:
> >> +            Typical output looks like this::
> >>
> >> -            00100000-ff709000 ---p 00000000 00:00 0          [rollup]
> >> -            Size:               1192 kB
> >> -            KernelPageSize:        4 kB
> >> -            MMUPageSize:           4 kB
> >> -            Rss:                 884 kB
> >> -            Pss:                 385 kB
> >> -            Pss_Anon:            301 kB
> >> -            Pss_File:             80 kB
> >> -            Pss_Shmem:             4 kB
> >> -            Shared_Clean:        696 kB
> >> -            Shared_Dirty:          0 kB
> >> -            Private_Clean:       120 kB
> >> -            Private_Dirty:        68 kB
> >> -            Referenced:          884 kB
> >> -            Anonymous:            68 kB
> >> -            LazyFree:              0 kB
> >> -            AnonHugePages:         0 kB
> >> -            ShmemPmdMapped:        0 kB
> >> -            Shared_Hugetlb:        0 kB
> >> -            Private_Hugetlb:       0 kB
> >> -            Swap:                  0 kB
> >> -            SwapPss:               0 kB
> >> -            Locked:              385 kB
> >> +                    00100000-ff709000 ---p 00000000 00:00 0          [rollup]
> >> +                    Size:               1192 kB
> >> +                    KernelPageSize:        4 kB
> >> +                    MMUPageSize:           4 kB
> >> +                    Rss:                 884 kB
> >> +                    Pss:                 385 kB
> >> +                    Pss_Anon:            301 kB
> >> +                    Pss_File:             80 kB
> >> +                    Pss_Shmem:             4 kB
> >> +                    Shared_Clean:        696 kB
> >> +                    Shared_Dirty:          0 kB
> >> +                    Private_Clean:       120 kB
> >> +                    Private_Dirty:        68 kB
> >> +                    Referenced:          884 kB
> >> +                    Anonymous:            68 kB
> >> +                    LazyFree:              0 kB
> >> +                    AnonHugePages:         0 kB
> >> +                    ShmemPmdMapped:        0 kB
> >> +                    Shared_Hugetlb:        0 kB
> >> +                    Private_Hugetlb:       0 kB
> >> +                    Swap:                  0 kB
> >> +                    SwapPss:               0 kB
> >> +                    Locked:              385 kB
> >> diff --git a/Documentation/ABI/testing/pstore b/Documentation/ABI/testing/pstore
> >> index d45209abdb1b..5b02540781a2 100644
> >> --- a/Documentation/ABI/testing/pstore
> >> +++ b/Documentation/ABI/testing/pstore
> >> @@ -9,25 +9,25 @@ Description:       Generic interface to platform dependent persistent storage.
> >>              provide a generic interface to show records captured in
> >>              the dying moments.  In the case of a panic the last part
> >>              of the console log is captured, but other interesting
> >> -            data can also be saved.
> >> +            data can also be saved::
> >>
> >> -            # mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore
> >> +                # mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore
> >>
> >> -            $ ls -l /sys/fs/pstore/
> >> -            total 0
> >> -            -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
> >> +                $ ls -l /sys/fs/pstore/
> >> +                total 0
> >> +                -r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
> >>
> >>              Different users of this interface will result in different
> >>              filename prefixes.  Currently two are defined:
> >>
> >> -            "dmesg" - saved console log
> >> -            "mce"   - architecture dependent data from fatal h/w error
> >> +            - "dmesg" - saved console log
> >> +            - "mce"   - architecture dependent data from fatal h/w error
> >>
> >>              Once the information in a file has been read, removing
> >>              the file will signal to the underlying persistent storage
> >> -            device that it can reclaim the space for later re-use.
> >> +            device that it can reclaim the space for later re-use::
> >>
> >> -            $ rm /sys/fs/pstore/dmesg-erst-1
> >> +                $ rm /sys/fs/pstore/dmesg-erst-1
> >>
> >>              The expectation is that all files in /sys/fs/pstore/
> >>              will be saved elsewhere and erased from persistent store
> >> @@ -44,4 +44,3 @@ Description:       Generic interface to platform dependent persistent storage.
> >>              backends are available, the preferred backend may be
> >>              set by passing the pstore.backend= argument to the kernel at
> >>              boot time.
> >> -
> >> diff --git a/Documentation/ABI/testing/sysfs-block-rnbd b/Documentation/ABI/testing/sysfs-block-rnbd
> >> index 8f070b47f361..14a6fe9422b3 100644
> >> --- a/Documentation/ABI/testing/sysfs-block-rnbd
> >> +++ b/Documentation/ABI/testing/sysfs-block-rnbd
> >> @@ -9,9 +9,9 @@ Description: To unmap a volume, "normal" or "force" has to be written to:
> >>              is using the device.  When "force" is used, the device is also unmapped
> >>              when device is in use.  All I/Os that are in progress will fail.
> >>
> >> -            Example:
> >> +            Example::
> >>
> >> -            # echo "normal" > /sys/block/rnbd0/rnbd/unmap_device
> >> +              # echo "normal" > /sys/block/rnbd0/rnbd/unmap_device
> >>
> >>  What:               /sys/block/rnbd<N>/rnbd/state
> >>  Date:               Feb 2020
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-acpi b/Documentation/ABI/testing/sysfs-bus-acpi
> >> index c78603497b97..58abacf59b2a 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-acpi
> >> +++ b/Documentation/ABI/testing/sysfs-bus-acpi
> >> @@ -5,6 +5,7 @@ Description:
> >>              This attribute indicates the full path of ACPI namespace
> >>              object associated with the device object.  For example,
> >>              \_SB_.PCI0.
> >> +
> >>              This file is not present for device objects representing
> >>              fixed ACPI hardware features (like power and sleep
> >>              buttons).
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10 b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
> >> index b5f526081711..3e92cbd3fd83 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
> >> +++ b/Documentation/ABI/testing/sysfs-bus-coresight-devices-etb10
> >> @@ -4,7 +4,10 @@ KernelVersion:      3.19
> >>  Contact:    Mathieu Poirier <mathieu.poirier@linaro.org>
> >>  Description:        (RW) Add/remove a sink from a trace path.  There can be multiple
> >>              source for a single sink.
> >> -            ex: echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink
> >> +
> >> +            ex::
> >> +
> >> +              echo 1 > /sys/bus/coresight/devices/20010000.etb/enable_sink
> >>
> >>  What:               /sys/bus/coresight/devices/<memory_map>.etb/trigger_cntr
> >>  Date:               November 2014
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-css b/Documentation/ABI/testing/sysfs-bus-css
> >> index 966f8504bd7b..12a733fe357f 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-css
> >> +++ b/Documentation/ABI/testing/sysfs-bus-css
> >> @@ -20,6 +20,7 @@ Contact:   Cornelia Huck <cornelia.huck@de.ibm.com>
> >>  Description:        Contains the ids of the channel paths used by this
> >>              subchannel, as reported by the channel subsystem
> >>              during subchannel recognition.
> >> +
> >>              Note: This is an I/O-subchannel specific attribute.
> >>  Users:              s390-tools, HAL
> >>
> >> @@ -31,6 +32,7 @@ Description:       Contains the PIM/PAM/POM values, as reported by the
> >>              channel subsystem when last queried by the common I/O
> >>              layer (this implies that this attribute is not necessarily
> >>              in sync with the values current in the channel subsystem).
> >> +
> >>              Note: This is an I/O-subchannel specific attribute.
> >>  Users:              s390-tools, HAL
> >>
> >> @@ -53,6 +55,7 @@ Description:       This file allows the driver for a device to be specified. When
> >>              opt-out of driver binding using a driver_override name such as
> >>              "none".  Only a single driver may be specified in the override,
> >>              there is no support for parsing delimiters.
> >> +
> >>              Note that unlike the mechanism of the same name for pci, this
> >>              file does not allow to override basic matching rules. I.e.,
> >>              the driver must still match the subchannel type of the device.
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-dfl b/Documentation/ABI/testing/sysfs-bus-dfl
> >> index 23543be904f2..b0265ab17200 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-dfl
> >> +++ b/Documentation/ABI/testing/sysfs-bus-dfl
> >> @@ -4,6 +4,7 @@ KernelVersion:       5.10
> >>  Contact:    Xu Yilun <yilun.xu@intel.com>
> >>  Description:        Read-only. It returns type of DFL FIU of the device. Now DFL
> >>              supports 2 FIU types, 0 for FME, 1 for PORT.
> >> +
> >>              Format: 0x%x
> >>
> >>  What:               /sys/bus/dfl/devices/dfl_dev.X/feature_id
> >> @@ -12,4 +13,5 @@ KernelVersion:     5.10
> >>  Contact:    Xu Yilun <yilun.xu@intel.com>
> >>  Description:        Read-only. It returns feature identifier local to its DFL FIU
> >>              type.
> >> +
> >>              Format: 0x%x
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7 b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
> >> index 2273627df190..de390a010af8 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
> >> +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
> >> @@ -7,7 +7,7 @@ Description:    Read-only. Attribute group to describe the magic bits
> >>
> >>                  Each attribute under this group defines a bit range of the
> >>                  perf_event_attr.config. All supported attributes are listed
> >> -                below.
> >> +                below::
> >>
> >>                              chip = "config:16-31"
> >>                              core  = "config:16-31"
> >> @@ -16,9 +16,9 @@ Description:    Read-only. Attribute group to describe the magic bits
> >>                              offset = "config:32-63"
> >>                              vcpu = "config:16-31"
> >>
> >> -               For example,
> >> +                For example::
> >>
> >> -            PM_PB_CYC =  "domain=1,offset=0x80,chip=?,lpar=0x0"
> >> +              PM_PB_CYC =  "domain=1,offset=0x80,chip=?,lpar=0x0"
> >>
> >>              In this event, '?' after chip specifies that
> >>              this value will be provided by user while running this event.
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
> >> index 6a023b42486c..12e2bf92783f 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
> >> +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
> >> @@ -7,7 +7,7 @@ Description:    Read-only. Attribute group to describe the magic bits
> >>
> >>                  Each attribute under this group defines a bit range of the
> >>                  perf_event_attr.config. All supported attributes are listed
> >> -                below.
> >> +                below::
> >>
> >>                              counter_info_version  = "config:16-23"
> >>                              length  = "config:24-31"
> >> @@ -20,9 +20,9 @@ Description:    Read-only. Attribute group to describe the magic bits
> >>                              secondary_index = "config:0-15"
> >>                              starting_index = "config:32-63"
> >>
> >> -               For example,
> >> +                For example::
> >>
> >> -            processor_core_utilization_instructions_completed = "request=0x94,
> >> +              processor_core_utilization_instructions_completed = "request=0x94,
> >>                                      phys_processor_idx=?,counter_info_version=0x8,
> >>                                      length=8,offset=0x18"
> >>
> >> @@ -36,6 +36,7 @@ Description:
> >>              '0' if the hypervisor is configured to forbid access to event
> >>              counters being accumulated by other guests and to physical
> >>              domain event counters.
> >> +
> >>              '1' if that access is allowed.
> >>
> >>  What:               /sys/bus/event_source/devices/hv_gpci/interface/ga
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-fcoe b/Documentation/ABI/testing/sysfs-bus-fcoe
> >> index 657df13b100d..8fe787cc4ab7 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-fcoe
> >> +++ b/Documentation/ABI/testing/sysfs-bus-fcoe
> >> @@ -3,16 +3,19 @@ Date:              August 2012
> >>  KernelVersion:      TBD
> >>  Contact:    Robert Love <robert.w.love@intel.com>, devel@open-fcoe.org
> >>  Description:        The FCoE bus. Attributes in this directory are control interfaces.
> >> +
> >>  Attributes:
> >>
> >> -    ctlr_create: 'FCoE Controller' instance creation interface. Writing an
> >> +    ctlr_create:
> >> +                 'FCoE Controller' instance creation interface. Writing an
> >>                   <ifname> to this file will allocate and populate sysfs with a
> >>                   fcoe_ctlr_device (ctlr_X). The user can then configure any
> >>                   per-port settings and finally write to the fcoe_ctlr_device's
> >>                   'start' attribute to begin the kernel's discovery and login
> >>                   process.
> >>
> >> -    ctlr_destroy: 'FCoE Controller' instance removal interface. Writing a
> >> +    ctlr_destroy:
> >> +                   'FCoE Controller' instance removal interface. Writing a
> >>                     fcoe_ctlr_device's sysfs name to this file will log the
> >>                     fcoe_ctlr_device out of the fabric or otherwise connected
> >>                     FCoE devices. It will also free all kernel memory allocated
> >> @@ -32,11 +35,13 @@ Description:     'FCoE Controller' instances on the fcoe bus.
> >>
> >>  Attributes:
> >>
> >> -    fcf_dev_loss_tmo: Device loss timeout period (see below). Changing
> >> +    fcf_dev_loss_tmo:
> >> +                      Device loss timeout period (see below). Changing
> >>                        this value will change the dev_loss_tmo for all
> >>                        FCFs discovered by this controller.
> >>
> >> -    mode:             Display or change the FCoE Controller's mode. Possible
> >> +    mode:
> >> +                      Display or change the FCoE Controller's mode. Possible
> >>                        modes are 'Fabric' and 'VN2VN'. If a FCoE Controller
> >>                        is started in 'Fabric' mode then FIP FCF discovery is
> >>                        initiated and ultimately a fabric login is attempted.
> >> @@ -44,23 +49,30 @@ Attributes:
> >>                        FIP VN2VN discovery and login is performed. A FCoE
> >>                        Controller only supports one mode at a time.
> >>
> >> -    enabled:          Whether an FCoE controller is enabled or disabled.
> >> +    enabled:
> >> +                      Whether an FCoE controller is enabled or disabled.
> >>                        0 if disabled, 1 if enabled. Writing either 0 or 1
> >>                        to this file will enable or disable the FCoE controller.
> >>
> >> -    lesb/link_fail:   Link Error Status Block (LESB) link failure count.
> >> +    lesb/link_fail:
> >> +                      Link Error Status Block (LESB) link failure count.
> >>
> >> -    lesb/vlink_fail:  Link Error Status Block (LESB) virtual link
> >> +    lesb/vlink_fail:
> >> +                      Link Error Status Block (LESB) virtual link
> >>                        failure count.
> >>
> >> -    lesb/miss_fka:    Link Error Status Block (LESB) missed FCoE
> >> +    lesb/miss_fka:
> >> +                      Link Error Status Block (LESB) missed FCoE
> >>                        Initialization Protocol (FIP) Keep-Alives (FKA).
> >>
> >> -    lesb/symb_err:    Link Error Status Block (LESB) symbolic error count.
> >> +    lesb/symb_err:
> >> +                      Link Error Status Block (LESB) symbolic error count.
> >>
> >> -    lesb/err_block:   Link Error Status Block (LESB) block error count.
> >> +    lesb/err_block:
> >> +                      Link Error Status Block (LESB) block error count.
> >>
> >> -    lesb/fcs_error:   Link Error Status Block (LESB) Fibre Channel
> >> +    lesb/fcs_error:
> >> +                      Link Error Status Block (LESB) Fibre Channel
> >>                        Services error count.
> >>
> >>  Notes: ctlr_X (global increment starting at 0)
> >> @@ -75,31 +87,41 @@ Description:     'FCoE FCF' instances on the fcoe bus. A FCF is a Fibre Channel
> >>              Fibre Channel frames into a FC fabric. It can also take
> >>              outbound FC frames and pack them in Ethernet packets to
> >>              be sent to their destination on the Ethernet segment.
> >> +
> >>  Attributes:
> >>
> >> -    fabric_name: Identifies the fabric that the FCF services.
> >> +    fabric_name:
> >> +                 Identifies the fabric that the FCF services.
> >>
> >> -    switch_name: Identifies the FCF.
> >> +    switch_name:
> >> +                 Identifies the FCF.
> >>
> >> -    priority:    The switch's priority amongst other FCFs on the same
> >> +    priority:
> >> +                 The switch's priority amongst other FCFs on the same
> >>                   fabric.
> >>
> >> -    selected:    1 indicates that the switch has been selected for use;
> >> +    selected:
> >> +                 1 indicates that the switch has been selected for use;
> >>                   0 indicates that the switch will not be used.
> >>
> >> -    fc_map:      The Fibre Channel MAP
> >> +    fc_map:
> >> +                 The Fibre Channel MAP
> >>
> >> -    vfid:        The Virtual Fabric ID
> >> +    vfid:
> >> +                 The Virtual Fabric ID
> >>
> >> -    mac:         The FCF's MAC address
> >> +    mac:
> >> +                 The FCF's MAC address
> >>
> >> -    fka_period:  The FIP Keep-Alive period
> >> +    fka_period:
> >> +                 The FIP Keep-Alive period
> >>
> >>      fabric_state: The internal kernel state
> >> -                  "Unknown" - Initialization value
> >> -                  "Disconnected" - No link to the FCF/fabric
> >> -                  "Connected" - Host is connected to the FCF
> >> -                  "Deleted" - FCF is being removed from the system
> >> +
> >> +                  - "Unknown" - Initialization value
> >> +                  - "Disconnected" - No link to the FCF/fabric
> >> +                  - "Connected" - Host is connected to the FCF
> >> +                  - "Deleted" - FCF is being removed from the system
> >>
> >>      dev_loss_tmo: The device loss timeout period for this FCF.
> >>
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-fsl-mc b/Documentation/ABI/testing/sysfs-bus-fsl-mc
> >> index 80256b8b4f26..bf3c6af6ad89 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-fsl-mc
> >> +++ b/Documentation/ABI/testing/sysfs-bus-fsl-mc
> >> @@ -6,8 +6,10 @@ Description:
> >>              the driver to attempt to bind to the device found at
> >>              this location. The format for the location is Object.Id
> >>              and is the same as found in /sys/bus/fsl-mc/devices/.
> >> -                For example:
> >> -            # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind
> >> +
> >> +                For example::
> >> +
> >> +              # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/bind
> >>
> >>  What:               /sys/bus/fsl-mc/drivers/.../unbind
> >>  Date:               December 2016
> >> @@ -17,5 +19,7 @@ Description:
> >>              driver to attempt to unbind from the device found at
> >>              this location. The format for the location is Object.Id
> >>              and is the same as found in /sys/bus/fsl-mc/devices/.
> >> -                For example:
> >> -            # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind
> >> +
> >> +                For example::
> >> +
> >> +              # echo dpni.2 > /sys/bus/fsl-mc/drivers/fsl_dpaa2_eth/unbind
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480 b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
> >> index 9de269bb0ae5..42dfc9399d2d 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
> >> +++ b/Documentation/ABI/testing/sysfs-bus-i2c-devices-fsa9480
> >> @@ -3,19 +3,25 @@ Date:              February 2011
> >>  Contact:    Minkyu Kang <mk7.kang@samsung.com>
> >>  Description:
> >>              show what device is attached
> >> -            NONE - no device
> >> -            USB - USB device is attached
> >> -            UART - UART is attached
> >> -            CHARGER - Charger is attaced
> >> -            JIG - JIG is attached
> >> +
> >> +            =======  ======================
> >> +            NONE     no device
> >> +            USB      USB device is attached
> >> +            UART     UART is attached
> >> +            CHARGER  Charger is attaced
> >> +            JIG      JIG is attached
> >> +            =======  ======================
> >>
> >>  What:               /sys/bus/i2c/devices/.../switch
> >>  Date:               February 2011
> >>  Contact:    Minkyu Kang <mk7.kang@samsung.com>
> >>  Description:
> >>              show or set the state of manual switch
> >> -            VAUDIO - switch to VAUDIO path
> >> -            UART - switch to UART path
> >> -            AUDIO - switch to AUDIO path
> >> -            DHOST - switch to DHOST path
> >> -            AUTO - switch automatically by device
> >> +
> >> +            =======  ==============================
> >> +            VAUDIO   switch to VAUDIO path
> >> +            UART     switch to UART path
> >> +            AUDIO    switch to AUDIO path
> >> +            DHOST    switch to DHOST path
> >> +            AUTO     switch automatically by device
> >> +            =======  ==============================
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-i3c b/Documentation/ABI/testing/sysfs-bus-i3c
> >> index 2f332ec36f82..1f4a2662335b 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-i3c
> >> +++ b/Documentation/ABI/testing/sysfs-bus-i3c
> >> @@ -84,6 +84,7 @@ Description:
> >>              by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
> >>              See the I3C specification for more details about these HDR
> >>              modes.
> >> +
> >>              This entry describes the HDRCAP of the master controller
> >>              driving the bus.
> >>
> >> @@ -135,6 +136,7 @@ Description:
> >>              Expose the HDR (High Data Rate) capabilities of a device.
> >>              Returns a list of supported HDR mode, each element is separated
> >>              by space. Modes can be "hdr-ddr", "hdr-tsp" and "hdr-tsl".
> >> +
> >>              See the I3C specification for more details about these HDR
> >>              modes.
> >>
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-iio b/Documentation/ABI/testing/sysfs-bus-iio
> >> index e3df71987eff..df42bed09f25 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-iio
> >> +++ b/Documentation/ABI/testing/sysfs-bus-iio
> >> @@ -15,6 +15,7 @@ Description:
> >>              based on hardware generated events (e.g. data ready) or
> >>              provided by a separate driver for other hardware (e.g.
> >>              periodic timer, GPIO or high resolution timer).
> >> +
> >>              Contains trigger type specific elements. These do not
> >>              generalize well and hence are not documented in this file.
> >>              X is the IIO index of the trigger.
> >> @@ -666,6 +667,7 @@ Description:
> >>              <type>[Y][_name]_<raw|input>_thresh_falling_value may take
> >>              different values, but the device can only enable both thresholds
> >>              or neither.
> >> +
> >>              Note the driver will assume the last p events requested are
> >>              to be enabled where p is how many it supports (which may vary
> >>              depending on the exact set requested. So if you want to be
> >> @@ -720,6 +722,7 @@ Description:
> >>              <type>[Y][_name]_<raw|input>_roc_falling_value may take
> >>              different values, but the device can only enable both rate of
> >>              change thresholds or neither.
> >> +
> >>              Note the driver will assume the last p events requested are
> >>              to be enabled where p is however many it supports (which may
> >>              vary depending on the exact set requested. So if you want to be
> >> @@ -775,9 +778,11 @@ Description:
> >>              Specifies the value of threshold that the device is comparing
> >>              against for the events enabled by
> >>              <type>Y[_name]_thresh[_rising|falling]_en.
> >> +
> >>              If separate attributes exist for the two directions, but
> >>              direction is not specified for this attribute, then a single
> >>              threshold value applies to both directions.
> >> +
> >>              The raw or input element of the name indicates whether the
> >>              value is in raw device units or in processed units (as _raw
> >>              and _input do on sysfs direct channel read attributes).
> >> @@ -860,6 +865,7 @@ Description:
> >>              If separate attributes exist for the two directions, but
> >>              direction is not specified for this attribute, then a single
> >>              hysteresis value applies to both directions.
> >> +
> >>              For falling events the hysteresis is added to the _value attribute for
> >>              this event to get the upper threshold for when the event goes back to
> >>              normal, for rising events the hysteresis is subtracted from the _value
> >> @@ -906,6 +912,7 @@ Description:
> >>              Specifies the value of rate of change threshold that the
> >>              device is comparing against for the events enabled by
> >>              <type>[Y][_name]_roc[_rising|falling]_en.
> >> +
> >>              If separate attributes exist for the two directions,
> >>              but direction is not specified for this attribute,
> >>              then a single threshold value applies to both directions.
> >> @@ -1305,6 +1312,7 @@ Description:
> >>              Proximity measurement indicating that some
> >>              object is near the sensor, usually by observing
> >>              reflectivity of infrared or ultrasound emitted.
> >> +
> >>              Often these sensors are unit less and as such conversion
> >>              to SI units is not possible. Higher proximity measurements
> >>              indicate closer objects, and vice versa. Units after
> >> @@ -1450,9 +1458,12 @@ Contact:      linux-iio@vger.kernel.org
> >>  Description:
> >>              A single positive integer specifying the maximum number of scan
> >>              elements to wait for.
> >> +
> >>              Poll will block until the watermark is reached.
> >> +
> >>              Blocking read will wait until the minimum between the requested
> >>              read amount or the low water mark is available.
> >> +
> >>              Non-blocking read will retrieve the available samples from the
> >>              buffer even if there are less samples then watermark level. This
> >>              allows the application to block on poll with a timeout and read
> >> @@ -1481,11 +1492,13 @@ Description:
> >>              device settings allows it (e.g. if a trigger is set that samples
> >>              data differently that the hardware fifo does then hardware fifo
> >>              will not enabled).
> >> +
> >>              If the hardware fifo is enabled and the level of the hardware
> >>              fifo reaches the hardware fifo watermark level the device will
> >>              flush its hardware fifo to the device buffer. Doing a non
> >>              blocking read on the device when no samples are present in the
> >>              device buffer will also force a flush.
> >> +
> >>              When the hardware fifo is enabled there is no need to use a
> >>              trigger to use buffer mode since the watermark settings
> >>              guarantees that the hardware fifo is flushed to the device
> >> @@ -1523,6 +1536,7 @@ Description:
> >>              A single positive integer specifying the minimum watermark level
> >>              for the hardware fifo of this device. If the device does not
> >>              have a hardware fifo this entry is not present.
> >> +
> >>              If the user sets buffer/watermark to a value less than this one,
> >>              then the hardware watermark will remain unset.
> >>
> >> @@ -1533,6 +1547,7 @@ Description:
> >>              A single positive integer specifying the maximum watermark level
> >>              for the hardware fifo of this device. If the device does not
> >>              have a hardware fifo this entry is not present.
> >> +
> >>              If the user sets buffer/watermark to a value greater than this
> >>              one, then the hardware watermark will be capped at this value.
> >>
> >> @@ -1544,6 +1559,7 @@ Description:
> >>              levels for the hardware fifo. This entry is optional and if it
> >>              is not present it means that all the values between
> >>              hwfifo_watermark_min and hwfifo_watermark_max are supported.
> >> +
> >>              If the user sets buffer/watermark to a value greater than
> >>              hwfifo_watermak_min but not equal to any of the values in this
> >>              list, the driver will chose an appropriate value for the
> >> @@ -1605,7 +1621,8 @@ KernelVersion: 4.1.0
> >>  Contact:    linux-iio@vger.kernel.org
> >>  Description:
> >>              '1' (enable) or '0' (disable) specifying the enable
> >> -            of heater function. Same reading values apply
> >> +            of heater function. Same reading values apply.
> >> +
> >>              This ABI is especially applicable for humidity sensors
> >>              to heatup the device and get rid of any condensation
> >>              in some humidity environment
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435 b/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
> >> index f30b4c424fb6..4b01150af397 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
> >> +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-hi8435
> >> @@ -19,9 +19,11 @@ Description:
> >>              is separately set for "GND-Open" and "Supply-Open" modes.
> >>              Channels 0..31 have common low threshold values, but could have different
> >>              sensing_modes.
> >> +
> >>              The low voltage threshold range is between 2..21V.
> >>              Hysteresis between low and high thresholds can not be lower then 2 and
> >>              can not be odd.
> >> +
> >>              If falling threshold results hysteresis to odd value then rising
> >>              threshold is automatically subtracted by one.
> >>
> >> @@ -34,10 +36,13 @@ Description:
> >>              this value then the threshold rising event is pushed.
> >>              Depending on in_voltageY_sensing_mode the high voltage threshold
> >>              is separately set for "GND-Open" and "Supply-Open" modes.
> >> +
> >>              Channels 0..31 have common high threshold values, but could have different
> >>              sensing_modes.
> >> +
> >>              The high voltage threshold range is between 3..22V.
> >>              Hysteresis between low and high thresholds can not be lower then 2 and
> >>              can not be odd.
> >> +
> >>              If rising threshold results hysteresis to odd value then falling
> >>              threshold is automatically appended by one.
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32 b/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
> >> index efe4c85e3c8b..1975c7a1af34 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
> >> +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-stm32
> >> @@ -5,10 +5,13 @@ Description:
> >>              The STM32 ADC can be configured to use external trigger sources
> >>              (e.g. timers, pwm or exti gpio). Then, it can be tuned to start
> >>              conversions on external trigger by either:
> >> +
> >>              - "rising-edge"
> >>              - "falling-edge"
> >>              - "both-edges".
> >> +
> >>              Reading returns current trigger polarity.
> >> +
> >>              Writing value before enabling conversions sets trigger polarity.
> >>
> >>  What:               /sys/bus/iio/devices/triggerX/trigger_polarity_available
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
> >> index a133fd8d081a..40df5c9fef99 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
> >> +++ b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08
> >> @@ -15,8 +15,11 @@ Description:
> >>              first object echoed in meters. Default value is 6.020.
> >>              This setting limits the time the driver is waiting for a
> >>              echo.
> >> +
> >>              Showing the range of available values is represented as the
> >>              minimum value, the step and the maximum value, all enclosed
> >>              in square brackets.
> >> -            Example:
> >> -            [0.043 0.043 11.008]
> >> +
> >> +            Example::
> >> +
> >> +                    [0.043 0.043 11.008]
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
> >> index a91aeabe7b24..d065cda7dd96 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
> >> +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-ad9523
> >> @@ -8,7 +8,9 @@ KernelVersion:       3.4.0
> >>  Contact:    linux-iio@vger.kernel.org
> >>  Description:
> >>              Reading returns either '1' or '0'.
> >> +
> >>              '1' means that the clock in question is present.
> >> +
> >>              '0' means that the clock is missing.
> >>
> >>  What:               /sys/bus/iio/devices/iio:deviceX/pllY_locked
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371 b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> >> index 302de64cb424..544548ee794c 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> >> +++ b/Documentation/ABI/testing/sysfs-bus-iio-frequency-adf4371
> >> @@ -27,12 +27,12 @@ What:            /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_name
> >>  KernelVersion:
> >>  Contact:    linux-iio@vger.kernel.org
> >>  Description:
> >> -            Reading returns the datasheet name for channel Y:
> >> +            Reading returns the datasheet name for channel Y::
> >>
> >> -            out_altvoltage0_name: RF8x
> >> -            out_altvoltage1_name: RFAUX8x
> >> -            out_altvoltage2_name: RF16x
> >> -            out_altvoltage3_name: RF32x
> >> +              out_altvoltage0_name: RF8x
> >> +              out_altvoltage1_name: RFAUX8x
> >> +              out_altvoltage2_name: RF16x
> >> +              out_altvoltage3_name: RF32x
> >>
> >>  What:               /sys/bus/iio/devices/iio:deviceX/out_altvoltageY_powerdown
> >>  KernelVersion:
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x b/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
> >> index 6adba9058b22..66b621f10223 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
> >> +++ b/Documentation/ABI/testing/sysfs-bus-iio-health-afe440x
> >> @@ -6,10 +6,14 @@ Description:
> >>              Get measured values from the ADC for these stages. Y is the
> >>              specific stage number corresponding to datasheet stage names
> >>              as follows:
> >> -            1 -> LED2
> >> -            2 -> ALED2/LED3
> >> -            3 -> LED1
> >> -            4 -> ALED1/LED4
> >> +
> >> +            == ==========
> >> +            1  LED2
> >> +            2  ALED2/LED3
> >> +            3  LED1
> >> +            4  ALED1/LED4
> >> +            == ==========
> >> +
> >>              Note that channels 5 and 6 represent LED2-ALED2 and LED1-ALED1
> >>              respectively which simply helper channels containing the
> >>              calculated difference in the value of stage 1 - 2 and 3 - 4.
> >> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018 b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> >> index f0ce0a0476ea..220206a20d98 100644
> >> --- a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> >> +++ b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> >> @@ -15,5 +15,7 @@ Description:
> >>              Scheme 0 has wider dynamic range, Scheme 1 proximity detection
> >>              is less affected by the ambient IR noise variation.
> >>
> >> -            0 Sensing IR from LED and ambient
> >> -            1 Sensing IR from LED with ambient IR rejection
> >> +            == =============================================