3.3.3. GETTING INTERACTIVE HELP

next, previous Section / Table of Contents / Index BALSAC offers an on-line help feature which becomes quite useful if you are lost inside one of the many option menus. This option is active by default and indicated by "...[?]Help..." in the main option menus, by ? in "[?,]esc" of all other option menus, and also by "...[H]elp(on )..." in the parameter option menu. With on-line help you can obtain a short explanation (in the text window) on each option given in any BALSAC menu. If the option key [K] appears in the menu pressing [?] followed by [K] gets you the help text. If you press [?] twice inside a menu an explanation will be given on all options of that menu. This may exceed the screen page and may require pressing [C] or L-click to continue (press [,] or R-click to cancel the listing) as indicated by ** Press [C], L-click to continue; [,], R-click to escape ** at the bottom of the screen. After the help text is shown the prompt line --> Select options from [ABC...,?] : lists all available option keys of the present menu including [,] and [?] inside the "[ ]" brackets. This allows you to continue selecting one of the options or obtaining more on-line help (press [?] again). Note, however, that the help text is always rather short, in particular inside graphics option menus, and meant only to remind the knowing user. It cannot replace the manual. But if you like you can modify or expand the available help text by creating your own help text file, for details consult Secs. 6.2.15, 6.4.11. If the on-line help feature is turned off for any reason you can activate it inside any menu by pressing [?] which opens the default help file confirmed by Help now available (default file) Press option key to get help : after which you can choose what option you want help on. If pressing [?] does not yield any response the default help file is unaccessible, see below. You can also explicitly activate on-line help by pressing [H] in the parameter option menu reading ========== BASIC PARAMETER OPTIONS ===================================== [M]ouse(off) [H]elp(off) [T]each(off) me[N]u( on) [E]ltb(off) [I]ndex(off) [O]rder( on) [W]indow : (Ox,Oy)= ( 0, 0) (Lwx,Lwy)= ( 640, 480) Qyx= 1.000 [A]dapter : Int= 18, Colmx= 16, Chx,Chy= 8 16 [P]aint : basic colors= 4, tones= 3, palette= 4 wor[K]b ste[R]eo [L]oadini [S]avini [B]ackup(fbu) [X]plot [?,]esc ======================================================================== after which the prompt Help file name ("+"=def,"-"=esc): asks you for the name of the input file. Here in most cases you can use the default name ('balsac2.hlp') typing "+" + [enter]. From now on on-line help is available which is indicated by "...[H]elp(on )..." in the initial BALSAC startup menu and in the parameter option menu, by "...[?]Help..." in the main option menu, and by "...[?,]esc" in all other menus. The on-line help feature requires an external help text file where the default is named 'balsac2.hlp' but other names may be possible, see Sec. 6.1. This file must exist in your directory or an appropriate directory path must be set. If BALSAC does not find the help text file when you try to open it at startup or inside the parameter option menu you get an error message ERROR: opening file for on-line help input File = balsac2.hlp WARNING: help file unaccessible, no on-line help available which reminds you to find a correct file (in your computer or try to get it from the original software package) or to live without on-line help. Note that if Unix or DOS versions of BALSAC run in mouse mode their on-line help feature works differently, see Sec. 3.3.8. next, previous Section / Table of Contents / Index