Documentation: better locations for sysfs-pci, sysfs-tagging
Subsystems (3)
PATCH v2 1/1 Documentation: better locations for sysfs-pci, sysfs-tagging
sysfs-pci and sysfs-tagging were mis-filed: their locations within 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 to PCI, and move sysfs-tagging to networking. (Thanks to Jonathan Corbet for coming up with the final locations.)
---
Changes since v1: moved sysfs-pci to PCI, and sysfs-tagging to networking, and poked around in the generated HTML via Firefox. It looks like the right place now.
thanks,
John Hubbard
NVIDIA
Documentation/PCI/index.rst | 1 +
Documentation/{filesystems => PCI}/sysfs-pci.rst | 0
Documentation/filesystems/index.rst | 2 --
Documentation/networking/index.rst | 1 +
Documentation/{filesystems => networking}/sysfs-tagging.rst | 0
5 files changed, 2 insertions(+), 2 deletions(-)
rename Documentation/{filesystems => PCI}/sysfs-pci.rst (100%)
rename Documentation/{filesystems => networking}/sysfs-tagging.rst (100%)Documentation/PCI/index.rst +1 -0
@@ -12,6 +12,7 @@ Linux PCI Bus Subsystem pciebus-howto pci-iov-howto msi-howto + sysfs-pci acpi-info pci-error-recovery pcieaer-howto
Documentation/PCI/sysfs-pci.rst renamed from Documentation/filesystems/sysfs-pci.rst +0 -0
Documentation/filesystems/index.rst +0 -2
@@ -34,8 +34,6 @@ algorithms work. quota seq_file sharedsubtree - sysfs-pci - sysfs-tagging automount-support
Documentation/networking/index.rst +1 -0
@@ -95,6 +95,7 @@ Contents: seg6-sysctl strparser switchdev + sysfs-tagging tc-actions-env-rules tcp-thin team
Documentation/networking/sysfs-tagging.rst renamed from Documentation/filesystems/sysfs-tagging.rst +0 -0
Signature · 1 line
2.28.0
Quoted 5 lines · On Fri, 9 Oct 2020 00:01:28 -0700 John Hubbard <[email protected]> wrote:
sysfs-pci and sysfs-tagging were mis-filed: their locations within
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.
Quoted 8 lines
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 to PCI, and move sysfs-tagging to networking. (Thanks to Jonathan Corbet for coming up with the final locations.)
Signed-off-by John Hubbard <[email protected]>
Applied, thanks.
jon