17 "Help windows\n"
18 "------------\n"
19 "o  Global help:  Unless in a data entry window, pressing <F1> will give \n"
20 "   you the global help window, which you are just reading.\n"
21 "\n"
22 "o  A short version of the global help is available by pressing <F3>.\n"
23 "\n"
24 "o  Local help:  To get help related to the current menu entry, use any\n"
25 "   of <?> <h>, or if in a data entry window then press <F1>.\n"
26 "\n"
27 "\n"
28 "Menu entries\n"
29 "------------\n"
30 "This interface lets you select features and parameters for the kernel\n"
31 "build.  Kernel features can either be built-in, modularized, or removed.\n"
32 "Parameters must be entered as text or decimal or hexadecimal numbers.\n"
33 "\n"
34 "Menu entries beginning with following braces represent features that\n"
35 "  [ ]  can be built in or removed\n"
36 "  < >  can be built in, modularized or removed\n"
37 "  { }  can be built in or modularized, are selected by another feature\n"
38 "  - -  are selected by another feature\n"
39 "  XXX  cannot be selected.  Symbol Info <F2> tells you why.\n"
40 "*, M or whitespace inside braces means to build in, build as a module\n"
41 "or to exclude the feature respectively.\n"
42 "\n"
43 "To change any of these features, highlight it with the movement keys\n"
44 "listed below and press <y> to build it in, <m> to make it a module or\n"
45 "<n> to remove it.  You may press the <Space> key to cycle through the\n"
46 "available options.\n"
47 "\n"
48 "A trailing \"--->\" designates a submenu, a trailing \"----\" an\n"
49 "empty submenu.\n"
50 "\n"
51 "Menu navigation keys\n"
52 "----------------------------------------------------------------------\n"
53 "Linewise up                 <Up>\n"
54 "Linewise down               <Down>\n"
55 "Pagewise up                 <Page Up>\n"
56 "Pagewise down               <Page Down>\n"
57 "First entry                 <Home>\n"
58 "Last entry                  <End>\n"
59 "Enter a submenu             <Right>  <Enter>\n"
60 "Go back to parent menu      <Left>   <Esc>  <F5>\n"
61 "Close a help window         <Enter>  <Esc>  <F5>\n"
62 "Close entry window, apply   <Enter>\n"
63 "Close entry window, forget  <Esc>  <F5>\n"
64 "Start incremental, case-insensitive search for STRING in menu entries,\n"
65 "    no regex support, STRING is displayed in upper left corner\n"
66 "                            </>STRING\n"
67 "    Remove last character   <Backspace>\n"
68 "    Jump to next hit        <Down>\n"
69 "    Jump to previous hit    <Up>\n"
70 "Exit menu search mode       </>  <Esc>\n"
71 "Search for configuration variables with or without leading CONFIG_\n"
72 "                            <F8>RegExpr<Enter>\n"
73 "Verbose search help         <F8><F1>\n"
74 "----------------------------------------------------------------------\n"
75 "\n"
76 "Unless in a data entry window, key <1> may be used instead of <F1>,\n"
77 "<2> instead of <F2>, etc.\n"
78 "\n"
79 "\n"
80 "Radiolist (Choice list)\n"
81 "-----------------------\n"
82 "Use the movement keys listed above to select the option you wish to set\n"
83 "and press <Space>.\n"
84 "\n"
85 "\n"
86 "Data entry\n"
87 "----------\n"
88 "Enter the requested information and press <Enter>.  Hexadecimal values\n"
89 "may be entered without the \"0x\" prefix.\n"
90 "\n"
91 "\n"
92 "Text Box (Help Window)\n"
93 "----------------------\n"
94 "Use movement keys as listed in table above.\n"
95 "\n"
96 "Press any of <Enter> <Esc> <q> <F5> <F9> to exit.\n"
97 "\n"
98 "\n"
99 "Alternate configuration files\n"
100 "-----------------------------\n"
101 "nconfig supports switching between different configurations.\n"
102 "Press <F6> to save your current configuration.  Press <F7> and enter\n"
103 "a file name to load a previously saved configuration.\n"
104 "\n"
105 "\n"
106 "Terminal configuration\n"
107 "----------------------\n"
108 "If you use nconfig in a xterm window, make sure your TERM environment\n"
109 "variable specifies a terminal configuration which supports at least\n"
110 "16 colors.  Otherwise nconfig will look rather bad.\n"
111 "\n"
112 "If the \"stty size\" command reports the current terminalsize correctly,\n"
113 "nconfig will adapt to sizes larger than the traditional 80x25 \"standard\"\n"
114 "and display longer menus properly.\n"
115 "\n"
116 "\n"
117 "Single menu mode\n"
118 "----------------\n"
119 "If you prefer to have all of the menu entries listed in a single menu,\n"
120 "rather than the default multimenu hierarchy, run nconfig with\n"
121 "NCONFIG_MODE environment variable set to single_menu.  Example:\n"
122 "\n"
123 "make NCONFIG_MODE=single_menu nconfig\n"
124 "\n"
125 "<Enter> will then unfold the appropriate category, or fold it if it\n"
126 "is already unfolded.  Folded menu entries will be designated by a\n"
127 "leading \"++>\" and unfolded entries by a leading \"-->\".\n"
128 "\n"
129 "Note that this mode can eventually be a little more CPU expensive than\n"
130 "the default mode, especially with a larger number of unfolded submenus.\n"
131 "\n"),
133 "Legend:  [*] built-in  [ ] excluded  <M> module  < > module capable.\n"
134 "Submenus are designated by a trailing \"--->\", empty ones by \"----\".\n"
135 "\n"
136 "Use the following keys to navigate the menus:\n"
137 "Move up or down with <Up> and <Down>.\n"
138 "Enter a submenu with <Enter> or <Right>.\n"
139 "Exit a submenu to its parent menu with <Esc> or <Left>.\n"
140 "Pressing <y> includes, <n> excludes, <m> modularizes features.\n"
141 "Pressing <Space> cycles through the available options.\n"
142 "To search for menu entries press </>.\n"
143 "<Esc> always leaves the current window.\n"
144 "\n"
145 "You do not have function keys support.\n"
146 "Press <1> instead of <F1>, <2> instead of <F2>, etc.\n"
147 "For verbose global help use key <1>.\n"
148 "For help related to the current menu entry press <?> or <h>.\n"),
150 "Legend:  [*] built-in  [ ] excluded  <M> module  < > module capable.\n"
151 "Submenus are designated by a trailing \"--->\", empty ones by \"----\".\n"
152 "\n"
153 "Use the following keys to navigate the menus:\n"
154 "Move up or down with <Up> or <Down>.\n"
155 "Enter a submenu with <Enter> or <Right>.\n"
156 "Exit a submenu to its parent menu with <Esc> or <Left>.\n"
157 "Pressing <y> includes, <n> excludes, <m> modularizes features.\n"
158 "Pressing <Space> cycles through the available options.\n"
159 "To search for menu entries press </>.\n"
160 "<Esc> always leaves the current window.\n"
161 "\n"
162 "Pressing <1> may be used instead of <F1>, <2> instead of <F2>, etc.\n"
163 "For verbose global help press <F1>.\n"
164 "For help related to the current menu entry press <?> or <h>.\n"),
166 "Press <Up>, <Down>, <Home> or <End> to navigate a radiolist, select\n"
167 "with <Space>.\n"
168 "For help related to the current entry press <?> or <h>.\n"
169 "For global help press <F1>.\n"),
171 "Please enter a decimal value.\n"
172 "Fractions will not be accepted.\n"
175 "Please enter a hexadecimal value.\n"
178 "Please enter a string value.\n"
181 "This feature depends on another feature which has been configured as a\n"
184 "Enter the name of the configuration file you wish to load.\n"
185 "Accept the name shown to restore the configuration you last\n"
188 "For various reasons, one may wish to keep several different\n"
189 "configurations available on a single machine.\n"
190 "\n"
191 "If you have saved a previous configuration in a file other than the\n"
192 "default one, entering its name here will allow you to load and modify\n"
193 "that configuration.\n"
194 "\n"
195 "Leave empty to abort.\n"),
197 "Enter a filename to which this configuration should be saved\n"
200 "For various reasons, one may wish to keep several different\n"
201 "configurations available on a single machine.\n"
202 "\n"
203 "Entering a file name here will allow you to later retrieve, modify\n"
204 "and use the current configuration as an alternate to whatever\n"
205 "configuration options you have selected at that time.\n"
206 "\n"
207 "Leave empty to abort.\n"),
209 "Search for symbols (configuration variable names CONFIG_*) and display\n"
210 "their relations.  Regular expressions are supported.\n"
211 "Example:  Search for \"^FOO\".\n"
212 "Result:\n"
213 "-----------------------------------------------------------------\n"
214 "Symbol: FOO [ = m]\n"
215 "Prompt: Foo bus is used to drive the bar HW\n"
216 "Defined at drivers/pci/Kconfig:47\n"
217 "Depends on: X86_LOCAL_APIC && X86_IO_APIC || IA64\n"
218 "Location:\n"
219 "  -> Bus options (PCI, PCMCIA, EISA, ISA)\n"
220 "    -> PCI support (PCI [ = y])\n"
221 "      -> PCI access mode (<choice> [ = y])\n"
222 "Selects: LIBCRC32\n"
223 "Selected by: BAR\n"
224 "-----------------------------------------------------------------\n"
225 "o  The line 'Prompt:' shows the text displayed for this symbol in\n"
226 "   the menu hierarchy.\n"
227 "o  The 'Defined at' line tells at what file / line number the symbol is\n"
228 "   defined.\n"
229 "o  The 'Depends on:' line lists symbols that need to be defined for\n"
230 "   this symbol to be visible and selectable in the menu.\n"
231 "o  The 'Location:' lines tell, where in the menu structure this symbol\n"
232 "   is located.  A location followed by a [ = y] indicates that this is\n"
233 "   a selectable menu item, and the current value is displayed inside\n"
234 "   brackets.\n"
235 "o  The 'Selects:' line tells, what symbol will be automatically selected\n"
236 "   if this symbol is selected (y or m).\n"
237 "o  The 'Selected by' line tells what symbol has selected this symbol.\n"
238 "\n"
239 "Only relevant lines are shown.\n"
240 "\n\n"
241 "Search examples:\n"
242 "USB  => find all symbols containing USB\n"
243 "^USB => find all symbols starting with USB\n"
244 "USB$ => find all symbols ending with USB\n"
245 "\n");
372 		mvwprintw(main_window, lines-3, offset,  in print_function_line()
377 		mvwprintw(main_window, lines-3,  in print_function_line()
494 /* return the index of the matched item, or -1 if no such item exists */
503 		--match_start;  in get_mext_match()
513 			--index;  in get_mext_match()
518 			return -1;  in get_mext_match()
527 	if (items_num > MAX_MENU_ITEMS-1)  in item_make()
566 	int index = items_num-1;  in item_add_str()
600 	return mcur->tag;  in item_tag()
617 	return mcur->usrptr;  in item_data()
633 			"%s - %s", config_filename, rootmenu.prompt->text);  in set_config_filename()
635 		menu_backtitle[sizeof(menu_backtitle)-1] = '\0';  in set_config_filename()
639 		filename[sizeof(filename)-1] = '\0';  in set_config_filename()
644  * -1 means go on doing what you were doing
654 			_("Do you wish to save your new configuration?\n"  in do_exit()
661 		return -1;  in do_exit()
671 				_("Error during writing of configuration.\n"  in do_exit()
745 	sym = menu->sym;  in build_conf()
746 	prop = menu->prompt;  in build_conf()
751 			ptype = menu->prompt ? menu->prompt->type : P_UNKNOWN;  in build_conf()
759 						menu->data ? "-->" : "++>",  in build_conf()
765 						  menu_is_empty(menu) ? "----" : "--->");  in build_conf()
767 				if (single_menu_mode && menu->data)  in build_conf()
782 					item_make(menu, ':', "---%*c%s",  in build_conf()
798 		for (child = menu->list; child; child = child->next) {  in build_conf()
799 			if (menu_is_visible(child) && child->sym == def_sym)  in build_conf()
835 				item_add_str("  --->");  in build_conf()
836 				if (def_menu->list) {  in build_conf()
839 					indent -= 2;  in build_conf()
847 				"---%*c%s", indent + 1,  in build_conf()
862 					item_make(menu, 't', "-%c-",  in build_conf()
878 					if (sym->rev_dep.tri == mod)  in build_conf()
885 					item_make(menu, 't', "-%c-", ch);  in build_conf()
891 				tmp = indent - tmp + 4;  in build_conf()
906 		if (menu->prompt && menu->prompt->type == P_MENU) {  in build_conf()
907 			item_add_str("  %s", menu_is_empty(menu) ? "----" : "--->");  in build_conf()
914 	for (child = menu->list; child; child = child->next)  in build_conf()
916 	indent -= doint;  in build_conf()
935 		toprow = max(selected_index-mwin_max_lines/2, 0);  in center_item()
936 		if (toprow >= item_count(curses_menu)-mwin_max_lines)  in center_item()
937 			toprow = item_count(curses_menu)-mwin_max_lines;  in center_item()
972 	maxx = min(maxx, mwin_max_cols-2);  in show_menu()
978 			(mwin_max_cols-maxx)/2);  in show_menu()
1016  * item to center, or -1 otherwise.
1017  * Else return -1 .
1023 	*ans = -1;  in do_match()
1024 	if (key == '/' || (state->in_search && key == 27)) {  in do_match()
1028 		state->in_search = 1-state->in_search;  in do_match()
1029 		bzero(state->pattern, sizeof(state->pattern));  in do_match()
1030 		state->match_direction = MATCH_TINKER_PATTERN_DOWN;  in do_match()
1032 	} else if (!state->in_search)  in do_match()
1036 		state->pattern[strlen(state->pattern)] = c;  in do_match()
1037 		state->pattern[strlen(state->pattern)] = '\0';  in do_match()
1038 		adj_match_dir(&state->match_direction);  in do_match()
1039 		*ans = get_mext_match(state->pattern,  in do_match()
1040 				state->match_direction);  in do_match()
1042 		state->match_direction = FIND_NEXT_MATCH_DOWN;  in do_match()
1043 		*ans = get_mext_match(state->pattern,  in do_match()
1044 				state->match_direction);  in do_match()
1046 		state->match_direction = FIND_NEXT_MATCH_UP;  in do_match()
1047 		*ans = get_mext_match(state->pattern,  in do_match()
1048 				state->match_direction);  in do_match()
1050 		state->pattern[strlen(state->pattern)-1] = '\0';  in do_match()
1051 		adj_match_dir(&state->match_direction);  in do_match()
1056 		state->in_search = 0;  in do_match()
1057 		bzero(state->pattern, sizeof(state->pattern));  in do_match()
1061 		return -1;  in do_match()
1102 				if (current_index != -1)  in conf()
1135 				res == 32 || res == 'n' || res == 'y' ||  in conf()
1157 		sym = submenu->sym;  in conf()
1171 					submenu->data =  in conf()
1172 						(void *) (long) !submenu->data;  in conf()
1180 				else if (submenu->prompt &&  in conf()
1181 					 submenu->prompt->type == P_MENU)  in conf()
1199 		case 'n':  in conf()
1246 	active = sym_get_choice_value(menu->sym);  in conf_choice()
1251 		for (i = 0, child = menu->list; child; child = child->next) {  in conf_choice()
1255 			if (child->sym == sym_get_choice_value(menu->sym))  in conf_choice()
1258 			else if (child->sym)  in conf_choice()
1265 			if (child->sym == active){  in conf_choice()
1286 				if (selected_index != -1)  in conf_choice()
1330 		if (!child || !menu_is_visible(child) || !child->sym)  in conf_choice()
1336 			sym_set_tristate_value(child->sym, yes);  in conf_choice()
1341 			active = child->sym;  in conf_choice()
1357 		switch (sym_get_type(menu->sym)) {  in conf_string()
1373 				sym_get_string_value(menu->sym),  in conf_string()
1378 			if (sym_set_string_value(menu->sym,  in conf_string()
1467 	main_window = newwin(lines-2, columns-2, 2, 1);  in setup_windows()
1469 	mwin_max_lines = lines-7;  in setup_windows()
1470 	mwin_max_cols = columns-6;  in setup_windows()
1485 	if (ac > 1 && strcmp(av[1], "-s") == 0) {  in main()
1513 			"least 20 lines and 75 columns\n");  in main()