[PATCH 00/10] Add all documentation files to an html/pdf produced book

[PATCH 00/10] Add all documentation files to an html/pdf produced book

[Mauro Carvalho Chehab]

Despite having converted almost all files to ReST at the main Documentation/
directory, they're still not included to any book. Also, after all those years
after migrated to ReST as the official documentation format, there are still
a lot of files using plain TXT files, with random internal formatting.

As it will likely require a lot more years to get everything converted,
let's add index.rst files to Documentation/* subdirs, with a text_files.rst
including all plain txt files as literal includes.

That ensures that the html output will contain the entire Linux Kernel
documentation.

Also, a few of the ReST files at the Documentation/*.txt are now
producing errors/warnings, as some patch broke its ReST format.

As keeping them as txt files makes harder to ensure that they'll be built
with Sphinx, let's place everything inside an "other" book, renaming them
to *.rst, in order to let Sphinx build them.

We could later move the files to a better book, but that will require some
time and patience, in order to ensure that they'll all be placed at their
rightful place.

It should be noticed that 3 files from the main Documentation/ dir are still
kept with *.txt suffix:

1) The logo.txt file is not really part of the Kernel documentation. It
just adds some documentation to the logo.gif file. So, leave it as-is;

2) The files atomic_t.txt and memory-barriers.txt aren't at ReST format.
Those got just moved to the Documentation/other/ directory. The rationale
is that the attempts to convert them to ReST found resistance from developers
whose maintain them. So, keep them as plain old text files, adding them
to the book via literal includes, just like the other plain txt files.

Keeping plain txt files is far from being perfect, but at least
now the written Kernel documentation will be available at html and pdf
formats.

Those patches are on my development tree at:
	https://git.linuxtv.org/mchehab/experimental.git/log/?h=all_docs_to_output


PS.: 

devicetree and ABI files are still not produced at Documentation/output.
Supporting those would likely be better served by some scripting.

Mauro Carvalho Chehab (10):
  docs: DMA-API-HOWTO: add a missing "="
  docs: atomic_bitops.txt: add a title for this document
  docs: clearing-warn-once.txt: add a title for this document
  docs: ntb.txt: use Sphinx notation for the two ascii figures
  docs: unaligned-memory-access.txt: use a lowercase title
  docs: video-output.txt: convert it to ReST format
  docs: Add all txt files to documentation
  docs: ntb.rst: add blank lines to clean up some Sphinx warnings
  docs: speculation.rst: mark example blocks as such
  docs: add plain text files to ReST output from  subdirs

 Documentation/EDID/index.rst                  |  15 ++
 Documentation/EDID/text_files.rst             |   6 +
 Documentation/PCI/index.rst                   |  15 ++
 Documentation/PCI/text_files.rst              |  72 +++++
 Documentation/RCU/index.rst                   |  15 ++
 Documentation/RCU/text_files.rst              |  96 +++++++
 Documentation/accounting/index.rst            |  15 ++
 Documentation/accounting/text_files.rst       |  30 +++
 Documentation/acpi/index.rst                  |  15 ++
 Documentation/acpi/text_files.rst             | 138 ++++++++++
 Documentation/aoe/index.rst                   |  15 ++
 Documentation/aoe/text_files.rst              |  18 ++
 Documentation/arm/index.rst                   |  21 ++
 Documentation/arm/text_files.rst              | 198 ++++++++++++++
 Documentation/arm64/index.rst                 |  15 ++
 Documentation/arm64/text_files.rst            |  72 +++++
 Documentation/auxdisplay/index.rst            |  15 ++
 Documentation/auxdisplay/text_files.rst       |   6 +
 Documentation/backlight/index.rst             |  15 ++
 Documentation/backlight/text_files.rst        |   6 +
 Documentation/block/index.rst                 |  15 ++
 Documentation/block/text_files.rst            |  96 +++++++
 Documentation/blockdev/index.rst              |  15 ++
 Documentation/blockdev/text_files.rst         |  42 +++
 Documentation/bus-devices/index.rst           |  15 ++
 Documentation/bus-devices/text_files.rst      |   6 +
 Documentation/cdrom/index.rst                 |  15 ++
 Documentation/cdrom/text_files.rst            |   6 +
 Documentation/cgroup-v1/index.rst             |  15 ++
 Documentation/cgroup-v1/text_files.rst        |  78 ++++++
 Documentation/cma/index.rst                   |  15 ++
 Documentation/cma/text_files.rst              |   6 +
 Documentation/connector/index.rst             |  15 ++
 Documentation/connector/text_files.rst        |   6 +
 Documentation/console/index.rst               |  15 ++
 Documentation/console/text_files.rst          |   6 +
 Documentation/cpu-freq/index.rst              |  15 ++
 Documentation/cpu-freq/text_files.rst         |  42 +++
 Documentation/device-mapper/index.rst         |  15 ++
 Documentation/device-mapper/text_files.rst    | 168 ++++++++++++
 Documentation/driver-model/index.rst          |  15 ++
 Documentation/driver-model/text_files.rst     |  60 +++++
 Documentation/early-userspace/index.rst       |  15 ++
 Documentation/early-userspace/text_files.rst  |   6 +
 Documentation/extcon/index.rst                |  15 ++
 Documentation/extcon/text_files.rst           |   6 +
 Documentation/fault-injection/index.rst       |  15 ++
 Documentation/fault-injection/text_files.rst  |  24 ++
 Documentation/fb/index.rst                    |  15 ++
 Documentation/fb/text_files.rst               | 204 ++++++++++++++
 Documentation/features/index.rst              |  15 ++
 Documentation/features/text_files.rst         | 252 ++++++++++++++++++
 Documentation/fmc/index.rst                   |  15 ++
 Documentation/fmc/text_files.rst              |  60 +++++
 Documentation/fpga/index.rst                  |  15 ++
 Documentation/fpga/text_files.rst             |   6 +
 Documentation/gpio/index.rst                  |  15 ++
 Documentation/gpio/text_files.rst             |   6 +
 Documentation/hid/index.rst                   |  15 ++
 Documentation/hid/text_files.rst              |  42 +++
 Documentation/hwmon/index.rst                 |  15 ++
 Documentation/hwmon/text_files.rst            |   6 +
 Documentation/ia64/index.rst                  |  15 ++
 Documentation/ia64/text_files.rst             |  48 ++++
 Documentation/ide/index.rst                   |  15 ++
 Documentation/ide/text_files.rst              |  18 ++
 Documentation/iio/index.rst                   |  15 ++
 Documentation/iio/text_files.rst              |  12 +
 Documentation/index.rst                       |  90 +++++++
 Documentation/infiniband/index.rst            |  15 ++
 Documentation/infiniband/text_files.rst       |  42 +++
 Documentation/ioctl/index.rst                 |  15 ++
 Documentation/ioctl/text_files.rst            |  30 +++
 Documentation/kbuild/index.rst                |  15 ++
 Documentation/kbuild/text_files.rst           |  42 +++
 Documentation/kdump/index.rst                 |  15 ++
 Documentation/kdump/text_files.rst            |  18 ++
 Documentation/laptops/index.rst               |  16 ++
 Documentation/laptops/text_files.rst          |  42 +++
 Documentation/leds/index.rst                  |  15 ++
 Documentation/leds/text_files.rst             |  84 ++++++
 Documentation/lightnvm/index.rst              |  15 ++
 Documentation/lightnvm/text_files.rst         |   6 +
 Documentation/livepatch/index.rst             |  15 ++
 Documentation/livepatch/text_files.rst        |  30 +++
 Documentation/locking/index.rst               |  15 ++
 Documentation/locking/text_files.rst          |  48 ++++
 Documentation/m68k/index.rst                  |  15 ++
 Documentation/m68k/text_files.rst             |   6 +
 Documentation/md/index.rst                    |  15 ++
 Documentation/md/text_files.rst               |  18 ++
 Documentation/memory-devices/index.rst        |  15 ++
 Documentation/memory-devices/text_files.rst   |   6 +
 Documentation/mic/index.rst                   |  15 ++
 Documentation/mic/text_files.rst              |  12 +
 Documentation/mmc/index.rst                   |  15 ++
 Documentation/mmc/text_files.rst              |  24 ++
 Documentation/mtd/index.rst                   |  15 ++
 Documentation/mtd/text_files.rst              |  18 ++
 Documentation/namespaces/index.rst            |  15 ++
 Documentation/namespaces/text_files.rst       |  12 +
 Documentation/netlabel/index.rst              |  15 ++
 Documentation/netlabel/text_files.rst         |  24 ++
 Documentation/nfc/index.rst                   |  15 ++
 Documentation/nfc/text_files.rst              |  12 +
 Documentation/nvdimm/index.rst                |  15 ++
 Documentation/nvdimm/text_files.rst           |  18 ++
 Documentation/nvmem/index.rst                 |  15 ++
 Documentation/nvmem/text_files.rst            |   6 +
 .../DMA-API-HOWTO.rst}                        |   2 +-
 .../{DMA-API.txt => other/DMA-API.rst}        |   0
 .../DMA-ISA-LPC.rst}                          |   0
 .../DMA-attributes.rst}                       |   0
 Documentation/{IPMI.txt => other/IPMI.rst}    |   0
 .../IRQ-affinity.rst}                         |   0
 .../{IRQ-domain.txt => other/IRQ-domain.rst}  |   0
 Documentation/{IRQ.txt => other/IRQ.rst}      |   0
 .../Intel-IOMMU.rst}                          |   0
 Documentation/{SAK.txt => other/SAK.rst}      |   0
 Documentation/{SM501.txt => other/SM501.rst}  |   0
 .../atomic_bitops.rst}                        |   6 +-
 Documentation/{ => other}/atomic_t.txt        |   0
 .../{bt8xxgpio.txt => other/bt8xxgpio.rst}    |   0
 .../{btmrvl.txt => other/btmrvl.rst}          |   0
 .../bus-virt-phys-mapping.rst}                |   0
 .../clearing-warn-once.rst}                   |   2 +
 .../{cpu-load.txt => other/cpu-load.rst}      |   0
 .../cputopology.rst}                          |   0
 Documentation/{crc32.txt => other/crc32.rst}  |   0
 .../{dcdbas.txt => other/dcdbas.rst}          |   0
 .../debugging-modules.rst}                    |   0
 .../debugging-via-ohci1394.rst}               |   0
 .../{dell_rbu.txt => other/dell_rbu.rst}      |   0
 .../{digsig.txt => other/digsig.rst}          |   0
 .../{efi-stub.txt => other/efi-stub.rst}      |   0
 Documentation/{eisa.txt => other/eisa.rst}    |   0
 .../futex-requeue-pi.rst}                     |   0
 .../gcc-plugins.rst}                          |   0
 .../{highuid.txt => other/highuid.rst}        |   0
 .../{hw_random.txt => other/hw_random.rst}    |   0
 .../{hwspinlock.txt => other/hwspinlock.rst}  |   0
 Documentation/other/index.rst                 | 100 +++++++
 .../{intel_txt.txt => other/intel_txt.rst}    |   0
 .../{io-mapping.txt => other/io-mapping.rst}  |   0
 .../io_ordering.rst}                          |   0
 .../{iostats.txt => other/iostats.rst}        |   0
 .../irqflags-tracing.rst}                     |   0
 Documentation/{isa.txt => other/isa.rst}      |   0
 .../{isapnp.txt => other/isapnp.rst}          |   0
 .../kernel-per-CPU-kthreads.rst}              |   0
 .../{kobject.txt => other/kobject.rst}        |   0
 .../{kprobes.txt => other/kprobes.rst}        |   0
 Documentation/{kref.txt => other/kref.rst}    |   0
 Documentation/{ldm.txt => other/ldm.rst}      |   0
 .../lockup-watchdogs.rst}                     |   0
 Documentation/{lsm.txt => other/lsm.rst}      |   0
 Documentation/{lzo.txt => other/lzo.rst}      |   0
 .../{mailbox.txt => other/mailbox.rst}        |   0
 Documentation/{ => other}/memory-barriers.txt |   0
 .../men-chameleon-bus.rst}                    |   0
 .../{nommu-mmap.txt => other/nommu-mmap.rst}  |   0
 Documentation/{ntb.txt => other/ntb.rst}      |  14 +-
 .../{numastat.txt => other/numastat.rst}      |   0
 .../{padata.txt => other/padata.rst}          |   0
 .../parport-lowlevel.rst}                     |   0
 .../percpu-rw-semaphore.rst}                  |   0
 Documentation/{phy.txt => other/phy.rst}      |   0
 .../{pi-futex.txt => other/pi-futex.rst}      |   0
 Documentation/{pnp.txt => other/pnp.rst}      |   0
 .../preempt-locking.rst}                      |   0
 Documentation/{pwm.txt => other/pwm.rst}      |   0
 .../{rbtree.txt => other/rbtree.rst}          |   0
 .../{remoteproc.txt => other/remoteproc.rst}  |   0
 .../{rfkill.txt => other/rfkill.rst}          |   0
 .../robust-futex-ABI.rst}                     |   0
 .../robust-futexes.rst}                       |   0
 Documentation/{rpmsg.txt => other/rpmsg.rst}  |   0
 Documentation/{rtc.txt => other/rtc.rst}      |   0
 .../{sgi-ioc4.txt => other/sgi-ioc4.rst}      |   0
 .../{siphash.txt => other/siphash.rst}        |   0
 .../smsc_ece1099.rst}                         |   0
 .../speculation.rst}                          |   8 +-
 .../static-keys.rst}                          |   0
 Documentation/{svga.txt => other/svga.rst}    |   0
 .../{switchtec.txt => other/switchtec.rst}    |   0
 .../{sync_file.txt => other/sync_file.rst}    |   0
 Documentation/{tee.txt => other/tee.rst}      |   0
 Documentation/other/text_files.rst            |  12 +
 .../this_cpu_ops.rst}                         |   0
 .../unaligned-memory-access.rst}              |   2 +-
 .../vfio-mediated-device.rst}                 |   0
 Documentation/{vfio.txt => other/vfio.rst}    |   0
 Documentation/other/video-output.rst          |  34 +++
 .../{xillybus.txt => other/xillybus.rst}      |   0
 Documentation/{xz.txt => other/xz.rst}        |   0
 Documentation/{zorro.txt => other/zorro.rst}  |   0
 Documentation/pcmcia/index.rst                |  15 ++
 Documentation/pcmcia/text_files.rst           |  24 ++
 Documentation/perf/index.rst                  |  15 ++
 Documentation/perf/text_files.rst             |  42 +++
 Documentation/phy/index.rst                   |  15 ++
 Documentation/phy/text_files.rst              |   6 +
 Documentation/platform/index.rst              |  15 ++
 Documentation/platform/text_files.rst         |   6 +
 Documentation/power/index.rst                 |  15 ++
 Documentation/power/text_files.rst            | 162 +++++++++++
 Documentation/powerpc/index.rst               |  16 ++
 Documentation/powerpc/text_files.rst          | 102 +++++++
 Documentation/pps/index.rst                   |  15 ++
 Documentation/pps/text_files.rst              |   6 +
 Documentation/pti/index.rst                   |  15 ++
 Documentation/pti/text_files.rst              |   6 +
 Documentation/ptp/index.rst                   |  15 ++
 Documentation/ptp/text_files.rst              |   6 +
 Documentation/rapidio/index.rst               |  15 ++
 Documentation/rapidio/text_files.rst          |  30 +++
 Documentation/riscv/index.rst                 |  15 ++
 Documentation/riscv/text_files.rst            |   6 +
 Documentation/s390/index.rst                  |  15 ++
 Documentation/s390/text_files.rst             |  60 +++++
 Documentation/scheduler/index.rst             |  15 ++
 Documentation/scheduler/text_files.rst        |  60 +++++
 Documentation/scsi/index.rst                  |  15 ++
 Documentation/scsi/text_files.rst             | 246 +++++++++++++++++
 Documentation/serial/index.rst                |  15 ++
 Documentation/serial/text_files.rst           |  30 +++
 Documentation/sparc/index.rst                 |  15 ++
 Documentation/sparc/text_files.rst            |  24 ++
 Documentation/sphinx/index.rst                |  15 ++
 Documentation/sphinx/text_files.rst           |   6 +
 Documentation/sysctl/index.rst                |  15 ++
 Documentation/sysctl/text_files.rst           |  42 +++
 Documentation/target/index.rst                |  15 ++
 Documentation/target/text_files.rst           |  12 +
 Documentation/thermal/index.rst               |  15 ++
 Documentation/thermal/text_files.rst          |  24 ++
 Documentation/timers/index.rst                |  15 ++
 Documentation/timers/text_files.rst           |  36 +++
 Documentation/usb/index.rst                   |  15 ++
 Documentation/usb/text_files.rst              | 138 ++++++++++
 Documentation/video-output.txt                |  34 ---
 Documentation/virtual/index.rst               |  17 ++
 Documentation/virtual/text_files.rst          | 150 +++++++++++
 Documentation/watchdog/index.rst              |  15 ++
 Documentation/watchdog/text_files.rst         |  54 ++++
 Documentation/x86/index.rst                   |  15 ++
 Documentation/x86/text_files.rst              | 132 +++++++++
 Documentation/xilinx/index.rst                |  15 ++
 Documentation/xilinx/text_files.rst           |   6 +
 Documentation/xtensa/index.rst                |  15 ++
 Documentation/xtensa/text_files.rst           |  18 ++
 251 files changed, 5262 insertions(+), 47 deletions(-)
 create mode 100644 Documentation/EDID/index.rst
 create mode 100644 Documentation/EDID/text_files.rst
 create mode 100644 Documentation/PCI/index.rst
 create mode 100644 Documentation/PCI/text_files.rst
 create mode 100644 Documentation/RCU/index.rst
 create mode 100644 Documentation/RCU/text_files.rst
 create mode 100644 Documentation/accounting/index.rst
 create mode 100644 Documentation/accounting/text_files.rst
 create mode 100644 Documentation/acpi/index.rst
 create mode 100644 Documentation/acpi/text_files.rst
 create mode 100644 Documentation/aoe/index.rst
 create mode 100644 Documentation/aoe/text_files.rst
 create mode 100644 Documentation/arm/index.rst
 create mode 100644 Documentation/arm/text_files.rst
 create mode 100644 Documentation/arm64/index.rst
 create mode 100644 Documentation/arm64/text_files.rst
 create mode 100644 Documentation/auxdisplay/index.rst
 create mode 100644 Documentation/auxdisplay/text_files.rst
 create mode 100644 Documentation/backlight/index.rst
 create mode 100644 Documentation/backlight/text_files.rst
 create mode 100644 Documentation/block/index.rst
 create mode 100644 Documentation/block/text_files.rst
 create mode 100644 Documentation/blockdev/index.rst
 create mode 100644 Documentation/blockdev/text_files.rst
 create mode 100644 Documentation/bus-devices/index.rst
 create mode 100644 Documentation/bus-devices/text_files.rst
 create mode 100644 Documentation/cdrom/index.rst
 create mode 100644 Documentation/cdrom/text_files.rst
 create mode 100644 Documentation/cgroup-v1/index.rst
 create mode 100644 Documentation/cgroup-v1/text_files.rst
 create mode 100644 Documentation/cma/index.rst
 create mode 100644 Documentation/cma/text_files.rst
 create mode 100644 Documentation/connector/index.rst
 create mode 100644 Documentation/connector/text_files.rst
 create mode 100644 Documentation/console/index.rst
 create mode 100644 Documentation/console/text_files.rst
 create mode 100644 Documentation/cpu-freq/index.rst
 create mode 100644 Documentation/cpu-freq/text_files.rst
 create mode 100644 Documentation/device-mapper/index.rst
 create mode 100644 Documentation/device-mapper/text_files.rst
 create mode 100644 Documentation/driver-model/index.rst
 create mode 100644 Documentation/driver-model/text_files.rst
 create mode 100644 Documentation/early-userspace/index.rst
 create mode 100644 Documentation/early-userspace/text_files.rst
 create mode 100644 Documentation/extcon/index.rst
 create mode 100644 Documentation/extcon/text_files.rst
 create mode 100644 Documentation/fault-injection/index.rst
 create mode 100644 Documentation/fault-injection/text_files.rst
 create mode 100644 Documentation/fb/index.rst
 create mode 100644 Documentation/fb/text_files.rst
 create mode 100644 Documentation/features/index.rst
 create mode 100644 Documentation/features/text_files.rst
 create mode 100644 Documentation/fmc/index.rst
 create mode 100644 Documentation/fmc/text_files.rst
 create mode 100644 Documentation/fpga/index.rst
 create mode 100644 Documentation/fpga/text_files.rst
 create mode 100644 Documentation/gpio/index.rst
 create mode 100644 Documentation/gpio/text_files.rst
 create mode 100644 Documentation/hid/index.rst
 create mode 100644 Documentation/hid/text_files.rst
 create mode 100644 Documentation/hwmon/index.rst
 create mode 100644 Documentation/hwmon/text_files.rst
 create mode 100644 Documentation/ia64/index.rst
 create mode 100644 Documentation/ia64/text_files.rst
 create mode 100644 Documentation/ide/index.rst
 create mode 100644 Documentation/ide/text_files.rst
 create mode 100644 Documentation/iio/index.rst
 create mode 100644 Documentation/iio/text_files.rst
 create mode 100644 Documentation/infiniband/index.rst
 create mode 100644 Documentation/infiniband/text_files.rst
 create mode 100644 Documentation/ioctl/index.rst
 create mode 100644 Documentation/ioctl/text_files.rst
 create mode 100644 Documentation/kbuild/index.rst
 create mode 100644 Documentation/kbuild/text_files.rst
 create mode 100644 Documentation/kdump/index.rst
 create mode 100644 Documentation/kdump/text_files.rst
 create mode 100644 Documentation/laptops/index.rst
 create mode 100644 Documentation/laptops/text_files.rst
 create mode 100644 Documentation/leds/index.rst
 create mode 100644 Documentation/leds/text_files.rst
 create mode 100644 Documentation/lightnvm/index.rst
 create mode 100644 Documentation/lightnvm/text_files.rst
 create mode 100644 Documentation/livepatch/index.rst
 create mode 100644 Documentation/livepatch/text_files.rst
 create mode 100644 Documentation/locking/index.rst
 create mode 100644 Documentation/locking/text_files.rst
 create mode 100644 Documentation/m68k/index.rst
 create mode 100644 Documentation/m68k/text_files.rst
 create mode 100644 Documentation/md/index.rst
 create mode 100644 Documentation/md/text_files.rst
 create mode 100644 Documentation/memory-devices/index.rst
 create mode 100644 Documentation/memory-devices/text_files.rst
 create mode 100644 Documentation/mic/index.rst
 create mode 100644 Documentation/mic/text_files.rst
 create mode 100644 Documentation/mmc/index.rst
 create mode 100644 Documentation/mmc/text_files.rst
 create mode 100644 Documentation/mtd/index.rst
 create mode 100644 Documentation/mtd/text_files.rst
 create mode 100644 Documentation/namespaces/index.rst
 create mode 100644 Documentation/namespaces/text_files.rst
 create mode 100644 Documentation/netlabel/index.rst
 create mode 100644 Documentation/netlabel/text_files.rst
 create mode 100644 Documentation/nfc/index.rst
 create mode 100644 Documentation/nfc/text_files.rst
 create mode 100644 Documentation/nvdimm/index.rst
 create mode 100644 Documentation/nvdimm/text_files.rst
 create mode 100644 Documentation/nvmem/index.rst
 create mode 100644 Documentation/nvmem/text_files.rst
 rename Documentation/{DMA-API-HOWTO.txt => other/DMA-API-HOWTO.rst} (99%)
 rename Documentation/{DMA-API.txt => other/DMA-API.rst} (100%)
 rename Documentation/{DMA-ISA-LPC.txt => other/DMA-ISA-LPC.rst} (100%)
 rename Documentation/{DMA-attributes.txt => other/DMA-attributes.rst} (100%)
 rename Documentation/{IPMI.txt => other/IPMI.rst} (100%)
 rename Documentation/{IRQ-affinity.txt => other/IRQ-affinity.rst} (100%)
 rename Documentation/{IRQ-domain.txt => other/IRQ-domain.rst} (100%)
 rename Documentation/{IRQ.txt => other/IRQ.rst} (100%)
 rename Documentation/{Intel-IOMMU.txt => other/Intel-IOMMU.rst} (100%)
 rename Documentation/{SAK.txt => other/SAK.rst} (100%)
 rename Documentation/{SM501.txt => other/SM501.rst} (100%)
 rename Documentation/{atomic_bitops.txt => other/atomic_bitops.rst} (97%)
 rename Documentation/{ => other}/atomic_t.txt (100%)
 rename Documentation/{bt8xxgpio.txt => other/bt8xxgpio.rst} (100%)
 rename Documentation/{btmrvl.txt => other/btmrvl.rst} (100%)
 rename Documentation/{bus-virt-phys-mapping.txt => other/bus-virt-phys-mapping.rst} (100%)
 rename Documentation/{clearing-warn-once.txt => other/clearing-warn-once.rst} (85%)
 rename Documentation/{cpu-load.txt => other/cpu-load.rst} (100%)
 rename Documentation/{cputopology.txt => other/cputopology.rst} (100%)
 rename Documentation/{crc32.txt => other/crc32.rst} (100%)
 rename Documentation/{dcdbas.txt => other/dcdbas.rst} (100%)
 rename Documentation/{debugging-modules.txt => other/debugging-modules.rst} (100%)
 rename Documentation/{debugging-via-ohci1394.txt => other/debugging-via-ohci1394.rst} (100%)
 rename Documentation/{dell_rbu.txt => other/dell_rbu.rst} (100%)
 rename Documentation/{digsig.txt => other/digsig.rst} (100%)
 rename Documentation/{efi-stub.txt => other/efi-stub.rst} (100%)
 rename Documentation/{eisa.txt => other/eisa.rst} (100%)
 rename Documentation/{futex-requeue-pi.txt => other/futex-requeue-pi.rst} (100%)
 rename Documentation/{gcc-plugins.txt => other/gcc-plugins.rst} (100%)
 rename Documentation/{highuid.txt => other/highuid.rst} (100%)
 rename Documentation/{hw_random.txt => other/hw_random.rst} (100%)
 rename Documentation/{hwspinlock.txt => other/hwspinlock.rst} (100%)
 create mode 100644 Documentation/other/index.rst
 rename Documentation/{intel_txt.txt => other/intel_txt.rst} (100%)
 rename Documentation/{io-mapping.txt => other/io-mapping.rst} (100%)
 rename Documentation/{io_ordering.txt => other/io_ordering.rst} (100%)
 rename Documentation/{iostats.txt => other/iostats.rst} (100%)
 rename Documentation/{irqflags-tracing.txt => other/irqflags-tracing.rst} (100%)
 rename Documentation/{isa.txt => other/isa.rst} (100%)
 rename Documentation/{isapnp.txt => other/isapnp.rst} (100%)
 rename Documentation/{kernel-per-CPU-kthreads.txt => other/kernel-per-CPU-kthreads.rst} (100%)
 rename Documentation/{kobject.txt => other/kobject.rst} (100%)
 rename Documentation/{kprobes.txt => other/kprobes.rst} (100%)
 rename Documentation/{kref.txt => other/kref.rst} (100%)
 rename Documentation/{ldm.txt => other/ldm.rst} (100%)
 rename Documentation/{lockup-watchdogs.txt => other/lockup-watchdogs.rst} (100%)
 rename Documentation/{lsm.txt => other/lsm.rst} (100%)
 rename Documentation/{lzo.txt => other/lzo.rst} (100%)
 rename Documentation/{mailbox.txt => other/mailbox.rst} (100%)
 rename Documentation/{ => other}/memory-barriers.txt (100%)
 rename Documentation/{men-chameleon-bus.txt => other/men-chameleon-bus.rst} (100%)
 rename Documentation/{nommu-mmap.txt => other/nommu-mmap.rst} (100%)
 rename Documentation/{ntb.txt => other/ntb.rst} (98%)
 rename Documentation/{numastat.txt => other/numastat.rst} (100%)
 rename Documentation/{padata.txt => other/padata.rst} (100%)
 rename Documentation/{parport-lowlevel.txt => other/parport-lowlevel.rst} (100%)
 rename Documentation/{percpu-rw-semaphore.txt => other/percpu-rw-semaphore.rst} (100%)
 rename Documentation/{phy.txt => other/phy.rst} (100%)
 rename Documentation/{pi-futex.txt => other/pi-futex.rst} (100%)
 rename Documentation/{pnp.txt => other/pnp.rst} (100%)
 rename Documentation/{preempt-locking.txt => other/preempt-locking.rst} (100%)
 rename Documentation/{pwm.txt => other/pwm.rst} (100%)
 rename Documentation/{rbtree.txt => other/rbtree.rst} (100%)
 rename Documentation/{remoteproc.txt => other/remoteproc.rst} (100%)
 rename Documentation/{rfkill.txt => other/rfkill.rst} (100%)
 rename Documentation/{robust-futex-ABI.txt => other/robust-futex-ABI.rst} (100%)
 rename Documentation/{robust-futexes.txt => other/robust-futexes.rst} (100%)
 rename Documentation/{rpmsg.txt => other/rpmsg.rst} (100%)
 rename Documentation/{rtc.txt => other/rtc.rst} (100%)
 rename Documentation/{sgi-ioc4.txt => other/sgi-ioc4.rst} (100%)
 rename Documentation/{siphash.txt => other/siphash.rst} (100%)
 rename Documentation/{smsc_ece1099.txt => other/smsc_ece1099.rst} (100%)
 rename Documentation/{speculation.txt => other/speculation.rst} (95%)
 rename Documentation/{static-keys.txt => other/static-keys.rst} (100%)
 rename Documentation/{svga.txt => other/svga.rst} (100%)
 rename Documentation/{switchtec.txt => other/switchtec.rst} (100%)
 rename Documentation/{sync_file.txt => other/sync_file.rst} (100%)
 rename Documentation/{tee.txt => other/tee.rst} (100%)
 create mode 100644 Documentation/other/text_files.rst
 rename Documentation/{this_cpu_ops.txt => other/this_cpu_ops.rst} (100%)
 rename Documentation/{unaligned-memory-access.txt => other/unaligned-memory-access.rst} (99%)
 rename Documentation/{vfio-mediated-device.txt => other/vfio-mediated-device.rst} (100%)
 rename Documentation/{vfio.txt => other/vfio.rst} (100%)
 create mode 100644 Documentation/other/video-output.rst
 rename Documentation/{xillybus.txt => other/xillybus.rst} (100%)
 rename Documentation/{xz.txt => other/xz.rst} (100%)
 rename Documentation/{zorro.txt => other/zorro.rst} (100%)
 create mode 100644 Documentation/pcmcia/index.rst
 create mode 100644 Documentation/pcmcia/text_files.rst
 create mode 100644 Documentation/perf/index.rst
 create mode 100644 Documentation/perf/text_files.rst
 create mode 100644 Documentation/phy/index.rst
 create mode 100644 Documentation/phy/text_files.rst
 create mode 100644 Documentation/platform/index.rst
 create mode 100644 Documentation/platform/text_files.rst
 create mode 100644 Documentation/power/index.rst
 create mode 100644 Documentation/power/text_files.rst
 create mode 100644 Documentation/powerpc/index.rst
 create mode 100644 Documentation/powerpc/text_files.rst
 create mode 100644 Documentation/pps/index.rst
 create mode 100644 Documentation/pps/text_files.rst
 create mode 100644 Documentation/pti/index.rst
 create mode 100644 Documentation/pti/text_files.rst
 create mode 100644 Documentation/ptp/index.rst
 create mode 100644 Documentation/ptp/text_files.rst
 create mode 100644 Documentation/rapidio/index.rst
 create mode 100644 Documentation/rapidio/text_files.rst
 create mode 100644 Documentation/riscv/index.rst
 create mode 100644 Documentation/riscv/text_files.rst
 create mode 100644 Documentation/s390/index.rst
 create mode 100644 Documentation/s390/text_files.rst
 create mode 100644 Documentation/scheduler/index.rst
 create mode 100644 Documentation/scheduler/text_files.rst
 create mode 100644 Documentation/scsi/index.rst
 create mode 100644 Documentation/scsi/text_files.rst
 create mode 100644 Documentation/serial/index.rst
 create mode 100644 Documentation/serial/text_files.rst
 create mode 100644 Documentation/sparc/index.rst
 create mode 100644 Documentation/sparc/text_files.rst
 create mode 100644 Documentation/sphinx/index.rst
 create mode 100644 Documentation/sphinx/text_files.rst
 create mode 100644 Documentation/sysctl/index.rst
 create mode 100644 Documentation/sysctl/text_files.rst
 create mode 100644 Documentation/target/index.rst
 create mode 100644 Documentation/target/text_files.rst
 create mode 100644 Documentation/thermal/index.rst
 create mode 100644 Documentation/thermal/text_files.rst
 create mode 100644 Documentation/timers/index.rst
 create mode 100644 Documentation/timers/text_files.rst
 create mode 100644 Documentation/usb/index.rst
 create mode 100644 Documentation/usb/text_files.rst
 delete mode 100644 Documentation/video-output.txt
 create mode 100644 Documentation/virtual/index.rst
 create mode 100644 Documentation/virtual/text_files.rst
 create mode 100644 Documentation/watchdog/index.rst
 create mode 100644 Documentation/watchdog/text_files.rst
 create mode 100644 Documentation/x86/index.rst
 create mode 100644 Documentation/x86/text_files.rst
 create mode 100644 Documentation/xilinx/index.rst
 create mode 100644 Documentation/xilinx/text_files.rst
 create mode 100644 Documentation/xtensa/index.rst
 create mode 100644 Documentation/xtensa/text_files.rst

-- 
2.20.1

[PATCH 01/10] docs: DMA-API-HOWTO: add a missing "="

[Mauro Carvalho Chehab]

The === line is shorter than the section title.

As this will generate a warning with rst build, fix it.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/DMA-API-HOWTO.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/DMA-API-HOWTO.txt b/Documentation/DMA-API-HOWTO.txt
index 1a721d0f35c8..db48c6fd3162 100644
--- a/Documentation/DMA-API-HOWTO.txt
+++ b/Documentation/DMA-API-HOWTO.txt
@@ -147,7 +147,7 @@ networking subsystems make sure that the buffers they use are valid
 for you to DMA from/to.
 
 DMA addressing capabilities
-==========================
+===========================
 
 By default, the kernel assumes that your device can address 32-bits of DMA
 addressing.  For a 64-bit capable device, this needs to be increased, and for
-- 
2.20.1

[PATCH 02/10] docs: atomic_bitops.txt: add a title for this document

[Mauro Carvalho Chehab]

This document misses a title. Add it, in order to follow
the documentation standard.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/atomic_bitops.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/atomic_bitops.txt b/Documentation/atomic_bitops.txt
index be70b32c95d9..093cdaefdb37 100644
--- a/Documentation/atomic_bitops.txt
+++ b/Documentation/atomic_bitops.txt
@@ -1,6 +1,6 @@
-
-On atomic bitops.
-
+=============
+Atomic bitops
+=============
 
 While our bitmap_{}() functions are non-atomic, we have a number of operations
 operating on single bits in a bitmap that are atomic.
-- 
2.20.1

[PATCH 03/10] docs: clearing-warn-once.txt: add a title for this document

[Mauro Carvalho Chehab]

This document misses a title. Add it, in order to follow
the documentation standard.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/clearing-warn-once.txt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Documentation/clearing-warn-once.txt b/Documentation/clearing-warn-once.txt
index 5b1f5d547be1..4aa938262d0e 100644
--- a/Documentation/clearing-warn-once.txt
+++ b/Documentation/clearing-warn-once.txt
@@ -1,3 +1,5 @@
+Clearing WARN_ONCE
+------------------
 
 WARN_ONCE / WARN_ON_ONCE only print a warning once.
 
-- 
2.20.1

[PATCH 04/10] docs: ntb.txt: use Sphinx notation for the two ascii figures

[Mauro Carvalho Chehab]

In order to make it to build with Sphinx, we need to fix the
notation for two ascii artwork.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/ntb.txt | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/Documentation/ntb.txt b/Documentation/ntb.txt
index a043854d28df..344a075f81f5 100644
--- a/Documentation/ntb.txt
+++ b/Documentation/ntb.txt
@@ -41,9 +41,10 @@ mainly used to perform the proper memory window initialization. Typically
 there are two types of memory window interfaces supported by the NTB API:
 inbound translation configured on the local ntb port and outbound translation
 configured by the peer, on the peer ntb port. The first type is
-depicted on the next figure
+depicted on the next figure::
+
+ Inbound translation:
 
-Inbound translation:
  Memory:              Local NTB Port:      Peer NTB Port:      Peer MMIO:
   ____________
  | dma-mapped |-ntb_mw_set_trans(addr)  |
@@ -58,9 +59,10 @@ maps corresponding outbound memory window so to have access to the shared
 memory region.
 
 The second type of interface, that implies the shared windows being
-initialized by a peer device, is depicted on the figure:
+initialized by a peer device, is depicted on the figure::
+
+ Outbound translation:
 
-Outbound translation:
  Memory:        Local NTB Port:    Peer NTB Port:      Peer MMIO:
   ____________                      ______________
  | dma-mapped |                |   | MW base addr |<== memory-mapped IO
-- 
2.20.1

[PATCH 05/10] docs: unaligned-memory-access.txt: use a lowercase title

[Mauro Carvalho Chehab]

As all other titles at the documentation, use lower case
for its title.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/unaligned-memory-access.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Documentation/unaligned-memory-access.txt b/Documentation/unaligned-memory-access.txt
index 51b4ff031586..1ee82419d8aa 100644
--- a/Documentation/unaligned-memory-access.txt
+++ b/Documentation/unaligned-memory-access.txt
@@ -1,5 +1,5 @@
 =========================
-UNALIGNED MEMORY ACCESSES
+Unaligned Memory Accesses
 =========================
 
 :Author: Daniel Drake <dsd@gentoo.org>,
-- 
2.20.1

[PATCH 06/10] docs: video-output.txt: convert it to ReST format

[Mauro Carvalho Chehab]

This file doesn't follow the documentation style we use
within the Kernel. Fix it.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/video-output.txt | 52 +++++++++++++++++-----------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/Documentation/video-output.txt b/Documentation/video-output.txt
index e517011be4f9..56d6fa2e2368 100644
--- a/Documentation/video-output.txt
+++ b/Documentation/video-output.txt
@@ -1,34 +1,34 @@
+Video Output Switcher Control
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-		Video Output Switcher Control
-		~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-		2006 luming.yu@intel.com
+2006 luming.yu@intel.com
 
 The output sysfs class driver provides an abstract video output layer that
 can be used to hook platform specific methods to enable/disable video output
 device through common sysfs interface. For example, on my IBM ThinkPad T42
 laptop, The ACPI video driver registered its output devices and read/write
-method for 'state' with output sysfs class. The user interface under sysfs is:
+method for 'state' with output sysfs class. The user interface under sysfs is::
 
-linux:/sys/class/video_output # tree .
-.
-|-- CRT0
-|   |-- device -> ../../../devices/pci0000:00/0000:00:01.0
-|   |-- state
-|   |-- subsystem -> ../../../class/video_output
-|   `-- uevent
-|-- DVI0
-|   |-- device -> ../../../devices/pci0000:00/0000:00:01.0
-|   |-- state
-|   |-- subsystem -> ../../../class/video_output
-|   `-- uevent
-|-- LCD0
-|   |-- device -> ../../../devices/pci0000:00/0000:00:01.0
-|   |-- state
-|   |-- subsystem -> ../../../class/video_output
-|   `-- uevent
-`-- TV0
-   |-- device -> ../../../devices/pci0000:00/0000:00:01.0
-   |-- state
-   |-- subsystem -> ../../../class/video_output
-   `-- uevent
+  linux:/sys/class/video_output # tree .
+  .
+  |-- CRT0
+  |   |-- device -> ../../../devices/pci0000:00/0000:00:01.0
+  |   |-- state
+  |   |-- subsystem -> ../../../class/video_output
+  |   `-- uevent
+  |-- DVI0
+  |   |-- device -> ../../../devices/pci0000:00/0000:00:01.0
+  |   |-- state
+  |   |-- subsystem -> ../../../class/video_output
+  |   `-- uevent
+  |-- LCD0
+  |   |-- device -> ../../../devices/pci0000:00/0000:00:01.0
+  |   |-- state
+  |   |-- subsystem -> ../../../class/video_output
+  |   `-- uevent
+  `-- TV0
+     |-- device -> ../../../devices/pci0000:00/0000:00:01.0
+     |-- state
+     |-- subsystem -> ../../../class/video_output
+     `-- uevent
 
-- 
2.20.1

[PATCH 07/10] docs: Add all txt files to documentation

[Mauro Carvalho Chehab]

Allow generating documentation for all files

There are two text files that would require a lot of extra effort
to be parsed by Sphinx, and whose authors strongly prefer to not
do that. So, add those as plain text files. That makes those two
files a little ackward at the html/pdf output, but at least everything
will be there.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/index.rst                       |   9 ++
 .../DMA-API-HOWTO.rst}                        |   0
 .../{DMA-API.txt => other/DMA-API.rst}        |   0
 .../DMA-ISA-LPC.rst}                          |   0
 .../DMA-attributes.rst}                       |   0
 Documentation/{IPMI.txt => other/IPMI.rst}    |   0
 .../IRQ-affinity.rst}                         |   0
 .../{IRQ-domain.txt => other/IRQ-domain.rst}  |   0
 Documentation/{IRQ.txt => other/IRQ.rst}      |   0
 .../Intel-IOMMU.rst}                          |   0
 Documentation/{SAK.txt => other/SAK.rst}      |   0
 Documentation/{SM501.txt => other/SM501.rst}  |   0
 .../atomic_bitops.rst}                        |   0
 Documentation/{ => other}/atomic_t.txt        |   0
 .../{bt8xxgpio.txt => other/bt8xxgpio.rst}    |   0
 .../{btmrvl.txt => other/btmrvl.rst}          |   0
 .../bus-virt-phys-mapping.rst}                |   0
 .../clearing-warn-once.rst}                   |   0
 .../{cpu-load.txt => other/cpu-load.rst}      |   0
 .../cputopology.rst}                          |   0
 Documentation/{crc32.txt => other/crc32.rst}  |   0
 .../{dcdbas.txt => other/dcdbas.rst}          |   0
 .../debugging-modules.rst}                    |   0
 .../debugging-via-ohci1394.rst}               |   0
 .../{dell_rbu.txt => other/dell_rbu.rst}      |   0
 .../{digsig.txt => other/digsig.rst}          |   0
 .../{efi-stub.txt => other/efi-stub.rst}      |   0
 Documentation/{eisa.txt => other/eisa.rst}    |   0
 .../futex-requeue-pi.rst}                     |   0
 .../gcc-plugins.rst}                          |   0
 .../{highuid.txt => other/highuid.rst}        |   0
 .../{hw_random.txt => other/hw_random.rst}    |   0
 .../{hwspinlock.txt => other/hwspinlock.rst}  |   0
 Documentation/other/index.rst                 | 100 ++++++++++++++++++
 .../{intel_txt.txt => other/intel_txt.rst}    |   0
 .../{io-mapping.txt => other/io-mapping.rst}  |   0
 .../io_ordering.rst}                          |   0
 .../{iostats.txt => other/iostats.rst}        |   0
 .../irqflags-tracing.rst}                     |   0
 Documentation/{isa.txt => other/isa.rst}      |   0
 .../{isapnp.txt => other/isapnp.rst}          |   0
 .../kernel-per-CPU-kthreads.rst}              |   0
 .../{kobject.txt => other/kobject.rst}        |   0
 .../{kprobes.txt => other/kprobes.rst}        |   0
 Documentation/{kref.txt => other/kref.rst}    |   0
 Documentation/{ldm.txt => other/ldm.rst}      |   0
 .../lockup-watchdogs.rst}                     |   0
 Documentation/{lsm.txt => other/lsm.rst}      |   0
 Documentation/{lzo.txt => other/lzo.rst}      |   0
 .../{mailbox.txt => other/mailbox.rst}        |   0
 Documentation/{ => other}/memory-barriers.txt |   0
 .../men-chameleon-bus.rst}                    |   0
 .../{nommu-mmap.txt => other/nommu-mmap.rst}  |   0
 Documentation/{ntb.txt => other/ntb.rst}      |   0
 .../{numastat.txt => other/numastat.rst}      |   0
 .../{padata.txt => other/padata.rst}          |   0
 .../parport-lowlevel.rst}                     |   0
 .../percpu-rw-semaphore.rst}                  |   0
 Documentation/{phy.txt => other/phy.rst}      |   0
 .../{pi-futex.txt => other/pi-futex.rst}      |   0
 Documentation/{pnp.txt => other/pnp.rst}      |   0
 .../preempt-locking.rst}                      |   0
 Documentation/{pwm.txt => other/pwm.rst}      |   0
 .../{rbtree.txt => other/rbtree.rst}          |   0
 .../{remoteproc.txt => other/remoteproc.rst}  |   0
 .../{rfkill.txt => other/rfkill.rst}          |   0
 .../robust-futex-ABI.rst}                     |   0
 .../robust-futexes.rst}                       |   0
 Documentation/{rpmsg.txt => other/rpmsg.rst}  |   0
 Documentation/{rtc.txt => other/rtc.rst}      |   0
 .../{sgi-ioc4.txt => other/sgi-ioc4.rst}      |   0
 .../{siphash.txt => other/siphash.rst}        |   0
 .../smsc_ece1099.rst}                         |   0
 .../speculation.rst}                          |   0
 .../static-keys.rst}                          |   0
 Documentation/{svga.txt => other/svga.rst}    |   0
 .../{switchtec.txt => other/switchtec.rst}    |   0
 .../{sync_file.txt => other/sync_file.rst}    |   0
 Documentation/{tee.txt => other/tee.rst}      |   0
 Documentation/other/text_files.rst            |  12 +++
 .../this_cpu_ops.rst}                         |   0
 .../unaligned-memory-access.rst}              |   0
 .../vfio-mediated-device.rst}                 |   0
 Documentation/{vfio.txt => other/vfio.rst}    |   0
 .../video-output.rst}                         |   0
 .../{xillybus.txt => other/xillybus.rst}      |   0
 Documentation/{xz.txt => other/xz.rst}        |   0
 Documentation/{zorro.txt => other/zorro.rst}  |   0
 88 files changed, 121 insertions(+)
 rename Documentation/{DMA-API-HOWTO.txt => other/DMA-API-HOWTO.rst} (100%)
 rename Documentation/{DMA-API.txt => other/DMA-API.rst} (100%)
 rename Documentation/{DMA-ISA-LPC.txt => other/DMA-ISA-LPC.rst} (100%)
 rename Documentation/{DMA-attributes.txt => other/DMA-attributes.rst} (100%)
 rename Documentation/{IPMI.txt => other/IPMI.rst} (100%)
 rename Documentation/{IRQ-affinity.txt => other/IRQ-affinity.rst} (100%)
 rename Documentation/{IRQ-domain.txt => other/IRQ-domain.rst} (100%)
 rename Documentation/{IRQ.txt => other/IRQ.rst} (100%)
 rename Documentation/{Intel-IOMMU.txt => other/Intel-IOMMU.rst} (100%)
 rename Documentation/{SAK.txt => other/SAK.rst} (100%)
 rename Documentation/{SM501.txt => other/SM501.rst} (100%)
 rename Documentation/{atomic_bitops.txt => other/atomic_bitops.rst} (100%)
 rename Documentation/{ => other}/atomic_t.txt (100%)
 rename Documentation/{bt8xxgpio.txt => other/bt8xxgpio.rst} (100%)
 rename Documentation/{btmrvl.txt => other/btmrvl.rst} (100%)
 rename Documentation/{bus-virt-phys-mapping.txt => other/bus-virt-phys-mapping.rst} (100%)
 rename Documentation/{clearing-warn-once.txt => other/clearing-warn-once.rst} (100%)
 rename Documentation/{cpu-load.txt => other/cpu-load.rst} (100%)
 rename Documentation/{cputopology.txt => other/cputopology.rst} (100%)
 rename Documentation/{crc32.txt => other/crc32.rst} (100%)
 rename Documentation/{dcdbas.txt => other/dcdbas.rst} (100%)
 rename Documentation/{debugging-modules.txt => other/debugging-modules.rst} (100%)
 rename Documentation/{debugging-via-ohci1394.txt => other/debugging-via-ohci1394.rst} (100%)
 rename Documentation/{dell_rbu.txt => other/dell_rbu.rst} (100%)
 rename Documentation/{digsig.txt => other/digsig.rst} (100%)
 rename Documentation/{efi-stub.txt => other/efi-stub.rst} (100%)
 rename Documentation/{eisa.txt => other/eisa.rst} (100%)
 rename Documentation/{futex-requeue-pi.txt => other/futex-requeue-pi.rst} (100%)
 rename Documentation/{gcc-plugins.txt => other/gcc-plugins.rst} (100%)
 rename Documentation/{highuid.txt => other/highuid.rst} (100%)
 rename Documentation/{hw_random.txt => other/hw_random.rst} (100%)
 rename Documentation/{hwspinlock.txt => other/hwspinlock.rst} (100%)
 create mode 100644 Documentation/other/index.rst
 rename Documentation/{intel_txt.txt => other/intel_txt.rst} (100%)
 rename Documentation/{io-mapping.txt => other/io-mapping.rst} (100%)
 rename Documentation/{io_ordering.txt => other/io_ordering.rst} (100%)
 rename Documentation/{iostats.txt => other/iostats.rst} (100%)
 rename Documentation/{irqflags-tracing.txt => other/irqflags-tracing.rst} (100%)
 rename Documentation/{isa.txt => other/isa.rst} (100%)
 rename Documentation/{isapnp.txt => other/isapnp.rst} (100%)
 rename Documentation/{kernel-per-CPU-kthreads.txt => other/kernel-per-CPU-kthreads.rst} (100%)
 rename Documentation/{kobject.txt => other/kobject.rst} (100%)
 rename Documentation/{kprobes.txt => other/kprobes.rst} (100%)
 rename Documentation/{kref.txt => other/kref.rst} (100%)
 rename Documentation/{ldm.txt => other/ldm.rst} (100%)
 rename Documentation/{lockup-watchdogs.txt => other/lockup-watchdogs.rst} (100%)
 rename Documentation/{lsm.txt => other/lsm.rst} (100%)
 rename Documentation/{lzo.txt => other/lzo.rst} (100%)
 rename Documentation/{mailbox.txt => other/mailbox.rst} (100%)
 rename Documentation/{ => other}/memory-barriers.txt (100%)
 rename Documentation/{men-chameleon-bus.txt => other/men-chameleon-bus.rst} (100%)
 rename Documentation/{nommu-mmap.txt => other/nommu-mmap.rst} (100%)
 rename Documentation/{ntb.txt => other/ntb.rst} (100%)
 rename Documentation/{numastat.txt => other/numastat.rst} (100%)
 rename Documentation/{padata.txt => other/padata.rst} (100%)
 rename Documentation/{parport-lowlevel.txt => other/parport-lowlevel.rst} (100%)
 rename Documentation/{percpu-rw-semaphore.txt => other/percpu-rw-semaphore.rst} (100%)
 rename Documentation/{phy.txt => other/phy.rst} (100%)
 rename Documentation/{pi-futex.txt => other/pi-futex.rst} (100%)
 rename Documentation/{pnp.txt => other/pnp.rst} (100%)
 rename Documentation/{preempt-locking.txt => other/preempt-locking.rst} (100%)
 rename Documentation/{pwm.txt => other/pwm.rst} (100%)
 rename Documentation/{rbtree.txt => other/rbtree.rst} (100%)
 rename Documentation/{remoteproc.txt => other/remoteproc.rst} (100%)
 rename Documentation/{rfkill.txt => other/rfkill.rst} (100%)
 rename Documentation/{robust-futex-ABI.txt => other/robust-futex-ABI.rst} (100%)
 rename Documentation/{robust-futexes.txt => other/robust-futexes.rst} (100%)
 rename Documentation/{rpmsg.txt => other/rpmsg.rst} (100%)
 rename Documentation/{rtc.txt => other/rtc.rst} (100%)
 rename Documentation/{sgi-ioc4.txt => other/sgi-ioc4.rst} (100%)
 rename Documentation/{siphash.txt => other/siphash.rst} (100%)
 rename Documentation/{smsc_ece1099.txt => other/smsc_ece1099.rst} (100%)
 rename Documentation/{speculation.txt => other/speculation.rst} (100%)
 rename Documentation/{static-keys.txt => other/static-keys.rst} (100%)
 rename Documentation/{svga.txt => other/svga.rst} (100%)
 rename Documentation/{switchtec.txt => other/switchtec.rst} (100%)
 rename Documentation/{sync_file.txt => other/sync_file.rst} (100%)
 rename Documentation/{tee.txt => other/tee.rst} (100%)
 create mode 100644 Documentation/other/text_files.rst
 rename Documentation/{this_cpu_ops.txt => other/this_cpu_ops.rst} (100%)
 rename Documentation/{unaligned-memory-access.txt => other/unaligned-memory-access.rst} (100%)
 rename Documentation/{vfio-mediated-device.txt => other/vfio-mediated-device.rst} (100%)
 rename Documentation/{vfio.txt => other/vfio.rst} (100%)
 rename Documentation/{video-output.txt => other/video-output.rst} (100%)
 rename Documentation/{xillybus.txt => other/xillybus.rst} (100%)
 rename Documentation/{xz.txt => other/xz.rst} (100%)
 rename Documentation/{zorro.txt => other/zorro.rst} (100%)

diff --git a/Documentation/index.rst b/Documentation/index.rst
index 80a421cb935e..02195dff3344 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -122,6 +122,15 @@ Translations
 
    translations/index
 
+Other random documents
+----------------------
+
+.. toctree::
+   :maxdepth: 2
+
+   other/index
+
+
 Indices and tables
 ==================
 
diff --git a/Documentation/DMA-API-HOWTO.txt b/Documentation/other/DMA-API-HOWTO.rst
similarity index 100%
rename from Documentation/DMA-API-HOWTO.txt
rename to Documentation/other/DMA-API-HOWTO.rst
diff --git a/Documentation/DMA-API.txt b/Documentation/other/DMA-API.rst
similarity index 100%
rename from Documentation/DMA-API.txt
rename to Documentation/other/DMA-API.rst
diff --git a/Documentation/DMA-ISA-LPC.txt b/Documentation/other/DMA-ISA-LPC.rst
similarity index 100%
rename from Documentation/DMA-ISA-LPC.txt
rename to Documentation/other/DMA-ISA-LPC.rst
diff --git a/Documentation/DMA-attributes.txt b/Documentation/other/DMA-attributes.rst
similarity index 100%
rename from Documentation/DMA-attributes.txt
rename to Documentation/other/DMA-attributes.rst
diff --git a/Documentation/IPMI.txt b/Documentation/other/IPMI.rst
similarity index 100%
rename from Documentation/IPMI.txt
rename to Documentation/other/IPMI.rst
diff --git a/Documentation/IRQ-affinity.txt b/Documentation/other/IRQ-affinity.rst
similarity index 100%
rename from Documentation/IRQ-affinity.txt
rename to Documentation/other/IRQ-affinity.rst
diff --git a/Documentation/IRQ-domain.txt b/Documentation/other/IRQ-domain.rst
similarity index 100%
rename from Documentation/IRQ-domain.txt
rename to Documentation/other/IRQ-domain.rst
diff --git a/Documentation/IRQ.txt b/Documentation/other/IRQ.rst
similarity index 100%
rename from Documentation/IRQ.txt
rename to Documentation/other/IRQ.rst
diff --git a/Documentation/Intel-IOMMU.txt b/Documentation/other/Intel-IOMMU.rst
similarity index 100%
rename from Documentation/Intel-IOMMU.txt
rename to Documentation/other/Intel-IOMMU.rst
diff --git a/Documentation/SAK.txt b/Documentation/other/SAK.rst
similarity index 100%
rename from Documentation/SAK.txt
rename to Documentation/other/SAK.rst
diff --git a/Documentation/SM501.txt b/Documentation/other/SM501.rst
similarity index 100%
rename from Documentation/SM501.txt
rename to Documentation/other/SM501.rst
diff --git a/Documentation/atomic_bitops.txt b/Documentation/other/atomic_bitops.rst
similarity index 100%
rename from Documentation/atomic_bitops.txt
rename to Documentation/other/atomic_bitops.rst
diff --git a/Documentation/atomic_t.txt b/Documentation/other/atomic_t.txt
similarity index 100%
rename from Documentation/atomic_t.txt
rename to Documentation/other/atomic_t.txt
diff --git a/Documentation/bt8xxgpio.txt b/Documentation/other/bt8xxgpio.rst
similarity index 100%
rename from Documentation/bt8xxgpio.txt
rename to Documentation/other/bt8xxgpio.rst
diff --git a/Documentation/btmrvl.txt b/Documentation/other/btmrvl.rst
similarity index 100%
rename from Documentation/btmrvl.txt
rename to Documentation/other/btmrvl.rst
diff --git a/Documentation/bus-virt-phys-mapping.txt b/Documentation/other/bus-virt-phys-mapping.rst
similarity index 100%
rename from Documentation/bus-virt-phys-mapping.txt
rename to Documentation/other/bus-virt-phys-mapping.rst
diff --git a/Documentation/clearing-warn-once.txt b/Documentation/other/clearing-warn-once.rst
similarity index 100%
rename from Documentation/clearing-warn-once.txt
rename to Documentation/other/clearing-warn-once.rst
diff --git a/Documentation/cpu-load.txt b/Documentation/other/cpu-load.rst
similarity index 100%
rename from Documentation/cpu-load.txt
rename to Documentation/other/cpu-load.rst
diff --git a/Documentation/cputopology.txt b/Documentation/other/cputopology.rst
similarity index 100%
rename from Documentation/cputopology.txt
rename to Documentation/other/cputopology.rst
diff --git a/Documentation/crc32.txt b/Documentation/other/crc32.rst
similarity index 100%
rename from Documentation/crc32.txt
rename to Documentation/other/crc32.rst
diff --git a/Documentation/dcdbas.txt b/Documentation/other/dcdbas.rst
similarity index 100%
rename from Documentation/dcdbas.txt
rename to Documentation/other/dcdbas.rst
diff --git a/Documentation/debugging-modules.txt b/Documentation/other/debugging-modules.rst
similarity index 100%
rename from Documentation/debugging-modules.txt
rename to Documentation/other/debugging-modules.rst
diff --git a/Documentation/debugging-via-ohci1394.txt b/Documentation/other/debugging-via-ohci1394.rst
similarity index 100%
rename from Documentation/debugging-via-ohci1394.txt
rename to Documentation/other/debugging-via-ohci1394.rst
diff --git a/Documentation/dell_rbu.txt b/Documentation/other/dell_rbu.rst
similarity index 100%
rename from Documentation/dell_rbu.txt
rename to Documentation/other/dell_rbu.rst
diff --git a/Documentation/digsig.txt b/Documentation/other/digsig.rst
similarity index 100%
rename from Documentation/digsig.txt
rename to Documentation/other/digsig.rst
diff --git a/Documentation/efi-stub.txt b/Documentation/other/efi-stub.rst
similarity index 100%
rename from Documentation/efi-stub.txt
rename to Documentation/other/efi-stub.rst
diff --git a/Documentation/eisa.txt b/Documentation/other/eisa.rst
similarity index 100%
rename from Documentation/eisa.txt
rename to Documentation/other/eisa.rst
diff --git a/Documentation/futex-requeue-pi.txt b/Documentation/other/futex-requeue-pi.rst
similarity index 100%
rename from Documentation/futex-requeue-pi.txt
rename to Documentation/other/futex-requeue-pi.rst
diff --git a/Documentation/gcc-plugins.txt b/Documentation/other/gcc-plugins.rst
similarity index 100%
rename from Documentation/gcc-plugins.txt
rename to Documentation/other/gcc-plugins.rst
diff --git a/Documentation/highuid.txt b/Documentation/other/highuid.rst
similarity index 100%
rename from Documentation/highuid.txt
rename to Documentation/other/highuid.rst
diff --git a/Documentation/hw_random.txt b/Documentation/other/hw_random.rst
similarity index 100%
rename from Documentation/hw_random.txt
rename to Documentation/other/hw_random.rst
diff --git a/Documentation/hwspinlock.txt b/Documentation/other/hwspinlock.rst
similarity index 100%
rename from Documentation/hwspinlock.txt
rename to Documentation/other/hwspinlock.rst
diff --git a/Documentation/other/index.rst b/Documentation/other/index.rst
new file mode 100644
index 000000000000..1c294687412a
--- /dev/null
+++ b/Documentation/other/index.rst
@@ -0,0 +1,100 @@
+.. _other_docs:
+
+=================
+Other Kernel docs
+=================
+
+.. toctree::
+    :maxdepth: 1
+
+    atomic_bitops.rst
+    bt8xxgpio.rst
+    btmrvl.rst
+    bus-virt-phys-mapping.rst
+    clearing-warn-once.rst
+    cpu-load.rst
+    cputopology.rst
+    crc32.rst
+    dcdbas.rst
+    debugging-modules.rst
+    debugging-via-ohci1394.rst
+    dell_rbu.rst
+    digsig.rst
+    DMA-API-HOWTO.rst
+    DMA-API.rst
+    DMA-attributes.rst
+    DMA-ISA-LPC.rst
+    efi-stub.rst
+    eisa.rst
+    futex-requeue-pi.rst
+    gcc-plugins.rst
+    highuid.rst
+    hw_random.rst
+    hwspinlock.rst
+    Intel-IOMMU.rst
+    intel_txt.rst
+    io-mapping.rst
+    io_ordering.rst
+    iostats.rst
+    IPMI.rst
+    IRQ-affinity.rst
+    IRQ-domain.rst
+    irqflags-tracing.rst
+    IRQ.rst
+    isapnp.rst
+    isa.rst
+    kernel-per-CPU-kthreads.rst
+    kobject.rst
+    kprobes.rst
+    kref.rst
+    ldm.rst
+    lockup-watchdogs.rst
+    lsm.rst
+    lzo.rst
+    mailbox.rst
+    men-chameleon-bus.rst
+    nommu-mmap.rst
+    ntb.rst
+    numastat.rst
+    padata.rst
+    parport-lowlevel.rst
+    percpu-rw-semaphore.rst
+    phy.rst
+    pi-futex.rst
+    pnp.rst
+    preempt-locking.rst
+    pwm.rst
+    rbtree.rst
+    remoteproc.rst
+    rfkill.rst
+    robust-futex-ABI.rst
+    robust-futexes.rst
+    rpmsg.rst
+    rtc.rst
+    SAK.rst
+    sgi-ioc4.rst
+    siphash.rst
+    SM501.rst
+    smsc_ece1099.rst
+    speculation.rst
+    static-keys.rst
+    svga.rst
+    switchtec.rst
+    sync_file.rst
+    tee.rst
+    this_cpu_ops.rst
+    unaligned-memory-access.rst
+    vfio-mediated-device.rst
+    vfio.rst
+    video-output.rst
+    xillybus.rst
+    xz.rst
+    zorro.rst
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/intel_txt.txt b/Documentation/other/intel_txt.rst
similarity index 100%
rename from Documentation/intel_txt.txt
rename to Documentation/other/intel_txt.rst
diff --git a/Documentation/io-mapping.txt b/Documentation/other/io-mapping.rst
similarity index 100%
rename from Documentation/io-mapping.txt
rename to Documentation/other/io-mapping.rst
diff --git a/Documentation/io_ordering.txt b/Documentation/other/io_ordering.rst
similarity index 100%
rename from Documentation/io_ordering.txt
rename to Documentation/other/io_ordering.rst
diff --git a/Documentation/iostats.txt b/Documentation/other/iostats.rst
similarity index 100%
rename from Documentation/iostats.txt
rename to Documentation/other/iostats.rst
diff --git a/Documentation/irqflags-tracing.txt b/Documentation/other/irqflags-tracing.rst
similarity index 100%
rename from Documentation/irqflags-tracing.txt
rename to Documentation/other/irqflags-tracing.rst
diff --git a/Documentation/isa.txt b/Documentation/other/isa.rst
similarity index 100%
rename from Documentation/isa.txt
rename to Documentation/other/isa.rst
diff --git a/Documentation/isapnp.txt b/Documentation/other/isapnp.rst
similarity index 100%
rename from Documentation/isapnp.txt
rename to Documentation/other/isapnp.rst
diff --git a/Documentation/kernel-per-CPU-kthreads.txt b/Documentation/other/kernel-per-CPU-kthreads.rst
similarity index 100%
rename from Documentation/kernel-per-CPU-kthreads.txt
rename to Documentation/other/kernel-per-CPU-kthreads.rst
diff --git a/Documentation/kobject.txt b/Documentation/other/kobject.rst
similarity index 100%
rename from Documentation/kobject.txt
rename to Documentation/other/kobject.rst
diff --git a/Documentation/kprobes.txt b/Documentation/other/kprobes.rst
similarity index 100%
rename from Documentation/kprobes.txt
rename to Documentation/other/kprobes.rst
diff --git a/Documentation/kref.txt b/Documentation/other/kref.rst
similarity index 100%
rename from Documentation/kref.txt
rename to Documentation/other/kref.rst
diff --git a/Documentation/ldm.txt b/Documentation/other/ldm.rst
similarity index 100%
rename from Documentation/ldm.txt
rename to Documentation/other/ldm.rst
diff --git a/Documentation/lockup-watchdogs.txt b/Documentation/other/lockup-watchdogs.rst
similarity index 100%
rename from Documentation/lockup-watchdogs.txt
rename to Documentation/other/lockup-watchdogs.rst
diff --git a/Documentation/lsm.txt b/Documentation/other/lsm.rst
similarity index 100%
rename from Documentation/lsm.txt
rename to Documentation/other/lsm.rst
diff --git a/Documentation/lzo.txt b/Documentation/other/lzo.rst
similarity index 100%
rename from Documentation/lzo.txt
rename to Documentation/other/lzo.rst
diff --git a/Documentation/mailbox.txt b/Documentation/other/mailbox.rst
similarity index 100%
rename from Documentation/mailbox.txt
rename to Documentation/other/mailbox.rst
diff --git a/Documentation/memory-barriers.txt b/Documentation/other/memory-barriers.txt
similarity index 100%
rename from Documentation/memory-barriers.txt
rename to Documentation/other/memory-barriers.txt
diff --git a/Documentation/men-chameleon-bus.txt b/Documentation/other/men-chameleon-bus.rst
similarity index 100%
rename from Documentation/men-chameleon-bus.txt
rename to Documentation/other/men-chameleon-bus.rst
diff --git a/Documentation/nommu-mmap.txt b/Documentation/other/nommu-mmap.rst
similarity index 100%
rename from Documentation/nommu-mmap.txt
rename to Documentation/other/nommu-mmap.rst
diff --git a/Documentation/ntb.txt b/Documentation/other/ntb.rst
similarity index 100%
rename from Documentation/ntb.txt
rename to Documentation/other/ntb.rst
diff --git a/Documentation/numastat.txt b/Documentation/other/numastat.rst
similarity index 100%
rename from Documentation/numastat.txt
rename to Documentation/other/numastat.rst
diff --git a/Documentation/padata.txt b/Documentation/other/padata.rst
similarity index 100%
rename from Documentation/padata.txt
rename to Documentation/other/padata.rst
diff --git a/Documentation/parport-lowlevel.txt b/Documentation/other/parport-lowlevel.rst
similarity index 100%
rename from Documentation/parport-lowlevel.txt
rename to Documentation/other/parport-lowlevel.rst
diff --git a/Documentation/percpu-rw-semaphore.txt b/Documentation/other/percpu-rw-semaphore.rst
similarity index 100%
rename from Documentation/percpu-rw-semaphore.txt
rename to Documentation/other/percpu-rw-semaphore.rst
diff --git a/Documentation/phy.txt b/Documentation/other/phy.rst
similarity index 100%
rename from Documentation/phy.txt
rename to Documentation/other/phy.rst
diff --git a/Documentation/pi-futex.txt b/Documentation/other/pi-futex.rst
similarity index 100%
rename from Documentation/pi-futex.txt
rename to Documentation/other/pi-futex.rst
diff --git a/Documentation/pnp.txt b/Documentation/other/pnp.rst
similarity index 100%
rename from Documentation/pnp.txt
rename to Documentation/other/pnp.rst
diff --git a/Documentation/preempt-locking.txt b/Documentation/other/preempt-locking.rst
similarity index 100%
rename from Documentation/preempt-locking.txt
rename to Documentation/other/preempt-locking.rst
diff --git a/Documentation/pwm.txt b/Documentation/other/pwm.rst
similarity index 100%
rename from Documentation/pwm.txt
rename to Documentation/other/pwm.rst
diff --git a/Documentation/rbtree.txt b/Documentation/other/rbtree.rst
similarity index 100%
rename from Documentation/rbtree.txt
rename to Documentation/other/rbtree.rst
diff --git a/Documentation/remoteproc.txt b/Documentation/other/remoteproc.rst
similarity index 100%
rename from Documentation/remoteproc.txt
rename to Documentation/other/remoteproc.rst
diff --git a/Documentation/rfkill.txt b/Documentation/other/rfkill.rst
similarity index 100%
rename from Documentation/rfkill.txt
rename to Documentation/other/rfkill.rst
diff --git a/Documentation/robust-futex-ABI.txt b/Documentation/other/robust-futex-ABI.rst
similarity index 100%
rename from Documentation/robust-futex-ABI.txt
rename to Documentation/other/robust-futex-ABI.rst
diff --git a/Documentation/robust-futexes.txt b/Documentation/other/robust-futexes.rst
similarity index 100%
rename from Documentation/robust-futexes.txt
rename to Documentation/other/robust-futexes.rst
diff --git a/Documentation/rpmsg.txt b/Documentation/other/rpmsg.rst
similarity index 100%
rename from Documentation/rpmsg.txt
rename to Documentation/other/rpmsg.rst
diff --git a/Documentation/rtc.txt b/Documentation/other/rtc.rst
similarity index 100%
rename from Documentation/rtc.txt
rename to Documentation/other/rtc.rst
diff --git a/Documentation/sgi-ioc4.txt b/Documentation/other/sgi-ioc4.rst
similarity index 100%
rename from Documentation/sgi-ioc4.txt
rename to Documentation/other/sgi-ioc4.rst
diff --git a/Documentation/siphash.txt b/Documentation/other/siphash.rst
similarity index 100%
rename from Documentation/siphash.txt
rename to Documentation/other/siphash.rst
diff --git a/Documentation/smsc_ece1099.txt b/Documentation/other/smsc_ece1099.rst
similarity index 100%
rename from Documentation/smsc_ece1099.txt
rename to Documentation/other/smsc_ece1099.rst
diff --git a/Documentation/speculation.txt b/Documentation/other/speculation.rst
similarity index 100%
rename from Documentation/speculation.txt
rename to Documentation/other/speculation.rst
diff --git a/Documentation/static-keys.txt b/Documentation/other/static-keys.rst
similarity index 100%
rename from Documentation/static-keys.txt
rename to Documentation/other/static-keys.rst
diff --git a/Documentation/svga.txt b/Documentation/other/svga.rst
similarity index 100%
rename from Documentation/svga.txt
rename to Documentation/other/svga.rst
diff --git a/Documentation/switchtec.txt b/Documentation/other/switchtec.rst
similarity index 100%
rename from Documentation/switchtec.txt
rename to Documentation/other/switchtec.rst
diff --git a/Documentation/sync_file.txt b/Documentation/other/sync_file.rst
similarity index 100%
rename from Documentation/sync_file.txt
rename to Documentation/other/sync_file.rst
diff --git a/Documentation/tee.txt b/Documentation/other/tee.rst
similarity index 100%
rename from Documentation/tee.txt
rename to Documentation/other/tee.rst
diff --git a/Documentation/other/text_files.rst b/Documentation/other/text_files.rst
new file mode 100644
index 000000000000..f743dcdd87f5
--- /dev/null
+++ b/Documentation/other/text_files.rst
@@ -0,0 +1,12 @@
+
+Memory barriers
+---------------
+
+    .. include:: memory-barriers.txt
+	:literal:
+
+Atomic types
+------------
+
+    .. include:: atomic_t.txt
+	:literal:
diff --git a/Documentation/this_cpu_ops.txt b/Documentation/other/this_cpu_ops.rst
similarity index 100%
rename from Documentation/this_cpu_ops.txt
rename to Documentation/other/this_cpu_ops.rst
diff --git a/Documentation/unaligned-memory-access.txt b/Documentation/other/unaligned-memory-access.rst
similarity index 100%
rename from Documentation/unaligned-memory-access.txt
rename to Documentation/other/unaligned-memory-access.rst
diff --git a/Documentation/vfio-mediated-device.txt b/Documentation/other/vfio-mediated-device.rst
similarity index 100%
rename from Documentation/vfio-mediated-device.txt
rename to Documentation/other/vfio-mediated-device.rst
diff --git a/Documentation/vfio.txt b/Documentation/other/vfio.rst
similarity index 100%
rename from Documentation/vfio.txt
rename to Documentation/other/vfio.rst
diff --git a/Documentation/video-output.txt b/Documentation/other/video-output.rst
similarity index 100%
rename from Documentation/video-output.txt
rename to Documentation/other/video-output.rst
diff --git a/Documentation/xillybus.txt b/Documentation/other/xillybus.rst
similarity index 100%
rename from Documentation/xillybus.txt
rename to Documentation/other/xillybus.rst
diff --git a/Documentation/xz.txt b/Documentation/other/xz.rst
similarity index 100%
rename from Documentation/xz.txt
rename to Documentation/other/xz.rst
diff --git a/Documentation/zorro.txt b/Documentation/other/zorro.rst
similarity index 100%
rename from Documentation/zorro.txt
rename to Documentation/other/zorro.rst
-- 
2.20.1

Re: [PATCH 07/10] docs: Add all txt files to documentation

[Joe Perches]

On Mon, 2019-04-08 at 13:58 -0300, Mauro Carvalho Chehab wrote:
> Allow generating documentation for all files

Please update the MAINTAINERS F: patterns too.

$ git grep -P "Documentation/\w*\.txt" MAINTAINERS
MAINTAINERS:F:  Documentation/dcdbas.txt
MAINTAINERS:F:  Documentation/kobject.txt
MAINTAINERS:F:  Documentation/hw_random.txt
MAINTAINERS:F:  Documentation/hwspinlock.txt
MAINTAINERS:F:  Documentation/intel_txt.txt
MAINTAINERS:F:  Documentation/IPMI.txt
MAINTAINERS:F:  Documentation/isa.txt
MAINTAINERS:F:  Documentation/isapnp.txt
MAINTAINERS:F:  Documentation/kprobes.txt
MAINTAINERS:F:  Documentation/atomic_bitops.txt
MAINTAINERS:F:  Documentation/atomic_t.txt
MAINTAINERS:F:  Documentation/ldm.txt
MAINTAINERS:F:  Documentation/padata.txt
MAINTAINERS:F:  Documentation/switchtec.txt
MAINTAINERS:F:  Documentation/pwm.txt
MAINTAINERS:F:  Documentation/rtc.txt
MAINTAINERS:F:  Documentation/remoteproc.txt
MAINTAINERS:F:  Documentation/rpmsg.txt
MAINTAINERS:F:  Documentation/rfkill.txt
MAINTAINERS:F:  Documentation/svga.txt
MAINTAINERS:F:  Documentation/sync_file.txt
MAINTAINERS:F:  Documentation/tee.txt
MAINTAINERS:F:  Documentation/vfio.txt

[PATCH 08/10] docs: ntb.rst: add blank lines to clean up some Sphinx warnings

[Mauro Carvalho Chehab]

In order to make it easier to parse and produce the right output,
add some extra blank lines.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/other/ntb.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/other/ntb.rst b/Documentation/other/ntb.rst
index 344a075f81f5..074a423c853c 100644
--- a/Documentation/other/ntb.rst
+++ b/Documentation/other/ntb.rst
@@ -77,11 +77,13 @@ outbound memory window so to have access to the shared memory region.
 
 As one can see the described scenarios can be combined in one portable
 algorithm.
+
  Local device:
   1) Allocate memory for a shared window
   2) Initialize memory window by translated address of the allocated region
      (it may fail if local memory window initialization is unsupported)
   3) Send the translated address and memory window index to a peer device
+
  Peer device:
   1) Initialize memory window with retrieved address of the allocated
      by another device memory region (it may fail if peer memory window
@@ -90,6 +92,7 @@ algorithm.
 
 In accordance with this scenario, the NTB Memory Window API can be used as
 follows:
+
  Local device:
   1) ntb_mw_count(pidx) - retrieve number of memory ranges, which can
      be allocated for memory windows between local device and peer device
@@ -105,6 +108,7 @@ follows:
   5) Send translated base address (usually together with memory window
      number) to the peer device using, for instance, scratchpad or message
      registers.
+
  Peer device:
   1) ntb_peer_mw_set_trans(pidx, midx) - try to set received from other
      device (related to pidx) translated address for specified memory
-- 
2.20.1

[PATCH 09/10] docs: speculation.rst: mark example blocks as such

[Mauro Carvalho Chehab]

Identify the example blocks there, in order to avoid Sphinx
warnings.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/other/speculation.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/other/speculation.rst b/Documentation/other/speculation.rst
index e9e6cbae2841..50d7ea857cff 100644
--- a/Documentation/other/speculation.rst
+++ b/Documentation/other/speculation.rst
@@ -17,7 +17,7 @@ observed to extract secret information.
 
 For example, in the presence of branch prediction, it is possible for bounds
 checks to be ignored by code which is speculatively executed. Consider the
-following code:
+following code::
 
 	int load_array(int *array, unsigned int index)
 	{
@@ -27,7 +27,7 @@ following code:
 			return array[index];
 	}
 
-Which, on arm64, may be compiled to an assembly sequence such as:
+Which, on arm64, may be compiled to an assembly sequence such as::
 
 	CMP	<index>, #MAX_ARRAY_ELEMS
 	B.LT	less
@@ -44,7 +44,7 @@ microarchitectural state which can be subsequently measured.
 
 More complex sequences involving multiple dependent memory accesses may
 result in sensitive information being leaked. Consider the following
-code, building on the prior example:
+code, building on the prior example::
 
 	int load_dependent_arrays(int *arr1, int *arr2, int index)
 	{
@@ -77,7 +77,7 @@ A call to array_index_nospec(index, size) returns a sanitized index
 value that is bounded to [0, size) even under cpu speculation
 conditions.
 
-This can be used to protect the earlier load_array() example:
+This can be used to protect the earlier load_array() example::
 
 	int load_array(int *array, unsigned int index)
 	{
-- 
2.20.1

[PATCH 10/10] docs: add plain text files to ReST output from subdirs

[Mauro Carvalho Chehab]

Those files are still in text mode. Still, let's add to the
ReST output documents as literal ones. They can be later moved
to ReST format.

Please notice that ABI and bindings are different beasts. So,
for now, keep them out of the documentation.

This patch was generated by the following bash script:

DIRS=$(dirname $(find Documentation/ -maxdepth 2 -name *.txt)|sort|uniq|grep -v output|grep -v ABI|grep -v bindings|grep -v devicetree)

for d in $DIRS; do
        if [ "$d" == "Documentation" ]; then
                continue
        fi
        echo "Processing dir $d" >&2
        if [ ! -e $d/index.rst ]; then
                for i in $(find $d -name *.txt); do
                        b=$(echo $i|sed s,$d/,,)
                        j=$(basename $i)
                        j=${j/.txt/};
                        j=${j//-/ };
                        j=${j//_/ }
                        echo -e "$j"
                        for k in $(seq 1 $(echo -n $j|wc -c)); do
                                echo -n "-"
                        done
                        echo -e "\n\n .. include:: $b\n    :literal:\n"
                done > $d/text_files.rst

                b=$(basename $d)
                (for k in $(seq 1 $(echo -n $b|wc -c)); do
                        echo -n "="
                done
                echo -e "\n$b"
                for k in $(seq 1 $(echo -n $b|wc -c)); do
                        echo -n "="
                done
                echo -e "\n\n.. toctree::\n    :maxdepth: 1\n\n    text_files.rst"
                for i in $(find $d -name *.rst|grep -v index.rst|grep -v text_files.rst); do
                        n=$(echo $i|sed s,Documentation/$b/,,)
                        echo "    $n"
                done

                echo -e "\n.. only::  subproject and html\n\n   Indices\n   =======\n\n   * :ref:\`genindex\`"
                ) > $d/index.rst

                echo "   $d/index" |sed s,Documentation/,, >> to_add
        fi
done

Please notice that some adjustment was needed in order to
handle Documentation/features.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/EDID/index.rst                 |  15 ++
 Documentation/EDID/text_files.rst            |   6 +
 Documentation/PCI/index.rst                  |  15 ++
 Documentation/PCI/text_files.rst             |  72 ++++++
 Documentation/RCU/index.rst                  |  15 ++
 Documentation/RCU/text_files.rst             |  96 +++++++
 Documentation/accounting/index.rst           |  15 ++
 Documentation/accounting/text_files.rst      |  30 +++
 Documentation/acpi/index.rst                 |  15 ++
 Documentation/acpi/text_files.rst            | 138 ++++++++++
 Documentation/aoe/index.rst                  |  15 ++
 Documentation/aoe/text_files.rst             |  18 ++
 Documentation/arm/index.rst                  |  21 ++
 Documentation/arm/text_files.rst             | 198 +++++++++++++++
 Documentation/arm64/index.rst                |  15 ++
 Documentation/arm64/text_files.rst           |  72 ++++++
 Documentation/auxdisplay/index.rst           |  15 ++
 Documentation/auxdisplay/text_files.rst      |   6 +
 Documentation/backlight/index.rst            |  15 ++
 Documentation/backlight/text_files.rst       |   6 +
 Documentation/block/index.rst                |  15 ++
 Documentation/block/text_files.rst           |  96 +++++++
 Documentation/blockdev/index.rst             |  15 ++
 Documentation/blockdev/text_files.rst        |  42 ++++
 Documentation/bus-devices/index.rst          |  15 ++
 Documentation/bus-devices/text_files.rst     |   6 +
 Documentation/cdrom/index.rst                |  15 ++
 Documentation/cdrom/text_files.rst           |   6 +
 Documentation/cgroup-v1/index.rst            |  15 ++
 Documentation/cgroup-v1/text_files.rst       |  78 ++++++
 Documentation/cma/index.rst                  |  15 ++
 Documentation/cma/text_files.rst             |   6 +
 Documentation/connector/index.rst            |  15 ++
 Documentation/connector/text_files.rst       |   6 +
 Documentation/console/index.rst              |  15 ++
 Documentation/console/text_files.rst         |   6 +
 Documentation/cpu-freq/index.rst             |  15 ++
 Documentation/cpu-freq/text_files.rst        |  42 ++++
 Documentation/device-mapper/index.rst        |  15 ++
 Documentation/device-mapper/text_files.rst   | 168 +++++++++++++
 Documentation/driver-model/index.rst         |  15 ++
 Documentation/driver-model/text_files.rst    |  60 +++++
 Documentation/early-userspace/index.rst      |  15 ++
 Documentation/early-userspace/text_files.rst |   6 +
 Documentation/extcon/index.rst               |  15 ++
 Documentation/extcon/text_files.rst          |   6 +
 Documentation/fault-injection/index.rst      |  15 ++
 Documentation/fault-injection/text_files.rst |  24 ++
 Documentation/fb/index.rst                   |  15 ++
 Documentation/fb/text_files.rst              | 204 +++++++++++++++
 Documentation/features/index.rst             |  15 ++
 Documentation/features/text_files.rst        | 252 +++++++++++++++++++
 Documentation/fmc/index.rst                  |  15 ++
 Documentation/fmc/text_files.rst             |  60 +++++
 Documentation/fpga/index.rst                 |  15 ++
 Documentation/fpga/text_files.rst            |   6 +
 Documentation/gpio/index.rst                 |  15 ++
 Documentation/gpio/text_files.rst            |   6 +
 Documentation/hid/index.rst                  |  15 ++
 Documentation/hid/text_files.rst             |  42 ++++
 Documentation/hwmon/index.rst                |  15 ++
 Documentation/hwmon/text_files.rst           |   6 +
 Documentation/ia64/index.rst                 |  15 ++
 Documentation/ia64/text_files.rst            |  48 ++++
 Documentation/ide/index.rst                  |  15 ++
 Documentation/ide/text_files.rst             |  18 ++
 Documentation/iio/index.rst                  |  15 ++
 Documentation/iio/text_files.rst             |  12 +
 Documentation/index.rst                      |  81 ++++++
 Documentation/infiniband/index.rst           |  15 ++
 Documentation/infiniband/text_files.rst      |  42 ++++
 Documentation/ioctl/index.rst                |  15 ++
 Documentation/ioctl/text_files.rst           |  30 +++
 Documentation/kbuild/index.rst               |  15 ++
 Documentation/kbuild/text_files.rst          |  42 ++++
 Documentation/kdump/index.rst                |  15 ++
 Documentation/kdump/text_files.rst           |  18 ++
 Documentation/laptops/index.rst              |  16 ++
 Documentation/laptops/text_files.rst         |  42 ++++
 Documentation/leds/index.rst                 |  15 ++
 Documentation/leds/text_files.rst            |  84 +++++++
 Documentation/lightnvm/index.rst             |  15 ++
 Documentation/lightnvm/text_files.rst        |   6 +
 Documentation/livepatch/index.rst            |  15 ++
 Documentation/livepatch/text_files.rst       |  30 +++
 Documentation/locking/index.rst              |  15 ++
 Documentation/locking/text_files.rst         |  48 ++++
 Documentation/m68k/index.rst                 |  15 ++
 Documentation/m68k/text_files.rst            |   6 +
 Documentation/md/index.rst                   |  15 ++
 Documentation/md/text_files.rst              |  18 ++
 Documentation/memory-devices/index.rst       |  15 ++
 Documentation/memory-devices/text_files.rst  |   6 +
 Documentation/mic/index.rst                  |  15 ++
 Documentation/mic/text_files.rst             |  12 +
 Documentation/mmc/index.rst                  |  15 ++
 Documentation/mmc/text_files.rst             |  24 ++
 Documentation/mtd/index.rst                  |  15 ++
 Documentation/mtd/text_files.rst             |  18 ++
 Documentation/namespaces/index.rst           |  15 ++
 Documentation/namespaces/text_files.rst      |  12 +
 Documentation/netlabel/index.rst             |  15 ++
 Documentation/netlabel/text_files.rst        |  24 ++
 Documentation/nfc/index.rst                  |  15 ++
 Documentation/nfc/text_files.rst             |  12 +
 Documentation/nvdimm/index.rst               |  15 ++
 Documentation/nvdimm/text_files.rst          |  18 ++
 Documentation/nvmem/index.rst                |  15 ++
 Documentation/nvmem/text_files.rst           |   6 +
 Documentation/pcmcia/index.rst               |  15 ++
 Documentation/pcmcia/text_files.rst          |  24 ++
 Documentation/perf/index.rst                 |  15 ++
 Documentation/perf/text_files.rst            |  42 ++++
 Documentation/phy/index.rst                  |  15 ++
 Documentation/phy/text_files.rst             |   6 +
 Documentation/platform/index.rst             |  15 ++
 Documentation/platform/text_files.rst        |   6 +
 Documentation/power/index.rst                |  15 ++
 Documentation/power/text_files.rst           | 162 ++++++++++++
 Documentation/powerpc/index.rst              |  16 ++
 Documentation/powerpc/text_files.rst         | 102 ++++++++
 Documentation/pps/index.rst                  |  15 ++
 Documentation/pps/text_files.rst             |   6 +
 Documentation/pti/index.rst                  |  15 ++
 Documentation/pti/text_files.rst             |   6 +
 Documentation/ptp/index.rst                  |  15 ++
 Documentation/ptp/text_files.rst             |   6 +
 Documentation/rapidio/index.rst              |  15 ++
 Documentation/rapidio/text_files.rst         |  30 +++
 Documentation/riscv/index.rst                |  15 ++
 Documentation/riscv/text_files.rst           |   6 +
 Documentation/s390/index.rst                 |  15 ++
 Documentation/s390/text_files.rst            |  60 +++++
 Documentation/scheduler/index.rst            |  15 ++
 Documentation/scheduler/text_files.rst       |  60 +++++
 Documentation/scsi/index.rst                 |  15 ++
 Documentation/scsi/text_files.rst            | 246 ++++++++++++++++++
 Documentation/serial/index.rst               |  15 ++
 Documentation/serial/text_files.rst          |  30 +++
 Documentation/sparc/index.rst                |  15 ++
 Documentation/sparc/text_files.rst           |  24 ++
 Documentation/sphinx/index.rst               |  15 ++
 Documentation/sphinx/text_files.rst          |   6 +
 Documentation/sysctl/index.rst               |  15 ++
 Documentation/sysctl/text_files.rst          |  42 ++++
 Documentation/target/index.rst               |  15 ++
 Documentation/target/text_files.rst          |  12 +
 Documentation/thermal/index.rst              |  15 ++
 Documentation/thermal/text_files.rst         |  24 ++
 Documentation/timers/index.rst               |  15 ++
 Documentation/timers/text_files.rst          |  36 +++
 Documentation/usb/index.rst                  |  15 ++
 Documentation/usb/text_files.rst             | 138 ++++++++++
 Documentation/virtual/index.rst              |  17 ++
 Documentation/virtual/text_files.rst         | 150 +++++++++++
 Documentation/watchdog/index.rst             |  15 ++
 Documentation/watchdog/text_files.rst        |  54 ++++
 Documentation/x86/index.rst                  |  15 ++
 Documentation/x86/text_files.rst             | 132 ++++++++++
 Documentation/xilinx/index.rst               |  15 ++
 Documentation/xilinx/text_files.rst          |   6 +
 Documentation/xtensa/index.rst               |  15 ++
 Documentation/xtensa/text_files.rst          |  18 ++
 163 files changed, 5086 insertions(+)
 create mode 100644 Documentation/EDID/index.rst
 create mode 100644 Documentation/EDID/text_files.rst
 create mode 100644 Documentation/PCI/index.rst
 create mode 100644 Documentation/PCI/text_files.rst
 create mode 100644 Documentation/RCU/index.rst
 create mode 100644 Documentation/RCU/text_files.rst
 create mode 100644 Documentation/accounting/index.rst
 create mode 100644 Documentation/accounting/text_files.rst
 create mode 100644 Documentation/acpi/index.rst
 create mode 100644 Documentation/acpi/text_files.rst
 create mode 100644 Documentation/aoe/index.rst
 create mode 100644 Documentation/aoe/text_files.rst
 create mode 100644 Documentation/arm/index.rst
 create mode 100644 Documentation/arm/text_files.rst
 create mode 100644 Documentation/arm64/index.rst
 create mode 100644 Documentation/arm64/text_files.rst
 create mode 100644 Documentation/auxdisplay/index.rst
 create mode 100644 Documentation/auxdisplay/text_files.rst
 create mode 100644 Documentation/backlight/index.rst
 create mode 100644 Documentation/backlight/text_files.rst
 create mode 100644 Documentation/block/index.rst
 create mode 100644 Documentation/block/text_files.rst
 create mode 100644 Documentation/blockdev/index.rst
 create mode 100644 Documentation/blockdev/text_files.rst
 create mode 100644 Documentation/bus-devices/index.rst
 create mode 100644 Documentation/bus-devices/text_files.rst
 create mode 100644 Documentation/cdrom/index.rst
 create mode 100644 Documentation/cdrom/text_files.rst
 create mode 100644 Documentation/cgroup-v1/index.rst
 create mode 100644 Documentation/cgroup-v1/text_files.rst
 create mode 100644 Documentation/cma/index.rst
 create mode 100644 Documentation/cma/text_files.rst
 create mode 100644 Documentation/connector/index.rst
 create mode 100644 Documentation/connector/text_files.rst
 create mode 100644 Documentation/console/index.rst
 create mode 100644 Documentation/console/text_files.rst
 create mode 100644 Documentation/cpu-freq/index.rst
 create mode 100644 Documentation/cpu-freq/text_files.rst
 create mode 100644 Documentation/device-mapper/index.rst
 create mode 100644 Documentation/device-mapper/text_files.rst
 create mode 100644 Documentation/driver-model/index.rst
 create mode 100644 Documentation/driver-model/text_files.rst
 create mode 100644 Documentation/early-userspace/index.rst
 create mode 100644 Documentation/early-userspace/text_files.rst
 create mode 100644 Documentation/extcon/index.rst
 create mode 100644 Documentation/extcon/text_files.rst
 create mode 100644 Documentation/fault-injection/index.rst
 create mode 100644 Documentation/fault-injection/text_files.rst
 create mode 100644 Documentation/fb/index.rst
 create mode 100644 Documentation/fb/text_files.rst
 create mode 100644 Documentation/features/index.rst
 create mode 100644 Documentation/features/text_files.rst
 create mode 100644 Documentation/fmc/index.rst
 create mode 100644 Documentation/fmc/text_files.rst
 create mode 100644 Documentation/fpga/index.rst
 create mode 100644 Documentation/fpga/text_files.rst
 create mode 100644 Documentation/gpio/index.rst
 create mode 100644 Documentation/gpio/text_files.rst
 create mode 100644 Documentation/hid/index.rst
 create mode 100644 Documentation/hid/text_files.rst
 create mode 100644 Documentation/hwmon/index.rst
 create mode 100644 Documentation/hwmon/text_files.rst
 create mode 100644 Documentation/ia64/index.rst
 create mode 100644 Documentation/ia64/text_files.rst
 create mode 100644 Documentation/ide/index.rst
 create mode 100644 Documentation/ide/text_files.rst
 create mode 100644 Documentation/iio/index.rst
 create mode 100644 Documentation/iio/text_files.rst
 create mode 100644 Documentation/infiniband/index.rst
 create mode 100644 Documentation/infiniband/text_files.rst
 create mode 100644 Documentation/ioctl/index.rst
 create mode 100644 Documentation/ioctl/text_files.rst
 create mode 100644 Documentation/kbuild/index.rst
 create mode 100644 Documentation/kbuild/text_files.rst
 create mode 100644 Documentation/kdump/index.rst
 create mode 100644 Documentation/kdump/text_files.rst
 create mode 100644 Documentation/laptops/index.rst
 create mode 100644 Documentation/laptops/text_files.rst
 create mode 100644 Documentation/leds/index.rst
 create mode 100644 Documentation/leds/text_files.rst
 create mode 100644 Documentation/lightnvm/index.rst
 create mode 100644 Documentation/lightnvm/text_files.rst
 create mode 100644 Documentation/livepatch/index.rst
 create mode 100644 Documentation/livepatch/text_files.rst
 create mode 100644 Documentation/locking/index.rst
 create mode 100644 Documentation/locking/text_files.rst
 create mode 100644 Documentation/m68k/index.rst
 create mode 100644 Documentation/m68k/text_files.rst
 create mode 100644 Documentation/md/index.rst
 create mode 100644 Documentation/md/text_files.rst
 create mode 100644 Documentation/memory-devices/index.rst
 create mode 100644 Documentation/memory-devices/text_files.rst
 create mode 100644 Documentation/mic/index.rst
 create mode 100644 Documentation/mic/text_files.rst
 create mode 100644 Documentation/mmc/index.rst
 create mode 100644 Documentation/mmc/text_files.rst
 create mode 100644 Documentation/mtd/index.rst
 create mode 100644 Documentation/mtd/text_files.rst
 create mode 100644 Documentation/namespaces/index.rst
 create mode 100644 Documentation/namespaces/text_files.rst
 create mode 100644 Documentation/netlabel/index.rst
 create mode 100644 Documentation/netlabel/text_files.rst
 create mode 100644 Documentation/nfc/index.rst
 create mode 100644 Documentation/nfc/text_files.rst
 create mode 100644 Documentation/nvdimm/index.rst
 create mode 100644 Documentation/nvdimm/text_files.rst
 create mode 100644 Documentation/nvmem/index.rst
 create mode 100644 Documentation/nvmem/text_files.rst
 create mode 100644 Documentation/pcmcia/index.rst
 create mode 100644 Documentation/pcmcia/text_files.rst
 create mode 100644 Documentation/perf/index.rst
 create mode 100644 Documentation/perf/text_files.rst
 create mode 100644 Documentation/phy/index.rst
 create mode 100644 Documentation/phy/text_files.rst
 create mode 100644 Documentation/platform/index.rst
 create mode 100644 Documentation/platform/text_files.rst
 create mode 100644 Documentation/power/index.rst
 create mode 100644 Documentation/power/text_files.rst
 create mode 100644 Documentation/powerpc/index.rst
 create mode 100644 Documentation/powerpc/text_files.rst
 create mode 100644 Documentation/pps/index.rst
 create mode 100644 Documentation/pps/text_files.rst
 create mode 100644 Documentation/pti/index.rst
 create mode 100644 Documentation/pti/text_files.rst
 create mode 100644 Documentation/ptp/index.rst
 create mode 100644 Documentation/ptp/text_files.rst
 create mode 100644 Documentation/rapidio/index.rst
 create mode 100644 Documentation/rapidio/text_files.rst
 create mode 100644 Documentation/riscv/index.rst
 create mode 100644 Documentation/riscv/text_files.rst
 create mode 100644 Documentation/s390/index.rst
 create mode 100644 Documentation/s390/text_files.rst
 create mode 100644 Documentation/scheduler/index.rst
 create mode 100644 Documentation/scheduler/text_files.rst
 create mode 100644 Documentation/scsi/index.rst
 create mode 100644 Documentation/scsi/text_files.rst
 create mode 100644 Documentation/serial/index.rst
 create mode 100644 Documentation/serial/text_files.rst
 create mode 100644 Documentation/sparc/index.rst
 create mode 100644 Documentation/sparc/text_files.rst
 create mode 100644 Documentation/sphinx/index.rst
 create mode 100644 Documentation/sphinx/text_files.rst
 create mode 100644 Documentation/sysctl/index.rst
 create mode 100644 Documentation/sysctl/text_files.rst
 create mode 100644 Documentation/target/index.rst
 create mode 100644 Documentation/target/text_files.rst
 create mode 100644 Documentation/thermal/index.rst
 create mode 100644 Documentation/thermal/text_files.rst
 create mode 100644 Documentation/timers/index.rst
 create mode 100644 Documentation/timers/text_files.rst
 create mode 100644 Documentation/usb/index.rst
 create mode 100644 Documentation/usb/text_files.rst
 create mode 100644 Documentation/virtual/index.rst
 create mode 100644 Documentation/virtual/text_files.rst
 create mode 100644 Documentation/watchdog/index.rst
 create mode 100644 Documentation/watchdog/text_files.rst
 create mode 100644 Documentation/x86/index.rst
 create mode 100644 Documentation/x86/text_files.rst
 create mode 100644 Documentation/xilinx/index.rst
 create mode 100644 Documentation/xilinx/text_files.rst
 create mode 100644 Documentation/xtensa/index.rst
 create mode 100644 Documentation/xtensa/text_files.rst

diff --git a/Documentation/EDID/index.rst b/Documentation/EDID/index.rst
new file mode 100644
index 000000000000..f1c4e0f806ca
--- /dev/null
+++ b/Documentation/EDID/index.rst
@@ -0,0 +1,15 @@
+====
+EDID
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/EDID/text_files.rst b/Documentation/EDID/text_files.rst
new file mode 100644
index 000000000000..b05085389fb4
--- /dev/null
+++ b/Documentation/EDID/text_files.rst
@@ -0,0 +1,6 @@
+HOWTO
+-----
+
+ .. include:: HOWTO.txt
+    :literal:
+
diff --git a/Documentation/PCI/index.rst b/Documentation/PCI/index.rst
new file mode 100644
index 000000000000..52769a4009c4
--- /dev/null
+++ b/Documentation/PCI/index.rst
@@ -0,0 +1,15 @@
+===
+PCI
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/PCI/text_files.rst b/Documentation/PCI/text_files.rst
new file mode 100644
index 000000000000..f59502191f59
--- /dev/null
+++ b/Documentation/PCI/text_files.rst
@@ -0,0 +1,72 @@
+acpi info
+---------
+
+ .. include:: acpi-info.txt
+    :literal:
+
+pci
+---
+
+ .. include:: pci.txt
+    :literal:
+
+PCIEBUS HOWTO
+-------------
+
+ .. include:: PCIEBUS-HOWTO.txt
+    :literal:
+
+MSI HOWTO
+---------
+
+ .. include:: MSI-HOWTO.txt
+    :literal:
+
+pcieaer howto
+-------------
+
+ .. include:: pcieaer-howto.txt
+    :literal:
+
+pci test
+--------
+
+ .. include:: endpoint/function/binding/pci-test.txt
+    :literal:
+
+pci test function
+-----------------
+
+ .. include:: endpoint/pci-test-function.txt
+    :literal:
+
+pci test howto
+--------------
+
+ .. include:: endpoint/pci-test-howto.txt
+    :literal:
+
+pci endpoint
+------------
+
+ .. include:: endpoint/pci-endpoint.txt
+    :literal:
+
+pci endpoint cfs
+----------------
+
+ .. include:: endpoint/pci-endpoint-cfs.txt
+    :literal:
+
+pci error recovery
+------------------
+
+ .. include:: pci-error-recovery.txt
+    :literal:
+
+pci iov howto
+-------------
+
+ .. include:: pci-iov-howto.txt
+    :literal:
+
diff --git a/Documentation/RCU/index.rst b/Documentation/RCU/index.rst
new file mode 100644
index 000000000000..b52c9223494c
--- /dev/null
+++ b/Documentation/RCU/index.rst
@@ -0,0 +1,15 @@
+===
+RCU
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/RCU/text_files.rst b/Documentation/RCU/text_files.rst
new file mode 100644
index 000000000000..6884e903d370
--- /dev/null
+++ b/Documentation/RCU/text_files.rst
@@ -0,0 +1,96 @@
+arrayRCU
+--------
+
+ .. include:: arrayRCU.txt
+    :literal:
+
+rcu
+---
+
+ .. include:: rcu.txt
+    :literal:
+
+rcu dereference
+---------------
+
+ .. include:: rcu_dereference.txt
+    :literal:
+
+RTFP
+----
+
+ .. include:: RTFP.txt
+    :literal:
+
+lockdep splat
+-------------
+
+ .. include:: lockdep-splat.txt
+    :literal:
+
+whatisRCU
+---------
+
+ .. include:: whatisRCU.txt
+    :literal:
+
+rcubarrier
+----------
+
+ .. include:: rcubarrier.txt
+    :literal:
+
+UP
+--
+
+ .. include:: UP.txt
+    :literal:
+
+torture
+-------
+
+ .. include:: torture.txt
+    :literal:
+
+listRCU
+-------
+
+ .. include:: listRCU.txt
+    :literal:
+
+lockdep
+-------
+
+ .. include:: lockdep.txt
+    :literal:
+
+rculist nulls
+-------------
+
+ .. include:: rculist_nulls.txt
+    :literal:
+
+rcuref
+------
+
+ .. include:: rcuref.txt
+    :literal:
+
+stallwarn
+---------
+
+ .. include:: stallwarn.txt
+    :literal:
+
+checklist
+---------
+
+ .. include:: checklist.txt
+    :literal:
+
+NMI RCU
+-------
+
+ .. include:: NMI-RCU.txt
+    :literal:
+
diff --git a/Documentation/accounting/index.rst b/Documentation/accounting/index.rst
new file mode 100644
index 000000000000..8c4463425a55
--- /dev/null
+++ b/Documentation/accounting/index.rst
@@ -0,0 +1,15 @@
+==========
+accounting
+==========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/accounting/text_files.rst b/Documentation/accounting/text_files.rst
new file mode 100644
index 000000000000..54b3b5417d07
--- /dev/null
+++ b/Documentation/accounting/text_files.rst
@@ -0,0 +1,30 @@
+cgroupstats
+-----------
+
+ .. include:: cgroupstats.txt
+    :literal:
+
+delay accounting
+----------------
+
+ .. include:: delay-accounting.txt
+    :literal:
+
+taskstats struct
+----------------
+
+ .. include:: taskstats-struct.txt
+    :literal:
+
+taskstats
+---------
+
+ .. include:: taskstats.txt
+    :literal:
+
+psi
+---
+
+ .. include:: psi.txt
+    :literal:
+
diff --git a/Documentation/acpi/index.rst b/Documentation/acpi/index.rst
new file mode 100644
index 000000000000..9cd1512c9e57
--- /dev/null
+++ b/Documentation/acpi/index.rst
@@ -0,0 +1,15 @@
+====
+acpi
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/acpi/text_files.rst b/Documentation/acpi/text_files.rst
new file mode 100644
index 000000000000..a59a9b4b055e
--- /dev/null
+++ b/Documentation/acpi/text_files.rst
@@ -0,0 +1,138 @@
+cppc sysfs
+----------
+
+ .. include:: cppc_sysfs.txt
+    :literal:
+
+graph
+-----
+
+ .. include:: dsd/graph.txt
+    :literal:
+
+data node references
+--------------------
+
+ .. include:: dsd/data-node-references.txt
+    :literal:
+
+method tracing
+--------------
+
+ .. include:: method-tracing.txt
+    :literal:
+
+method customizing
+------------------
+
+ .. include:: method-customizing.txt
+    :literal:
+
+ssdt overlays
+-------------
+
+ .. include:: ssdt-overlays.txt
+    :literal:
+
+gpio properties
+---------------
+
+ .. include:: gpio-properties.txt
+    :literal:
+
+namespace
+---------
+
+ .. include:: namespace.txt
+    :literal:
+
+initrd table override
+---------------------
+
+ .. include:: initrd_table_override.txt
+    :literal:
+
+video extension
+---------------
+
+ .. include:: video_extension.txt
+    :literal:
+
+aml debugger
+------------
+
+ .. include:: aml-debugger.txt
+    :literal:
+
+scan handlers
+-------------
+
+ .. include:: scan_handlers.txt
+    :literal:
+
+linuxized acpica
+----------------
+
+ .. include:: linuxized-acpica.txt
+    :literal:
+
+lpit
+----
+
+ .. include:: lpit.txt
+    :literal:
+
+enumeration
+-----------
+
+ .. include:: enumeration.txt
+    :literal:
+
+DSD properties rules
+--------------------
+
+ .. include:: DSD-properties-rules.txt
+    :literal:
+
+output format
+-------------
+
+ .. include:: apei/output_format.txt
+    :literal:
+
+einj
+----
+
+ .. include:: apei/einj.txt
+    :literal:
+
+acpi lid
+--------
+
+ .. include:: acpi-lid.txt
+    :literal:
+
+dsdt override
+-------------
+
+ .. include:: dsdt-override.txt
+    :literal:
+
+i2c muxes
+---------
+
+ .. include:: i2c-muxes.txt
+    :literal:
+
+osi
+---
+
+ .. include:: osi.txt
+    :literal:
+
+debug
+-----
+
+ .. include:: debug.txt
+    :literal:
+
diff --git a/Documentation/aoe/index.rst b/Documentation/aoe/index.rst
new file mode 100644
index 000000000000..78050a63702b
--- /dev/null
+++ b/Documentation/aoe/index.rst
@@ -0,0 +1,15 @@
+===
+aoe
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/aoe/text_files.rst b/Documentation/aoe/text_files.rst
new file mode 100644
index 000000000000..cb25a9871779
--- /dev/null
+++ b/Documentation/aoe/text_files.rst
@@ -0,0 +1,18 @@
+udev
+----
+
+ .. include:: udev.txt
+    :literal:
+
+aoe
+---
+
+ .. include:: aoe.txt
+    :literal:
+
+todo
+----
+
+ .. include:: todo.txt
+    :literal:
+
diff --git a/Documentation/arm/index.rst b/Documentation/arm/index.rst
new file mode 100644
index 000000000000..ef6fae3506e6
--- /dev/null
+++ b/Documentation/arm/index.rst
@@ -0,0 +1,21 @@
+===
+arm
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+    stm32/stm32f746-overview.rst
+    stm32/overview.rst
+    stm32/stm32h743-overview.rst
+    stm32/stm32f769-overview.rst
+    stm32/stm32f429-overview.rst
+    stm32/stm32mp157-overview.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/arm/text_files.rst b/Documentation/arm/text_files.rst
new file mode 100644
index 000000000000..afb02862fccd
--- /dev/null
+++ b/Documentation/arm/text_files.rst
@@ -0,0 +1,198 @@
+tcm
+---
+
+ .. include:: tcm.txt
+    :literal:
+
+kernel user helpers
+-------------------
+
+ .. include:: kernel_user_helpers.txt
+    :literal:
+
+cluster pm race avoidance
+-------------------------
+
+ .. include:: cluster-pm-race-avoidance.txt
+    :literal:
+
+firmware
+--------
+
+ .. include:: firmware.txt
+    :literal:
+
+release notes
+-------------
+
+ .. include:: VFP/release-notes.txt
+    :literal:
+
+uefi
+----
+
+ .. include:: uefi.txt
+    :literal:
+
+Suspend
+-------
+
+ .. include:: Samsung-S3C24XX/Suspend.txt
+    :literal:
+
+H1940
+-----
+
+ .. include:: Samsung-S3C24XX/H1940.txt
+    :literal:
+
+CPUfreq
+-------
+
+ .. include:: Samsung-S3C24XX/CPUfreq.txt
+    :literal:
+
+Overview
+--------
+
+ .. include:: Samsung-S3C24XX/Overview.txt
+    :literal:
+
+NAND
+----
+
+ .. include:: Samsung-S3C24XX/NAND.txt
+    :literal:
+
+GPIO
+----
+
+ .. include:: Samsung-S3C24XX/GPIO.txt
+    :literal:
+
+S3C2412
+-------
+
+ .. include:: Samsung-S3C24XX/S3C2412.txt
+    :literal:
+
+EB2410ITX
+---------
+
+ .. include:: Samsung-S3C24XX/EB2410ITX.txt
+    :literal:
+
+USB Host
+--------
+
+ .. include:: Samsung-S3C24XX/USB-Host.txt
+    :literal:
+
+SMDK2440
+--------
+
+ .. include:: Samsung-S3C24XX/SMDK2440.txt
+    :literal:
+
+S3C2413
+-------
+
+ .. include:: Samsung-S3C24XX/S3C2413.txt
+    :literal:
+
+clocks
+------
+
+ .. include:: sunxi/clocks.txt
+    :literal:
+
+memory
+------
+
+ .. include:: memory.txt
+    :literal:
+
+overview
+--------
+
+ .. include:: SPEAr/overview.txt
+    :literal:
+
+vlocks
+------
+
+ .. include:: vlocks.txt
+    :literal:
+
+Overview
+--------
+
+ .. include:: keystone/Overview.txt
+    :literal:
+
+knav qmss
+---------
+
+ .. include:: keystone/knav-qmss.txt
+    :literal:
+
+mfp
+---
+
+ .. include:: pxa/mfp.txt
+    :literal:
+
+Overview
+--------
+
+ .. include:: Samsung/Overview.txt
+    :literal:
+
+GPIO
+----
+
+ .. include:: Samsung/GPIO.txt
+    :literal:
+
+Bootloader interface
+--------------------
+
+ .. include:: Samsung/Bootloader-interface.txt
+    :literal:
+
+kernel mode neon
+----------------
+
+ .. include:: kernel_mode_neon.txt
+    :literal:
+
+stih418 overview
+----------------
+
+ .. include:: sti/stih418-overview.txt
+    :literal:
+
+stih416 overview
+----------------
+
+ .. include:: sti/stih416-overview.txt
+    :literal:
+
+overview
+--------
+
+ .. include:: sti/overview.txt
+    :literal:
+
+stih407 overview
+----------------
+
+ .. include:: sti/stih407-overview.txt
+    :literal:
+
+stih415 overview
+----------------
+
+ .. include:: sti/stih415-overview.txt
+    :literal:
+
diff --git a/Documentation/arm64/index.rst b/Documentation/arm64/index.rst
new file mode 100644
index 000000000000..0a6dac4bf859
--- /dev/null
+++ b/Documentation/arm64/index.rst
@@ -0,0 +1,15 @@
+=====
+arm64
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/arm64/text_files.rst b/Documentation/arm64/text_files.rst
new file mode 100644
index 000000000000..398011cd944d
--- /dev/null
+++ b/Documentation/arm64/text_files.rst
@@ -0,0 +1,72 @@
+sve
+---
+
+ .. include:: sve.txt
+    :literal:
+
+acpi object usage
+-----------------
+
+ .. include:: acpi_object_usage.txt
+    :literal:
+
+tagged pointers
+---------------
+
+ .. include:: tagged-pointers.txt
+    :literal:
+
+booting
+-------
+
+ .. include:: booting.txt
+    :literal:
+
+memory
+------
+
+ .. include:: memory.txt
+    :literal:
+
+arm acpi
+--------
+
+ .. include:: arm-acpi.txt
+    :literal:
+
+legacy instructions
+-------------------
+
+ .. include:: legacy_instructions.txt
+    :literal:
+
+silicon errata
+--------------
+
+ .. include:: silicon-errata.txt
+    :literal:
+
+cpu feature registers
+---------------------
+
+ .. include:: cpu-feature-registers.txt
+    :literal:
+
+hugetlbpage
+-----------
+
+ .. include:: hugetlbpage.txt
+    :literal:
+
+pointer authentication
+----------------------
+
+ .. include:: pointer-authentication.txt
+    :literal:
+
+elf hwcaps
+----------
+
+ .. include:: elf_hwcaps.txt
+    :literal:
+
diff --git a/Documentation/auxdisplay/index.rst b/Documentation/auxdisplay/index.rst
new file mode 100644
index 000000000000..35e70695cab0
--- /dev/null
+++ b/Documentation/auxdisplay/index.rst
@@ -0,0 +1,15 @@
+==========
+auxdisplay
+==========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/auxdisplay/text_files.rst b/Documentation/auxdisplay/text_files.rst
new file mode 100644
index 000000000000..204db9460ec5
--- /dev/null
+++ b/Documentation/auxdisplay/text_files.rst
@@ -0,0 +1,6 @@
+lcd panel cgram
+---------------
+
+ .. include:: lcd-panel-cgram.txt
+    :literal:
+
diff --git a/Documentation/backlight/index.rst b/Documentation/backlight/index.rst
new file mode 100644
index 000000000000..7f24f0c11dab
--- /dev/null
+++ b/Documentation/backlight/index.rst
@@ -0,0 +1,15 @@
+=========
+backlight
+=========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/backlight/text_files.rst b/Documentation/backlight/text_files.rst
new file mode 100644
index 000000000000..2c6d750ee3be
--- /dev/null
+++ b/Documentation/backlight/text_files.rst
@@ -0,0 +1,6 @@
+lp855x driver
+-------------
+
+ .. include:: lp855x-driver.txt
+    :literal:
+
diff --git a/Documentation/block/index.rst b/Documentation/block/index.rst
new file mode 100644
index 000000000000..f7193d23a254
--- /dev/null
+++ b/Documentation/block/index.rst
@@ -0,0 +1,15 @@
+=====
+block
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/block/text_files.rst b/Documentation/block/text_files.rst
new file mode 100644
index 000000000000..9c07df138250
--- /dev/null
+++ b/Documentation/block/text_files.rst
@@ -0,0 +1,96 @@
+cmdline partition
+-----------------
+
+ .. include:: cmdline-partition.txt
+    :literal:
+
+biovecs
+-------
+
+ .. include:: biovecs.txt
+    :literal:
+
+writeback cache control
+-----------------------
+
+ .. include:: writeback_cache_control.txt
+    :literal:
+
+queue sysfs
+-----------
+
+ .. include:: queue-sysfs.txt
+    :literal:
+
+capability
+----------
+
+ .. include:: capability.txt
+    :literal:
+
+deadline iosched
+----------------
+
+ .. include:: deadline-iosched.txt
+    :literal:
+
+switching sched
+---------------
+
+ .. include:: switching-sched.txt
+    :literal:
+
+stat
+----
+
+ .. include:: stat.txt
+    :literal:
+
+biodoc
+------
+
+ .. include:: biodoc.txt
+    :literal:
+
+pr
+--
+
+ .. include:: pr.txt
+    :literal:
+
+kyber iosched
+-------------
+
+ .. include:: kyber-iosched.txt
+    :literal:
+
+data integrity
+--------------
+
+ .. include:: data-integrity.txt
+    :literal:
+
+bfq iosched
+-----------
+
+ .. include:: bfq-iosched.txt
+    :literal:
+
+request
+-------
+
+ .. include:: request.txt
+    :literal:
+
+null blk
+--------
+
+ .. include:: null_blk.txt
+    :literal:
+
+ioprio
+------
+
+ .. include:: ioprio.txt
+    :literal:
+
diff --git a/Documentation/blockdev/index.rst b/Documentation/blockdev/index.rst
new file mode 100644
index 000000000000..23fd7b3be569
--- /dev/null
+++ b/Documentation/blockdev/index.rst
@@ -0,0 +1,15 @@
+========
+blockdev
+========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/blockdev/text_files.rst b/Documentation/blockdev/text_files.rst
new file mode 100644
index 000000000000..beada1e885b7
--- /dev/null
+++ b/Documentation/blockdev/text_files.rst
@@ -0,0 +1,42 @@
+nbd
+---
+
+ .. include:: nbd.txt
+    :literal:
+
+floppy
+------
+
+ .. include:: floppy.txt
+    :literal:
+
+paride
+------
+
+ .. include:: paride.txt
+    :literal:
+
+data structure v9
+-----------------
+
+ .. include:: drbd/data-structure-v9.txt
+    :literal:
+
+README
+------
+
+ .. include:: drbd/README.txt
+    :literal:
+
+zram
+----
+
+ .. include:: zram.txt
+    :literal:
+
+ramdisk
+-------
+
+ .. include:: ramdisk.txt
+    :literal:
+
diff --git a/Documentation/bus-devices/index.rst b/Documentation/bus-devices/index.rst
new file mode 100644
index 000000000000..54c123411adf
--- /dev/null
+++ b/Documentation/bus-devices/index.rst
@@ -0,0 +1,15 @@
+===========
+bus-devices
+===========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/bus-devices/text_files.rst b/Documentation/bus-devices/text_files.rst
new file mode 100644
index 000000000000..d2b7d46934a0
--- /dev/null
+++ b/Documentation/bus-devices/text_files.rst
@@ -0,0 +1,6 @@
+ti gpmc
+-------
+
+ .. include:: ti-gpmc.txt
+    :literal:
+
diff --git a/Documentation/cdrom/index.rst b/Documentation/cdrom/index.rst
new file mode 100644
index 000000000000..700d405d23c2
--- /dev/null
+++ b/Documentation/cdrom/index.rst
@@ -0,0 +1,15 @@
+=====
+cdrom
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/cdrom/text_files.rst b/Documentation/cdrom/text_files.rst
new file mode 100644
index 000000000000..da0302b144ba
--- /dev/null
+++ b/Documentation/cdrom/text_files.rst
@@ -0,0 +1,6 @@
+packet writing
+--------------
+
+ .. include:: packet-writing.txt
+    :literal:
+
diff --git a/Documentation/cgroup-v1/index.rst b/Documentation/cgroup-v1/index.rst
new file mode 100644
index 000000000000..a7036617328c
--- /dev/null
+++ b/Documentation/cgroup-v1/index.rst
@@ -0,0 +1,15 @@
+=========
+cgroup-v1
+=========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/cgroup-v1/text_files.rst b/Documentation/cgroup-v1/text_files.rst
new file mode 100644
index 000000000000..0dd5ac6e1710
--- /dev/null
+++ b/Documentation/cgroup-v1/text_files.rst
@@ -0,0 +1,78 @@
+devices
+-------
+
+ .. include:: devices.txt
+    :literal:
+
+cpusets
+-------
+
+ .. include:: cpusets.txt
+    :literal:
+
+net cls
+-------
+
+ .. include:: net_cls.txt
+    :literal:
+
+freezer subsystem
+-----------------
+
+ .. include:: freezer-subsystem.txt
+    :literal:
+
+memory
+------
+
+ .. include:: memory.txt
+    :literal:
+
+memcg test
+----------
+
+ .. include:: memcg_test.txt
+    :literal:
+
+net prio
+--------
+
+ .. include:: net_prio.txt
+    :literal:
+
+hugetlb
+-------
+
+ .. include:: hugetlb.txt
+    :literal:
+
+cgroups
+-------
+
+ .. include:: cgroups.txt
+    :literal:
+
+rdma
+----
+
+ .. include:: rdma.txt
+    :literal:
+
+cpuacct
+-------
+
+ .. include:: cpuacct.txt
+    :literal:
+
+pids
+----
+
+ .. include:: pids.txt
+    :literal:
+
+blkio controller
+----------------
+
+ .. include:: blkio-controller.txt
+    :literal:
+
diff --git a/Documentation/cma/index.rst b/Documentation/cma/index.rst
new file mode 100644
index 000000000000..d4c0e3eaefe7
--- /dev/null
+++ b/Documentation/cma/index.rst
@@ -0,0 +1,15 @@
+===
+cma
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/cma/text_files.rst b/Documentation/cma/text_files.rst
new file mode 100644
index 000000000000..f40a4d7ef511
--- /dev/null
+++ b/Documentation/cma/text_files.rst
@@ -0,0 +1,6 @@
+debugfs
+-------
+
+ .. include:: debugfs.txt
+    :literal:
+
diff --git a/Documentation/connector/index.rst b/Documentation/connector/index.rst
new file mode 100644
index 000000000000..103749a7fb9f
--- /dev/null
+++ b/Documentation/connector/index.rst
@@ -0,0 +1,15 @@
+=========
+connector
+=========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/connector/text_files.rst b/Documentation/connector/text_files.rst
new file mode 100644
index 000000000000..4ec047a82f53
--- /dev/null
+++ b/Documentation/connector/text_files.rst
@@ -0,0 +1,6 @@
+connector
+---------
+
+ .. include:: connector.txt
+    :literal:
+
diff --git a/Documentation/console/index.rst b/Documentation/console/index.rst
new file mode 100644
index 000000000000..8849d1c15379
--- /dev/null
+++ b/Documentation/console/index.rst
@@ -0,0 +1,15 @@
+=======
+console
+=======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/console/text_files.rst b/Documentation/console/text_files.rst
new file mode 100644
index 000000000000..a9383e21e7c8
--- /dev/null
+++ b/Documentation/console/text_files.rst
@@ -0,0 +1,6 @@
+console
+-------
+
+ .. include:: console.txt
+    :literal:
+
diff --git a/Documentation/cpu-freq/index.rst b/Documentation/cpu-freq/index.rst
new file mode 100644
index 000000000000..d1a7bae5a093
--- /dev/null
+++ b/Documentation/cpu-freq/index.rst
@@ -0,0 +1,15 @@
+========
+cpu-freq
+========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/cpu-freq/text_files.rst b/Documentation/cpu-freq/text_files.rst
new file mode 100644
index 000000000000..017904e28e08
--- /dev/null
+++ b/Documentation/cpu-freq/text_files.rst
@@ -0,0 +1,42 @@
+pcc cpufreq
+-----------
+
+ .. include:: pcc-cpufreq.txt
+    :literal:
+
+amd powernow
+------------
+
+ .. include:: amd-powernow.txt
+    :literal:
+
+index
+-----
+
+ .. include:: index.txt
+    :literal:
+
+cpufreq nforce2
+---------------
+
+ .. include:: cpufreq-nforce2.txt
+    :literal:
+
+cpu drivers
+-----------
+
+ .. include:: cpu-drivers.txt
+    :literal:
+
+core
+----
+
+ .. include:: core.txt
+    :literal:
+
+cpufreq stats
+-------------
+
+ .. include:: cpufreq-stats.txt
+    :literal:
+
diff --git a/Documentation/device-mapper/index.rst b/Documentation/device-mapper/index.rst
new file mode 100644
index 000000000000..4b4e81794ce4
--- /dev/null
+++ b/Documentation/device-mapper/index.rst
@@ -0,0 +1,15 @@
+=============
+device-mapper
+=============
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/device-mapper/text_files.rst b/Documentation/device-mapper/text_files.rst
new file mode 100644
index 000000000000..e9d439c48b75
--- /dev/null
+++ b/Documentation/device-mapper/text_files.rst
@@ -0,0 +1,168 @@
+dm raid
+-------
+
+ .. include:: dm-raid.txt
+    :literal:
+
+era
+---
+
+ .. include:: era.txt
+    :literal:
+
+writecache
+----------
+
+ .. include:: writecache.txt
+    :literal:
+
+verity
+------
+
+ .. include:: verity.txt
+    :literal:
+
+thin provisioning
+-----------------
+
+ .. include:: thin-provisioning.txt
+    :literal:
+
+linear
+------
+
+ .. include:: linear.txt
+    :literal:
+
+dm io
+-----
+
+ .. include:: dm-io.txt
+    :literal:
+
+dm init
+-------
+
+ .. include:: dm-init.txt
+    :literal:
+
+kcopyd
+------
+
+ .. include:: kcopyd.txt
+    :literal:
+
+zero
+----
+
+ .. include:: zero.txt
+    :literal:
+
+cache
+-----
+
+ .. include:: cache.txt
+    :literal:
+
+unstriped
+---------
+
+ .. include:: unstriped.txt
+    :literal:
+
+log writes
+----------
+
+ .. include:: log-writes.txt
+    :literal:
+
+switch
+------
+
+ .. include:: switch.txt
+    :literal:
+
+dm zoned
+--------
+
+ .. include:: dm-zoned.txt
+    :literal:
+
+persistent data
+---------------
+
+ .. include:: persistent-data.txt
+    :literal:
+
+delay
+-----
+
+ .. include:: delay.txt
+    :literal:
+
+dm integrity
+------------
+
+ .. include:: dm-integrity.txt
+    :literal:
+
+dm queue length
+---------------
+
+ .. include:: dm-queue-length.txt
+    :literal:
+
+snapshot
+--------
+
+ .. include:: snapshot.txt
+    :literal:
+
+statistics
+----------
+
+ .. include:: statistics.txt
+    :literal:
+
+striped
+-------
+
+ .. include:: striped.txt
+    :literal:
+
+dm service time
+---------------
+
+ .. include:: dm-service-time.txt
+    :literal:
+
+dm flakey
+---------
+
+ .. include:: dm-flakey.txt
+    :literal:
+
+dm uevent
+---------
+
+ .. include:: dm-uevent.txt
+    :literal:
+
+dm crypt
+--------
+
+ .. include:: dm-crypt.txt
+    :literal:
+
+dm log
+------
+
+ .. include:: dm-log.txt
+    :literal:
+
+cache policies
+--------------
+
+ .. include:: cache-policies.txt
+    :literal:
+
diff --git a/Documentation/driver-model/index.rst b/Documentation/driver-model/index.rst
new file mode 100644
index 000000000000..b5cbeb754995
--- /dev/null
+++ b/Documentation/driver-model/index.rst
@@ -0,0 +1,15 @@
+============
+driver-model
+============
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/driver-model/text_files.rst b/Documentation/driver-model/text_files.rst
new file mode 100644
index 000000000000..1b160cfdbb5e
--- /dev/null
+++ b/Documentation/driver-model/text_files.rst
@@ -0,0 +1,60 @@
+class
+-----
+
+ .. include:: class.txt
+    :literal:
+
+platform
+--------
+
+ .. include:: platform.txt
+    :literal:
+
+overview
+--------
+
+ .. include:: overview.txt
+    :literal:
+
+device
+------
+
+ .. include:: device.txt
+    :literal:
+
+driver
+------
+
+ .. include:: driver.txt
+    :literal:
+
+design patterns
+---------------
+
+ .. include:: design-patterns.txt
+    :literal:
+
+porting
+-------
+
+ .. include:: porting.txt
+    :literal:
+
+bus
+---
+
+ .. include:: bus.txt
+    :literal:
+
+binding
+-------
+
+ .. include:: binding.txt
+    :literal:
+
+devres
+------
+
+ .. include:: devres.txt
+    :literal:
+
diff --git a/Documentation/early-userspace/index.rst b/Documentation/early-userspace/index.rst
new file mode 100644
index 000000000000..a2d4a659af75
--- /dev/null
+++ b/Documentation/early-userspace/index.rst
@@ -0,0 +1,15 @@
+===============
+early-userspace
+===============
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/early-userspace/text_files.rst b/Documentation/early-userspace/text_files.rst
new file mode 100644
index 000000000000..c902ea1b6b42
--- /dev/null
+++ b/Documentation/early-userspace/text_files.rst
@@ -0,0 +1,6 @@
+buffer format
+-------------
+
+ .. include:: buffer-format.txt
+    :literal:
+
diff --git a/Documentation/extcon/index.rst b/Documentation/extcon/index.rst
new file mode 100644
index 000000000000..c27a59575f72
--- /dev/null
+++ b/Documentation/extcon/index.rst
@@ -0,0 +1,15 @@
+======
+extcon
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/extcon/text_files.rst b/Documentation/extcon/text_files.rst
new file mode 100644
index 000000000000..0d0e7196ef11
--- /dev/null
+++ b/Documentation/extcon/text_files.rst
@@ -0,0 +1,6 @@
+intel int3496
+-------------
+
+ .. include:: intel-int3496.txt
+    :literal:
+
diff --git a/Documentation/fault-injection/index.rst b/Documentation/fault-injection/index.rst
new file mode 100644
index 000000000000..8ed02c999173
--- /dev/null
+++ b/Documentation/fault-injection/index.rst
@@ -0,0 +1,15 @@
+===============
+fault-injection
+===============
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/fault-injection/text_files.rst b/Documentation/fault-injection/text_files.rst
new file mode 100644
index 000000000000..5020a0d7e242
--- /dev/null
+++ b/Documentation/fault-injection/text_files.rst
@@ -0,0 +1,24 @@
+provoke crashes
+---------------
+
+ .. include:: provoke-crashes.txt
+    :literal:
+
+nvme fault injection
+--------------------
+
+ .. include:: nvme-fault-injection.txt
+    :literal:
+
+notifier error inject
+---------------------
+
+ .. include:: notifier-error-inject.txt
+    :literal:
+
+fault injection
+---------------
+
+ .. include:: fault-injection.txt
+    :literal:
+
diff --git a/Documentation/fb/index.rst b/Documentation/fb/index.rst
new file mode 100644
index 000000000000..41df9e298e43
--- /dev/null
+++ b/Documentation/fb/index.rst
@@ -0,0 +1,15 @@
+==
+fb
+==
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/fb/text_files.rst b/Documentation/fb/text_files.rst
new file mode 100644
index 000000000000..4b6683ffe2d3
--- /dev/null
+++ b/Documentation/fb/text_files.rst
@@ -0,0 +1,204 @@
+tridentfb
+---------
+
+ .. include:: tridentfb.txt
+    :literal:
+
+udlfb
+-----
+
+ .. include:: udlfb.txt
+    :literal:
+
+pxafb
+-----
+
+ .. include:: pxafb.txt
+    :literal:
+
+matroxfb
+--------
+
+ .. include:: matroxfb.txt
+    :literal:
+
+vt8623fb
+--------
+
+ .. include:: vt8623fb.txt
+    :literal:
+
+intel810
+--------
+
+ .. include:: intel810.txt
+    :literal:
+
+sstfb
+-----
+
+ .. include:: sstfb.txt
+    :literal:
+
+sm501
+-----
+
+ .. include:: sm501.txt
+    :literal:
+
+fbcon
+-----
+
+ .. include:: fbcon.txt
+    :literal:
+
+modedb
+------
+
+ .. include:: modedb.txt
+    :literal:
+
+metronomefb
+-----------
+
+ .. include:: metronomefb.txt
+    :literal:
+
+ep93xx fb
+---------
+
+ .. include:: ep93xx-fb.txt
+    :literal:
+
+s3fb
+----
+
+ .. include:: s3fb.txt
+    :literal:
+
+api
+---
+
+ .. include:: api.txt
+    :literal:
+
+aty128fb
+--------
+
+ .. include:: aty128fb.txt
+    :literal:
+
+lxfb
+----
+
+ .. include:: lxfb.txt
+    :literal:
+
+sm712fb
+-------
+
+ .. include:: sm712fb.txt
+    :literal:
+
+framebuffer
+-----------
+
+ .. include:: framebuffer.txt
+    :literal:
+
+viafb
+-----
+
+ .. include:: viafb.txt
+    :literal:
+
+gxfb
+----
+
+ .. include:: gxfb.txt
+    :literal:
+
+uvesafb
+-------
+
+ .. include:: uvesafb.txt
+    :literal:
+
+pvr2fb
+------
+
+ .. include:: pvr2fb.txt
+    :literal:
+
+internals
+---------
+
+ .. include:: internals.txt
+    :literal:
+
+sa1100fb
+--------
+
+ .. include:: sa1100fb.txt
+    :literal:
+
+intelfb
+-------
+
+ .. include:: intelfb.txt
+    :literal:
+
+cmap xfbdev
+-----------
+
+ .. include:: cmap_xfbdev.txt
+    :literal:
+
+deferred io
+-----------
+
+ .. include:: deferred_io.txt
+    :literal:
+
+efifb
+-----
+
+ .. include:: efifb.txt
+    :literal:
+
+arkfb
+-----
+
+ .. include:: arkfb.txt
+    :literal:
+
+sh7760fb
+--------
+
+ .. include:: sh7760fb.txt
+    :literal:
+
+cirrusfb
+--------
+
+ .. include:: cirrusfb.txt
+    :literal:
+
+vesafb
+------
+
+ .. include:: vesafb.txt
+    :literal:
+
+tgafb
+-----
+
+ .. include:: tgafb.txt
+    :literal:
+
+sisfb
+-----
+
+ .. include:: sisfb.txt
+    :literal:
+
diff --git a/Documentation/features/index.rst b/Documentation/features/index.rst
new file mode 100644
index 000000000000..549d3a16f947
--- /dev/null
+++ b/Documentation/features/index.rst
@@ -0,0 +1,15 @@
+========
+features
+========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/features/text_files.rst b/Documentation/features/text_files.rst
new file mode 100644
index 000000000000..6dee5e688fc4
--- /dev/null
+++ b/Documentation/features/text_files.rst
@@ -0,0 +1,252 @@
+arch support
+------------
+
+ .. include:: arch-support.txt
+    :literal:
+
+debug KASAN arch support
+------------------------
+
+ .. include:: debug/KASAN/arch-support.txt
+    :literal:
+
+debug gcov profile all arch support
+-----------------------------------
+
+ .. include:: debug/gcov-profile-all/arch-support.txt
+    :literal:
+
+debug user ret profiler arch support
+------------------------------------
+
+ .. include:: debug/user-ret-profiler/arch-support.txt
+    :literal:
+
+debug optprobes arch support
+----------------------------
+
+ .. include:: debug/optprobes/arch-support.txt
+    :literal:
+
+debug kretprobes arch support
+-----------------------------
+
+ .. include:: debug/kretprobes/arch-support.txt
+    :literal:
+
+debug kgdb arch support
+-----------------------
+
+ .. include:: debug/kgdb/arch-support.txt
+    :literal:
+
+debug stackprotector arch support
+---------------------------------
+
+ .. include:: debug/stackprotector/arch-support.txt
+    :literal:
+
+debug uprobes arch support
+--------------------------
+
+ .. include:: debug/uprobes/arch-support.txt
+    :literal:
+
+debug kprobes arch support
+--------------------------
+
+ .. include:: debug/kprobes/arch-support.txt
+    :literal:
+
+debug kprobes on ftrace arch support
+------------------------------------
+
+ .. include:: debug/kprobes-on-ftrace/arch-support.txt
+    :literal:
+
+perf kprobes event arch support
+-------------------------------
+
+ .. include:: perf/kprobes-event/arch-support.txt
+    :literal:
+
+perf perf regs arch support
+---------------------------
+
+ .. include:: perf/perf-regs/arch-support.txt
+    :literal:
+
+perf perf stackdump arch support
+--------------------------------
+
+ .. include:: perf/perf-stackdump/arch-support.txt
+    :literal:
+
+io dma contiguous arch support
+------------------------------
+
+ .. include:: io/dma-contiguous/arch-support.txt
+    :literal:
+
+seccomp seccomp filter arch support
+-----------------------------------
+
+ .. include:: seccomp/seccomp-filter/arch-support.txt
+    :literal:
+
+vm huge vmap arch support
+-------------------------
+
+ .. include:: vm/huge-vmap/arch-support.txt
+    :literal:
+
+vm pte special arch support
+---------------------------
+
+ .. include:: vm/pte_special/arch-support.txt
+    :literal:
+
+vm ioremap prot arch support
+----------------------------
+
+ .. include:: vm/ioremap_prot/arch-support.txt
+    :literal:
+
+vm TLB arch support
+-------------------
+
+ .. include:: vm/TLB/arch-support.txt
+    :literal:
+
+vm numa memblock arch support
+-----------------------------
+
+ .. include:: vm/numa-memblock/arch-support.txt
+    :literal:
+
+vm THP arch support
+-------------------
+
+ .. include:: vm/THP/arch-support.txt
+    :literal:
+
+vm PG uncached arch support
+---------------------------
+
+ .. include:: vm/PG_uncached/arch-support.txt
+    :literal:
+
+vm ELF ASLR arch support
+------------------------
+
+ .. include:: vm/ELF-ASLR/arch-support.txt
+    :literal:
+
+sched numa balancing arch support
+---------------------------------
+
+ .. include:: sched/numa-balancing/arch-support.txt
+    :literal:
+
+sched membarrier sync core arch support
+---------------------------------------
+
+ .. include:: sched/membarrier-sync-core/arch-support.txt
+    :literal:
+
+locking rwsem optimized arch support
+------------------------------------
+
+ .. include:: locking/rwsem-optimized/arch-support.txt
+    :literal:
+
+locking queued spinlocks arch support
+-------------------------------------
+
+ .. include:: locking/queued-spinlocks/arch-support.txt
+    :literal:
+
+locking cmpxchg local arch support
+----------------------------------
+
+ .. include:: locking/cmpxchg-local/arch-support.txt
+    :literal:
+
+locking lockdep arch support
+----------------------------
+
+ .. include:: locking/lockdep/arch-support.txt
+    :literal:
+
+locking queued rwlocks arch support
+-----------------------------------
+
+ .. include:: locking/queued-rwlocks/arch-support.txt
+    :literal:
+
+core tracehook arch support
+---------------------------
+
+ .. include:: core/tracehook/arch-support.txt
+    :literal:
+
+core eBPF JIT arch support
+--------------------------
+
+ .. include:: core/eBPF-JIT/arch-support.txt
+    :literal:
+
+core cBPF JIT arch support
+--------------------------
+
+ .. include:: core/cBPF-JIT/arch-support.txt
+    :literal:
+
+core generic idle thread arch support
+-------------------------------------
+
+ .. include:: core/generic-idle-thread/arch-support.txt
+    :literal:
+
+core jump labels arch support
+-----------------------------
+
+ .. include:: core/jump-labels/arch-support.txt
+    :literal:
+
+time virt cpuacct arch support
+------------------------------
+
+ .. include:: time/virt-cpuacct/arch-support.txt
+    :literal:
+
+time irq time acct arch support
+-------------------------------
+
+ .. include:: time/irq-time-acct/arch-support.txt
+    :literal:
+
+time arch tick broadcast arch support
+-------------------------------------
+
+ .. include:: time/arch-tick-broadcast/arch-support.txt
+    :literal:
+
+time context tracking arch support
+----------------------------------
+
+ .. include:: time/context-tracking/arch-support.txt
+    :literal:
+
+time clockevents arch support
+-----------------------------
+
+ .. include:: time/clockevents/arch-support.txt
+    :literal:
+
+time modern timekeeping arch support
+------------------------------------
+
+ .. include:: time/modern-timekeeping/arch-support.txt
+    :literal:
+
diff --git a/Documentation/fmc/index.rst b/Documentation/fmc/index.rst
new file mode 100644
index 000000000000..9fb27ae724a2
--- /dev/null
+++ b/Documentation/fmc/index.rst
@@ -0,0 +1,15 @@
+===
+fmc
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/fmc/text_files.rst b/Documentation/fmc/text_files.rst
new file mode 100644
index 000000000000..12756cb7e6f0
--- /dev/null
+++ b/Documentation/fmc/text_files.rst
@@ -0,0 +1,60 @@
+API
+---
+
+ .. include:: API.txt
+    :literal:
+
+identifiers
+-----------
+
+ .. include:: identifiers.txt
+    :literal:
+
+fmc write eeprom
+----------------
+
+ .. include:: fmc-write-eeprom.txt
+    :literal:
+
+fmc fakedev
+-----------
+
+ .. include:: fmc-fakedev.txt
+    :literal:
+
+mezzanine
+---------
+
+ .. include:: mezzanine.txt
+    :literal:
+
+fmc chardev
+-----------
+
+ .. include:: fmc-chardev.txt
+    :literal:
+
+parameters
+----------
+
+ .. include:: parameters.txt
+    :literal:
+
+fmc trivial
+-----------
+
+ .. include:: fmc-trivial.txt
+    :literal:
+
+FMC and SDB
+-----------
+
+ .. include:: FMC-and-SDB.txt
+    :literal:
+
+carrier
+-------
+
+ .. include:: carrier.txt
+    :literal:
+
diff --git a/Documentation/fpga/index.rst b/Documentation/fpga/index.rst
new file mode 100644
index 000000000000..511d60d603ce
--- /dev/null
+++ b/Documentation/fpga/index.rst
@@ -0,0 +1,15 @@
+====
+fpga
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/fpga/text_files.rst b/Documentation/fpga/text_files.rst
new file mode 100644
index 000000000000..06dc2683a9fb
--- /dev/null
+++ b/Documentation/fpga/text_files.rst
@@ -0,0 +1,6 @@
+dfl
+---
+
+ .. include:: dfl.txt
+    :literal:
+
diff --git a/Documentation/gpio/index.rst b/Documentation/gpio/index.rst
new file mode 100644
index 000000000000..f2729e924d5a
--- /dev/null
+++ b/Documentation/gpio/index.rst
@@ -0,0 +1,15 @@
+====
+gpio
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/gpio/text_files.rst b/Documentation/gpio/text_files.rst
new file mode 100644
index 000000000000..325ae8b1567e
--- /dev/null
+++ b/Documentation/gpio/text_files.rst
@@ -0,0 +1,6 @@
+sysfs
+-----
+
+ .. include:: sysfs.txt
+    :literal:
+
diff --git a/Documentation/hid/index.rst b/Documentation/hid/index.rst
new file mode 100644
index 000000000000..83572ebc5aaa
--- /dev/null
+++ b/Documentation/hid/index.rst
@@ -0,0 +1,15 @@
+===
+hid
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/hid/text_files.rst b/Documentation/hid/text_files.rst
new file mode 100644
index 000000000000..bdd342d8d47b
--- /dev/null
+++ b/Documentation/hid/text_files.rst
@@ -0,0 +1,42 @@
+hiddev
+------
+
+ .. include:: hiddev.txt
+    :literal:
+
+hid transport
+-------------
+
+ .. include:: hid-transport.txt
+    :literal:
+
+hid sensor
+----------
+
+ .. include:: hid-sensor.txt
+    :literal:
+
+hidraw
+------
+
+ .. include:: hidraw.txt
+    :literal:
+
+uhid
+----
+
+ .. include:: uhid.txt
+    :literal:
+
+intel ish hid
+-------------
+
+ .. include:: intel-ish-hid.txt
+    :literal:
+
+hid alps
+--------
+
+ .. include:: hid-alps.txt
+    :literal:
+
diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
new file mode 100644
index 000000000000..cf77b7405107
--- /dev/null
+++ b/Documentation/hwmon/index.rst
@@ -0,0 +1,15 @@
+=====
+hwmon
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/hwmon/text_files.rst b/Documentation/hwmon/text_files.rst
new file mode 100644
index 000000000000..b0915e67aeb2
--- /dev/null
+++ b/Documentation/hwmon/text_files.rst
@@ -0,0 +1,6 @@
+hwmon kernel api
+----------------
+
+ .. include:: hwmon-kernel-api.txt
+    :literal:
+
diff --git a/Documentation/ia64/index.rst b/Documentation/ia64/index.rst
new file mode 100644
index 000000000000..f35dc5c37bf8
--- /dev/null
+++ b/Documentation/ia64/index.rst
@@ -0,0 +1,15 @@
+====
+ia64
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/ia64/text_files.rst b/Documentation/ia64/text_files.rst
new file mode 100644
index 000000000000..493f7bcd6912
--- /dev/null
+++ b/Documentation/ia64/text_files.rst
@@ -0,0 +1,48 @@
+IRQ redir
+---------
+
+ .. include:: IRQ-redir.txt
+    :literal:
+
+aliasing
+--------
+
+ .. include:: aliasing.txt
+    :literal:
+
+serial
+------
+
+ .. include:: serial.txt
+    :literal:
+
+efirtc
+------
+
+ .. include:: efirtc.txt
+    :literal:
+
+mca
+---
+
+ .. include:: mca.txt
+    :literal:
+
+xen
+---
+
+ .. include:: xen.txt
+    :literal:
+
+err inject
+----------
+
+ .. include:: err_inject.txt
+    :literal:
+
+fsys
+----
+
+ .. include:: fsys.txt
+    :literal:
+
diff --git a/Documentation/ide/index.rst b/Documentation/ide/index.rst
new file mode 100644
index 000000000000..56cf4c539ada
--- /dev/null
+++ b/Documentation/ide/index.rst
@@ -0,0 +1,15 @@
+===
+ide
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/ide/text_files.rst b/Documentation/ide/text_files.rst
new file mode 100644
index 000000000000..ed1505d82354
--- /dev/null
+++ b/Documentation/ide/text_files.rst
@@ -0,0 +1,18 @@
+warm plug howto
+---------------
+
+ .. include:: warm-plug-howto.txt
+    :literal:
+
+ide
+---
+
+ .. include:: ide.txt
+    :literal:
+
+ide tape
+--------
+
+ .. include:: ide-tape.txt
+    :literal:
+
diff --git a/Documentation/iio/index.rst b/Documentation/iio/index.rst
new file mode 100644
index 000000000000..c3961e2fa27b
--- /dev/null
+++ b/Documentation/iio/index.rst
@@ -0,0 +1,15 @@
+===
+iio
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/iio/text_files.rst b/Documentation/iio/text_files.rst
new file mode 100644
index 000000000000..e8b2eacc5bc8
--- /dev/null
+++ b/Documentation/iio/text_files.rst
@@ -0,0 +1,12 @@
+iio configfs
+------------
+
+ .. include:: iio_configfs.txt
+    :literal:
+
+ep93xx adc
+----------
+
+ .. include:: ep93xx_adc.txt
+    :literal:
+
diff --git a/Documentation/index.rst b/Documentation/index.rst
index 02195dff3344..70cfc34047fd 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -128,6 +128,87 @@ Other random documents
 .. toctree::
    :maxdepth: 2
 
+   usb/index
+   accounting/index
+   acpi/index
+   aoe/index
+   arm/index
+   arm64/index
+   auxdisplay/index
+   backlight/index
+   block/index
+   blockdev/index
+   bus-devices/index
+   cdrom/index
+   cgroup-v1/index
+   cma/index
+   connector/index
+   console/index
+   cpu-freq/index
+   device-mapper/index
+   driver-model/index
+   early-userspace/index
+   EDID/index
+   extcon/index
+   fault-injection/index
+   fb/index
+   features/index
+   fmc/index
+   fpga/index
+   gpio/index
+   hid/index
+   hwmon/index
+   ia64/index
+   ide/index
+   iio/index
+   infiniband/index
+   ioctl/index
+   kbuild/index
+   kdump/index
+   laptops/index
+   leds/index
+   lightnvm/index
+   livepatch/index
+   locking/index
+   m68k/index
+   md/index
+   memory-devices/index
+   mic/index
+   mmc/index
+   mtd/index
+   namespaces/index
+   netlabel/index
+   nfc/index
+   nvdimm/index
+   nvmem/index
+   PCI/index
+   pcmcia/index
+   perf/index
+   phy/index
+   platform/index
+   power/index
+   powerpc/index
+   pps/index
+   pti/index
+   ptp/index
+   rapidio/index
+   RCU/index
+   riscv/index
+   s390/index
+   scheduler/index
+   scsi/index
+   serial/index
+   sparc/index
+   sphinx/index
+   sysctl/index
+   target/index
+   thermal/index
+   timers/index
+   virtual/index
+   watchdog/index
+   x86/index
+   xilinx/index
+   xtensa/index
    other/index
 
 
diff --git a/Documentation/infiniband/index.rst b/Documentation/infiniband/index.rst
new file mode 100644
index 000000000000..229187d928a0
--- /dev/null
+++ b/Documentation/infiniband/index.rst
@@ -0,0 +1,15 @@
+==========
+infiniband
+==========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/infiniband/text_files.rst b/Documentation/infiniband/text_files.rst
new file mode 100644
index 000000000000..f5ce4e85e435
--- /dev/null
+++ b/Documentation/infiniband/text_files.rst
@@ -0,0 +1,42 @@
+ipoib
+-----
+
+ .. include:: ipoib.txt
+    :literal:
+
+tag matching
+------------
+
+ .. include:: tag_matching.txt
+    :literal:
+
+opa vnic
+--------
+
+ .. include:: opa_vnic.txt
+    :literal:
+
+sysfs
+-----
+
+ .. include:: sysfs.txt
+    :literal:
+
+user verbs
+----------
+
+ .. include:: user_verbs.txt
+    :literal:
+
+user mad
+--------
+
+ .. include:: user_mad.txt
+    :literal:
+
+core locking
+------------
+
+ .. include:: core_locking.txt
+    :literal:
+
diff --git a/Documentation/ioctl/index.rst b/Documentation/ioctl/index.rst
new file mode 100644
index 000000000000..01706d1561a1
--- /dev/null
+++ b/Documentation/ioctl/index.rst
@@ -0,0 +1,15 @@
+=====
+ioctl
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/ioctl/text_files.rst b/Documentation/ioctl/text_files.rst
new file mode 100644
index 000000000000..dac15d6ee78f
--- /dev/null
+++ b/Documentation/ioctl/text_files.rst
@@ -0,0 +1,30 @@
+cdrom
+-----
+
+ .. include:: cdrom.txt
+    :literal:
+
+ioctl number
+------------
+
+ .. include:: ioctl-number.txt
+    :literal:
+
+botching up ioctls
+------------------
+
+ .. include:: botching-up-ioctls.txt
+    :literal:
+
+hdio
+----
+
+ .. include:: hdio.txt
+    :literal:
+
+ioctl decoding
+--------------
+
+ .. include:: ioctl-decoding.txt
+    :literal:
+
diff --git a/Documentation/kbuild/index.rst b/Documentation/kbuild/index.rst
new file mode 100644
index 000000000000..9b55f11ab83a
--- /dev/null
+++ b/Documentation/kbuild/index.rst
@@ -0,0 +1,15 @@
+======
+kbuild
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/kbuild/text_files.rst b/Documentation/kbuild/text_files.rst
new file mode 100644
index 000000000000..f819ec3c2b9f
--- /dev/null
+++ b/Documentation/kbuild/text_files.rst
@@ -0,0 +1,42 @@
+kconfig language
+----------------
+
+ .. include:: kconfig-language.txt
+    :literal:
+
+modules
+-------
+
+ .. include:: modules.txt
+    :literal:
+
+kconfig macro language
+----------------------
+
+ .. include:: kconfig-macro-language.txt
+    :literal:
+
+headers install
+---------------
+
+ .. include:: headers_install.txt
+    :literal:
+
+makefiles
+---------
+
+ .. include:: makefiles.txt
+    :literal:
+
+kbuild
+------
+
+ .. include:: kbuild.txt
+    :literal:
+
+kconfig
+-------
+
+ .. include:: kconfig.txt
+    :literal:
+
diff --git a/Documentation/kdump/index.rst b/Documentation/kdump/index.rst
new file mode 100644
index 000000000000..fd6acbd82c6a
--- /dev/null
+++ b/Documentation/kdump/index.rst
@@ -0,0 +1,15 @@
+=====
+kdump
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/kdump/text_files.rst b/Documentation/kdump/text_files.rst
new file mode 100644
index 000000000000..5811f022a6f6
--- /dev/null
+++ b/Documentation/kdump/text_files.rst
@@ -0,0 +1,18 @@
+vmcoreinfo
+----------
+
+ .. include:: vmcoreinfo.txt
+    :literal:
+
+kdump
+-----
+
+ .. include:: kdump.txt
+    :literal:
+
+gdbmacros
+---------
+
+ .. include:: gdbmacros.txt
+    :literal:
+
diff --git a/Documentation/laptops/index.rst b/Documentation/laptops/index.rst
new file mode 100644
index 000000000000..871ea13d2945
--- /dev/null
+++ b/Documentation/laptops/index.rst
@@ -0,0 +1,16 @@
+=======
+laptops
+=======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+    lg-laptop.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/laptops/text_files.rst b/Documentation/laptops/text_files.rst
new file mode 100644
index 000000000000..8350542e746a
--- /dev/null
+++ b/Documentation/laptops/text_files.rst
@@ -0,0 +1,42 @@
+sony laptop
+-----------
+
+ .. include:: sony-laptop.txt
+    :literal:
+
+asus laptop
+-----------
+
+ .. include:: asus-laptop.txt
+    :literal:
+
+disk shock protection
+---------------------
+
+ .. include:: disk-shock-protection.txt
+    :literal:
+
+sonypi
+------
+
+ .. include:: sonypi.txt
+    :literal:
+
+toshiba haps
+------------
+
+ .. include:: toshiba_haps.txt
+    :literal:
+
+thinkpad acpi
+-------------
+
+ .. include:: thinkpad-acpi.txt
+    :literal:
+
+laptop mode
+-----------
+
+ .. include:: laptop-mode.txt
+    :literal:
+
diff --git a/Documentation/leds/index.rst b/Documentation/leds/index.rst
new file mode 100644
index 000000000000..4d39a519742d
--- /dev/null
+++ b/Documentation/leds/index.rst
@@ -0,0 +1,15 @@
+====
+leds
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/leds/text_files.rst b/Documentation/leds/text_files.rst
new file mode 100644
index 000000000000..f57dc4293584
--- /dev/null
+++ b/Documentation/leds/text_files.rst
@@ -0,0 +1,84 @@
+leds lp3944
+-----------
+
+ .. include:: leds-lp3944.txt
+    :literal:
+
+leds mlxcpld
+------------
+
+ .. include:: leds-mlxcpld.txt
+    :literal:
+
+leds lp55xx
+-----------
+
+ .. include:: leds-lp55xx.txt
+    :literal:
+
+ledtrig oneshot
+---------------
+
+ .. include:: ledtrig-oneshot.txt
+    :literal:
+
+leds lp5521
+-----------
+
+ .. include:: leds-lp5521.txt
+    :literal:
+
+leds class
+----------
+
+ .. include:: leds-class.txt
+    :literal:
+
+ledtrig usbport
+---------------
+
+ .. include:: ledtrig-usbport.txt
+    :literal:
+
+leds lp5523
+-----------
+
+ .. include:: leds-lp5523.txt
+    :literal:
+
+leds lm3556
+-----------
+
+ .. include:: leds-lm3556.txt
+    :literal:
+
+leds blinkm
+-----------
+
+ .. include:: leds-blinkm.txt
+    :literal:
+
+uleds
+-----
+
+ .. include:: uleds.txt
+    :literal:
+
+leds lp5562
+-----------
+
+ .. include:: leds-lp5562.txt
+    :literal:
+
+ledtrig transient
+-----------------
+
+ .. include:: ledtrig-transient.txt
+    :literal:
+
+leds class flash
+----------------
+
+ .. include:: leds-class-flash.txt
+    :literal:
+
diff --git a/Documentation/lightnvm/index.rst b/Documentation/lightnvm/index.rst
new file mode 100644
index 000000000000..9805c8a2a721
--- /dev/null
+++ b/Documentation/lightnvm/index.rst
@@ -0,0 +1,15 @@
+========
+lightnvm
+========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/lightnvm/text_files.rst b/Documentation/lightnvm/text_files.rst
new file mode 100644
index 000000000000..5c42f292a3e9
--- /dev/null
+++ b/Documentation/lightnvm/text_files.rst
@@ -0,0 +1,6 @@
+pblk
+----
+
+ .. include:: pblk.txt
+    :literal:
+
diff --git a/Documentation/livepatch/index.rst b/Documentation/livepatch/index.rst
new file mode 100644
index 000000000000..0f754c496efc
--- /dev/null
+++ b/Documentation/livepatch/index.rst
@@ -0,0 +1,15 @@
+=========
+livepatch
+=========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/livepatch/text_files.rst b/Documentation/livepatch/text_files.rst
new file mode 100644
index 000000000000..1a640566e082
--- /dev/null
+++ b/Documentation/livepatch/text_files.rst
@@ -0,0 +1,30 @@
+shadow vars
+-----------
+
+ .. include:: shadow-vars.txt
+    :literal:
+
+cumulative patches
+------------------
+
+ .. include:: cumulative-patches.txt
+    :literal:
+
+livepatch
+---------
+
+ .. include:: livepatch.txt
+    :literal:
+
+module elf format
+-----------------
+
+ .. include:: module-elf-format.txt
+    :literal:
+
+callbacks
+---------
+
+ .. include:: callbacks.txt
+    :literal:
+
diff --git a/Documentation/locking/index.rst b/Documentation/locking/index.rst
new file mode 100644
index 000000000000..39848db64db3
--- /dev/null
+++ b/Documentation/locking/index.rst
@@ -0,0 +1,15 @@
+=======
+locking
+=======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/locking/text_files.rst b/Documentation/locking/text_files.rst
new file mode 100644
index 000000000000..f99e524a3fcf
--- /dev/null
+++ b/Documentation/locking/text_files.rst
@@ -0,0 +1,48 @@
+lockstat
+--------
+
+ .. include:: lockstat.txt
+    :literal:
+
+mutex design
+------------
+
+ .. include:: mutex-design.txt
+    :literal:
+
+lockdep design
+--------------
+
+ .. include:: lockdep-design.txt
+    :literal:
+
+ww mutex design
+---------------
+
+ .. include:: ww-mutex-design.txt
+    :literal:
+
+rt mutex
+--------
+
+ .. include:: rt-mutex.txt
+    :literal:
+
+locktorture
+-----------
+
+ .. include:: locktorture.txt
+    :literal:
+
+rt mutex design
+---------------
+
+ .. include:: rt-mutex-design.txt
+    :literal:
+
+spinlocks
+---------
+
+ .. include:: spinlocks.txt
+    :literal:
+
diff --git a/Documentation/m68k/index.rst b/Documentation/m68k/index.rst
new file mode 100644
index 000000000000..3812f6ade56d
--- /dev/null
+++ b/Documentation/m68k/index.rst
@@ -0,0 +1,15 @@
+====
+m68k
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/m68k/text_files.rst b/Documentation/m68k/text_files.rst
new file mode 100644
index 000000000000..c2bbf62b87fc
--- /dev/null
+++ b/Documentation/m68k/text_files.rst
@@ -0,0 +1,6 @@
+kernel options
+--------------
+
+ .. include:: kernel-options.txt
+    :literal:
+
diff --git a/Documentation/md/index.rst b/Documentation/md/index.rst
new file mode 100644
index 000000000000..55b3585647d6
--- /dev/null
+++ b/Documentation/md/index.rst
@@ -0,0 +1,15 @@
+==
+md
+==
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/md/text_files.rst b/Documentation/md/text_files.rst
new file mode 100644
index 000000000000..9240f85c3a8a
--- /dev/null
+++ b/Documentation/md/text_files.rst
@@ -0,0 +1,18 @@
+md cluster
+----------
+
+ .. include:: md-cluster.txt
+    :literal:
+
+raid5 ppl
+---------
+
+ .. include:: raid5-ppl.txt
+    :literal:
+
+raid5 cache
+-----------
+
+ .. include:: raid5-cache.txt
+    :literal:
+
diff --git a/Documentation/memory-devices/index.rst b/Documentation/memory-devices/index.rst
new file mode 100644
index 000000000000..3123b41d55ca
--- /dev/null
+++ b/Documentation/memory-devices/index.rst
@@ -0,0 +1,15 @@
+==============
+memory-devices
+==============
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/memory-devices/text_files.rst b/Documentation/memory-devices/text_files.rst
new file mode 100644
index 000000000000..601c3673e2d3
--- /dev/null
+++ b/Documentation/memory-devices/text_files.rst
@@ -0,0 +1,6 @@
+ti emif
+-------
+
+ .. include:: ti-emif.txt
+    :literal:
+
diff --git a/Documentation/mic/index.rst b/Documentation/mic/index.rst
new file mode 100644
index 000000000000..21bbc740db93
--- /dev/null
+++ b/Documentation/mic/index.rst
@@ -0,0 +1,15 @@
+===
+mic
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/mic/text_files.rst b/Documentation/mic/text_files.rst
new file mode 100644
index 000000000000..ef4e000ecb32
--- /dev/null
+++ b/Documentation/mic/text_files.rst
@@ -0,0 +1,12 @@
+scif overview
+-------------
+
+ .. include:: scif_overview.txt
+    :literal:
+
+mic overview
+------------
+
+ .. include:: mic_overview.txt
+    :literal:
+
diff --git a/Documentation/mmc/index.rst b/Documentation/mmc/index.rst
new file mode 100644
index 000000000000..d9a25445aa29
--- /dev/null
+++ b/Documentation/mmc/index.rst
@@ -0,0 +1,15 @@
+===
+mmc
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/mmc/text_files.rst b/Documentation/mmc/text_files.rst
new file mode 100644
index 000000000000..c398f3add6a6
--- /dev/null
+++ b/Documentation/mmc/text_files.rst
@@ -0,0 +1,24 @@
+mmc tools
+---------
+
+ .. include:: mmc-tools.txt
+    :literal:
+
+mmc async req
+-------------
+
+ .. include:: mmc-async-req.txt
+    :literal:
+
+mmc dev attrs
+-------------
+
+ .. include:: mmc-dev-attrs.txt
+    :literal:
+
+mmc dev parts
+-------------
+
+ .. include:: mmc-dev-parts.txt
+    :literal:
+
diff --git a/Documentation/mtd/index.rst b/Documentation/mtd/index.rst
new file mode 100644
index 000000000000..fcd638f74473
--- /dev/null
+++ b/Documentation/mtd/index.rst
@@ -0,0 +1,15 @@
+===
+mtd
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/mtd/text_files.rst b/Documentation/mtd/text_files.rst
new file mode 100644
index 000000000000..d94d611bacd8
--- /dev/null
+++ b/Documentation/mtd/text_files.rst
@@ -0,0 +1,18 @@
+nand ecc
+--------
+
+ .. include:: nand_ecc.txt
+    :literal:
+
+spi nor
+-------
+
+ .. include:: spi-nor.txt
+    :literal:
+
+intel spi
+---------
+
+ .. include:: intel-spi.txt
+    :literal:
+
diff --git a/Documentation/namespaces/index.rst b/Documentation/namespaces/index.rst
new file mode 100644
index 000000000000..cf4adc0385e1
--- /dev/null
+++ b/Documentation/namespaces/index.rst
@@ -0,0 +1,15 @@
+==========
+namespaces
+==========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/namespaces/text_files.rst b/Documentation/namespaces/text_files.rst
new file mode 100644
index 000000000000..e7cce7c8f6da
--- /dev/null
+++ b/Documentation/namespaces/text_files.rst
@@ -0,0 +1,12 @@
+compatibility list
+------------------
+
+ .. include:: compatibility-list.txt
+    :literal:
+
+resource control
+----------------
+
+ .. include:: resource-control.txt
+    :literal:
+
diff --git a/Documentation/netlabel/index.rst b/Documentation/netlabel/index.rst
new file mode 100644
index 000000000000..4bb664a6fb37
--- /dev/null
+++ b/Documentation/netlabel/index.rst
@@ -0,0 +1,15 @@
+========
+netlabel
+========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/netlabel/text_files.rst b/Documentation/netlabel/text_files.rst
new file mode 100644
index 000000000000..5f73428efa0d
--- /dev/null
+++ b/Documentation/netlabel/text_files.rst
@@ -0,0 +1,24 @@
+introduction
+------------
+
+ .. include:: introduction.txt
+    :literal:
+
+draft ietf cipso ipsecurity 01
+------------------------------
+
+ .. include:: draft-ietf-cipso-ipsecurity-01.txt
+    :literal:
+
+lsm interface
+-------------
+
+ .. include:: lsm_interface.txt
+    :literal:
+
+cipso ipv4
+----------
+
+ .. include:: cipso_ipv4.txt
+    :literal:
+
diff --git a/Documentation/nfc/index.rst b/Documentation/nfc/index.rst
new file mode 100644
index 000000000000..8f9a567569bf
--- /dev/null
+++ b/Documentation/nfc/index.rst
@@ -0,0 +1,15 @@
+===
+nfc
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/nfc/text_files.rst b/Documentation/nfc/text_files.rst
new file mode 100644
index 000000000000..73bc4c231e75
--- /dev/null
+++ b/Documentation/nfc/text_files.rst
@@ -0,0 +1,12 @@
+nfc pn544
+---------
+
+ .. include:: nfc-pn544.txt
+    :literal:
+
+nfc hci
+-------
+
+ .. include:: nfc-hci.txt
+    :literal:
+
diff --git a/Documentation/nvdimm/index.rst b/Documentation/nvdimm/index.rst
new file mode 100644
index 000000000000..760f4ba35cd3
--- /dev/null
+++ b/Documentation/nvdimm/index.rst
@@ -0,0 +1,15 @@
+======
+nvdimm
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/nvdimm/text_files.rst b/Documentation/nvdimm/text_files.rst
new file mode 100644
index 000000000000..a19cc00b162f
--- /dev/null
+++ b/Documentation/nvdimm/text_files.rst
@@ -0,0 +1,18 @@
+nvdimm
+------
+
+ .. include:: nvdimm.txt
+    :literal:
+
+btt
+---
+
+ .. include:: btt.txt
+    :literal:
+
+security
+--------
+
+ .. include:: security.txt
+    :literal:
+
diff --git a/Documentation/nvmem/index.rst b/Documentation/nvmem/index.rst
new file mode 100644
index 000000000000..a2ef7675b97f
--- /dev/null
+++ b/Documentation/nvmem/index.rst
@@ -0,0 +1,15 @@
+=====
+nvmem
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/nvmem/text_files.rst b/Documentation/nvmem/text_files.rst
new file mode 100644
index 000000000000..d7bcce8b8f1c
--- /dev/null
+++ b/Documentation/nvmem/text_files.rst
@@ -0,0 +1,6 @@
+nvmem
+-----
+
+ .. include:: nvmem.txt
+    :literal:
+
diff --git a/Documentation/pcmcia/index.rst b/Documentation/pcmcia/index.rst
new file mode 100644
index 000000000000..4a3417cfd4f4
--- /dev/null
+++ b/Documentation/pcmcia/index.rst
@@ -0,0 +1,15 @@
+======
+pcmcia
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/pcmcia/text_files.rst b/Documentation/pcmcia/text_files.rst
new file mode 100644
index 000000000000..77072070203f
--- /dev/null
+++ b/Documentation/pcmcia/text_files.rst
@@ -0,0 +1,24 @@
+driver
+------
+
+ .. include:: driver.txt
+    :literal:
+
+devicetable
+-----------
+
+ .. include:: devicetable.txt
+    :literal:
+
+driver changes
+--------------
+
+ .. include:: driver-changes.txt
+    :literal:
+
+locking
+-------
+
+ .. include:: locking.txt
+    :literal:
+
diff --git a/Documentation/perf/index.rst b/Documentation/perf/index.rst
new file mode 100644
index 000000000000..119c58d4d43c
--- /dev/null
+++ b/Documentation/perf/index.rst
@@ -0,0 +1,15 @@
+====
+perf
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/perf/text_files.rst b/Documentation/perf/text_files.rst
new file mode 100644
index 000000000000..f46f56b53fe1
--- /dev/null
+++ b/Documentation/perf/text_files.rst
@@ -0,0 +1,42 @@
+arm dsu pmu
+-----------
+
+ .. include:: arm_dsu_pmu.txt
+    :literal:
+
+arm ccn
+-------
+
+ .. include:: arm-ccn.txt
+    :literal:
+
+thunderx2 pmu
+-------------
+
+ .. include:: thunderx2-pmu.txt
+    :literal:
+
+hisi pmu
+--------
+
+ .. include:: hisi-pmu.txt
+    :literal:
+
+qcom l3 pmu
+-----------
+
+ .. include:: qcom_l3_pmu.txt
+    :literal:
+
+xgene pmu
+---------
+
+ .. include:: xgene-pmu.txt
+    :literal:
+
+qcom l2 pmu
+-----------
+
+ .. include:: qcom_l2_pmu.txt
+    :literal:
+
diff --git a/Documentation/phy/index.rst b/Documentation/phy/index.rst
new file mode 100644
index 000000000000..b18b16a9080d
--- /dev/null
+++ b/Documentation/phy/index.rst
@@ -0,0 +1,15 @@
+===
+phy
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/phy/text_files.rst b/Documentation/phy/text_files.rst
new file mode 100644
index 000000000000..42f04fec9968
--- /dev/null
+++ b/Documentation/phy/text_files.rst
@@ -0,0 +1,6 @@
+samsung usb2
+------------
+
+ .. include:: samsung-usb2.txt
+    :literal:
+
diff --git a/Documentation/platform/index.rst b/Documentation/platform/index.rst
new file mode 100644
index 000000000000..f1dd91d8af05
--- /dev/null
+++ b/Documentation/platform/index.rst
@@ -0,0 +1,15 @@
+========
+platform
+========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/platform/text_files.rst b/Documentation/platform/text_files.rst
new file mode 100644
index 000000000000..9ce75cc46502
--- /dev/null
+++ b/Documentation/platform/text_files.rst
@@ -0,0 +1,6 @@
+x86 laptop drivers
+------------------
+
+ .. include:: x86-laptop-drivers.txt
+    :literal:
+
diff --git a/Documentation/power/index.rst b/Documentation/power/index.rst
new file mode 100644
index 000000000000..463fcf6918c5
--- /dev/null
+++ b/Documentation/power/index.rst
@@ -0,0 +1,15 @@
+=====
+power
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/power/text_files.rst b/Documentation/power/text_files.rst
new file mode 100644
index 000000000000..444639321e70
--- /dev/null
+++ b/Documentation/power/text_files.rst
@@ -0,0 +1,162 @@
+power supply class
+------------------
+
+ .. include:: power_supply_class.txt
+    :literal:
+
+tricks
+------
+
+ .. include:: tricks.txt
+    :literal:
+
+video
+-----
+
+ .. include:: video.txt
+    :literal:
+
+interface
+---------
+
+ .. include:: interface.txt
+    :literal:
+
+apm acpi
+--------
+
+ .. include:: apm-acpi.txt
+    :literal:
+
+freezing of tasks
+-----------------
+
+ .. include:: freezing-of-tasks.txt
+    :literal:
+
+suspend and interrupts
+----------------------
+
+ .. include:: suspend-and-interrupts.txt
+    :literal:
+
+runtime pm
+----------
+
+ .. include:: runtime_pm.txt
+    :literal:
+
+drivers testing
+---------------
+
+ .. include:: drivers-testing.txt
+    :literal:
+
+pci
+---
+
+ .. include:: pci.txt
+    :literal:
+
+pm qos interface
+----------------
+
+ .. include:: pm_qos_interface.txt
+    :literal:
+
+charger manager
+---------------
+
+ .. include:: charger-manager.txt
+    :literal:
+
+suspend and cpuhotplug
+----------------------
+
+ .. include:: suspend-and-cpuhotplug.txt
+    :literal:
+
+basic pm debugging
+------------------
+
+ .. include:: basic-pm-debugging.txt
+    :literal:
+
+opp
+---
+
+ .. include:: opp.txt
+    :literal:
+
+swsusp
+------
+
+ .. include:: swsusp.txt
+    :literal:
+
+powercap
+--------
+
+ .. include:: powercap/powercap.txt
+    :literal:
+
+s2ram
+-----
+
+ .. include:: s2ram.txt
+    :literal:
+
+regulator
+---------
+
+ .. include:: regulator/regulator.txt
+    :literal:
+
+design
+------
+
+ .. include:: regulator/design.txt
+    :literal:
+
+overview
+--------
+
+ .. include:: regulator/overview.txt
+    :literal:
+
+machine
+-------
+
+ .. include:: regulator/machine.txt
+    :literal:
+
+consumer
+--------
+
+ .. include:: regulator/consumer.txt
+    :literal:
+
+swsusp and swap files
+---------------------
+
+ .. include:: swsusp-and-swap-files.txt
+    :literal:
+
+userland swsusp
+---------------
+
+ .. include:: userland-swsusp.txt
+    :literal:
+
+energy model
+------------
+
+ .. include:: energy-model.txt
+    :literal:
+
+swsusp dmcrypt
+--------------
+
+ .. include:: swsusp-dmcrypt.txt
+    :literal:
+
diff --git a/Documentation/powerpc/index.rst b/Documentation/powerpc/index.rst
new file mode 100644
index 000000000000..2377406d5494
--- /dev/null
+++ b/Documentation/powerpc/index.rst
@@ -0,0 +1,16 @@
+=======
+powerpc
+=======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+    isa-versions.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/powerpc/text_files.rst b/Documentation/powerpc/text_files.rst
new file mode 100644
index 000000000000..0fd81e5f2a05
--- /dev/null
+++ b/Documentation/powerpc/text_files.rst
@@ -0,0 +1,102 @@
+pmu ebb
+-------
+
+ .. include:: pmu-ebb.txt
+    :literal:
+
+cpu features
+------------
+
+ .. include:: cpu_features.txt
+    :literal:
+
+hvcs
+----
+
+ .. include:: hvcs.txt
+    :literal:
+
+mpc52xx
+-------
+
+ .. include:: mpc52xx.txt
+    :literal:
+
+eeh pci error recovery
+----------------------
+
+ .. include:: eeh-pci-error-recovery.txt
+    :literal:
+
+cxl
+---
+
+ .. include:: cxl.txt
+    :literal:
+
+cxlflash
+--------
+
+ .. include:: cxlflash.txt
+    :literal:
+
+transactional memory
+--------------------
+
+ .. include:: transactional_memory.txt
+    :literal:
+
+ptrace
+------
+
+ .. include:: ptrace.txt
+    :literal:
+
+syscall64 abi
+-------------
+
+ .. include:: syscall64-abi.txt
+    :literal:
+
+DAWR POWER9
+-----------
+
+ .. include:: DAWR-POWER9.txt
+    :literal:
+
+dscr
+----
+
+ .. include:: dscr.txt
+    :literal:
+
+bootwrapper
+-----------
+
+ .. include:: bootwrapper.txt
+    :literal:
+
+qe firmware
+-----------
+
+ .. include:: qe_firmware.txt
+    :literal:
+
+cpu families
+------------
+
+ .. include:: cpu_families.txt
+    :literal:
+
+firmware assisted dump
+----------------------
+
+ .. include:: firmware-assisted-dump.txt
+    :literal:
+
+pci iov resource on powernv
+---------------------------
+
+ .. include:: pci_iov_resource_on_powernv.txt
+    :literal:
+
diff --git a/Documentation/pps/index.rst b/Documentation/pps/index.rst
new file mode 100644
index 000000000000..1e45db400812
--- /dev/null
+++ b/Documentation/pps/index.rst
@@ -0,0 +1,15 @@
+===
+pps
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/pps/text_files.rst b/Documentation/pps/text_files.rst
new file mode 100644
index 000000000000..9bfff567aee3
--- /dev/null
+++ b/Documentation/pps/text_files.rst
@@ -0,0 +1,6 @@
+pps
+---
+
+ .. include:: pps.txt
+    :literal:
+
diff --git a/Documentation/pti/index.rst b/Documentation/pti/index.rst
new file mode 100644
index 000000000000..f49ea7d55a2c
--- /dev/null
+++ b/Documentation/pti/index.rst
@@ -0,0 +1,15 @@
+===
+pti
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/pti/text_files.rst b/Documentation/pti/text_files.rst
new file mode 100644
index 000000000000..11ff10ffde48
--- /dev/null
+++ b/Documentation/pti/text_files.rst
@@ -0,0 +1,6 @@
+pti intel mid
+-------------
+
+ .. include:: pti_intel_mid.txt
+    :literal:
+
diff --git a/Documentation/ptp/index.rst b/Documentation/ptp/index.rst
new file mode 100644
index 000000000000..e818e57ba2fa
--- /dev/null
+++ b/Documentation/ptp/index.rst
@@ -0,0 +1,15 @@
+===
+ptp
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/ptp/text_files.rst b/Documentation/ptp/text_files.rst
new file mode 100644
index 000000000000..6e99bfa956f6
--- /dev/null
+++ b/Documentation/ptp/text_files.rst
@@ -0,0 +1,6 @@
+ptp
+---
+
+ .. include:: ptp.txt
+    :literal:
+
diff --git a/Documentation/rapidio/index.rst b/Documentation/rapidio/index.rst
new file mode 100644
index 000000000000..fb84ec7e0670
--- /dev/null
+++ b/Documentation/rapidio/index.rst
@@ -0,0 +1,15 @@
+=======
+rapidio
+=======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/rapidio/text_files.rst b/Documentation/rapidio/text_files.rst
new file mode 100644
index 000000000000..954660d67fb7
--- /dev/null
+++ b/Documentation/rapidio/text_files.rst
@@ -0,0 +1,30 @@
+rio cm
+------
+
+ .. include:: rio_cm.txt
+    :literal:
+
+tsi721
+------
+
+ .. include:: tsi721.txt
+    :literal:
+
+rapidio
+-------
+
+ .. include:: rapidio.txt
+    :literal:
+
+sysfs
+-----
+
+ .. include:: sysfs.txt
+    :literal:
+
+mport cdev
+----------
+
+ .. include:: mport_cdev.txt
+    :literal:
+
diff --git a/Documentation/riscv/index.rst b/Documentation/riscv/index.rst
new file mode 100644
index 000000000000..82566ff8f91d
--- /dev/null
+++ b/Documentation/riscv/index.rst
@@ -0,0 +1,15 @@
+=====
+riscv
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/riscv/text_files.rst b/Documentation/riscv/text_files.rst
new file mode 100644
index 000000000000..b802ee76dc3a
--- /dev/null
+++ b/Documentation/riscv/text_files.rst
@@ -0,0 +1,6 @@
+pmu
+---
+
+ .. include:: pmu.txt
+    :literal:
+
diff --git a/Documentation/s390/index.rst b/Documentation/s390/index.rst
new file mode 100644
index 000000000000..67729adbeb34
--- /dev/null
+++ b/Documentation/s390/index.rst
@@ -0,0 +1,15 @@
+====
+s390
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/s390/text_files.rst b/Documentation/s390/text_files.rst
new file mode 100644
index 000000000000..34ef06610849
--- /dev/null
+++ b/Documentation/s390/text_files.rst
@@ -0,0 +1,60 @@
+qeth
+----
+
+ .. include:: qeth.txt
+    :literal:
+
+zfcpdump
+--------
+
+ .. include:: zfcpdump.txt
+    :literal:
+
+driver model
+------------
+
+ .. include:: driver-model.txt
+    :literal:
+
+3270
+----
+
+ .. include:: 3270.txt
+    :literal:
+
+s390dbf
+-------
+
+ .. include:: s390dbf.txt
+    :literal:
+
+Debugging390
+------------
+
+ .. include:: Debugging390.txt
+    :literal:
+
+monreader
+---------
+
+ .. include:: monreader.txt
+    :literal:
+
+vfio ap
+-------
+
+ .. include:: vfio-ap.txt
+    :literal:
+
+cds
+---
+
+ .. include:: cds.txt
+    :literal:
+
+vfio ccw
+--------
+
+ .. include:: vfio-ccw.txt
+    :literal:
+
diff --git a/Documentation/scheduler/index.rst b/Documentation/scheduler/index.rst
new file mode 100644
index 000000000000..de2223df0417
--- /dev/null
+++ b/Documentation/scheduler/index.rst
@@ -0,0 +1,15 @@
+=========
+scheduler
+=========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/scheduler/text_files.rst b/Documentation/scheduler/text_files.rst
new file mode 100644
index 000000000000..021ffdbe46c2
--- /dev/null
+++ b/Documentation/scheduler/text_files.rst
@@ -0,0 +1,60 @@
+completion
+----------
+
+ .. include:: completion.txt
+    :literal:
+
+sched bwc
+---------
+
+ .. include:: sched-bwc.txt
+    :literal:
+
+sched nice design
+-----------------
+
+ .. include:: sched-nice-design.txt
+    :literal:
+
+sched stats
+-----------
+
+ .. include:: sched-stats.txt
+    :literal:
+
+sched deadline
+--------------
+
+ .. include:: sched-deadline.txt
+    :literal:
+
+sched design CFS
+----------------
+
+ .. include:: sched-design-CFS.txt
+    :literal:
+
+sched energy
+------------
+
+ .. include:: sched-energy.txt
+    :literal:
+
+sched arch
+----------
+
+ .. include:: sched-arch.txt
+    :literal:
+
+sched rt group
+--------------
+
+ .. include:: sched-rt-group.txt
+    :literal:
+
+sched domains
+-------------
+
+ .. include:: sched-domains.txt
+    :literal:
+
diff --git a/Documentation/scsi/index.rst b/Documentation/scsi/index.rst
new file mode 100644
index 000000000000..7ff787394bd2
--- /dev/null
+++ b/Documentation/scsi/index.rst
@@ -0,0 +1,15 @@
+====
+scsi
+====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/scsi/text_files.rst b/Documentation/scsi/text_files.rst
new file mode 100644
index 000000000000..dfc5311a9390
--- /dev/null
+++ b/Documentation/scsi/text_files.rst
@@ -0,0 +1,246 @@
+FlashPoint
+----------
+
+ .. include:: FlashPoint.txt
+    :literal:
+
+st
+--
+
+ .. include:: st.txt
+    :literal:
+
+libsas
+------
+
+ .. include:: libsas.txt
+    :literal:
+
+ppa
+---
+
+ .. include:: ppa.txt
+    :literal:
+
+osst
+----
+
+ .. include:: osst.txt
+    :literal:
+
+aacraid
+-------
+
+ .. include:: aacraid.txt
+    :literal:
+
+megaraid
+--------
+
+ .. include:: megaraid.txt
+    :literal:
+
+sd parameters
+-------------
+
+ .. include:: sd-parameters.txt
+    :literal:
+
+aha152x
+-------
+
+ .. include:: aha152x.txt
+    :literal:
+
+hptiop
+------
+
+ .. include:: hptiop.txt
+    :literal:
+
+smartpqi
+--------
+
+ .. include:: smartpqi.txt
+    :literal:
+
+g NCR5380
+---------
+
+ .. include:: g_NCR5380.txt
+    :literal:
+
+qlogicfas
+---------
+
+ .. include:: qlogicfas.txt
+    :literal:
+
+sym53c8xx 2
+-----------
+
+ .. include:: sym53c8xx_2.txt
+    :literal:
+
+scsi mid low api
+----------------
+
+ .. include:: scsi_mid_low_api.txt
+    :literal:
+
+hpsa
+----
+
+ .. include:: hpsa.txt
+    :literal:
+
+scsi changer
+------------
+
+ .. include:: scsi-changer.txt
+    :literal:
+
+scsi fc transport
+-----------------
+
+ .. include:: scsi_fc_transport.txt
+    :literal:
+
+tcm qla2xxx
+-----------
+
+ .. include:: tcm_qla2xxx.txt
+    :literal:
+
+scsi generic
+------------
+
+ .. include:: scsi-generic.txt
+    :literal:
+
+ufs
+---
+
+ .. include:: ufs.txt
+    :literal:
+
+arcmsr spec
+-----------
+
+ .. include:: arcmsr_spec.txt
+    :literal:
+
+scsi
+----
+
+ .. include:: scsi.txt
+    :literal:
+
+cxgb3i
+------
+
+ .. include:: cxgb3i.txt
+    :literal:
+
+dc395x
+------
+
+ .. include:: dc395x.txt
+    :literal:
+
+wd719x
+------
+
+ .. include:: wd719x.txt
+    :literal:
+
+aic7xxx
+-------
+
+ .. include:: aic7xxx.txt
+    :literal:
+
+aic79xx
+-------
+
+ .. include:: aic79xx.txt
+    :literal:
+
+NinjaSCSI
+---------
+
+ .. include:: NinjaSCSI.txt
+    :literal:
+
+scsi parameters
+---------------
+
+ .. include:: scsi-parameters.txt
+    :literal:
+
+bfa
+---
+
+ .. include:: bfa.txt
+    :literal:
+
+lpfc
+----
+
+ .. include:: lpfc.txt
+    :literal:
+
+dpti
+----
+
+ .. include:: dpti.txt
+    :literal:
+
+link power management policy
+----------------------------
+
+ .. include:: link_power_management_policy.txt
+    :literal:
+
+BusLogic
+--------
+
+ .. include:: BusLogic.txt
+    :literal:
+
+ncr53c8xx
+---------
+
+ .. include:: ncr53c8xx.txt
+    :literal:
+
+bnx2fc
+------
+
+ .. include:: bnx2fc.txt
+    :literal:
+
+sym53c500 cs
+------------
+
+ .. include:: sym53c500_cs.txt
+    :literal:
+
+53c700
+------
+
+ .. include:: 53c700.txt
+    :literal:
+
+advansys
+--------
+
+ .. include:: advansys.txt
+    :literal:
+
+scsi eh
+-------
+
+ .. include:: scsi_eh.txt
+    :literal:
+
diff --git a/Documentation/serial/index.rst b/Documentation/serial/index.rst
new file mode 100644
index 000000000000..efb5e664cb50
--- /dev/null
+++ b/Documentation/serial/index.rst
@@ -0,0 +1,15 @@
+======
+serial
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/serial/text_files.rst b/Documentation/serial/text_files.rst
new file mode 100644
index 000000000000..b816ca0f69e9
--- /dev/null
+++ b/Documentation/serial/text_files.rst
@@ -0,0 +1,30 @@
+serial iso7816
+--------------
+
+ .. include:: serial-iso7816.txt
+    :literal:
+
+tty
+---
+
+ .. include:: tty.txt
+    :literal:
+
+rocket
+------
+
+ .. include:: rocket.txt
+    :literal:
+
+serial rs485
+------------
+
+ .. include:: serial-rs485.txt
+    :literal:
+
+n gsm
+-----
+
+ .. include:: n_gsm.txt
+    :literal:
+
diff --git a/Documentation/sparc/index.rst b/Documentation/sparc/index.rst
new file mode 100644
index 000000000000..d2e71a139fd6
--- /dev/null
+++ b/Documentation/sparc/index.rst
@@ -0,0 +1,15 @@
+=====
+sparc
+=====
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/sparc/text_files.rst b/Documentation/sparc/text_files.rst
new file mode 100644
index 000000000000..461369cbaa82
--- /dev/null
+++ b/Documentation/sparc/text_files.rst
@@ -0,0 +1,24 @@
+oracle dax
+----------
+
+ .. include:: oradax/oracle-dax.txt
+    :literal:
+
+dax hv api
+----------
+
+ .. include:: oradax/dax-hv-api.txt
+    :literal:
+
+adi
+---
+
+ .. include:: adi.txt
+    :literal:
+
+console
+-------
+
+ .. include:: console.txt
+    :literal:
+
diff --git a/Documentation/sphinx/index.rst b/Documentation/sphinx/index.rst
new file mode 100644
index 000000000000..6cf7d66129ea
--- /dev/null
+++ b/Documentation/sphinx/index.rst
@@ -0,0 +1,15 @@
+======
+sphinx
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/sphinx/text_files.rst b/Documentation/sphinx/text_files.rst
new file mode 100644
index 000000000000..c63b74ae99d5
--- /dev/null
+++ b/Documentation/sphinx/text_files.rst
@@ -0,0 +1,6 @@
+requirements
+------------
+
+ .. include:: requirements.txt
+    :literal:
+
diff --git a/Documentation/sysctl/index.rst b/Documentation/sysctl/index.rst
new file mode 100644
index 000000000000..1c087d67d789
--- /dev/null
+++ b/Documentation/sysctl/index.rst
@@ -0,0 +1,15 @@
+======
+sysctl
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/sysctl/text_files.rst b/Documentation/sysctl/text_files.rst
new file mode 100644
index 000000000000..15684500f4de
--- /dev/null
+++ b/Documentation/sysctl/text_files.rst
@@ -0,0 +1,42 @@
+abi
+---
+
+ .. include:: abi.txt
+    :literal:
+
+kernel
+------
+
+ .. include:: kernel.txt
+    :literal:
+
+vm
+--
+
+ .. include:: vm.txt
+    :literal:
+
+net
+---
+
+ .. include:: net.txt
+    :literal:
+
+sunrpc
+------
+
+ .. include:: sunrpc.txt
+    :literal:
+
+fs
+--
+
+ .. include:: fs.txt
+    :literal:
+
+user
+----
+
+ .. include:: user.txt
+    :literal:
+
diff --git a/Documentation/target/index.rst b/Documentation/target/index.rst
new file mode 100644
index 000000000000..8f147d94974c
--- /dev/null
+++ b/Documentation/target/index.rst
@@ -0,0 +1,15 @@
+======
+target
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/target/text_files.rst b/Documentation/target/text_files.rst
new file mode 100644
index 000000000000..6604a6637d3d
--- /dev/null
+++ b/Documentation/target/text_files.rst
@@ -0,0 +1,12 @@
+tcmu design
+-----------
+
+ .. include:: tcmu-design.txt
+    :literal:
+
+tcm mod builder
+---------------
+
+ .. include:: tcm_mod_builder.txt
+    :literal:
+
diff --git a/Documentation/thermal/index.rst b/Documentation/thermal/index.rst
new file mode 100644
index 000000000000..5d25cb046bee
--- /dev/null
+++ b/Documentation/thermal/index.rst
@@ -0,0 +1,15 @@
+=======
+thermal
+=======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/thermal/text_files.rst b/Documentation/thermal/text_files.rst
new file mode 100644
index 000000000000..1a41df47bce6
--- /dev/null
+++ b/Documentation/thermal/text_files.rst
@@ -0,0 +1,24 @@
+cpu cooling api
+---------------
+
+ .. include:: cpu-cooling-api.txt
+    :literal:
+
+sysfs api
+---------
+
+ .. include:: sysfs-api.txt
+    :literal:
+
+intel powerclamp
+----------------
+
+ .. include:: intel_powerclamp.txt
+    :literal:
+
+power allocator
+---------------
+
+ .. include:: power_allocator.txt
+    :literal:
+
diff --git a/Documentation/timers/index.rst b/Documentation/timers/index.rst
new file mode 100644
index 000000000000..eaf4b4259083
--- /dev/null
+++ b/Documentation/timers/index.rst
@@ -0,0 +1,15 @@
+======
+timers
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/timers/text_files.rst b/Documentation/timers/text_files.rst
new file mode 100644
index 000000000000..a985c0b36952
--- /dev/null
+++ b/Documentation/timers/text_files.rst
@@ -0,0 +1,36 @@
+highres
+-------
+
+ .. include:: highres.txt
+    :literal:
+
+timekeeping
+-----------
+
+ .. include:: timekeeping.txt
+    :literal:
+
+NO HZ
+-----
+
+ .. include:: NO_HZ.txt
+    :literal:
+
+hrtimers
+--------
+
+ .. include:: hrtimers.txt
+    :literal:
+
+hpet
+----
+
+ .. include:: hpet.txt
+    :literal:
+
+timers howto
+------------
+
+ .. include:: timers-howto.txt
+    :literal:
+
diff --git a/Documentation/usb/index.rst b/Documentation/usb/index.rst
new file mode 100644
index 000000000000..8f8aa24153c3
--- /dev/null
+++ b/Documentation/usb/index.rst
@@ -0,0 +1,15 @@
+===
+usb
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/usb/text_files.rst b/Documentation/usb/text_files.rst
new file mode 100644
index 000000000000..d252ded9733b
--- /dev/null
+++ b/Documentation/usb/text_files.rst
@@ -0,0 +1,138 @@
+usb serial
+----------
+
+ .. include:: usb-serial.txt
+    :literal:
+
+acm
+---
+
+ .. include:: acm.txt
+    :literal:
+
+authorization
+-------------
+
+ .. include:: authorization.txt
+    :literal:
+
+gadget testing
+--------------
+
+ .. include:: gadget-testing.txt
+    :literal:
+
+gadget hid
+----------
+
+ .. include:: gadget_hid.txt
+    :literal:
+
+ohci
+----
+
+ .. include:: ohci.txt
+    :literal:
+
+rio
+---
+
+ .. include:: rio.txt
+    :literal:
+
+mtouchusb
+---------
+
+ .. include:: mtouchusb.txt
+    :literal:
+
+usbmon
+------
+
+ .. include:: usbmon.txt
+    :literal:
+
+mass storage
+------------
+
+ .. include:: mass-storage.txt
+    :literal:
+
+chipidea
+--------
+
+ .. include:: chipidea.txt
+    :literal:
+
+iuu phoenix
+-----------
+
+ .. include:: iuu_phoenix.txt
+    :literal:
+
+misc usbsevseg
+--------------
+
+ .. include:: misc_usbsevseg.txt
+    :literal:
+
+gadget configfs
+---------------
+
+ .. include:: gadget_configfs.txt
+    :literal:
+
+gadget multi
+------------
+
+ .. include:: gadget_multi.txt
+    :literal:
+
+functionfs
+----------
+
+ .. include:: functionfs.txt
+    :literal:
+
+gadget serial
+-------------
+
+ .. include:: gadget_serial.txt
+    :literal:
+
+gadget printer
+--------------
+
+ .. include:: gadget_printer.txt
+    :literal:
+
+usbip protocol
+--------------
+
+ .. include:: usbip_protocol.txt
+    :literal:
+
+WUSB Design overview
+--------------------
+
+ .. include:: WUSB-Design-overview.txt
+    :literal:
+
+ehci
+----
+
+ .. include:: ehci.txt
+    :literal:
+
+dwc3
+----
+
+ .. include:: dwc3.txt
+    :literal:
+
+usb help
+--------
+
+ .. include:: usb-help.txt
+    :literal:
+
diff --git a/Documentation/virtual/index.rst b/Documentation/virtual/index.rst
new file mode 100644
index 000000000000..5926192c8372
--- /dev/null
+++ b/Documentation/virtual/index.rst
@@ -0,0 +1,17 @@
+=======
+virtual
+=======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+    kvm/amd-memory-encryption.rst
+    kvm/vcpu-requests.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/virtual/text_files.rst b/Documentation/virtual/text_files.rst
new file mode 100644
index 000000000000..3fe1087fd7bb
--- /dev/null
+++ b/Documentation/virtual/text_files.rst
@@ -0,0 +1,150 @@
+UserModeLinux HOWTO
+-------------------
+
+ .. include:: uml/UserModeLinux-HOWTO.txt
+    :literal:
+
+paravirt ops
+------------
+
+ .. include:: paravirt_ops.txt
+    :literal:
+
+msr
+---
+
+ .. include:: kvm/msr.txt
+    :literal:
+
+mpic
+----
+
+ .. include:: kvm/devices/mpic.txt
+    :literal:
+
+vcpu
+----
+
+ .. include:: kvm/devices/vcpu.txt
+    :literal:
+
+vfio
+----
+
+ .. include:: kvm/devices/vfio.txt
+    :literal:
+
+arm vgic
+--------
+
+ .. include:: kvm/devices/arm-vgic.txt
+    :literal:
+
+vm
+--
+
+ .. include:: kvm/devices/vm.txt
+    :literal:
+
+s390 flic
+---------
+
+ .. include:: kvm/devices/s390_flic.txt
+    :literal:
+
+xics
+----
+
+ .. include:: kvm/devices/xics.txt
+    :literal:
+
+arm vgic v3
+-----------
+
+ .. include:: kvm/devices/arm-vgic-v3.txt
+    :literal:
+
+arm vgic its
+------------
+
+ .. include:: kvm/devices/arm-vgic-its.txt
+    :literal:
+
+timekeeping
+-----------
+
+ .. include:: kvm/timekeeping.txt
+    :literal:
+
+api
+---
+
+ .. include:: kvm/api.txt
+    :literal:
+
+s390 diag
+---------
+
+ .. include:: kvm/s390-diag.txt
+    :literal:
+
+halt polling
+------------
+
+ .. include:: kvm/halt-polling.txt
+    :literal:
+
+nested vmx
+----------
+
+ .. include:: kvm/nested-vmx.txt
+    :literal:
+
+hypercalls
+----------
+
+ .. include:: kvm/hypercalls.txt
+    :literal:
+
+cpuid
+-----
+
+ .. include:: kvm/cpuid.txt
+    :literal:
+
+psci
+----
+
+ .. include:: kvm/arm/psci.txt
+    :literal:
+
+hyp abi
+-------
+
+ .. include:: kvm/arm/hyp-abi.txt
+    :literal:
+
+review checklist
+----------------
+
+ .. include:: kvm/review-checklist.txt
+    :literal:
+
+locking
+-------
+
+ .. include:: kvm/locking.txt
+    :literal:
+
+mmu
+---
+
+ .. include:: kvm/mmu.txt
+    :literal:
+
+ppc pv
+------
+
+ .. include:: kvm/ppc-pv.txt
+    :literal:
+
diff --git a/Documentation/watchdog/index.rst b/Documentation/watchdog/index.rst
new file mode 100644
index 000000000000..620f9d9175e1
--- /dev/null
+++ b/Documentation/watchdog/index.rst
@@ -0,0 +1,15 @@
+========
+watchdog
+========
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/watchdog/text_files.rst b/Documentation/watchdog/text_files.rst
new file mode 100644
index 000000000000..0061a48c8a8f
--- /dev/null
+++ b/Documentation/watchdog/text_files.rst
@@ -0,0 +1,54 @@
+wdt
+---
+
+ .. include:: wdt.txt
+    :literal:
+
+pcwd watchdog
+-------------
+
+ .. include:: pcwd-watchdog.txt
+    :literal:
+
+convert drivers to kernel api
+-----------------------------
+
+ .. include:: convert_drivers_to_kernel_api.txt
+    :literal:
+
+watchdog api
+------------
+
+ .. include:: watchdog-api.txt
+    :literal:
+
+mlx wdt
+-------
+
+ .. include:: mlx-wdt.txt
+    :literal:
+
+watchdog kernel api
+-------------------
+
+ .. include:: watchdog-kernel-api.txt
+    :literal:
+
+hpwdt
+-----
+
+ .. include:: hpwdt.txt
+    :literal:
+
+watchdog parameters
+-------------------
+
+ .. include:: watchdog-parameters.txt
+    :literal:
+
+watchdog pm
+-----------
+
+ .. include:: watchdog-pm.txt
+    :literal:
+
diff --git a/Documentation/x86/index.rst b/Documentation/x86/index.rst
new file mode 100644
index 000000000000..86dbc8a60159
--- /dev/null
+++ b/Documentation/x86/index.rst
@@ -0,0 +1,15 @@
+===
+x86
+===
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/x86/text_files.rst b/Documentation/x86/text_files.rst
new file mode 100644
index 000000000000..4bb7caad5cb6
--- /dev/null
+++ b/Documentation/x86/text_files.rst
@@ -0,0 +1,132 @@
+exception tables
+----------------
+
+ .. include:: exception-tables.txt
+    :literal:
+
+usb legacy support
+------------------
+
+ .. include:: usb-legacy-support.txt
+    :literal:
+
+tlb
+---
+
+ .. include:: tlb.txt
+    :literal:
+
+IO APIC
+-------
+
+ .. include:: i386/IO-APIC.txt
+    :literal:
+
+mtrr
+----
+
+ .. include:: mtrr.txt
+    :literal:
+
+earlyprintk
+-----------
+
+ .. include:: earlyprintk.txt
+    :literal:
+
+zero page
+---------
+
+ .. include:: zero-page.txt
+    :literal:
+
+orc unwinder
+------------
+
+ .. include:: orc-unwinder.txt
+    :literal:
+
+5level paging
+-------------
+
+ .. include:: x86_64/5level-paging.txt
+    :literal:
+
+mm
+--
+
+ .. include:: x86_64/mm.txt
+    :literal:
+
+uefi
+----
+
+ .. include:: x86_64/uefi.txt
+    :literal:
+
+boot options
+------------
+
+ .. include:: x86_64/boot-options.txt
+    :literal:
+
+topology
+--------
+
+ .. include:: topology.txt
+    :literal:
+
+intel mpx
+---------
+
+ .. include:: intel_mpx.txt
+    :literal:
+
+microcode
+---------
+
+ .. include:: microcode.txt
+    :literal:
+
+pti
+---
+
+ .. include:: pti.txt
+    :literal:
+
+boot
+----
+
+ .. include:: boot.txt
+    :literal:
+
+entry 64
+--------
+
+ .. include:: entry_64.txt
+    :literal:
+
+amd memory encryption
+---------------------
+
+ .. include:: amd-memory-encryption.txt
+    :literal:
+
+protection keys
+---------------
+
+ .. include:: protection-keys.txt
+    :literal:
+
+pat
+---
+
+ .. include:: pat.txt
+    :literal:
+
+resctrl ui
+----------
+
+ .. include:: resctrl_ui.txt
+    :literal:
+
diff --git a/Documentation/xilinx/index.rst b/Documentation/xilinx/index.rst
new file mode 100644
index 000000000000..4dc76c07ce9e
--- /dev/null
+++ b/Documentation/xilinx/index.rst
@@ -0,0 +1,15 @@
+======
+xilinx
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/xilinx/text_files.rst b/Documentation/xilinx/text_files.rst
new file mode 100644
index 000000000000..6c9623381591
--- /dev/null
+++ b/Documentation/xilinx/text_files.rst
@@ -0,0 +1,6 @@
+eemi
+----
+
+ .. include:: eemi.txt
+    :literal:
+
diff --git a/Documentation/xtensa/index.rst b/Documentation/xtensa/index.rst
new file mode 100644
index 000000000000..a3e823504e0e
--- /dev/null
+++ b/Documentation/xtensa/index.rst
@@ -0,0 +1,15 @@
+======
+xtensa
+======
+
+.. toctree::
+    :maxdepth: 1
+
+    text_files.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/xtensa/text_files.rst b/Documentation/xtensa/text_files.rst
new file mode 100644
index 000000000000..83af5b20b10c
--- /dev/null
+++ b/Documentation/xtensa/text_files.rst
@@ -0,0 +1,18 @@
+booting
+-------
+
+ .. include:: booting.txt
+    :literal:
+
+atomctl
+-------
+
+ .. include:: atomctl.txt
+    :literal:
+
+mmu
+---
+
+ .. include:: mmu.txt
+    :literal:
+
-- 
2.20.1

Re: [PATCH 00/10] Add all documentation files to an html/pdf produced book

[Jonathan Corbet]

On Mon,  8 Apr 2019 13:58:16 -0300
Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:

> Despite having converted almost all files to ReST at the main Documentation/
> directory, they're still not included to any book. Also, after all those years
> after migrated to ReST as the official documentation format, there are still
> a lot of files using plain TXT files, with random internal formatting.
> 
> As it will likely require a lot more years to get everything converted,
> let's add index.rst files to Documentation/* subdirs, with a text_files.rst
> including all plain txt files as literal includes.
> 
> That ensures that the html output will contain the entire Linux Kernel
> documentation.

Hmm...

>  251 files changed, 5262 insertions(+), 47 deletions(-)

Somebody clearly thinks I haven't been involved in enough merge conflicts
recently :)

I understand the goal, but I have to wonder.  This feels a lot like giving
up on the problem and just sweeping the remaining junk into a pile
somewhere.  I feel like it would, if anything, reduce the incentive to
deal with these leftover documents properly.  

If this is *really* something we want to do, I would much rather proceed
in smaller steps and preferably with the cooperation of the maintainers
involved.  Imposing all of this at once just seems like a way to make it
highly dangerous for me to show my face a conferences...

Thoughts?

Thanks,

jon

Re: [PATCH 00/10] Add all documentation files to an html/pdf produced book

[Mauro Carvalho Chehab]

Em Mon, 8 Apr 2019 16:18:20 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Mon,  8 Apr 2019 13:58:16 -0300
> Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:
> 
> > Despite having converted almost all files to ReST at the main Documentation/
> > directory, they're still not included to any book. Also, after all those years
> > after migrated to ReST as the official documentation format, there are still
> > a lot of files using plain TXT files, with random internal formatting.
> > 
> > As it will likely require a lot more years to get everything converted,
> > let's add index.rst files to Documentation/* subdirs, with a text_files.rst
> > including all plain txt files as literal includes.
> > 
> > That ensures that the html output will contain the entire Linux Kernel
> > documentation.  
> 
> Hmm...
> 
> >  251 files changed, 5262 insertions(+), 47 deletions(-)  
> 
> Somebody clearly thinks I haven't been involved in enough merge conflicts
> recently :)

:-)

If you take a look at the patches themselves, the first 6 patches are
puntual fixes to a single doc file, in order to fix them:

  [PATCH 01/10] docs: DMA-API-HOWTO: add a missing "="
  [PATCH 02/10] docs: atomic_bitops.txt: add a title for this document
  [PATCH 03/10] docs: clearing-warn-once.txt: add a title for this document
  [PATCH 04/10] docs: ntb.txt: use Sphinx notation for the two ascii figures
  [PATCH 05/10] docs: unaligned-memory-access.txt: use a lowercase title
  [PATCH 06/10] docs: video-output.txt: convert it to ReST format

I remember we patched all Documentation/*.txt files in the past to make
them ReST compliant. New changes (or new files) broke it. Those could
be easily reviewed by their maintainers.

In order to avoid new regressions, and ensure that those ReST files
will be part of the build, the 7th patch rename those files from
*.txt to *.rst and move to an "other/" directory, creating an
"unclassified" book:

  [PATCH 07/10] docs: Add all txt files to documentation

The next two patches are additional ReST improvements and warning
fixes:

  [PATCH 08/10] docs: ntb.rst: add blank lines to clean up some Sphinx warnings
  [PATCH 09/10] docs: speculation.rst: mark example blocks as such

And the final patch adds one index.rst to each sub-directory at
Documentation/ that doesn't have yet any ReST file:

  [PATCH 10/10] docs: add plain text files to ReST output from  subdirs

Inside each Documentation/ subdir, it also adds a text_files.rst with
includes all plain text files.

You're right: patch 07/10 rename would cause trivial merge conflicts. So, if
we are willing to take this, it probably makes sense to apply it late at
a merge cycle.

Patch 10/10 should not cause many conflicts (except if one remove a dir or
a file), as it only adds new files. Still, worth applying it also late
at the merge cycle.

That's said, I was naive to not reorder the patch series, keeping just
the two polemic patches at the end. I'll rebase my series, in order to
send the fixes patches.

So, let's focus the discussions on those two patches:

  [PATCH 07/10] docs: Add all txt files to documentation
  [PATCH 10/10] docs: add plain text files to ReST output from  subdirs

> I understand the goal, but I have to wonder.  This feels a lot like giving
> up on the problem and just sweeping the remaining junk into a pile
> somewhere.

The junk is already there. If we don't take any action to
separate the wheat from the chaff, it will keep tormenting us
for decades to come.

Looking on our main index.rst file, it defines those major groups:

	Licensing documentation
	User-oriented documentation
	Application-developer documentation
	Introduction to kernel development
	Kernel API documentation
	Architecture-specific documentation
	Filesystem Documentation
	Translations

The problem with the legacy stuff is that the same document frequently
has user-oriented, application-oriented and kernel-API stuff at the
same file (or group of files), as they're usually arranged per
subsystem or per C fileset. So, it is not possible to move them as-is
to any of the above without risking adding mess to the higher quality
documments.

Splitting those stuff into the main groups is no joy, and would be
an intensive hard work to solve it. We either need someone to sponsor
a group of people just for rewriting documentation or this will never
happen. In any case, IMHO, the best would be to add a new
crap^h^h^h^hstaging group were we could place all legacy random stuff.
Then, gradually fix those, splitting stuff and promoting them to the
main books, in a similar way to what we do with staging.

> I feel like it would, if anything, reduce the incentive to
> deal with these leftover documents properly.  

IMHO, it is just the opposite. Let's face it: ReST build was added around
May, 2016, for Kernel 4.7. People had quite some time and kernel versions
to do conversions. If nothing is done, I doubt we would have any boom on
patches addressing the issues.

On the other hand, if someone wants to add a ReST file to a random 
Documentation/* subdir that doesn't contain yet an index.rst file, it would
need first to add an index, and may be ashamed of adding something there
without converting the existing files. By having one index.rst file there,
newer files could be added directly there, without the need of touching
the legacy stuff. IMHO, this reduces the barrier to get new documentation
using the ReST format. It should equally be easy for someone to convert
single document files from text to ReST, as it would only need to remove
the file from the text_files.rst, adding it at index.rst.

> If this is *really* something we want to do, I would much rather proceed
> in smaller steps and preferably with the cooperation of the maintainers
> involved.  Imposing all of this at once just seems like a way to make it
> highly dangerous for me to show my face a conferences...

I understand your PoV, but not sure how to proceed.

IMO, we should aim to achieve two goals:

1) avoid, as much as possible, to add new plain text non-ReST compatible
files to the documentation, as, if we keep adding them, we'll never
have a consistent documentation set;

2) ensure that the already converted files will be on some book, as this
will help to identify regressions.

That's what patches 07/10 and 10/10 are trying to achieve.

It should be easy to break patch 10/10 on a per-subdir base, making
it easier to be merge it by subsystem maintainers.

If I split it on per-subdir, that would fit for you?

-

In the case of patch 07/10, I might have done it on a different way:
instead of moving them to a "staging-like" book (Documentation/other),
it could have used other strategies:

1) rename the files to *.rst but leaving them at the Documentation/
diretory, and adding a new "other.rst" or "staging.rst" where those
stuff would be added. IMHO, this is a crap way of doing it, as
we'll use the main Documentation/ dir as a trash can;

2) do a better job with moves, adding those files on some existing
sub-directories. This doesn't sound an easy task, as it is not
trivial to associate every single file there with an existing book.
Also, some stuff there don't have new content added for ages.
Maybe the stuff doesn't apply anymore (or it is for some part of
the Kernel that are just stable enough).

Ok, perhaps if we add patch 10/10 before 07/10, it could make
easier to move the files, as we'll have a lot more places to
add the rst files, as all sub-dirs will now contain rst files.

If you're ok with such strategy, I could try such approach and
see what happens.

Thanks,
Mauro

Re: [PATCH 00/10] Add all documentation files to an html/pdf produced book

[Jonathan Corbet]

On Wed, 10 Apr 2019 06:49:39 -0300
Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:

[I'm just responding to one little piece of this for the moment...]

> In any case, IMHO, the best would be to add a new
> crap^h^h^h^hstaging group were we could place all legacy random stuff.
> Then, gradually fix those, splitting stuff and promoting them to the
> main books, in a similar way to what we do with staging.

Now that's an interesting idea; I hadn't thought about that.  Doing so,
though, implies a willingness to stage unloved docs *out*, and my
experience is that there is little appetite for that.  It also kind of
implies moving docs twice - at least for the ones that get updates - and
that may not be entirely appreciated.

> > I feel like it would, if anything, reduce the incentive to
> > deal with these leftover documents properly.    
> 
> IMHO, it is just the opposite. Let's face it: ReST build was added around
> May, 2016, for Kernel 4.7. People had quite some time and kernel versions
> to do conversions. If nothing is done, I doubt we would have any boom on
> patches addressing the issues.

So I don't have any hard numbers, but my feeling is that this work is
continuing apace and perhaps even picking up.  Certainly I'm having a
harder time keeping up with it, even when you're busy with other things :)
These things take time; I'm not really ready to give up on it yet.

Thanks,

jon

Re: [PATCH 00/10] Add all documentation files to an html/pdf produced book

[Mauro Carvalho Chehab]

Em Thu, 11 Apr 2019 12:49:04 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Wed, 10 Apr 2019 06:49:39 -0300
> Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:
> 
> [I'm just responding to one little piece of this for the moment...]
> 
> > In any case, IMHO, the best would be to add a new
> > crap^h^h^h^hstaging group were we could place all legacy random stuff.
> > Then, gradually fix those, splitting stuff and promoting them to the
> > main books, in a similar way to what we do with staging.  
> 
> Now that's an interesting idea; I hadn't thought about that.  Doing so,
> though, implies a willingness to stage unloved docs *out*,

That sounds like a plus! 

> and my experience is that there is little appetite for that. 

Heh, I guess most of us are biased to avoid dropping stuff. Yet, it
happens with time. I wouldn't mind dropping something too outdated
if, after some time, nobody fixes the issues there.

> It also kind of
> implies moving docs twice - at least for the ones that get updates - and
> that may not be entirely appreciated.

True, but avoiding moving twice is not trivial. I mean, files
need to be renamed anyway. Only if we get it right the first
time (converting the file and placing at the right place), we'll
avoid a double move.

I considered an alternative of just including a *.txt file
at a ReST TOC, but Sphinx doesn't allow including a file that
it is not specified at source_suffix. Worse than that, if a
suffix is added there, it will parse (and crash) if the file
has things like:
        some indented title
        ===================

or even:
	- item
	- ....

With a sort of pattern that we have on several text files.

There's an alternative: we could have an "index_staging.rst" file
with the documents that require serious work. So, instead of
actually moving stuff, we'll just place their location there
(but files still need to be renamed). When the document is fixed,
all we need is to move from the staging index to the main one.

> > > I feel like it would, if anything, reduce the incentive to
> > > deal with these leftover documents properly.      
> > 
> > IMHO, it is just the opposite. Let's face it: ReST build was added around
> > May, 2016, for Kernel 4.7. People had quite some time and kernel versions
> > to do conversions. If nothing is done, I doubt we would have any boom on
> > patches addressing the issues.  
> 
> So I don't have any hard numbers, but my feeling is that this work is
> continuing apace and perhaps even picking up.  Certainly I'm having a
> harder time keeping up with it, even when you're busy with other things :)
> These things take time; I'm not really ready to give up on it yet.

Ok. I'm working on a series of patches converting stuff from some random
subsystems. I should be sending the series soon.


Thanks,
Mauro

Re: [PATCH 00/10] Add all documentation files to an html/pdf produced book

[Mauro Carvalho Chehab]

Em Fri, 12 Apr 2019 06:28:26 -0300
Mauro Carvalho Chehab <mchehab+samsung@kernel.org> escreveu:

> > So I don't have any hard numbers, but my feeling is that this work is
> > continuing apace and perhaps even picking up.  Certainly I'm having a
> > harder time keeping up with it, even when you're busy with other things :)
> > These things take time; I'm not really ready to give up on it yet.  
> 
> Ok. I'm working on a series of patches converting stuff from some random
> subsystems. I should be sending the series soon.

Finished the conversion. I need to do double-check if everything is
ok and fix broken links, but if you want to take a sneak peak, it is
on my devel tree:

	https://git.linuxtv.org/mchehab/experimental.git/tree/?h=all_with_indexes

It got a way bigger than the past series:

 379 files changed, 22705 insertions(+), 17379 deletions(-)

As this time it is doing a ReST conversion instead of just adding
indexes for *.txt files.


Thanks,
Mauro

Mauro Carvalho Chehab (41):
      docs: acpi: convert text files to ReST
      Documentation/aoe: convert it to ReST output
      Documentation/arm64: convert documentation to ReST format
      Documentation/cdrom/cdrom-standard.tex: convert from LaTeX to ReST
      Documentation/cdrom: add plain text files to ReST output
      Documentation/cdrom: convert remaining files to ReST
      Documentation/cgroup-v1: add plain text files to ReST output
      docs: cgroup-v1/cgroups.txt: convert it to ReST file format
      Documentation/cpu-freq: convert files to ReST
      Documentation/device-mapper: convert it to ReST format
      docs: extcon: move it to acpi dir and convert it to ReST
      Documentation/fault-injection: convert it to ReST format
      Documentation/fb: convert documentation to ReST format
      Documentation/fpga: convert it to ReST
      Documentation/gpio: convert it to ReST
      Documentation/ide: convert it to ReST format
      Documentation/infiniband: convert it to ReST format
      Documentation/kbuild: convert it to ReST output
      Documentation/kdump: convert it to ReST
      Documentation/livepatch: convert it to ReST format
      Documentation/locking: convert docs to ReST format
      Documentation/mic: convert it to ReST format
      Documentation/netlabel: convert it to ReST
      Documentation/PCI: convert docs to ReST format
      Documentation/pcmcia: convert it to ReST format
      Documentation/power: convert docs to ReST
      Documentation/powerpc: convert docs to ReST
      Documentation/pps/pps.txt convert it to ReST and move to API book
      Documentation/ptp/ptp.txt: convert to ReST and move to driver-api
      Documentation/riscv: convert it to ReST format
      s390: include/asm/debug.h add kerneldoc markups
      s390: Debugging390.txt convert table to ascii artwork
      s390: docs: convert text files to ReST format
      s390: docs: s390dbf.rst: use kernel-doc markup
      Documentation/serial: convert it to ReST format
      Documentation/target: convert it to ReST format
      Documentation/timers: convert to ReST and add to the kernel API book
      Documentation/usb: convert documents to ReST
      Documentation/watchdog: convert documents to ReST format
      Documentation/x86: convert text files to ReST and add to arch book
      Documentation/xilinx: convert eemi.txt to ReST

 Documentation/PCI/{MSI-HOWTO.txt => MSI-HOWTO.rst} |   56 +-
 .../PCI/{PCIEBUS-HOWTO.txt => PCIEBUS-HOWTO.rst}   |   57 +-
 Documentation/PCI/{acpi-info.txt => acpi-info.rst} |    9 +-
 .../PCI/endpoint/function/binding/pci-test.rst     |   24 +
 .../PCI/endpoint/function/binding/pci-test.txt     |   19 -
 .../{pci-endpoint-cfs.txt => pci-endpoint-cfs.rst} |   37 +-
 .../{pci-endpoint.txt => pci-endpoint.rst}         |  101 +-
 ...pci-test-function.txt => pci-test-function.rst} |   70 +-
 .../{pci-test-howto.txt => pci-test-howto.rst}     |   49 +-
 Documentation/PCI/index.rst                        |   28 +
 ...i-error-recovery.txt => pci-error-recovery.rst} |  201 +-
 .../PCI/{pci-iov-howto.txt => pci-iov-howto.rst}   |   88 +-
 Documentation/PCI/{pci.txt => pci.rst}             |  170 +-
 .../PCI/{pcieaer-howto.txt => pcieaer-howto.rst}   |  103 +-
 ...operties-rules.txt => DSD-properties-rules.rst} |    4 +-
 Documentation/acpi/{acpi-lid.txt => acpi-lid.rst}  |   37 +-
 .../acpi/{aml-debugger.txt => aml-debugger.rst}    |   31 +-
 Documentation/acpi/apei/{einj.txt => einj.rst}     |   59 +-
 Documentation/acpi/apei/output_format.rst          |  148 ++
 Documentation/acpi/apei/output_format.txt          |  147 --
 .../acpi/{cppc_sysfs.txt => cppc_sysfs.rst}        |   52 +-
 Documentation/acpi/{debug.txt => debug.rst}        |   20 +-
 .../drivers/extcon-intel-int3496.rst}              |   14 +-
 ...ode-references.txt => data-node-references.rst} |   11 +-
 Documentation/acpi/dsd/{graph.txt => graph.rst}    |   24 +-
 .../acpi/{dsdt-override.txt => dsdt-override.rst}  |    4 +-
 .../acpi/{enumeration.txt => enumeration.rst}      |   40 +-
 .../{gpio-properties.txt => gpio-properties.rst}   |   42 +-
 .../acpi/{i2c-muxes.txt => i2c-muxes.rst}          |   21 +-
 Documentation/acpi/index.rst                       |   41 +
 ...able_override.txt => initrd_table_override.rst} |   90 +-
 .../{linuxized-acpica.txt => linuxized-acpica.rst} |   58 +-
 Documentation/acpi/{lpit.txt => lpit.rst}          |    8 +-
 ...thod-customizing.txt => method-customizing.rst} |   48 +-
 .../{method-tracing.txt => method-tracing.rst}     |  132 +-
 .../acpi/{namespace.txt => namespace.rst}          |  327 +--
 Documentation/acpi/{osi.txt => osi.rst}            |    3 +-
 .../acpi/{scan_handlers.txt => scan_handlers.rst}  |    9 +-
 .../acpi/{ssdt-overlays.txt => ssdt-overlays.rst}  |  128 +-
 .../{video_extension.txt => video_extension.rst}   |   16 +-
 Documentation/aoe/{aoe.txt => aoe.rst}             |   65 +-
 Documentation/aoe/examples.rst                     |   24 +
 Documentation/aoe/index.rst                        |   17 +
 Documentation/aoe/{todo.txt => todo.rst}           |    3 +
 ...acpi_object_usage.txt => acpi_object_usage.rst} |  280 ++-
 Documentation/arm64/{arm-acpi.txt => arm-acpi.rst} |  161 +-
 Documentation/arm64/{booting.txt => booting.rst}   |   91 +-
 ...ure-registers.txt => cpu-feature-registers.rst} |  196 +-
 .../arm64/{elf_hwcaps.txt => elf_hwcaps.rst}       |   50 +-
 .../arm64/{hugetlbpage.txt => hugetlbpage.rst}     |    7 +-
 Documentation/arm64/index.rst                      |   26 +
 ...cy_instructions.txt => legacy_instructions.rst} |   43 +-
 Documentation/arm64/memory.rst                     |   98 +
 Documentation/arm64/memory.txt                     |   97 -
 ...thentication.txt => pointer-authentication.rst} |    2 +
 .../{silicon-errata.txt => silicon-errata.rst}     |   62 +-
 Documentation/arm64/{sve.txt => sve.rst}           |   10 +-
 .../{tagged-pointers.txt => tagged-pointers.rst}   |    6 +-
 Documentation/cdrom/Makefile                       |   21 -
 Documentation/cdrom/cdrom-standard.rst             | 1063 ++++++++
 Documentation/cdrom/cdrom-standard.tex             | 1026 --------
 Documentation/cdrom/{ide-cd => ide-cd.rst}         |  132 +-
 Documentation/cdrom/index.rst                      |   17 +
 .../{packet-writing.txt => packet-writing.rst}     |   27 +-
 .../cgroup-v1/{cgroups.txt => cgroups.rst}         |  182 +-
 Documentation/cgroup-v1/index.rst                  |   16 +
 Documentation/cgroup-v1/text_files.rst             |   72 +
 .../{amd-powernow.txt => amd-powernow.rst}         |    7 +
 Documentation/cpu-freq/{core.txt => core.rst}      |   66 +-
 .../cpu-freq/{cpu-drivers.txt => cpu-drivers.rst}  |  207 +-
 .../{cpufreq-nforce2.txt => cpufreq-nforce2.rst}   |    8 +-
 Documentation/cpu-freq/cpufreq-stats.rst           |  128 +
 Documentation/cpu-freq/cpufreq-stats.txt           |  127 -
 Documentation/cpu-freq/index.rst                   |   50 +
 Documentation/cpu-freq/index.txt                   |   56 -
 .../cpu-freq/{pcc-cpufreq.txt => pcc-cpufreq.rst}  |  102 +-
 .../{cache-policies.txt => cache-policies.rst}     |   24 +-
 .../device-mapper/{cache.txt => cache.rst}         |  214 +-
 .../device-mapper/{delay.txt => delay.rst}         |   29 +-
 .../device-mapper/{dm-crypt.txt => dm-crypt.rst}   |   61 +-
 .../device-mapper/{dm-flakey.txt => dm-flakey.rst} |   45 +-
 .../device-mapper/{dm-init.txt => dm-init.rst}     |   75 +-
 .../{dm-integrity.txt => dm-integrity.rst}         |   55 +-
 .../device-mapper/{dm-io.txt => dm-io.rst}         |   13 +-
 .../device-mapper/{dm-log.txt => dm-log.rst}       |    5 +-
 .../{dm-queue-length.txt => dm-queue-length.rst}   |   25 +-
 .../device-mapper/{dm-raid.txt => dm-raid.rst}     |  225 +-
 .../{dm-service-time.txt => dm-service-time.rst}   |   76 +-
 Documentation/device-mapper/dm-uevent.rst          |  110 +
 Documentation/device-mapper/dm-uevent.txt          |   97 -
 .../device-mapper/{dm-zoned.txt => dm-zoned.rst}   |   10 +-
 Documentation/device-mapper/{era.txt => era.rst}   |   36 +-
 Documentation/device-mapper/index.rst              |   42 +
 .../device-mapper/{kcopyd.txt => kcopyd.rst}       |    9 +-
 Documentation/device-mapper/linear.rst             |   63 +
 Documentation/device-mapper/linear.txt             |   61 -
 .../{log-writes.txt => log-writes.rst}             |  107 +-
 .../{persistent-data.txt => persistent-data.rst}   |    4 +
 .../device-mapper/{snapshot.txt => snapshot.rst}   |  116 +-
 .../{statistics.txt => statistics.rst}             |   62 +-
 Documentation/device-mapper/striped.rst            |   61 +
 Documentation/device-mapper/striped.txt            |   57 -
 .../device-mapper/{switch.txt => switch.rst}       |   46 +-
 ...thin-provisioning.txt => thin-provisioning.rst} |   68 +-
 .../device-mapper/{unstriped.txt => unstriped.rst} |   93 +-
 .../device-mapper/{verity.txt => verity.rst}       |   20 +-
 .../{writecache.txt => writecache.rst}             |   13 +-
 Documentation/device-mapper/{zero.txt => zero.rst} |   13 +-
 Documentation/driver-api/index.rst                 |    3 +
 Documentation/{pps/pps.txt => driver-api/pps.rst}  |   67 +-
 Documentation/{ptp/ptp.txt => driver-api/ptp.rst}  |   17 +-
 .../driver => driver-api/serial/driver.rst}        |  113 +-
 Documentation/driver-api/serial/index.rst          |   30 +
 Documentation/driver-api/serial/moxa-smartio.rst   |  615 +++++
 Documentation/driver-api/serial/n_gsm.rst          |  103 +
 .../rocket.txt => driver-api/serial/rocket.rst}    |  132 +-
 .../serial/serial-iso7816.rst}                     |   21 +-
 .../serial/serial-rs485.rst}                       |   22 +-
 .../{serial/tty.txt => driver-api/serial/tty.rst}  |   93 +-
 .../{fault-injection.txt => fault-injection.rst}   |  281 ++-
 Documentation/fault-injection/index.rst            |   18 +
 ...-error-inject.txt => notifier-error-inject.rst} |   18 +-
 .../fault-injection/nvme-fault-injection.rst       |  120 +
 .../fault-injection/nvme-fault-injection.txt       |  116 -
 Documentation/fault-injection/provoke-crashes.rst  |   48 +
 Documentation/fault-injection/provoke-crashes.txt  |   38 -
 Documentation/fb/{api.txt => api.rst}              |   29 +-
 Documentation/fb/{arkfb.txt => arkfb.rst}          |    8 +-
 Documentation/fb/{aty128fb.txt => aty128fb.rst}    |   31 +-
 Documentation/fb/{cirrusfb.txt => cirrusfb.rst}    |   45 +-
 .../fb/{cmap_xfbdev.txt => cmap_xfbdev.rst}        |   56 +-
 .../fb/{deferred_io.txt => deferred_io.rst}        |   28 +-
 Documentation/fb/{efifb.txt => efifb.rst}          |   18 +-
 Documentation/fb/{ep93xx-fb.txt => ep93xx-fb.rst}  |   25 +-
 Documentation/fb/{fbcon.txt => fbcon.rst}          |  179 +-
 .../fb/{framebuffer.txt => framebuffer.rst}        |   79 +-
 Documentation/fb/{gxfb.txt => gxfb.rst}            |   22 +-
 Documentation/fb/index.rst                         |   48 +
 Documentation/fb/{intel810.txt => intel810.rst}    |   77 +-
 Documentation/fb/{intelfb.txt => intelfb.rst}      |   62 +-
 Documentation/fb/{internals.txt => internals.rst}  |   23 +-
 Documentation/fb/{lxfb.txt => lxfb.rst}            |   23 +-
 Documentation/fb/matroxfb.rst                      |  443 ++++
 Documentation/fb/matroxfb.txt                      |  413 ----
 .../fb/{metronomefb.txt => metronomefb.rst}        |    7 +-
 Documentation/fb/{modedb.txt => modedb.rst}        |   44 +-
 Documentation/fb/pvr2fb.rst                        |   66 +
 Documentation/fb/pvr2fb.txt                        |   65 -
 Documentation/fb/{pxafb.txt => pxafb.rst}          |   81 +-
 Documentation/fb/{s3fb.txt => s3fb.rst}            |    8 +-
 Documentation/fb/{sa1100fb.txt => sa1100fb.rst}    |   23 +-
 Documentation/fb/sh7760fb.rst                      |  130 +
 Documentation/fb/sh7760fb.txt                      |  131 -
 Documentation/fb/{sisfb.txt => sisfb.rst}          |   38 +-
 Documentation/fb/{sm501.txt => sm501.rst}          |    7 +-
 Documentation/fb/{sm712fb.txt => sm712fb.rst}      |   18 +-
 Documentation/fb/sstfb.rst                         |  207 ++
 Documentation/fb/sstfb.txt                         |  174 --
 Documentation/fb/{tgafb.txt => tgafb.rst}          |   30 +-
 Documentation/fb/{tridentfb.txt => tridentfb.rst}  |   34 +-
 Documentation/fb/{udlfb.txt => udlfb.rst}          |   55 +-
 Documentation/fb/{uvesafb.txt => uvesafb.rst}      |  141 +-
 Documentation/fb/{vesafb.txt => vesafb.rst}        |  143 +-
 Documentation/fb/viafb.rst                         |  297 +++
 Documentation/fb/viafb.txt                         |  252 --
 Documentation/fb/{vt8623fb.txt => vt8623fb.rst}    |   10 +-
 Documentation/fpga/{dfl.txt => dfl.rst}            |   58 +-
 Documentation/fpga/index.rst                       |   15 +
 Documentation/gpio/index.rst                       |   15 +
 Documentation/gpio/{sysfs.txt => sysfs.rst}        |   39 +-
 Documentation/ide/changelogs.rst                   |   18 +
 Documentation/ide/{ide-tape.txt => ide-tape.rst}   |   23 +-
 Documentation/ide/{ide.txt => ide.rst}             |  147 +-
 Documentation/ide/index.rst                        |   19 +
 .../{warm-plug-howto.txt => warm-plug-howto.rst}   |   10 +-
 Documentation/index.rst                            |   31 +
 .../{core_locking.txt => core_locking.rst}         |   64 +-
 Documentation/infiniband/index.rst                 |   21 +
 Documentation/infiniband/{ipoib.txt => ipoib.rst}  |   18 +-
 .../infiniband/{opa_vnic.txt => opa_vnic.rst}      |  110 +-
 Documentation/infiniband/{sysfs.txt => sysfs.rst}  |    4 +-
 .../{tag_matching.txt => tag_matching.rst}         |    5 +
 .../infiniband/{user_mad.txt => user_mad.rst}      |   33 +-
 .../infiniband/{user_verbs.txt => user_verbs.rst}  |   12 +-
 .../{headers_install.txt => headers_install.rst}   |    5 +-
 Documentation/kbuild/index.rst                     |   25 +
 Documentation/kbuild/issues.rst                    |   11 +
 Documentation/kbuild/{kbuild.txt => kbuild.rst}    |  119 +-
 .../{kconfig-language.txt => kconfig-language.rst} |  240 +-
 ...cro-language.txt => kconfig-macro-language.rst} |   37 +-
 Documentation/kbuild/{kconfig.txt => kconfig.rst}  |  136 +-
 .../kbuild/{makefiles.txt => makefiles.rst}        |  515 ++--
 Documentation/kbuild/{modules.txt => modules.rst}  |  167 +-
 Documentation/kdump/index.rst                      |   19 +
 Documentation/kdump/{kdump.txt => kdump.rst}       |  138 +-
 .../kdump/{vmcoreinfo.txt => vmcoreinfo.rst}       |   59 +-
 .../livepatch/{callbacks.txt => callbacks.rst}     |   12 +-
 ...mulative-patches.txt => cumulative-patches.rst} |   14 +-
 Documentation/livepatch/index.rst                  |   19 +
 .../livepatch/{livepatch.txt => livepatch.rst}     |   58 +-
 ...module-elf-format.txt => module-elf-format.rst} |  217 +-
 .../livepatch/{shadow-vars.txt => shadow-vars.rst} |   65 +-
 Documentation/locking/index.rst                    |   22 +
 .../{lockdep-design.txt => lockdep-design.rst}     |   41 +-
 Documentation/locking/lockstat.rst                 |  204 ++
 Documentation/locking/lockstat.txt                 |  183 --
 .../locking/{locktorture.txt => locktorture.rst}   |  105 +-
 .../locking/{mutex-design.txt => mutex-design.rst} |   26 +-
 .../{rt-mutex-design.txt => rt-mutex-design.rst}   |  135 +-
 .../locking/{rt-mutex.txt => rt-mutex.rst}         |   30 +-
 .../locking/{spinlocks.txt => spinlocks.rst}       |   32 +-
 .../{ww-mutex-design.txt => ww-mutex-design.rst}   |   82 +-
 Documentation/mic/index.rst                        |   16 +
 .../mic/{mic_overview.txt => mic_overview.rst}     |    6 +-
 .../mic/{scif_overview.txt => scif_overview.rst}   |   58 +-
 .../netlabel/{cipso_ipv4.txt => cipso_ipv4.rst}    |   19 +-
 Documentation/netlabel/draft_ietf.rst              |    5 +
 Documentation/netlabel/index.rst                   |   19 +
 .../{introduction.txt => introduction.rst}         |   16 +-
 .../{lsm_interface.txt => lsm_interface.rst}       |   16 +-
 .../pcmcia/{devicetable.txt => devicetable.rst}    |    4 +
 .../{driver-changes.txt => driver-changes.rst}     |   35 +-
 Documentation/pcmcia/{driver.txt => driver.rst}    |   18 +-
 Documentation/pcmcia/index.rst                     |   18 +
 Documentation/pcmcia/{locking.txt => locking.rst}  |   39 +-
 Documentation/power/{apm-acpi.txt => apm-acpi.rst} |   10 +-
 ...sic-pm-debugging.txt => basic-pm-debugging.rst} |   77 +-
 .../{charger-manager.txt => charger-manager.rst}   |  105 +-
 .../{drivers-testing.txt => drivers-testing.rst}   |    5 +
 .../power/{energy-model.txt => energy-model.rst}   |  105 +-
 ...freezing-of-tasks.txt => freezing-of-tasks.rst} |   91 +-
 Documentation/power/index.rst                      |   44 +
 .../power/{interface.txt => interface.rst}         |   20 +-
 Documentation/power/{opp.txt => opp.rst}           |  175 +-
 Documentation/power/{pci.txt => pci.rst}           |   77 +-
 .../{pm_qos_interface.txt => pm_qos_interface.rst} |  127 +-
 Documentation/power/power_supply_class.rst         |  282 +++
 Documentation/power/power_supply_class.txt         |  231 --
 Documentation/power/powercap/powercap.rst          |  257 ++
 Documentation/power/powercap/powercap.txt          |  236 --
 .../power/regulator/{consumer.txt => consumer.rst} |  141 +-
 .../power/regulator/{design.txt => design.rst}     |    9 +-
 .../power/regulator/{machine.txt => machine.rst}   |   47 +-
 .../power/regulator/{overview.txt => overview.rst} |   51 +-
 Documentation/power/regulator/regulator.rst        |   32 +
 Documentation/power/regulator/regulator.txt        |   30 -
 .../power/{runtime_pm.txt => runtime_pm.rst}       |  234 +-
 Documentation/power/{s2ram.txt => s2ram.rst}       |   20 +-
 ...d-cpuhotplug.txt => suspend-and-cpuhotplug.rst} |   42 +-
 ...d-interrupts.txt => suspend-and-interrupts.rst} |    2 +
 ...nd-swap-files.txt => swsusp-and-swap-files.rst} |   15 +-
 .../{swsusp-dmcrypt.txt => swsusp-dmcrypt.rst}     |  120 +-
 Documentation/power/swsusp.rst                     |  501 ++++
 Documentation/power/swsusp.txt                     |  446 ----
 Documentation/power/{tricks.txt => tricks.rst}     |    6 +-
 .../{userland-swsusp.txt => userland-swsusp.rst}   |   53 +-
 Documentation/power/{video.txt => video.rst}       |  156 +-
 .../powerpc/{DAWR-POWER9.txt => DAWR-POWER9.rst}   |    9 +-
 .../powerpc/{bootwrapper.txt => bootwrapper.rst}   |    6 +-
 .../powerpc/{cpu_families.txt => cpu_families.rst} |   23 +-
 .../powerpc/{cpu_features.txt => cpu_features.rst} |    6 +-
 Documentation/powerpc/{cxl.txt => cxl.rst}         |   46 +-
 .../powerpc/{cxlflash.txt => cxlflash.rst}         |    6 +-
 Documentation/powerpc/{dscr.txt => dscr.rst}       |   18 +-
 ...ror-recovery.txt => eeh-pci-error-recovery.rst} |   96 +-
 ...ssisted-dump.txt => firmware-assisted-dump.rst} |  117 +-
 Documentation/powerpc/{hvcs.txt => hvcs.rst}       |  108 +-
 Documentation/powerpc/index.rst                    |   32 +
 Documentation/powerpc/isa-versions.rst             |   13 +-
 Documentation/powerpc/{mpc52xx.txt => mpc52xx.rst} |   12 +-
 ...powernv.txt => pci_iov_resource_on_powernv.rst} |   15 +-
 Documentation/powerpc/{pmu-ebb.txt => pmu-ebb.rst} |    1 +
 Documentation/powerpc/ptrace.rst                   |  156 ++
 Documentation/powerpc/ptrace.txt                   |  151 --
 .../powerpc/{qe_firmware.txt => qe_firmware.rst}   |   37 +-
 .../{syscall64-abi.txt => syscall64-abi.rst}       |   29 +-
 ...ctional_memory.txt => transactional_memory.rst} |   45 +-
 Documentation/riscv/index.rst                      |   15 +
 Documentation/riscv/{pmu.txt => pmu.rst}           |   98 +-
 Documentation/s390/{3270.txt => 3270.rst}          |   85 +-
 Documentation/s390/Debugging390.rst                | 2613 ++++++++++++++++++++
 Documentation/s390/Debugging390.txt                | 2142 ----------------
 Documentation/s390/{cds.txt => cds.rst}            |  368 +--
 Documentation/s390/{CommonIO => common_io.rst}     |   47 +-
 Documentation/s390/{DASD => dasd.rst}              |   33 +-
 .../s390/{driver-model.txt => driver-model.rst}    |  177 +-
 Documentation/s390/index.rst                       |   28 +
 .../s390/{monreader.txt => monreader.rst}          |   84 +-
 Documentation/s390/{qeth.txt => qeth.rst}          |   36 +-
 Documentation/s390/s390dbf.rst                     |  474 ++++
 Documentation/s390/s390dbf.txt                     |  667 -----
 Documentation/s390/text_files.rst                  |   11 +
 Documentation/s390/{vfio-ap.txt => vfio-ap.rst}    |  499 ++--
 Documentation/s390/{vfio-ccw.txt => vfio-ccw.rst}  |   90 +-
 Documentation/s390/{zfcpdump.txt => zfcpdump.rst}  |    2 +
 Documentation/serial/README.cycladesZ              |    8 -
 Documentation/serial/moxa-smartio                  |  523 ----
 Documentation/serial/n_gsm.txt                     |   96 -
 Documentation/target/index.rst                     |   17 +
 Documentation/target/scripts.rst                   |   11 +
 Documentation/target/tcm_mod_builder.rst           |  149 ++
 Documentation/target/tcm_mod_builder.txt           |  145 --
 .../target/{tcmu-design.txt => tcmu-design.rst}    |  274 +-
 Documentation/timers/{highres.txt => highres.rst}  |    8 +-
 Documentation/timers/{hpet.txt => hpet.rst}        |    4 +-
 .../timers/{hrtimers.txt => hrtimers.rst}          |    4 +-
 Documentation/timers/index.rst                     |   20 +
 Documentation/timers/{NO_HZ.txt => no_hz.rst}      |   40 +-
 .../timers/{timekeeping.txt => timekeeping.rst}    |    3 +-
 .../timers/{timers-howto.txt => timers-howto.rst}  |   15 +-
 Documentation/usb/acm.rst                          |  132 +
 Documentation/usb/acm.txt                          |  128 -
 .../usb/{authorization.txt => authorization.rst}   |   75 +-
 Documentation/usb/{chipidea.txt => chipidea.rst}   |  102 +-
 Documentation/usb/{dwc3.txt => dwc3.rst}           |   12 +-
 Documentation/usb/{ehci.txt => ehci.rst}           |   42 +-
 .../usb/{functionfs.txt => functionfs.rst}         |   16 +-
 .../usb/{gadget-testing.txt => gadget-testing.rst} |  611 +++--
 .../{gadget_configfs.txt => gadget_configfs.rst}   |  306 +--
 .../usb/{gadget_hid.txt => gadget_hid.rst}         |  175 +-
 .../usb/{gadget_multi.txt => gadget_multi.rst}     |   43 +-
 .../usb/{gadget_printer.txt => gadget_printer.rst} |  155 +-
 .../usb/{gadget_serial.txt => gadget_serial.rst}   |   75 +-
 Documentation/usb/index.rst                        |   39 +
 .../usb/{iuu_phoenix.txt => iuu_phoenix.rst}       |   32 +-
 .../usb/{mass-storage.txt => mass-storage.rst}     |   19 +-
 .../usb/{misc_usbsevseg.txt => misc_usbsevseg.rst} |    7 +
 Documentation/usb/{mtouchusb.txt => mtouchusb.rst} |   34 +-
 Documentation/usb/{ohci.txt => ohci.rst}           |    4 +
 Documentation/usb/{rio.txt => rio.rst}             |   54 +-
 Documentation/usb/text_files.rst                   |   29 +
 Documentation/usb/usb-help.rst                     |   17 +
 Documentation/usb/usb-help.txt                     |   16 -
 .../usb/{usb-serial.txt => usb-serial.rst}         |  165 +-
 Documentation/usb/usbip_protocol.rst               |  411 +++
 Documentation/usb/usbip_protocol.txt               |  357 ---
 Documentation/usb/{usbmon.txt => usbmon.rst}       |  100 +-
 ...esign-overview.txt => wusb-design-overview.rst} |   55 +-
 ...l_api.txt => convert_drivers_to_kernel_api.rst} |  108 +-
 Documentation/watchdog/{hpwdt.txt => hpwdt.rst}    |   29 +-
 Documentation/watchdog/index.rst                   |   23 +
 .../watchdog/{mlx-wdt.txt => mlx-wdt.rst}          |   24 +-
 .../{pcwd-watchdog.txt => pcwd-watchdog.rst}       |   12 +-
 .../{watchdog-api.txt => watchdog-api.rst}         |   75 +-
 ...hdog-kernel-api.txt => watchdog-kernel-api.rst} |   89 +-
 Documentation/watchdog/watchdog-parameters.rst     |  736 ++++++
 Documentation/watchdog/watchdog-parameters.txt     |  410 ---
 .../watchdog/{watchdog-pm.txt => watchdog-pm.rst}  |    3 +
 Documentation/watchdog/{wdt.txt => wdt.rst}        |   31 +-
 ...ry-encryption.txt => amd-memory-encryption.rst} |   10 +-
 Documentation/x86/{boot.txt => boot.rst}           |  588 ++---
 .../x86/{earlyprintk.txt => earlyprintk.rst}       |   77 +-
 Documentation/x86/{entry_64.txt => entry_64.rst}   |   11 +-
 .../{exception-tables.txt => exception-tables.rst} |  247 +-
 .../x86/i386/{IO-APIC.txt => IO-APIC.rst}          |   22 +-
 Documentation/x86/index.rst                        |   40 +
 Documentation/x86/{intel_mpx.txt => intel_mpx.rst} |   57 +-
 Documentation/x86/{microcode.txt => microcode.rst} |   51 +-
 Documentation/x86/mtrr.rst                         |  351 +++
 Documentation/x86/mtrr.txt                         |  329 ---
 .../x86/{orc-unwinder.txt => orc-unwinder.rst}     |    1 +
 Documentation/x86/pat.rst                          |  231 ++
 Documentation/x86/pat.txt                          |  230 --
 .../{protection-keys.txt => protection-keys.rst}   |   33 +-
 Documentation/x86/{pti.txt => pti.rst}             |    8 +-
 .../x86/{resctrl_ui.txt => resctrl_ui.rst}         |  643 ++---
 Documentation/x86/{tlb.txt => tlb.rst}             |   12 +-
 Documentation/x86/{topology.txt => topology.rst}   |   26 +-
 ...b-legacy-support.txt => usb-legacy-support.rst} |   38 +-
 .../{5level-paging.txt => 5level-paging.rst}       |   13 +-
 .../x86_64/{boot-options.txt => boot-options.rst}  |   98 +-
 Documentation/x86/x86_64/mm.rst                    |  185 ++
 Documentation/x86/x86_64/mm.txt                    |  153 --
 Documentation/x86/x86_64/{uefi.txt => uefi.rst}    |   21 +-
 Documentation/x86/zero-page.rst                    |   47 +
 Documentation/x86/zero-page.txt                    |   40 -
 Documentation/xilinx/{eemi.txt => eemi.rst}        |    8 +-
 Documentation/xilinx/index.rst                     |   15 +
 arch/s390/include/asm/debug.h                      |  231 ++
 379 files changed, 22705 insertions(+), 17379 deletions(-)
 rename Documentation/PCI/{MSI-HOWTO.txt => MSI-HOWTO.rst} (90%)
 rename Documentation/PCI/{PCIEBUS-HOWTO.txt => PCIEBUS-HOWTO.rst} (85%)
 rename Documentation/PCI/{acpi-info.txt => acpi-info.rst} (97%)
 create mode 100644 Documentation/PCI/endpoint/function/binding/pci-test.rst
 delete mode 100644 Documentation/PCI/endpoint/function/binding/pci-test.txt
 rename Documentation/PCI/endpoint/{pci-endpoint-cfs.txt => pci-endpoint-cfs.rst} (81%)
 rename Documentation/PCI/endpoint/{pci-endpoint.txt => pci-endpoint.rst} (80%)
 rename Documentation/PCI/endpoint/{pci-test-function.txt => pci-test-function.rst} (59%)
 rename Documentation/PCI/endpoint/{pci-test-howto.txt => pci-test-howto.rst} (83%)
 create mode 100644 Documentation/PCI/index.rst
 rename Documentation/PCI/{pci-error-recovery.txt => pci-error-recovery.rst} (77%)
 rename Documentation/PCI/{pci-iov-howto.txt => pci-iov-howto.rst} (74%)
 rename Documentation/PCI/{pci.txt => pci.rst} (83%)
 rename Documentation/PCI/{pcieaer-howto.txt => pcieaer-howto.rst} (77%)
 rename Documentation/acpi/{DSD-properties-rules.txt => DSD-properties-rules.rst} (98%)
 rename Documentation/acpi/{acpi-lid.txt => acpi-lid.rst} (85%)
 rename Documentation/acpi/{aml-debugger.txt => aml-debugger.rst} (77%)
 rename Documentation/acpi/apei/{einj.txt => einj.rst} (77%)
 create mode 100644 Documentation/acpi/apei/output_format.rst
 delete mode 100644 Documentation/acpi/apei/output_format.txt
 rename Documentation/acpi/{cppc_sysfs.txt => cppc_sysfs.rst} (59%)
 rename Documentation/acpi/{debug.txt => debug.rst} (93%)
 rename Documentation/{extcon/intel-int3496.txt => acpi/drivers/extcon-intel-int3496.rst} (66%)
 rename Documentation/acpi/dsd/{data-node-references.txt => data-node-references.rst} (91%)
 rename Documentation/acpi/dsd/{graph.txt => graph.rst} (88%)
 rename Documentation/acpi/{dsdt-override.txt => dsdt-override.rst} (55%)
 rename Documentation/acpi/{enumeration.txt => enumeration.rst} (95%)
 rename Documentation/acpi/{gpio-properties.txt => gpio-properties.rst} (91%)
 rename Documentation/acpi/{i2c-muxes.txt => i2c-muxes.rst} (82%)
 create mode 100644 Documentation/acpi/index.rst
 rename Documentation/acpi/{initrd_table_override.txt => initrd_table_override.rst} (53%)
 rename Documentation/acpi/{linuxized-acpica.txt => linuxized-acpica.rst} (92%)
 rename Documentation/acpi/{lpit.txt => lpit.rst} (92%)
 rename Documentation/acpi/{method-customizing.txt => method-customizing.rst} (72%)
 rename Documentation/acpi/{method-tracing.txt => method-tracing.rst} (74%)
 rename Documentation/acpi/{namespace.txt => namespace.rst} (65%)
 rename Documentation/acpi/{osi.txt => osi.rst} (99%)
 rename Documentation/acpi/{scan_handlers.txt => scan_handlers.rst} (98%)
 rename Documentation/acpi/{ssdt-overlays.txt => ssdt-overlays.rst} (62%)
 rename Documentation/acpi/{video_extension.txt => video_extension.rst} (95%)
 rename Documentation/aoe/{aoe.txt => aoe.rst} (79%)
 create mode 100644 Documentation/aoe/examples.rst
 create mode 100644 Documentation/aoe/index.rst
 rename Documentation/aoe/{todo.txt => todo.rst} (98%)
 rename Documentation/arm64/{acpi_object_usage.txt => acpi_object_usage.rst} (84%)
 rename Documentation/arm64/{arm-acpi.txt => arm-acpi.rst} (87%)
 rename Documentation/arm64/{booting.txt => booting.rst} (86%)
 rename Documentation/arm64/{cpu-feature-registers.txt => cpu-feature-registers.rst} (66%)
 rename Documentation/arm64/{elf_hwcaps.txt => elf_hwcaps.rst} (95%)
 rename Documentation/arm64/{hugetlbpage.txt => hugetlbpage.rst} (86%)
 create mode 100644 Documentation/arm64/index.rst
 rename Documentation/arm64/{legacy_instructions.txt => legacy_instructions.rst} (73%)
 create mode 100644 Documentation/arm64/memory.rst
 delete mode 100644 Documentation/arm64/memory.txt
 rename Documentation/arm64/{pointer-authentication.txt => pointer-authentication.rst} (98%)
 rename Documentation/arm64/{silicon-errata.txt => silicon-errata.rst} (55%)
 rename Documentation/arm64/{sve.txt => sve.rst} (98%)
 rename Documentation/arm64/{tagged-pointers.txt => tagged-pointers.rst} (94%)
 delete mode 100644 Documentation/cdrom/Makefile
 create mode 100644 Documentation/cdrom/cdrom-standard.rst
 delete mode 100644 Documentation/cdrom/cdrom-standard.tex
 rename Documentation/cdrom/{ide-cd => ide-cd.rst} (87%)
 create mode 100644 Documentation/cdrom/index.rst
 rename Documentation/cdrom/{packet-writing.txt => packet-writing.rst} (91%)
 rename Documentation/cgroup-v1/{cgroups.txt => cgroups.rst} (89%)
 create mode 100644 Documentation/cgroup-v1/index.rst
 create mode 100644 Documentation/cgroup-v1/text_files.rst
 rename Documentation/cpu-freq/{amd-powernow.txt => amd-powernow.rst} (94%)
 rename Documentation/cpu-freq/{core.txt => core.rst} (67%)
 rename Documentation/cpu-freq/{cpu-drivers.txt => cpu-drivers.rst} (57%)
 rename Documentation/cpu-freq/{cpufreq-nforce2.txt => cpufreq-nforce2.rst} (66%)
 create mode 100644 Documentation/cpu-freq/cpufreq-stats.rst
 delete mode 100644 Documentation/cpu-freq/cpufreq-stats.txt
 create mode 100644 Documentation/cpu-freq/index.rst
 delete mode 100644 Documentation/cpu-freq/index.txt
 rename Documentation/cpu-freq/{pcc-cpufreq.txt => pcc-cpufreq.rst} (80%)
 rename Documentation/device-mapper/{cache-policies.txt => cache-policies.rst} (94%)
 rename Documentation/device-mapper/{cache.txt => cache.rst} (61%)
 rename Documentation/device-mapper/{delay.txt => delay.rst} (53%)
 rename Documentation/device-mapper/{dm-crypt.txt => dm-crypt.rst} (87%)
 rename Documentation/device-mapper/{dm-flakey.txt => dm-flakey.rst} (60%)
 rename Documentation/device-mapper/{dm-init.txt => dm-init.rst} (68%)
 rename Documentation/device-mapper/{dm-integrity.txt => dm-integrity.rst} (90%)
 rename Documentation/device-mapper/{dm-io.txt => dm-io.rst} (92%)
 rename Documentation/device-mapper/{dm-log.txt => dm-log.rst} (90%)
 rename Documentation/device-mapper/{dm-queue-length.txt => dm-queue-length.rst} (76%)
 rename Documentation/device-mapper/{dm-raid.txt => dm-raid.rst} (71%)
 rename Documentation/device-mapper/{dm-service-time.txt => dm-service-time.rst} (60%)
 create mode 100644 Documentation/device-mapper/dm-uevent.rst
 delete mode 100644 Documentation/device-mapper/dm-uevent.txt
 rename Documentation/device-mapper/{dm-zoned.txt => dm-zoned.rst} (97%)
 rename Documentation/device-mapper/{era.txt => era.rst} (70%)
 create mode 100644 Documentation/device-mapper/index.rst
 rename Documentation/device-mapper/{kcopyd.txt => kcopyd.rst} (93%)
 create mode 100644 Documentation/device-mapper/linear.rst
 delete mode 100644 Documentation/device-mapper/linear.txt
 rename Documentation/device-mapper/{log-writes.txt => log-writes.rst} (61%)
 rename Documentation/device-mapper/{persistent-data.txt => persistent-data.rst} (98%)
 rename Documentation/device-mapper/{snapshot.txt => snapshot.rst} (62%)
 rename Documentation/device-mapper/{statistics.txt => statistics.rst} (87%)
 create mode 100644 Documentation/device-mapper/striped.rst
 delete mode 100644 Documentation/device-mapper/striped.txt
 rename Documentation/device-mapper/{switch.txt => switch.rst} (84%)
 rename Documentation/device-mapper/{thin-provisioning.txt => thin-provisioning.rst} (92%)
 rename Documentation/device-mapper/{unstriped.txt => unstriped.rst} (60%)
 rename Documentation/device-mapper/{verity.txt => verity.rst} (98%)
 rename Documentation/device-mapper/{writecache.txt => writecache.rst} (96%)
 rename Documentation/device-mapper/{zero.txt => zero.rst} (83%)
 rename Documentation/{pps/pps.txt => driver-api/pps.rst} (90%)
 rename Documentation/{ptp/ptp.txt => driver-api/ptp.rst} (90%)
 rename Documentation/{serial/driver => driver-api/serial/driver.rst} (92%)
 create mode 100644 Documentation/driver-api/serial/index.rst
 create mode 100644 Documentation/driver-api/serial/moxa-smartio.rst
 create mode 100644 Documentation/driver-api/serial/n_gsm.rst
 rename Documentation/{serial/rocket.txt => driver-api/serial/rocket.rst} (70%)
 rename Documentation/{serial/serial-iso7816.txt => driver-api/serial/serial-iso7816.rst} (85%)
 rename Documentation/{serial/serial-rs485.txt => driver-api/serial/serial-rs485.rst} (89%)
 rename Documentation/{serial/tty.txt => driver-api/serial/tty.rst} (76%)
 rename Documentation/fault-injection/{fault-injection.txt => fault-injection.rst} (68%)
 create mode 100644 Documentation/fault-injection/index.rst
 rename Documentation/fault-injection/{notifier-error-inject.txt => notifier-error-inject.rst} (83%)
 create mode 100644 Documentation/fault-injection/nvme-fault-injection.rst
 delete mode 100644 Documentation/fault-injection/nvme-fault-injection.txt
 create mode 100644 Documentation/fault-injection/provoke-crashes.rst
 delete mode 100644 Documentation/fault-injection/provoke-crashes.txt
 rename Documentation/fb/{api.txt => api.rst} (97%)
 rename Documentation/fb/{arkfb.txt => arkfb.rst} (92%)
 rename Documentation/fb/{aty128fb.txt => aty128fb.rst} (66%)
 rename Documentation/fb/{cirrusfb.txt => cirrusfb.rst} (75%)
 rename Documentation/fb/{cmap_xfbdev.txt => cmap_xfbdev.rst} (50%)
 rename Documentation/fb/{deferred_io.txt => deferred_io.rst} (86%)
 rename Documentation/fb/{efifb.txt => efifb.rst} (75%)
 rename Documentation/fb/{ep93xx-fb.txt => ep93xx-fb.rst} (86%)
 rename Documentation/fb/{fbcon.txt => fbcon.rst} (69%)
 rename Documentation/fb/{framebuffer.txt => framebuffer.rst} (92%)
 rename Documentation/fb/{gxfb.txt => gxfb.rst} (65%)
 create mode 100644 Documentation/fb/index.rst
 rename Documentation/fb/{intel810.txt => intel810.rst} (83%)
 rename Documentation/fb/{intelfb.txt => intelfb.rst} (73%)
 rename Documentation/fb/{internals.txt => internals.rst} (82%)
 rename Documentation/fb/{lxfb.txt => lxfb.rst} (65%)
 create mode 100644 Documentation/fb/matroxfb.rst
 delete mode 100644 Documentation/fb/matroxfb.txt
 rename Documentation/fb/{metronomefb.txt => metronomefb.rst} (98%)
 rename Documentation/fb/{modedb.txt => modedb.rst} (87%)
 create mode 100644 Documentation/fb/pvr2fb.rst
 delete mode 100644 Documentation/fb/pvr2fb.txt
 rename Documentation/fb/{pxafb.txt => pxafb.rst} (78%)
 rename Documentation/fb/{s3fb.txt => s3fb.rst} (94%)
 rename Documentation/fb/{sa1100fb.txt => sa1100fb.rst} (64%)
 create mode 100644 Documentation/fb/sh7760fb.rst
 delete mode 100644 Documentation/fb/sh7760fb.txt
 rename Documentation/fb/{sisfb.txt => sisfb.rst} (85%)
 rename Documentation/fb/{sm501.txt => sm501.rst} (65%)
 rename Documentation/fb/{sm712fb.txt => sm712fb.rst} (59%)
 create mode 100644 Documentation/fb/sstfb.rst
 delete mode 100644 Documentation/fb/sstfb.txt
 rename Documentation/fb/{tgafb.txt => tgafb.rst} (71%)
 rename Documentation/fb/{tridentfb.txt => tridentfb.rst} (71%)
 rename Documentation/fb/{udlfb.txt => udlfb.rst} (77%)
 rename Documentation/fb/{uvesafb.txt => uvesafb.rst} (52%)
 rename Documentation/fb/{vesafb.txt => vesafb.rst} (53%)
 create mode 100644 Documentation/fb/viafb.rst
 delete mode 100644 Documentation/fb/viafb.txt
 rename Documentation/fb/{vt8623fb.txt => vt8623fb.rst} (85%)
 rename Documentation/fpga/{dfl.txt => dfl.rst} (89%)
 create mode 100644 Documentation/fpga/index.rst
 create mode 100644 Documentation/gpio/index.rst
 rename Documentation/gpio/{sysfs.txt => sysfs.rst} (86%)
 create mode 100644 Documentation/ide/changelogs.rst
 rename Documentation/ide/{ide-tape.txt => ide-tape.rst} (83%)
 rename Documentation/ide/{ide.txt => ide.rst} (72%)
 create mode 100644 Documentation/ide/index.rst
 rename Documentation/ide/{warm-plug-howto.txt => warm-plug-howto.rst} (61%)
 rename Documentation/infiniband/{core_locking.txt => core_locking.rst} (78%)
 create mode 100644 Documentation/infiniband/index.rst
 rename Documentation/infiniband/{ipoib.txt => ipoib.rst} (93%)
 rename Documentation/infiniband/{opa_vnic.txt => opa_vnic.rst} (63%)
 rename Documentation/infiniband/{sysfs.txt => sysfs.rst} (69%)
 rename Documentation/infiniband/{tag_matching.txt => tag_matching.rst} (98%)
 rename Documentation/infiniband/{user_mad.txt => user_mad.rst} (90%)
 rename Documentation/infiniband/{user_verbs.txt => user_verbs.rst} (93%)
 rename Documentation/kbuild/{headers_install.txt => headers_install.rst} (96%)
 create mode 100644 Documentation/kbuild/index.rst
 create mode 100644 Documentation/kbuild/issues.rst
 rename Documentation/kbuild/{kbuild.txt => kbuild.rst} (72%)
 rename Documentation/kbuild/{kconfig-language.txt => kconfig-language.rst} (85%)
 rename Documentation/kbuild/{kconfig-macro-language.txt => kconfig-macro-language.rst} (94%)
 rename Documentation/kbuild/{kconfig.txt => kconfig.rst} (80%)
 rename Documentation/kbuild/{makefiles.txt => makefiles.rst} (84%)
 rename Documentation/kbuild/{modules.txt => modules.rst} (85%)
 create mode 100644 Documentation/kdump/index.rst
 rename Documentation/kdump/{kdump.txt => kdump.rst} (90%)
 rename Documentation/kdump/{vmcoreinfo.txt => vmcoreinfo.rst} (95%)
 rename Documentation/livepatch/{callbacks.txt => callbacks.rst} (94%)
 rename Documentation/livepatch/{cumulative-patches.txt => cumulative-patches.rst} (89%)
 create mode 100644 Documentation/livepatch/index.rst
 rename Documentation/livepatch/{livepatch.txt => livepatch.rst} (94%)
 rename Documentation/livepatch/{module-elf-format.txt => module-elf-format.rst} (68%)
 rename Documentation/livepatch/{shadow-vars.txt => shadow-vars.rst} (87%)
 create mode 100644 Documentation/locking/index.rst
 rename Documentation/locking/{lockdep-design.txt => lockdep-design.rst} (93%)
 create mode 100644 Documentation/locking/lockstat.rst
 delete mode 100644 Documentation/locking/lockstat.txt
 rename Documentation/locking/{locktorture.txt => locktorture.rst} (57%)
 rename Documentation/locking/{mutex-design.txt => mutex-design.rst} (94%)
 rename Documentation/locking/{rt-mutex-design.txt => rt-mutex-design.rst} (91%)
 rename Documentation/locking/{rt-mutex.txt => rt-mutex.rst} (71%)
 rename Documentation/locking/{spinlocks.txt => spinlocks.rst} (89%)
 rename Documentation/locking/{ww-mutex-design.txt => ww-mutex-design.rst} (93%)
 create mode 100644 Documentation/mic/index.rst
 rename Documentation/mic/{mic_overview.txt => mic_overview.rst} (96%)
 rename Documentation/mic/{scif_overview.txt => scif_overview.rst} (76%)
 rename Documentation/netlabel/{cipso_ipv4.txt => cipso_ipv4.rst} (87%)
 create mode 100644 Documentation/netlabel/draft_ietf.rst
 create mode 100644 Documentation/netlabel/index.rst
 rename Documentation/netlabel/{introduction.txt => introduction.rst} (91%)
 rename Documentation/netlabel/{lsm_interface.txt => lsm_interface.rst} (88%)
 rename Documentation/pcmcia/{devicetable.txt => devicetable.rst} (97%)
 rename Documentation/pcmcia/{driver-changes.txt => driver-changes.rst} (90%)
 rename Documentation/pcmcia/{driver.txt => driver.rst} (66%)
 create mode 100644 Documentation/pcmcia/index.rst
 rename Documentation/pcmcia/{locking.txt => locking.rst} (81%)
 rename Documentation/power/{apm-acpi.txt => apm-acpi.rst} (87%)
 rename Documentation/power/{basic-pm-debugging.txt => basic-pm-debugging.rst} (87%)
 rename Documentation/power/{charger-manager.txt => charger-manager.rst} (78%)
 rename Documentation/power/{drivers-testing.txt => drivers-testing.rst} (93%)
 rename Documentation/power/{energy-model.txt => energy-model.rst} (74%)
 rename Documentation/power/{freezing-of-tasks.txt => freezing-of-tasks.rst} (75%)
 create mode 100644 Documentation/power/index.rst
 rename Documentation/power/{interface.txt => interface.rst} (87%)
 rename Documentation/power/{opp.txt => opp.rst} (78%)
 rename Documentation/power/{pci.txt => pci.rst} (97%)
 rename Documentation/power/{pm_qos_interface.txt => pm_qos_interface.rst} (62%)
 create mode 100644 Documentation/power/power_supply_class.rst
 delete mode 100644 Documentation/power/power_supply_class.txt
 create mode 100644 Documentation/power/powercap/powercap.rst
 delete mode 100644 Documentation/power/powercap/powercap.txt
 rename Documentation/power/regulator/{consumer.txt => consumer.rst} (61%)
 rename Documentation/power/regulator/{design.txt => design.rst} (86%)
 rename Documentation/power/regulator/{machine.txt => machine.rst} (75%)
 rename Documentation/power/regulator/{overview.txt => overview.rst} (81%)
 create mode 100644 Documentation/power/regulator/regulator.rst
 delete mode 100644 Documentation/power/regulator/regulator.txt
 rename Documentation/power/{runtime_pm.txt => runtime_pm.rst} (89%)
 rename Documentation/power/{s2ram.txt => s2ram.rst} (92%)
 rename Documentation/power/{suspend-and-cpuhotplug.txt => suspend-and-cpuhotplug.rst} (90%)
 rename Documentation/power/{suspend-and-interrupts.txt => suspend-and-interrupts.rst} (98%)
 rename Documentation/power/{swsusp-and-swap-files.txt => swsusp-and-swap-files.rst} (85%)
 rename Documentation/power/{swsusp-dmcrypt.txt => swsusp-dmcrypt.rst} (68%)
 create mode 100644 Documentation/power/swsusp.rst
 delete mode 100644 Documentation/power/swsusp.txt
 rename Documentation/power/{tricks.txt => tricks.rst} (93%)
 rename Documentation/power/{userland-swsusp.txt => userland-swsusp.rst} (86%)
 rename Documentation/power/{video.txt => video.rst} (56%)
 rename Documentation/powerpc/{DAWR-POWER9.txt => DAWR-POWER9.rst} (95%)
 rename Documentation/powerpc/{bootwrapper.txt => bootwrapper.rst} (97%)
 rename Documentation/powerpc/{cpu_families.txt => cpu_families.rst} (95%)
 rename Documentation/powerpc/{cpu_features.txt => cpu_features.rst} (97%)
 rename Documentation/powerpc/{cxl.txt => cxl.rst} (95%)
 rename Documentation/powerpc/{cxlflash.txt => cxlflash.rst} (99%)
 rename Documentation/powerpc/{dscr.txt => dscr.rst} (91%)
 rename Documentation/powerpc/{eeh-pci-error-recovery.txt => eeh-pci-error-recovery.rst} (83%)
 rename Documentation/powerpc/{firmware-assisted-dump.txt => firmware-assisted-dump.rst} (80%)
 rename Documentation/powerpc/{hvcs.txt => hvcs.rst} (91%)
 create mode 100644 Documentation/powerpc/index.rst
 rename Documentation/powerpc/{mpc52xx.txt => mpc52xx.rst} (91%)
 rename Documentation/powerpc/{pci_iov_resource_on_powernv.txt => pci_iov_resource_on_powernv.rst} (97%)
 rename Documentation/powerpc/{pmu-ebb.txt => pmu-ebb.rst} (99%)
 create mode 100644 Documentation/powerpc/ptrace.rst
 delete mode 100644 Documentation/powerpc/ptrace.txt
 rename Documentation/powerpc/{qe_firmware.txt => qe_firmware.rst} (95%)
 rename Documentation/powerpc/{syscall64-abi.txt => syscall64-abi.rst} (82%)
 rename Documentation/powerpc/{transactional_memory.txt => transactional_memory.rst} (93%)
 create mode 100644 Documentation/riscv/index.rst
 rename Documentation/riscv/{pmu.txt => pmu.rst} (77%)
 rename Documentation/s390/{3270.txt => 3270.rst} (90%)
 create mode 100644 Documentation/s390/Debugging390.rst
 delete mode 100644 Documentation/s390/Debugging390.txt
 rename Documentation/s390/{cds.txt => cds.rst} (64%)
 rename Documentation/s390/{CommonIO => common_io.rst} (88%)
 rename Documentation/s390/{DASD => dasd.rst} (92%)
 rename Documentation/s390/{driver-model.txt => driver-model.rst} (73%)
 create mode 100644 Documentation/s390/index.rst
 rename Documentation/s390/{monreader.txt => monreader.rst} (81%)
 rename Documentation/s390/{qeth.txt => qeth.rst} (62%)
 create mode 100644 Documentation/s390/s390dbf.rst
 delete mode 100644 Documentation/s390/s390dbf.txt
 create mode 100644 Documentation/s390/text_files.rst
 rename Documentation/s390/{vfio-ap.txt => vfio-ap.rst} (72%)
 rename Documentation/s390/{vfio-ccw.txt => vfio-ccw.rst} (89%)
 rename Documentation/s390/{zfcpdump.txt => zfcpdump.rst} (97%)
 delete mode 100644 Documentation/serial/README.cycladesZ
 delete mode 100644 Documentation/serial/moxa-smartio
 delete mode 100644 Documentation/serial/n_gsm.txt
 create mode 100644 Documentation/target/index.rst
 create mode 100644 Documentation/target/scripts.rst
 create mode 100644 Documentation/target/tcm_mod_builder.rst
 delete mode 100644 Documentation/target/tcm_mod_builder.txt
 rename Documentation/target/{tcmu-design.txt => tcmu-design.rst} (69%)
 rename Documentation/timers/{highres.txt => highres.rst} (98%)
 rename Documentation/timers/{hpet.txt => hpet.rst} (91%)
 rename Documentation/timers/{hrtimers.txt => hrtimers.rst} (98%)
 create mode 100644 Documentation/timers/index.rst
 rename Documentation/timers/{NO_HZ.txt => no_hz.rst} (93%)
 rename Documentation/timers/{timekeeping.txt => timekeeping.rst} (98%)
 rename Documentation/timers/{timers-howto.txt => timers-howto.rst} (93%)
 create mode 100644 Documentation/usb/acm.rst
 delete mode 100644 Documentation/usb/acm.txt
 rename Documentation/usb/{authorization.txt => authorization.rst} (67%)
 rename Documentation/usb/{chipidea.txt => chipidea.rst} (56%)
 rename Documentation/usb/{dwc3.txt => dwc3.rst} (97%)
 rename Documentation/usb/{ehci.txt => ehci.rst} (92%)
 rename Documentation/usb/{functionfs.txt => functionfs.rst} (87%)
 rename Documentation/usb/{gadget-testing.txt => gadget-testing.rst} (56%)
 rename Documentation/usb/{gadget_configfs.txt => gadget_configfs.rst} (62%)
 rename Documentation/usb/{gadget_hid.txt => gadget_hid.rst} (74%)
 rename Documentation/usb/{gadget_multi.txt => gadget_multi.rst} (90%)
 rename Documentation/usb/{gadget_printer.txt => gadget_printer.rst} (82%)
 rename Documentation/usb/{gadget_serial.txt => gadget_serial.rst} (86%)
 create mode 100644 Documentation/usb/index.rst
 rename Documentation/usb/{iuu_phoenix.txt => iuu_phoenix.rst} (82%)
 rename Documentation/usb/{mass-storage.txt => mass-storage.rst} (96%)
 rename Documentation/usb/{misc_usbsevseg.txt => misc_usbsevseg.rst} (95%)
 rename Documentation/usb/{mtouchusb.txt => mtouchusb.rst} (83%)
 rename Documentation/usb/{ohci.txt => ohci.rst} (98%)
 rename Documentation/usb/{rio.txt => rio.rst} (86%)
 create mode 100644 Documentation/usb/text_files.rst
 create mode 100644 Documentation/usb/usb-help.rst
 delete mode 100644 Documentation/usb/usb-help.txt
 rename Documentation/usb/{usb-serial.txt => usb-serial.rst} (85%)
 create mode 100644 Documentation/usb/usbip_protocol.rst
 delete mode 100644 Documentation/usb/usbip_protocol.txt
 rename Documentation/usb/{usbmon.txt => usbmon.rst} (89%)
 rename Documentation/usb/{WUSB-Design-overview.txt => wusb-design-overview.rst} (93%)
 rename Documentation/watchdog/{convert_drivers_to_kernel_api.txt => convert_drivers_to_kernel_api.rst} (75%)
 rename Documentation/watchdog/{hpwdt.txt => hpwdt.rst} (76%)
 create mode 100644 Documentation/watchdog/index.rst
 rename Documentation/watchdog/{mlx-wdt.txt => mlx-wdt.rst} (78%)
 rename Documentation/watchdog/{pcwd-watchdog.txt => pcwd-watchdog.rst} (89%)
 rename Documentation/watchdog/{watchdog-api.txt => watchdog-api.rst} (80%)
 rename Documentation/watchdog/{watchdog-kernel-api.txt => watchdog-kernel-api.rst} (90%)
 create mode 100644 Documentation/watchdog/watchdog-parameters.rst
 delete mode 100644 Documentation/watchdog/watchdog-parameters.txt
 rename Documentation/watchdog/{watchdog-pm.txt => watchdog-pm.rst} (92%)
 rename Documentation/watchdog/{wdt.txt => wdt.rst} (68%)
 rename Documentation/x86/{amd-memory-encryption.txt => amd-memory-encryption.rst} (95%)
 rename Documentation/x86/{boot.txt => boot.rst} (74%)
 rename Documentation/x86/{earlyprintk.txt => earlyprintk.rst} (68%)
 rename Documentation/x86/{entry_64.txt => entry_64.rst} (96%)
 rename Documentation/x86/{exception-tables.txt => exception-tables.rst} (66%)
 rename Documentation/x86/i386/{IO-APIC.txt => IO-APIC.rst} (94%)
 create mode 100644 Documentation/x86/index.rst
 rename Documentation/x86/{intel_mpx.txt => intel_mpx.rst} (91%)
 rename Documentation/x86/{microcode.txt => microcode.rst} (84%)
 create mode 100644 Documentation/x86/mtrr.rst
 delete mode 100644 Documentation/x86/mtrr.txt
 rename Documentation/x86/{orc-unwinder.txt => orc-unwinder.rst} (99%)
 create mode 100644 Documentation/x86/pat.rst
 delete mode 100644 Documentation/x86/pat.txt
 rename Documentation/x86/{protection-keys.txt => protection-keys.rst} (83%)
 rename Documentation/x86/{pti.txt => pti.rst} (99%)
 rename Documentation/x86/{resctrl_ui.txt => resctrl_ui.rst} (75%)
 rename Documentation/x86/{tlb.txt => tlb.rst} (93%)
 rename Documentation/x86/{topology.txt => topology.rst} (94%)
 rename Documentation/x86/{usb-legacy-support.txt => usb-legacy-support.rst} (57%)
 rename Documentation/x86/x86_64/{5level-paging.txt => 5level-paging.rst} (92%)
 rename Documentation/x86/x86_64/{boot-options.txt => boot-options.rst} (77%)
 create mode 100644 Documentation/x86/x86_64/mm.rst
 delete mode 100644 Documentation/x86/x86_64/mm.txt
 rename Documentation/x86/x86_64/{uefi.txt => uefi.rst} (78%)
 create mode 100644 Documentation/x86/zero-page.rst
 delete mode 100644 Documentation/x86/zero-page.txt
 rename Documentation/xilinx/{eemi.txt => eemi.rst} (92%)
 create mode 100644 Documentation/xilinx/index.rst