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,USER_AGENT_GIT autolearn=unavailable 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 20D18C4CECC for ; Mon, 27 Apr 2020 21:23:38 +0000 (UTC) Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (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 C147B20728 for ; Mon, 27 Apr 2020 21:23:37 +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="P4ErDB3U" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org C147B20728 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=linuxppc-dev-bounces+linuxppc-dev=archiver.kernel.org@lists.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 499ySQ33l2zDqgx for ; Tue, 28 Apr 2020 07:23:34 +1000 (AEST) Authentication-Results: lists.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=kernel.org (client-ip=198.145.29.99; helo=mail.kernel.org; envelope-from=mchehab@kernel.org; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=pass (p=none dis=none) header.from=kernel.org Authentication-Results: lists.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256 header.s=default header.b=P4ErDB3U; dkim-atps=neutral Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 499yKL4yL1zDqgB for ; Tue, 28 Apr 2020 07:17:26 +1000 (AEST) 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 C5F552075E; Mon, 27 Apr 2020 21:17:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1588022243; bh=diHIQNdW9tXwNaigHoaDIpMGH+WAB2UEy0sdibZm2Fc=; h=From:To:Cc:Subject:Date:From; b=P4ErDB3UqWrQeqbLqijoEa8kkqGyrk6Qu0y5yI2MKzjqNm6ch/xu4WEb6bki8G/bw w+R3JWBW/0iVAtsV2f2EZCbEipIeFB47JUs0l47yQSuVBVgGt6XiHW+EvIw5b5nHYD JW8gpsqNwh6fZ1haUh2NStOV0V/kj5diMisolXXs= Received: from mchehab by mail.kernel.org with local (Exim 4.92.3) (envelope-from ) id 1jTB7y-000Hjc-03; Mon, 27 Apr 2020 23:17:22 +0200 From: Mauro Carvalho Chehab To: Linux Doc Mailing List Subject: [PATCH v3 00/29] Convert files to ReST - part 2 Date: Mon, 27 Apr 2020 23:16:52 +0200 Message-Id: X-Mailer: git-send-email 2.25.4 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: linuxppc-dev@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Linux on PowerPC Developers Mail List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Jonathan Corbet , Mauro Carvalho Chehab , linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org, codalist@coda.cs.cmu.edu, linux-xfs@vger.kernel.org, linux-cachefs@redhat.com, linux-fsdevel@vger.kernel.org, linuxppc-dev@lists.ozlabs.org Errors-To: linuxppc-dev-bounces+linuxppc-dev=archiver.kernel.org@lists.ozlabs.org Sender: "Linuxppc-dev" This is the second part of a series I wrote sometime ago where I manually convert lots of files to be properly parsed by Sphinx as ReST files. As it touches on lot of stuff, this series is based on today's linux-next, at tag next-20190617. The first version of this series had 57 patches. The first part with 28 patches were already merged. Right now, there are still ~76 patches pending applying (including this series), and that's because I opted to do ~1 patch per converted directory. That sounds too much to be send on a single round. So, I'm opting to split it on 3 parts for the conversion, plus a final patch adding orphaned books to existing ones. Those patches should probably be good to be merged either by subsystem maintainers or via the docs tree. I opted to mark new files not included yet to the main index.rst (directly or indirectly) with the :orphan: tag, in order to avoid adding warnings to the build system. This should be removed after we find a "home" for all the converted files within the new document tree arrangement, after I submit the third part. Both this series and the other parts of this work are on my devel git tree, at: https://git.linuxtv.org/mchehab/experimental.git/log/?h=convert_rst_renames_v5.1 The final output in html (after all patches I currently have, including the upcoming series) can be seen at: https://www.infradead.org/~mchehab/rst_conversion/ It contains all pending work from my side related to the conversion, plus the patches I finished a first version today with contains the renaming patches and de-orphan changes. --- Version 3: - Rebased on the top of next-20200424 - configfs.rst conversion moved to the end of the series; - avoided almost all markups at configfs.rst while still preserving a reasonable output and not generating build warnings. Version 2: - Removed patches merged via other trees; - rebased on the top of today's linux-next (next-20190617); - Fix a typo on one patch's description; - Added received acks. Mauro Carvalho Chehab (29): docs: filesystems: convert caching/object.txt to ReST docs: filesystems: convert caching/fscache.txt to ReST format docs: filesystems: caching/netfs-api.txt: convert it to ReST docs: filesystems: caching/operations.txt: convert it to ReST docs: filesystems: caching/cachefiles.txt: convert to ReST docs: filesystems: caching/backend-api.txt: convert it to ReST docs: filesystems: convert cifs/cifsroot.txt to ReST docs: filesystems: convert automount-support.txt to ReST docs: filesystems: convert coda.txt to ReST docs: filesystems: convert devpts.txt to ReST docs: filesystems: convert dnotify.txt to ReST docs: filesystems: convert fiemap.txt to ReST docs: filesystems: convert files.txt to ReST docs: filesystems: convert fuse-io.txt to ReST docs: filesystems: convert locks.txt to ReST docs: filesystems: convert mandatory-locking.txt to ReST docs: filesystems: convert mount_api.txt to ReST docs: filesystems: convert quota.txt to ReST docs: filesystems: convert seq_file.txt to ReST docs: filesystems: convert sharedsubtree.txt to ReST docs: filesystems: split spufs.txt into 3 separate files docs: filesystems: convert spufs/spu_create.txt to ReST docs: filesystems: convert spufs/spufs.txt to ReST docs: filesystems: convert spufs/spu_run.txt to ReST docs: filesystems: convert sysfs-pci.txt to ReST docs: filesystems: convert sysfs-tagging.txt to ReST docs: filesystems: convert xfs-delayed-logging-design.txt to ReST docs: filesystems: convert xfs-self-describing-metadata.txt to ReST docs: filesystems: convert configfs.txt to ReST Documentation/admin-guide/sysctl/kernel.rst | 2 +- ...ount-support.txt => automount-support.rst} | 23 +- .../{backend-api.txt => backend-api.rst} | 165 +- .../{cachefiles.txt => cachefiles.rst} | 139 +- Documentation/filesystems/caching/fscache.rst | 565 ++++++ Documentation/filesystems/caching/fscache.txt | 448 ----- Documentation/filesystems/caching/index.rst | 14 + .../caching/{netfs-api.txt => netfs-api.rst} | 172 +- .../caching/{object.txt => object.rst} | 43 +- .../{operations.txt => operations.rst} | 45 +- .../cifs/{cifsroot.txt => cifsroot.rst} | 56 +- Documentation/filesystems/coda.rst | 1670 ++++++++++++++++ Documentation/filesystems/coda.txt | 1676 ----------------- .../{configfs/configfs.txt => configfs.rst} | 131 +- Documentation/filesystems/devpts.rst | 36 + Documentation/filesystems/devpts.txt | 26 - .../filesystems/{dnotify.txt => dnotify.rst} | 11 +- .../filesystems/{fiemap.txt => fiemap.rst} | 133 +- .../filesystems/{files.txt => files.rst} | 15 +- .../filesystems/{fuse-io.txt => fuse-io.rst} | 6 + Documentation/filesystems/index.rst | 23 + .../filesystems/{locks.txt => locks.rst} | 14 +- ...tory-locking.txt => mandatory-locking.rst} | 25 +- .../{mount_api.txt => mount_api.rst} | 329 ++-- Documentation/filesystems/proc.rst | 2 +- .../filesystems/{quota.txt => quota.rst} | 41 +- .../{seq_file.txt => seq_file.rst} | 61 +- .../{sharedsubtree.txt => sharedsubtree.rst} | 394 ++-- Documentation/filesystems/spufs/index.rst | 13 + .../filesystems/spufs/spu_create.rst | 131 ++ Documentation/filesystems/spufs/spu_run.rst | 138 ++ .../{spufs.txt => spufs/spufs.rst} | 304 +-- .../{sysfs-pci.txt => sysfs-pci.rst} | 23 +- .../{sysfs-tagging.txt => sysfs-tagging.rst} | 22 +- ...ign.txt => xfs-delayed-logging-design.rst} | 65 +- ...a.txt => xfs-self-describing-metadata.rst} | 182 +- Documentation/iio/iio_configfs.rst | 2 +- Documentation/usb/gadget_configfs.rst | 4 +- MAINTAINERS | 14 +- fs/cachefiles/Kconfig | 4 +- fs/coda/Kconfig | 2 +- fs/configfs/inode.c | 2 +- fs/configfs/item.c | 2 +- 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/locks.c | 2 +- include/linux/configfs.h | 2 +- include/linux/fs_context.h | 2 +- include/linux/fscache-cache.h | 4 +- include/linux/fscache.h | 42 +- include/linux/lsm_hooks.h | 2 +- 54 files changed, 3843 insertions(+), 3408 deletions(-) rename Documentation/filesystems/{automount-support.txt => automount-support.rst} (92%) rename Documentation/filesystems/caching/{backend-api.txt => backend-api.rst} (87%) rename Documentation/filesystems/caching/{cachefiles.txt => cachefiles.rst} (90%) create mode 100644 Documentation/filesystems/caching/fscache.rst delete mode 100644 Documentation/filesystems/caching/fscache.txt create mode 100644 Documentation/filesystems/caching/index.rst rename Documentation/filesystems/caching/{netfs-api.txt => netfs-api.rst} (91%) rename Documentation/filesystems/caching/{object.txt => object.rst} (95%) rename Documentation/filesystems/caching/{operations.txt => operations.rst} (90%) rename Documentation/filesystems/cifs/{cifsroot.txt => cifsroot.rst} (72%) create mode 100644 Documentation/filesystems/coda.rst delete mode 100644 Documentation/filesystems/coda.txt rename Documentation/filesystems/{configfs/configfs.txt => configfs.rst} (87%) create mode 100644 Documentation/filesystems/devpts.rst delete mode 100644 Documentation/filesystems/devpts.txt rename Documentation/filesystems/{dnotify.txt => dnotify.rst} (90%) rename Documentation/filesystems/{fiemap.txt => fiemap.rst} (70%) rename Documentation/filesystems/{files.txt => files.rst} (95%) rename Documentation/filesystems/{fuse-io.txt => fuse-io.rst} (95%) rename Documentation/filesystems/{locks.txt => locks.rst} (91%) rename Documentation/filesystems/{mandatory-locking.txt => mandatory-locking.rst} (91%) rename Documentation/filesystems/{mount_api.txt => mount_api.rst} (79%) rename Documentation/filesystems/{quota.txt => quota.rst} (81%) rename Documentation/filesystems/{seq_file.txt => seq_file.rst} (92%) rename Documentation/filesystems/{sharedsubtree.txt => sharedsubtree.rst} (72%) create mode 100644 Documentation/filesystems/spufs/index.rst create mode 100644 Documentation/filesystems/spufs/spu_create.rst create mode 100644 Documentation/filesystems/spufs/spu_run.rst rename Documentation/filesystems/{spufs.txt => spufs/spufs.rst} (57%) rename Documentation/filesystems/{sysfs-pci.txt => sysfs-pci.rst} (92%) rename Documentation/filesystems/{sysfs-tagging.txt => sysfs-tagging.rst} (72%) rename Documentation/filesystems/{xfs-delayed-logging-design.txt => xfs-delayed-logging-design.rst} (97%) rename Documentation/filesystems/{xfs-self-describing-metadata.txt => xfs-self-describing-metadata.rst} (83%) -- 2.25.4