[RFC PATCH] Documentation/arch: Add Documentation/arch-TODO
From: Ingo Molnar <hidden>
Date: 2015-05-13 08:34:52
Also in:
linux-arch, lkml
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
* Andrew Morton [off-list ref] wrote:
On Tue, 12 May 2015 23:38:43 +0200 Peter Zijlstra [off-list ref] wrote:quoted
quoted
with the expectation that other architectures will follow along, but this doesn't happen. The arch maintainers simply didn't know about it or nobody nags them. Nothing happens and inconsistencies hang around for years. eg, http://lkml.iu.edu/hypermail/linux/kernel/1504.2/04993.html I'm thinking we should find a way to do this better. One way might be to maintain a Documentation/arch-todo which identifies each item, has a little list of what-to-do instructions and perhaps a list of the not-yet-done architectures. Basically a way for everyone to communicate at the arch maintainers.If only there was a linux-arch list to which arch maintainers should subscribe... oh wait :-)It was I who got linux-arch established, so I'm fairly familiar with it. (12 years ago, gad). I don't think it's been very successful, particularly for this purpose. A whole pile of randomly cc'ed lkml overflow which we're relying on each individual maintainer to sift through and pluck out particular action items then later remember to implement them. It's disorganized and has too many cracks for things to fall through.
Yes, a mailing list is indeed not a very good TODO list. We need a persistent post-it, and Documentation/arch-TODO (note the capital letters, we might as well shout?) sounds like a good place. I'd suggest making it tabular, as per the patch below. If it gets too large we can split it into multiple tables. I'd like people to have a good look whether I messed up any entry, and I'd be happy to add new items as well. Thanks, Ingo =======================>
From 33a487046b16971564d323079f66fb63aa870f4d Mon Sep 17 00:00:00 2001
From: Ingo Molnar <redacted> Date: Wed, 13 May 2015 10:30:11 +0200 Subject: [PATCH] Documentation/arch: Add Documentation/arch-TODO Add a TODO list for missing/incomplete architecture support for generic kernel features. Signed-off-by: Ingo Molnar <redacted> --- Documentation/arch-TODO | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+)
diff --git a/Documentation/arch-TODO b/Documentation/arch-TODO
new file mode 100644
index 000000000000..bfa289639b1c
--- /dev/null
+++ b/Documentation/arch-TODO@@ -0,0 +1,47 @@ + +For generic kernel features that need architecture support, this is +the feature support matrix, for all upstream Linux architectures: + + ELF-ASLR:----------------------------------------------------------. + clockevents:---------------------------------------------------. | +modern-timekeeping:--------------------------------------------. | | + kgdb:-------------------------------------. | | | + context-tracking:------------------------------. | | | | + seccomp-filter:-----------------------. | | | | | + jump-labels:----------------. | | | | | | + stackprotector:---------. | | | | | | | + lockdep:--. | | | | | | | | + | | | | | | | | | +---------------------------------------------------------------------------------- + alpha | TODO | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | + arc | ok | TODO | TODO | TODO | TODO | ok | ok | ok | TODO | + arm | ok | ok | ok | ok | ok | ok | TODO | ok | ok | + arm64 | ok | ok | ok | ok | ok | ok | ok | ok | ok | + avr32 | ok | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | + blackfin | ok | TODO | TODO | TODO | TODO | ok | TODO | ok | TODO | + c6x | TODO | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | + cris | TODO | TODO | TODO | TODO | TODO | TODO | TODO | ok | TODO | + frv | TODO | TODO | TODO | TODO | TODO | TODO | ok | TODO | TODO | + hexagon | ok | TODO | TODO | TODO | TODO | ok | ok | ok | TODO | + ia64 | TODO | TODO | TODO | TODO | TODO | TODO | ok | TODO | TODO | + m32r | TODO | TODO | TODO | TODO | TODO | TODO | TODO | TODO | TODO | + m68k | TODO | TODO | TODO | TODO | TODO | TODO | TODO | ok | TODO | + metag | ok | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | + microblaze | ok | TODO | TODO | TODO | TODO | ok | ok | ok | TODO | + mips | ok | ok | ok | ok | ok | ok | ok | ok | ok | + mn10300 | TODO | TODO | TODO | TODO | TODO | ok | ok | ok | TODO | + nios2 | TODO | TODO | TODO | TODO | TODO | ok | ok | ok | TODO | + openrisc | TODO | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | + parisc | TODO | TODO | TODO | TODO | TODO | TODO | ok | TODO | TODO | + powerpc | ok | TODO | ok | TODO | TODO | ok | ok | ok | ok | + s390 | ok | TODO | ok | ok | TODO | TODO | ok | ok | ok | + score | ok | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | + sh | ok | ok | TODO | TODO | TODO | ok | ok | ok | TODO | + sparc | ok | TODO | ok | TODO | ok | ok | ok | ok | TODO | + tile | ok | TODO | TODO | TODO | ok | ok | ok | ok | TODO | + um | ok | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | + unicore32 | ok | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | + x86 | ok | ok | ok | ok | ok | ok | ok | ok | ok | + xtensa | ok | TODO | TODO | TODO | TODO | TODO | ok | ok | TODO | +---------------------------------------------------------------------------------- +