2006-03-22 00:31:14

by Randy Dunlap

[permalink] [raw]
Subject: [PATCH/RFC] expose Doc/ source files

From: Randy Dunlap <[email protected]>

I propose that we expose example and tool source files in the
Documentation/ directory in their own files instead of being
buried (almost hidden) in readme/txt or shar files.

This will make them more visible/usable to users who may need
to use them, to developers who may need to test with them, and
to janitors who would update them if they were more visible.

Also, if any of these possibly should not be in the kernel tree at
all, it will be clearer that they are here and we can discuss if
they should be removed.


Signed-off-by: Randy Dunlap <[email protected]>
---
Documentation/block/ionice.c | 110
Documentation/block/ioprio.txt | 118
Documentation/dnotify.txt | 38
Documentation/dnotify_example.c | 34
Documentation/dslm.c | 165 +
Documentation/hpet.txt | 272 -
Documentation/hpet_example.c | 267 +
Documentation/java.txt | 201 -
Documentation/javaclassname.c | 194 +
Documentation/jprobe-example.c | 56
Documentation/kprobe_example.c | 65
Documentation/kprobes.txt | 180 -
Documentation/kretprobe-example.c | 53
Documentation/laptop-mode.txt | 168 -
Documentation/mtrr-add.c | 96
Documentation/mtrr-show.c | 83
Documentation/mtrr.txt | 183 -
Documentation/pcmcia/crc32hash.c | 32
Documentation/pcmcia/devicetable.txt | 34
Documentation/rtc-test.c | 213 +
Documentation/rtc.txt | 216 -
Documentation/s390/Debugging390.txt | 63
Documentation/s390/hex2ascii.c | 58
Documentation/sharedsubtree.txt | 79
Documentation/smount.c | 72
Documentation/sound/oss/MultiSound | 1509 ++---------
Documentation/sound/oss/MultiSound.d/Makefile | 8
Documentation/sound/oss/MultiSound.d/conv.l | 8
Documentation/sound/oss/MultiSound.d/msndreset.c | 55
Documentation/sound/oss/MultiSound.d/pinnaclecfg.c | 432 +++
Documentation/sound/oss/MultiSound.d/setdigital.c | 78
Documentation/sound/oss/rme96xx | 736 -----
Documentation/sound/oss/rmectrl.c | 255 +
Documentation/sound/oss/xrmectrl | 469 +++
Documentation/video4linux/CQcam.txt | 204 -
Documentation/video4linux/v4lgrab.c | 192 +
Documentation/vm/hugepage-mmap.c | 74
Documentation/vm/hugepage-shm.c | 71
Documentation/vm/hugetlbpage.txt | 150 -
Documentation/watchdog/pcwd-watchdog.txt | 73
Documentation/watchdog/watchdog-api.txt | 14
Documentation/watchdog/watchdog-simple.c | 19
Documentation/watchdog/watchdog-test.c | 68
Documentation/watchdog/watchdog.txt | 23
44 files changed, 3634 insertions(+), 3854 deletions(-)
---

patch file (234 KB) is at:
http://www.xenotime.net/linux/patches/linux-2616-doc-sources.patch

Note: Several source files in Documentation/ have build errors.
I have patches for those also, but I'll wait on sending those.
---