Skip to contentSkip to conversation

"staging" area for unsorted random files under Documentation/*.rst

PATCH Mauro Carvalho Chehab 3 participants 5 messages Feb 18, 2020 – Feb 22, 2020 Documentation

lore
Share & tools
lore
#0 lore raw

Hi Jon,

We already discussed this matter previously, but we end not doing any changes yet.

I'm about to finish the conversion of the remaining text files to ReST. Skipping translations and a few exceptions, after my patch series (pending merge), there are now only ~50 remaining files[1].

Yet, we still have ~80 files already converted but not renamed, as Documentation/*.txt files.

Shifting those around is not easy (I tried a few times), as some discussions are required in order to get them at their rightful places.

So, my current proposal is to just rename them to *.rst, keeping them where they are, and adding them into an "staging" area at the main index.rst. See the enclosed patch.

Then, once we finish the conversion, we may come up with some patches moving them to better places.

What do you think?

[1] considering my tree (based on next-20200217) at:

https://git.linuxtv.org/mchehab/experimental.git/log/?h=all_docs_merged

HTML output: https://www.infradead.org/~mchehab/kernel_docs/

And running this small script that should get rid of (most) false positives:

$ dirname $(find Documentation/ -type f|grep -vE '\.(rst|svg|dot|py|awk|sh|pl|gitignore|S|yaml|c|inf|vim|modes)'|grep -vE '(Makefile|Kconfig|LICENSE|COPYING-logo|ChangeLog|CREDITS)'|grep -v devicetree/bindings|grep -vE 'Documentation/(ABI|features|output|SubmittingPatches|CodingStyle|logo.gif|dontdiff|sphinx/requirements.txt|admin-guide/kdump/gdbmacros.txt|admin-guide/aoe/udev.txt|EDID/hex|netlabel/draft-ietf-cipso-ipsecurity-01.txt|firmware_class/hotplug-script|target/target-export-device|networking/mac80211-auth-assoc-deauth.txt|sparc/oradax/dax-hv-api.txt)'|grep -v translations)|sort|uniq -c|sort -n
$ echo -n "Total: "
$ dirname $(find Documentation/ -type f|grep -vE '\.(rst|svg|dot|py|awk|sh|pl|gitignore|S|yaml|c|inf|vim|modes)'|grep -vE '(Makefile|Kconfig|LICENSE|COPYING-logo|ChangeLog|CREDITS)'|grep -v devicetree/bindings|grep -vE 'Documentation/(ABI|features|output|SubmittingPatches|CodingStyle|logo.gif|dontdiff|sphinx/requirements.txt|admin-guide/kdump/gdbmacros.txt|admin-guide/aoe/udev.txt|EDID/hex|netlabel/draft-ietf-cipso-ipsecurity-01.txt|firmware_class/hotplug-script|target/target-export-device|networking/mac80211-auth-assoc-deauth.txt|sparc/oradax/dax-hv-api.txt)'|grep -v translations)|wc -l

1 Documentation/filesystems/cifs
1 Documentation/filesystems/configfs
1 Documentation/scsi
1 Documentation/virt/kvm/devices
2 Documentation/admin-guide
3 Documentation
6 Documentation/devicetree
6 Documentation/filesystems/caching
8 Documentation/RCU
21 Documentation/filesystems
Total: 50

Once we get this series merged, I'm planning to prepare and submit a second series doing the conversion for the other ~20 filesystem files.

Btw, if you want to look how things will become after my patch series, I'm keeping a html build after all my patch series at:

https://www.infradead.org/~mchehab/kernel_docs/

Cheers,
Mauro

docs: place random ReST files at the index.rst

There are several ReST documents that are currently at the main Documentation/ directory, with .txt extension.

That's bad, because:

- It is a bad example: people keep adding new .txt files inside Documentation/;
- Any efforts of detecting files that still require conversion would need to explicitly exclude those.

While not ideal, for now let's just place those files on some place inside index.rst. We can later move them to other places.

Documentation/index.rst +47 -0
index e99d0bd2589d..9a512600c95c 100644
@@ -186,6 +186,53 @@ Translations
 
    translations/index
 
+Unsorted random documents
+-------------------------
+
+.. toctree::
+   :maxdepth: 2
+
+   DMA-API
+   DMA-API-HOWTO
+   DMA-ISA-LPC
+   DMA-attributes
+   IPMI
+   IRQ
+   IRQ-affinity
+   IRQ-domain
+   bus-virt-phys-mapping
+   crc32
+   debugging-modules
+   debugging-via-ohci1394
+   digsig
+   futex-requeue-pi
+   hwspinlock
+   io-mapping
+   io_ordering
+   irqflags-tracing
+   kobject
+   kprobes
+   kref
+   lzo
+   mailbox
+   nommu-mmap
+   percpu-rw-semaphore
+   pi-futex
+   preempt-locking
+   rbtree
+   remoteproc
+   robust-futex-ABI
+   robust-futexes
+   rpmsg
+   speculation
+   static-keys
+   tee
+   this_cpu_ops
+   unaligned-memory-access
+   watch_queue
+   xz
+
+
 Indices and tables
 ==================
 
Documentation/DMA-API-HOWTO.rst renamed from Documentation/DMA-API-HOWTO.txt +0 -0
similarity index 100%
rename from Documentation/DMA-API-HOWTO.txt
rename to Documentation/DMA-API-HOWTO.rst
Documentation/DMA-API.rst renamed from Documentation/DMA-API.txt +0 -0
similarity index 100%
rename from Documentation/DMA-API.txt
rename to Documentation/DMA-API.rst
Documentation/DMA-ISA-LPC.rst renamed from Documentation/DMA-ISA-LPC.txt +0 -0
similarity index 100%
rename from Documentation/DMA-ISA-LPC.txt
rename to Documentation/DMA-ISA-LPC.rst
Documentation/DMA-attributes.rst renamed from Documentation/DMA-attributes.txt +0 -0
similarity index 100%
rename from Documentation/DMA-attributes.txt
rename to Documentation/DMA-attributes.rst
Documentation/IPMI.rst renamed from Documentation/IPMI.txt +0 -0
similarity index 100%
rename from Documentation/IPMI.txt
rename to Documentation/IPMI.rst
Documentation/IRQ-affinity.rst renamed from Documentation/IRQ-affinity.txt +0 -0
similarity index 100%
rename from Documentation/IRQ-affinity.txt
rename to Documentation/IRQ-affinity.rst
Documentation/IRQ-domain.rst renamed from Documentation/IRQ-domain.txt +0 -0
similarity index 100%
rename from Documentation/IRQ-domain.txt
rename to Documentation/IRQ-domain.rst
Documentation/IRQ.rst renamed from Documentation/IRQ.txt +0 -0
similarity index 100%
rename from Documentation/IRQ.txt
rename to Documentation/IRQ.rst
Documentation/bus-virt-phys-mapping.rst renamed from Documentation/bus-virt-phys-mapping.txt +0 -0
similarity index 100%
rename from Documentation/bus-virt-phys-mapping.txt
rename to Documentation/bus-virt-phys-mapping.rst
Documentation/crc32.rst renamed from Documentation/crc32.txt +0 -0
similarity index 100%
rename from Documentation/crc32.txt
rename to Documentation/crc32.rst
Documentation/debugging-modules.rst renamed from Documentation/debugging-modules.txt +0 -0
similarity index 100%
rename from Documentation/debugging-modules.txt
rename to Documentation/debugging-modules.rst
Documentation/debugging-via-ohci1394.rst renamed from Documentation/debugging-via-ohci1394.txt +0 -0
similarity index 100%
rename from Documentation/debugging-via-ohci1394.txt
rename to Documentation/debugging-via-ohci1394.rst
Documentation/digsig.rst renamed from Documentation/digsig.txt +0 -0
similarity index 100%
rename from Documentation/digsig.txt
rename to Documentation/digsig.rst
Documentation/futex-requeue-pi.rst renamed from Documentation/futex-requeue-pi.txt +0 -0
similarity index 100%
rename from Documentation/futex-requeue-pi.txt
rename to Documentation/futex-requeue-pi.rst
Documentation/hwspinlock.rst renamed from Documentation/hwspinlock.txt +0 -0
similarity index 100%
rename from Documentation/hwspinlock.txt
rename to Documentation/hwspinlock.rst
Documentation/io-mapping.rst renamed from Documentation/io-mapping.txt +0 -0
similarity index 100%
rename from Documentation/io-mapping.txt
rename to Documentation/io-mapping.rst
Documentation/io_ordering.rst renamed from Documentation/io_ordering.txt +0 -0
similarity index 100%
rename from Documentation/io_ordering.txt
rename to Documentation/io_ordering.rst
Documentation/irqflags-tracing.rst renamed from Documentation/irqflags-tracing.txt +0 -0
similarity index 100%
rename from Documentation/irqflags-tracing.txt
rename to Documentation/irqflags-tracing.rst
Documentation/kobject.rst renamed from Documentation/kobject.txt +0 -0
similarity index 100%
rename from Documentation/kobject.txt
rename to Documentation/kobject.rst
Documentation/kprobes.rst renamed from Documentation/kprobes.txt +0 -0
similarity index 100%
rename from Documentation/kprobes.txt
rename to Documentation/kprobes.rst
Documentation/kref.rst renamed from Documentation/kref.txt +0 -0
similarity index 100%
rename from Documentation/kref.txt
rename to Documentation/kref.rst
Documentation/lzo.rst renamed from Documentation/lzo.txt +0 -0
similarity index 100%
rename from Documentation/lzo.txt
rename to Documentation/lzo.rst
Documentation/mailbox.rst renamed from Documentation/mailbox.txt +0 -0
similarity index 100%
rename from Documentation/mailbox.txt
rename to Documentation/mailbox.rst
Documentation/nommu-mmap.rst renamed from Documentation/nommu-mmap.txt +0 -0
similarity index 100%
rename from Documentation/nommu-mmap.txt
rename to Documentation/nommu-mmap.rst
Documentation/percpu-rw-semaphore.rst renamed from Documentation/percpu-rw-semaphore.txt +0 -0
similarity index 100%
rename from Documentation/percpu-rw-semaphore.txt
rename to Documentation/percpu-rw-semaphore.rst
Documentation/pi-futex.rst renamed from Documentation/pi-futex.txt +0 -0
similarity index 100%
rename from Documentation/pi-futex.txt
rename to Documentation/pi-futex.rst
Documentation/preempt-locking.rst renamed from Documentation/preempt-locking.txt +0 -0
similarity index 100%
rename from Documentation/preempt-locking.txt
rename to Documentation/preempt-locking.rst
Documentation/rbtree.rst renamed from Documentation/rbtree.txt +0 -0
similarity index 100%
rename from Documentation/rbtree.txt
rename to Documentation/rbtree.rst
Documentation/remoteproc.rst renamed from Documentation/remoteproc.txt +0 -0
similarity index 100%
rename from Documentation/remoteproc.txt
rename to Documentation/remoteproc.rst
Documentation/robust-futex-ABI.rst renamed from Documentation/robust-futex-ABI.txt +0 -0
similarity index 100%
rename from Documentation/robust-futex-ABI.txt
rename to Documentation/robust-futex-ABI.rst
Documentation/robust-futexes.rst renamed from Documentation/robust-futexes.txt +0 -0
similarity index 100%
rename from Documentation/robust-futexes.txt
rename to Documentation/robust-futexes.rst
Documentation/rpmsg.rst renamed from Documentation/rpmsg.txt +0 -0
similarity index 100%
rename from Documentation/rpmsg.txt
rename to Documentation/rpmsg.rst
Documentation/speculation.rst renamed from Documentation/speculation.txt +0 -0
similarity index 100%
rename from Documentation/speculation.txt
rename to Documentation/speculation.rst
Documentation/static-keys.rst renamed from Documentation/static-keys.txt +0 -0
similarity index 100%
rename from Documentation/static-keys.txt
rename to Documentation/static-keys.rst
Documentation/tee.rst renamed from Documentation/tee.txt +0 -0
similarity index 100%
rename from Documentation/tee.txt
rename to Documentation/tee.rst
Documentation/this_cpu_ops.rst renamed from Documentation/this_cpu_ops.txt +0 -0
similarity index 100%
rename from Documentation/this_cpu_ops.txt
rename to Documentation/this_cpu_ops.rst
Documentation/unaligned-memory-access.rst renamed from Documentation/unaligned-memory-access.txt +0 -0
similarity index 100%
rename from Documentation/unaligned-memory-access.txt
rename to Documentation/unaligned-memory-access.rst
Documentation/xz.rst renamed from Documentation/xz.txt +0 -0
similarity index 100%
rename from Documentation/xz.txt
rename to Documentation/xz.rst
#1 lore raw
Quoted 6 lines · Mauro Carvalho Chehab

Shifting those around is not easy (I tried a few times), as some discussions are required in order to get them at their rightful places.

So, my current proposal is to just rename them to *.rst, keeping them where they are, and adding them into an "staging" area at the main index.rst. See the enclosed patch.

The obligatory bikeshedding comment, how about adding an actual "staging" directory under Documentation, perhaps with an index.rst of its own?

Personally I don't really mind having .txt files around either, just *not* at the top level Documentation directory.

BR,
Jani.

Signature · 1 line
Jani Nikula, Intel Open Source Graphics Center
maintainer
#2 lore raw
Quoted 11 lines · On Tue, 18 Feb 2020 14:26:14 +0200 Jani Nikula <[email protected]>…
Quoted 6 lines · Mauro Carvalho Chehab

Shifting those around is not easy (I tried a few times), as some discussions are required in order to get them at their rightful places.

So, my current proposal is to just rename them to *.rst, keeping them where they are, and adding them into an "staging" area at the main index.rst. See the enclosed patch.

The obligatory bikeshedding comment, how about adding an actual "staging" directory under Documentation, perhaps with an index.rst of its own?

I kind of agree, actually. If we absolutely must create a trashpile of random documents, the top-level directory seems like the worst place for it. Let's hide our shame rather than rubbing everybody's nose in it.

Quoted 2 lines

Personally I don't really mind having .txt files around either, just *not* at the top level Documentation directory.

In general, RST conversion is not my highest priority at this point. There is only so much value in creating a more nicely formatted version of an unorganized heap of obsolete documentation. Hopefully we get get a bit more focus on quality once this is all behind us...

Thanks,

jon

#3 lore raw

Em Wed, 19 Feb 2020 02:29:51 -0700
Jonathan Corbet <[email protected]> escreveu:

Quoted 11 lines
Quoted 8 lines · On Tue, 18 Feb 2020 14:26:14 +0200 Jani Nikula <[email protected]>…
Quoted 6 lines · Mauro Carvalho Chehab

Shifting those around is not easy (I tried a few times), as some discussions are required in order to get them at their rightful places.

So, my current proposal is to just rename them to *.rst, keeping them where they are, and adding them into an "staging" area at the main index.rst. See the enclosed patch.

Quoted 7 lines
Quoted 3 lines

The obligatory bikeshedding comment, how about adding an actual "staging" directory under Documentation, perhaps with an index.rst of its own?

I kind of agree, actually. If we absolutely must create a trashpile of random documents, the top-level directory seems like the worst place for it. Let's hide our shame rather than rubbing everybody's nose in it.

Ok. I'll prepare a patch creating a Documentation/staging and move those unsorted stuff into it.

I may try to do another attempt to move at least some of those unsorted documents to a better place before the final one that will place the remaining ones under staging/.

Quoted 4 lines
Quoted 2 lines

Personally I don't really mind having .txt files around either, just *not* at the top level Documentation directory.

In general, RST conversion is not my highest priority at this point.

Well, right now on my TODO list there are just ~20 files left to convert.

I'm excluding from my TODO a few exceptions like config files with .txt extensions and translations, plus a couple of text files whose previous conversion attempts generated heated discussions.

Quoted 3 lines

There is only so much value in creating a more nicely formatted version of an unorganized heap of obsolete documentation. Hopefully we get get a bit more focus on quality once this is all behind us...

Yeah, there's little value nicely formatting outdated stuff. However, having them converted make those docs more visible, which in turn helps to attract devels to send patches updating them.

The more important is that, once we get past this step, we can have a clearer view about what's left undocumented.

Cheers,
Mauro

#4 lore raw

Em Thu, 20 Feb 2020 06:29:34 +0100
Mauro Carvalho Chehab <[email protected]> escreveu:

Quoted 8 lines
Quoted 1 line

In general, RST conversion is not my highest priority at this point.

Well, right now on my TODO list there are just ~20 files left to convert.

I'm excluding from my TODO a few exceptions like config files with .txt extensions and translations, plus a couple of text files whose previous conversion attempts generated heated discussions.

Btw, finished the conversion yesterday. If you want to do a sneak pick, it is at:

https://git.linuxtv.org/mchehab/experimental.git/log/?h=all_docs_merged_v2

And the html output at:

https://www.infradead.org/~mchehab/kernel_docs/devicetree/

The series contain 285 patches. the diffstat is big, but lots of the things there are just fixing broken references due to .txt to .rst renames (see enclosed). The actual changes are at filesystems, networking, RCU, misc, devicetree (only the actual docs were touched), and on a few other random places.

Yeah, I know it will be painful to review and apply those. I already sent some of the patch series for review. I should be sending the remaining series along the next couple weeks.

Cheers,
Mauro

-

PS.: as you may notice, the rename RFC patch is applied here. This is just for helping me to check if I didn't miss anything. As I said, I won't be submitting it as-is.

Right now, the script I'm using to check what's missing conversion points to just a bunch of stuff:

$ ./nonconverted_docs.sh 
Documentation/memory-barriers.txt
Documentation/firmware_class/hotplug-script
Documentation/RCU/RTFP.bib
Documentation/networking/mac80211-auth-assoc-deauth.txt
Documentation/atomic_bitops.txt
Documentation/admin-guide/devices.txt
Documentation/admin-guide/kernel-parameters.txt
Documentation/target/target-export-device
Documentation/atomic_t.txt
Documentation/usb/CREDITS
Documentation/netlabel/draft-ietf-cipso-ipsecurity-01.txt
Documentation/virt/kvm/devices/README
Documentation/sparc/oradax/dax-hv-api.txt

Several of the above are false positives. For example, the IETF draft should probably be kept as-is (or removed in favor of a pointer to its URL inside the IETF site).

 Documentation/ABI/stable/sysfs-devices-node        |    2 +-
 Documentation/ABI/testing/procfs-smaps_rollup      |    2 +-
 .../{DMA-API-HOWTO.txt => DMA-API-HOWTO.rst}       |    0
 Documentation/{DMA-API.txt => DMA-API.rst}         |    6 +-
 Documentation/{DMA-ISA-LPC.txt => DMA-ISA-LPC.rst} |    2 +-
 .../{DMA-attributes.txt => DMA-attributes.rst}     |    0
 Documentation/{IPMI.txt => IPMI.rst}               |    0
 .../{IRQ-affinity.txt => IRQ-affinity.rst}         |    0
 Documentation/{IRQ-domain.txt => IRQ-domain.rst}   |    0
 Documentation/{IRQ.txt => IRQ.rst}                 |    0
 .../binding/{pci-test.txt => pci-test.rst}         |   33 +-
 Documentation/PCI/endpoint/index.rst               |    2 +
 Documentation/PCI/pci.rst                          |    8 +-
 Documentation/RCU/{RTFP.txt => RTFP.bib}           |  323 +--
 Documentation/RCU/RTFP.rst                         |  593 ++++++
 Documentation/RCU/{checklist.txt => checklist.rst} |   17 +-
 Documentation/RCU/index.rst                        |   11 +
 .../RCU/{lockdep-splat.txt => lockdep-splat.rst}   |  109 +-
 Documentation/RCU/{lockdep.txt => lockdep.rst}     |   12 +-
 Documentation/RCU/rcu.rst                          |    4 +-
 .../RCU/{rculist_nulls.txt => rculist_nulls.rst}   |  252 ++-
 Documentation/RCU/{rcuref.txt => rcuref.rst}       |  199 +-
 Documentation/RCU/{stallwarn.txt => stallwarn.rst} |   55 +-
 Documentation/RCU/{torture.txt => torture.rst}     |  117 +-
 Documentation/admin-guide/cpu-load.rst             |    2 +-
 Documentation/admin-guide/ext4.rst                 |    2 +-
 Documentation/admin-guide/hw-vuln/l1tf.rst         |    2 +-
 Documentation/admin-guide/kernel-parameters.txt    |   30 +-
 .../admin-guide/kernel-per-CPU-kthreads.rst        |    2 +-
 Documentation/admin-guide/nfs/nfsroot.rst          |    2 +-
 Documentation/admin-guide/serial-console.rst       |    2 +-
 Documentation/admin-guide/sysctl/kernel.rst        |    4 +-
 Documentation/admin-guide/sysctl/net.rst           |    4 +-
 Documentation/admin-guide/sysctl/vm.rst            |    2 +-
 Documentation/arm/booting.rst                      |    2 +-
 Documentation/arm/microchip.rst                    |    2 +-
 Documentation/arm64/index.rst                      |    1 +
 Documentation/arm64/{perf.txt => perf.rst}         |    7 +-
 Documentation/block/biodoc.rst                     |    2 +-
 Documentation/bpf/index.rst                        |    4 +-
 ...-phys-mapping.txt => bus-virt-phys-mapping.rst} |    2 +-
 .../{amd-powernow.txt => amd-powernow.rst}         |   12 +-
 Documentation/cpu-freq/{core.txt => core.rst}      |   65 +-
 .../cpu-freq/{cpu-drivers.txt => cpu-drivers.rst}  |  129 +-
 .../{cpufreq-nforce2.txt => cpufreq-nforce2.rst}   |   18 +-
 .../{cpufreq-stats.txt => cpufreq-stats.rst}       |  119 +-
 Documentation/cpu-freq/{index.txt => index.rst}    |   44 +-
 .../cpu-freq/{pcc-cpufreq.txt => pcc-cpufreq.rst}  |   92 +-
 Documentation/{crc32.txt => crc32.rst}             |    0
 .../crypto/{api-intro.txt => api-intro.rst}        |  186 +-
 .../{asymmetric-keys.txt => asymmetric-keys.rst}   |   91 +-
 .../crypto/{async-tx-api.txt => async-tx-api.rst}  |  255 ++-
 .../{descore-readme.txt => descore-readme.rst}     |  152 +-
 Documentation/crypto/index.rst                     |    5 +
 ...via-ohci1394.txt => debugging-via-ohci1394.rst} |    0
 .../devicetree/bindings/{ABI.txt => ABI.rst}       |    5 +-
 Documentation/devicetree/bindings/arm/amlogic.yaml |    2 +-
 Documentation/devicetree/bindings/arm/arm,scmi.txt |    2 +-
 Documentation/devicetree/bindings/arm/arm,scpi.txt |    2 +-
 .../devicetree/bindings/arm/bcm/brcm,bcm63138.txt  |    2 +-
 .../bindings/arm/hisilicon/hi3519-sysctrl.txt      |    2 +-
 .../bindings/arm/msm/qcom,idle-state.txt           |    2 +-
 Documentation/devicetree/bindings/arm/omap/mpu.txt |    2 +-
 Documentation/devicetree/bindings/arm/psci.yaml    |    2 +-
 Documentation/devicetree/bindings/arm/syna.txt     |    2 +-
 .../bindings/clock/qcom,gcc-apq8064.yaml           |    2 +-
 .../devicetree/bindings/display/tilcdc/tilcdc.txt  |    2 +-
 Documentation/devicetree/bindings/index.rst        |   12 +
 Documentation/devicetree/bindings/leds/common.yaml |    2 +-
 .../devicetree/bindings/leds/register-bit-led.txt  |    2 +-
 .../bindings/memory-controllers/ti/emif.txt        |    2 +-
 .../devicetree/bindings/misc/fsl,qoriq-mc.txt      |    2 +-
 .../bindings/pinctrl/aspeed,ast2400-pinctrl.yaml   |    2 +-
 .../bindings/pinctrl/aspeed,ast2500-pinctrl.yaml   |    2 +-
 .../bindings/pinctrl/aspeed,ast2600-pinctrl.yaml   |    2 +-
 .../bindings/power/amlogic,meson-ee-pwrc.yaml      |    2 +-
 .../devicetree/bindings/reset/st,stm32mp1-rcc.txt  |    2 +-
 ...bmitting-patches.txt => submitting-patches.rst} |   12 +-
 .../bindings/thermal/brcm,avs-ro-thermal.yaml      |    2 +-
 .../{writing-bindings.txt => writing-bindings.rst} |    9 +-
 ...oting-without-of.txt => booting-without-of.rst} |  303 +--
 .../devicetree/{changesets.txt => changesets.rst}  |   24 +-
 ...tion-notes.txt => dynamic-resolution-notes.rst} |    5 +-
 Documentation/devicetree/index.rst                 |   18 +
 .../{of_unittest.txt => of_unittest.rst}           |  192 +-
 .../{overlay-notes.txt => overlay-notes.rst}       |  143 +-
 .../{usage-model.txt => usage-model.rst}           |   35 +-
 Documentation/devicetree/writing-schema.rst        |    9 +-
 Documentation/{digsig.txt => digsig.rst}           |    0
 Documentation/doc-guide/maintainer-profile.rst     |    2 +-
 Documentation/driver-api/dmaengine/client.rst      |    2 +-
 Documentation/driver-api/dmaengine/provider.rst    |    2 +-
 Documentation/driver-api/driver-model/device.rst   |    4 +-
 Documentation/driver-api/driver-model/overview.rst |    2 +-
 Documentation/driver-api/libata.rst                |    2 +-
 .../driver-api/thermal/cpu-idle-cooling.rst        |   18 +-
 Documentation/driver-api/thermal/index.rst         |    1 +
 Documentation/driver-api/usb/dma.rst               |    6 +-
 Documentation/filesystems/{9p.txt => 9p.rst}       |  114 +-
 Documentation/filesystems/{adfs.txt => adfs.rst}   |   29 +-
 Documentation/filesystems/{affs.txt => affs.rst}   |   62 +-
 Documentation/filesystems/{afs.txt => afs.rst}     |   75 +-
 ...-mount-control.txt => autofs-mount-control.rst} |  108 +-
 ...automount-support.txt => automount-support.rst} |   23 +-
 Documentation/filesystems/{befs.txt => befs.rst}   |   59 +-
 Documentation/filesystems/{bfs.txt => bfs.rst}     |   37 +-
 Documentation/filesystems/{btrfs.txt => btrfs.rst} |    3 +
 .../caching/{backend-api.txt => backend-api.rst}   |  165 +-
 .../caching/{cachefiles.txt => cachefiles.rst}     |  139 +-
 .../caching/{fscache.txt => fscache.rst}           |  439 ++--
 Documentation/filesystems/caching/index.rst        |   14 +
 .../caching/{netfs-api.txt => netfs-api.rst}       |  172 +-
 .../filesystems/caching/{object.txt => object.rst} |   43 +-
 .../caching/{operations.txt => operations.rst}     |   45 +-
 Documentation/filesystems/{ceph.txt => ceph.rst}   |   26 +-
 .../cifs/{cifsroot.txt => cifsroot.rst}            |   58 +-
 Documentation/filesystems/{coda.txt => coda.rst}   | 1556 +++++++-------
 .../{configfs/configfs.txt => configfs.rst}        |  129 +-
 .../filesystems/{cramfs.txt => cramfs.rst}         |   19 +-
 Documentation/filesystems/{dax.txt => dax.rst}     |   11 +-
 .../filesystems/{debugfs.txt => debugfs.rst}       |   54 +-
 .../filesystems/{devpts.txt => devpts.rst}         |   40 +-
 Documentation/filesystems/{dlmfs.txt => dlmfs.rst} |   28 +-
 .../filesystems/{dnotify.txt => dnotify.rst}       |   13 +-
 .../filesystems/{ecryptfs.txt => ecryptfs.rst}     |   44 +-
 .../filesystems/{efivarfs.txt => efivarfs.rst}     |    5 +-
 Documentation/filesystems/{erofs.txt => erofs.rst} |  177 +-
 Documentation/filesystems/{ext2.txt => ext2.rst}   |   43 +-
 Documentation/filesystems/{ext3.txt => ext3.rst}   |    2 +
 Documentation/filesystems/{f2fs.txt => f2fs.rst}   |  254 ++-
 .../filesystems/{fiemap.txt => fiemap.rst}         |  131 +-
 Documentation/filesystems/{files.txt => files.rst} |   15 +-
 .../filesystems/{fuse-io.txt => fuse-io.rst}       |    6 +
 .../{gfs2-glocks.txt => gfs2-glocks.rst}           |  149 +-
 .../{gfs2-uevents.txt => gfs2-uevents.rst}         |   20 +-
 Documentation/filesystems/{gfs2.txt => gfs2.rst}   |   20 +-
 Documentation/filesystems/{hfs.txt => hfs.rst}     |   23 +-
 .../filesystems/{hfsplus.txt => hfsplus.rst}       |    2 +
 Documentation/filesystems/{hpfs.txt => hpfs.rst}   |  239 ++-
 Documentation/filesystems/index.rst                |   72 +-
 .../filesystems/{inotify.txt => inotify.rst}       |   33 +-
 Documentation/filesystems/{isofs.txt => isofs.rst} |   72 +-
 Documentation/filesystems/{locks.txt => locks.rst} |   14 +-
 ...mandatory-locking.txt => mandatory-locking.rst} |   25 +-
 .../filesystems/{mount_api.txt => mount_api.rst}   |  329 ++-
 .../filesystems/{nilfs2.txt => nilfs2.rst}         |   40 +-
 Documentation/filesystems/{ntfs.txt => ntfs.rst}   |  145 +-
 ...ne-filecheck.txt => ocfs2-online-filecheck.rst} |   45 +-
 Documentation/filesystems/{ocfs2.txt => ocfs2.rst} |   31 +-
 Documentation/filesystems/{omfs.txt => omfs.rst}   |   98 +-
 .../filesystems/{orangefs.txt => orangefs.rst}     |  187 +-
 .../{path-lookup.txt => path-walking.rst}          |   90 +-
 Documentation/filesystems/porting.rst              |    2 +-
 Documentation/filesystems/{proc.txt => proc.rst}   | 1546 +++++++-------
 Documentation/filesystems/{qnx6.txt => qnx6.rst}   |   22 +
 Documentation/filesystems/{quota.txt => quota.rst} |   41 +-
 ...fs-initramfs.txt => ramfs-rootfs-initramfs.rst} |   56 +-
 Documentation/filesystems/{relay.txt => relay.rst} |  139 +-
 Documentation/filesystems/{romfs.txt => romfs.rst} |   42 +-
 .../filesystems/{seq_file.txt => seq_file.rst}     |   61 +-
 .../{sharedsubtree.txt => sharedsubtree.rst}       |  398 ++--
 Documentation/filesystems/spufs/index.rst          |   13 +
 Documentation/filesystems/spufs/spu_create.rst     |  131 ++
 Documentation/filesystems/spufs/spu_run.rst        |  138 ++
 .../filesystems/{spufs.txt => spufs/spufs.rst}     |  304 +--
 .../filesystems/{squashfs.txt => squashfs.rst}     |   60 +-
 .../filesystems/{sysfs-pci.txt => sysfs-pci.rst}   |   23 +-
 .../{sysfs-tagging.txt => sysfs-tagging.rst}       |   22 +-
 Documentation/filesystems/{sysfs.txt => sysfs.rst} |  326 +--
 .../filesystems/{sysv-fs.txt => sysv-fs.rst}       |  153 +-
 Documentation/filesystems/{tmpfs.txt => tmpfs.rst} |   44 +-
 Documentation/filesystems/ubifs-authentication.rst |   10 +-
 Documentation/filesystems/{ubifs.txt => ubifs.rst} |   25 +-
 Documentation/filesystems/{udf.txt => udf.rst}     |   21 +-
 ...g-design.txt => xfs-delayed-logging-design.rst} |   65 +-
 ...tadata.txt => xfs-self-describing-metadata.rst} |  190 +-
 .../filesystems/{zonefs.txt => zonefs.rst}         |  108 +-
 .../{futex-requeue-pi.txt => futex-requeue-pi.rst} |    0
 Documentation/gpu/drm-mm.rst                       |    2 +-
 Documentation/gpu/i915.rst                         |    4 +-
 Documentation/hwmon/adm1177.rst                    |    3 +-
 Documentation/{hwspinlock.txt => hwspinlock.rst}   |    0
 Documentation/ia64/irq-redir.rst                   |    2 +-
 Documentation/iio/iio_configfs.rst                 |    2 +-
 Documentation/index.rst                            |   52 +
 Documentation/{io-mapping.txt => io-mapping.rst}   |    0
 Documentation/{io_ordering.txt => io_ordering.rst} |    0
 .../{irqflags-tracing.txt => irqflags-tracing.rst} |    0
 Documentation/{kobject.txt => kobject.rst}         |    2 +-
 Documentation/{kprobes.txt => kprobes.rst}         |    0
 Documentation/{kref.txt => kref.rst}               |    0
 Documentation/locking/locktorture.rst              |    2 +-
 Documentation/locking/rt-mutex.rst                 |    2 +-
 Documentation/{lzo.txt => lzo.rst}                 |    0
 Documentation/{mailbox.txt => mailbox.rst}         |    0
 Documentation/memory-barriers.txt                  |    8 +-
 .../{ad525x_dpot.txt => ad525x_dpot.rst}           |   24 +-
 .../misc-devices/{apds990x.txt => apds990x.rst}    |   31 +-
 .../misc-devices/{bh1770glc.txt => bh1770glc.rst}  |   45 +-
 .../misc-devices/{c2port.txt => c2port.rst}        |   58 +-
 Documentation/misc-devices/index.rst               |    6 +
 ...pci-endpoint-test.txt => pci-endpoint-test.rst} |   65 +-
 ...spear-pcie-gadget.txt => spear-pcie-gadget.rst} |  176 +-
 .../networking/{6lowpan.txt => 6lowpan.rst}        |   29 +-
 Documentation/networking/{6pack.txt => 6pack.rst}  |   46 +-
 .../networking/{altera_tse.txt => altera_tse.rst}  |   89 +-
 .../{arcnet-hardware.txt => arcnet-hardware.rst}   | 2227 ++++++++++----------
 .../networking/{arcnet.txt => arcnet.rst}          |  348 +--
 Documentation/networking/{atm.txt => atm.rst}      |    6 +
 Documentation/networking/{ax25.txt => ax25.rst}    |    6 +
 .../networking/{baycom.txt => baycom.rst}          |  120 +-
 .../networking/{bonding.txt => bonding.rst}        | 1317 ++++++------
 Documentation/networking/caif/caif.rst             |    2 -
 Documentation/networking/caif/index.rst            |   13 +
 .../caif/{Linux-CAIF.txt => linux_caif.rst}        |   54 +-
 .../caif/{spi_porting.txt => spi_porting.rst}      |  291 +--
 Documentation/networking/can.rst                   |    2 +-
 .../networking/{cdc_mbim.txt => cdc_mbim.rst}      |   76 +-
 Documentation/networking/checksum-offloads.rst     |    2 +-
 Documentation/networking/{cops.txt => cops.rst}    |   77 +-
 .../networking/{cxacru.txt => cxacru.rst}          |   86 +-
 Documentation/networking/{dccp.txt => dccp.rst}    |   39 +-
 Documentation/networking/{dctcp.txt => dctcp.rst}  |   14 +-
 .../networking/{decnet.txt => decnet.rst}          |   77 +-
 Documentation/networking/{defza.txt => defza.rst}  |    8 +-
 .../device_drivers/3com/{3c509.txt => 3c509.rst}   |  162 +-
 .../device_drivers/3com/{vortex.txt => vortex.rst} |  227 +-
 .../device_drivers/amazon/{ena.txt => ena.rst}     |  144 +-
 .../aquantia/{atlantic.txt => atlantic.rst}        |  369 ++--
 .../device_drivers/chelsio/{cxgb.txt => cxgb.rst}  |  183 +-
 .../cirrus/{cs89x0.txt => cs89x0.rst}              |  559 ++---
 .../davicom/{dm9000.txt => dm9000.rst}             |   24 +-
 .../device_drivers/dec/{de4x5.txt => de4x5.rst}    |  105 +-
 .../device_drivers/dec/{dmfe.txt => dmfe.rst}      |   35 +-
 .../device_drivers/dlink/{dl2k.txt => dl2k.rst}    |  228 +-
 .../freescale/{dpaa.txt => dpaa.rst}               |  141 +-
 .../freescale/{gianfar.txt => gianfar.rst}         |   21 +-
 Documentation/networking/device_drivers/index.rst  |   24 +
 .../networking/device_drivers/intel/e100.rst       |    2 +-
 .../intel/{ipw2100.txt => ipw2100.rst}             |  240 ++-
 .../intel/{ipw2200.txt => ipw2200.rst}             |  414 ++--
 .../networking/device_drivers/intel/ixgb.rst       |    2 +-
 .../microsoft/{netvsc.txt => netvsc.rst}           |   57 +-
 .../device_drivers/neterion/{s2io.txt => s2io.rst} |  213 +-
 .../device_drivers/neterion/{vxge.txt => vxge.rst} |   60 +-
 .../qualcomm/{rmnet.txt => rmnet.rst}              |   43 +-
 .../device_drivers/{sb1000.txt => sb1000.rst}      |  331 +--
 .../device_drivers/smsc/{smc9.txt => smc9.rst}     |   47 +-
 .../networking/device_drivers/ti/cpsw.rst          |  587 ++++++
 .../networking/device_drivers/ti/cpsw.txt          |  541 -----
 .../ti/{cpsw_switchdev.txt => cpsw_switchdev.rst}  |  243 ++-
 .../device_drivers/ti/{tlan.txt => tlan.rst}       |   73 +-
 .../toshiba/{spider_net.txt => spider_net.rst}     |   60 +-
 .../{dns_resolver.txt => dns_resolver.rst}         |   52 +-
 .../networking/{driver.txt => driver.rst}          |   22 +-
 Documentation/networking/{eql.txt => eql.rst}      |  443 ++--
 .../networking/{fib_trie.txt => fib_trie.rst}      |   16 +-
 .../networking/{filter.txt => filter.rst}          |  868 ++++----
 .../networking/{fore200e.txt => fore200e.rst}      |    8 +-
 .../networking/{framerelay.txt => framerelay.rst}  |   21 +-
 .../networking/{gen_stats.txt => gen_stats.rst}    |   98 +-
 .../{generic-hdlc.txt => generic-hdlc.rst}         |   86 +-
 .../{generic_netlink.txt => generic_netlink.rst}   |    6 +
 Documentation/networking/{gtp.txt => gtp.rst}      |   97 +-
 Documentation/networking/{hinic.txt => hinic.rst}  |    5 +-
 Documentation/networking/{ila.txt => ila.rst}      |   89 +-
 Documentation/networking/index.rst                 |   88 +
 .../networking/{ip-sysctl.txt => ip-sysctl.rst}    |  834 +++++---
 .../networking/{ip_dynaddr.txt => ip_dynaddr.rst}  |   29 +-
 Documentation/networking/{ipddp.txt => ipddp.rst}  |   13 +-
 .../networking/{iphase.txt => iphase.rst}          |  187 +-
 Documentation/networking/{ipsec.txt => ipsec.rst}  |   14 +-
 Documentation/networking/{ipv6.txt => ipv6.rst}    |    8 +-
 .../networking/{ipvlan.txt => ipvlan.rst}          |  159 +-
 .../{ipvs-sysctl.txt => ipvs-sysctl.rst}           |  188 +-
 Documentation/networking/{kcm.txt => kcm.rst}      |   85 +-
 Documentation/networking/{l2tp.txt => l2tp.rst}    |  159 +-
 .../{lapb-module.txt => lapb-module.rst}           |  122 +-
 Documentation/networking/{ltpc.txt => ltpc.rst}    |   47 +-
 ...c80211-injection.txt => mac80211-injection.rst} |   41 +-
 .../{mpls-sysctl.txt => mpls-sysctl.rst}           |   17 +-
 .../networking/{multiqueue.txt => multiqueue.rst}  |   41 +-
 .../networking/{net_dim.txt => net_dim.rst}        |  113 +-
 .../networking/{netconsole.txt => netconsole.rst}  |  125 +-
 .../{netdev-features.txt => netdev-features.rst}   |   19 +-
 .../networking/{netdevices.txt => netdevices.rst}  |   21 +-
 .../{netfilter-sysctl.txt => netfilter-sysctl.rst} |   11 +-
 .../networking/{netif-msg.txt => netif-msg.rst}    |   86 +-
 ...onntrack-sysctl.txt => nf_conntrack-sysctl.rst} |   51 +-
 .../{nf_flowtable.txt => nf_flowtable.rst}         |   55 +-
 .../{openvswitch.txt => openvswitch.rst}           |   23 +-
 .../networking/{operstates.txt => operstates.rst}  |   45 +-
 .../{packet_mmap.txt => packet_mmap.rst}           | 1255 +++++------
 .../networking/{phonet.txt => phonet.rst}          |   56 +-
 .../networking/{pktgen.txt => pktgen.rst}          |  320 +--
 Documentation/networking/{PLIP.txt => plip.rst}    |   43 +-
 .../{ppp_generic.txt => ppp_generic.rst}           |   52 +-
 .../{proc_net_tcp.txt => proc_net_tcp.rst}         |   23 +-
 .../{radiotap-headers.txt => radiotap-headers.rst} |   99 +-
 .../networking/{ray_cs.txt => ray_cs.rst}          |  105 +-
 Documentation/networking/{rds.txt => rds.rst}      |  305 +--
 .../networking/{regulatory.txt => regulatory.rst}  |   29 +-
 Documentation/networking/{rxrpc.txt => rxrpc.rst}  |  306 +--
 Documentation/networking/scaling.rst               |    4 +-
 Documentation/networking/{sctp.txt => sctp.rst}    |   37 +-
 Documentation/networking/{secid.txt => secid.rst}  |    6 +
 .../{seg6-sysctl.txt => seg6-sysctl.rst}           |   18 +-
 Documentation/networking/{skfp.txt => skfp.rst}    |  153 +-
 Documentation/networking/snmp_counter.rst          |    2 +-
 .../networking/{strparser.txt => strparser.rst}    |   85 +-
 .../networking/{switchdev.txt => switchdev.rst}    |  116 +-
 ...ions-env-rules.txt => tc-actions-env-rules.rst} |   25 +-
 .../networking/{tcp-thin.txt => tcp-thin.rst}      |    5 +
 Documentation/networking/{team.txt => team.rst}    |    6 +
 .../{timestamping.txt => timestamping.rst}         |  166 +-
 .../networking/{tproxy.txt => tproxy.rst}          |   57 +-
 .../networking/{tuntap.txt => tuntap.rst}          |  200 +-
 .../networking/{udplite.txt => udplite.rst}        |  175 +-
 Documentation/networking/{vrf.txt => vrf.rst}      |  497 +++--
 Documentation/networking/{vxlan.txt => vxlan.rst}  |   33 +-
 .../networking/{x25-iface.txt => x25-iface.rst}    |   10 +-
 Documentation/networking/{x25.txt => x25.rst}      |    4 +
 .../{xfrm_device.txt => xfrm_device.rst}           |   33 +-
 .../networking/{xfrm_proc.txt => xfrm_proc.rst}    |   31 +
 .../networking/{xfrm_sync.txt => xfrm_sync.rst}    |   66 +-
 .../{xfrm_sysctl.txt => xfrm_sysctl.rst}           |    7 +
 .../networking/{z8530drv.txt => z8530drv.rst}      |  629 +++---
 Documentation/{nommu-mmap.txt => nommu-mmap.rst}   |    0
 ...pu-rw-semaphore.txt => percpu-rw-semaphore.rst} |    0
 Documentation/{pi-futex.txt => pi-futex.rst}       |    0
 Documentation/powerpc/firmware-assisted-dump.rst   |    2 +-
 Documentation/powerpc/index.rst                    |    1 +
 ...pudispatch_stats.txt => vcpudispatch_stats.rst} |   17 +-
 .../{preempt-locking.txt => preempt-locking.rst}   |    0
 Documentation/process/adding-syscalls.rst          |    2 +-
 Documentation/process/submit-checklist.rst         |    2 +-
 Documentation/process/submitting-patches.rst       |    2 +-
 Documentation/{rbtree.txt => rbtree.rst}           |    0
 Documentation/{remoteproc.txt => remoteproc.rst}   |    2 +-
 .../{robust-futex-ABI.txt => robust-futex-ABI.rst} |    0
 .../{robust-futexes.txt => robust-futexes.rst}     |    0
 Documentation/{rpmsg.txt => rpmsg.rst}             |    0
 Documentation/scsi/{53c700.txt => 53c700.rst}      |   61 +-
 Documentation/scsi/{BusLogic.txt => BusLogic.rst}  |   89 +-
 .../scsi/{FlashPoint.txt => FlashPoint.rst}        |  241 ++-
 .../scsi/{NinjaSCSI.txt => NinjaSCSI.rst}          |  198 +-
 Documentation/scsi/{aacraid.txt => aacraid.rst}    |   59 +-
 Documentation/scsi/{advansys.txt => advansys.rst}  |  129 +-
 Documentation/scsi/{aha152x.txt => aha152x.rst}    |   73 +-
 Documentation/scsi/{aic79xx.txt => aic79xx.rst}    |  586 ++---
 Documentation/scsi/{aic7xxx.txt => aic7xxx.rst}    |  446 ++--
 Documentation/scsi/arcmsr_spec.rst                 |  907 ++++++++
 Documentation/scsi/arcmsr_spec.txt                 |  574 -----
 Documentation/scsi/{bfa.txt => bfa.rst}            |   28 +-
 Documentation/scsi/{bnx2fc.txt => bnx2fc.rst}      |   18 +-
 Documentation/scsi/{cxgb3i.txt => cxgb3i.rst}      |   22 +-
 Documentation/scsi/{dc395x.txt => dc395x.rst}      |   79 +-
 Documentation/scsi/dpti.rst                        |   92 +
 Documentation/scsi/dpti.txt                        |   83 -
 .../scsi/{g_NCR5380.txt => g_NCR5380.rst}          |   83 +-
 Documentation/scsi/{hpsa.txt => hpsa.rst}          |   79 +-
 Documentation/scsi/{hptiop.txt => hptiop.rst}      |   45 +-
 Documentation/scsi/index.rst                       |   51 +
 Documentation/scsi/{libsas.txt => libsas.rst}      |  352 ++--
 ...policy.txt => link_power_management_policy.rst} |   12 +-
 Documentation/scsi/{lpfc.txt => lpfc.rst}          |   16 +-
 Documentation/scsi/{megaraid.txt => megaraid.rst}  |   47 +-
 .../scsi/{ncr53c8xx.txt => ncr53c8xx.rst}          | 1871 +++++++++-------
 Documentation/scsi/{ppa.txt => ppa.rst}            |   12 +-
 .../scsi/{qlogicfas.txt => qlogicfas.rst}          |   17 +-
 .../scsi/{scsi-changer.txt => scsi-changer.rst}    |   36 +-
 .../scsi/{scsi-generic.txt => scsi-generic.rst}    |   75 +-
 .../{scsi-parameters.txt => scsi-parameters.rst}   |   28 +-
 Documentation/scsi/{scsi.txt => scsi.rst}          |   31 +-
 Documentation/scsi/{scsi_eh.txt => scsi_eh.rst}    |  213 +-
 ...scsi_fc_transport.txt => scsi_fc_transport.rst} |  242 ++-
 .../{scsi_mid_low_api.txt => scsi_mid_low_api.rst} | 1788 ++++++++--------
 Documentation/scsi/scsi_transport_srp/Makefile     |    7 -
 Documentation/scsi/scsi_transport_srp/figures.rst  |    6 +
 .../scsi/{sd-parameters.txt => sd-parameters.rst}  |   21 +-
 Documentation/scsi/{smartpqi.txt => smartpqi.rst}  |   52 +-
 Documentation/scsi/{st.txt => st.rst}              |  301 ++-
 .../scsi/{sym53c500_cs.txt => sym53c500_cs.rst}    |    8 +-
 .../scsi/{sym53c8xx_2.txt => sym53c8xx_2.rst}      | 1131 +++++-----
 .../scsi/{tcm_qla2xxx.txt => tcm_qla2xxx.rst}      |   26 +-
 Documentation/scsi/{ufs.txt => ufs.rst}            |   84 +-
 Documentation/scsi/{wd719x.txt => wd719x.rst}      |   23 +-
 Documentation/security/keys/core.rst               |    2 +-
 Documentation/sh/index.rst                         |    6 +
 .../sh/{new-machine.txt => new-machine.rst}        |  199 +-
 .../sh/{register-banks.txt => register-banks.rst}  |   13 +-
 Documentation/{speculation.txt => speculation.rst} |    0
 Documentation/{static-keys.txt => static-keys.rst} |    0
 Documentation/{tee.txt => tee.rst}                 |    0
 .../{this_cpu_ops.txt => this_cpu_ops.rst}         |    0
 Documentation/trace/index.rst                      |    1 +
 Documentation/trace/kprobetrace.rst                |    2 +-
 ...ng-buffer-design.txt => ring-buffer-design.rst} |  836 ++++----
 .../translations/it_IT/process/adding-syscalls.rst |    2 +-
 .../it_IT/process/submit-checklist.rst             |    2 +-
 .../it_IT/process/submitting-patches.rst           |    2 +-
 .../translations/ko_KR/memory-barriers.txt         |    8 +-
 Documentation/translations/zh_CN/IRQ.txt           |    4 +-
 Documentation/translations/zh_CN/arm/Booting       |    2 +-
 .../translations/zh_CN/filesystems/sysfs.txt       |    8 +-
 Documentation/translations/zh_CN/io_ordering.txt   |    4 +-
 .../zh_CN/process/submit-checklist.rst             |    2 +-
 ...mory-access.txt => unaligned-memory-access.rst} |    0
 Documentation/usb/gadget_configfs.rst              |    4 +-
 Documentation/virt/kvm/arm/pvtime.rst              |    2 +-
 Documentation/virt/kvm/devices/vcpu.rst            |    2 +-
 Documentation/virt/kvm/hypercalls.rst              |    4 +-
 Documentation/virt/kvm/mmu.rst                     |    2 +-
 Documentation/virt/kvm/review-checklist.rst        |    2 +-
 Documentation/watchdog/hpwdt.rst                   |    2 +-
 Documentation/x86/index.rst                        |    1 -
 Documentation/{xz.txt => xz.rst}                   |    0
 MAINTAINERS                                        |  188 +-
 Next/merge.log                                     |    2 +-
 arch/Kconfig                                       |    2 +-
 arch/ia64/hp/common/sba_iommu.c                    |   12 +-
 arch/parisc/kernel/pci-dma.c                       |    2 +-
 arch/powerpc/include/uapi/asm/kvm_para.h           |    2 +-
 arch/sh/Kconfig.cpu                                |    2 +-
 arch/unicore32/include/asm/io.h                    |    2 +-
 arch/x86/include/asm/dma-mapping.h                 |    4 +-
 arch/x86/kernel/amd_gart_64.c                      |    2 +-
 arch/x86/kvm/mmu/mmu.c                             |    2 +-
 crypto/asymmetric_keys/asymmetric_type.c           |    2 +-
 crypto/asymmetric_keys/public_key.c                |    2 +-
 crypto/asymmetric_keys/signature.c                 |    2 +-
 drivers/atm/Kconfig                                |    4 +-
 drivers/base/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 +-
 .../crypto/allwinner/sun8i-ce/sun8i-ce-cipher.c    |    2 +-
 drivers/crypto/allwinner/sun8i-ce/sun8i-ce-core.c  |    2 +-
 .../crypto/allwinner/sun8i-ss/sun8i-ss-cipher.c    |    2 +-
 drivers/crypto/allwinner/sun8i-ss/sun8i-ss-core.c  |    2 +-
 drivers/gpu/drm/Kconfig                            |    2 +-
 drivers/gpu/drm/drm_ioctl.c                        |    2 +-
 drivers/gpu/drm/msm/disp/dpu1/dpu_kms.h            |    2 +-
 drivers/hwtracing/coresight/Kconfig                |    2 +-
 drivers/media/v4l2-core/v4l2-fwnode.c              |    2 +-
 drivers/misc/Kconfig                               |    2 +-
 drivers/misc/ad525x_dpot.c                         |    2 +-
 drivers/net/Kconfig                                |   12 +-
 drivers/net/appletalk/Kconfig                      |    8 +-
 drivers/net/arcnet/Kconfig                         |    6 +-
 drivers/net/caif/Kconfig                           |    2 +-
 drivers/net/ethernet/3com/3c59x.c                  |    4 +-
 drivers/net/ethernet/3com/Kconfig                  |    2 +-
 drivers/net/ethernet/chelsio/Kconfig               |    2 +-
 drivers/net/ethernet/cirrus/Kconfig                |    2 +-
 drivers/net/ethernet/dec/tulip/Kconfig             |    4 +-
 drivers/net/ethernet/dlink/dl2k.c                  |    2 +-
 drivers/net/ethernet/neterion/Kconfig              |    4 +-
 drivers/net/ethernet/smsc/Kconfig                  |    4 +-
 drivers/net/ethernet/ti/Kconfig                    |    2 +-
 drivers/net/ethernet/ti/tlan.c                     |    2 +-
 drivers/net/ethernet/toshiba/ps3_gelic_net.c       |    2 +-
 drivers/net/ethernet/toshiba/spider_net.c          |    2 +-
 drivers/net/fddi/Kconfig                           |    2 +-
 drivers/net/hamradio/Kconfig                       |   14 +-
 drivers/net/hamradio/scc.c                         |    2 +-
 drivers/net/plip/Kconfig                           |    2 +-
 drivers/net/wan/Kconfig                            |    4 +-
 drivers/net/wireless/Kconfig                       |    2 +-
 drivers/net/wireless/intel/ipw2x00/Kconfig         |    4 +-
 drivers/net/wireless/intel/ipw2x00/ipw2100.c       |    2 +-
 drivers/parisc/sba_iommu.c                         |   14 +-
 drivers/scsi/BusLogic.c                            |    2 +-
 drivers/scsi/Kconfig                               |   42 +-
 drivers/scsi/aha152x.c                             |    4 +-
 drivers/scsi/aic7xxx/Kconfig.aic79xx               |    2 +-
 drivers/scsi/aic7xxx/Kconfig.aic7xxx               |    2 +-
 drivers/scsi/arcmsr/arcmsr_attr.c                  |    2 +-
 drivers/scsi/arcmsr/arcmsr_hba.c                   |    2 +-
 drivers/scsi/dpt/dpti_ioctl.h                      |    2 +-
 drivers/scsi/dpt_i2o.c                             |    2 +-
 drivers/scsi/dpti.h                                |    2 +-
 drivers/scsi/g_NCR5380.c                           |    2 +-
 drivers/scsi/ncr53c8xx.c                           |    2 +-
 drivers/scsi/pcmcia/Kconfig                        |    2 +-
 drivers/scsi/smartpqi/Kconfig                      |    2 +-
 drivers/scsi/st.c                                  |    2 +-
 drivers/scsi/ufs/Kconfig                           |    2 +-
 drivers/staging/fsl-dpaa2/ethsw/README             |    2 +-
 fs/Kconfig                                         |    2 +-
 fs/Kconfig.binfmt                                  |    2 +-
 fs/adfs/Kconfig                                    |    2 +-
 fs/affs/Kconfig                                    |    2 +-
 fs/afs/Kconfig                                     |    6 +-
 fs/bfs/Kconfig                                     |    2 +-
 fs/cachefiles/Kconfig                              |    4 +-
 fs/coda/Kconfig                                    |    2 +-
 fs/configfs/inode.c                                |    2 +-
 fs/configfs/item.c                                 |    2 +-
 fs/cramfs/Kconfig                                  |    2 +-
 fs/dcache.c                                        |    6 +-
 fs/ecryptfs/Kconfig                                |    2 +-
 fs/fat/Kconfig                                     |    8 +-
 fs/fscache/Kconfig                                 |    8 +-
 fs/fscache/cache.c                                 |    8 +-
 fs/fscache/cookie.c                                |    2 +-
 fs/fscache/object.c                                |    4 +-
 fs/fscache/operation.c                             |    2 +-
 fs/fuse/Kconfig                                    |    2 +-
 fs/fuse/dev.c                                      |    2 +-
 fs/hfs/Kconfig                                     |    2 +-
 fs/hpfs/Kconfig                                    |    2 +-
 fs/isofs/Kconfig                                   |    2 +-
 fs/locks.c                                         |    2 +-
 fs/namei.c                                         |    2 +-
 fs/namespace.c                                     |    2 +-
 fs/nfs/Kconfig                                     |    2 +-
 fs/notify/inotify/Kconfig                          |    2 +-
 fs/ntfs/Kconfig                                    |    2 +-
 fs/ocfs2/Kconfig                                   |    2 +-
 fs/overlayfs/Kconfig                               |    6 +-
 fs/proc/Kconfig                                    |    4 +-
 fs/romfs/Kconfig                                   |    2 +-
 fs/sysfs/dir.c                                     |    2 +-
 fs/sysfs/file.c                                    |    2 +-
 fs/sysfs/mount.c                                   |    2 +-
 fs/sysfs/symlink.c                                 |    2 +-
 fs/sysv/Kconfig                                    |    2 +-
 fs/udf/Kconfig                                     |    2 +-
 include/crypto/public_key.h                        |    2 +-
 include/keys/asymmetric-parser.h                   |    2 +-
 include/keys/asymmetric-subtype.h                  |    2 +-
 include/keys/asymmetric-type.h                     |    2 +-
 include/linux/configfs.h                           |    2 +-
 include/linux/dma-mapping.h                        |    2 +-
 include/linux/fs_context.h                         |    2 +-
 include/linux/fscache-cache.h                      |    4 +-
 include/linux/fscache.h                            |   42 +-
 include/linux/io-mapping.h                         |    2 +-
 include/linux/jump_label.h                         |    2 +-
 include/linux/kobject.h                            |    2 +-
 include/linux/kobject_ns.h                         |    2 +-
 include/linux/lsm_hooks.h                          |    2 +-
 include/linux/mfd/core.h                           |    2 +-
 include/linux/mm.h                                 |    4 +-
 include/linux/netdev_features.h                    |    2 +-
 include/linux/rbtree.h                             |    2 +-
 include/linux/rbtree_augmented.h                   |    2 +-
 include/linux/rculist_nulls.h                      |    2 +-
 include/linux/relay.h                              |    2 +-
 include/linux/sysfs.h                              |    2 +-
 include/media/videobuf-dma-sg.h                    |    2 +-
 include/net/cfg80211.h                             |    2 +-
 include/scsi/sg.h                                  |    2 +-
 include/uapi/linux/errqueue.h                      |    2 +-
 include/uapi/linux/ethtool_netlink.h               |    2 +-
 include/uapi/linux/if_x25.h                        |    2 +-
 include/uapi/linux/kvm.h                           |    4 +-
 include/uapi/rdma/rdma_user_ioctl_cmds.h           |    2 +-
 init/Kconfig                                       |    2 +-
 kernel/dma/debug.c                                 |    2 +-
 kernel/rcu/rcutorture.c                            |    2 +-
 kernel/rcu/tree_stall.h                            |    4 +-
 kernel/relay.c                                     |    2 +-
 lib/Kconfig                                        |    2 +-
 lib/Kconfig.debug                                  |    2 +-
 lib/crc32.c                                        |    2 +-
 lib/kobject.c                                      |    4 +-
 lib/lzo/lzo1x_decompress_safe.c                    |    2 +-
 lib/xz/Kconfig                                     |    2 +-
 mm/Kconfig                                         |    2 +-
 mm/gup.c                                           |   12 +-
 mm/nommu.c                                         |    2 +-
 net/Kconfig                                        |    4 +-
 net/atm/Kconfig                                    |    2 +-
 net/ax25/Kconfig                                   |    6 +-
 net/ceph/Kconfig                                   |    2 +-
 net/core/gen_stats.c                               |    2 +-
 net/core/pktgen.c                                  |    2 +-
 net/core/sock.c                                    |    4 +-
 net/decnet/Kconfig                                 |    4 +-
 net/dns_resolver/Kconfig                           |    2 +-
 net/dns_resolver/dns_key.c                         |    2 +-
 net/dns_resolver/dns_query.c                       |    2 +-
 net/ipv4/Kconfig                                   |    8 +-
 net/ipv4/icmp.c                                    |    2 +-
 net/ipv4/ipconfig.c                                |    2 +-
 net/ipv6/Kconfig                                   |    2 +-
 net/lapb/Kconfig                                   |    2 +-
 net/mac80211/tx.c                                  |    2 +-
 net/netfilter/Kconfig                              |    2 +-
 net/rxrpc/Kconfig                                  |    6 +-
 net/rxrpc/sysctl.c                                 |    2 +-
 net/wireless/radiotap.c                            |    2 +-
 net/x25/Kconfig                                    |    4 +-
 samples/kprobes/kprobe_example.c                   |    2 +-
 samples/kprobes/kretprobe_example.c                |    2 +-
 samples/pktgen/README.rst                          |    2 +-
 scripts/checkpatch.pl                              |    2 +-
 scripts/documentation-file-ref-check               |   13 +-
 tools/bpf/bpf_asm.c                                |    2 +-
 tools/bpf/bpf_dbg.c                                |    2 +-
 tools/include/linux/rbtree.h                       |    2 +-
 tools/include/linux/rbtree_augmented.h             |    2 +-
 tools/include/uapi/linux/kvm.h                     |    4 +-
 virt/kvm/arm/vgic/vgic-mmio-v3.c                   |    2 +-
 virt/kvm/arm/vgic/vgic.h                           |    4 +-
 608 files changed, 25908 insertions(+), 19832 deletions(-)