diff options
| author | Linus Torvalds <torvalds@ppc970.osdl.org> | 2005-01-14 20:21:18 -0800 |
|---|---|---|
| committer | Linus Torvalds <torvalds@ppc970.osdl.org> | 2005-01-14 20:21:18 -0800 |
| commit | ec6d84c7ef684a0b85d15c50dadef9a039574d03 (patch) | |
| tree | 09ca81e4358f95d7ef7c3378e76c112c51b18c20 /scripts/README.Menuconfig | |
| parent | f1707e2da28f0799cabfef2af47c3af0789cfffa (diff) | |
| parent | 7a81787b813bc78a43d7bb76fe1d57d0d552873d (diff) | |
Merge bk://linux-sam.bkbits.net/kconfig
into ppc970.osdl.org:/home/torvalds/v2.6/linux
Diffstat (limited to 'scripts/README.Menuconfig')
| -rw-r--r-- | scripts/README.Menuconfig | 201 |
1 files changed, 0 insertions, 201 deletions
diff --git a/scripts/README.Menuconfig b/scripts/README.Menuconfig deleted file mode 100644 index 89ec0f24e14f..000000000000 --- a/scripts/README.Menuconfig +++ /dev/null @@ -1,201 +0,0 @@ -Menuconfig gives the Linux kernel configuration a long needed face -lift. Featuring text based color menus and dialogs, it does not -require X Windows (however, you need ncurses in order to use it). -With this utility you can easily select a kernel option to modify -without sifting through 100 other options. - -Overview --------- -Some kernel features may be built directly into the kernel. -Some may be made into loadable runtime modules. Some features -may be completely removed altogether. There are also certain -kernel parameters which are not really features, but must be -entered in as decimal or hexadecimal numbers or possibly text. - -Menu items beginning with [*], <M> or [ ] represent features -configured to be built in, modularized or removed respectively. -Pointed brackets <> represent module capable features. - more... - -To change any of these features, highlight it with the cursor -keys and press <Y> to build it in, <M> to make it a module or -<N> to removed it. You may also press the <Space Bar> to cycle -through the available options (ie. Y->N->M->Y). - -Items beginning with numbers or other text within parenthesis can -be changed by highlighting the item and pressing <Enter>. Then -enter the new parameter into the dialog box that pops up. - - -Some additional keyboard hints: - -Menus ----------- -o Use the Up/Down arrow keys (cursor keys) to highlight the item - you wish to change or submenu wish to select and press <Enter>. - Submenus are designated by "--->". - - Shortcut: Press the option's highlighted letter (hotkey). - Pressing a hotkey more than once will sequence - through all visible items which use that hotkey. - - You may also use the <PAGE UP> and <PAGE DOWN> keys to scroll - unseen options into view. - -o To exit a menu use the cursor keys to highlight the <Exit> button - and press <ENTER>. - - Shortcut: Press <ESC><ESC> or <E> or <X> if there is no hotkey - using those letters. You may press a single <ESC>, but - there is a delayed response which you may find annoying. - - Also, the <TAB> and cursor keys will cycle between <Select>, - <Exit> and <Help> - -o To get help with an item, use the cursor keys to highlight <Help> - and Press <ENTER>. - - Shortcut: Press <H> or <?>. - - -Radiolists (Choice lists) ------------ -o Use the cursor keys to select the option you wish to set and press - <S> or the <SPACE BAR>. - - Shortcut: Press the first letter of the option you wish to set then - press <S> or <SPACE BAR>. - -o To see available help for the item, use the cursor keys to highlight - <Help> and Press <ENTER>. - - Shortcut: Press <H> or <?>. - - Also, the <TAB> and cursor keys will cycle between <Select> and - <Help> - - -Data Entry ------------ -o Enter the requested information and press <ENTER> - If you are entering hexadecimal values, it is not necessary to - add the '0x' prefix to the entry. - -o For help, use the <TAB> or cursor keys to highlight the help option - and press <ENTER>. You can try <TAB><H> as well. - - -Text Box (Help Window) --------- -o Use the cursor keys to scroll up/down/left/right. The VI editor - keys h,j,k,l function here as do <SPACE BAR> and <B> for those - who are familiar with less and lynx. - -o Press <E>, <X>, <Enter> or <Esc><Esc> to exit. - - -Final Acceptance ----------------- -With the exception of the old style sound configuration, -YOUR CHANGES ARE NOT FINAL. You will be given a last chance to -confirm them prior to exiting Menuconfig. - -If Menuconfig quits with an error while saving your configuration, -you may look in the file /usr/src/linux/.menuconfig.log for -information which may help you determine the cause. - -Alternate Configuration Files ------------------------------ -Menuconfig supports the use of alternate configuration files for -those who, for various reasons, find it necessary to switch -between different kernel configurations. - -At the end of the main menu you will find two options. One is -for saving the current configuration to a file of your choosing. -The other option is for loading a previously saved alternate -configuration. - -Even if you don't use alternate configuration files, but you -find during a Menuconfig session that you have completely messed -up your settings, you may use the "Load Alternate..." option to -restore your previously saved settings from ".config" without -restarting Menuconfig. - -Other information ------------------ -The windowing utility, lxdialog, will only be rebuilt if your kernel -source tree is fresh, or changes are patched into it via a kernel -patch or you do 'make mrproper'. If changes to lxdialog are patched -in, most likely the rebuild time will be short. You may force a -complete rebuild of lxdialog by changing to its directory and doing -'make clean all' - -If you use Menuconfig in an XTERM window make sure you have your -$TERM variable set to point to a xterm definition which supports color. -Otherwise, Menuconfig will look rather bad. Menuconfig will not -display correctly in a RXVT window because rxvt displays only one -intensity of color, bright. - -Menuconfig will display larger menus on screens or xterms which are -set to display more than the standard 25 row by 80 column geometry. -In order for this to work, the "stty size" command must be able to -display the screen's current row and column geometry. I STRONGLY -RECOMMEND that you make sure you do NOT have the shell variables -LINES and COLUMNS exported into your environment. Some distributions -export those variables via /etc/profile. Some ncurses programs can -become confused when those variables (LINES & COLUMNS) don't reflect -the true screen size. - - -NOTICE: lxdialog requires the ncurses libraries to compile. If you - don't already have ncurses you really should get it. - - The makefile for lxdialog attempts to find your ncurses - header file. Although it should find the header for older - versions of ncurses, it is probably a good idea to get the - latest ncurses anyway. - - If you have upgraded your ncurses libraries, MAKE SURE you - remove the old ncurses header files. If you don't you - will most certainly get a segmentation fault. - -WARNING: It is not recommended that you change any defines in - lxdialog's header files. If you have a grayscale display and - are brave, you may tinker with color.h to tune the colors to - your preference. - -COMPATIBILITY ISSUE: - There have been some compatibility problems reported with - older versions of bash and sed. I am trying to work these - out but it is preferable that you upgrade those utilities. - - -******** IMPORTANT, OPTIONAL ALTERNATE PERSONALITY AVAILABLE ******** -******** ******** -If you prefer to have all of the kernel options listed in a single -menu, rather than the default multimenu hierarchy, run the menuconfig -with MENUCONFIG_MODE environment variable set to single_menu. Example: - -make menuconfig MENUCONFIG_MODE=single_menu - -<Enter> will then unroll the appropriate category, or enfold it if it -is already unrolled. - -Note that this mode can eventually be a little more CPU expensive -(especially with a larger number of unrolled categories) than the -default mode. -********************************************************************* - - -Propaganda ----------- -The windowing support utility (lxdialog) is a VERY modified version of -the dialog utility by Savio Lam <lam836@cs.cuhk.hk>. Although lxdialog -is significantly different from dialog, I have left Savio's copyrights -intact. Please DO NOT contact Savio with questions about lxdialog. -He will not be able to assist. - -William Roadcap was the original author of Menuconfig. -Michael Elizabeth Chastain <mec@shout.net> is the current maintainer. - -<END OF FILE> |
