kconfig: update user kconfig tools doc.
Update Documentation/kbuild/kconfig.txt, which mostly contains user help for using the kernel config tools. - Add mention of 'nconfig' embedded help text. - Make the section on new config symbols readable. - Correct how to find menuconfig search help. - Add section on 'nconfig' usage. - Mention that gconfig has multiple viewing modes/options. Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Signed-off-by: Masahiro Yamada <yamada.masahiro@socionext.com>
This commit is contained in:
parent
3f9cdee592
commit
452d4c8673
|
@ -2,9 +2,9 @@ This file contains some assistance for using "make *config".
|
||||||
|
|
||||||
Use "make help" to list all of the possible configuration targets.
|
Use "make help" to list all of the possible configuration targets.
|
||||||
|
|
||||||
The xconfig ('qconf') and menuconfig ('mconf') programs also
|
The xconfig ('qconf'), menuconfig ('mconf'), and nconfig ('nconf')
|
||||||
have embedded help text. Be sure to check it for navigation,
|
programs also have embedded help text. Be sure to check that for
|
||||||
search, and other general help text.
|
navigation, search, and other general help text.
|
||||||
|
|
||||||
======================================================================
|
======================================================================
|
||||||
General
|
General
|
||||||
|
@ -17,13 +17,16 @@ this happens, using a previously working .config file and running
|
||||||
for you, so you may find that you need to see what NEW kernel
|
for you, so you may find that you need to see what NEW kernel
|
||||||
symbols have been introduced.
|
symbols have been introduced.
|
||||||
|
|
||||||
To see a list of new config symbols when using "make oldconfig", use
|
To see a list of new config symbols, use
|
||||||
|
|
||||||
cp user/some/old.config .config
|
cp user/some/old.config .config
|
||||||
make listnewconfig
|
make listnewconfig
|
||||||
|
|
||||||
and the config program will list any new symbols, one per line.
|
and the config program will list any new symbols, one per line.
|
||||||
|
|
||||||
|
Alternatively, you can use the brute force method:
|
||||||
|
|
||||||
|
make oldconfig
|
||||||
scripts/diffconfig .config.old .config | less
|
scripts/diffconfig .config.old .config | less
|
||||||
|
|
||||||
______________________________________________________________________
|
______________________________________________________________________
|
||||||
|
@ -160,7 +163,7 @@ Searching in menuconfig:
|
||||||
This lists all config symbols that contain "hotplug",
|
This lists all config symbols that contain "hotplug",
|
||||||
e.g., HOTPLUG_CPU, MEMORY_HOTPLUG.
|
e.g., HOTPLUG_CPU, MEMORY_HOTPLUG.
|
||||||
|
|
||||||
For search help, enter / followed TAB-TAB-TAB (to highlight
|
For search help, enter / followed by TAB-TAB (to highlight
|
||||||
<Help>) and Enter. This will tell you that you can also use
|
<Help>) and Enter. This will tell you that you can also use
|
||||||
regular expressions (regexes) in the search string, so if you
|
regular expressions (regexes) in the search string, so if you
|
||||||
are not interested in MEMORY_HOTPLUG, you could try
|
are not interested in MEMORY_HOTPLUG, you could try
|
||||||
|
@ -202,6 +205,39 @@ Example:
|
||||||
make MENUCONFIG_MODE=single_menu menuconfig
|
make MENUCONFIG_MODE=single_menu menuconfig
|
||||||
|
|
||||||
|
|
||||||
|
======================================================================
|
||||||
|
nconfig
|
||||||
|
--------------------------------------------------
|
||||||
|
|
||||||
|
nconfig is an alternate text-based configurator. It lists function
|
||||||
|
keys across the bottom of the terminal (window) that execute commands.
|
||||||
|
You can also just use the corresponding numeric key to execute the
|
||||||
|
commands unless you are in a data entry window. E.g., instead of F6
|
||||||
|
for Save, you can just press 6.
|
||||||
|
|
||||||
|
Use F1 for Global help or F3 for the Short help menu.
|
||||||
|
|
||||||
|
Searching in nconfig:
|
||||||
|
|
||||||
|
You can search either in the menu entry "prompt" strings
|
||||||
|
or in the configuration symbols.
|
||||||
|
|
||||||
|
Use / to begin a search through the menu entries. This does
|
||||||
|
not support regular expressions. Use <Down> or <Up> for
|
||||||
|
Next hit and Previous hit, respectively. Use <Esc> to
|
||||||
|
terminate the search mode.
|
||||||
|
|
||||||
|
F8 (SymSearch) searches the configuration symbols for the
|
||||||
|
given string or regular expression (regex).
|
||||||
|
|
||||||
|
NCONFIG_MODE
|
||||||
|
--------------------------------------------------
|
||||||
|
This mode shows all sub-menus in one large tree.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
make NCONFIG_MODE=single_menu nconfig
|
||||||
|
|
||||||
|
|
||||||
======================================================================
|
======================================================================
|
||||||
xconfig
|
xconfig
|
||||||
--------------------------------------------------
|
--------------------------------------------------
|
||||||
|
@ -230,8 +266,7 @@ gconfig
|
||||||
|
|
||||||
Searching in gconfig:
|
Searching in gconfig:
|
||||||
|
|
||||||
None (gconfig isn't maintained as well as xconfig or menuconfig);
|
There is no search command in gconfig. However, gconfig does
|
||||||
however, gconfig does have a few more viewing choices than
|
have several different viewing choices, modes, and options.
|
||||||
xconfig does.
|
|
||||||
|
|
||||||
###
|
###
|
||||||
|
|
Loading…
Reference in New Issue
Block a user