Henrik Austad
a7ddcea58a
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>
2018-09-09 15:08:58 -06:00
..
ABI
platform-drivers-x86 for v4.19-1
2018-08-22 14:14:15 -07:00
accelerators
accounting
acpi
ACPI: property: graph: Update graph documentation to use generic references
2018-07-23 12:44:52 +02:00
admin-guide
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
aoe
arm
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
arm64
auxdisplay
backlight
block
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
blockdev
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
bpf
Merge git://git.kernel.org/pub/scm/linux/kernel/git/bpf/bpf-next
2018-08-07 11:02:05 -07:00
bus-devices
cdrom
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
cgroup-v1
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
cma
connector
console
Documentation: corrections to console/console.txt
2018-08-10 16:09:40 -06:00
core-api
docs/core-api: mm-api: add section about GFP flags
2018-08-23 18:48:43 -07:00
cpu-freq
cpuidle
crypto
crypto: remove redundant type flags from tfm allocation
2018-07-09 00:30:29 +08:00
dev-tools
docs: dev-tools: coccinelle: Update documentation
2018-08-31 16:51:59 -06:00
device-mapper
dm thin: include metadata_low_watermark threshold in pool status
2018-07-30 11:49:08 -04:00
devicetree
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
doc-guide
Documentation/sphinx: allow "functions" with no parameters
2018-06-30 07:52:42 -06:00
driver-api
FireWire: add driver-api Introduction section
2018-09-06 09:41:16 -06:00
driver-model
dmaengine: add a new helper dmaenginem_async_device_register
2018-07-30 10:50:22 +05:30
early-userspace
initramfs: move gen_initramfs_list.sh from scripts/ to usr/
2018-08-22 23:21:44 +09:00
EDID
extcon
fault-injection
fb
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
features
ARM: 8777/1: Hook up SYNC_CORE functionality for sys_membarrier()
2018-07-11 11:02:08 +01:00
filesystems
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
firmware_class
fmc
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
fpga
docs: fpga: add a document for FPGA Device Feature List (DFL) Framework Overview
2018-07-15 13:55:44 +02:00
gpio
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
gpu
drm/msm/gpu: Add the buffer objects from the submit to the crash dump
2018-07-30 08:50:10 -04:00
hid
hwmon
ARM: SoC driver updates
2018-08-23 13:52:46 -07:00
i2c
i2c: ocores: update my email address
2018-08-24 14:46:43 +02:00
ia64
ide
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
iio
infiniband
input
input: add MT_TOOL_DIAL
2018-07-17 15:33:47 +02:00
ioctl
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
isdn
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
kbuild
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
kdump
kernel-hacking
doc:it_IT: translation for kernel-hacking
2018-07-26 16:21:09 -06:00
laptops
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
leds
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
lightnvm
livepatch
locking
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
m68k
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
maintainer
docs: Fix more broken references
2018-06-15 18:11:26 -03:00
md
media
media: doc: media/v4l-drivers: Update Qualcomm CAMSS driver document for 8x96
2018-08-02 08:48:00 -04:00
memory-devices
mic
mips
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
misc-devices
pci_endpoint_test: Add 2 ioctl commands
2018-07-19 11:46:57 +01:00
mmc
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
mtd
namespaces
netlabel
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
networking
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
nfc
nios2
nvdimm
nvmem
openrisc
parisc
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
PCI
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
pcmcia
pcmcia: remove long deprecated pcmcia_request_exclusive_irq() function
2018-08-18 12:30:42 -07:00
perf
phy
platform
power
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
powerpc
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
pps
process
docs: tidy up TOCs and refs to license-rules.rst
2018-08-31 16:50:50 -06:00
pti
ptp
rapidio
RCU
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
riscv
s390
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
scheduler
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
scsi
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
security
Kbuild: rename CC_STACKPROTECTOR[_STRONG] config variables
2018-06-14 12:21:18 +09:00
serial
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
sh
sound
ASoC: Updates for v4.19
2018-08-13 12:12:31 +02:00
sparc
sphinx
Documentation/sphinx: allow "functions" with no parameters
2018-06-30 07:52:42 -06:00
sphinx-static
spi
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
sysctl
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
target
thermal
timers
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
trace
docs: tracing: Add stacktrace filter command
2018-08-31 16:34:49 -06:00
translations
This was a moderately busy cycle for docs, with the usual collection of
2018-08-14 14:29:31 -07:00
usb
USB-serial updates for v4.19-rc1
2018-07-20 21:47:15 +02:00
userspace-api
virtual
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
vm
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
w1
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
watchdog
wimax
x86
Drop all 00-INDEX files from Documentation/
2018-09-09 15:08:58 -06:00
xtensa
.gitignore
atomic_bitops.txt
atomic_t.txt
bt8xxgpio.txt
btmrvl.txt
bus-virt-phys-mapping.txt
Changes
clearing-warn-once.txt
CodingStyle
conf.py
ext4: import inode data fork chapter from wiki page
2018-07-29 15:45:00 -04:00
cpu-load.txt
cputopology.txt
crc32.txt
dcdbas.txt
debugging-modules.txt
debugging-via-ohci1394.txt
dell_rbu.txt
digsig.txt
DMA-API-HOWTO.txt
DMA-API.txt
DMA-attributes.txt
DMA-ISA-LPC.txt
docutils.conf
dontdiff
efi-stub.txt
efi_stub: update documentation on dtb= parameter
2018-09-09 14:46:44 -06:00
eisa.txt
flexible-arrays.txt
futex-requeue-pi.txt
gcc-plugins.txt
highuid.txt
hw_random.txt
hwspinlock.txt
index.rst
docs: tidy up TOCs and refs to license-rules.rst
2018-08-31 16:50:50 -06:00
Intel-IOMMU.txt
intel_txt.txt
io-mapping.txt
io_ordering.txt
iostats.txt
block: Track DISCARD statistics and output them in stat and diskstat
2018-07-18 08:44:22 -06:00
IPMI.txt
IRQ-affinity.txt
IRQ-domain.txt
IRQ.txt
irqflags-tracing.txt
isa.txt
isapnp.txt
kernel-per-CPU-kthreads.txt
kobject.txt
kprobes.txt
kprobes/Documentation: Fix various typos
2018-06-22 11:10:55 +02:00
kref.txt
ldm.txt
lockup-watchdogs.txt
logo.gif
logo.txt
lsm.txt
lzo.txt
mailbox.txt
Makefile
memory-barriers.txt
sched/Documentation: Update wake_up() & co. memory-barrier guarantees
2018-07-17 09:30:34 +02:00
memory-hotplug.txt
men-chameleon-bus.txt
nommu-mmap.txt
Documentation: nommu-map: Fix duplicate word typo
2018-06-26 09:01:27 -06:00
ntb.txt
numastat.txt
padata.txt
parport-lowlevel.txt
percpu-rw-semaphore.txt
phy.txt
pi-futex.txt
pnp.txt
preempt-locking.txt
pwm.txt
rbtree.txt
remoteproc.txt
rfkill.txt
rfkill: Fix several typos in documentation
2018-06-15 13:36:08 +02:00
robust-futex-ABI.txt
robust-futexes.txt
rpmsg.txt
rtc.txt
SAK.txt
sgi-ioc4.txt
siphash.txt
SM501.txt
smsc_ece1099.txt
speculation.txt
static-keys.txt
SubmittingPatches
svga.txt
switchtec.txt
sync_file.txt
tee.txt
this_cpu_ops.txt
unaligned-memory-access.txt
vfio-mediated-device.txt
vfio.txt
video-output.txt
xillybus.txt
xz.txt
zorro.txt