linux-doc.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* "staging" area for unsorted random files under Documentation/*.rst
@ 2020-02-18 10:32 Mauro Carvalho Chehab
  2020-02-18 12:26 ` Jani Nikula
  0 siblings, 1 reply; 5+ messages in thread
From: Mauro Carvalho Chehab @ 2020-02-18 10:32 UTC (permalink / raw)
  To: Jonathan Corbet; +Cc: Linux Doc Mailing List

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.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>

diff --git a/Documentation/index.rst b/Documentation/index.rst
index e99d0bd2589d..9a512600c95c 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -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
 ==================
 
diff --git a/Documentation/DMA-API-HOWTO.txt b/Documentation/DMA-API-HOWTO.rst
similarity index 100%
rename from Documentation/DMA-API-HOWTO.txt
rename to Documentation/DMA-API-HOWTO.rst
diff --git a/Documentation/DMA-API.txt b/Documentation/DMA-API.rst
similarity index 100%
rename from Documentation/DMA-API.txt
rename to Documentation/DMA-API.rst
diff --git a/Documentation/DMA-ISA-LPC.txt b/Documentation/DMA-ISA-LPC.rst
similarity index 100%
rename from Documentation/DMA-ISA-LPC.txt
rename to Documentation/DMA-ISA-LPC.rst
diff --git a/Documentation/DMA-attributes.txt b/Documentation/DMA-attributes.rst
similarity index 100%
rename from Documentation/DMA-attributes.txt
rename to Documentation/DMA-attributes.rst
diff --git a/Documentation/IPMI.txt b/Documentation/IPMI.rst
similarity index 100%
rename from Documentation/IPMI.txt
rename to Documentation/IPMI.rst
diff --git a/Documentation/IRQ-affinity.txt b/Documentation/IRQ-affinity.rst
similarity index 100%
rename from Documentation/IRQ-affinity.txt
rename to Documentation/IRQ-affinity.rst
diff --git a/Documentation/IRQ-domain.txt b/Documentation/IRQ-domain.rst
similarity index 100%
rename from Documentation/IRQ-domain.txt
rename to Documentation/IRQ-domain.rst
diff --git a/Documentation/IRQ.txt b/Documentation/IRQ.rst
similarity index 100%
rename from Documentation/IRQ.txt
rename to Documentation/IRQ.rst
diff --git a/Documentation/bus-virt-phys-mapping.txt b/Documentation/bus-virt-phys-mapping.rst
similarity index 100%
rename from Documentation/bus-virt-phys-mapping.txt
rename to Documentation/bus-virt-phys-mapping.rst
diff --git a/Documentation/crc32.txt b/Documentation/crc32.rst
similarity index 100%
rename from Documentation/crc32.txt
rename to Documentation/crc32.rst
diff --git a/Documentation/debugging-modules.txt b/Documentation/debugging-modules.rst
similarity index 100%
rename from Documentation/debugging-modules.txt
rename to Documentation/debugging-modules.rst
diff --git a/Documentation/debugging-via-ohci1394.txt b/Documentation/debugging-via-ohci1394.rst
similarity index 100%
rename from Documentation/debugging-via-ohci1394.txt
rename to Documentation/debugging-via-ohci1394.rst
diff --git a/Documentation/digsig.txt b/Documentation/digsig.rst
similarity index 100%
rename from Documentation/digsig.txt
rename to Documentation/digsig.rst
diff --git a/Documentation/futex-requeue-pi.txt b/Documentation/futex-requeue-pi.rst
similarity index 100%
rename from Documentation/futex-requeue-pi.txt
rename to Documentation/futex-requeue-pi.rst
diff --git a/Documentation/hwspinlock.txt b/Documentation/hwspinlock.rst
similarity index 100%
rename from Documentation/hwspinlock.txt
rename to Documentation/hwspinlock.rst
diff --git a/Documentation/io-mapping.txt b/Documentation/io-mapping.rst
similarity index 100%
rename from Documentation/io-mapping.txt
rename to Documentation/io-mapping.rst
diff --git a/Documentation/io_ordering.txt b/Documentation/io_ordering.rst
similarity index 100%
rename from Documentation/io_ordering.txt
rename to Documentation/io_ordering.rst
diff --git a/Documentation/irqflags-tracing.txt b/Documentation/irqflags-tracing.rst
similarity index 100%
rename from Documentation/irqflags-tracing.txt
rename to Documentation/irqflags-tracing.rst
diff --git a/Documentation/kobject.txt b/Documentation/kobject.rst
similarity index 100%
rename from Documentation/kobject.txt
rename to Documentation/kobject.rst
diff --git a/Documentation/kprobes.txt b/Documentation/kprobes.rst
similarity index 100%
rename from Documentation/kprobes.txt
rename to Documentation/kprobes.rst
diff --git a/Documentation/kref.txt b/Documentation/kref.rst
similarity index 100%
rename from Documentation/kref.txt
rename to Documentation/kref.rst
diff --git a/Documentation/lzo.txt b/Documentation/lzo.rst
similarity index 100%
rename from Documentation/lzo.txt
rename to Documentation/lzo.rst
diff --git a/Documentation/mailbox.txt b/Documentation/mailbox.rst
similarity index 100%
rename from Documentation/mailbox.txt
rename to Documentation/mailbox.rst
diff --git a/Documentation/nommu-mmap.txt b/Documentation/nommu-mmap.rst
similarity index 100%
rename from Documentation/nommu-mmap.txt
rename to Documentation/nommu-mmap.rst
diff --git a/Documentation/percpu-rw-semaphore.txt b/Documentation/percpu-rw-semaphore.rst
similarity index 100%
rename from Documentation/percpu-rw-semaphore.txt
rename to Documentation/percpu-rw-semaphore.rst
diff --git a/Documentation/pi-futex.txt b/Documentation/pi-futex.rst
similarity index 100%
rename from Documentation/pi-futex.txt
rename to Documentation/pi-futex.rst
diff --git a/Documentation/preempt-locking.txt b/Documentation/preempt-locking.rst
similarity index 100%
rename from Documentation/preempt-locking.txt
rename to Documentation/preempt-locking.rst
diff --git a/Documentation/rbtree.txt b/Documentation/rbtree.rst
similarity index 100%
rename from Documentation/rbtree.txt
rename to Documentation/rbtree.rst
diff --git a/Documentation/remoteproc.txt b/Documentation/remoteproc.rst
similarity index 100%
rename from Documentation/remoteproc.txt
rename to Documentation/remoteproc.rst
diff --git a/Documentation/robust-futex-ABI.txt b/Documentation/robust-futex-ABI.rst
similarity index 100%
rename from Documentation/robust-futex-ABI.txt
rename to Documentation/robust-futex-ABI.rst
diff --git a/Documentation/robust-futexes.txt b/Documentation/robust-futexes.rst
similarity index 100%
rename from Documentation/robust-futexes.txt
rename to Documentation/robust-futexes.rst
diff --git a/Documentation/rpmsg.txt b/Documentation/rpmsg.rst
similarity index 100%
rename from Documentation/rpmsg.txt
rename to Documentation/rpmsg.rst
diff --git a/Documentation/speculation.txt b/Documentation/speculation.rst
similarity index 100%
rename from Documentation/speculation.txt
rename to Documentation/speculation.rst
diff --git a/Documentation/static-keys.txt b/Documentation/static-keys.rst
similarity index 100%
rename from Documentation/static-keys.txt
rename to Documentation/static-keys.rst
diff --git a/Documentation/tee.txt b/Documentation/tee.rst
similarity index 100%
rename from Documentation/tee.txt
rename to Documentation/tee.rst
diff --git a/Documentation/this_cpu_ops.txt b/Documentation/this_cpu_ops.rst
similarity index 100%
rename from Documentation/this_cpu_ops.txt
rename to Documentation/this_cpu_ops.rst
diff --git a/Documentation/unaligned-memory-access.txt b/Documentation/unaligned-memory-access.rst
similarity index 100%
rename from Documentation/unaligned-memory-access.txt
rename to Documentation/unaligned-memory-access.rst
diff --git a/Documentation/xz.txt b/Documentation/xz.rst
similarity index 100%
rename from Documentation/xz.txt
rename to Documentation/xz.rst

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

* Re: "staging" area for unsorted random files under Documentation/*.rst
  2020-02-18 10:32 "staging" area for unsorted random files under Documentation/*.rst Mauro Carvalho Chehab
@ 2020-02-18 12:26 ` Jani Nikula
  2020-02-19  9:29   ` Jonathan Corbet
  0 siblings, 1 reply; 5+ messages in thread
From: Jani Nikula @ 2020-02-18 12:26 UTC (permalink / raw)
  To: Mauro Carvalho Chehab, Jonathan Corbet; +Cc: Linux Doc Mailing List

On Tue, 18 Feb 2020, Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> 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.


-- 
Jani Nikula, Intel Open Source Graphics Center

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

* Re: "staging" area for unsorted random files under Documentation/*.rst
  2020-02-18 12:26 ` Jani Nikula
@ 2020-02-19  9:29   ` Jonathan Corbet
  2020-02-20  5:29     ` Mauro Carvalho Chehab
  0 siblings, 1 reply; 5+ messages in thread
From: Jonathan Corbet @ 2020-02-19  9:29 UTC (permalink / raw)
  To: Jani Nikula; +Cc: Mauro Carvalho Chehab, Linux Doc Mailing List

On Tue, 18 Feb 2020 14:26:14 +0200
Jani Nikula <jani.nikula@linux.intel.com> wrote:

> On Tue, 18 Feb 2020, Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:
> > 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.

> 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

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

* Re: "staging" area for unsorted random files under Documentation/*.rst
  2020-02-19  9:29   ` Jonathan Corbet
@ 2020-02-20  5:29     ` Mauro Carvalho Chehab
  2020-02-22  8:41       ` Mauro Carvalho Chehab
  0 siblings, 1 reply; 5+ messages in thread
From: Mauro Carvalho Chehab @ 2020-02-20  5:29 UTC (permalink / raw)
  To: Jonathan Corbet; +Cc: Jani Nikula, Linux Doc Mailing List

Em Wed, 19 Feb 2020 02:29:51 -0700
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Tue, 18 Feb 2020 14:26:14 +0200
> Jani Nikula <jani.nikula@linux.intel.com> wrote:
> 
> > On Tue, 18 Feb 2020, Mauro Carvalho Chehab <mchehab+huawei@kernel.org> wrote:  
> > > 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.

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

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

> 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

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

* Re: "staging" area for unsorted random files under Documentation/*.rst
  2020-02-20  5:29     ` Mauro Carvalho Chehab
@ 2020-02-22  8:41       ` Mauro Carvalho Chehab
  0 siblings, 0 replies; 5+ messages in thread
From: Mauro Carvalho Chehab @ 2020-02-22  8:41 UTC (permalink / raw)
  To: Jonathan Corbet; +Cc: Jani Nikula, Linux Doc Mailing List

Em Thu, 20 Feb 2020 06:29:34 +0100
Mauro Carvalho Chehab <mchehab+huawei@kernel.org> escreveu:

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


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

end of thread, other threads:[~2020-02-22  8:41 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-02-18 10:32 "staging" area for unsorted random files under Documentation/*.rst Mauro Carvalho Chehab
2020-02-18 12:26 ` Jani Nikula
2020-02-19  9:29   ` Jonathan Corbet
2020-02-20  5:29     ` Mauro Carvalho Chehab
2020-02-22  8:41       ` Mauro Carvalho Chehab

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