Subject: Re: [PATCH v2 00/79] Convert files to ReST

From: Mauro Carvalho Chehab <[email-masked]>
Date: Mon, 22 Apr 2019 11:51:10 -0300

Em Mon, 22 Apr 2019 10:26:49 -0300
Mauro Carvalho Chehab <[email-masked]> escreveu:

> This series convert lots of files to be properly parsed by Sphinx
> as ReST files.
> 
> As it touches on lot of stuff, this series is based on linux-next,
> at tag next-20190418.
> 
> The version 2 is mainly focused on addressing a comment I received
> from several subsystem maintainters:
> 
> - While it was doing the conversion, the files were not
>   being renamed to ReST. So, they weren't producing any document.
> 
> So, I opted to do the rename as well, on each patch, and to add a
> :orphan:  markup at the beginning of each file, in order to shut up
> the Sphinx warning that the file was not included on any TOC.
> 
> The second version of this series also touches a lot more directories
> without any index.rst.
> 
> After this patch, just a few directories at Documentation won't have
> an index.rst file:
> 
>     $ for i in $(find Documentation/ -name '*.txt'|perl -ne 's,([^/]*/[^/]*/).*,\1,; print $_;'|sort|uniq|grep -v Documentation/output|grep -v Documentation/sphinx); do if [ ! -f $i/index.rst ]; then echo $i; fi; done|grep -v .txt
> 
>     Documentation/ABI/
>     Documentation/devicetree/
>     Documentation/features/
>     Documentation/platform/
>     Documentation/RCU/
>     Documentation/scsi/
>     Documentation/virtual/
> 
> I'm working on another patch patch series with removes the :orphan: from
> the added files while adding them to some book. As such series would
> cause lots of conflicts, the best would be to wait for this series to be applied
> by each subsystem maintainer before adding it (probably late on some
> merge window).
> 
> Ah, I removed the patches with converts /acpi, /x86 and /PCI from this
> submission. As pointed by Rafael, Changbin is already working on
> those.
> 
> Also, I got some acks from some of those conversions. I'm opting to not
> adding here, as all patches were changed (due to the rename and addition
> of the index.rst file). So, if you send your ack already, feel free to re-send.
> 
> Both this series and  the next steps are on my devel git tree,
> at:
> 
> 	https://git.linuxtv.org/mchehab/experimental.git/log/?h=convert_rst_v2
> 
> The final output in html can be seen at:
> 
> 	https://www.infradead.org/~mchehab/rst_conversion/
> 
> Mauro Carvalho Chehab (79):
>   docs: core-api: fix broken references for div64.c and gcd.c
>   docs: trace: fix some Sphinx warnings
>   scripts/documentation-file-ref-check: don't parse Next/ dir
>   docs: aoe: convert docs to ReST and rename to *.rst
>   docs: arm64: convert docs to ReST and rename to .rst
>   docs: cdrom-standard.tex: convert from LaTeX to ReST
>   docs: cdrom: convert docs to ReST and rename to *.rst
>   docs: cgroup-v1: convert docs to ReST and rename to *.rst
>   docs: cgroup-v1/blkio-controller.rst: add a note about CFQ scheduler
>   docs: cpu-freq: convert docs to ReST and rename to *.rst
>   docs: convert docs to ReST and rename to *.rst
>   docs: fault-injection: convert docs to ReST and rename to *.rst
>   docs: fb: convert docs to ReST and rename to *.rst
>   docs: fpga: convert docs to ReST and rename to *.rst
>   docs: gpio: convert docs to ReST and rename to *.rst
>   docs: ide: convert docs to ReST and rename to *.rst
>   docs: infiniband: convert docs to ReST and rename to *.rst
>   docs: kbuild: convert docs to ReST and rename to *.rst
>   docs: kdump: convert docs to ReST and rename to *.rst
>   docs: livepatch: convert docs to ReST and rename to *.rst
>   docs: locking: convert docs to ReST and rename to *.rst
>   docs: mic: convert docs to ReST and rename to *.rst
>   docs: netlabel: convert docs to ReST and rename to *.rst
>   docs: pcmcia: convert docs to ReST and rename to *.rst
>   docs: convert docs to ReST and rename to *.rst
>   docs: powerpc: convert docs to ReST and rename to *.rst
>   docs: pps.txt: convert to ReST and rename to pps.rst
>   docs: ptp.txt: convert to ReST and move to driver-api
>   docs: riscv: convert docs to ReST and rename to *.rst
>   docs: Debugging390.txt: convert table to ascii artwork
>   docs: s390: convert docs to ReST and rename to *.rst
>   s390: include/asm/debug.h add kerneldoc markups
>   docs: serial: convert docs to ReST and rename to *.rst
>   docs: target: convert docs to ReST and rename to *.rst
>   docs: timers: convert docs to ReST and rename to *.rst
>   docs: watchdog: convert docs to ReST and rename to *.rst
>   docs: xilinx: convert eemi.txt to eemi.rst
>   docs: scheduler: convert docs to ReST and rename to *.rst
>   docs: EDID/HOWTO.txt: convert it and rename to howto.rst
>   convert docs to ReST and rename to *.rst
>   docs: lcd-panel-cgram.txt: convert docs to ReST and rename to *.rst
>   docs: lp855x-driver.txt: convert to ReST and move to kernel-api
>   docs: m68k: convert docs to ReST and rename to *.rst
>   docs: cma/debugfs.txt: convert docs to ReST and rename to *.rst
>   docs: console.txt: convert docs to ReST and rename to *.rst
>   docs: pti_intel_mid.txt: convert it to pti_intel_mid.rst
>   docs: early-userspace: convert docs to ReST and rename to *.rst
>   docs: driver-model: convert docs to ReST and rename to *.rst
>   docs: arm: convert docs to ReST and rename to *.rst
>   docs: memory-devices: convert ti-emif.txt to ReST
>   docs: xen-tpmfront.txt: convert it to .rst
>   docs: bus-devices: ti-gpmc.rst: convert it to ReST
>   docs: nvmem: convert docs to ReST and rename to *.rst
>   docs: phy: convert samsung-usb2.txt to ReST format
>   docs: rbtree.txt: fix Sphinx build warnings
>   docs: Documentation/*.txt: rename all ReST files to *.rst
>   docs: accounting: convert to ReST
>   docs: fmc: convert to ReST
>   docs: hid: convert to ReST
>   docs: ia64: convert to ReST
>   docs: leds: convert to ReST
>   docs: laptops: convert to ReST
>   docs: iio: convert to ReST
>   docs: ioctl-number.txt: convert it to ReST format
>   docs: ioctl: convert to ReST
>   docs: namespaces: convert to ReST
>   docs: nfc: convert to ReST
>   docs: md: convert to ReST
>   docs: mtd: convert to ReST
>   docs: nvdimm: convert to ReST
>   docs: xtensa: convert to ReST
>   docs: mmc: convert to ReST
>   docs: sparc: convert to ReST
>   docs: thermal: convert to ReST
>   docs: rapidio: convert to ReST
>   docs: blockdev: convert to ReST
>   docs: perf: convert to ReST
>   docs: sysctl: convert to ReST
>   docs: block: convert to ReST
> 
>  Documentation/ABI/removed/sysfs-class-rfkill  |    2 +-
>  Documentation/ABI/stable/sysfs-class-rfkill   |    2 +-
>  Documentation/ABI/stable/sysfs-devices-node   |    2 +-
>  Documentation/ABI/testing/procfs-diskstats    |    2 +-
>  Documentation/ABI/testing/sysfs-block         |    2 +-
>  Documentation/ABI/testing/sysfs-block-device  |    2 +-
>  .../ABI/testing/sysfs-class-powercap          |    2 +-
>  .../ABI/testing/sysfs-class-switchtec         |    2 +-
>  .../ABI/testing/sysfs-devices-system-cpu      |    4 +-
>  .../ABI/testing/sysfs-kernel-livepatch        |    2 +-
>  Documentation/ABI/testing/sysfs-kernel-uids   |    2 +-
>  .../ABI/testing/sysfs-platform-asus-laptop    |    2 +-
>  .../{DMA-API-HOWTO.txt => DMA-API-HOWTO.rst}  |    2 +
>  Documentation/{DMA-API.txt => DMA-API.rst}    |    8 +-
>  .../{DMA-ISA-LPC.txt => DMA-ISA-LPC.rst}      |    4 +-
>  ...{DMA-attributes.txt => DMA-attributes.rst} |    2 +
>  Documentation/EDID/{HOWTO.txt => howto.rst}   |   31 +-
>  Documentation/{IPMI.txt => IPMI.rst}          |    2 +
>  .../{IRQ-affinity.txt => IRQ-affinity.rst}    |    2 +
>  .../{IRQ-domain.txt => IRQ-domain.rst}        |    2 +
>  Documentation/{IRQ.txt => IRQ.rst}            |    2 +
>  .../{Intel-IOMMU.txt => Intel-IOMMU.rst}      |    2 +
>  Documentation/PCI/pci-error-recovery.txt      |    2 +-
>  Documentation/PCI/pci.txt                     |   10 +-
>  Documentation/{SAK.txt => SAK.rst}            |    2 +
>  Documentation/{SM501.txt => SM501.rst}        |    2 +
>  .../{cgroupstats.txt => cgroupstats.rst}      |   14 +-
>  ...ay-accounting.txt => delay-accounting.rst} |   61 +-
>  Documentation/accounting/index.rst            |   14 +
>  Documentation/accounting/{psi.txt => psi.rst} |   40 +-
>  ...kstats-struct.txt => taskstats-struct.rst} |   53 +-
>  .../{taskstats.txt => taskstats.rst}          |   15 +-
>  Documentation/admin-guide/README.rst          |    2 +-
>  Documentation/admin-guide/bug-hunting.rst     |    2 +-
>  Documentation/admin-guide/cgroup-v2.rst       |    6 +-
>  .../admin-guide/kernel-parameters.rst         |    2 +-
>  .../admin-guide/kernel-parameters.txt         |   64 +-
>  Documentation/admin-guide/l1tf.rst            |    4 +-
>  Documentation/admin-guide/mm/index.rst        |    2 +-
>  Documentation/admin-guide/mm/ksm.rst          |    2 +-
>  .../admin-guide/mm/numa_memory_policy.rst     |    2 +-
>  Documentation/aoe/{aoe.txt => aoe.rst}        |   63 +-
>  Documentation/aoe/examples.rst                |   23 +
>  Documentation/aoe/index.rst                   |   19 +
>  Documentation/aoe/{todo.txt => todo.rst}      |    3 +
>  Documentation/aoe/udev.txt                    |    2 +-
>  Documentation/arm/Marvell/README              |  395 ---
>  Documentation/arm/Netwinder                   |   78 -
>  Documentation/arm/SA1100/FreeBird             |   21 -
>  Documentation/arm/SA1100/empeg                |    2 -
>  Documentation/arm/SA1100/serial_UART          |   47 -
>  Documentation/arm/{README => arm.rst}         |   50 +-
>  Documentation/arm/{Booting => booting.rst}    |   71 +-
>  ...ance.txt => cluster-pm-race-avoidance.rst} |  177 +-
>  .../arm/{firmware.txt => firmware.rst}        |   14 +-
>  Documentation/arm/index.rst                   |   80 +
>  .../arm/{Interrupts => interrupts.rst}        |   86 +-
>  Documentation/arm/{IXP4xx => ixp4xx.rst}      |   61 +-
>  ...nel_mode_neon.txt => kernel_mode_neon.rst} |    3 +
>  ...er_helpers.txt => kernel_user_helpers.rst} |   79 +-
>  .../keystone/{knav-qmss.txt => knav-qmss.rst} |    6 +-
>  .../keystone/{Overview.txt => overview.rst}   |   47 +-
>  Documentation/arm/marvel.rst                  |  488 +++
>  .../arm/{mem_alignment => mem_alignment.rst}  |   11 +-
>  Documentation/arm/{memory.txt => memory.rst}  |    9 +-
>  .../arm/{Microchip/README => microchip.rst}   |   63 +-
>  Documentation/arm/netwinder.rst               |   85 +
>  Documentation/arm/nwfpe/index.rst             |   11 +
>  .../nwfpe/{README.FPE => netwinder-fpe.rst}   |   24 +-
>  Documentation/arm/nwfpe/{NOTES => notes.rst}  |    3 +
>  Documentation/arm/nwfpe/{README => nwfpe.rst} |   10 +-
>  Documentation/arm/nwfpe/{TODO => todo.rst}    |   47 +-
>  Documentation/arm/{OMAP/DSS => omap/dss.rst}  |  112 +-
>  Documentation/arm/omap/index.rst              |   10 +
>  .../arm/{OMAP/README => omap/omap.rst}        |    7 +
>  .../arm/{OMAP/omap_pm => omap/omap_pm.rst}    |   55 +-
>  Documentation/arm/{Porting => porting.rst}    |   14 +-
>  Documentation/arm/pxa/{mfp.txt => mfp.rst}    |  106 +-
>  .../{SA1100/ADSBitsy => sa1100/adsbitsy.rst}  |   14 +-
>  .../{SA1100/Assabet => sa1100/assabet.rst}    |  185 +-
>  .../arm/{SA1100/Brutus => sa1100/brutus.rst}  |   45 +-
>  .../arm/{SA1100/CERF => sa1100/cerf.rst}      |   10 +-
>  Documentation/arm/sa1100/freebird.rst         |   25 +
>  .../graphicsclient.rst}                       |   46 +-
>  .../graphicsmaster.rst}                       |   13 +-
>  .../HUW_WEBPANEL => sa1100/huw_webpanel.rst}  |    8 +-
>  Documentation/arm/sa1100/index.rst            |   23 +
>  .../arm/{SA1100/Itsy => sa1100/itsy.rst}      |   14 +-
>  .../arm/{SA1100/LART => sa1100/lart.rst}      |    3 +-
>  .../nanoEngine => sa1100/nanoengine.rst}      |    6 +-
>  .../{SA1100/Pangolin => sa1100/pangolin.rst}  |   10 +-
>  .../arm/{SA1100/PLEB => sa1100/pleb.rst}      |    6 +-
>  Documentation/arm/sa1100/serial_uart.rst      |   51 +
>  .../arm/{SA1100/Tifon => sa1100/tifon.rst}    |    4 +-
>  .../arm/{SA1100/Yopy => sa1100/yopy.rst}      |    5 +-
>  .../cpufreq.rst}                              |    5 +-
>  .../eb2410itx.rst}                            |    5 +-
>  .../GPIO.txt => samsung-s3c24xx/gpio.rst}     |   23 +-
>  .../H1940.txt => samsung-s3c24xx/h1940.rst}   |    5 +-
>  Documentation/arm/samsung-s3c24xx/index.rst   |   18 +
>  .../NAND.txt => samsung-s3c24xx/nand.rst}     |    6 +-
>  .../overview.rst}                             |   21 +-
>  .../s3c2412.rst}                              |    5 +-
>  .../s3c2413.rst}                              |    7 +-
>  .../smdk2440.rst}                             |    5 +-
>  .../suspend.rst}                              |   20 +-
>  .../usb-host.rst}                             |   16 +-
>  .../bootloader-interface.rst}                 |   27 +-
>  .../clksrc-change-registers.awk               |    0
>  .../{Samsung/GPIO.txt => samsung/gpio.rst}    |    7 +-
>  Documentation/arm/samsung/index.rst           |   10 +
>  .../Overview.txt => samsung/overview.rst}     |   15 +-
>  Documentation/arm/{Setup => setup.rst}        |   49 +-
>  .../arm/{SH-Mobile => sh-mobile}/.gitignore   |    0
>  .../overview.txt => spear/overview.rst}       |   20 +-
>  .../arm/sti/{overview.txt => overview.rst}    |   21 +-
>  ...h407-overview.txt => stih407-overview.rst} |    9 +-
>  ...h415-overview.txt => stih415-overview.rst} |    8 +-
>  ...h416-overview.txt => stih416-overview.rst} |    5 +-
>  ...h418-overview.txt => stih418-overview.rst} |    9 +-
>  .../arm/stm32/stm32f429-overview.rst          |    5 +-
>  .../arm/stm32/stm32f746-overview.rst          |    5 +-
>  .../arm/stm32/stm32f769-overview.rst          |    5 +-
>  .../arm/stm32/stm32h743-overview.rst          |    5 +-
>  .../arm/stm32/stm32mp157-overview.rst         |    1 +
>  Documentation/arm/{sunxi/README => sunxi.rst} |   98 +-
>  .../arm/sunxi/{clocks.txt => clocks.rst}      |    7 +-
>  .../arm/{swp_emulation => swp_emulation.rst}  |   24 +-
>  Documentation/arm/{tcm.txt => tcm.rst}        |   54 +-
>  Documentation/arm/{uefi.txt => uefi.rst}      |   39 +-
>  .../release-notes.rst}                        |    4 +-
>  Documentation/arm/{vlocks.txt => vlocks.rst}  |    9 +-
>  ...object_usage.txt => acpi_object_usage.rst} |  288 +-
>  .../arm64/{arm-acpi.txt => arm-acpi.rst}      |  155 +-
>  .../arm64/{booting.txt => booting.rst}        |   91 +-
>  ...egisters.txt => cpu-feature-registers.rst} |  190 +-
>  .../arm64/{elf_hwcaps.txt => elf_hwcaps.rst}  |   56 +-
>  .../{hugetlbpage.txt => hugetlbpage.rst}      |    7 +-
>  Documentation/arm64/index.rst                 |   28 +
>  ...structions.txt => legacy_instructions.rst} |   43 +-
>  Documentation/arm64/memory.rst                |   98 +
>  Documentation/arm64/memory.txt                |   97 -
>  ...ication.txt => pointer-authentication.rst} |    2 +
>  ...{silicon-errata.txt => silicon-errata.rst} |   63 +-
>  Documentation/arm64/{sve.txt => sve.rst}      |   12 +-
>  ...agged-pointers.txt => tagged-pointers.rst} |    6 +-
>  .../{atomic_bitops.txt => atomic_bitops.rst}  |    2 +
>  ...cd-panel-cgram.txt => lcd-panel-cgram.rst} |    9 +-
>  Documentation/backlight/lp855x-driver.rst     |   83 +
>  Documentation/backlight/lp855x-driver.txt     |   66 -
>  .../{bfq-iosched.txt => bfq-iosched.rst}      |   68 +-
>  .../block/{biodoc.txt => biodoc.rst}          |  365 ++-
>  .../block/{biovecs.txt => biovecs.rst}        |   20 +-
>  Documentation/block/capability.rst            |   18 +
>  Documentation/block/capability.txt            |   15 -
>  ...ne-partition.txt => cmdline-partition.rst} |   13 +-
>  ...{data-integrity.txt => data-integrity.rst} |   58 +-
>  ...dline-iosched.txt => deadline-iosched.rst} |   19 +-
>  Documentation/block/index.rst                 |   25 +
>  .../block/{ioprio.txt => ioprio.rst}          |   95 +-
>  .../{kyber-iosched.txt => kyber-iosched.rst}  |    3 +-
>  .../block/{null_blk.txt => null_blk.rst}      |   65 +-
>  Documentation/block/{pr.txt => pr.rst}        |   14 +-
>  .../{queue-sysfs.txt => queue-sysfs.rst}      |    7 +-
>  .../block/{request.txt => request.rst}        |   47 +-
>  Documentation/block/{stat.txt => stat.rst}    |   13 +-
>  ...witching-sched.txt => switching-sched.rst} |   28 +-
>  ...ontrol.txt => writeback_cache_control.rst} |   12 +-
>  ...structure-v9.txt => data-structure-v9.rst} |    6 +-
>  Documentation/blockdev/drbd/figures.rst       |   28 +
>  .../blockdev/drbd/{README.txt => index.rst}   |   15 +-
>  .../blockdev/{floppy.txt => floppy.rst}       |   88 +-
>  Documentation/blockdev/index.rst              |   16 +
>  Documentation/blockdev/{nbd.txt => nbd.rst}   |    1 +
>  .../blockdev/{paride.txt => paride.rst}       |  144 +-
>  .../blockdev/{ramdisk.txt => ramdisk.rst}     |   55 +-
>  Documentation/blockdev/{zram.txt => zram.rst} |  197 +-
>  .../{bt8xxgpio.txt => bt8xxgpio.rst}          |    2 +
>  Documentation/{btmrvl.txt => btmrvl.rst}      |    2 +
>  .../bus-devices/{ti-gpmc.txt => ti-gpmc.rst}  |  159 +-
>  ...-mapping.txt => bus-virt-phys-mapping.rst} |    4 +-
>  Documentation/cdrom/Makefile                  |   21 -
>  Documentation/cdrom/cdrom-standard.rst        | 1063 +++++++
>  Documentation/cdrom/cdrom-standard.tex        | 1026 -------
>  Documentation/cdrom/{ide-cd => ide-cd.rst}    |  196 +-
>  Documentation/cdrom/index.rst                 |   19 +
>  ...{packet-writing.txt => packet-writing.rst} |   27 +-
>  ...io-controller.txt => blkio-controller.rst} |  103 +-
>  .../cgroup-v1/{cgroups.txt => cgroups.rst}    |  184 +-
>  .../cgroup-v1/{cpuacct.txt => cpuacct.rst}    |   15 +-
>  .../cgroup-v1/{cpusets.txt => cpusets.rst}    |  205 +-
>  .../cgroup-v1/{devices.txt => devices.rst}    |   40 +-
>  ...er-subsystem.txt => freezer-subsystem.rst} |   14 +-
>  .../cgroup-v1/{hugetlb.txt => hugetlb.rst}    |   31 +-
>  Documentation/cgroup-v1/index.rst             |   30 +
>  .../{memcg_test.txt => memcg_test.rst}        |  261 +-
>  .../cgroup-v1/{memory.txt => memory.rst}      |  449 +--
>  .../cgroup-v1/{net_cls.txt => net_cls.rst}    |   37 +-
>  .../cgroup-v1/{net_prio.txt => net_prio.rst}  |   24 +-
>  .../cgroup-v1/{pids.txt => pids.rst}          |   78 +-
>  .../cgroup-v1/{rdma.txt => rdma.rst}          |   66 +-
>  ...g-warn-once.txt => clearing-warn-once.rst} |    2 +
>  .../cma/{debugfs.txt => debugfs.rst}          |    8 +-
>  .../{connector.txt => connector.rst}          |  130 +-
>  .../console/{console.txt => console.rst}      |   63 +-
>  Documentation/core-api/kernel-api.rst         |    4 +-
>  Documentation/core-api/printk-formats.rst     |    2 +-
>  .../{amd-powernow.txt => amd-powernow.rst}    |   11 +-
>  Documentation/cpu-freq/{core.txt => core.rst} |   68 +-
>  .../{cpu-drivers.txt => cpu-drivers.rst}      |  217 +-
>  ...pufreq-nforce2.txt => cpufreq-nforce2.rst} |   12 +-
>  Documentation/cpu-freq/cpufreq-stats.rst      |  128 +
>  Documentation/cpu-freq/cpufreq-stats.txt      |  127 -
>  Documentation/cpu-freq/index.rst              |   52 +
>  Documentation/cpu-freq/index.txt              |   56 -
>  .../{pcc-cpufreq.txt => pcc-cpufreq.rst}      |  102 +-
>  Documentation/{cpu-load.txt => cpu-load.rst}  |    2 +
>  .../{cputopology.txt => cputopology.rst}      |    2 +
>  Documentation/{crc32.txt => crc32.rst}        |    2 +
>  Documentation/{dcdbas.txt => dcdbas.rst}      |    2 +
>  ...ging-modules.txt => debugging-modules.rst} |    2 +
>  ...hci1394.txt => debugging-via-ohci1394.rst} |    2 +
>  Documentation/{dell_rbu.txt => dell_rbu.rst}  |    2 +
>  ...{cache-policies.txt => cache-policies.rst} |   24 +-
>  .../device-mapper/{cache.txt => cache.rst}    |  206 +-
>  .../device-mapper/{delay.txt => delay.rst}    |   29 +-
>  .../{dm-crypt.txt => dm-crypt.rst}            |   57 +-
>  .../{dm-flakey.txt => dm-flakey.rst}          |   45 +-
>  .../{dm-init.txt => dm-init.rst}              |   75 +-
>  .../{dm-integrity.txt => dm-integrity.rst}    |   55 +-
>  .../device-mapper/{dm-io.txt => dm-io.rst}    |   14 +-
>  .../device-mapper/{dm-log.txt => dm-log.rst}  |    5 +-
>  ...m-queue-length.txt => dm-queue-length.rst} |   25 +-
>  .../{dm-raid.txt => dm-raid.rst}              |  225 +-
>  ...m-service-time.txt => dm-service-time.rst} |   68 +-
>  Documentation/device-mapper/dm-uevent.rst     |  110 +
>  Documentation/device-mapper/dm-uevent.txt     |   97 -
>  .../{dm-zoned.txt => dm-zoned.rst}            |   10 +-
>  .../device-mapper/{era.txt => era.rst}        |   36 +-
>  Documentation/device-mapper/index.rst         |   44 +
>  .../device-mapper/{kcopyd.txt => kcopyd.rst}  |   10 +-
>  Documentation/device-mapper/linear.rst        |   63 +
>  Documentation/device-mapper/linear.txt        |   61 -
>  .../{log-writes.txt => log-writes.rst}        |   91 +-
>  ...ersistent-data.txt => persistent-data.rst} |    4 +
>  .../{snapshot.txt => snapshot.rst}            |  116 +-
>  .../{statistics.txt => statistics.rst}        |   66 +-
>  Documentation/device-mapper/striped.rst       |   61 +
>  Documentation/device-mapper/striped.txt       |   57 -
>  .../device-mapper/{switch.txt => switch.rst}  |   47 +-
>  ...provisioning.txt => thin-provisioning.rst} |   68 +-
>  .../{unstriped.txt => unstriped.rst}          |  111 +-
>  .../device-mapper/{verity.txt => verity.rst}  |   20 +-
>  .../{writecache.txt => writecache.rst}        |   13 +-
>  .../device-mapper/{zero.txt => zero.rst}      |   14 +-
>  Documentation/devicetree/bindings/arm/xen.txt |    2 +-
>  .../devicetree/bindings/phy/phy-bindings.txt  |    2 +-
>  .../devicetree/booting-without-of.txt         |    4 +-
>  Documentation/{digsig.txt => digsig.rst}      |    2 +
>  Documentation/driver-api/gpio/driver.rst      |    2 +-
>  Documentation/driver-api/pm/devices.rst       |    6 +-
>  .../{pps/pps.txt => driver-api/pps.rst}       |   67 +-
>  .../{ptp/ptp.txt => driver-api/ptp.rst}       |   26 +-
>  Documentation/driver-api/s390-drivers.rst     |    4 +-
>  Documentation/driver-api/usb/dma.rst          |    6 +-
>  .../driver-api/usb/power-management.rst       |    2 +-
>  .../driver-model/{binding.txt => binding.rst} |   20 +-
>  .../driver-model/{bus.txt => bus.rst}         |   69 +-
>  .../driver-model/{class.txt => class.rst}     |   74 +-
>  ...esign-patterns.txt => design-patterns.rst} |  106 +-
>  .../driver-model/{device.txt => device.rst}   |   59 +-
>  .../driver-model/{devres.txt => devres.rst}   |   50 +-
>  .../driver-model/{driver.txt => driver.rst}   |  112 +-
>  Documentation/driver-model/index.rst          |   26 +
>  .../{overview.txt => overview.rst}            |   37 +-
>  .../{platform.txt => platform.rst}            |   30 +-
>  .../driver-model/{porting.txt => porting.rst} |  333 +--
>  .../{buffer-format.txt => buffer-format.rst}  |   19 +-
>  .../{README => early_userspace_support.rst}   |    3 +
>  Documentation/early-userspace/index.rst       |   18 +
>  Documentation/{efi-stub.txt => efi-stub.rst}  |    2 +
>  Documentation/{eisa.txt => eisa.rst}          |    6 +-
>  ...ault-injection.txt => fault-injection.rst} |  265 +-
>  Documentation/fault-injection/index.rst       |   20 +
>  ...r-inject.txt => notifier-error-inject.rst} |   18 +-
>  .../fault-injection/nvme-fault-injection.rst  |  120 +
>  .../fault-injection/nvme-fault-injection.txt  |  116 -
>  .../fault-injection/provoke-crashes.rst       |   48 +
>  .../fault-injection/provoke-crashes.txt       |   38 -
>  Documentation/fb/{api.txt => api.rst}         |   29 +-
>  Documentation/fb/{arkfb.txt => arkfb.rst}     |    8 +-
>  .../fb/{aty128fb.txt => aty128fb.rst}         |   35 +-
>  .../fb/{cirrusfb.txt => cirrusfb.rst}         |   47 +-
>  .../fb/{cmap_xfbdev.txt => cmap_xfbdev.rst}   |   57 +-
>  .../fb/{deferred_io.txt => deferred_io.rst}   |   28 +-
>  Documentation/fb/{efifb.txt => efifb.rst}     |   18 +-
>  .../fb/{ep93xx-fb.txt => ep93xx-fb.rst}       |   27 +-
>  Documentation/fb/{fbcon.txt => fbcon.rst}     |  181 +-
>  .../fb/{framebuffer.txt => framebuffer.rst}   |   79 +-
>  Documentation/fb/{gxfb.txt => gxfb.rst}       |   24 +-
>  Documentation/fb/index.rst                    |   50 +
>  .../fb/{intel810.txt => intel810.rst}         |   79 +-
>  Documentation/fb/{intelfb.txt => intelfb.rst} |   62 +-
>  .../fb/{internals.txt => internals.rst}       |   24 +-
>  Documentation/fb/{lxfb.txt => lxfb.rst}       |   25 +-
>  Documentation/fb/matroxfb.rst                 |  443 +++
>  Documentation/fb/matroxfb.txt                 |  413 ---
>  .../fb/{metronomefb.txt => metronomefb.rst}   |    8 +-
>  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 +-
>  .../fb/{sa1100fb.txt => sa1100fb.rst}         |   23 +-
>  Documentation/fb/sh7760fb.rst                 |  130 +
>  Documentation/fb/sh7760fb.txt                 |  131 -
>  Documentation/fb/{sisfb.txt => sisfb.rst}     |   40 +-
>  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 +-
>  .../fb/{tridentfb.txt => tridentfb.rst}       |   36 +-
>  Documentation/fb/{udlfb.txt => udlfb.rst}     |   55 +-
>  Documentation/fb/{uvesafb.txt => uvesafb.rst} |  128 +-
>  Documentation/fb/{vesafb.txt => vesafb.rst}   |  123 +-
>  Documentation/fb/viafb.rst                    |  297 ++
>  Documentation/fb/viafb.txt                    |  252 --
>  .../fb/{vt8623fb.txt => vt8623fb.rst}         |   10 +-
>  Documentation/filesystems/nfs/nfsroot.txt     |    2 +-
>  .../filesystems/ramfs-rootfs-initramfs.txt    |    4 +-
>  Documentation/filesystems/sysfs.txt           |    2 +-
>  Documentation/filesystems/tmpfs.txt           |    2 +-
>  .../filesystems/ubifs-authentication.md       |    4 +-
>  Documentation/fmc/{API.txt => api.rst}        |   10 +-
>  .../fmc/{carrier.txt => carrier.rst}          |   65 +-
>  .../fmc/{FMC-and-SDB.txt => fmc-and-sdb.rst}  |   19 +-
>  .../fmc/{fmc-chardev.txt => fmc-chardev.rst}  |    9 +-
>  .../fmc/{fmc-fakedev.txt => fmc-fakedev.rst}  |   13 +-
>  .../fmc/{fmc-trivial.txt => fmc-trivial.rst}  |   11 +-
>  ...-write-eeprom.txt => fmc-write-eeprom.rst} |   36 +-
>  .../fmc/{identifiers.txt => identifiers.rst}  |   20 +-
>  Documentation/fmc/index.rst                   |   21 +
>  .../fmc/{mezzanine.txt => mezzanine.rst}      |   34 +-
>  .../fmc/{parameters.txt => parameters.rst}    |   11 +-
>  Documentation/fpga/{dfl.txt => dfl.rst}       |   58 +-
>  Documentation/fpga/index.rst                  |   17 +
>  ...ex-requeue-pi.txt => futex-requeue-pi.rst} |    2 +
>  .../{gcc-plugins.txt => gcc-plugins.rst}      |    2 +
>  Documentation/gpio/index.rst                  |   17 +
>  Documentation/gpio/{sysfs.txt => sysfs.rst}   |   39 +-
>  Documentation/gpu/drm-mm.rst                  |    2 +-
>  .../hid/{hid-alps.txt => hid-alps.rst}        |   85 +-
>  .../hid/{hid-sensor.txt => hid-sensor.rst}    |  192 +-
>  .../{hid-transport.txt => hid-transport.rst}  |   82 +-
>  Documentation/hid/{hiddev.txt => hiddev.rst}  |  130 +-
>  Documentation/hid/{hidraw.txt => hidraw.rst}  |   53 +-
>  Documentation/hid/index.rst                   |   18 +
>  Documentation/hid/intel-ish-hid.rst           |  485 +++
>  Documentation/hid/intel-ish-hid.txt           |  454 ---
>  Documentation/hid/{uhid.txt => uhid.rst}      |   46 +-
>  Documentation/{highuid.txt => highuid.rst}    |    2 +
>  .../{hw_random.txt => hw_random.rst}          |    2 +
>  Documentation/hwmon/submitting-patches.rst    |    2 +-
>  .../{hwspinlock.txt => hwspinlock.rst}        |    2 +
>  .../ia64/{aliasing.txt => aliasing.rst}       |   71 +-
>  Documentation/ia64/{efirtc.txt => efirtc.rst} |   86 +-
>  .../ia64/{err_inject.txt => err_inject.rst}   |  347 ++-
>  Documentation/ia64/{fsys.txt => fsys.rst}     |  127 +-
>  Documentation/ia64/{README => ia64.rst}       |   26 +-
>  Documentation/ia64/index.rst                  |   18 +
>  .../ia64/{IRQ-redir.txt => irq-redir.rst}     |   32 +-
>  Documentation/ia64/{mca.txt => mca.rst}       |   10 +-
>  Documentation/ia64/{serial.txt => serial.rst} |   36 +-
>  Documentation/ia64/xen.rst                    |  206 ++
>  Documentation/ia64/xen.txt                    |  183 --
>  Documentation/ide/changelogs.rst              |   17 +
>  .../ide/{ide-tape.txt => ide-tape.rst}        |   23 +-
>  Documentation/ide/{ide.txt => ide.rst}        |  147 +-
>  Documentation/ide/index.rst                   |   21 +
>  ...arm-plug-howto.txt => warm-plug-howto.rst} |   10 +-
>  .../iio/{ep93xx_adc.txt => ep93xx_adc.rst}    |   15 +-
>  .../{iio_configfs.txt => iio_configfs.rst}    |   52 +-
>  Documentation/iio/index.rst                   |   12 +
>  Documentation/index.rst                       |    1 +
>  .../{core_locking.txt => core_locking.rst}    |   64 +-
>  Documentation/infiniband/index.rst            |   23 +
>  .../infiniband/{ipoib.txt => ipoib.rst}       |   24 +-
>  .../infiniband/{opa_vnic.txt => opa_vnic.rst} |  108 +-
>  .../infiniband/{sysfs.txt => sysfs.rst}       |    4 +-
>  .../{tag_matching.txt => tag_matching.rst}    |    5 +
>  .../infiniband/{user_mad.txt => user_mad.rst} |   33 +-
>  .../{user_verbs.txt => user_verbs.rst}        |   12 +-
>  Documentation/input/input.rst                 |    2 +-
>  .../{intel_txt.txt => intel_txt.rst}          |    2 +
>  .../{io-mapping.txt => io-mapping.rst}        |    2 +
>  .../{io_ordering.txt => io_ordering.rst}      |    2 +
>  ...g-up-ioctls.txt => botching-up-ioctls.rst} |    1 +
>  Documentation/ioctl/cdrom.rst                 | 1233 ++++++++
>  Documentation/ioctl/cdrom.txt                 |  967 ------
>  Documentation/ioctl/{hdio.txt => hdio.rst}    |  835 ++++--
>  Documentation/ioctl/index.rst                 |   16 +
>  ...{ioctl-decoding.txt => ioctl-decoding.rst} |   13 +-
>  Documentation/ioctl/ioctl-number.rst          |  360 +++
>  Documentation/ioctl/ioctl-number.txt          |  350 ---
>  Documentation/{iostats.txt => iostats.rst}    |    2 +
>  ...flags-tracing.txt => irqflags-tracing.rst} |    2 +
>  Documentation/{isa.txt => isa.rst}            |    2 +
>  Documentation/{isapnp.txt => isapnp.rst}      |    2 +
>  ...eaders_install.txt => headers_install.rst} |    5 +-
>  Documentation/kbuild/index.rst                |   27 +
>  Documentation/kbuild/issues.rst               |   11 +
>  .../kbuild/{kbuild.txt => kbuild.rst}         |  119 +-
>  ...nfig-language.txt => kconfig-language.rst} |  232 +-
>  ...anguage.txt => kconfig-macro-language.rst} |   37 +-
>  .../kbuild/{kconfig.txt => kconfig.rst}       |  136 +-
>  .../kbuild/{makefiles.txt => makefiles.rst}   |  518 ++--
>  .../kbuild/{modules.txt => modules.rst}       |  168 +-
>  Documentation/kdump/index.rst                 |   21 +
>  Documentation/kdump/{kdump.txt => kdump.rst}  |  131 +-
>  .../kdump/{vmcoreinfo.txt => vmcoreinfo.rst}  |   59 +-
>  Documentation/kernel-hacking/hacking.rst      |    4 +-
>  Documentation/kernel-hacking/locking.rst      |    2 +-
>  ...hreads.txt => kernel-per-CPU-kthreads.rst} |    6 +-
>  Documentation/{kobject.txt => kobject.rst}    |    4 +-
>  Documentation/{kprobes.txt => kprobes.rst}    |    2 +
>  Documentation/{kref.txt => kref.rst}          |    2 +
>  .../{asus-laptop.txt => asus-laptop.rst}      |   91 +-
>  ...otection.txt => disk-shock-protection.rst} |   32 +-
>  Documentation/laptops/index.rst               |   17 +
>  .../{laptop-mode.txt => laptop-mode.rst}      |  509 ++--
>  .../{sony-laptop.txt => sony-laptop.rst}      |   58 +-
>  .../laptops/{sonypi.txt => sonypi.rst}        |   28 +-
>  .../{thinkpad-acpi.txt => thinkpad-acpi.rst}  |  373 ++-
>  .../{toshiba_haps.txt => toshiba_haps.rst}    |   47 +-
>  Documentation/{ldm.txt => ldm.rst}            |    2 +
>  Documentation/leds/index.rst                  |   25 +
>  .../leds/{leds-blinkm.txt => leds-blinkm.rst} |   63 +-
>  ...s-class-flash.txt => leds-class-flash.rst} |   49 +-
>  .../leds/{leds-class.txt => leds-class.rst}   |   15 +-
>  .../leds/{leds-lm3556.txt => leds-lm3556.rst} |  100 +-
>  .../leds/{leds-lp3944.txt => leds-lp3944.rst} |   23 +-
>  Documentation/leds/leds-lp5521.rst            |  115 +
>  Documentation/leds/leds-lp5521.txt            |  101 -
>  Documentation/leds/leds-lp5523.rst            |  147 +
>  Documentation/leds/leds-lp5523.txt            |  130 -
>  Documentation/leds/leds-lp5562.rst            |  137 +
>  Documentation/leds/leds-lp5562.txt            |  120 -
>  Documentation/leds/leds-lp55xx.rst            |  224 ++
>  Documentation/leds/leds-lp55xx.txt            |  194 --
>  Documentation/leds/leds-mlxcpld.rst           |  118 +
>  Documentation/leds/leds-mlxcpld.txt           |  110 -
>  ...edtrig-oneshot.txt => ledtrig-oneshot.rst} |   11 +-
>  ...ig-transient.txt => ledtrig-transient.rst} |   63 +-
>  ...edtrig-usbport.txt => ledtrig-usbport.rst} |   11 +-
>  Documentation/leds/{uleds.txt => uleds.rst}   |    5 +-
>  .../{callbacks.txt => callbacks.rst}          |   12 +-
>  ...ive-patches.txt => cumulative-patches.rst} |   14 +-
>  Documentation/livepatch/index.rst             |   21 +
>  .../{livepatch.txt => livepatch.rst}          |   60 +-
>  ...e-elf-format.txt => module-elf-format.rst} |  211 +-
>  .../{shadow-vars.txt => shadow-vars.rst}      |   65 +-
>  Documentation/locking/index.rst               |   24 +
>  ...{lockdep-design.txt => lockdep-design.rst} |   41 +-
>  Documentation/locking/lockstat.rst            |  204 ++
>  Documentation/locking/lockstat.txt            |  183 --
>  .../{locktorture.txt => locktorture.rst}      |  105 +-
>  .../{mutex-design.txt => mutex-design.rst}    |   26 +-
>  ...t-mutex-design.txt => rt-mutex-design.rst} |  139 +-
>  .../locking/{rt-mutex.txt => rt-mutex.rst}    |   32 +-
>  .../locking/{spinlocks.txt => spinlocks.rst}  |   32 +-
>  ...w-mutex-design.txt => ww-mutex-design.rst} |   82 +-
>  ...kup-watchdogs.txt => lockup-watchdogs.rst} |    2 +
>  Documentation/{lsm.txt => lsm.rst}            |    2 +
>  Documentation/{lzo.txt => lzo.rst}            |    2 +
>  Documentation/m68k/index.rst                  |   17 +
>  ...{kernel-options.txt => kernel-options.rst} |  319 +-
>  Documentation/{mailbox.txt => mailbox.rst}    |    2 +
>  Documentation/md/index.rst                    |   12 +
>  .../md/{md-cluster.txt => md-cluster.rst}     |  188 +-
>  .../md/{raid5-cache.txt => raid5-cache.rst}   |   28 +-
>  .../md/{raid5-ppl.txt => raid5-ppl.rst}       |    2 +
>  Documentation/memory-barriers.txt             |    6 +-
>  .../{ti-emif.txt => ti-emif.rst}              |   27 +-
>  ...hameleon-bus.txt => men-chameleon-bus.rst} |    2 +
>  Documentation/mic/index.rst                   |   18 +
>  .../{mic_overview.txt => mic_overview.rst}    |    6 +-
>  .../{scif_overview.txt => scif_overview.rst}  |   58 +-
>  Documentation/mmc/index.rst                   |   13 +
>  .../{mmc-async-req.txt => mmc-async-req.rst}  |   53 +-
>  .../{mmc-dev-attrs.txt => mmc-dev-attrs.rst}  |   32 +-
>  .../{mmc-dev-parts.txt => mmc-dev-parts.rst}  |   13 +-
>  .../mmc/{mmc-tools.txt => mmc-tools.rst}      |    5 +-
>  Documentation/mtd/index.rst                   |   12 +
>  .../mtd/{intel-spi.txt => intel-spi.rst}      |   46 +-
>  .../mtd/{nand_ecc.txt => nand_ecc.rst}        |  481 +--
>  .../mtd/{spi-nor.txt => spi-nor.rst}          |    7 +-
>  ...bility-list.txt => compatibility-list.rst} |    9 +-
>  Documentation/namespaces/index.rst            |   11 +
>  ...ource-control.txt => resource-control.rst} |    4 +
>  .../{cipso_ipv4.txt => cipso_ipv4.rst}        |   19 +-
>  Documentation/netlabel/draft_ietf.rst         |    5 +
>  Documentation/netlabel/index.rst              |   21 +
>  .../{introduction.txt => introduction.rst}    |   16 +-
>  .../{lsm_interface.txt => lsm_interface.rst}  |   16 +-
>  Documentation/networking/ip-sysctl.txt        |    2 +-
>  Documentation/networking/scaling.rst          |    4 +-
>  Documentation/networking/timestamping.txt     |    2 +-
>  Documentation/nfc/index.rst                   |   11 +
>  .../nfc/{nfc-hci.txt => nfc-hci.rst}          |  163 +-
>  .../nfc/{nfc-pn544.txt => nfc-pn544.rst}      |    6 +-
>  .../{nommu-mmap.txt => nommu-mmap.rst}        |    2 +
>  Documentation/{ntb.txt => ntb.rst}            |    2 +
>  Documentation/{numastat.txt => numastat.rst}  |    2 +
>  Documentation/nvdimm/{btt.txt => btt.rst}     |  139 +-
>  Documentation/nvdimm/index.rst                |   12 +
>  .../nvdimm/{nvdimm.txt => nvdimm.rst}         |  518 ++--
>  .../nvdimm/{security.txt => security.rst}     |    4 +-
>  Documentation/nvmem/{nvmem.txt => nvmem.rst}  |  112 +-
>  Documentation/{padata.txt => padata.rst}      |    2 +
>  ...port-lowlevel.txt => parport-lowlevel.rst} |    2 +
>  .../{devicetable.txt => devicetable.rst}      |    4 +
>  ...{driver-changes.txt => driver-changes.rst} |   35 +-
>  .../pcmcia/{driver.txt => driver.rst}         |   18 +-
>  Documentation/pcmcia/index.rst                |   20 +
>  .../pcmcia/{locking.txt => locking.rst}       |   39 +-
>  ...-semaphore.txt => percpu-rw-semaphore.rst} |    2 +
>  .../perf/{arm-ccn.txt => arm-ccn.rst}         |   18 +-
>  .../perf/{arm_dsu_pmu.txt => arm_dsu_pmu.rst} |    5 +-
>  .../perf/{hisi-pmu.txt => hisi-pmu.rst}       |   35 +-
>  Documentation/perf/index.rst                  |   16 +
>  .../perf/{qcom_l2_pmu.txt => qcom_l2_pmu.rst} |    3 +-
>  .../perf/{qcom_l3_pmu.txt => qcom_l3_pmu.rst} |    3 +-
>  .../{thunderx2-pmu.txt => thunderx2-pmu.rst}  |   25 +-
>  .../perf/{xgene-pmu.txt => xgene-pmu.rst}     |    3 +-
>  Documentation/{phy.txt => phy.rst}            |    2 +
>  .../{samsung-usb2.txt => samsung-usb2.rst}    |   62 +-
>  Documentation/{pi-futex.txt => pi-futex.rst}  |    4 +-
>  Documentation/{pnp.txt => pnp.rst}            |    2 +
>  .../power/{apm-acpi.txt => apm-acpi.rst}      |   10 +-
>  ...m-debugging.txt => basic-pm-debugging.rst} |   79 +-
>  ...harger-manager.txt => charger-manager.rst} |  101 +-
>  ...rivers-testing.txt => drivers-testing.rst} |   15 +-
>  .../{energy-model.txt => energy-model.rst}    |  101 +-
>  ...ing-of-tasks.txt => freezing-of-tasks.rst} |   91 +-
>  Documentation/power/index.rst                 |   46 +
>  .../power/{interface.txt => interface.rst}    |   24 +-
>  Documentation/power/{opp.txt => opp.rst}      |  175 +-
>  Documentation/power/{pci.txt => pci.rst}      |   87 +-
>  ...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 --
>  .../regulator/{consumer.txt => consumer.rst}  |  141 +-
>  .../regulator/{design.txt => design.rst}      |    9 +-
>  .../regulator/{machine.txt => machine.rst}    |   47 +-
>  .../regulator/{overview.txt => overview.rst}  |   57 +-
>  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 +-
>  ...hotplug.txt => suspend-and-cpuhotplug.rst} |   42 +-
>  ...errupts.txt => suspend-and-interrupts.rst} |    2 +
>  ...ap-files.txt => swsusp-and-swap-files.rst} |   17 +-
>  ...{swsusp-dmcrypt.txt => swsusp-dmcrypt.rst} |  120 +-
>  Documentation/power/swsusp.rst                |  501 ++++
>  Documentation/power/swsusp.txt                |  446 ---
>  .../power/{tricks.txt => tricks.rst}          |    6 +-
>  ...serland-swsusp.txt => userland-swsusp.rst} |   55 +-
>  Documentation/power/{video.txt => video.rst}  |  156 +-
>  .../{bootwrapper.txt => bootwrapper.rst}      |   28 +-
>  .../{cpu_families.txt => cpu_families.rst}    |   23 +-
>  .../{cpu_features.txt => cpu_features.rst}    |    6 +-
>  Documentation/powerpc/{cxl.txt => cxl.rst}    |   46 +-
>  .../powerpc/{cxlflash.txt => cxlflash.rst}    |   10 +-
>  .../{DAWR-POWER9.txt => dawr-power9.rst}      |   10 +-
>  Documentation/powerpc/{dscr.txt => dscr.rst}  |   18 +-
>  ...ecovery.txt => eeh-pci-error-recovery.rst} |  108 +-
>  ...ed-dump.txt => firmware-assisted-dump.rst} |  119 +-
>  Documentation/powerpc/{hvcs.txt => hvcs.rst}  |  108 +-
>  Documentation/powerpc/index.rst               |   34 +
>  Documentation/powerpc/isa-versions.rst        |   13 +-
>  .../powerpc/{mpc52xx.txt => mpc52xx.rst}      |   12 +-
>  ...nv.txt => pci_iov_resource_on_powernv.rst} |   15 +-
>  .../powerpc/{pmu-ebb.txt => pmu-ebb.rst}      |    1 +
>  Documentation/powerpc/ptrace.rst              |  156 +
>  Documentation/powerpc/ptrace.txt              |  151 -
>  .../{qe_firmware.txt => qe_firmware.rst}      |   37 +-
>  .../{syscall64-abi.txt => syscall64-abi.rst}  |   29 +-
>  ...al_memory.txt => transactional_memory.rst} |   45 +-
>  ...reempt-locking.txt => preempt-locking.rst} |    2 +
>  Documentation/process/4.Coding.rst            |    2 +-
>  Documentation/process/coding-style.rst        |    2 +-
>  Documentation/process/submit-checklist.rst    |    4 +-
>  Documentation/process/submitting-drivers.rst  |    2 +-
>  Documentation/pti/pti_intel_mid.rst           |  106 +
>  Documentation/pti/pti_intel_mid.txt           |   99 -
>  Documentation/{pwm.txt => pwm.rst}            |    2 +
>  Documentation/rapidio/index.rst               |   15 +
>  .../{mport_cdev.txt => mport_cdev.rst}        |   47 +-
>  .../rapidio/{rapidio.txt => rapidio.rst}      |   39 +-
>  .../rapidio/{rio_cm.txt => rio_cm.rst}        |   66 +-
>  .../rapidio/{sysfs.txt => sysfs.rst}          |    4 +
>  .../rapidio/{tsi721.txt => tsi721.rst}        |   45 +-
>  Documentation/{rbtree.txt => rbtree.rst}      |    8 +-
>  .../{remoteproc.txt => remoteproc.rst}        |    4 +-
>  Documentation/{rfkill.txt => rfkill.rst}      |    2 +
>  Documentation/riscv/index.rst                 |   17 +
>  Documentation/riscv/{pmu.txt => pmu.rst}      |   98 +-
>  ...ust-futex-ABI.txt => robust-futex-ABI.rst} |    2 +
>  ...{robust-futexes.txt => robust-futexes.rst} |    2 +
>  Documentation/{rpmsg.txt => rpmsg.rst}        |    2 +
>  Documentation/{rtc.txt => rtc.rst}            |    2 +
>  Documentation/s390/{3270.txt => 3270.rst}     |   85 +-
>  Documentation/s390/Debugging390.txt           | 2142 --------------
>  Documentation/s390/{cds.txt => cds.rst}       |  354 ++-
>  .../s390/{CommonIO => common_io.rst}          |   49 +-
>  Documentation/s390/{DASD => dasd.rst}         |   33 +-
>  Documentation/s390/debugging390.rst           | 2613 +++++++++++++++++
>  .../{driver-model.txt => driver-model.rst}    |  179 +-
>  Documentation/s390/index.rst                  |   30 +
>  .../s390/{monreader.txt => monreader.rst}     |   85 +-
>  Documentation/s390/{qeth.txt => qeth.rst}     |   36 +-
>  Documentation/s390/s390dbf.rst                |  133 +
>  Documentation/s390/s390dbf.txt                |  667 -----
>  Documentation/s390/text_files.rst             |   11 +
>  .../s390/{vfio-ap.txt => vfio-ap.rst}         |  487 +--
>  .../s390/{vfio-ccw.txt => vfio-ccw.rst}       |   96 +-
>  .../s390/{zfcpdump.txt => zfcpdump.rst}       |    2 +
>  .../{completion.txt => completion.rst}        |   38 +-
>  Documentation/scheduler/index.rst             |   29 +
>  .../{sched-arch.txt => sched-arch.rst}        |   18 +-
>  .../{sched-bwc.txt => sched-bwc.rst}          |   30 +-
>  ...{sched-deadline.txt => sched-deadline.rst} |  297 +-
>  ...ed-design-CFS.txt => sched-design-CFS.rst} |   17 +-
>  .../{sched-domains.txt => sched-domains.rst}  |    8 +-
>  .../{sched-energy.txt => sched-energy.rst}    |   53 +-
>  ...-nice-design.txt => sched-nice-design.rst} |    6 +-
>  ...{sched-rt-group.txt => sched-rt-group.rst} |   30 +-
>  .../{sched-stats.txt => sched-stats.rst}      |   35 +-
>  Documentation/scheduler/text_files.rst        |    5 +
>  .../{xen-tpmfront.txt => xen-tpmfront.rst}    |  103 +-
>  .../{README.cycladesZ => cyclades_z.rst}      |    5 +-
>  Documentation/serial/{driver => driver.rst}   |  115 +-
>  Documentation/serial/index.rst                |   32 +
>  Documentation/serial/moxa-smartio             |  523 ----
>  Documentation/serial/moxa-smartio.rst         |  615 ++++
>  Documentation/serial/n_gsm.rst                |  103 +
>  Documentation/serial/n_gsm.txt                |   96 -
>  .../serial/{rocket.txt => rocket.rst}         |  144 +-
>  ...{serial-iso7816.txt => serial-iso7816.rst} |   21 +-
>  .../{serial-rs485.txt => serial-rs485.rst}    |   22 +-
>  Documentation/serial/{tty.txt => tty.rst}     |  111 +-
>  Documentation/{sgi-ioc4.txt => sgi-ioc4.rst}  |    2 +
>  Documentation/{siphash.txt => siphash.rst}    |    2 +
>  .../{smsc_ece1099.txt => smsc_ece1099.rst}    |    2 +
>  Documentation/sparc/{adi.txt => adi.rst}      |  174 +-
>  .../sparc/{console.txt => console.rst}        |    4 +-
>  Documentation/sparc/index.rst                 |   13 +
>  .../oradax/{oracle-dax.txt => oracle-dax.rst} |   58 +-
>  .../{speculation.txt => speculation.rst}      |    2 +
>  .../{static-keys.txt => static-keys.rst}      |    2 +
>  Documentation/{svga.txt => svga.rst}          |    2 +
>  .../{switchtec.txt => switchtec.rst}          |    4 +-
>  .../{sync_file.txt => sync_file.rst}          |    2 +
>  Documentation/sysctl/abi.rst                  |   67 +
>  Documentation/sysctl/abi.txt                  |   54 -
>  Documentation/sysctl/{fs.txt => fs.rst}       |  141 +-
>  Documentation/sysctl/{README => index.rst}    |   36 +-
>  .../sysctl/{kernel.txt => kernel.rst}         |  378 +--
>  Documentation/sysctl/{net.txt => net.rst}     |  141 +-
>  .../sysctl/{sunrpc.txt => sunrpc.rst}         |   13 +-
>  Documentation/sysctl/{user.txt => user.rst}   |   32 +-
>  Documentation/sysctl/{vm.txt => vm.rst}       |  264 +-
>  Documentation/target/index.rst                |   19 +
>  Documentation/target/scripts.rst              |   11 +
>  Documentation/target/tcm_mod_builder.rst      |  149 +
>  Documentation/target/tcm_mod_builder.txt      |  145 -
>  .../{tcmu-design.txt => tcmu-design.rst}      |  268 +-
>  Documentation/{tee.txt => tee.rst}            |    2 +
>  ...pu-cooling-api.txt => cpu-cooling-api.rst} |   39 +-
>  .../{exynos_thermal => exynos_thermal.rst}    |   47 +-
>  .../thermal/exynos_thermal_emulation          |   53 -
>  .../thermal/exynos_thermal_emulation.rst      |   61 +
>  Documentation/thermal/index.rst               |   18 +
>  ...el_powerclamp.txt => intel_powerclamp.rst} |  177 +-
>  .../{nouveau_thermal => nouveau_thermal.rst}  |   54 +-
>  ...ower_allocator.txt => power_allocator.rst} |  140 +-
>  .../thermal/{sysfs-api.txt => sysfs-api.rst}  |  490 ++--
>  ...hermal => x86_pkg_temperature_thermal.rst} |   28 +-
>  .../{this_cpu_ops.txt => this_cpu_ops.rst}    |    2 +
>  .../timers/{highres.txt => highres.rst}       |   13 +-
>  Documentation/timers/{hpet.txt => hpet.rst}   |    4 +-
>  .../timers/{hrtimers.txt => hrtimers.rst}     |    6 +-
>  Documentation/timers/index.rst                |   22 +
>  Documentation/timers/{NO_HZ.txt => no_hz.rst} |   40 +-
>  .../{timekeeping.txt => timekeeping.rst}      |    3 +-
>  .../{timers-howto.txt => timers-howto.rst}    |   15 +-
>  Documentation/trace/coresight-cpu-debug.txt   |    2 +-
>  Documentation/trace/ftrace.rst                |    1 +
>  Documentation/trace/histogram.rst             |   86 +-
>  Documentation/trace/kprobetrace.rst           |    2 +-
>  .../it_IT/kernel-hacking/hacking.rst          |    4 +-
>  .../it_IT/kernel-hacking/locking.rst          |    2 +-
>  .../translations/it_IT/process/4.Coding.rst   |    2 +-
>  .../it_IT/process/submit-checklist.rst        |    4 +-
>  .../translations/ko_KR/memory-barriers.txt    |    6 +-
>  Documentation/translations/zh_CN/IRQ.txt      |    4 +-
>  Documentation/translations/zh_CN/arm/Booting  |    4 +-
>  .../zh_CN/arm/kernel_user_helpers.txt         |    4 +-
>  .../translations/zh_CN/arm64/booting.txt      |    4 +-
>  .../zh_CN/arm64/legacy_instructions.txt       |    4 +-
>  .../translations/zh_CN/arm64/memory.txt       |    4 +-
>  .../zh_CN/arm64/silicon-errata.txt            |    4 +-
>  .../zh_CN/arm64/tagged-pointers.txt           |    4 +-
>  .../translations/zh_CN/filesystems/sysfs.txt  |    2 +-
>  .../translations/zh_CN/io_ordering.txt        |    4 +-
>  .../translations/zh_CN/oops-tracing.txt       |    2 +-
>  .../translations/zh_CN/process/4.Coding.rst   |    2 +-
>  .../zh_CN/process/coding-style.rst            |    2 +-
>  .../zh_CN/process/submit-checklist.rst        |    4 +-
>  .../zh_CN/process/submitting-drivers.rst      |    2 +-
>  ...access.txt => unaligned-memory-access.rst} |    2 +
>  ...ed-device.txt => vfio-mediated-device.rst} |    4 +-
>  Documentation/{vfio.txt => vfio.rst}          |    2 +
>  .../{video-output.txt => video-output.rst}    |    2 +
>  Documentation/virtual/kvm/api.txt             |    2 +-
>  Documentation/vm/numa.rst                     |    6 +-
>  Documentation/vm/page_migration.rst           |    2 +-
>  Documentation/vm/unevictable-lru.rst          |    4 +-
>  ....txt => convert_drivers_to_kernel_api.rst} |  109 +-
>  .../watchdog/{hpwdt.txt => hpwdt.rst}         |   27 +-
>  Documentation/watchdog/index.rst              |   25 +
>  .../watchdog/{mlx-wdt.txt => mlx-wdt.rst}     |   24 +-
>  .../{pcwd-watchdog.txt => pcwd-watchdog.rst}  |   13 +-
>  .../{watchdog-api.txt => watchdog-api.rst}    |   76 +-
>  ...kernel-api.txt => watchdog-kernel-api.rst} |   91 +-
>  .../watchdog/watchdog-parameters.rst          |  736 +++++
>  .../watchdog/watchdog-parameters.txt          |  410 ---
>  .../{watchdog-pm.txt => watchdog-pm.rst}      |    3 +
>  Documentation/watchdog/{wdt.txt => wdt.rst}   |   31 +-
>  Documentation/x86/topology.txt                |    2 +-
>  .../x86/x86_64/fake-numa-for-cpusets          |    4 +-
>  Documentation/xilinx/{eemi.txt => eemi.rst}   |    8 +-
>  Documentation/xilinx/index.rst                |   17 +
>  Documentation/{xillybus.txt => xillybus.rst}  |    2 +
>  .../xtensa/{atomctl.txt => atomctl.rst}       |   13 +-
>  .../xtensa/{booting.txt => booting.rst}       |    5 +-
>  Documentation/xtensa/index.rst                |   12 +
>  Documentation/xtensa/mmu.rst                  |  195 ++
>  Documentation/xtensa/mmu.txt                  |  189 --
>  Documentation/{xz.txt => xz.rst}              |    2 +
>  Documentation/{zorro.txt => zorro.rst}        |    2 +
>  Kconfig                                       |    2 +-
>  MAINTAINERS                                   |  132 +-
>  arch/Kconfig                                  |    4 +-
>  arch/arc/plat-eznps/Kconfig                   |    2 +-
>  arch/arm/Kconfig                              |    8 +-
>  arch/arm/common/mcpm_entry.c                  |    2 +-
>  arch/arm/common/mcpm_head.S                   |    2 +-
>  arch/arm/common/vlock.S                       |    2 +-
>  arch/arm/include/asm/setup.h                  |    2 +-
>  arch/arm/include/uapi/asm/setup.h             |    2 +-
>  arch/arm/kernel/entry-armv.S                  |    2 +-
>  arch/arm/mach-exynos/common.h                 |    2 +-
>  arch/arm/mach-ixp4xx/Kconfig                  |   14 +-
>  arch/arm/mach-s3c24xx/pm.c                    |    2 +-
>  arch/arm/mm/Kconfig                           |    4 +-
>  arch/arm/plat-samsung/Kconfig                 |    6 +-
>  arch/arm/tools/mach-types                     |    2 +-
>  arch/arm64/Kconfig                            |    2 +-
>  arch/arm64/include/asm/efi.h                  |    2 +-
>  arch/arm64/include/asm/image.h                |    2 +-
>  arch/arm64/include/uapi/asm/sigcontext.h      |    2 +-
>  arch/arm64/kernel/kexec_image.c               |    2 +-
>  arch/arm64/kernel/kuser32.S                   |    2 +-
>  arch/c6x/Kconfig                              |    2 +-
>  arch/ia64/hp/common/sba_iommu.c               |   12 +-
>  arch/ia64/kernel/efi.c                        |    2 +-
>  arch/ia64/kernel/fsys.S                       |    2 +-
>  arch/ia64/mm/ioremap.c                        |    2 +-
>  arch/ia64/pci/pci.c                           |    2 +-
>  arch/ia64/sn/pci/pci_dma.c                    |    4 +-
>  arch/m68k/q40/README                          |    2 +-
>  arch/microblaze/Kconfig.debug                 |    2 +-
>  arch/microblaze/Kconfig.platform              |    2 +-
>  arch/mips/bmips/setup.c                       |    2 +-
>  arch/nds32/Kconfig                            |    2 +-
>  arch/openrisc/Kconfig                         |    2 +-
>  arch/parisc/Kconfig                           |    2 +-
>  arch/parisc/kernel/pci-dma.c                  |    2 +-
>  arch/powerpc/kernel/exceptions-64s.S          |    2 +-
>  arch/powerpc/sysdev/Kconfig                   |    2 +-
>  arch/riscv/Kconfig                            |    2 +-
>  arch/s390/Kconfig                             |    4 +-
>  arch/s390/include/asm/debug.h                 |  235 +-
>  arch/sh/Kconfig                               |    4 +-
>  arch/sparc/Kconfig                            |    2 +-
>  arch/unicore32/include/asm/io.h               |    2 +-
>  arch/x86/Kconfig                              |   10 +-
>  arch/x86/include/asm/dma-mapping.h            |    4 +-
>  arch/x86/kernel/amd_gart_64.c                 |    2 +-
>  arch/xtensa/include/asm/initialize_mmu.h      |    2 +-
>  block/Kconfig                                 |    4 +-
>  block/Kconfig.iosched                         |    2 +-
>  block/bfq-iosched.c                           |    2 +-
>  block/blk-integrity.c                         |    2 +-
>  block/ioprio.c                                |    2 +-
>  block/mq-deadline.c                           |    2 +-
>  block/partitions/Kconfig                      |    2 +-
>  block/partitions/cmdline.c                    |    2 +-
>  drivers/auxdisplay/Kconfig                    |    2 +-
>  drivers/base/core.c                           |    2 +-
>  drivers/base/platform.c                       |    2 +-
>  drivers/block/Kconfig                         |   10 +-
>  drivers/block/floppy.c                        |    2 +-
>  drivers/block/zram/Kconfig                    |    6 +-
>  drivers/cdrom/cdrom.c                         |    2 +-
>  drivers/char/Kconfig                          |    6 +-
>  drivers/char/hw_random/core.c                 |    2 +-
>  drivers/char/ipmi/Kconfig                     |    2 +-
>  drivers/char/ipmi/ipmi_si_hotmod.c            |    2 +-
>  drivers/char/ipmi/ipmi_si_intf.c              |    2 +-
>  drivers/cpufreq/Kconfig.x86                   |    2 +-
>  drivers/crypto/sunxi-ss/sun4i-ss-cipher.c     |    2 +-
>  drivers/crypto/sunxi-ss/sun4i-ss-core.c       |    2 +-
>  drivers/crypto/sunxi-ss/sun4i-ss-hash.c       |    2 +-
>  drivers/crypto/sunxi-ss/sun4i-ss.h            |    2 +-
>  drivers/dma-buf/Kconfig                       |    2 +-
>  drivers/firmware/Kconfig                      |    2 +-
>  drivers/gpio/Kconfig                          |    2 +-
>  drivers/gpio/gpio-cs5535.c                    |    2 +-
>  drivers/gpu/drm/Kconfig                       |    2 +-
>  drivers/gpu/drm/drm_ioctl.c                   |    2 +-
>  drivers/gpu/drm/drm_modeset_lock.c            |    2 +-
>  drivers/gpu/drm/i915/i915_drv.h               |    2 +-
>  drivers/ide/Kconfig                           |   20 +-
>  drivers/ide/ide-cd.c                          |    2 +-
>  drivers/iio/Kconfig                           |    2 +-
>  drivers/infiniband/core/user_mad.c            |    2 +-
>  drivers/infiniband/ulp/ipoib/Kconfig          |    2 +-
>  drivers/input/touchscreen/sun4i-ts.c          |    2 +-
>  drivers/leds/trigger/Kconfig                  |    2 +-
>  drivers/leds/trigger/ledtrig-transient.c      |    2 +-
>  drivers/md/Kconfig                            |    2 +-
>  drivers/md/dm-init.c                          |    2 +-
>  drivers/md/dm-raid.c                          |    2 +-
>  drivers/media/usb/dvb-usb-v2/anysee.c         |    2 +-
>  drivers/misc/lkdtm/core.c                     |    2 +-
>  drivers/mtd/devices/Kconfig                   |    2 +-
>  drivers/mtd/nand/raw/nand_ecc.c               |    2 +-
>  drivers/net/ethernet/intel/ice/ice_main.c     |    2 +-
>  drivers/net/ethernet/smsc/Kconfig             |    6 +-
>  drivers/net/wireless/intel/iwlegacy/Kconfig   |    4 +-
>  drivers/net/wireless/intel/iwlwifi/Kconfig    |    2 +-
>  drivers/nvdimm/Kconfig                        |    2 +-
>  drivers/opp/Kconfig                           |    2 +-
>  drivers/parisc/sba_iommu.c                    |   16 +-
>  drivers/parport/Kconfig                       |    2 +-
>  drivers/pci/switch/Kconfig                    |    2 +-
>  drivers/pcmcia/ds.c                           |    2 +-
>  drivers/perf/qcom_l3_pmu.c                    |    2 +-
>  drivers/platform/x86/Kconfig                  |    8 +-
>  drivers/platform/x86/dcdbas.c                 |    2 +-
>  drivers/platform/x86/dell_rbu.c               |    2 +-
>  drivers/pnp/isapnp/Kconfig                    |    2 +-
>  drivers/power/supply/power_supply_core.c      |    2 +-
>  drivers/rapidio/Kconfig                       |    2 +-
>  drivers/regulator/core.c                      |    2 +-
>  drivers/s390/char/zcore.c                     |    2 +-
>  drivers/sbus/char/oradax.c                    |    2 +-
>  drivers/scsi/Kconfig                          |    4 +-
>  drivers/soc/fsl/qe/qe.c                       |    2 +-
>  drivers/staging/sm750fb/Kconfig               |    2 +-
>  drivers/tty/Kconfig                           |    8 +-
>  drivers/tty/hvc/hvcs.c                        |    2 +-
>  drivers/tty/serial/Kconfig                    |    2 +-
>  drivers/tty/serial/ucc_uart.c                 |    2 +-
>  drivers/usb/misc/Kconfig                      |    4 +-
>  drivers/vfio/Kconfig                          |    2 +-
>  drivers/vfio/mdev/Kconfig                     |    2 +-
>  drivers/video/fbdev/Kconfig                   |   38 +-
>  drivers/video/fbdev/matrox/matroxfb_base.c    |    2 +-
>  drivers/video/fbdev/pxafb.c                   |    2 +-
>  drivers/video/fbdev/sh7760fb.c                |    2 +-
>  drivers/w1/Kconfig                            |    2 +-
>  drivers/watchdog/Kconfig                      |    6 +-
>  drivers/watchdog/smsc37b787_wdt.c             |    2 +-
>  include/asm-generic/bitops/atomic.h           |    2 +-
>  include/linux/cgroup-defs.h                   |    2 +-
>  include/linux/connector.h                     |   63 +-
>  include/linux/dma-mapping.h                   |    2 +-
>  include/linux/fault-inject.h                  |    2 +-
>  include/linux/hw_random.h                     |    2 +-
>  include/linux/interrupt.h                     |    2 +-
>  include/linux/io-mapping.h                    |    2 +-
>  include/linux/iopoll.h                        |    4 +-
>  include/linux/jump_label.h                    |    2 +-
>  include/linux/kobject.h                       |    2 +-
>  include/linux/kobject_ns.h                    |    2 +-
>  include/linux/lockdep.h                       |    2 +-
>  include/linux/mutex.h                         |    2 +-
>  include/linux/pm.h                            |    2 +-
>  include/linux/rbtree.h                        |    2 +-
>  include/linux/rbtree_augmented.h              |    2 +-
>  include/linux/regmap.h                        |    4 +-
>  include/linux/rwsem.h                         |    2 +-
>  include/linux/serial_core.h                   |    2 +-
>  include/linux/thermal.h                       |    4 +-
>  include/media/videobuf-dma-sg.h               |    2 +-
>  include/pcmcia/ds.h                           |    2 +-
>  include/pcmcia/ss.h                           |    2 +-
>  include/soc/fsl/qe/qe.h                       |    2 +-
>  include/uapi/linux/bpf.h                      |    2 +-
>  include/uapi/rdma/rdma_user_ioctl_cmds.h      |    2 +-
>  init/Kconfig                                  |   12 +-
>  kernel/cgroup/cpuset.c                        |    2 +-
>  kernel/dma/debug.c                            |    2 +-
>  kernel/locking/mutex.c                        |    2 +-
>  kernel/locking/rtmutex.c                      |    2 +-
>  kernel/padata.c                               |    2 +-
>  kernel/panic.c                                |    2 +-
>  kernel/power/Kconfig                          |    6 +-
>  kernel/sched/deadline.c                       |    2 +-
>  lib/Kconfig                                   |    2 +-
>  lib/Kconfig.debug                             |    8 +-
>  lib/crc32.c                                   |    2 +-
>  lib/kobject.c                                 |    4 +-
>  lib/lzo/lzo1x_decompress_safe.c               |    2 +-
>  lib/xz/Kconfig                                |    2 +-
>  mm/Kconfig                                    |    2 +-
>  mm/nommu.c                                    |    2 +-
>  mm/swap.c                                     |    2 +-
>  net/bridge/netfilter/Kconfig                  |    2 +-
>  net/ipv4/netfilter/Kconfig                    |    2 +-
>  net/ipv6/netfilter/Kconfig                    |    2 +-
>  net/netfilter/Kconfig                         |   18 +-
>  net/tipc/Kconfig                              |    2 +-
>  net/wireless/Kconfig                          |    2 +-
>  samples/Kconfig                               |    2 +-
>  samples/kprobes/kprobe_example.c              |    2 +-
>  samples/kprobes/kretprobe_example.c           |    2 +-
>  scripts/Kbuild.include                        |    4 +-
>  scripts/Makefile.host                         |    2 +-
>  scripts/checkpatch.pl                         |    8 +-
>  scripts/coccinelle/free/devm_free.cocci       |    2 +-
>  scripts/documentation-file-ref-check          |    5 +-
>  scripts/gcc-plugins/Kconfig                   |    2 +-
>  scripts/kconfig/symbol.c                      |    2 +-
>  .../tests/err_recursive_dep/expected_stderr   |   14 +-
>  security/Kconfig                              |    2 +-
>  security/device_cgroup.c                      |    2 +-
>  sound/oss/dmasound/Kconfig                    |    6 +-
>  tools/include/linux/rbtree.h                  |    2 +-
>  tools/include/linux/rbtree_augmented.h        |    2 +-
>  tools/include/uapi/linux/bpf.h                |    2 +-
>  .../Documentation/stack-validation.txt        |    2 +-
>  tools/testing/fault-injection/failcmd.sh      |    2 +-
>  tools/testing/selftests/zram/README           |    2 +-
>  usr/Kconfig                                   |    2 +-
>  961 files changed, 31818 insertions(+), 24040 deletions(-)
>  rename Documentation/{DMA-API-HOWTO.txt => DMA-API-HOWTO.rst} (99%)
>  rename Documentation/{DMA-API.txt => DMA-API.rst} (99%)
>  rename Documentation/{DMA-ISA-LPC.txt => DMA-ISA-LPC.rst} (98%)
>  rename Documentation/{DMA-attributes.txt => DMA-attributes.rst} (99%)
>  rename Documentation/EDID/{HOWTO.txt => howto.rst} (83%)
>  rename Documentation/{IPMI.txt => IPMI.rst} (99%)
>  rename Documentation/{IRQ-affinity.txt => IRQ-affinity.rst} (99%)
>  rename Documentation/{IRQ-domain.txt => IRQ-domain.rst} (99%)
>  rename Documentation/{IRQ.txt => IRQ.rst} (99%)
>  rename Documentation/{Intel-IOMMU.txt => Intel-IOMMU.rst} (99%)
>  rename Documentation/{SAK.txt => SAK.rst} (99%)
>  rename Documentation/{SM501.txt => SM501.rst} (99%)
>  rename Documentation/accounting/{cgroupstats.txt => cgroupstats.rst} (77%)
>  rename Documentation/accounting/{delay-accounting.txt => delay-accounting.rst} (77%)
>  create mode 100644 Documentation/accounting/index.rst
>  rename Documentation/accounting/{psi.txt => psi.rst} (91%)
>  rename Documentation/accounting/{taskstats-struct.txt => taskstats-struct.rst} (90%)
>  rename Documentation/accounting/{taskstats.txt => taskstats.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%)
>  delete mode 100644 Documentation/arm/Marvell/README
>  delete mode 100644 Documentation/arm/Netwinder
>  delete mode 100644 Documentation/arm/SA1100/FreeBird
>  delete mode 100644 Documentation/arm/SA1100/empeg
>  delete mode 100644 Documentation/arm/SA1100/serial_UART
>  rename Documentation/arm/{README => arm.rst} (88%)
>  rename Documentation/arm/{Booting => booting.rst} (89%)
>  rename Documentation/arm/{cluster-pm-race-avoidance.txt => cluster-pm-race-avoidance.rst} (84%)
>  rename Documentation/arm/{firmware.txt => firmware.rst} (86%)
>  create mode 100644 Documentation/arm/index.rst
>  rename Documentation/arm/{Interrupts => interrupts.rst} (81%)
>  rename Documentation/arm/{IXP4xx => ixp4xx.rst} (84%)
>  rename Documentation/arm/{kernel_mode_neon.txt => kernel_mode_neon.rst} (99%)
>  rename Documentation/arm/{kernel_user_helpers.txt => kernel_user_helpers.rst} (78%)
>  rename Documentation/arm/keystone/{knav-qmss.txt => knav-qmss.rst} (92%)
>  rename Documentation/arm/keystone/{Overview.txt => overview.rst} (59%)
>  create mode 100644 Documentation/arm/marvel.rst
>  rename Documentation/arm/{mem_alignment => mem_alignment.rst} (89%)
>  rename Documentation/arm/{memory.txt => memory.rst} (90%)
>  rename Documentation/arm/{Microchip/README => microchip.rst} (92%)
>  create mode 100644 Documentation/arm/netwinder.rst
>  create mode 100644 Documentation/arm/nwfpe/index.rst
>  rename Documentation/arm/nwfpe/{README.FPE => netwinder-fpe.rst} (94%)
>  rename Documentation/arm/nwfpe/{NOTES => notes.rst} (99%)
>  rename Documentation/arm/nwfpe/{README => nwfpe.rst} (98%)
>  rename Documentation/arm/nwfpe/{TODO => todo.rst} (75%)
>  rename Documentation/arm/{OMAP/DSS => omap/dss.rst} (86%)
>  create mode 100644 Documentation/arm/omap/index.rst
>  rename Documentation/arm/{OMAP/README => omap/omap.rst} (62%)
>  rename Documentation/arm/{OMAP/omap_pm => omap/omap_pm.rst} (83%)
>  rename Documentation/arm/{Porting => porting.rst} (94%)
>  rename Documentation/arm/pxa/{mfp.txt => mfp.rst} (83%)
>  rename Documentation/arm/{SA1100/ADSBitsy => sa1100/adsbitsy.rst} (90%)
>  rename Documentation/arm/{SA1100/Assabet => sa1100/assabet.rst} (62%)
>  rename Documentation/arm/{SA1100/Brutus => sa1100/brutus.rst} (75%)
>  rename Documentation/arm/{SA1100/CERF => sa1100/cerf.rst} (91%)
>  create mode 100644 Documentation/arm/sa1100/freebird.rst
>  rename Documentation/arm/{SA1100/GraphicsClient => sa1100/graphicsclient.rst} (87%)
>  rename Documentation/arm/{SA1100/GraphicsMaster => sa1100/graphicsmaster.rst} (92%)
>  rename Documentation/arm/{SA1100/HUW_WEBPANEL => sa1100/huw_webpanel.rst} (78%)
>  create mode 100644 Documentation/arm/sa1100/index.rst
>  rename Documentation/arm/{SA1100/Itsy => sa1100/itsy.rst} (88%)
>  rename Documentation/arm/{SA1100/LART => sa1100/lart.rst} (90%)
>  rename Documentation/arm/{SA1100/nanoEngine => sa1100/nanoengine.rst} (74%)
>  rename Documentation/arm/{SA1100/Pangolin => sa1100/pangolin.rst} (81%)
>  rename Documentation/arm/{SA1100/PLEB => sa1100/pleb.rst} (95%)
>  create mode 100644 Documentation/arm/sa1100/serial_uart.rst
>  rename Documentation/arm/{SA1100/Tifon => sa1100/tifon.rst} (88%)
>  rename Documentation/arm/{SA1100/Yopy => sa1100/yopy.rst} (74%)
>  rename Documentation/arm/{Samsung-S3C24XX/CPUfreq.txt => samsung-s3c24xx/cpufreq.rst} (96%)
>  rename Documentation/arm/{Samsung-S3C24XX/EB2410ITX.txt => samsung-s3c24xx/eb2410itx.rst} (92%)
>  rename Documentation/arm/{Samsung-S3C24XX/GPIO.txt => samsung-s3c24xx/gpio.rst} (89%)
>  rename Documentation/arm/{Samsung-S3C24XX/H1940.txt => samsung-s3c24xx/h1940.rst} (94%)
>  create mode 100644 Documentation/arm/samsung-s3c24xx/index.rst
>  rename Documentation/arm/{Samsung-S3C24XX/NAND.txt => samsung-s3c24xx/nand.rst} (92%)
>  rename Documentation/arm/{Samsung-S3C24XX/Overview.txt => samsung-s3c24xx/overview.rst} (94%)
>  rename Documentation/arm/{Samsung-S3C24XX/S3C2412.txt => samsung-s3c24xx/s3c2412.rst} (96%)
>  rename Documentation/arm/{Samsung-S3C24XX/S3C2413.txt => samsung-s3c24xx/s3c2413.rst} (77%)
>  rename Documentation/arm/{Samsung-S3C24XX/SMDK2440.txt => samsung-s3c24xx/smdk2440.rst} (94%)
>  rename Documentation/arm/{Samsung-S3C24XX/Suspend.txt => samsung-s3c24xx/suspend.rst} (94%)
>  rename Documentation/arm/{Samsung-S3C24XX/USB-Host.txt => samsung-s3c24xx/usb-host.rst} (94%)
>  rename Documentation/arm/{Samsung/Bootloader-interface.txt => samsung/bootloader-interface.rst} (72%)
>  rename Documentation/arm/{Samsung => samsung}/clksrc-change-registers.awk (100%)
>  rename Documentation/arm/{Samsung/GPIO.txt => samsung/gpio.rst} (87%)
>  create mode 100644 Documentation/arm/samsung/index.rst
>  rename Documentation/arm/{Samsung/Overview.txt => samsung/overview.rst} (86%)
>  rename Documentation/arm/{Setup => setup.rst} (87%)
>  rename Documentation/arm/{SH-Mobile => sh-mobile}/.gitignore (100%)
>  rename Documentation/arm/{SPEAr/overview.txt => spear/overview.rst} (91%)
>  rename Documentation/arm/sti/{overview.txt => overview.rst} (82%)
>  rename Documentation/arm/sti/{stih407-overview.txt => stih407-overview.rst} (82%)
>  rename Documentation/arm/sti/{stih415-overview.txt => stih415-overview.rst} (79%)
>  rename Documentation/arm/sti/{stih416-overview.txt => stih416-overview.rst} (83%)
>  rename Documentation/arm/sti/{stih418-overview.txt => stih418-overview.rst} (83%)
>  rename Documentation/arm/{sunxi/README => sunxi.rst} (83%)
>  rename Documentation/arm/sunxi/{clocks.txt => clocks.rst} (92%)
>  rename Documentation/arm/{swp_emulation => swp_emulation.rst} (63%)
>  rename Documentation/arm/{tcm.txt => tcm.rst} (86%)
>  rename Documentation/arm/{uefi.txt => uefi.rst} (63%)
>  rename Documentation/arm/{VFP/release-notes.txt => vfp/release-notes.rst} (92%)
>  rename Documentation/arm/{vlocks.txt => vlocks.rst} (98%)
>  rename Documentation/arm64/{acpi_object_usage.txt => acpi_object_usage.rst} (84%)
>  rename Documentation/arm64/{arm-acpi.txt => arm-acpi.rst} (86%)
>  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} (92%)
>  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%)
>  rename Documentation/{atomic_bitops.txt => atomic_bitops.rst} (99%)
>  rename Documentation/auxdisplay/{lcd-panel-cgram.txt => lcd-panel-cgram.rst} (88%)
>  create mode 100644 Documentation/backlight/lp855x-driver.rst
>  delete mode 100644 Documentation/backlight/lp855x-driver.txt
>  rename Documentation/block/{bfq-iosched.txt => bfq-iosched.rst} (95%)
>  rename Documentation/block/{biodoc.txt => biodoc.rst} (83%)
>  rename Documentation/block/{biovecs.txt => biovecs.rst} (92%)
>  create mode 100644 Documentation/block/capability.rst
>  delete mode 100644 Documentation/block/capability.txt
>  rename Documentation/block/{cmdline-partition.txt => cmdline-partition.rst} (92%)
>  rename Documentation/block/{data-integrity.txt => data-integrity.rst} (92%)
>  rename Documentation/block/{deadline-iosched.txt => deadline-iosched.rst} (89%)
>  create mode 100644 Documentation/block/index.rst
>  rename Documentation/block/{ioprio.txt => ioprio.rst} (75%)
>  rename Documentation/block/{kyber-iosched.txt => kyber-iosched.rst} (86%)
>  rename Documentation/block/{null_blk.txt => null_blk.rst} (60%)
>  rename Documentation/block/{pr.txt => pr.rst} (95%)
>  rename Documentation/block/{queue-sysfs.txt => queue-sysfs.rst} (99%)
>  rename Documentation/block/{request.txt => request.rst} (59%)
>  rename Documentation/block/{stat.txt => stat.rst} (89%)
>  rename Documentation/block/{switching-sched.txt => switching-sched.rst} (71%)
>  rename Documentation/block/{writeback_cache_control.txt => writeback_cache_control.rst} (94%)
>  rename Documentation/blockdev/drbd/{data-structure-v9.txt => data-structure-v9.rst} (94%)
>  create mode 100644 Documentation/blockdev/drbd/figures.rst
>  rename Documentation/blockdev/drbd/{README.txt => index.rst} (55%)
>  rename Documentation/blockdev/{floppy.txt => floppy.rst} (81%)
>  create mode 100644 Documentation/blockdev/index.rst
>  rename Documentation/blockdev/{nbd.txt => nbd.rst} (96%)
>  rename Documentation/blockdev/{paride.txt => paride.rst} (85%)
>  rename Documentation/blockdev/{ramdisk.txt => ramdisk.rst} (84%)
>  rename Documentation/blockdev/{zram.txt => zram.rst} (76%)
>  rename Documentation/{bt8xxgpio.txt => bt8xxgpio.rst} (99%)
>  rename Documentation/{btmrvl.txt => btmrvl.rst} (99%)
>  rename Documentation/bus-devices/{ti-gpmc.txt => ti-gpmc.rst} (58%)
>  rename Documentation/{bus-virt-phys-mapping.txt => bus-virt-phys-mapping.rst} (99%)
>  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} (82%)
>  create mode 100644 Documentation/cdrom/index.rst
>  rename Documentation/cdrom/{packet-writing.txt => packet-writing.rst} (91%)
>  rename Documentation/cgroup-v1/{blkio-controller.txt => blkio-controller.rst} (89%)
>  rename Documentation/cgroup-v1/{cgroups.txt => cgroups.rst} (88%)
>  rename Documentation/cgroup-v1/{cpuacct.txt => cpuacct.rst} (90%)
>  rename Documentation/cgroup-v1/{cpusets.txt => cpusets.rst} (90%)
>  rename Documentation/cgroup-v1/{devices.txt => devices.rst} (88%)
>  rename Documentation/cgroup-v1/{freezer-subsystem.txt => freezer-subsystem.rst} (95%)
>  rename Documentation/cgroup-v1/{hugetlb.txt => hugetlb.rst} (74%)
>  create mode 100644 Documentation/cgroup-v1/index.rst
>  rename Documentation/cgroup-v1/{memcg_test.txt => memcg_test.rst} (62%)
>  rename Documentation/cgroup-v1/{memory.txt => memory.rst} (71%)
>  rename Documentation/cgroup-v1/{net_cls.txt => net_cls.rst} (50%)
>  rename Documentation/cgroup-v1/{net_prio.txt => net_prio.rst} (71%)
>  rename Documentation/cgroup-v1/{pids.txt => pids.rst} (62%)
>  rename Documentation/cgroup-v1/{rdma.txt => rdma.rst} (79%)
>  rename Documentation/{clearing-warn-once.txt => clearing-warn-once.rst} (96%)
>  rename Documentation/cma/{debugfs.txt => debugfs.rst} (91%)
>  rename Documentation/connector/{connector.txt => connector.rst} (57%)
>  rename Documentation/console/{console.txt => console.rst} (80%)
>  rename Documentation/cpu-freq/{amd-powernow.txt => amd-powernow.rst} (91%)
>  rename Documentation/cpu-freq/{core.txt => core.rst} (66%)
>  rename Documentation/cpu-freq/{cpu-drivers.txt => cpu-drivers.rst} (57%)
>  rename Documentation/cpu-freq/{cpufreq-nforce2.txt => cpufreq-nforce2.rst} (65%)
>  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/{cpu-load.txt => cpu-load.rst} (99%)
>  rename Documentation/{cputopology.txt => cputopology.rst} (99%)
>  rename Documentation/{crc32.txt => crc32.rst} (99%)
>  rename Documentation/{dcdbas.txt => dcdbas.rst} (99%)
>  rename Documentation/{debugging-modules.txt => debugging-modules.rst} (98%)
>  rename Documentation/{debugging-via-ohci1394.txt => debugging-via-ohci1394.rst} (99%)
>  rename Documentation/{dell_rbu.txt => dell_rbu.rst} (99%)
>  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} (86%)
>  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/{digsig.txt => digsig.rst} (99%)
>  rename Documentation/{pps/pps.txt => driver-api/pps.rst} (89%)
>  rename Documentation/{ptp/ptp.txt => driver-api/ptp.rst} (88%)
>  rename Documentation/driver-model/{binding.txt => binding.rst} (92%)
>  rename Documentation/driver-model/{bus.txt => bus.rst} (76%)
>  rename Documentation/driver-model/{class.txt => class.rst} (75%)
>  rename Documentation/driver-model/{design-patterns.txt => design-patterns.rst} (59%)
>  rename Documentation/driver-model/{device.txt => device.rst} (69%)
>  rename Documentation/driver-model/{devres.txt => devres.rst} (93%)
>  rename Documentation/driver-model/{driver.txt => driver.rst} (75%)
>  create mode 100644 Documentation/driver-model/index.rst
>  rename Documentation/driver-model/{overview.txt => overview.rst} (90%)
>  rename Documentation/driver-model/{platform.txt => platform.rst} (95%)
>  rename Documentation/driver-model/{porting.txt => porting.rst} (62%)
>  rename Documentation/early-userspace/{buffer-format.txt => buffer-format.rst} (91%)
>  rename Documentation/early-userspace/{README => early_userspace_support.rst} (99%)
>  create mode 100644 Documentation/early-userspace/index.rst
>  rename Documentation/{efi-stub.txt => efi-stub.rst} (99%)
>  rename Documentation/{eisa.txt => eisa.rst} (98%)
>  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} (61%)
>  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} (85%)
>  rename Documentation/fb/{fbcon.txt => fbcon.rst} (68%)
>  rename Documentation/fb/{framebuffer.txt => framebuffer.rst} (92%)
>  rename Documentation/fb/{gxfb.txt => gxfb.rst} (60%)
>  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} (60%)
>  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} (70%)
>  rename Documentation/fb/{udlfb.txt => udlfb.rst} (77%)
>  rename Documentation/fb/{uvesafb.txt => uvesafb.rst} (52%)
>  rename Documentation/fb/{vesafb.txt => vesafb.rst} (56%)
>  create mode 100644 Documentation/fb/viafb.rst
>  delete mode 100644 Documentation/fb/viafb.txt
>  rename Documentation/fb/{vt8623fb.txt => vt8623fb.rst} (85%)
>  rename Documentation/fmc/{API.txt => api.rst} (87%)
>  rename Documentation/fmc/{carrier.txt => carrier.rst} (91%)
>  rename Documentation/fmc/{FMC-and-SDB.txt => fmc-and-sdb.rst} (88%)
>  rename Documentation/fmc/{fmc-chardev.txt => fmc-chardev.rst} (96%)
>  rename Documentation/fmc/{fmc-fakedev.txt => fmc-fakedev.rst} (85%)
>  rename Documentation/fmc/{fmc-trivial.txt => fmc-trivial.rst} (69%)
>  rename Documentation/fmc/{fmc-write-eeprom.txt => fmc-write-eeprom.rst} (79%)
>  rename Documentation/fmc/{identifiers.txt => identifiers.rst} (93%)
>  create mode 100644 Documentation/fmc/index.rst
>  rename Documentation/fmc/{mezzanine.txt => mezzanine.rst} (87%)
>  rename Documentation/fmc/{parameters.txt => parameters.rst} (96%)
>  rename Documentation/fpga/{dfl.txt => dfl.rst} (89%)
>  create mode 100644 Documentation/fpga/index.rst
>  rename Documentation/{futex-requeue-pi.txt => futex-requeue-pi.rst} (99%)
>  rename Documentation/{gcc-plugins.txt => gcc-plugins.rst} (99%)
>  create mode 100644 Documentation/gpio/index.rst
>  rename Documentation/gpio/{sysfs.txt => sysfs.rst} (86%)
>  rename Documentation/hid/{hid-alps.txt => hid-alps.rst} (64%)
>  rename Documentation/hid/{hid-sensor.txt => hid-sensor.rst} (61%)
>  rename Documentation/hid/{hid-transport.txt => hid-transport.rst} (93%)
>  rename Documentation/hid/{hiddev.txt => hiddev.rst} (80%)
>  rename Documentation/hid/{hidraw.txt => hidraw.rst} (89%)
>  create mode 100644 Documentation/hid/index.rst
>  create mode 100644 Documentation/hid/intel-ish-hid.rst
>  delete mode 100644 Documentation/hid/intel-ish-hid.txt
>  rename Documentation/hid/{uhid.txt => uhid.rst} (94%)
>  rename Documentation/{highuid.txt => highuid.rst} (99%)
>  rename Documentation/{hw_random.txt => hw_random.rst} (99%)
>  rename Documentation/{hwspinlock.txt => hwspinlock.rst} (99%)
>  rename Documentation/ia64/{aliasing.txt => aliasing.rst} (84%)
>  rename Documentation/ia64/{efirtc.txt => efirtc.rst} (76%)
>  rename Documentation/ia64/{err_inject.txt => err_inject.rst} (82%)
>  rename Documentation/ia64/{fsys.txt => fsys.rst} (76%)
>  rename Documentation/ia64/{README => ia64.rst} (61%)
>  create mode 100644 Documentation/ia64/index.rst
>  rename Documentation/ia64/{IRQ-redir.txt => irq-redir.rst} (84%)
>  rename Documentation/ia64/{mca.txt => mca.rst} (96%)
>  rename Documentation/ia64/{serial.txt => serial.rst} (87%)
>  create mode 100644 Documentation/ia64/xen.rst
>  delete mode 100644 Documentation/ia64/xen.txt
>  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/iio/{ep93xx_adc.txt => ep93xx_adc.rst} (71%)
>  rename Documentation/iio/{iio_configfs.txt => iio_configfs.rst} (73%)
>  create mode 100644 Documentation/iio/index.rst
>  rename Documentation/infiniband/{core_locking.txt => core_locking.rst} (78%)
>  create mode 100644 Documentation/infiniband/index.rst
>  rename Documentation/infiniband/{ipoib.txt => ipoib.rst} (90%)
>  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/{intel_txt.txt => intel_txt.rst} (99%)
>  rename Documentation/{io-mapping.txt => io-mapping.rst} (99%)
>  rename Documentation/{io_ordering.txt => io_ordering.rst} (99%)
>  rename Documentation/ioctl/{botching-up-ioctls.txt => botching-up-ioctls.rst} (99%)
>  create mode 100644 Documentation/ioctl/cdrom.rst
>  delete mode 100644 Documentation/ioctl/cdrom.txt
>  rename Documentation/ioctl/{hdio.txt => hdio.rst} (54%)
>  create mode 100644 Documentation/ioctl/index.rst
>  rename Documentation/ioctl/{ioctl-decoding.txt => ioctl-decoding.rst} (54%)
>  create mode 100644 Documentation/ioctl/ioctl-number.rst
>  delete mode 100644 Documentation/ioctl/ioctl-number.txt
>  rename Documentation/{iostats.txt => iostats.rst} (99%)
>  rename Documentation/{irqflags-tracing.txt => irqflags-tracing.rst} (99%)
>  rename Documentation/{isa.txt => isa.rst} (99%)
>  rename Documentation/{isapnp.txt => isapnp.rst} (98%)
>  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} (84%)
>  create mode 100644 Documentation/kdump/index.rst
>  rename Documentation/kdump/{kdump.txt => kdump.rst} (91%)
>  rename Documentation/kdump/{vmcoreinfo.txt => vmcoreinfo.rst} (95%)
>  rename Documentation/{kernel-per-CPU-kthreads.txt => kernel-per-CPU-kthreads.rst} (99%)
>  rename Documentation/{kobject.txt => kobject.rst} (99%)
>  rename Documentation/{kprobes.txt => kprobes.rst} (99%)
>  rename Documentation/{kref.txt => kref.rst} (99%)
>  rename Documentation/laptops/{asus-laptop.txt => asus-laptop.rst} (84%)
>  rename Documentation/laptops/{disk-shock-protection.txt => disk-shock-protection.rst} (91%)
>  create mode 100644 Documentation/laptops/index.rst
>  rename Documentation/laptops/{laptop-mode.txt => laptop-mode.rst} (62%)
>  rename Documentation/laptops/{sony-laptop.txt => sony-laptop.rst} (85%)
>  rename Documentation/laptops/{sonypi.txt => sonypi.rst} (87%)
>  rename Documentation/laptops/{thinkpad-acpi.txt => thinkpad-acpi.rst} (88%)
>  rename Documentation/laptops/{toshiba_haps.txt => toshiba_haps.rst} (60%)
>  rename Documentation/{ldm.txt => ldm.rst} (99%)
>  create mode 100644 Documentation/leds/index.rst
>  rename Documentation/leds/{leds-blinkm.txt => leds-blinkm.rst} (56%)
>  rename Documentation/leds/{leds-class-flash.txt => leds-class-flash.rst} (74%)
>  rename Documentation/leds/{leds-class.txt => leds-class.rst} (92%)
>  rename Documentation/leds/{leds-lm3556.txt => leds-lm3556.rst} (70%)
>  rename Documentation/leds/{leds-lp3944.txt => leds-lp3944.rst} (78%)
>  create mode 100644 Documentation/leds/leds-lp5521.rst
>  delete mode 100644 Documentation/leds/leds-lp5521.txt
>  create mode 100644 Documentation/leds/leds-lp5523.rst
>  delete mode 100644 Documentation/leds/leds-lp5523.txt
>  create mode 100644 Documentation/leds/leds-lp5562.rst
>  delete mode 100644 Documentation/leds/leds-lp5562.txt
>  create mode 100644 Documentation/leds/leds-lp55xx.rst
>  delete mode 100644 Documentation/leds/leds-lp55xx.txt
>  create mode 100644 Documentation/leds/leds-mlxcpld.rst
>  delete mode 100644 Documentation/leds/leds-mlxcpld.txt
>  rename Documentation/leds/{ledtrig-oneshot.txt => ledtrig-oneshot.rst} (90%)
>  rename Documentation/leds/{ledtrig-transient.txt => ledtrig-transient.rst} (81%)
>  rename Documentation/leds/{ledtrig-usbport.txt => ledtrig-usbport.rst} (86%)
>  rename Documentation/leds/{uleds.txt => uleds.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} (93%)
>  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} (70%)
>  rename Documentation/locking/{spinlocks.txt => spinlocks.rst} (89%)
>  rename Documentation/locking/{ww-mutex-design.txt => ww-mutex-design.rst} (93%)
>  rename Documentation/{lockup-watchdogs.txt => lockup-watchdogs.rst} (99%)
>  rename Documentation/{lsm.txt => lsm.rst} (99%)
>  rename Documentation/{lzo.txt => lzo.rst} (99%)
>  create mode 100644 Documentation/m68k/index.rst
>  rename Documentation/m68k/{kernel-options.txt => kernel-options.rst} (78%)
>  rename Documentation/{mailbox.txt => mailbox.rst} (99%)
>  create mode 100644 Documentation/md/index.rst
>  rename Documentation/md/{md-cluster.txt => md-cluster.rst} (68%)
>  rename Documentation/md/{raid5-cache.txt => raid5-cache.rst} (92%)
>  rename Documentation/md/{raid5-ppl.txt => raid5-ppl.rst} (98%)
>  rename Documentation/memory-devices/{ti-emif.txt => ti-emif.rst} (81%)
>  rename Documentation/{men-chameleon-bus.txt => men-chameleon-bus.rst} (99%)
>  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%)
>  create mode 100644 Documentation/mmc/index.rst
>  rename Documentation/mmc/{mmc-async-req.txt => mmc-async-req.rst} (75%)
>  rename Documentation/mmc/{mmc-dev-attrs.txt => mmc-dev-attrs.rst} (73%)
>  rename Documentation/mmc/{mmc-dev-parts.txt => mmc-dev-parts.rst} (83%)
>  rename Documentation/mmc/{mmc-tools.txt => mmc-tools.rst} (92%)
>  create mode 100644 Documentation/mtd/index.rst
>  rename Documentation/mtd/{intel-spi.txt => intel-spi.rst} (71%)
>  rename Documentation/mtd/{nand_ecc.txt => nand_ecc.rst} (67%)
>  rename Documentation/mtd/{spi-nor.txt => spi-nor.rst} (94%)
>  rename Documentation/namespaces/{compatibility-list.txt => compatibility-list.rst} (86%)
>  create mode 100644 Documentation/namespaces/index.rst
>  rename Documentation/namespaces/{resource-control.txt => resource-control.rst} (89%)
>  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%)
>  create mode 100644 Documentation/nfc/index.rst
>  rename Documentation/nfc/{nfc-hci.txt => nfc-hci.rst} (71%)
>  rename Documentation/nfc/{nfc-pn544.txt => nfc-pn544.rst} (82%)
>  rename Documentation/{nommu-mmap.txt => nommu-mmap.rst} (99%)
>  rename Documentation/{ntb.txt => ntb.rst} (99%)
>  rename Documentation/{numastat.txt => numastat.rst} (99%)
>  rename Documentation/nvdimm/{btt.txt => btt.rst} (71%)
>  create mode 100644 Documentation/nvdimm/index.rst
>  rename Documentation/nvdimm/{nvdimm.txt => nvdimm.rst} (60%)
>  rename Documentation/nvdimm/{security.txt => security.rst} (99%)
>  rename Documentation/nvmem/{nvmem.txt => nvmem.rst} (62%)
>  rename Documentation/{padata.txt => padata.rst} (99%)
>  rename Documentation/{parport-lowlevel.txt => parport-lowlevel.rst} (99%)
>  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/{percpu-rw-semaphore.txt => percpu-rw-semaphore.rst} (99%)
>  rename Documentation/perf/{arm-ccn.txt => arm-ccn.rst} (86%)
>  rename Documentation/perf/{arm_dsu_pmu.txt => arm_dsu_pmu.rst} (92%)
>  rename Documentation/perf/{hisi-pmu.txt => hisi-pmu.rst} (73%)
>  create mode 100644 Documentation/perf/index.rst
>  rename Documentation/perf/{qcom_l2_pmu.txt => qcom_l2_pmu.rst} (94%)
>  rename Documentation/perf/{qcom_l3_pmu.txt => qcom_l3_pmu.rst} (93%)
>  rename Documentation/perf/{thunderx2-pmu.txt => thunderx2-pmu.rst} (73%)
>  rename Documentation/perf/{xgene-pmu.txt => xgene-pmu.rst} (96%)
>  rename Documentation/{phy.txt => phy.rst} (99%)
>  rename Documentation/phy/{samsung-usb2.txt => samsung-usb2.rst} (77%)
>  rename Documentation/{pi-futex.txt => pi-futex.rst} (99%)
>  rename Documentation/{pnp.txt => pnp.rst} (99%)
>  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} (86%)
>  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} (84%)
>  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} (79%)
>  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} (83%)
>  rename Documentation/power/{swsusp-dmcrypt.txt => swsusp-dmcrypt.rst} (67%)
>  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} (85%)
>  rename Documentation/power/{video.txt => video.rst} (56%)
>  rename Documentation/powerpc/{bootwrapper.txt => bootwrapper.rst} (93%)
>  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} (98%)
>  rename Documentation/powerpc/{DAWR-POWER9.txt => dawr-power9.rst} (95%)
>  rename Documentation/powerpc/{dscr.txt => dscr.rst} (91%)
>  rename Documentation/powerpc/{eeh-pci-error-recovery.txt => eeh-pci-error-recovery.rst} (82%)
>  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%)
>  rename Documentation/{preempt-locking.txt => preempt-locking.rst} (99%)
>  create mode 100644 Documentation/pti/pti_intel_mid.rst
>  delete mode 100644 Documentation/pti/pti_intel_mid.txt
>  rename Documentation/{pwm.txt => pwm.rst} (99%)
>  create mode 100644 Documentation/rapidio/index.rst
>  rename Documentation/rapidio/{mport_cdev.txt => mport_cdev.rst} (84%)
>  rename Documentation/rapidio/{rapidio.txt => rapidio.rst} (97%)
>  rename Documentation/rapidio/{rio_cm.txt => rio_cm.rst} (76%)
>  rename Documentation/rapidio/{sysfs.txt => sysfs.rst} (75%)
>  rename Documentation/rapidio/{tsi721.txt => tsi721.rst} (79%)
>  rename Documentation/{rbtree.txt => rbtree.rst} (99%)
>  rename Documentation/{remoteproc.txt => remoteproc.rst} (99%)
>  rename Documentation/{rfkill.txt => rfkill.rst} (99%)
>  create mode 100644 Documentation/riscv/index.rst
>  rename Documentation/riscv/{pmu.txt => pmu.rst} (77%)
>  rename Documentation/{robust-futex-ABI.txt => robust-futex-ABI.rst} (99%)
>  rename Documentation/{robust-futexes.txt => robust-futexes.rst} (99%)
>  rename Documentation/{rpmsg.txt => rpmsg.rst} (99%)
>  rename Documentation/{rtc.txt => rtc.rst} (99%)
>  rename Documentation/s390/{3270.txt => 3270.rst} (90%)
>  delete mode 100644 Documentation/s390/Debugging390.txt
>  rename Documentation/s390/{cds.txt => cds.rst} (64%)
>  rename Documentation/s390/{CommonIO => common_io.rst} (87%)
>  rename Documentation/s390/{DASD => dasd.rst} (92%)
>  create mode 100644 Documentation/s390/debugging390.rst
>  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} (88%)
>  rename Documentation/s390/{zfcpdump.txt => zfcpdump.rst} (97%)
>  rename Documentation/scheduler/{completion.txt => completion.rst} (94%)
>  create mode 100644 Documentation/scheduler/index.rst
>  rename Documentation/scheduler/{sched-arch.txt => sched-arch.rst} (81%)
>  rename Documentation/scheduler/{sched-bwc.txt => sched-bwc.rst} (90%)
>  rename Documentation/scheduler/{sched-deadline.txt => sched-deadline.rst} (88%)
>  rename Documentation/scheduler/{sched-design-CFS.txt => sched-design-CFS.rst} (97%)
>  rename Documentation/scheduler/{sched-domains.txt => sched-domains.rst} (97%)
>  rename Documentation/scheduler/{sched-energy.txt => sched-energy.rst} (96%)
>  rename Documentation/scheduler/{sched-nice-design.txt => sched-nice-design.rst} (98%)
>  rename Documentation/scheduler/{sched-rt-group.txt => sched-rt-group.rst} (95%)
>  rename Documentation/scheduler/{sched-stats.txt => sched-stats.rst} (91%)
>  create mode 100644 Documentation/scheduler/text_files.rst
>  rename Documentation/security/tpm/{xen-tpmfront.txt => xen-tpmfront.rst} (66%)
>  rename Documentation/serial/{README.cycladesZ => cyclades_z.rst} (85%)
>  rename Documentation/serial/{driver => driver.rst} (92%)
>  create mode 100644 Documentation/serial/index.rst
>  delete mode 100644 Documentation/serial/moxa-smartio
>  create mode 100644 Documentation/serial/moxa-smartio.rst
>  create mode 100644 Documentation/serial/n_gsm.rst
>  delete mode 100644 Documentation/serial/n_gsm.txt
>  rename Documentation/serial/{rocket.txt => rocket.rst} (68%)
>  rename Documentation/serial/{serial-iso7816.txt => serial-iso7816.rst} (85%)
>  rename Documentation/serial/{serial-rs485.txt => serial-rs485.rst} (89%)
>  rename Documentation/serial/{tty.txt => tty.rst} (74%)
>  rename Documentation/{sgi-ioc4.txt => sgi-ioc4.rst} (99%)
>  rename Documentation/{siphash.txt => siphash.rst} (99%)
>  rename Documentation/{smsc_ece1099.txt => smsc_ece1099.rst} (99%)
>  rename Documentation/sparc/{adi.txt => adi.rst} (70%)
>  rename Documentation/sparc/{console.txt => console.rst} (53%)
>  create mode 100644 Documentation/sparc/index.rst
>  rename Documentation/sparc/oradax/{oracle-dax.txt => oracle-dax.rst} (95%)
>  rename Documentation/{speculation.txt => speculation.rst} (99%)
>  rename Documentation/{static-keys.txt => static-keys.rst} (99%)
>  rename Documentation/{svga.txt => svga.rst} (99%)
>  rename Documentation/{switchtec.txt => switchtec.rst} (98%)
>  rename Documentation/{sync_file.txt => sync_file.rst} (99%)
>  create mode 100644 Documentation/sysctl/abi.rst
>  delete mode 100644 Documentation/sysctl/abi.txt
>  rename Documentation/sysctl/{fs.txt => fs.rst} (77%)
>  rename Documentation/sysctl/{README => index.rst} (78%)
>  rename Documentation/sysctl/{kernel.txt => kernel.rst} (79%)
>  rename Documentation/sysctl/{net.txt => net.rst} (85%)
>  rename Documentation/sysctl/{sunrpc.txt => sunrpc.rst} (62%)
>  rename Documentation/sysctl/{user.txt => user.rst} (77%)
>  rename Documentation/sysctl/{vm.txt => vm.rst} (84%)
>  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/{tee.txt => tee.rst} (99%)
>  rename Documentation/thermal/{cpu-cooling-api.txt => cpu-cooling-api.rst} (82%)
>  rename Documentation/thermal/{exynos_thermal => exynos_thermal.rst} (67%)
>  delete mode 100644 Documentation/thermal/exynos_thermal_emulation
>  create mode 100644 Documentation/thermal/exynos_thermal_emulation.rst
>  create mode 100644 Documentation/thermal/index.rst
>  rename Documentation/thermal/{intel_powerclamp.txt => intel_powerclamp.rst} (76%)
>  rename Documentation/thermal/{nouveau_thermal => nouveau_thermal.rst} (64%)
>  rename Documentation/thermal/{power_allocator.txt => power_allocator.rst} (74%)
>  rename Documentation/thermal/{sysfs-api.txt => sysfs-api.rst} (66%)
>  rename Documentation/thermal/{x86_pkg_temperature_thermal => x86_pkg_temperature_thermal.rst} (80%)
>  rename Documentation/{this_cpu_ops.txt => this_cpu_ops.rst} (99%)
>  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%)
>  rename Documentation/{unaligned-memory-access.txt => unaligned-memory-access.rst} (99%)
>  rename Documentation/{vfio-mediated-device.txt => vfio-mediated-device.rst} (99%)
>  rename Documentation/{vfio.txt => vfio.rst} (99%)
>  rename Documentation/{video-output.txt => video-output.rst} (99%)
>  rename Documentation/watchdog/{convert_drivers_to_kernel_api.txt => convert_drivers_to_kernel_api.rst} (75%)
>  rename Documentation/watchdog/{hpwdt.txt => hpwdt.rst} (77%)
>  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/xilinx/{eemi.txt => eemi.rst} (92%)
>  create mode 100644 Documentation/xilinx/index.rst
>  rename Documentation/{xillybus.txt => xillybus.rst} (99%)
>  rename Documentation/xtensa/{atomctl.txt => atomctl.rst} (81%)
>  rename Documentation/xtensa/{booting.txt => booting.rst} (91%)
>  create mode 100644 Documentation/xtensa/index.rst
>  create mode 100644 Documentation/xtensa/mmu.rst
>  delete mode 100644 Documentation/xtensa/mmu.txt
>  rename Documentation/{xz.txt => xz.rst} (99%)
>  rename Documentation/{zorro.txt => zorro.rst} (99%)

Ah, I forgot to mention on this description: the conversions were
hand-made (except for one or two exceptions where I wrote small scripts
to help on some specific patches - explicitly mentioned).

In order to fix the broken documentation links, after the
changes, I used the enclosed script. It basically detects
renames and run a loop to fix all occurrences of such renames.

It doesn't work 100% - as it only works when the changes of the file
is smaller than 50% of the file - with is the default logic for
git merge detection. Yet, that saves a lot of time when adjusting
the renames. I used it together with ./scripts/documentation-file-ref-check
in order to double-check if all references to renamed files
were properly addressed.

Thanks,
Mauro

--

#!/bin/perl
use strict;

open IN,"git show|";

my $from;

while(<IN>) {
	if (m/rename from (\S.*)/) {
		die "Error: two froms!" if ($from ne "");
		$from = $1;
		next;
	}
	if (m/rename to (\S.*)/) {
		die "Error: no from!" if ($from eq "");

		my $cmd = "for i in \$(git grep -l $from); do sed s,$from,$1,g -i \$i; done";
		$from = "";
		print "$cmd\n";
		qx($cmd);
	}
}