menumark(3X)                                                    menumark(3X)



NAME
       menumark - get and set the menu mark string

SYNOPSIS
       ##include <>
       int setmenumark(MENU *menu, const char *mark);
       const char *menumark(const MENU *menu);

DESCRIPTION
       In  order  to  make  menu selections visible on older terminals without
       highlighting or color capability, the menu library marks selected items
       in a menu with a prefix string.

       The  function  setmenumark  sets  the mark string for the given menu.
       Calling setmenumark with a null  menu  item  will  abolish  the  mark
       string.   Note  that  changing the length of the mark string for a menu
       while the menu is posted is likely to produce unhelpful behavior.

       The default string is "-" (a dash). Calling setmenumark with  a  NUL
       menu argument will change this default.

       The function menumark returns the menu's mark string (or NUL if there
       is none).

RETURN VALUE
       The  function  menumark  returns  NUL   on   error.    The   function
       setmenumark may return the following error codes:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

       EBADARGUMENT
            Routine detected an incorrect or out-of-range argument.

SEE ALSO
       curses(3X), menu(3X).

NOTES
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PORTABILITY
       These routines emulate the System V menu library.  They were  not  sup-
       ported on Version 7 or BSD versions.

AUTHORS
       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                 menumark(3X)