lkml.org 
[lkml]   [2006]   [Apr]   [12]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
Patch in this message
/
Date
From
Subject[PATCH] config: update usage/help info
On Wed, 12 Apr 2006 18:59:29 +0200 Sam Ravnborg wrote:

> > IMO the main points/questions are:
> >
> > - where to document the command-line options and environment variables
> > (including the recent KCONFIG_CONFIG): in a usage() function or in
> > Documentation/kbuild/usage.txt file?
>
> The latter...
> make help was the other alternative and it is too big already.
>
> For kbuild I also need to add some stuff.

Here's a shot at it, although it seemed that top-level README was
sufficient for the make *config additions. We can move whatever you
think should be moved to a new file.
(This is missing a recent KCONFIG_OVERWRITECONFIG environment variable
that I think Roman just added.)
---

From: Randy Dunlap <rdunlap@xenotime.net>

Replace outdated help message with a reference to README.
Update README for make *config variants and environment
variable info.

Signed-off-by: Randy Dunlap <rdunlap@xenotime.net>
---
README | 23 ++++++++++++++++++++++-
scripts/kconfig/conf.c | 3 ++-
2 files changed, 24 insertions(+), 2 deletions(-)

--- linux-2617-rc1.orig/scripts/kconfig/conf.c
+++ linux-2617-rc1/scripts/kconfig/conf.c
@@ -5,6 +5,7 @@

#include <ctype.h>
#include <stdlib.h>
+#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <time.h>
@@ -546,7 +547,7 @@ int main(int ac, char **av)
break;
case 'h':
case '?':
- printf("%s [-o|-s] config\n", av[0]);
+ fprintf(stderr, "See README for usage info\n");
exit(0);
}
}
--- linux-2617-rc1.orig/README
+++ linux-2617-rc1/README
@@ -165,10 +165,31 @@ CONFIGURING the kernel:
"make xconfig" X windows (Qt) based configuration tool.
"make gconfig" X windows (Gtk) based configuration tool.
"make oldconfig" Default all questions based on the contents of
- your existing ./.config file.
+ your existing ./.config file and asking about
+ new config symbols.
"make silentoldconfig"
Like above, but avoids cluttering the screen
with questions already answered.
+ "make defconfig" Create a ./.config file by using the default
+ symbol values from arch/$ARCH/defconfig.
+ "make allyesconfig"
+ Create a ./.config file by setting symbol
+ values to 'y' as much as possible.
+ "make allmodconfig"
+ Create a ./.config file by setting symbol
+ values to 'm' as much as possible.
+ "make allnoconfig" Create a ./.config file by setting symbol
+ values to 'n' as much as possible.
+ "make randconfig" Create a ./.config file by setting symbol
+ values to random values.
+
+ The allyesconfig/allmodconfig/allnoconfig/randconfig variants can
+ also use the environment variable KCONFIG_ALLCONFIG to specify a
+ filename that contains config options that the user requires to be
+ set to a specific value. If KCONFIG_ALLCONFIG=filename is not used,
+ "make *config" checks for a file named "all{yes/mod/no/random}.config"
+ for symbol values that are to be forced. If this file is not found,
+ it checks for a file named "all.config" to contain forced values.

NOTES on "make config":
- having unnecessary drivers will make the kernel bigger, and can
-
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/
\
 
 \ /
  Last update: 2006-04-12 20:57    [W:0.038 / U:1.024 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site