(CC to documentation, get_maintainer, and LKMM maintainers)
Hi Mauro,
As I didn't receive "[PATCH 12/14] docs: move remaining stuff under
Documentation/*.txt to Documentation/staging", I'm replying to
[PATCH 00/14].
On Fri, 1 May 2020 17:37:44 +0200, Mauro Carvalho Chehab wrote:
> The main goal of this series is to cleanup the Documentation/
> directory.
>
> Most of the files under Documentation/*.txt are already in ReST format.
> They just need to be moved to some place. So, most of the work here is
> to just move files for them to generate an output using the docs building
> system.
>
> After this change, the Documentation/ dir will contain:
>
> - the main ReST file:
> - index.rst
>
> - TUX and its copyright:
> - logo.gif and COPYING-logo
>
> - Files required to do ReST builds:
> - .gitignore, Makefile, conf.py, docutils.conf, Kconfig
>
> - A pre-git file used to generate patches:
> - dontdiff
> (I guess we should get rid of it, as I doubt this is useful those days).
>
> -
>
> Besides the above rightful files, the Documentation/ dir will also
> contain some left-overs:
>
> - two somewhat new ReST files that should be moved to somewhere:
> - asm-annotations.rst and watch_queue.rst
>
> - Two files that helps people looking for some well known documents
> that are referenced at the web, pointing to their new location inside
> the process/ dir:
> - SubmittingPatches and CodingStyle
>
> - Three .txt files that weren't converted to ReST:
> - atomic_bitops.txt, memory-barriers.txt, atomic_t.txt
>
> It should be noticed that I'm in doubt about the location of some files,
> and some stuff may well belong to a trash can. So, this series create
> a temporary place for orphaned documents in the form of a
> Documentation/staging directory.
>
> This series is also on my development git tree, at:
>
> https://git.linuxtv.org/mchehab/experimental.git/log/?h=rename-main-docs
>
> The built output documentation on html format is at:
>
> https://www.infradead.org/~mchehab/kernel_docs/
>
> (it contains also other documents I converted to ReST)
>
>
> Mauro Carvalho Chehab (14):
> docs: move DMA kAPI to Documentation/core-api
> docs: add bus-virt-phys-mapping.txt to core-api
> docs: fix references for DMA*.txt files
> docs: move IPMI.txt to the driver API book
> docs: fix references for ipmi.rst file
> docs: debugging-via-ohci1394.txt: add it to the core-api book
> docs: add IRQ documentation at the core-api book
> docs: move kobject and kref docs into the core-api book
> docs: move digsig docs to the security book
> docs: move locking-specific documenta to locking/ directory
> docs: move other kAPI documents to core-api
> docs: move remaining stuff under Documentation/*.txt to
> Documentation/staging
> docs: staging: don't use literalinclude
> docs: staging: use small font for literal includes
>
> Documentation/PCI/pci.rst | 6 +-
> Documentation/admin-guide/hw-vuln/l1tf.rst| 2 +-
> .../admin-guide/kernel-parameters.txt | 2 +-
> .../admin-guide/kernel-per-CPU-kthreads.rst | 2 +-
> Documentation/admin-guide/sysctl/vm.rst | 2 +-
> Documentation/block/biodoc.rst| 2 +-
> .../bus-virt-phys-mapping.rst}| 2 +-
> .../debugging-via-ohci1394.rst} | 0
> .../dma-api-howto.rst}| 0
> .../{DMA-API.txt => core-api/dma-api.rst} | 6 +-
> .../dma-attributes.rst} | 0
> .../dma-isa-lpc.rst} | 2 +-
> Documentation/core-api/index.rst | 14 +
> .../{IRQ.txt => core-api/irq/concepts.rst}| 0
> Documentation/core-api/irq/index.rst | 11
> .../irq/irq-affinity.rst} | 0
> .../irq/irq-domain.rst} | 3 +-
> .../irq/irqflags-tracing.rst} | 0
> Documentation/core-api/kobject.rst| 2 +-
> Documentation/{kref.txt => core-api/kref.rst} | 0
> .../{mailbox.txt => core-api/mailbox.rst} | 0
> .../nommu-mmap.rst} | 0
> .../this_cpu_ops.rst} | 0
> .../unaligned-memory-access.rst} | 0
> Documentation/driver-api/index.rst| 1 +
> .../{IPMI.txt => driver-api/ipmi.rst} | 0
> Documentation/driver-api/usb/dma.rst | 6 +-
> Documentation/gpu/drm-mm.rst | 2 +-
> Documentation/ia64/irq-redir.rst | 2 +-
> Documentation/index.rst | 13
> .../futex-requeue-pi.rst} | 0
> .../hwspinlock.rst} | 0
> Documentation/locking/index.rst | 7 +++
> .../percpu-rw-semaphore.rst} | 0
> .../{pi-futex.txt => locking/pi-futex.rst}| 0
> .../preempt-locking.rst} | 0
> .../robust-futex-ABI.rst}