aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/filesystems
diff options
context:
space:
mode:
authorHenrik Austad <henrik@austad.us>2018-09-03 18:15:23 -0400
committerJonathan Corbet <corbet@lwn.net>2018-09-09 17:08:58 -0400
commita7ddcea58ae22d85d94eabfdd3de75c3742e376b (patch)
treeab90291f7fee502aa96f8eb436dd6653116add86 /Documentation/filesystems
parent9d92e4835ffce841a72e9cf6d1c022adc55428aa (diff)
Drop all 00-INDEX files from Documentation/
This is a respin with a wider audience (all that get_maintainer returned) and I know this spams a *lot* of people. Not sure what would be the correct way, so my apologies for ruining your inbox. The 00-INDEX files are supposed to give a summary of all files present in a directory, but these files are horribly out of date and their usefulness is brought into question. Often a simple "ls" would reveal the same information as the filenames are generally quite descriptive as a short introduction to what the file covers (it should not surprise anyone what Documentation/sched/sched-design-CFS.txt covers) A few years back it was mentioned that these files were no longer really needed, and they have since then grown further out of date, so perhaps it is time to just throw them out. A short status yields the following _outdated_ 00-INDEX files, first counter is files listed in 00-INDEX but missing in the directory, last is files present but not listed in 00-INDEX. List of outdated 00-INDEX: Documentation: (4/10) Documentation/sysctl: (0/1) Documentation/timers: (1/0) Documentation/blockdev: (3/1) Documentation/w1/slaves: (0/1) Documentation/locking: (0/1) Documentation/devicetree: (0/5) Documentation/power: (1/1) Documentation/powerpc: (0/5) Documentation/arm: (1/0) Documentation/x86: (0/9) Documentation/x86/x86_64: (1/1) Documentation/scsi: (4/4) Documentation/filesystems: (2/9) Documentation/filesystems/nfs: (0/2) Documentation/cgroup-v1: (0/2) Documentation/kbuild: (0/4) Documentation/spi: (1/0) Documentation/virtual/kvm: (1/0) Documentation/scheduler: (0/2) Documentation/fb: (0/1) Documentation/block: (0/1) Documentation/networking: (6/37) Documentation/vm: (1/3) Then there are 364 subdirectories in Documentation/ with several files that are missing 00-INDEX alltogether (and another 120 with a single file and no 00-INDEX). I don't really have an opinion to whether or not we /should/ have 00-INDEX, but the above 00-INDEX should either be removed or be kept up to date. If we should keep the files, I can try to keep them updated, but I rather not if we just want to delete them anyway. As a starting point, remove all index-files and references to 00-INDEX and see where the discussion is going. Signed-off-by: Henrik Austad <henrik@austad.us> Acked-by: "Paul E. McKenney" <paulmck@linux.vnet.ibm.com> Just-do-it-by: Steven Rostedt <rostedt@goodmis.org> Reviewed-by: Jens Axboe <axboe@kernel.dk> Acked-by: Paul Moore <paul@paul-moore.com> Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Mike Rapoport <rppt@linux.vnet.ibm.com> Cc: [Almost everybody else] Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Diffstat (limited to 'Documentation/filesystems')
-rw-r--r--Documentation/filesystems/00-INDEX153
-rw-r--r--Documentation/filesystems/nfs/00-INDEX26
2 files changed, 0 insertions, 179 deletions
diff --git a/Documentation/filesystems/00-INDEX b/Documentation/filesystems/00-INDEX
deleted file mode 100644
index 0937bade1099..000000000000
--- a/Documentation/filesystems/00-INDEX
+++ /dev/null
@@ -1,153 +0,0 @@
100-INDEX
2 - this file (info on some of the filesystems supported by linux).
3Locking
4 - info on locking rules as they pertain to Linux VFS.
59p.txt
6 - 9p (v9fs) is an implementation of the Plan 9 remote fs protocol.
7adfs.txt
8 - info and mount options for the Acorn Advanced Disc Filing System.
9afs.txt
10 - info and examples for the distributed AFS (Andrew File System) fs.
11affs.txt
12 - info and mount options for the Amiga Fast File System.
13autofs-mount-control.txt
14 - info on device control operations for autofs module.
15automount-support.txt
16 - information about filesystem automount support.
17befs.txt
18 - information about the BeOS filesystem for Linux.
19bfs.txt
20 - info for the SCO UnixWare Boot Filesystem (BFS).
21btrfs.txt
22 - info for the BTRFS filesystem.
23caching/
24 - directory containing filesystem cache documentation.
25ceph.txt
26 - info for the Ceph Distributed File System.
27cifs/
28 - directory containing CIFS filesystem documentation and example code.
29coda.txt
30 - description of the CODA filesystem.
31configfs/
32 - directory containing configfs documentation and example code.
33cramfs.txt
34 - info on the cram filesystem for small storage (ROMs etc).
35dax.txt
36 - info on avoiding the page cache for files stored on CPU-addressable
37 storage devices.
38debugfs.txt
39 - info on the debugfs filesystem.
40devpts.txt
41 - info on the devpts filesystem.
42directory-locking
43 - info about the locking scheme used for directory operations.
44dlmfs.txt
45 - info on the userspace interface to the OCFS2 DLM.
46dnotify.txt
47 - info about directory notification in Linux.
48dnotify_test.c
49 - example program for dnotify.
50ecryptfs.txt
51 - docs on eCryptfs: stacked cryptographic filesystem for Linux.
52efivarfs.txt
53 - info for the efivarfs filesystem.
54exofs.txt
55 - info, usage, mount options, design about EXOFS.
56ext2.txt
57 - info, mount options and specifications for the Ext2 filesystem.
58ext3.txt
59 - info, mount options and specifications for the Ext3 filesystem.
60ext4.txt
61 - info, mount options and specifications for the Ext4 filesystem.
62f2fs.txt
63 - info and mount options for the F2FS filesystem.
64fiemap.txt
65 - info on fiemap ioctl.
66files.txt
67 - info on file management in the Linux kernel.
68fuse.txt
69 - info on the Filesystem in User SpacE including mount options.
70gfs2-glocks.txt
71 - info on the Global File System 2 - Glock internal locking rules.
72gfs2-uevents.txt
73 - info on the Global File System 2 - uevents.
74gfs2.txt
75 - info on the Global File System 2.
76hfs.txt
77 - info on the Macintosh HFS Filesystem for Linux.
78hfsplus.txt
79 - info on the Macintosh HFSPlus Filesystem for Linux.
80hpfs.txt
81 - info and mount options for the OS/2 HPFS.
82inotify.txt
83 - info on the powerful yet simple file change notification system.
84isofs.txt
85 - info and mount options for the ISO 9660 (CDROM) filesystem.
86jfs.txt
87 - info and mount options for the JFS filesystem.
88locks.txt
89 - info on file locking implementations, flock() vs. fcntl(), etc.
90mandatory-locking.txt
91 - info on the Linux implementation of Sys V mandatory file locking.
92nfs/
93 - nfs-related documentation.
94nilfs2.txt
95 - info and mount options for the NILFS2 filesystem.
96ntfs.txt
97 - info and mount options for the NTFS filesystem (Windows NT).
98ocfs2.txt
99 - info and mount options for the OCFS2 clustered filesystem.
100omfs.txt
101 - info on the Optimized MPEG FileSystem.
102path-lookup.txt
103 - info on path walking and name lookup locking.
104pohmelfs/
105 - directory containing pohmelfs filesystem documentation.
106porting
107 - various information on filesystem porting.
108proc.txt
109 - info on Linux's /proc filesystem.
110qnx6.txt
111 - info on the QNX6 filesystem.
112quota.txt
113 - info on Quota subsystem.
114ramfs-rootfs-initramfs.txt
115 - info on the 'in memory' filesystems ramfs, rootfs and initramfs.
116relay.txt
117 - info on relay, for efficient streaming from kernel to user space.
118romfs.txt
119 - description of the ROMFS filesystem.
120seq_file.txt
121 - how to use the seq_file API.
122sharedsubtree.txt
123 - a description of shared subtrees for namespaces.
124spufs.txt
125 - info and mount options for the SPU filesystem used on Cell.
126squashfs.txt
127 - info on the squashfs filesystem.
128sysfs-pci.txt
129 - info on accessing PCI device resources through sysfs.
130sysfs-tagging.txt
131 - info on sysfs tagging to avoid duplicates.
132sysfs.txt
133 - info on sysfs, a ram-based filesystem for exporting kernel objects.
134sysv-fs.txt
135 - info on the SystemV/V7/Xenix/Coherent filesystem.
136tmpfs.txt
137 - info on tmpfs, a filesystem that holds all files in virtual memory.
138ubifs.txt
139 - info on the Unsorted Block Images FileSystem.
140udf.txt
141 - info and mount options for the UDF filesystem.
142ufs.txt
143 - info on the ufs filesystem.
144vfat.txt
145 - info on using the VFAT filesystem used in Windows NT and Windows 95.
146vfs.txt
147 - overview of the Virtual File System.
148xfs-delayed-logging-design.txt
149 - info on the XFS Delayed Logging Design.
150xfs-self-describing-metadata.txt
151 - info on XFS Self Describing Metadata.
152xfs.txt
153 - info and mount options for the XFS filesystem.
diff --git a/Documentation/filesystems/nfs/00-INDEX b/Documentation/filesystems/nfs/00-INDEX
deleted file mode 100644
index 53f3b596ac0d..000000000000
--- a/Documentation/filesystems/nfs/00-INDEX
+++ /dev/null
@@ -1,26 +0,0 @@
100-INDEX
2 - this file (nfs-related documentation).
3Exporting
4 - explanation of how to make filesystems exportable.
5fault_injection.txt
6 - information for using fault injection on the server
7knfsd-stats.txt
8 - statistics which the NFS server makes available to user space.
9nfs.txt
10 - nfs client, and DNS resolution for fs_locations.
11nfs41-server.txt
12 - info on the Linux server implementation of NFSv4 minor version 1.
13nfs-rdma.txt
14 - how to install and setup the Linux NFS/RDMA client and server software
15nfsd-admin-interfaces.txt
16 - Administrative interfaces for nfsd.
17nfsroot.txt
18 - short guide on setting up a diskless box with NFS root filesystem.
19pnfs.txt
20 - short explanation of some of the internals of the pnfs client code
21rpc-cache.txt
22 - introduction to the caching mechanisms in the sunrpc layer.
23idmapper.txt
24 - information for configuring request-keys to be used by idmapper
25rpc-server-gss.txt
26 - Information on GSS authentication support in the NFS Server