menu_colors.sh(1)                                  menu_colors.sh(1)


       NAME
             menu_colors.sh - menu tool environment variables

       SYNOPSIS
             . /etc/inst/locale/${LANG}/menus/menu_colors.sh

       DESCRIPTION
             The shell file menu_colors.sh is used to set up environment
             variables to manage colors for the menu(1) command.

             This tool, when sourced into the current shell, defines a
             function menu_colors that takes an argument which determines
             the colors or attributes that will be displayed next time the
             menu tool is invoked.  These attributes are configurable by
             editing the file menu_colors.sh.

             Valid arguments are:

             regular   the color scheme is the one defined for regular
                       screens (default white text on blue background, or
                       white text on black background for monochrome
                       displays).

             warn      the color scheme is the one defined for warning
                       screens (default white text on magenta background,
                       or black text on white background for monochrome
                       displays).

             error     the color scheme is the one defined for error
                       screens (default white text on red background, or
                       black text on white background for monochrome
                       displays).

             The curses library provides the color for the menu tool.
             Given a color monitor, the default color scheme is as follows:
             regular menu screens are white text on a blue background, help
             screens are black text on a cyan background, and error
             messages are white text on a red background.  These defaults
             can be overridden by setting the following environment
             variables to the values in usr/include/curses.h given for
             colors, and exporting the variables:

             REG_FG       The foreground color for regular menu screens.
                          The default is COLOR_WHITE.




                           Copyright 1994 Novell, Inc.               Page 1

      menu_colors.sh(1)                                  menu_colors.sh(1)


            REG_BG       The background color for regular menu screens.
                         The default is COLOR_BLUE.

            REG_FG       The foreground color for error messages.  The
                         default is COLOR_WHITE.

            ERROR_BG     The background color for error messages.  The
                         default is COLOR_RED.

            HELP_FG      The foreground color for help screens.  The
                         default is COLOR_BLACK.

            HELP_BG      The background color for help screens.  The
                         default is COLOR_CYAN.

            REG_ATTR     The curses text attribute for regular menu
                         screens.  The default is A_NORMAL.

            ERROR_ATTR   The curses text attribute for error messages.
                         The default is A_STANDOUT (inverse video).

            HELP_ATTR    The curses text attribute for help screens.  The
                         default is A_NORMAL.

      EXAMPLE
            To display a warning screen, enter:

                        # This will set up the environment to have the menu_colors()
                        # function defined.  This should only be done once in a shell
                        # script.
                        . /etc/inst/locale/${LANG}/menus/menu_colors.sh
                        menu_colors warn
                        menu -f form_description_file -o output_file

      REFERENCES
            menu(1), menu(4)












                          Copyright 1994 Novell, Inc.               Page 2