linux-i3c.lists.infradead.org archive mirror
 help / color / mirror / Atom feed
* [PATCH 30/33] docs: ABI: cleanup several ABI documents
       [not found] <cover.1603893146.git.mchehab+huawei@kernel.org>
@ 2020-10-28 14:23 ` Mauro Carvalho Chehab
  2020-10-29 14:42   ` Jonathan Cameron
                     ` (3 more replies)
  0 siblings, 4 replies; 7+ messages in thread
From: Mauro Carvalho Chehab @ 2020-10-28 14:23 UTC (permalink / raw)
  To: Linux Doc Mailing List, Greg Kroah-Hartman
  Cc: Andrew Lunn, Peter Chen, Linus Walleij, Jerry Snitselaar,
	dri-devel, Pavel Machek, Christian Gromm, ceph-devel, Kan Liang,
	Bart Van Assche, Michael Ellerman, linux-acpi, Danil Kipnis,
	Samuel Thibault, Guenter Roeck, Ohad Ben-Cohen, linux-pm,
	Simon Gaiser, Avri Altman, Alexander Antonov, Dan Murphy,
	Thomas Gleixner, Stefan Achatz, Konstantin Khlebnikov,
	Mathieu Malaterre, Jingoo Han, Rafael J. Wysocki, linux-kernel,
	Hans Verkuil, Andrew Morton, Wu Hao, Peter Meerwald-Stadler,
	Mimi Zohar, Srinivas Kandagatla, Hanjun Guo, Oleh Kravchenko,
	Lars-Peter Clausen, Andy Shevchenko, Saravana Kannan,
	Gregory CLEMENT, Anton Vorontsov,
	Marek Marczykowski-Górecki, linux-stm32,
	Bartosz Golaszewski, Len Brown, Alexandre Torgue,
	Michael Hennerich, Suzuki K Poulose, coresight, linux-media,
	Frederic Barrat, Bjorn Helgaas, Jaegeuk Kim, Boris Ostrovsky,
	Mika Westerberg, linux-arm-kernel, Oded Gabbay, Tony Luck,
	Mathieu Poirier, Boris Brezillon, PrasannaKumar Muralidharan,
	linux-gpio, Dongsheng Yang, Roman Sudarikov, Jarkko Sakkinen,
	Maxime Coquelin, Vaibhav Jain, Pali Rohár, Jonathan Cameron,
	Heiner Kallweit, Gautham R. Shenoy, Cezary Rojewski,
	Mario Limonciello, linux-iio, Tom Rix, linux-fpga,
	Rasmus Villemoes, Jonas Meurer, Daniel Thompson,
	Florian Fainelli, Mark Gross, Jonathan Corbet, Ilya Dryomov,
	Jack Wang, Kees Cook, Mark Brown, Dan Williams, Kranthi Kuntala,
	Martin K. Petersen, Dmitry Torokhov, Sebastian Reichel,
	Colin Cross, Enric Balletbo i Serra, David S. Miller,
	Roger Pau Monné, Peter Zijlstra (Intel),
	linux-remoteproc, Bjorn Andersson, Paul Cercueil, linux-i3c,
	linux-f2fs-devel, Lee Jones, Mauro Carvalho Chehab, Russell King,
	Marek Behún, Pawan Gupta, Mike Leach, Andrew Donnellan,
	Kajol Jain, Chao Yu, Johan Hovold, Madhavan Srinivasan,
	Andreas Klinger, Josh Poimboeuf, David Sterba, Wim Van Sebroeck,
	Jens Axboe, netdev, Asutosh Das, linuxppc-dev

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(-)

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";
-- 
2.26.2


-- 
linux-i3c mailing list
linux-i3c@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-i3c

^ permalink raw reply related	[flat|nested] 7+ messages in thread

* Re: [PATCH 30/33] docs: ABI: cleanup several ABI documents
  2020-10-28 14:23 ` [PATCH 30/33] docs: ABI: cleanup several ABI documents Mauro Carvalho Chehab
@ 2020-10-29 14:42   ` Jonathan Cameron
  2020-10-29 15:29     ` kajoljain
  2020-10-30  6:33   ` Vaibhav Jain
                     ` (2 subsequent siblings)
  3 siblings, 1 reply; 7+ messages in thread
From: Jonathan Cameron @ 2020-10-29 14:42 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Andrew Lunn, Peter Chen, Linus Walleij, Jerry Snitselaar,
	dri-devel, Pavel Machek, Christian Gromm, ceph-devel, Kan Liang,
	Bart Van Assche, Michael Ellerman, linux-acpi, Danil Kipnis,
	Samuel Thibault, Guenter Roeck, Ohad Ben-Cohen, linux-pm,
	Simon Gaiser, Avri Altman, Alexander Antonov, Dan Murphy,
	Thomas Gleixner, Stefan Achatz, Konstantin Khlebnikov,
	Mathieu Malaterre, Jingoo Han, Rafael J. Wysocki, linux-kernel,
	Greg Kroah-Hartman, Hans Verkuil, Andrew Morton, Wu Hao,
	Peter Meerwald-Stadler, Linux Doc Mailing List, Mimi Zohar,
	Srinivas Kandagatla, Hanjun Guo, Oleh Kravchenko,
	Lars-Peter Clausen, Andy Shevchenko, Saravana Kannan,
	Gregory CLEMENT, Anton Vorontsov,
	Marek Marczykowski-Górecki, linux-stm32,
	Bartosz Golaszewski, Len Brown, Alexandre Torgue,
	Michael Hennerich, Suzuki K Poulose, coresight, linux-media,
	Frederic Barrat, Bjorn Helgaas, Jaegeuk Kim, Boris Ostrovsky,
	Mika Westerberg, linux-arm-kernel, Oded Gabbay, Tony Luck,
	Mathieu Poirier, Boris Brezillon, PrasannaKumar Muralidharan,
	linux-gpio, Dongsheng Yang, Roman Sudarikov, Jarkko Sakkinen,
	Maxime Coquelin, Vaibhav Jain, Pali Rohár, Heiner Kallweit,
	Gautham R. Shenoy, Cezary Rojewski, Mario Limonciello, linux-iio,
	Tom Rix, linux-fpga, Rasmus Villemoes, Jonas Meurer,
	Daniel Thompson, Florian Fainelli, Mark Gross, Jonathan Corbet,
	Ilya Dryomov, Jack Wang, Kees Cook, Mark Brown, Dan Williams,
	Kranthi Kuntala, Martin K. Petersen, Dmitry Torokhov,
	Sebastian Reichel, Colin Cross, Enric Balletbo i Serra,
	David S. Miller, Roger Pau Monné, Peter Zijlstra (Intel),
	linux-remoteproc, Bjorn Andersson, Paul Cercueil, linux-i3c,
	linux-f2fs-devel, Lee Jones, Russell King, Marek Behún,
	Pawan Gupta, Mike Leach, Andrew Donnellan, Kajol Jain, Chao Yu,
	Johan Hovold, Madhavan Srinivasan, Andreas Klinger,
	Josh Poimboeuf, David Sterba, Wim Van Sebroeck, Jens Axboe,
	netdev, Asutosh Das, linuxppc-dev

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";


-- 
linux-i3c mailing list
linux-i3c@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-i3c

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH 30/33] docs: ABI: cleanup several ABI documents
  2020-10-29 14:42   ` Jonathan Cameron
@ 2020-10-29 15:29     ` kajoljain
  2020-10-29 16:14       ` Oded Gabbay
  0 siblings, 1 reply; 7+ messages in thread
From: kajoljain @ 2020-10-29 15:29 UTC (permalink / raw)
  To: Jonathan Cameron, Mauro Carvalho Chehab
  Cc: Andrew Lunn, Peter Chen, Linus Walleij, Jerry Snitselaar,
	dri-devel, Pavel Machek, Christian Gromm, ceph-devel, Kan Liang,
	Bart Van Assche, Michael Ellerman, linux-acpi, Danil Kipnis,
	Samuel Thibault, Guenter Roeck, Ohad Ben-Cohen, linux-pm,
	Simon Gaiser, Avri Altman, Alexander Antonov, Dan Murphy,
	Thomas Gleixner, Stefan Achatz, Konstantin Khlebnikov,
	Mathieu Malaterre, Jingoo Han, Rafael J. Wysocki, linux-kernel,
	Greg Kroah-Hartman, Hans Verkuil, Andrew Morton, Wu Hao,
	Peter Meerwald-Stadler, Linux Doc Mailing List, Mimi Zohar,
	Srinivas Kandagatla, Hanjun Guo, Oleh Kravchenko,
	Lars-Peter Clausen, Andy Shevchenko, Saravana Kannan,
	Gregory CLEMENT, Anton Vorontsov,
	Marek Marczykowski-Górecki, linux-stm32,
	Bartosz Golaszewski, Len Brown, Alexandre Torgue,
	Michael Hennerich, Suzuki K Poulose, coresight, linux-media,
	Frederic Barrat, Bjorn Helgaas, Jaegeuk Kim, Boris Ostrovsky,
	Mika Westerberg, linux-arm-kernel, Oded Gabbay, Tony Luck,
	Mathieu Poirier, Boris Brezillon, PrasannaKumar Muralidharan,
	linux-gpio, Dongsheng Yang, Roman Sudarikov, Jarkko Sakkinen,
	Maxime Coquelin, Vaibhav Jain, Pali Rohár, Heiner Kallweit,
	Gautham R. Shenoy, Cezary Rojewski, Mario Limonciello, linux-iio,
	Tom Rix, linux-fpga, Rasmus Villemoes, Jonas Meurer,
	Daniel Thompson, Florian Fainelli, Mark Gross, Jonathan Corbet,
	Ilya Dryomov, Jack Wang, Kees Cook, Mark Brown, Dan Williams,
	Kranthi Kuntala, Martin K. Petersen, Dmitry Torokhov,
	Sebastian Reichel, Colin Cross, Enric Balletbo i Serra,
	David S. Miller, Roger Pau Monné, Peter Zijlstra (Intel),
	linux-remoteproc, Bjorn Andersson, Paul Cercueil, linux-i3c,
	linux-f2fs-devel, Lee Jones, Russell King, Marek Behún,
	Pawan Gupta, Mike Leach, Andrew Donnellan, Chao Yu, Johan Hovold,
	Madhavan Srinivasan, Andreas Klinger, Josh Poimboeuf,
	David Sterba, Wim Van Sebroeck, Jens Axboe, netdev, Asutosh Das,
	linuxppc-dev



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";
> 

-- 
linux-i3c mailing list
linux-i3c@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-i3c

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH 30/33] docs: ABI: cleanup several ABI documents
  2020-10-29 15:29     ` kajoljain
@ 2020-10-29 16:14       ` Oded Gabbay
  0 siblings, 0 replies; 7+ messages in thread
From: Oded Gabbay @ 2020-10-29 16:14 UTC (permalink / raw)
  To: kajoljain
  Cc: Andrew Lunn, Peter Chen, Linus Walleij, Jerry Snitselaar,
	Maling list - DRI developers, Pavel Machek, Christian Gromm,
	ceph-devel, Kan Liang, Bart Van Assche, Michael Ellerman,
	linux-acpi, Danil Kipnis, Samuel Thibault, Guenter Roeck,
	Ohad Ben-Cohen, linux-pm, Simon Gaiser, Avri Altman,
	Alexander Antonov, Dan Murphy, Thomas Gleixner, Stefan Achatz,
	Konstantin Khlebnikov, Mathieu Malaterre, Jingoo Han,
	Rafael J. Wysocki, Linux-Kernel@Vger. Kernel. Org,
	Greg Kroah-Hartman, Hans Verkuil, Andrew Morton, Wu Hao,
	Peter Meerwald-Stadler, Linux Doc Mailing List, Mimi Zohar,
	Srinivas Kandagatla, Hanjun Guo, Oleh Kravchenko,
	Lars-Peter Clausen, Andy Shevchenko, Saravana Kannan,
	Gregory CLEMENT, Anton Vorontsov,
	Marek Marczykowski-Górecki, linux-stm32,
	Bartosz Golaszewski, Len Brown, Alexandre Torgue,
	Michael Hennerich, Suzuki K Poulose, coresight,
	Linux Media Mailing List, Frederic Barrat, Bjorn Helgaas,
	Jaegeuk Kim, Boris Ostrovsky, Mika Westerberg,
	list@263.net:IOMMU DRIVERS
	<iommu@lists.linux-foundation.org>,
	Joerg Roedel <joro@8bytes.org>, ,
	Tony Luck, Mathieu Poirier, Boris Brezillon,
	PrasannaKumar Muralidharan, linux-gpio, Dongsheng Yang,
	Roman Sudarikov, Jarkko Sakkinen, Maxime Coquelin, Vaibhav Jain,
	Pali Rohár, Jonathan Cameron, Heiner Kallweit,
	Gautham R. Shenoy, Cezary Rojewski, Mario Limonciello, linux-iio,
	Tom Rix, linux-fpga, Rasmus Villemoes, Jonas Meurer,
	Daniel Thompson, Florian Fainelli, Mark Gross, Jonathan Corbet,
	Ilya Dryomov, Jack Wang, Kees Cook, Mark Brown, Dan Williams,
	Kranthi Kuntala, Martin K. Petersen, Dmitry Torokhov,
	Sebastian Reichel, Colin Cross, Enric Balletbo i Serra,
	David S. Miller, Roger Pau Monné, Peter Zijlstra (Intel),
	linux-remoteproc, Bjorn Andersson, Paul Cercueil, linux-i3c,
	linux-f2fs-devel, Lee Jones, Mauro Carvalho Chehab, Russell King,
	Marek Behún, Pawan Gupta, Mike Leach, Andrew Donnellan,
	Chao Yu, Johan Hovold, Madhavan Srinivasan, Andreas Klinger,
	Josh Poimboeuf, David Sterba, Wim Van Sebroeck, Jens Axboe,
	netdev, Asutosh Das, linuxppc-dev

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
> >> +            == =============================================
> >> +            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";
> >

-- 
linux-i3c mailing list
linux-i3c@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-i3c

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH 30/33] docs: ABI: cleanup several ABI documents
  2020-10-28 14:23 ` [PATCH 30/33] docs: ABI: cleanup several ABI documents Mauro Carvalho Chehab
  2020-10-29 14:42   ` Jonathan Cameron
@ 2020-10-30  6:33   ` Vaibhav Jain
  2020-10-30  7:52   ` Jinpu Wang
  2020-11-03 15:24   ` Bjorn Andersson
  3 siblings, 0 replies; 7+ messages in thread
From: Vaibhav Jain @ 2020-10-30  6:33 UTC (permalink / raw)
  To: Mauro Carvalho Chehab, Linux Doc Mailing List, Greg Kroah-Hartman
  Cc: Andrew Lunn, Peter Meerwald-Stadler, Peter Chen, Linus Walleij,
	Jerry Snitselaar, dri-devel, Barrat <fbarrat,
	Srinivas Kandagatla, Pavel Machek, Hanjun Guo, Christian Gromm,
	Oleh Kravchenko, Thomas Gleixner, Kan Liang, Frederic,
	Lars-Peter Clausen, Bart Van Assche, Saravana Kannan,
	Bartosz Golaszewski, Gregory CLEMENT, Anton Vorontsov,
	Marek Marczykowski-Górecki, linux-stm32, linux-acpi,
	Danil Kipnis, Samuel Thibault, Guenter Roeck, Wu Hao,
	Ohad Ben-Cohen, Alexandre Torgue, Michael Hennerich, linux-pm,
	coresight, linux-media, Simon Gaiser, Avri Altman, Dan Murphy,
	ceph-devel, Stefan Achatz, Konstantin Khlebnikov,
	Andy Shevchenko, Alexander Antonov, Mathieu Malaterre,
	Jingoo Han, Rafael J. Wysocki, linux-kernel, Hans Verkuil,
	Andrew Morton, Len Brown, Mimi Zohar, Suzuki K Poulose

Mauro Carvalho Chehab <mchehab+huawei@kernel.org> writes:

> 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>

<snip>
> 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
<snip>

Thanks,

I am fine with proposed changes to sysfs-bus-papr-pmem.

Acked-by: Vaibhav Jain <vaibhav@linux.ibm.com> # for sysfs-bus-papr-pmem


-- 
linux-i3c mailing list
linux-i3c@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-i3c

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH 30/33] docs: ABI: cleanup several ABI documents
  2020-10-28 14:23 ` [PATCH 30/33] docs: ABI: cleanup several ABI documents Mauro Carvalho Chehab
  2020-10-29 14:42   ` Jonathan Cameron
  2020-10-30  6:33   ` Vaibhav Jain
@ 2020-10-30  7:52   ` Jinpu Wang
  2020-11-03 15:24   ` Bjorn Andersson
  3 siblings, 0 replies; 7+ messages in thread
From: Jinpu Wang @ 2020-10-30  7:52 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Andrew Lunn, Peter Chen, Linus Walleij, Jerry Snitselaar,
	dri-devel, Pavel Machek, Christian Gromm, ceph-devel, Kan Liang,
	Bart Van Assche, Michael Ellerman, linux-acpi, Danil Kipnis,
	Samuel Thibault, Guenter Roeck, Ohad Ben-Cohen, linux-pm,
	Simon Gaiser, Avri Altman, Alexander Antonov, Dan Murphy,
	Thomas Gleixner, Stefan Achatz, Konstantin Khlebnikov,
	Mathieu Malaterre, Jingoo Han, Rafael J. Wysocki, linux-kernel,
	Greg Kroah-Hartman, Hans Verkuil, Andrew Morton, Wu Hao,
	Peter Meerwald-Stadler, Linux Doc Mailing List, Mimi Zohar,
	Srinivas Kandagatla, Hanjun Guo, Oleh Kravchenko,
	Lars-Peter Clausen, Andy Shevchenko, Saravana Kannan,
	Gregory CLEMENT, Anton Vorontsov,
	Marek Marczykowski-Górecki, linux-stm32,
	Bartosz Golaszewski, Len Brown, Alexandre Torgue,
	Michael Hennerich, Suzuki K Poulose, coresight, linux-media,
	Frederic Barrat, Bjorn Helgaas, Jaegeuk Kim, Boris Ostrovsky,
	Mika Westerberg, linux-arm-kernel, Oded Gabbay, Tony Luck,
	Mathieu Poirier, Boris Brezillon, PrasannaKumar Muralidharan,
	linux-gpio, Dongsheng Yang, Roman Sudarikov, Jarkko Sakkinen,
	Maxime Coquelin, Vaibhav Jain, Pali Rohár, Jonathan Cameron,
	Heiner Kallweit, Gautham R. Shenoy, Cezary Rojewski,
	Mario Limonciello, linux-iio, Tom Rix, linux-fpga,
	Rasmus Villemoes, Jonas Meurer, Daniel Thompson,
	Florian Fainelli, Mark Gross, Jonathan Corbet, Ilya Dryomov,
	Kees Cook, Mark Brown, Dan Williams, Kranthi Kuntala,
	Martin K. Petersen, Dmitry Torokhov, Sebastian Reichel,
	Colin Cross, Enric Balletbo i Serra, David S. Miller,
	Roger Pau Monné, Peter Zijlstra (Intel),
	linux-remoteproc, Bjorn Andersson, Paul Cercueil, linux-i3c,
	linux-f2fs-devel, Lee Jones, Russell King, Marek Behún,
	Pawan Gupta, Mike Leach, Andrew Donnellan, Kajol Jain, Chao Yu,
	Johan Hovold, Madhavan Srinivasan, Andreas Klinger,
	Josh Poimboeuf, David Sterba, Wim Van Sebroeck, Jens Axboe,
	netdev, Asutosh Das, linuxppc-dev

On Wed, Oct 28, 2020 at 3:23 PM 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>
> ---
>  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 +-
For rnbd change looks good to me, thanks!
Acked-by: Jack Wang <jinpu.wang@cloud.ionos.com> #rnbd


> 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";

> --
> 2.26.2
>

-- 
linux-i3c mailing list
linux-i3c@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-i3c

^ permalink raw reply	[flat|nested] 7+ messages in thread

* Re: [PATCH 30/33] docs: ABI: cleanup several ABI documents
  2020-10-28 14:23 ` [PATCH 30/33] docs: ABI: cleanup several ABI documents Mauro Carvalho Chehab
                     ` (2 preceding siblings ...)
  2020-10-30  7:52   ` Jinpu Wang
@ 2020-11-03 15:24   ` Bjorn Andersson
  3 siblings, 0 replies; 7+ messages in thread
From: Bjorn Andersson @ 2020-11-03 15:24 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: linux-stm32, Linux Doc Mailing List, linux-iio, netdev,
	coresight, linux-pm, linux-remoteproc, linux-kernel, dri-devel,
	linux-f2fs-devel, linux-acpi, linux-gpio, linux-i3c,
	linuxppc-dev, linux-fpga, linux-arm-kernel, linux-media

On Wed 28 Oct 09:23 CDT 2020, Mauro Carvalho Chehab wrote:
[..]
>  .../ABI/testing/sysfs-class-remoteproc        |  14 +-

for this:

Acked-by: Bjorn Andersson <bjorn.andersson@linaro.org>

Thanks,
Bjorn

-- 
linux-i3c mailing list
linux-i3c@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-i3c

^ permalink raw reply	[flat|nested] 7+ messages in thread

end of thread, other threads:[~2020-11-03 18:07 UTC | newest]

Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
     [not found] <cover.1603893146.git.mchehab+huawei@kernel.org>
2020-10-28 14:23 ` [PATCH 30/33] docs: ABI: cleanup several ABI documents Mauro Carvalho Chehab
2020-10-29 14:42   ` Jonathan Cameron
2020-10-29 15:29     ` kajoljain
2020-10-29 16:14       ` Oded Gabbay
2020-10-30  6:33   ` Vaibhav Jain
2020-10-30  7:52   ` Jinpu Wang
2020-11-03 15:24   ` Bjorn Andersson

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).