linux-kernel - [PATCH] Documentation: filesystems: better locations for sysfs-pci, sysfs-tagging

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <20201007233151.490953-1-jhubbard@nvidia.com>
Date:   Wed, 7 Oct 2020 16:31:51 -0700
From:   John Hubbard <jhubbard@...dia.com>
To:     Jonathan Corbet <corbet@....net>
CC:     Mauro Carvalho Chehab <mchehab+huawei@...nel.org>,
        Jan Kara <jack@...e.cz>, David Sterba <dsterba@...e.com>,
        <linux-doc@...r.kernel.org>, LKML <linux-kernel@...r.kernel.org>,
        John Hubbard <jhubbard@...dia.com>
Subject: [PATCH] Documentation: filesystems: better locations for sysfs-pci, sysfs-tagging

sysfs-pci and sysfs-tagging were mis-filed: their locations with
Documentation/ implied that they were related to file systems. Actually,
each topic is about a very specific *use* of sysfs, and sysfs *happens*
to be a (virtual) filesystem, so this is not really the right place.

It's jarring to be reading about filesystems in general and then come
across these specific details about PCI, and tagging...and then back to
general filesystems again.

Move sysfs-pci and sysfs-tagging to a location under the sysfs topic.

Signed-off-by: John Hubbard <jhubbard@...dia.com>
---

Hi,

I'm not sure if the "toctree, maxdepth: 1" is the ideal way to do this, 
but the output in the browser looks about right to me, anyway.

thanks,
John Hubbard
NVIDIA

 Documentation/filesystems/index.rst |  2 --
 Documentation/filesystems/sysfs.rst | 14 ++++++++++++++
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst
index 4c536e66dc4c..98f59a864242 100644
--- a/Documentation/filesystems/index.rst
+++ b/Documentation/filesystems/index.rst
@@ -34,8 +34,6 @@ algorithms work.
    quota
    seq_file
    sharedsubtree
-   sysfs-pci
-   sysfs-tagging
 
    automount-support
 
diff --git a/Documentation/filesystems/sysfs.rst b/Documentation/filesystems/sysfs.rst
index ab0f7795792b..39da2f5c235f 100644
--- a/Documentation/filesystems/sysfs.rst
+++ b/Documentation/filesystems/sysfs.rst
@@ -416,3 +416,17 @@ ABI between the kernel and user space. As for any ABI, it is important that
 this ABI is stable and properly documented. All new sysfs attributes must be
 documented in Documentation/ABI. See also Documentation/ABI/README for more
 information.
+
+sysfs and PCI
+~~~~~~~~~~~~~
+.. toctree::
+   :maxdepth: 1
+
+   sysfs-pci
+
+sysfs and tagging
+~~~~~~~~~~~~~~~~~
+.. toctree::
+   :maxdepth: 1
+
+   sysfs-tagging
-- 
2.28.0