From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1945915AbXBBQS4 (ORCPT ); Fri, 2 Feb 2007 11:18:56 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1945932AbXBBQS4 (ORCPT ); Fri, 2 Feb 2007 11:18:56 -0500 Received: from nic.NetDirect.CA ([216.16.235.2]:45897 "EHLO rubicon.netdirect.ca" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1945915AbXBBQSz (ORCPT ); Fri, 2 Feb 2007 11:18:55 -0500 X-Originating-Ip: 74.109.98.130 Date: Fri, 2 Feb 2007 11:17:25 -0500 (EST) From: "Robert P. J. Day" X-X-Sender: rpjday@CPE00045a9c397f-CM001225dbafb6 To: Linux kernel mailing list Subject: [PATCH] KCONFIG: Add the maturity level categories DEPRECATED and OBSOLETE. Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Net-Direct-Inc-MailScanner-Information: Please contact the ISP for more information X-Net-Direct-Inc-MailScanner: Found to be clean X-Net-Direct-Inc-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-16.8, required 5, autolearn=not spam, ALL_TRUSTED -1.80, BAYES_00 -15.00) X-Net-Direct-Inc-MailScanner-From: rpjday@mindspring.com Sender: linux-kernel-owner@vger.kernel.org X-Mailing-List: linux-kernel@vger.kernel.org In addition to EXPERIMENTAL and BROKEN, define the maturity level options DEPRECATED and OBSOLETE. Signed-off-by: Robert P. J. Day --- we'd discussed this a while back but nothing seemed to be finalized one way or the other so, as a followup to the exchange summarized here: http://kerneltrap.org/node/7593 add those two new categories, without actually changing the current status of any existing config options, so the current build should be unaffected by this patch alone. diff --git a/init/Kconfig b/init/Kconfig index a3f83e2..acc0052 100644 --- a/init/Kconfig +++ b/init/Kconfig @@ -29,9 +29,10 @@ config EXPERIMENTAL , and in the kernel source). - This option will also make obsoleted drivers available. These are - drivers that have been replaced by something else, and/or are - scheduled to be removed in a future kernel release. + At the moment, this option also makes obsolete drivers available, + but such drivers really should be removed from the EXPERIMENTAL + category and added to either DEPRECATED or OBSOLETE, depending + on their status. Unless you intend to help test and develop a feature or driver that falls into this category, or you have a situation that requires @@ -40,6 +41,29 @@ config EXPERIMENTAL you say Y here, you will be offered the choice of using features or drivers that are currently considered to be in the alpha-test phase. +config DEPRECATED + bool "Prompt for deprecated code/drivers" + default y + ---help--- + Code that is tagged as "deprecated" is officially still available + for use but will typically have already been scheduled for removal + at some point, so it's in your best interests to start looking for + an alternative. + + Check the file Documentation/feature-removal-schedule.txt to see + if a particular feature has an official scheduled removal date. + +config OBSOLETE + bool "Prompt for obsolete code/drivers" + default n + ---help--- + Code that is tagged as "obsolete" is officially no longer supported + and shouldn't play a part in any normal build, but those features + might still be available if you absolutely need access to them. + + You are *strongly* discouraged from continuing to depend on + obsolete code on an ongoing, long-term basis. + config BROKEN bool -- ======================================================================== Robert P. J. Day Linux Consulting, Training and Annoying Kernel Pedantry Waterloo, Ontario, CANADA http://www.fsdev.dreamhosters.com/wiki/index.php?title=Main_Page ========================================================================