2 * Copyright (C) 2002 Roman Zippel <zippel@linux-m68k.org>
3 * Released under the terms of the GNU GPL v2.0.
5 * Introduced single menu mode (show all sub-menus in one large tree).
6 * 2002-11-06 Petr Baudis <pasky@ucw.cz>
8 * i18n, 2005, Arnaldo Carvalho de Melo <acme@conectiva.com.br>
23 #include "lxdialog/dialog.h"
25 static const char mconf_readme
[] = N_(
28 "This interface let you select features and parameters for the build.\n"
29 "Features can either be built-in, modularized, or ignored. Parameters\n"
30 "must be entered in as decimal or hexadecimal numbers or text.\n"
32 "Menu items beginning with following braces represent features that\n"
33 " [ ] can be built in or removed\n"
34 " < > can be built in, modularized or removed\n"
35 " { } can be built in or modularized (selected by other feature)\n"
36 " - - are selected by other feature,\n"
37 "while *, M or whitespace inside braces means to build in, build as\n"
38 "a module or to exclude the feature respectively.\n"
40 "To change any of these features, highlight it with the cursor\n"
41 "keys and press <Y> to build it in, <M> to make it a module or\n"
42 "<N> to removed it. You may also press the <Space Bar> to cycle\n"
43 "through the available options (ie. Y->N->M->Y).\n"
45 "Some additional keyboard hints:\n"
49 "o Use the Up/Down arrow keys (cursor keys) to highlight the item\n"
50 " you wish to change or submenu wish to select and press <Enter>.\n"
51 " Submenus are designated by \"--->\".\n"
53 " Shortcut: Press the option's highlighted letter (hotkey).\n"
54 " Pressing a hotkey more than once will sequence\n"
55 " through all visible items which use that hotkey.\n"
57 " You may also use the <PAGE UP> and <PAGE DOWN> keys to scroll\n"
58 " unseen options into view.\n"
60 "o To exit a menu use the cursor keys to highlight the <Exit> button\n"
61 " and press <ENTER>.\n"
63 " Shortcut: Press <ESC><ESC> or <E> or <X> if there is no hotkey\n"
64 " using those letters. You may press a single <ESC>, but\n"
65 " there is a delayed response which you may find annoying.\n"
67 " Also, the <TAB> and cursor keys will cycle between <Select>,\n"
68 " <Exit> and <Help>.\n"
70 "o To get help with an item, use the cursor keys to highlight <Help>\n"
71 " and press <ENTER>.\n"
73 " Shortcut: Press <H> or <?>.\n"
75 "o To toggle the display of hidden options, press <Z>.\n"
78 "Radiolists (Choice lists)\n"
80 "o Use the cursor keys to select the option you wish to set and press\n"
81 " <S> or the <SPACE BAR>.\n"
83 " Shortcut: Press the first letter of the option you wish to set then\n"
84 " press <S> or <SPACE BAR>.\n"
86 "o To see available help for the item, use the cursor keys to highlight\n"
87 " <Help> and Press <ENTER>.\n"
89 " Shortcut: Press <H> or <?>.\n"
91 " Also, the <TAB> and cursor keys will cycle between <Select> and\n"
97 "o Enter the requested information and press <ENTER>\n"
98 " If you are entering hexadecimal values, it is not necessary to\n"
99 " add the '0x' prefix to the entry.\n"
101 "o For help, use the <TAB> or cursor keys to highlight the help option\n"
102 " and press <ENTER>. You can try <TAB><H> as well.\n"
105 "Text Box (Help Window)\n"
107 "o Use the cursor keys to scroll up/down/left/right. The VI editor\n"
108 " keys h,j,k,l function here as do <SPACE BAR> and <B> for those\n"
109 " who are familiar with less and lynx.\n"
111 "o Press <E>, <X>, <Enter> or <Esc><Esc> to exit.\n"
114 "Alternate Configuration Files\n"
115 "-----------------------------\n"
116 "Menuconfig supports the use of alternate configuration files for\n"
117 "those who, for various reasons, find it necessary to switch\n"
118 "between different configurations.\n"
120 "At the end of the main menu you will find two options. One is\n"
121 "for saving the current configuration to a file of your choosing.\n"
122 "The other option is for loading a previously saved alternate\n"
125 "Even if you don't use alternate configuration files, but you\n"
126 "find during a Menuconfig session that you have completely messed\n"
127 "up your settings, you may use the \"Load Alternate...\" option to\n"
128 "restore your previously saved settings from \".config\" without\n"
129 "restarting Menuconfig.\n"
131 "Other information\n"
132 "-----------------\n"
133 "If you use Menuconfig in an XTERM window make sure you have your\n"
134 "$TERM variable set to point to a xterm definition which supports color.\n"
135 "Otherwise, Menuconfig will look rather bad. Menuconfig will not\n"
136 "display correctly in a RXVT window because rxvt displays only one\n"
137 "intensity of color, bright.\n"
139 "Menuconfig will display larger menus on screens or xterms which are\n"
140 "set to display more than the standard 25 row by 80 column geometry.\n"
141 "In order for this to work, the \"stty size\" command must be able to\n"
142 "display the screen's current row and column geometry. I STRONGLY\n"
143 "RECOMMEND that you make sure you do NOT have the shell variables\n"
144 "LINES and COLUMNS exported into your environment. Some distributions\n"
145 "export those variables via /etc/profile. Some ncurses programs can\n"
146 "become confused when those variables (LINES & COLUMNS) don't reflect\n"
147 "the true screen size.\n"
149 "Optional personality available\n"
150 "------------------------------\n"
151 "If you prefer to have all of the options listed in a single menu, rather\n"
152 "than the default multimenu hierarchy, run the menuconfig with\n"
153 "MENUCONFIG_MODE environment variable set to single_menu. Example:\n"
155 "make MENUCONFIG_MODE=single_menu menuconfig\n"
157 "<Enter> will then unroll the appropriate category, or enfold it if it\n"
158 "is already unrolled.\n"
160 "Note that this mode can eventually be a little more CPU expensive\n"
161 "(especially with a larger number of unrolled categories) than the\n"
164 "Different color themes available\n"
165 "--------------------------------\n"
166 "It is possible to select different color themes using the variable\n"
167 "MENUCONFIG_COLOR. To select a theme use:\n"
169 "make MENUCONFIG_COLOR=<theme> menuconfig\n"
171 "Available themes are\n"
172 " mono => selects colors suitable for monochrome displays\n"
173 " blackbg => selects a color scheme with black background\n"
174 " classic => theme with blue background. The classic look\n"
175 " bluetitle => a LCD friendly version of classic. (default)\n"
177 menu_instructions
[] = N_(
178 "Arrow keys navigate the menu. "
179 "<Enter> selects submenus --->. "
180 "Highlighted letters are hotkeys. "
181 "Pressing <Y> includes, <N> excludes, <M> modularizes features. "
182 "Press <Esc><Esc> to exit, <?> for Help, </> for Search. "
183 "Legend: [*] built-in [ ] excluded <M> module < > module capable"),
184 radiolist_instructions
[] = N_(
185 "Use the arrow keys to navigate this window or "
186 "press the hotkey of the item you wish to select "
187 "followed by the <SPACE BAR>. "
188 "Press <?> for additional information about this option."),
189 inputbox_instructions_int
[] = N_(
190 "Please enter a decimal value. "
191 "Fractions will not be accepted. "
192 "Use the <TAB> key to move from the input field to the buttons below it."),
193 inputbox_instructions_hex
[] = N_(
194 "Please enter a hexadecimal value. "
195 "Use the <TAB> key to move from the input field to the buttons below it."),
196 inputbox_instructions_string
[] = N_(
197 "Please enter a string value. "
198 "Use the <TAB> key to move from the input field to the buttons below it."),
200 "This feature depends on another which has been configured as a module.\n"
201 "As a result, this feature will be built as a module."),
202 load_config_text
[] = N_(
203 "Enter the name of the configuration file you wish to load. "
204 "Accept the name shown to restore the configuration you "
205 "last retrieved. Leave blank to abort."),
206 load_config_help
[] = N_(
208 "For various reasons, one may wish to keep several different\n"
209 "configurations available on a single machine.\n"
211 "If you have saved a previous configuration in a file other than the\n"
212 "default one, entering its name here will allow you to modify that\n"
215 "If you are uncertain, then you have probably never used alternate\n"
216 "configuration files. You should therefore leave this blank to abort.\n"),
217 save_config_text
[] = N_(
218 "Enter a filename to which this configuration should be saved "
219 "as an alternate. Leave blank to abort."),
220 save_config_help
[] = N_(
222 "For various reasons, one may wish to keep different configurations\n"
223 "available on a single machine.\n"
225 "Entering a file name here will allow you to later retrieve, modify\n"
226 "and use the current configuration as an alternate to whatever\n"
227 "configuration options you have selected at that time.\n"
229 "If you are uncertain what all this means then you should probably\n"
230 "leave this blank.\n"),
233 "Search for symbols and display their relations.\n"
234 "Regular expressions are allowed.\n"
235 "Example: search for \"^FOO\"\n"
237 "-----------------------------------------------------------------\n"
239 "Prompt: Foo bus is used to drive the bar HW\n"
240 "Defined at drivers/pci/Kconfig:47\n"
241 "Depends on: X86_LOCAL_APIC && X86_IO_APIC || IA64\n"
243 " -> Bus options (PCI, PCMCIA, EISA, MCA, ISA)\n"
244 " -> PCI support (PCI [=y])\n"
245 " -> PCI access mode (<choice> [=y])\n"
246 "Selects: LIBCRC32\n"
248 "-----------------------------------------------------------------\n"
249 "o The line 'Prompt:' shows the text used in the menu structure for\n"
251 "o The 'Defined at' line tell at what file / line number the symbol\n"
253 "o The 'Depends on:' line tell what symbols needs to be defined for\n"
254 " this symbol to be visible in the menu (selectable)\n"
255 "o The 'Location:' lines tell where in the menu structure this symbol\n"
257 " A location followed by a [=y] indicate that this is a selectable\n"
258 " menu item - and current value is displayed inside brackets.\n"
259 "o The 'Selects:' line tell what symbol will be automatically\n"
260 " selected if this symbol is selected (y or m)\n"
261 "o The 'Selected by' line tell what symbol has selected this symbol\n"
263 "Only relevant lines are shown.\n"
266 "Examples: USB => find all symbols containing USB\n"
267 " ^USB => find all symbols starting with USB\n"
268 " USB$ => find all symbols ending with USB\n"
272 static struct menu
*current_menu
;
273 static int child_count
;
274 static int single_menu_mode
;
275 static int show_all_options
;
276 static int saved_x
, saved_y
;
278 static void conf(struct menu
*menu
);
279 static void conf_choice(struct menu
*menu
);
280 static void conf_string(struct menu
*menu
);
281 static void conf_load(void);
282 static void conf_save(void);
283 static void show_textbox(const char *title
, const char *text
, int r
, int c
);
284 static void show_helptext(const char *title
, const char *text
);
285 static void show_help(struct menu
*menu
);
287 static char filename
[PATH_MAX
+1];
288 static void set_config_filename(const char *config_filename
)
290 static char menu_backtitle
[PATH_MAX
+128];
293 size
= snprintf(menu_backtitle
, sizeof(menu_backtitle
),
294 "%s - %s", config_filename
, rootmenu
.prompt
->text
);
295 if (size
>= sizeof(menu_backtitle
))
296 menu_backtitle
[sizeof(menu_backtitle
)-1] = '\0';
297 set_dialog_backtitle(menu_backtitle
);
299 size
= snprintf(filename
, sizeof(filename
), "%s", config_filename
);
300 if (size
>= sizeof(filename
))
301 filename
[sizeof(filename
)-1] = '\0';
305 static void search_conf(void)
307 struct symbol
**sym_arr
;
313 dres
= dialog_inputbox(_("Search Configuration Parameter"),
314 _("Enter " CONFIG_
" (sub)string to search for "
315 "(with or without \"" CONFIG_
"\")"),
321 show_helptext(_("Search Configuration"), search_help
);
327 /* strip the prefix if necessary */
328 dialog_input
= dialog_input_result
;
329 if (strncasecmp(dialog_input_result
, CONFIG_
, strlen(CONFIG_
)) == 0)
330 dialog_input
+= strlen(CONFIG_
);
332 sym_arr
= sym_re_search(dialog_input
);
333 res
= get_relations_str(sym_arr
);
335 show_textbox(_("Search Results"), str_get(&res
), 0, 0);
339 static void build_conf(struct menu
*menu
)
342 struct property
*prop
;
344 int type
, tmp
, doint
= 2;
350 * note: menu_is_visible() has side effect that it will
351 * recalc the value of the symbol.
353 visible
= menu_is_visible(menu
);
354 if (show_all_options
&& !menu_has_prompt(menu
))
356 else if (!show_all_options
&& !visible
)
362 if (prop
&& menu
!= current_menu
) {
363 const char *prompt
= menu_get_prompt(menu
);
364 switch (prop
->type
) {
368 if (single_menu_mode
) {
370 menu
->data
? "-->" : "++>",
371 indent
+ 1, ' ', prompt
);
373 item_make(" %*c%s --->", indent
+ 1, ' ', prompt
);
377 if (single_menu_mode
&& menu
->data
)
383 item_make(" %*c*** %s ***", indent
+ 1, ' ', _(prompt
));
391 item_make("---%*c%s", indent
+ 1, ' ', _(prompt
));
401 type
= sym_get_type(sym
);
402 if (sym_is_choice(sym
)) {
403 struct symbol
*def_sym
= sym_get_choice_value(sym
);
404 struct menu
*def_menu
= NULL
;
407 for (child
= menu
->list
; child
; child
= child
->next
) {
408 if (menu_is_visible(child
) && child
->sym
== def_sym
)
412 val
= sym_get_tristate_value(sym
);
413 if (sym_is_changable(sym
)) {
416 item_make("[%c]", val
== no
? ' ' : '*');
420 case yes
: ch
= '*'; break;
421 case mod
: ch
= 'M'; break;
422 default: ch
= ' '; break;
424 item_make("<%c>", ch
);
431 item_set_tag(def_menu
? 't' : ':');
435 item_add_str("%*c%s", indent
+ 1, ' ', _(menu_get_prompt(menu
)));
438 item_add_str(" (%s)", _(menu_get_prompt(def_menu
)));
439 item_add_str(" --->");
440 if (def_menu
->list
) {
442 build_conf(def_menu
);
449 if (menu
== current_menu
) {
450 item_make("---%*c%s", indent
+ 1, ' ', _(menu_get_prompt(menu
)));
456 val
= sym_get_tristate_value(sym
);
457 if (sym_is_choice_value(sym
) && val
== yes
) {
464 if (sym_is_changable(sym
))
465 item_make("[%c]", val
== no
? ' ' : '*');
467 item_make("-%c-", val
== no
? ' ' : '*');
473 case yes
: ch
= '*'; break;
474 case mod
: ch
= 'M'; break;
475 default: ch
= ' '; break;
477 if (sym_is_changable(sym
)) {
478 if (sym
->rev_dep
.tri
== mod
)
479 item_make("{%c}", ch
);
481 item_make("<%c>", ch
);
483 item_make("-%c-", ch
);
488 tmp
= 2 + strlen(sym_get_string_value(sym
)); /* () = 2 */
489 item_make("(%s)", sym_get_string_value(sym
));
490 tmp
= indent
- tmp
+ 4;
493 item_add_str("%*c%s%s", tmp
, ' ', _(menu_get_prompt(menu
)),
494 (sym_has_value(sym
) || !sym_is_changable(sym
)) ?
501 item_add_str("%*c%s%s", indent
+ 1, ' ', _(menu_get_prompt(menu
)),
502 (sym_has_value(sym
) || !sym_is_changable(sym
)) ?
504 if (menu
->prompt
->type
== P_MENU
) {
505 item_add_str(" --->");
512 for (child
= menu
->list
; child
; child
= child
->next
)
517 static void conf(struct menu
*menu
)
519 struct menu
*submenu
;
520 const char *prompt
= menu_get_prompt(menu
);
522 struct menu
*active_menu
= NULL
;
532 if (menu
== &rootmenu
) {
535 item_make(_(" Load an Alternate Configuration File"));
537 item_make(_(" Save an Alternate Configuration File"));
541 res
= dialog_menu(prompt
? _(prompt
) : _("Main Menu"),
542 _(menu_instructions
),
543 active_menu
, &s_scroll
);
544 if (res
== 1 || res
== KEY_ESC
|| res
== -ERRDISPLAYTOOSMALL
)
546 if (!item_activate_selected())
551 submenu
= item_data();
552 active_menu
= item_data();
560 switch (item_tag()) {
562 if (single_menu_mode
)
563 submenu
->data
= (void *) (long) !submenu
->data
;
568 if (sym_is_choice(sym
) && sym_get_tristate_value(sym
) == yes
)
569 conf_choice(submenu
);
570 else if (submenu
->prompt
->type
== P_MENU
)
574 conf_string(submenu
);
588 show_helptext(_("README"), _(mconf_readme
));
591 if (item_is_tag('t')) {
592 if (sym_set_tristate_value(sym
, yes
))
594 if (sym_set_tristate_value(sym
, mod
))
595 show_textbox(NULL
, setmod_text
, 6, 74);
599 if (item_is_tag('t'))
600 sym_set_tristate_value(sym
, no
);
603 if (item_is_tag('t'))
604 sym_set_tristate_value(sym
, mod
);
607 if (item_is_tag('t'))
608 sym_toggle_tristate_value(sym
);
609 else if (item_is_tag('m'))
616 show_all_options
= !show_all_options
;
622 static void show_textbox(const char *title
, const char *text
, int r
, int c
)
625 dialog_textbox(title
, text
, r
, c
);
628 static void show_helptext(const char *title
, const char *text
)
630 show_textbox(title
, text
, 0, 0);
633 static void show_help(struct menu
*menu
)
635 struct gstr help
= str_new();
637 help
.max_width
= getmaxx(stdscr
) - 10;
638 menu_get_ext_help(menu
, &help
);
640 show_helptext(_(menu_get_prompt(menu
)), str_get(&help
));
644 static void conf_choice(struct menu
*menu
)
646 const char *prompt
= _(menu_get_prompt(menu
));
648 struct symbol
*active
;
650 active
= sym_get_choice_value(menu
->sym
);
657 for (child
= menu
->list
; child
; child
= child
->next
) {
658 if (!menu_is_visible(child
))
661 item_make("%s", _(menu_get_prompt(child
)));
663 item_make("*** %s ***", _(menu_get_prompt(child
)));
666 item_set_data(child
);
667 if (child
->sym
== active
)
668 item_set_selected(1);
669 if (child
->sym
== sym_get_choice_value(menu
->sym
))
673 res
= dialog_checklist(prompt
? _(prompt
) : _("Main Menu"),
674 _(radiolist_instructions
),
676 selected
= item_activate_selected();
684 sym_set_tristate_value(child
->sym
, yes
);
697 case -ERRDISPLAYTOOSMALL
:
703 static void conf_string(struct menu
*menu
)
705 const char *prompt
= menu_get_prompt(menu
);
711 switch (sym_get_type(menu
->sym
)) {
713 heading
= _(inputbox_instructions_int
);
716 heading
= _(inputbox_instructions_hex
);
719 heading
= _(inputbox_instructions_string
);
722 heading
= _("Internal mconf error!");
725 res
= dialog_inputbox(prompt
? _(prompt
) : _("Main Menu"),
727 sym_get_string_value(menu
->sym
));
730 if (sym_set_string_value(menu
->sym
, dialog_input_result
))
732 show_textbox(NULL
, _("You have made an invalid entry."), 5, 43);
743 static void conf_load(void)
749 res
= dialog_inputbox(NULL
, load_config_text
,
753 if (!dialog_input_result
[0])
755 if (!conf_read(dialog_input_result
)) {
756 set_config_filename(dialog_input_result
);
757 sym_set_change_count(1);
760 show_textbox(NULL
, _("File does not exist!"), 5, 38);
763 show_helptext(_("Load Alternate Configuration"), load_config_help
);
771 static void conf_save(void)
776 res
= dialog_inputbox(NULL
, save_config_text
,
780 if (!dialog_input_result
[0])
782 if (!conf_write(dialog_input_result
)) {
783 set_config_filename(dialog_input_result
);
786 show_textbox(NULL
, _("Can't create file! Probably a nonexistent directory."), 5, 60);
789 show_helptext(_("Save Alternate Configuration"), save_config_help
);
797 static int handle_exit(void)
802 if (conf_get_changed())
803 res
= dialog_yesno(NULL
,
804 _("Do you wish to save your new configuration ?\n"
805 "<ESC><ESC> to continue."),
810 end_dialog(saved_x
, saved_y
);
814 if (conf_write(filename
)) {
815 fprintf(stderr
, _("\n\n"
816 "Error while writing of the configuration.\n"
817 "Your configuration changes were NOT saved."
824 "*** End of the configuration.\n"
825 "*** Execute 'make' to start the build or try 'make help'."
830 fprintf(stderr
, _("\n\n"
831 "Your configuration changes were NOT saved."
838 static void sig_handler(int signo
)
843 int main(int ac
, char **av
)
848 setlocale(LC_ALL
, "");
849 bindtextdomain(PACKAGE
, LOCALEDIR
);
852 signal(SIGINT
, sig_handler
);
857 mode
= getenv("MENUCONFIG_MODE");
859 if (!strcasecmp(mode
, "single_menu"))
860 single_menu_mode
= 1;
865 getyx(stdscr
, saved_y
, saved_x
);
866 if (init_dialog(NULL
)) {
867 fprintf(stderr
, N_("Your display is too small to run Menuconfig!\n"));
868 fprintf(stderr
, N_("It must be at least 19 lines by 80 columns.\n"));
872 set_config_filename(conf_get_configname());
876 } while (res
== KEY_ESC
);