**CIGAL Reference Manual, Chapter 1 (Topics): funcmenu**
===== Funcmenu -- The Function Menu =====
CIGAL has a special menu that it uses to
determine the meaning of the keyboard function keys (F1 through F10 and
ESC) and the buttons on the cursor device (generally a mouse or tablet).
Any CIGAL command, or group of commands, can be assigned to any key;
pressing that key then executes the corresponding command sequence. The
function menu can be changed at any time to make the most efficient use
of these handy one-touch keys.  Usually, the F1 key is reserved to print
a description of what the rest of the function keys do; so if in doubt
about the current meaning of the keys try pressing F1 for help.

To create a new function menu you simply create a text file specify the
commands to assign to each key. You must give the text file a '.MNU'
suffix to identify it as a menu file. The assignments consist of the
name of the key on one line, followed by the command lines to be
assigned to that key, and then followed by a blank line.

The names of the keys are:
      F1  F2  F3  F4  F5  F6  F7  F8  F9  F10  ESC  M1  M2  M3
for the 10 function keys, the ESCAPE key, and the mouse (or other
cursor) buttons.(see HELP SAMPLEFUNCMENU for a sample function menu)


The function menu is controlled by the MENU command (see [[jvs:cigal:manual:chapter2:menu|MENU(2)]]). For
example, if the lines above were in a file named FUNCTEST.MNU, you could
activate this menu with the command:
        menu functest 8
(where the 8 indicates this test menu is not to be stored permanently in
the system menu table).

Note: If you want to extract the sample menu from the helpfile to test
it, execute the following commands:
        help funcmenu > tmpfile
        list tmpfile 0 - - 1 37 22 > tmpfile.mnu
        menu tmpfile 8
        del tmpfile tmpfile.mnu
Note: Function menus have not yet been tested on Macintosh CIGAL

**See Also:**\\
[[jvs:cigal|CIGAL Home]], 
[[jvs:cigal:manual|CIGAL Manual]], 
[[jvs:cigal:manual:chapter1|Topics List]], 
[[jvs:cigal:manual:help|Manual Help]]