usage: menu [flag] name [ name2 … ] [dflg] ; load/unload the named menu(s)
or: menu [flag] [name] [dflg] {…}; load an explicit menu
or: menu 0 [mnutype]; inactivate menu
or: menu -1 [mnutype]; restore previous menu
or: menu ; redraw menu display

The MENU command is used to read, activate, or inactivate command menus. The 5 different types of menus (PULL-DOWN, FUNCTION, SCREEN, TABLET and TEMPSCREEN) are all controlled by this command (see MENUS(1) for more general information on the different types of CIGAL menus).

The FLAG argument controls the meaning of the MENU command:

   1-10    Read/Activate menu as Pull-down menu (1-10 is position on menu bar)
    11     Read/Activate menu as Function menu
    12     Read/Activate menu as Screen menu
    13     Read/Activate menu as Tablet menu
    14     Read/Activate menu as TempScreen menu
     0     Inactivate menu (next argument can specify which menu)
    -1     Restore previous menu (next argument can specify which menu)

Note: When reading or activating a Function, Screen, or Tablet menu the format of the menu is sufficient to indicate which type, so the FLAG argument is generally not necessary. For a Pull-down menu you only need the FLAG if you want to specify in which position to put the menu, otherwise it will appear in the first available menu bar position. For a TempScreen menu you must specify the flag.

Reading a Menu

If a named menu is not found in CIGAL's system menu library, then the MENU command will first attempt to read the menu into the library. See MAKEMENU(1) for information on how to create new command menus.

The DFLG argument can be included to specify menu display options. The following flags can be combined by addition:

       1   SAVMODE       save current video display mode with mode; when
                          the menu is activated in any other video mode it
                          will automatically switch back to its saved mode
       2   SAVSCR        store current video screen display as menu display
       4   STORTXT       store display as processed video text
      10o  TEMP          delete menu from system table when inactivated
                          (default for '{' if no name specified)
      20o  STDIN         read menu from standard input (default for '{')

Note: the NAME argument is not needed if the menu is temporary, loaded explicitly, and not a Pull-down menu.

Inactivating a Menu

At any one time you can have 1 Function menu, 1 Screen or Tablet menu, and up to 10 Pull-down menus active. You inactivate a menu by entering:

                        menu 0 name
                     or menu 0 mnu
                     or menu 0 mnu1 mnu2 mnu3 ...
                     or menu 0 mnufirst - mnulast

For all but the first of these, the menus to inactivate are specified by menu position number, as described for the FLAG argument above. If no menu is specified, the current Screen or Tablet menu is inactivated. MNUFIRST to MNULAST can be used to inactivate many consecutive menu numbers.

Examples:

        menu 0                  ; turn off the screen menu (or tablet)
        menu 0 1 - 10           ; inactivate all pull-down menus

Reactivating menus

Pull-down or function menus that have been inactivated, can be reactivated by entering the command:

                        menu - mnu1 mnu2 ...
                     or menu - mnufirst - mnulast

Examples:

        menu - 11               ; reactivate the function key menu
        menu - 1 - 10           ; reactivate all pull-down menus

Restoring Previous Menu

Redrawing the Menu Display If at any time the menu display disappears, you can redraw it with:

                        menu

See Also:
DELETE(2), DIR(2), EDIT(2), MAKEMENU(1), MENUS(1), SHOW(2), TABLETS(1), WINDOWS(1)

CIGAL Home, CIGAL Manual, Commands List, Manual Help