From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.8 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, MAILING_LIST_MULTI,MENTIONS_GIT_HOSTING,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3C680C47257 for ; Fri, 1 May 2020 16:02:15 +0000 (UTC) Received: from fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 1359E24958 for ; Fri, 1 May 2020 16:02:15 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=kernel.org header.i=@kernel.org header.b="KA+ZZ5va" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 1359E24958 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=iommu-bounces@lists.linux-foundation.org Received: from localhost (localhost [127.0.0.1]) by fraxinus.osuosl.org (Postfix) with ESMTP id E7DC387387; Fri, 1 May 2020 16:02:14 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from fraxinus.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id nofBkozEWIvw; Fri, 1 May 2020 16:02:12 +0000 (UTC) Received: from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56]) by fraxinus.osuosl.org (Postfix) with ESMTP id 444D387386; Fri, 1 May 2020 16:02:12 +0000 (UTC) Received: from lf-lists.osuosl.org (localhost [127.0.0.1]) by lists.linuxfoundation.org (Postfix) with ESMTP id 30CC9C088C; Fri, 1 May 2020 16:02:12 +0000 (UTC) Received: from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138]) by lists.linuxfoundation.org (Postfix) with ESMTP id 1CEB7C016F for ; Fri, 1 May 2020 15:38:07 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by whitealder.osuosl.org (Postfix) with ESMTP id 08A208832A for ; Fri, 1 May 2020 15:38:07 +0000 (UTC) X-Virus-Scanned: amavisd-new at osuosl.org Received: from whitealder.osuosl.org ([127.0.0.1]) by localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id qjZGOKU5odC9 for ; Fri, 1 May 2020 15:38:05 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by whitealder.osuosl.org (Postfix) with ESMTPS id DDC3388325 for ; Fri, 1 May 2020 15:38:05 +0000 (UTC) Received: from mail.kernel.org (ip5f5ad5c5.dynamic.kabel-deutschland.de [95.90.213.197]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 47ADD24972; Fri, 1 May 2020 15:38:03 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1588347483; bh=UmrP/hoKXS1X0eTMC7eo7TOZzxfnIVaKR9qol1Dq/Bc=; h=From:To:Cc:Subject:Date:From; b=KA+ZZ5vaGp4af7L1FIvczyp64NtuVk/7PJp0nGQoLbtxSvVYCH9dGlcV8erL/XrwN g2bVEWnVohJbxmhaJBM4zY/lz9bfpdnSGeRulrEYr4qofsrwAyib0Sj8w6JhkKD9/y jRAO4uKWmKWhR+/3X+J47Le6iXTeDi/zgpDX0sjA= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jUXjk-00FE4N-Ss; Fri, 01 May 2020 17:38:00 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Subject: [PATCH 00/14] Move the ReST files from Documentation/*.txt Date: Fri, 1 May 2020 17:37:44 +0200 Message-Id: X-Mailer: git-send-email 2.25.4 MIME-Version: 1.0 X-Mailman-Approved-At: Fri, 01 May 2020 16:02:10 +0000 Cc: "Rafael J. Wysocki" , Catalin Marinas , dri-devel@lists.freedesktop.org, Christoph Hellwig , linux-arch@vger.kernel.org, "Aneesh Kumar K.V" , Alan Stern , Allison Randal , openipmi-developer@lists.sourceforge.net, Harald Seiler , Guenter Roeck , Ohad Ben-Cohen , Boqun Feng , Nicholas Piggin , Thomas Gleixner , Tom Vaden , Marcos Paulo de Souza , Greg Kroah-Hartman , Randy Dunlap , linux-kernel@vger.kernel.org, Masami Hiramatsu , Tejun Heo , Andrew Morton , Alexandre Belloni , linux-ia64@vger.kernel.org, David Airlie , "James E.J. Bottomley" , Masahiro Yamada , Harry Wei , Manivannan Sadhasivam , Ingo Molnar , Stephen Rothwell , Alexandre Ghiti , Helge Deller , Anil S Keshavamurthy , Daniel Jordan , Frederic Weisbecker , Andrea Parri , Juergen Gross , Corey Minyard , Maxime Ripard , Bjorn Helgaas , Damien Le Moal , Tony Luck , Mathieu Poirier , Patrick Bellasi , "Eric W. Biederman" , Daniel Bristot de Oliveira , Jens Wiklander , Mike Kravetz , Kefeng Wang , linux-pci@vger.kernel.org, Akira Yokosawa , Dmitry Safonov <0x7f454c46@gmail.com>, Joel Fernandes , Alex Shi , Will Deacon , Rob Herring , Jonathan Corbet , Krzysztof Kozlowski , Andy Shevchenko , Zenghui Yu , Darren Hart , Jade Alglave , Fenghua Yu , Arnd Bergmann , Bartlomiej Zolnierkiewicz , linux-remoteproc@vger.kernel.org, =?UTF-8?q?Jonathan=20Neusch=C3=A4fer?= , "Steven Rostedt \(VMware\)" , SeongJae Park , "Naveen N. Rao" , Borislav Petkov , Luc Maranget , Dan Williams , Peter Collingbourne , linux-parisc@vger.kernel.org, Sameer Rahmani , iommu@lists.linux-foundation.org, Baolin Wang , Logan Gunthorpe , "David S. Miller" , Lecopzer Chen , Peter Zijlstra , Sebastian Andrzej Siewior , Pragat Pandya , Bjorn Andersson , David Howells , linux-mm@kvack.org, "H. Peter Anvin" , Sergey Senozhatsky , Mauro Carvalho Chehab , Marc Zyngier , x86@kernel.org, Mike Rapoport , Jason Gunthorpe , Ingo Molnar , Pawan Gupta , Jakub Kicinski , Daniel Vetter , "Paul E. McKenney" , Anshuman Khandual , Daniel Lustig , Maarten Lankhorst , Simon Horman , Jens Axboe , netdev@vger.kernel.org, tee-dev@lists.linaro.org, Changbin Du , Thomas Zimmermann , Robin Murphy X-BeenThere: iommu@lists.linux-foundation.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: Development issues for Linux IOMMU support List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: iommu-bounces@lists.linux-foundation.org Sender: "iommu" 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} | 0 .../robust-futexes.rst} | 0 Documentation/locking/rt-mutex.rst | 2 +- Documentation/memory-barriers.txt | 6 +- Documentation/networking/scaling.rst | 4 +- .../{digsig.txt => security/digsig.rst} | 0 Documentation/security/index.rst | 1 + .../{crc32.txt => staging/crc32.rst} | 0 Documentation/staging/index.rst | 59 +++++++++++++++++++ .../{kprobes.txt => staging/kprobes.rst} | 0 Documentation/{lzo.txt => staging/lzo.rst} | 0 .../remoteproc.rst} | 2 +- .../{rpmsg.txt => staging/rpmsg.rst} | 0 .../speculation.rst} | 8 ++- .../static-keys.rst} | 0 Documentation/{tee.txt => staging/tee.rst} | 1 + Documentation/{xz.txt => staging/xz.rst} | 0 Documentation/trace/kprobetrace.rst | 2 +- .../translations/ko_KR/memory-barriers.txt | 6 +- Documentation/translations/zh_CN/IRQ.txt | 4 +- MAINTAINERS | 20 +++---- arch/Kconfig | 2 +- arch/ia64/hp/common/sba_iommu.c | 12 ++-- arch/parisc/kernel/pci-dma.c | 2 +- arch/x86/include/asm/dma-mapping.h | 4 +- arch/x86/kernel/amd_gart_64.c | 2 +- drivers/char/ipmi/Kconfig | 2 +- drivers/char/ipmi/ipmi_si_hotmod.c | 2 +- drivers/char/ipmi/ipmi_si_intf.c | 2 +- drivers/parisc/sba_iommu.c | 14 ++--- include/asm-generic/bitops/atomic.h | 2 +- include/linux/dma-mapping.h | 2 +- include/linux/jump_label.h | 2 +- include/media/videobuf-dma-sg.h | 2 +- init/Kconfig | 2 +- kernel/dma/debug.c | 2 +- lib/Kconfig.debug | 2 +- lib/crc32.c | 2 +- lib/lzo/lzo1x_decompress_safe.c | 2 +- lib/xz/Kconfig | 2 +- mm/Kconfig | 2 +- mm/nommu.c | 2 +- samples/kprobes/kprobe_example.c | 2 +- samples/kprobes/kretprobe_example.c | 2 +- 80 files changed, 191 insertions(+), 81 deletions(-) rename Documentation/{bus-virt-phys-mapping.txt => core-api/bus-virt-phys-mapping.rst} (99%) rename Documentation/{debugging-via-ohci1394.txt => core-api/debugging-via-ohci1394.rst} (100%) rename Documentation/{DMA-API-HOWTO.txt => core-api/dma-api-howto.rst} (100%) rename Documentation/{DMA-API.txt => core-api/dma-api.rst} (99%) rename Documentation/{DMA-attributes.txt => core-api/dma-attributes.rst} (100%) rename Documentation/{DMA-ISA-LPC.txt => core-api/dma-isa-lpc.rst} (98%) rename Documentation/{IRQ.txt => core-api/irq/concepts.rst} (100%) create mode 100644 Documentation/core-api/irq/index.rst rename Documentation/{IRQ-affinity.txt => core-api/irq/irq-affinity.rst} (100%) rename Documentation/{IRQ-domain.txt => core-api/irq/irq-domain.rst} (99%) rename Documentation/{irqflags-tracing.txt => core-api/irq/irqflags-tracing.rst} (100%) rename Documentation/{kref.txt => core-api/kref.rst} (100%) rename Documentation/{mailbox.txt => core-api/mailbox.rst} (100%) rename Documentation/{nommu-mmap.txt => core-api/nommu-mmap.rst} (100%) rename Documentation/{this_cpu_ops.txt => core-api/this_cpu_ops.rst} (100%) rename Documentation/{unaligned-memory-access.txt => core-api/unaligned-memory-access.rst} (100%) rename Documentation/{IPMI.txt => driver-api/ipmi.rst} (100%) rename Documentation/{futex-requeue-pi.txt => locking/futex-requeue-pi.rst} (100%) rename Documentation/{hwspinlock.txt => locking/hwspinlock.rst} (100%) rename Documentation/{percpu-rw-semaphore.txt => locking/percpu-rw-semaphore.rst} (100%) rename Documentation/{pi-futex.txt => locking/pi-futex.rst} (100%) rename Documentation/{preempt-locking.txt => locking/preempt-locking.rst} (100%) rename Documentation/{robust-futex-ABI.txt => locking/robust-futex-ABI.rst} (100%) rename Documentation/{robust-futexes.txt => locking/robust-futexes.rst} (100%) rename Documentation/{digsig.txt => security/digsig.rst} (100%) rename Documentation/{crc32.txt => staging/crc32.rst} (100%) create mode 100644 Documentation/staging/index.rst rename Documentation/{kprobes.txt => staging/kprobes.rst} (100%) rename Documentation/{lzo.txt => staging/lzo.rst} (100%) rename Documentation/{remoteproc.txt => staging/remoteproc.rst} (99%) rename Documentation/{rpmsg.txt => staging/rpmsg.rst} (100%) rename Documentation/{speculation.txt => staging/speculation.rst} (97%) rename Documentation/{static-keys.txt => staging/static-keys.rst} (100%) rename Documentation/{tee.txt => staging/tee.rst} (99%) rename Documentation/{xz.txt => staging/xz.rst} (100%) -- 2.25.4 _______________________________________________ iommu mailing list iommu@lists.linux-foundation.org https://lists.linuxfoundation.org/mailman/listinfo/iommu