Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1422950AbbENW5c (ORCPT ); Thu, 14 May 2015 18:57:32 -0400 Received: from ozlabs.org ([103.22.144.67]:57836 "EHLO ozlabs.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1422888AbbENW5b (ORCPT ); Thu, 14 May 2015 18:57:31 -0400 Message-ID: <1431644248.2981.1.camel@ellerman.id.au> Subject: Re: [PATCH v2] Documentation/arch: Add kernel feature descriptions and arch support status under Documentation/features/ From: Michael Ellerman To: Andrew Morton Cc: Ingo Molnar , Josh Triplett , Borislav Petkov , Jonathan Corbet , Peter Zijlstra , Andy Lutomirski , Ingo Molnar , "H. Peter Anvin" , Thomas Gleixner , Linus Torvalds , linux-api@vger.kernel.org, linux-kernel@vger.kernel.org, x86@kernel.org, linux-arch@vger.kernel.org Date: Fri, 15 May 2015 08:57:28 +1000 In-Reply-To: <20150514123835.1bf436bc35d711f8dbf9bc0f@linux-foundation.org> References: <20150513083441.GA17336@gmail.com> <20150513085636.GA11030@gmail.com> <20150513092421.GB11030@gmail.com> <20150513094622.GC11030@gmail.com> <20150513094756.GD11030@gmail.com> <20150513131835.GJ1517@pd.tnic> <20150513134842.GA1657@gmail.com> <20150513162757.GA21894@x> <20150513150523.ddd65d7cd51f820b78f0c8e3@linux-foundation.org> <20150514101518.GA27550@gmail.com> <20150514103544.GA7027@gmail.com> <20150514123835.1bf436bc35d711f8dbf9bc0f@linux-foundation.org> Content-Type: text/plain; charset="UTF-8" X-Mailer: Evolution 3.12.10-0ubuntu1~14.10.1 Mime-Version: 1.0 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1496 Lines: 39 On Thu, 2015-05-14 at 12:38 -0700, Andrew Morton wrote: > > Add arch support matrices for more than 40 generic kernel features > > that need per architecture support. > > > > Each feature has its own directory under Documentation/features/feature_name/, > > and the arch-support.txt file shows its current arch porting status. > > It would be nice to provide people with commit IDs to look at, but the > IDs won't be known at the time the documentation file is created. We > could provide patch titles. +1 on patch titles. > But still, let's not overdo it - get something in there, see how well > it works, evolve it over time. > > I don't think we've heard from any (non-x86) arch maintainers? Do they > consider this useful at all? Poke. Yes it is. I have my own version I've cobbled together for powerpc, but this is much better. I'd like to see more description in the individual files of what the feature is, and preferably some pointers to what's needed to implement it. The kconfig for HAVE_ARCH_SECCOMP_FILTER is a good example of what I mean. I realise retrofitting that for all these existing features is quite time consuming, but for new features hopefully the bar can be raised a little in terms of that description. cheers -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/