


   TopLevelShell(3X)



   NAME
     TTooppLLeevveellSShheellll-The TopLevelShell widget class

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     TopLevelShell is used for normal top-level windows such as any addi-
     tional top-level widgets an application needs.

     Classes

     TopLevelShell inherits behavior and resources from CCoorree, CCoommppoossiittee,
     SShheellll, WWMMSShheellll, and VVeennddoorrSShheellll.

     The class pointer is ttooppLLeevveellSShheellllWWiiddggeettCCllaassss.

     The class name is TTooppLLeevveellSShheellll.

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource
     values for the inherited classes to set attributes for this widget.  To
     reference a resource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given resource can be set at creation time (C),
     set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                            TTooppLLeevveellSShheellll RReessoouurrccee SSeett
      NNaammee                  CCllaassss                 TTyyppee      DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNiconic             XmCIconic             Boolean   False     CSG
      XmNiconName           XmCIconName           String    NULL      CSG
      XmNiconNameEncoding   XmCIconNameEncoding   Atom      dynamic   CSG

     XXmmNNiiccoonniicc
     Specifies that if this is True when the widget instance is realized, the
     widget instance indicates to the window manager that the application
     wishes to start as an icon, irrespective of the XXmmNNiinniittiiaallSSttaattee
     resource.

     XXmmNNiiccoonnNNaammee
     Specifies the short form of the application name to be displayed by the
     window manager when the application is iconified.

     XXmmNNiiccoonnNNaammeeEEnnccooddiinngg
     Specifies a property type that represents the encoding of the XXmmNNiiccoonn--
     NNaammee string.  If a language procedure has been set, the default is None;


   1-90






                                                            TopLevelShell(3X)


     otherwise, the default is XA_STRING.  When the widget is realized, if
     the value is None, the corresponding name is assumed to be in the
     current locale.  The name is passed to XXmmbbTTeexxttLLiissttTTooTTeexxttPPrrooppeerrttyy with an
     encoding style of XXSSttddIICCCCTTeexxttSSttyyllee.  The resulting encoding is "STRING"
     if the name is fully convertible to "STRING," otherwise "COMPOUND_TEXT."
     The values of the encoding resources are not changed; they remain None.

     Inherited Resources

     TopLevelShell inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.
                                 VVeennddoorrSShheellll RReessoouurrccee SSeett
   NNaammee                     CCllaassss                    TTyyppee            DDeeffaauulltt      AAcccceessss
   _____________________________________________________________________________________
   XmNaudibleWarning        XmCAudibleWarning        unsigned char   XmBELL       CSG
   XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic      CSG
   XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic      CG
   XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmDESTROY    CSG
   XmNinputMethod           XmCInputMethod           String          NULL         CSG
   XmNkeyboardFocusPolicy   XmCKeyboardFocusPolicy   unsigned char   XmEXPLICIT   CSG
   XmNlabelFontList         XmCLabelFontList         XmFontList      dynamic      CSG
   XmNmwmDecorations        XmCMwmDecorations        int             -1           CSG
   XmNmwmFunctions          XmCMwmFunctions          int             -1           CSG
   XmNmwmInputMode          XmCMwmInputMode          int             -1           CSG
   XmNmwmMenu               XmCMwmMenu               String          NULL         CSG
   XmNpreeditType           XmCPreeditType           String          dynamic      CSG
   XmNshellUnitType         XmCShellUnitType         unsigned char   XmPIXELS     CSG
   XmNtextFontList          XmCTextFontList          XmFontList      dynamic      CSG
   XmNuseAsyncGeometry      XmCUseAsyncGeometry      Boolean         False        CSG
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   XmNbaseHeight      XmCBaseHeight      int       XtUnspecifiedShellInt   CSG
   XmNbaseWidth       XmCBaseWidth       int       XtUnspecifiedShellInt   CSG
   XmNheightInc       XmCHeightInc       int       XtUnspecifiedShellInt   CSG
   XmNiconMask        XmCIconMask        Pixmap    NULL                    CSG
   XmNiconPixmap      XmCIconPixmap      Pixmap    NULL                    CSG
   XmNiconWindow      XmCIconWindow      Window    NULL                    CSG
   XmNiconX           XmCIconX           int       -1                      CSG
   XmNiconY           XmCIconY           int       -1                      CSG
   XmNinitialState    XmCInitialState    int       NormalState             CSG
   XmNinput           XmCInput           Boolean   True                    CSG
   XmNmaxAspectX      XmCMaxAspectX      int       XtUnspecifiedShellInt   CSG
   XmNmaxAspectY      XmCMaxAspectY      int       XtUnspecifiedShellInt   CSG
   XmNmaxHeight       XmCMaxHeight       int       XtUnspecifiedShellInt   CSG
   XmNmaxWidth        XmCMaxWidth        int       XtUnspecifiedShellInt   CSG
   XmNminAspectX      XmCMinAspectX      int       XtUnspecifiedShellInt   CSG
   XmNminAspectY      XmCMinAspectY      int       XtUnspecifiedShellInt   CSG
   XmNminHeight       XmCMinHeight       int       XtUnspecifiedShellInt   CSG
   XmNminWidth        XmCMinWidth        int       XtUnspecifiedShellInt   CSG
   XmNtitle           XmCTitle           String    dynamic                 CSG
   XmNtitleEncoding   XmCTitleEncoding   Atom      dynamic                 CSG
   XmNtransient       XmCTransient       Boolean   False                   CSG


   1-91






   TopLevelShell(3X)


   XmNwaitForWm       XmCWaitForWm       Boolean   True                    CSG
   XmNwidthInc        XmCWidthInc        int       XtUnspecifiedShellInt   CSG
   XmNwindowGroup     XmCWindowGroup     Window    dynamic                 CSG
   XmNwinGravity      XmCWinGravity      int       dynamic                 CSG
   XmNwmTimeout       XmCWmTimeout       int       5000 ms                 CSG
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   XmNallowShellResize       XmCAllowShellResize       Boolean                  False            CG
   XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
   XmNgeometry               XmCGeometry               String                   NULL             CSG
   XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  False            CSG
   XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C
   XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
   XmNsaveUnder              XmCSaveUnder              Boolean                  False            CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
   XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
   XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
   XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
   XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderWidth                  XmCBorderWidth                  Dimension        1                      CSG
   XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
   XmNdepth                        XmCDepth                        int              dynamic                CG
   XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
   XmNheight                       XmCHeight                       Dimension        dynamic                CSG
   XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
   XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
   XmNscreen                       XmCScreen                       Screen *         dynamic                CG
   XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
   XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
   XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
   XmNx                            XmCPosition                     Position         0                      CSG
   XmNy                            XmCPosition                     Position         0                      CSG

     Translations

     There are no translations for TopLevelShell.

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), SShheellll((33XX)), WWMMSShheellll((33XX)), and VVeennddoorrSShheellll((33XX)).





   1-92






                                                           TransientShell(3X)



   NAME
     TTrraannssiieennttSShheellll-The TransientShell widget class

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     TransientShell is used for shell windows that can be manipulated by the
     window manager but are not allowed to be iconified separately.  For
     example, Dialog boxes make no sense without their associated applica-
     tion.  They are iconified by the window manager only if the main appli-
     cation shell is iconified.

     Classes

     TransientShell inherits behavior and resources from CCoorree, CCoommppoossiittee,
     SShheellll, WWMMSShheellll, and VVeennddoorrSShheellll.

     The class pointer is ttrraannssiieennttSShheellllWWiiddggeettCCllaassss.

     The class name is TTrraannssiieennttSShheellll.

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource
     values for the inherited classes to set attributes for this widget.  To
     reference a resource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given resource can be set at creation time (C),
     set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).

     In addition to these new resources, new resources, TTrraannssiieennttSShheellll over-
     rides the XXmmNNssaavveeUUnnddeerr resource in SShheellll and the XXmmNNttrraannssiieenntt resource
     in WWMMSShheellll.
                           TTrraannssiieennttSShheellll RReessoouurrccee SSeett
          NNaammee              CCllaassss             TTyyppee     DDeeffaauulltt   AAcccceessss
          _____________________________________________________________
          XmNtransientFor   XmCTransientFor   Widget   NULL      CSG

     XXmmNNttrraannssiieennttFFoorr
               Specifies a widget for which the shell acts as a pop-up.  If
               this resource is NULL or is a widget that has not been real-
               ized, the XXmmNNwwiinnddoowwGGrroouupp is used instead.






   1-93






   TransientShell(3X)



     Inherited Resources

     TransientShell inherits behavior and resources from the following
     superclasses.  For a complete description of each resource, refer to the
     man page for that superclass.  The following table defines a set of
     widget resources used by the programmer to specify data.  The programmer
     can also set the resource values for the inherited classes to set attri-
     butes for this widget.  To reference a resource by name or by class in a
     .Xdefaults file, remove the XXmmNN or XXmmCC prefix and use the remaining
     letters.  To specify one of the defined values for a resource in a .Xde-
     faults file, remove the XXmm prefix and use the remaining letters (in
     either lowercase or uppercase, but include any underscores between
     words).  The codes in the access column indicate if the given resource
     can be set at creation time (C), set by using XXttSSeettVVaalluueess (S), retrieved
     by using XXttGGeettVVaalluueess (G), or is not applicable (N/A).
                                 VVeennddoorrSShheellll RReessoouurrccee SSeett
   NNaammee                     CCllaassss                    TTyyppee            DDeeffaauulltt      AAcccceessss
   _____________________________________________________________________________________
   XmNaudibleWarning        XmCAudibleWarning        unsigned char   XmBELL       CSG
   XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic      CSG
   XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic      CG
   XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmDESTROY    CSG
   XmNinputMethod           XmCInputMethod           String          NULL         CSG
   XmNkeyboardFocusPolicy   XmCKeyboardFocusPolicy   unsigned char   XmEXPLICIT   CSG
   XmNlabelFontList         XmCLabelFontList         XmFontList      dynamic      CSG
   XmNmwmDecorations        XmCMwmDecorations        int             -1           CSG
   XmNmwmFunctions          XmCMwmFunctions          int             -1           CSG
   XmNmwmInputMode          XmCMwmInputMode          int             -1           CSG
   XmNmwmMenu               XmCMwmMenu               String          NULL         CSG
   XmNpreeditType           XmCPreeditType           String          dynamic      CSG
   XmNshellUnitType         XmCShellUnitType         unsigned char   XmPIXELS     CSG
   XmNtextFontList          XmCTextFontList          XmFontList      dynamic      CSG
   XmNuseAsyncGeometry      XmCUseAsyncGeometry      Boolean         False        CSG
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   XmNbaseHeight      XmCBaseHeight      int       XtUnspecifiedShellInt   CSG
   XmNbaseWidth       XmCBaseWidth       int       XtUnspecifiedShellInt   CSG
   XmNheightInc       XmCHeightInc       int       XtUnspecifiedShellInt   CSG
   XmNiconMask        XmCIconMask        Pixmap    NULL                    CSG
   XmNiconPixmap      XmCIconPixmap      Pixmap    NULL                    CSG
   XmNiconWindow      XmCIconWindow      Window    NULL                    CSG
   XmNiconX           XmCIconX           int       -1                      CSG
   XmNiconY           XmCIconY           int       -1                      CSG
   XmNinitialState    XmCInitialState    int       NormalState             CSG
   XmNinput           XmCInput           Boolean   True                    CSG
   XmNmaxAspectX      XmCMaxAspectX      int       XtUnspecifiedShellInt   CSG
   XmNmaxAspectY      XmCMaxAspectY      int       XtUnspecifiedShellInt   CSG
   XmNmaxHeight       XmCMaxHeight       int       XtUnspecifiedShellInt   CSG
   XmNmaxWidth        XmCMaxWidth        int       XtUnspecifiedShellInt   CSG
   XmNminAspectX      XmCMinAspectX      int       XtUnspecifiedShellInt   CSG
   XmNminAspectY      XmCMinAspectY      int       XtUnspecifiedShellInt   CSG
   XmNminHeight       XmCMinHeight       int       XtUnspecifiedShellInt   CSG


   1-94






                                                           TransientShell(3X)


   XmNminWidth        XmCMinWidth        int       XtUnspecifiedShellInt   CSG
   XmNtitle           XmCTitle           String    dynamic                 CSG
   XmNtitleEncoding   XmCTitleEncoding   Atom      dynamic                 CSG
   XmNtransient       XmCTransient       Boolean   True                    CSG
   XmNwaitForWm       XmCWaitForWm       Boolean   True                    CSG
   XmNwidthInc        XmCWidthInc        int       XtUnspecifiedShellInt   CSG
   XmNwindowGroup     XmCWindowGroup     Window    dynamic                 CSG
   XmNwinGravity      XmCWinGravity      int       dynamic                 CSG
   XmNwmTimeout       XmCWmTimeout       int       5000 ms                 CSG
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   XmNallowShellResize       XmCAllowShellResize       Boolean                  False            CG
   XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
   XmNgeometry               XmCGeometry               String                   NULL             CSG
   XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  False            CSG
   XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C
   XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
   XmNsaveUnder              XmCSaveUnder              Boolean                  True             CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
   XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
   XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
   XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
   XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderWidth                  XmCBorderWidth                  Dimension        1                      CSG
   XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
   XmNdepth                        XmCDepth                        int              dynamic                CG
   XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
   XmNheight                       XmCHeight                       Dimension        dynamic                CSG
   XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
   XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
   XmNscreen                       XmCScreen                       Screen *         dynamic                CG
   XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
   XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
   XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
   XmNx                            XmCPosition                     Position         0                      CSG
   XmNy                            XmCPosition                     Position         0                      CSG

     Translations

     There are no translations for TransientShell.




   1-95






   TransientShell(3X)


   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), SShheellll((33XX)), VVeennddoorrSShheellll((33XX)), and WWMMSShheellll((33XX)).






















































   1-96






                                                                      Uil(3X)



   NAME
     UUiill-Invokes the UIL compiler from within an application

   SYNOPSIS
     ##iinncclluuddee <<uuiill//UUiillDDeeff..hh>>
     UUiill__ssttaattuuss__ttyyppee UUiill ((_c_o_m_m_a_n_d__d_e_s_c, _c_o_m_p_i_l_e__d_e_s_c, _m_e_s_s_a_g_e__c_b,
               _m_e_s_s_a_g_e__d_a_t_a, _s_t_a_t_u_s__c_b, _s_t_a_t_u_s__d_a_t_a))
          UUiill__ccoommmmaanndd__ttyyppee    *_c_o_m_m_a_n_d__d_e_s_c;;
          UUiill__ccoommppiillee__ddeesscc__ttyyppee*_c_o_m_p_i_l_e__d_e_s_c;;
          UUiill__ccoonnttiinnuuee__ttyyppee   ((*_m_e_s_s_a_g_e__c_b)) (());;
          cchhaarr                *_m_e_s_s_a_g_e__d_a_t_a;;
          UUiill__ccoonnttiinnuuee__ttyyppee   ((*_s_t_a_t_u_s__c_b)) (());;
          cchhaarr                *_s_t_a_t_u_s__d_a_t_a;;

   DESCRIPTION
     The UUiill function provides a callable entry point for the UIL compiler.
     The UUiill callable interface can be used to process a UIL source file and
     to generate UID files, as well as return a detailed description of the
     UIL source module in the form of a symbol table (parse tree).

     _c_o_m_m_a_n_d__d_e_s_c        Specifies the uuiill command line.

     _c_o_m_p_i_l_e__d_e_s_c        Returns the results of the compilation.

     _m_e_s_s_a_g_e__c_b          Specifies a callback function that is called when
                         the compiler encounters errors in the UIL source.

     _m_e_s_s_a_g_e__d_a_t_a        Specifies user data that is passed to the message
                         callback function (message_cb). Note that this argu-
                         ment is not interpreted by UIL, and is used
                         exclusively by the calling application.

     _s_t_a_t_u_s__c_b           Specifies a callback function that is called to
                         allow X applications to service X events such as
                         updating the screen.  This function is called at
                         various check points, which have been hard coded
                         into the UIL compiler.  The status_update_delay
                         argument in command_desc specifies the number of
                         check points to be passed before the status_cb func-
                         tion is invoked.

     _s_t_a_t_u_s__d_a_t_a         Specifies user data that is passed to the status
                         callback function (status_cb). Note that this argu-
                         ment is not interpreted by the UIL compiler, and is
                         used exclusively by the calling application.

     The data structures UUiill__ccoommmmaanndd__ttyyppee and UUiill__ccoommppiillee__ddeesscc__ttyyppee are
     detailed below.
     typedef struct Uil_command_type {
     char *source_file;
         /* single source to compile */
     char *resource_file; /* name of output file */
     char *listing_file; /* name of listing file */


   1-97






   Uil(3X)


     unsigned int *include_dir_count;
         /* number of dirs. in include_dir */
     char *((*include_dir) []);
         /* dir. to search for include files */
     unsigned listing_file_flag: 1;
         /* produce a listing */
     unsigned resource_file_flag: 1;
         /* generate UID output */
     unsigned machine_code_flag: 1;
         /* generate machine code */
     unsigned report_info_msg_flag: 1;
         /* report info messages */
     unsigned report_warn_msg_flag: 1;
         /* report warnings */
     unsigned parse_tree_flag: 1;
         /* generate parse tree */
     unsigned int status_update_delay;
         /* number of times a status point is */
         /* passed before calling status_cb */
         /* function 0 means called every time */
     char *database;
         /* name of database file */
     unsigned database_flag: 1;
         /* read a new database file */
     unsigned use_setlocale_flag: 1;
         /* enable calls to setlocale */
     };

     typedef struct Uil_compile_desc_type {
     unsigned int compiler_version;
         /* version number of compiler */
     unsigned int data_version;
         /* version number of structures */
     char *parse_tree_root; /* parse tree output */
     unsigned int message_count [Uil_k_max_status+1];
     /* array of severity counts */
     };



















   1-98






                                                                      Uil(3X)


     Following is a description of the message callback function specified by
     _m_e_s_s_a_g_e__c_b:
     UUiill__ccoonnttiinnuuee__ttyyppee ((*_m_e_s_s_a_g_e__c_b)) ((_m_e_s_s_a_g_e__d_a_t_a, _m_e_s_s_a_g_e__n_u_m_b_e_r,
               _s_e_v_e_r_i_t_y, _m_s_g__b_u_f_f_e_r, _s_r_c__b_u_f_f_e_r, _p_t_r__b_u_f_f_e_r, _l_o_c__b_u_f_f_e_r,
               _m_e_s_s_a_g_e__c_o_u_n_t))
          cchhaarr      *_m_e_s_s_a_g_e__d_a_t_a;;
          iinntt       _m_e_s_s_a_g_e__n_u_m_b_e_r;;
          iinntt       _s_e_v_e_r_i_t_y;;
          cchhaarr      *_m_s_g__b_u_f_f_e_r,, *_s_r_c__b_u_f_f_e_r;;
          cchhaarr      *_p_t_r__b_u_f_f_e_r,, *_l_o_c__b_u_f_f_e_r;;
          iinntt       _m_e_s_s_a_g_e__c_o_u_n_t[[]];;

     Specifies a callback function that UIL invokes instead of printing an
     error message when the compiler encounters an error in the UIL source.
     The callback should return one of these values:

     UUiill__kk__tteerrmmiinnaattee     Tells UIL to terminate processing of the source
                         file.

     UUiill__kk__ccoonnttiinnuuee      Tells UIL to continue processing the source file.

     Following are the arguments:

     _m_e_s_s_a_g_e__d_a_t_a        Data supplied by the application as the _m_e_s_s_a_g_e__d_a_t_a
                         argument to the UUiill function.  UIL does not inter-
                         pret this data in any way; it just passes it to the
                         callback.

     _m_e_s_s_a_g_e__n_u_m_b_e_r      An index into a table of error messages and severi-
                         ties, for internal use by UIL.

     _s_e_v_e_r_i_t_y            An integer that indicates the severity of the error.
                         The possible values are the status constants
                         returned by the UUiill function.  See the "RETURN
                         VALUE" section below.

     _m_s_g__b_u_f_f_e_r          A string that describes the error.

     _s_r_c__b_u_f_f_e_r          A string consisting of the source line where the
                         error occurred.  This is not always available; the
                         argument is then NULL.

     _p_t_r__b_u_f_f_e_r          A string consisting of whitespace and a printing
                         character in the character position corresponding to
                         the column of the source line where the error
                         occurred.  This string may be printed beneath the
                         source line to provide a visual indication of the
                         column where the error occurred.  This is not always
                         available; the argument is then NULL.

     _l_o_c__b_u_f_f_e_r          A string identifying the line number and file of the
                         source line where the error occurred.  This is not
                         always available; the argument is then NULL.



   1-99






   Uil(3X)


     _m_e_s_s_a_g_e__c_o_u_n_t       An array of integers containing the number of diag-
                         nostic messages issued thus far for each severity
                         level.  To find the number of messages issued for
                         the current severity level, use the _s_e_v_e_r_i_t_y argu-
                         ment as the index into this array.

     Following is a description of the status callback function specified by
     _s_t_a_t_u_s__c_b:
     UUiill__ccoonnttiinnuuee__ttyyppee ((*_s_t_a_t_u_s__c_b)) ((_s_t_a_t_u_s__d_a_t_a, _p_e_r_c_e_n_t__c_o_m_p_l_e_t_e,
               _l_i_n_e_s__p_r_o_c_e_s_s_e_d, _c_u_r_r_e_n_t__f_i_l_e, _m_e_s_s_a_g_e__c_o_u_n_t))
          cchhaarr      *_s_t_a_t_u_s__d_a_t_a;;
          iinntt       _p_e_r_c_e_n_t__c_o_m_p_l_e_t_e;;
          iinntt       _l_i_n_e_s__p_r_o_c_e_s_s_e_d;;
          cchhaarr      *_c_u_r_r_e_n_t__f_i_l_e;;
          iinntt       _m_e_s_s_a_g_e__c_o_u_n_t[[]];;

     Specifies a callback function that is invoked to allow X applications to
     service X events such as updating the screen.  The callback should
     return one of these values:

     UUiill__kk__tteerrmmiinnaattee     Tells UIL to terminate processing of the source
                         file.

     UUiill__kk__ccoonnttiinnuuee      Tells UIL to continue processing the source file.

     Following are the arguments:

     _s_t_a_t_u_s__d_a_t_a         Data supplied by the application as the _s_t_a_t_u_s__d_a_t_a
                         argument to the UUiill function.  UIL does not inter-
                         pret this data in any way; it just passes it to the
                         callback.

     _p_e_r_c_e_n_t__c_o_m_p_l_e_t_e    An integer indicating what percentage of the current
                         source file has been processed so far.

     _l_i_n_e_s__p_r_o_c_e_s_s_e_d     An integer indicating how many lines of the current
                         source file have been read so far.

     _c_u_r_r_e_n_t__f_i_l_e        A string containing the pathname of the current
                         source file.

     _m_e_s_s_a_g_e__c_o_u_n_t       An array of integers containing the number of diag-
                         nostic messages issued thus far for each severity
                         level.  To find the number of messages issued for a
                         given severity level, use the severity level as the
                         index into this array.  The possible severity levels
                         are the status constants returned by the UUiill func-
                         tion.  See the "RETURN VALUE" section below.

   RETURN VALUE
     This function returns one of these status return constants:

     UUiill__kk__ssuucccceessss__ssttaattuuss     The operation succeeded.



   1-100






                                                                      Uil(3X)


     UUiill__kk__iinnffoo__ssttaattuuss        The operation succeeded, and an informational
                              message is returned.

     UUiill__kk__wwaarrnniinngg__ssttaattuuss     The operation succeeded, and a warning message
                              is returned.

     UUiill__kk__eerrrroorr__ssttaattuuss       The operation failed due to an error.

     UUiill__kk__sseevveerree__ssttaattuuss      The operation failed due to an error.

   RELATED INFORMATION
     UUiillDDuummppSSyymmbboollTTaabbllee((33XX)) and uuiill((11XX)).












































   1-101






   UilDumpSymbolTable(3X)



   NAME
     UUiillDDuummppSSyymmbboollTTaabbllee-Dumps the contents of a named UIL symbol table to
     standard output

   SYNOPSIS
     ##iinncclluuddee <<uuiill//UUiillDDeeff..hh>>
     vvooiidd UUiillDDuummppSSyymmbboollTTaabbllee ((_r_o_o_t__p_t_r))
          ssyymm__eennttrryy__ttyyppee **_r_o_o_t__p_t_r;;

   DESCRIPTION

     The UUiillDDuummppSSyymmbboollTTaabbllee function dumps the contents of a UIL symbol table
     pointer to standard output.

     _r_o_o_t__p_t_r  Specifies a pointer to the the symbol table root entry.  This
               value can be taken from the ppaarrssee__ttrreeee__rroooott part of the
               UUiill__ccoommppiillee__ddeesscc__ttyyppee data structure returned by UUiill.

     By following the link from the root entry, you can traverse the entire
     parse tree.  Symbol table entries are in the following format:

     _h_e_x._a_d_d_r_e_s_s
     _s_y_m_b_o_l._t_y_p_e
     _s_y_m_b_o_l._d_a_t_a
      _p_r_e_v._s_o_u_r_c_e._p_o_s_i_t_i_o_n
      _s_o_u_r_c_e._p_o_s_i_t_i_o_n
      _m_o_d_i_f_i_c_a_t_i_o_n._r_e_c_o_r_d

     where:

     _h_e_x._a_d_d_r_e_s_s         Specifies the hexadecimal address of this entry in
                         the symbol table.

     _s_y_m_b_o_l._t_y_p_e         Specifies the type of this symbol table entry.  Some
                         possible types are rroooott, mmoodduullee, vvaalluuee, pprroocceedduurree,
                         and wwiiddggeett.

     _s_y_m_b_o_l._d_a_t_a         Specifies data for the symbol table entry.  The data
                         varies with the type of the entry.  Often it con-
                         tains pointers to other symbol table entries, or the
                         actual data for the data type.

     _p_r_e_v._s_o_u_r_c_e._p_o_s_i_t_i_o_n
                         Specifies the end point in the source code for the
                         previous source item.

     _s_o_u_r_c_e._p_o_s_i_t_i_o_n     Specifies the range of positions in the source code
                         for this symbol.

     The exact data structures for each symbol type are defined in the
     include file UUiillSSyymmDDeeff..hh.  Note that this file is automatically included
     when an application includes the file UUiillDDeeff..hh.



   1-102






                                                       UilDumpSymbolTable(3X)


   RELATED INFORMATION
     UUiill((33XX))






















































   1-103






   VendorShell(3X)



   NAME
     VVeennddoorrSShheellll-The VendorShell widget class

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     VendorShell is a Motif widget class used as a supporting superclass for
     all shell classes that are visible to the window manager and that are
     not override redirect.  It contains resources that describe the MWM-
     specific look and feel.  It also manages the MWM-specific communication
     needed by all VendorShell subclasses.  See the mmwwmm(1X) man page for more
     information.  If an application uses the XXmmNNmmwwmmDDeeccoorraattiioonnss, XXmmNNmmwwmmFFuunncc--
     ttiioonnss, or XXmmNNmmwwmmIInnppuuttMMooddee resource, it should include the file
     <<XXmm//MMwwmmUUttiill..hh>>.

     Setting XXmmNNhheeiigghhtt, XXmmNNwwiiddtthh, or XXmmNNbboorrddeerrWWiiddtthh for either a VendorShell
     or its managed child usually sets that resource to the same value in
     both the parent and the child.  When an off-the-spot input method
     exists, the height and width of the shell may be greater than those of
     the managed child in order to accommodate the input method.  In this
     case setting XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh for the shell does not necessarily
     set that resource to the same value in the managed child, and setting
     XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh for the child does not necessarily set that
     resource to the same value in the shell.

     For the managed child of a VendorShell, regardless of the value of the
     shell's XXmmNNaalllloowwSShheellllRReessiizzee, setting XXmmNNxx or XXmmNNyy sets the corresponding
     resource of the parent but does not change the child's position relative
     to the parent.  XXttGGeettVVaalluueess for the child's XXmmNNxx or XXmmNNyy yields the
     value of the corresponding resource in the parent.  The _x and _y coordi-
     nates of the child's upper left outside corner relative to the parent's
     upper left inside corner are both zero minus the value of XXmmNNbboorr--
     ddeerrWWiiddtthh.

     Note that the _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l allows a
     window manager to change or control the border width of a reparented
     top-level window.

     Classes

     VendorShell inherits behavior and resources from CCoorree, CCoommppoossiittee, SShheellll,
     and WWMMSShheellll classes.

     The class pointer is vveennddoorrSShheellllWWiiddggeettCCllaassss.

     The class name is VVeennddoorrSShheellll.

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource


   1-104






                                                              VendorShell(3X)


     values for the inherited classes to set attributes for this widget.  To
     reference a subresource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a subresource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given subresource can be set at creation time
     (C), set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G),
     or is not applicable (N/A).
                                 VVeennddoorrSShheellll RReessoouurrccee SSeett
   NNaammee                     CCllaassss                    TTyyppee            DDeeffaauulltt      AAcccceessss
   _____________________________________________________________________________________
   XmNaudibleWarning        XmCAudibleWarning        unsigned char   XmBELL       CSG
   XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic      CSG
   XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic      CG
   XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmDESTROY    CSG
   XmNinputMethod           XmCInputMethod           String          NULL         CSG
   XmNkeyboardFocusPolicy   XmCKeyboardFocusPolicy   unsigned char   XmEXPLICIT   CSG
   XmNlabelFontList         XmCLabelFontList         XmFontList      dynamic      CSG
   XmNmwmDecorations        XmCMwmDecorations        int             -1           CSG
   XmNmwmFunctions          XmCMwmFunctions          int             -1           CSG
   XmNmwmInputMode          XmCMwmInputMode          int             -1           CSG
   XmNmwmMenu               XmCMwmMenu               String          NULL         CSG
   XmNpreeditType           XmCPreeditType           String          dynamic      CSG
   XmNshellUnitType         XmCShellUnitType         unsigned char   XmPIXELS     CSG
   XmNtextFontList          XmCTextFontList          XmFontList      dynamic      CSG
   XmNuseAsyncGeometry      XmCUseAsyncGeometry      Boolean         False        CSG

     XXmmNNaauuddiibblleeWWaarrnniinngg
               Determines whether an action activates its associated audible
               cue.  The possible values are: XXmmBBEELLLL and XXmmNNOONNEE.

     XXmmNNbbuuttttoonnFFoonnttLLiisstt
               Specifies the font list used for VendorShell's button descen-
               dants.  If this value is NULL at initialization and if the
               value of XXmmNNddeeffaauullttFFoonnttLLiisstt is not NULL, XXmmNNbbuuttttoonnFFoonnttLLiisstt is
               initialized to the value of XXmmNNddeeffaauullttFFoonnttLLiisstt.  If the value
               of XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL, XXmmNNbbuuttttoonnFFoonnttLLiisstt is initial-
               ized by looking up the parent hierarchy of the widget for an
               ancestor that is a subclass of the XmBulletinBoard, Vendor-
               Shell, or XmMenuShell widget class.  If such an ancestor is
               found, XXmmNNbbuuttttoonnFFoonnttLLiisstt is initialized to the XXmmNNbbuuttttoonn--
               FFoonnttLLiisstt of the ancestor  widget.  If no such ancestor is
               found, the default is implementation dependent.

     XXmmNNddeeffaauullttFFoonnttLLiisstt
               Specifies a default font list for VendorShell's descendants.
               This resource is obsolete and exists for compatibility with
               earlier releases.  It has been replaced by XXmmNNbbuuttttoonnFFoonnttLLiisstt,
               XXmmNNllaabbeellFFoonnttLLiisstt, and XXmmNNtteexxttFFoonnttLLiisstt.

     XXmmNNddeelleetteeRReessppoonnssee
               Determines what action the shell takes in response to a
               WWMM__DDEELLEETTEE__WWIINNDDOOWW message.  The setting can be one of three


   1-105






   VendorShell(3X)


               values: XXmmDDEESSTTRROOYY, XXmmUUNNMMAAPP, and XXmmDDOO__NNOOTTHHIINNGG.  The resource is
               scanned, and the appropriate action is taken, after the
               WWMM__DDEELLEETTEE__WWIINNDDOOWW callback list (if any) that is registered
               with the Protocol manager has been called.

     XXmmNNiinnppuuttMMeetthhoodd
               Specifies the string that sets the locale modifier for the
               input method.

     XXmmNNkkeeyybbooaarrddFFooccuussPPoolliiccyy
               Determines allocation of keyboard focus within the widget
               hierarchy rooted at this shell.  The X keyboard focus must be
               directed to somewhere in the hierarchy for this client-side
               focus management to take effect.  Possible values are XXmmEEXXPPLLII--
               CCIITT, specifying a click-to-type policy, and XXmmPPOOIINNTTEERR, speci-
               fying a pointer-driven policy.

     XXmmNNllaabbeellFFoonnttLLiisstt
               Specifies the font list used for VendorShell's label descen-
               dants (Labels and LabelGadgets).  If this value is NULL at
               initialization and if the value of XXmmNNddeeffaauullttFFoonnttLLiisstt is not
               NULL, XXmmNNllaabbeellFFoonnttLLiisstt is initialized to the value of XXmmNNddee--
               ffaauullttFFoonnttLLiisstt.  If the value of XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL,
               XXmmNNllaabbeellFFoonnttLLiisstt is initialized by looking up the parent
               hierarchy of the widget for an ancestor that is a subclass of
               the XmBulletinBoard, VendorShell, or XmMenuShell widget class.
               If such an ancestor is found, XXmmNNllaabbeellFFoonnttLLiisstt is initialized
               to the XXmmNNllaabbeellFFoonnttLLiisstt of the ancestor widget.  If no such
               ancestor is found, the default is implementation dependent.

     XXmmNNmmwwmmDDeeccoorraattiioonnss
               Specifies the decoration flags (specific decorations to add or
               remove from the window manager frame) for the __MMOOTTIIFF__WWMM__HHIINNTTSS
               property.  If any decoration flags are specified by the
               __MMOOTTIIFF__WWMM__HHIINNTTSS property, only decorations indicated by both
               that property and the MWM cclliieennttDDeeccoorraattiioonn and ttrraann--
               ssiieennttDDeeccoorraattiioonn resources are displayed.  If no decoration
               flags are specified by the __MMOOTTIIFF__WWMM__HHIINNTTSS property, decora-
               tions indicated by the MWM cclliieennttDDeeccoorraattiioonn and ttrraann--
               ssiieennttDDeeccoorraattiioonn resources are displayed.  The default for the
               XXmmNNmmwwmmDDeeccoorraattiioonnss resource is not to specify any decoration
               flags for the __MMOOTTIIFF__WWMM__HHIINNTTSS property.  The value of this
               resource is the bitwise inclusive OR of one or more flag bits.
               Following are the possible flag bit constants, defined in the
               include file <<XXmm//MMwwmmUUttiill..hh>>:

                 ++oo  MMWWMM__DDEECCOORR__AALLLL-All decorations _e_x_c_e_p_t those specified by
                    other flag bits that are set

                 ++oo  MMWWMM__DDEECCOORR__BBOORRDDEERR-Client window border

                 ++oo  MMWWMM__DDEECCOORR__RREESSIIZZEEHH-Resize frame handles

                 ++oo  MMWWMM__DDEECCOORR__TTIITTLLEE-Title bar


   1-106






                                                              VendorShell(3X)



                 ++oo  MMWWMM__DDEECCOORR__MMEENNUU-Window menu button

                 ++oo  MMWWMM__DDEECCOORR__MMIINNIIMMIIZZEE-Minimize window button

                 ++oo  MMWWMM__DDEECCOORR__MMAAXXIIMMIIZZEE-Maximize window button

     XXmmNNmmwwmmFFuunnccttiioonnss
               Specifies the function flags (specific window manager func-
               tions to apply or not apply to the client window) for the
               __MMOOTTIIFF__WWMM__HHIINNTTSS property.  If any function flags are specified
               by the __MMOOTTIIFF__WWMM__HHIINNTTSS property, only functions indicated by
               both that property and the MWM cclliieennttFFuunnccttiioonnss and ttrraann--
               ssiieennttFFuunnccttiioonnss resources are applied.  If no function flags
               are specified by the __MMOOTTIIFF__WWMM__HHIINNTTSS property, functions indi-
               cated by the MWM cclliieennttFFuunnccttiioonnss and ttrraannssiieennttFFuunnccttiioonnss
               resources are applied.  The default for the XXmmNNmmwwmmFFuunnccttiioonnss
               resource is not to specify any function flags for the
               __MMOOTTIIFF__WWMM__HHIINNTTSS property.  The value of this resource is the
               bitwise inclusive OR of one or more flag bits.  Following are
               the possible flag bit constants, defined in the include file
               <<XXmm//MMwwmmUUttiill..hh>>:

                 ++oo  MMWWMM__FFUUNNCC__AALLLL-All functions _e_x_c_e_p_t those specified by
                    other flag bits that are set

                 ++oo  MMWWMM__FFUUNNCC__RREESSIIZZEE-ff..rreessiizzee

                 ++oo  MMWWMM__FFUUNNCC__MMOOVVEE-ff..mmoovvee

                 ++oo  MMWWMM__FFUUNNCC__MMIINNIIMMIIZZEE-ff..mmiinniimmiizzee

                 ++oo  MMWWMM__FFUUNNCC__MMAAXXIIMMIIZZEE-ff..mmaaxxiimmiizzee

                 ++oo  MMWWMM__FFUUNNCC__CCLLOOSSEE-ff..kkiillll

     XXmmNNmmwwmmIInnppuuttMMooddee
               Specifies the input mode flag (application modal or system
               modal input constraints) for the __MMOOTTIIFF__WWMM__HHIINNTTSS property.  If
               no input mode flag is specified by the __MMOOTTIIFF__WWMM__HHIINNTTSS pro-
               perty, no input constraints are applied, and input goes to any
               window.  The default for the XXmmNNmmwwmmIInnppuuttMMooddee resource is not
               to specify any input mode flag for the __MMOOTTIIFF__WWMM__HHIINNTTSS pro-
               perty.  An application that sets input constraints on a dialog
               usually uses the BulletinBoard's XXmmNNddiiaallooggSSttyyllee resource
               rather than the parent DialogShell's XXmmNNmmwwmmIInnppuuttMMooddee resource.
               Following are the possible values for this resource, defined
               in the include file <<XXmm//MMwwmmUUttiill..hh>>:

                 ++oo  MMWWMM__IINNPPUUTT__MMOODDEELLEESSSS-Input goes to any window

                 ++oo  MMWWMM__IINNPPUUTT__PPRRIIMMAARRYY__AAPPPPLLIICCAATTIIOONN__MMOODDAALL-Input does not go to
                    ancestors of this window



   1-107






   VendorShell(3X)


                 ++oo  MMWWMM__IINNPPUUTT__SSYYSSTTEEMM__MMOODDAALL-Input goes only to this window

                 ++oo  MMWWMM__IINNPPUUTT__FFUULLLL__AAPPPPLLIICCAATTIIOONN__MMOODDAALL-Input does not go to
                    other windows in this application

     XXmmNNmmwwmmMMeennuu
               Specifies the menu items that the Motif window manager should
               add to the end of the window menu.  The string contains a list
               of items separated by \n with the following format:
               _l_a_b_e_l [_m_n_e_m_o_n_i_c] [_a_c_c_e_l_e_r_a_t_o_r] _f_u_n_c_t_i_o_n
               If more than one item is specified, the items should be
               separated by a newline character.

     XXmmNNpprreeeeddiittTTyyppee
               Specifies the input method style or styles available to the
               input manager.  The syntax, possible values, and default value
               are implementation dependent.

     XXmmNNsshheellllUUnniittTTyyppee
               Determines geometric resource interpretation.  The following
               values are allowed:

                 ++oo  XXmmPPIIXXEELLSS-all values provided to the widget are treated as
                    normal pixel values.

                 ++oo  XXmm110000TTHH__MMIILLLLIIMMEETTEERRSS-all values provided to the widget are
                    treated as 1/100 millimeter.

                 ++oo  XXmm11000000TTHH__IINNCCHHEESS-all values provided to the widget are
                    treated as 1/1000 inch.

                 ++oo  XXmm110000TTHH__PPOOIINNTTSS-all values provided to the widget are
                    treated as 1/100 point.  A point is a unit used in text
                    processing applications and is defined as 1/72 inch.

                 ++oo  XXmm110000TTHH__FFOONNTT__UUNNIITTSS-all values provided to the widget are
                    treated as 1/100 of a font unit.  A font unit has hor-
                    izontal and vertical components.  These are the values of
                    the XmScreen resources XXmmNNhhoorriizzoonnttaallFFoonnttUUnniitt and XXmmNNvveerr--
                    ttiiccaallFFoonnttUUnniitt.

     XXmmNNtteexxttFFoonnttLLiisstt
               Specifies the font list used for VendorShell's Text and List
               descendants.  If this value is NULL at initialization and if
               the value of XXmmNNddeeffaauullttFFoonnttLLiisstt is not NULL, XXmmNNtteexxttFFoonnttLLiisstt
               is initialized to the value of XXmmNNddeeffaauullttFFoonnttLLiisstt.  If the
               value of XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL, XXmmNNtteexxttFFoonnttLLiisstt is ini-
               tialized by looking up the parent hierarchy of the widget for
               an ancestor that is a subclass of the XmBulletinBoard or Ven-
               dorShell widget class.  If such an ancestor is found,
               XXmmNNtteexxttFFoonnttLLiisstt is initialized to the XXmmNNtteexxttFFoonnttLLiisstt of the
               ancestor widget.  If no such ancestor is found, the default is
               implementation dependent.



   1-108






                                                              VendorShell(3X)


     XXmmNNuusseeAAssyynnccGGeeoommeettrryy
               Specifies whether the geometry manager should wait for confir-
               mation of a geometry request to the window manager.  When the
               value of this resource is True, the geometry manager forces
               XXmmNNwwaaiittFFoorrWWmm to False and XXmmNNwwmmTTiimmeeoouutt to 0, and it relies on
               asynchronous notification.  When the value of this resource is
               False, XXmmNNwwaaiittFFoorrWWmm and XXmmNNwwmmTTiimmeeoouutt are unaffected.  The
               default is False.

     Inherited Resources

     VendorShell inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   XmNbaseHeight      XmCBaseHeight      int       XtUnspecifiedShellInt   CSG
   XmNbaseWidth       XmCBaseWidth       int       XtUnspecifiedShellInt   CSG
   XmNheightInc       XmCHeightInc       int       XtUnspecifiedShellInt   CSG
   XmNiconMask        XmCIconMask        Pixmap    NULL                    CSG
   XmNiconPixmap      XmCIconPixmap      Pixmap    NULL                    CSG
   XmNiconWindow      XmCIconWindow      Window    NULL                    CSG
   XmNiconX           XmCIconX           int       -1                      CSG
   XmNiconY           XmCIconY           int       -1                      CSG
   XmNinitialState    XmCInitialState    int       NormalState             CSG
   XmNinput           XmCInput           Boolean   True                    CSG
   XmNmaxAspectX      XmCMaxAspectX      int       XtUnspecifiedShellInt   CSG
   XmNmaxAspectY      XmCMaxAspectY      int       XtUnspecifiedShellInt   CSG
   XmNmaxHeight       XmCMaxHeight       int       XtUnspecifiedShellInt   CSG
   XmNmaxWidth        XmCMaxWidth        int       XtUnspecifiedShellInt   CSG
   XmNminAspectX      XmCMinAspectX      int       XtUnspecifiedShellInt   CSG
   XmNminAspectY      XmCMinAspectY      int       XtUnspecifiedShellInt   CSG
   XmNminHeight       XmCMinHeight       int       XtUnspecifiedShellInt   CSG
   XmNminWidth        XmCMinWidth        int       XtUnspecifiedShellInt   CSG
   XmNtitle           XmCTitle           String    dynamic                 CSG
   XmNtitleEncoding   XmCTitleEncoding   Atom      dynamic                 CSG
   XmNtransient       XmCTransient       Boolean   False                   CSG
   XmNwaitForWm       XmCWaitForWm       Boolean   True                    CSG
   XmNwidthInc        XmCWidthInc        int       XtUnspecifiedShellInt   CSG
   XmNwindowGroup     XmCWindowGroup     Window    dynamic                 CSG
   XmNwinGravity      XmCWinGravity      int       dynamic                 CSG
   XmNwmTimeout       XmCWmTimeout       int       5000 ms                 CSG
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   XmNallowShellResize       XmCAllowShellResize       Boolean                  False            CG
   XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
   XmNgeometry               XmCGeometry               String                   NULL             CSG
   XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  False            CSG
   XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C
   XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
   XmNsaveUnder              XmCSaveUnder              Boolean                  False            CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG


   1-109






   VendorShell(3X)


                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
   XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
   XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
   XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
   XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderWidth                  XmCBorderWidth                  Dimension        1                      CSG
   XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
   XmNdepth                        XmCDepth                        int              dynamic                CG
   XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
   XmNheight                       XmCHeight                       Dimension        dynamic                CSG
   XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
   XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
   XmNscreen                       XmCScreen                       Screen *         dynamic                CG
   XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
   XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
   XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
   XmNx                            XmCPosition                     Position         0                      CSG
   XmNy                            XmCPosition                     Position         0                      CSG

     Translations

     There are no translations for VendorShell.

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), mmwwmm((11XX)), SShheellll((33XX)), WWMMSShheellll((33XX)),
     XXmmAAccttiivvaatteePPrroottooccooll((33XX)), XXmmAAccttiivvaatteeWWMMPPrroottooccooll((33XX)),
     XXmmAAddddPPrroottooccoollCCaallllbbaacckk((33XX)), XXmmAAddddWWMMPPrroottooccoollCCaallllbbaacckk((33XX)),
     XXmmAAddddPPrroottooccoollss((33XX)), XXmmAAddddWWMMPPrroottooccoollss((33XX)), XXmmDDeeaaccttiivvaatteePPrroottooccooll((33XX)),
     XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll((33XX)), XXmmGGeettAAttoommNNaammee((33XX)), XXmmIInntteerrnnAAttoomm((33XX)),
     XXmmIIssMMoottiiffWWMMRRuunnnniinngg((33XX)), XXmmRReemmoovveePPrroottooccoollCCaallllbbaacckk((33XX)),
     XXmmRReemmoovveeWWMMPPrroottooccoollCCaallllbbaacckk((33XX)), XXmmRReemmoovveePPrroottooccoollss((33XX)),
     XXmmRReemmoovveeWWMMPPrroottooccoollss((33XX)), XXmmSSccrreeeenn((33XX)), XXmmSSeettPPrroottooccoollHHooookkss((33XX)), and
     XXmmSSeettWWMMPPrroottooccoollHHooookkss((33XX)).













   1-110






                                                          VirtualBindings(3X)



   NAME
     VViirrttuuaallBBiinnddiinnggss-Bindings for virtual mouse and key events

   DESCRIPTION
     The 1/Motif manual pages describe translations in terms of _v_i_r_t_u_a_l _b_i_n_d_-
     _i_n_g_s, based on those described in the _O_S_F/_M_o_t_i_f _S_t_y_l_e _G_u_i_d_e.  Mouse
     events are described in terms of _v_i_r_t_u_a_l _b_u_t_t_o_n_s, and key events are
     described in terms of _v_i_r_t_u_a_l _k_e_y_s.  The term _v_i_r_t_u_a_l implies that the
     events as described do not necessarily correspond to a fixed set of X
     Window System events.  Instead, virtual buttons and keys are linked to
     actual events by means of virtual bindings.

     Virtual Modifiers

     Both virtual buttons and virtual keys may contain _v_i_r_t_u_a_l _m_o_d_i_f_i_e_r_s.
     Each virtual modifier corresponds to one or more actual modifiers.  The
     following table lists the bindings of virtual modifiers to actual modif-
     iers in 1/Motif:

                            VViirrttuuaall MMooddiiffiieerr BBiinnddiinnggss
                       VViirrttuuaall MMooddiiffiieerr   AAccttuuaall MMooddiiffiieerrss
                       ___________________________________
                       MMAAlltt               MMoodd11
                       MMCCooppyy              CCttrrll
                       MMCCttrrll              CCttrrll
                       MMLLiinnkk              CCttrrll SShhiifftt
                       MMMMoovvee              SShhiifftt
                       MMSShhiifftt             SShhiifftt

     MMoodd11 refers to the first modifier key.  1/Motif requires that it
     correspond to either AAlltt or MMeettaa.

     The virtual modifier MMAAnnyy indicates that any modifier can be used.  If
     MMAAnnyy is not specified and the user presses an actual modifier that is
     not explicitly included in a translation, that modifier may prevent the
     translation from being matched.

     Virtual Buttons

     Each virtual button corresponds to one or more actual button event
     descriptions.  Each button event description contains a button name and
     possibly modifiers.  These button event descriptions, appropriately
     ordered and possibly further modified, are used in translation tables.
     The following table lists the bindings of virtual buttons to actual but-
     ton event descriptions in 1/Motif:

                             VViirrttuuaall BBuuttttoonn BBiinnddiinnggss
                      VViirrttuuaall BBuuttttoonn   AAccttuuaall BBuuttttoonn EEvveennttss
                      _____________________________________
                      BBCCuussttoomm          <<BBttnn33>>
                      BBDDrraagg            <<BBttnn22>>
                      BBEExxtteenndd          SShhiifftt<<BBttnn11>>
                      BBMMeennuu            <<BBttnn33>>


   1-111






   VirtualBindings(3X)


                      BBSSeelleecctt          <<BBttnn11>>
                      BBTTooggggllee          CCttrrll<<BBttnn11>>

     Virtual Keys

     Each virtual key corresponds to one or more actual key event descrip-
     tions.  Each key event description contains a keysym name and possibly
     modifiers.  These key event descriptions, appropriately ordered and pos-
     sibly further modified, are used in translation tables.  The following
     table lists the bindings of virtual keys to actual key event descrip-
     tions in 1/Motif:

                               VViirrttuuaall KKeeyy BBiinnddiinnggss
                       ____________________________________
                       VViirrttuuaall KKeeyy    AAccttuuaall KKeeyy EEvveennttss
                       ________________________________________________________________________
                       KKAAccttiivvaattee      <<KKeeyy>>RReettuurrnn
                                      CCttrrll<<KKeeyy>>RReettuurrnn
                                      <<KKeeyy>>oossffAAccttiivvaattee
                       ____________________________________
                       KKAAddddMMooddee       <<KKeeyy>>oossffAAddddMMooddee
                       ____________________________________
                       KKBBaacckkSSppaaccee     <<KKeeyy>>oossffBBaacckkSSppaaccee
                       ____________________________________
                       KKBBaacckkTTaabb       SShhiifftt<<KKeeyy>>TTaabb
                       ____________________________________
                       KKBBeeggiinnDDaattaa     CCttrrll<<KKeeyy>>oossffBBeeggiinnLLiinnee
                       ____________________________________
                       KKBBeeggiinnLLiinnee     <<KKeeyy>>oossffBBeeggiinnLLiinnee
                       ____________________________________
                       KKCCaanncceell        <<KKeeyy>>oossffCCaanncceell
                       ____________________________________
                       KKCClleeaarr         <<KKeeyy>>oossffCClleeaarr
                       ____________________________________
                       KKCCooppyy          <<KKeeyy>>oossffCCooppyy
                                      CCttrrll<<KKeeyy>>oossffIInnsseerrtt
                       ____________________________________
                       KKCCuutt           <<KKeeyy>>oossffCCuutt
                                      SShhiifftt<<KKeeyy>>oossffDDeelleettee
                       ____________________________________
                       KKDDeelleettee        <<KKeeyy>>oossffDDeelleettee
                       ____________________________________
                       KKDDeesseelleeccttAAllll   CCttrrll<<KKeeyy>>bbaacckkssllaasshh
                       ____________________________________
                       KKDDoowwnn          <<KKeeyy>>oossffDDoowwnn
                       ____________________________________
                       KKEEnnddDDaattaa       CCttrrll<<KKeeyy>>oossffEEnnddLLiinnee
                       ____________________________________
                       KKEEnnddLLiinnee       <<KKeeyy>>oossffEEnnddLLiinnee
                       ____________________________________
                       KKEEnntteerr         <<KKeeyy>>RReettuurrnn
                       ____________________________________
                       KKEEssccaappee        <<KKeeyy>>EEssccaappee
                       ____________________________________


   1-112






                                                          VirtualBindings(3X)


                       KKEExxtteenndd        CCttrrll SShhiifftt<<KKeeyy>>ssppaaccee
                                      SShhiifftt<<KKeeyy>>oossffSSeelleecctt
                       ____________________________________
                       KKHHeellpp          <<KKeeyy>>oossffHHeellpp
                       ____________________________________
                       KKIInnsseerrtt        <<KKeeyy>>oossffIInnsseerrtt
                       ____________________________________
                         VViirrttuuaall KKeeyy BBiinnddiinnggss ((CCoonnttiinnuueedd))
                     ________________________________________
                     VViirrttuuaall KKeeyy     AAccttuuaall KKeeyy EEvveennttss
                     ________________________________________________________________________________
                     KKLLeefftt           <<KKeeyy>>oossffLLeefftt
                     ________________________________________
                     KKMMeennuu           <<KKeeyy>>oossffMMeennuu
                     ________________________________________
                     KKMMeennuuBBaarr        <<KKeeyy>>oossffMMeennuuBBaarr
                     ________________________________________
                     KKNNeexxttFFiieelldd      <<KKeeyy>>TTaabb
                                     CCttrrll<<KKeeyy>>TTaabb
                     ________________________________________
                     KKNNeexxttMMeennuu       CCttrrll<<KKeeyy>>oossffDDoowwnn
                                     CCttrrll<<KKeeyy>>oossffRRiigghhtt
                     ________________________________________
                     KKPPaaggeeDDoowwnn       <<KKeeyy>>oossffPPaaggeeDDoowwnn
                     ________________________________________
                     KKPPaaggeeLLeefftt       CCttrrll<<KKeeyy>>oossffPPaaggeeUUpp
                                     <<KKeeyy>>oossffPPaaggeeLLeefftt
                     ________________________________________
                     KKPPaaggeeRRiigghhtt      CCttrrll<<KKeeyy>>oossffPPaaggeeDDoowwnn
                                     <<KKeeyy>>oossffPPaaggeeRRiigghhtt
                     ________________________________________
                     KKPPaaggeeUUpp         <<KKeeyy>>oossffPPaaggeeUUpp
                     ________________________________________
                     KKPPaassttee          <<KKeeyy>>oossffPPaassttee
                                     SShhiifftt<<KKeeyy>>oossffIInnsseerrtt
                     ________________________________________
                     KKPPrreevvFFiieelldd      SShhiifftt<<KKeeyy>>TTaabb
                                     CCttrrll SShhiifftt<<KKeeyy>>TTaabb
                     ________________________________________
                     KKPPrreevvMMeennuu       CCttrrll<<KKeeyy>>oossffUUpp
                                     CCttrrll<<KKeeyy>>oossffLLeefftt
                     ________________________________________
                     KKPPrriimmaarryyCCooppyy    CCttrrll<<KKeeyy>>oossffPPrriimmaarryyPPaassttee
                                     MMoodd11<<KKeeyy>>oossffCCooppyy
                                     MMoodd11 CCttrrll<<KKeeyy>>oossffIInnsseerrtt
                     ________________________________________
                     KKPPrriimmaarryyCCuutt     MMoodd11<<KKeeyy>>oossffPPrriimmaarryyPPaassttee
                                     MMoodd11<<KKeeyy>>oossffCCuutt
                                     MMoodd11 SShhiifftt<<KKeeyy>>oossffDDeelleettee
                     ________________________________________
                     KKPPrriimmaarryyPPaassttee   <<KKeeyy>>oossffPPrriimmaarryyPPaassttee
                     ________________________________________
                     KKQQuuiicckkCCooppyy      CCttrrll<<KKeeyy>>oossffQQuuiicckkPPaassttee
                     ________________________________________


   1-113






   VirtualBindings(3X)


                     KKQQuuiicckkCCuutt       MMoodd11<<KKeeyy>>oossffQQuuiicckkPPaassttee
                     ________________________________________
                     KKQQuuiicckkEExxtteenndd    SShhiifftt<<KKeeyy>>oossffQQuuiicckkPPaassttee
                     ________________________________________
                         VViirrttuuaall KKeeyy BBiinnddiinnggss ((CCoonnttiinnuueedd))
                      ______________________________________
                      VViirrttuuaall KKeeyy   AAccttuuaall KKeeyy EEvveennttss
                      ____________________________________________________________________________
                      KKQQuuiicckkPPaassttee   <<KKeeyy>>oossffQQuuiicckkPPaassttee
                      ______________________________________
                      KKRReesseelleecctt     CCttrrll SShhiifftt<<KKeeyy>>oossffSSeelleecctt
                      ______________________________________
                      KKRReessttoorree      CCttrrll SShhiifftt<<KKeeyy>>oossffIInnsseerrtt
                      ______________________________________
                      KKRRiigghhtt        <<KKeeyy>>oossffRRiigghhtt
                      ______________________________________
                      KKSSeelleecctt       <<KKeeyy>>ssppaaccee
                                    CCttrrll<<KKeeyy>>ssppaaccee
                                    <<KKeeyy>>oossffSSeelleecctt
                      ______________________________________
                      KKSSeelleeccttAAllll    CCttrrll<<KKeeyy>>ssllaasshh
                      ______________________________________
                      KKSSppaaccee        <<KKeeyy>>ssppaaccee
                      ______________________________________
                      KKTTaabb          <<KKeeyy>>TTaabb
                      ______________________________________
                      KKUUnnddoo         <<KKeeyy>>oossffUUnnddoo
                                    MMoodd11<<KKeeyy>>oossffBBaacckkSSppaaccee
                      ______________________________________
                      KKUUpp           <<KKeeyy>>oossffUUpp
                      ______________________________________
                      KKAAnnyy          <<KKeeyy>>
                      ______________________________________

     Bindings for osf Keysyms

     Keysym strings that begin with "osf" are not part of the X server's key-
     board mapping.  Instead, these keysyms are produced on the client side
     at run time.  They are interpreted by the routine XXmmTTrraannssllaatteeKKeeyy, and
     are used by the translation manager when the server delivers an actual
     key event.  For each application, a mapping is maintained between "osf"
     keysyms and keysyms that correspond to actual keys.  This mapping is
     based on information obtained at application startup from one of the
     following sources, listed in order of precedence:

       ++oo  A ddeeffaauullttVViirrttuuaallBBiinnddiinnggss application resource in the resource data-
          base.

       ++oo  A property on the root window, which can be set by mmwwmm on startup,
          or by the xxmmbbiinndd client, or on prior startup of a Motif applica-
          tion.

       ++oo  The file ..mmoottiiffbbiinndd in the user's home directory.



   1-114






                                                          VirtualBindings(3X)


       ++oo  A set of bindings based on the vendor string and optionally the
          vendor release of the X server.  Motif searches for these bindings
          in the following steps:

            ---- If the file xxmmbbiinndd..aalliiaass exists in the user's home directory,
               Motif searches this file for a pathname associated with the
               vendor string or with the vendor string and vendor release.
               If it finds such a pathname and if that file exists, Motif
               loads the bindings contained in that file.

            ---- If it has found no bindings, Motif next looks for the file
               xxmmbbiinndd..aalliiaass in the directory specified by the environment
               variable XXMMBBIINNDDDDIIRR, if XXMMBBIINNDDDDIIRR is set, or in the directory
               //uussrr//lliibb//XXmm//bbiinnddiinnggss if XXMMBBIINNDDDDIIRR is not set.  If this file
               exists Motif searches it for a pathname associated with the
               vendor string or with the vendor string and vendor release.
               If it finds such a pathname and if that file exists, Motif
               loads the bindings contained in that file.

            ---- If it still has found no bindings, Motif loads a set of hard-
               coded fallback bindings.

     The xxmmbbiinndd..aalliiaass file contains zero or more lines of the form:

     "_v_e_n_d_o_r__s_t_r_i_n_g[ _v_e_n_d_o_r__r_e_l_e_a_s_e]"_b_i_n_d_i_n_g_s__f_i_l_e

     where _v_e_n_d_o_r__s_t_r_i_n_g is the X server vendor name as  returned  by  the  X
     client  xxddppyyiinnffoo  or the Xlib function XXSSeerrvveerrVVeennddoorr, and must appear in
     double quotes.  If _v_e_n_d_o_r__r_e_l_e_a_s_e is included, it is the X server vendor
     release number as returned by the X client xxddppyyiinnffoo or the Xlib function
     XXVVeennddoorrRReelleeaassee, and must also be  contained  within  the  double  quotes
     separated  by  one space from _v_e_n_d_o_r__s_t_r_i_n_g.  _v_e_n_d_o_r__r_e_l_e_a_s_e is provided
     to allow support of changes in keyboard hardware from a vendor, assuming
     that  the  vendor  increments  the  release number to flag such changes.
     Alternatively, the vendor may simply use a unique vendor string for each
     different keyboard.

     _b_i_n_d_i_n_g_s__f_i_l_e is the pathname of the file containing the bindings  them-
     selves.  It can be a relative or absolute pathname.  If it it is a rela-
     tive pathname, it is relative to the location of the xxmmbbiinndd..aalliiaass file.

     Comment lines in the xxmmbbiinndd..aalliiaass file begin with !!.

     The bindings found in either the ..mmoottiiffbbiinndd file or the  vendor  mapping
     are  placed  in a property on the root window.  This property is used to
     determine the bindings for subsequent Motif applications.

     On startup mmwwmm attempts to load the file ..mmoottiiffbbiinndd in the  user's  home
     directory.   If  this  is  unsuccessful, it loads the vendor bindings as
     described above.  It places the bindings it loads in a property  on  the
     root window for use by subsequent Motif applications.

     xxmmbbiinndd loads bindings from a file if that file is specified on the  com-
     mand  line.  If no file is specified on the command line, it attempts to


   1-115






   VirtualBindings(3X)


     load the file ..mmoottiiffbbiinndd in the user's home directory.  If  this  fails,
     it loads the vendor bindings as described above.  It places the bindings
     it loads in a property on the root window for use  by  subsequent  Motif
     applications.

     The format of the specification for  mapping  "osf"  keysyms  to  actual
     keysyms  is similar to that of a specification for an event translation.
     The syntax is specified here in EBNF notation using the  following  con-
     ventions:

     [_a]       Means either nothing or _a
     {_a}       Means zero or more occurrences of _a

     Terminals are enclosed in double quotation marks.

     The syntax of an "osf" keysym binding specification is as follows:

     binding_spec   = {line "\n"} [line]
     line           = virtual_keysym ":" key_event
     key_event      = {modifier_name} "<Key>" actual_keysym
     virtual_keysym = keysym
     actual_keysym  = keysym
     keysym         = A valid X11 keysym name that is
                      mapped by XXSSttrriinnggTTooKKeeyyssyymm

     As with event translations, more specific event descriptions  must  pre-
     cede  less specific descriptions.  For example, an event description for
     a key with a modifier must  precede  a  description  for  the  same  key
     without the same modifier.

     Following is an example of a specification for  the  ddeeffaauullttVViirrttuuaallBBiinndd--
     iinnggss resource in a resource file:
     *defaultVirtualBindings: \
          osfBackSpace   :    <Key>BackSpace\n\
          osfInsert      :    <Key>InsertChar\n\
     ...
          osfDelete      :    <Key>DeleteChar

     The format of a ..mmoottiiffbbiinndd file or of a file containing vendor  bindings
     is  the  same,  except that the binding specification for each keysym is
     placed on a separate line.  The example specification above  appears  as
     follows in a ..mmoottiiffbbiinndd or vendor bindings file:
     osfBackSpace   :    <Key>BackSpace
     osfInsert      :    <Key>InsertChar
     ...
     osfDelete      :    <Key>DeleteChar

     The following table lists the fixed fallback default bindings for  "osf"
     keysyms:







   1-116






                                                          VirtualBindings(3X)


                   FFaallllbbaacckk DDeeffaauulltt BBiinnddiinnggss ffoorr ""oossff"" KKeeyyssyymmss
                   ""oossff"" KKeeyyssyymm      FFaallllbbaacckk DDeeffaauulltt BBiinnddiinngg
                   ___________________________________________
                   oossffAAccttiivvaattee       <<uunnbboouunndd>>
                   oossffAAddddMMooddee        SShhiifftt FF88
                   oossffBBaacckkSSppaaccee      BBaacckkssppaaccee
                   oossffBBeeggiinnLLiinnee      HHoommee
                   oossffCClleeaarr          CClleeaarr
                   oossffCCooppyy           <<uunnbboouunndd>>
                   oossffCCuutt            <<uunnbboouunndd>>
                   oossffDDeelleettee         DDeelleettee
                   oossffDDoowwnn           DDoowwnn
                   oossffEEnnddLLiinnee        EEnndd
                   oossffCCaanncceell         EEssccaappee
                   oossffHHeellpp           FF11
                   oossffIInnsseerrtt         IInnsseerrtt
                   oossffLLeefftt           LLeefftt
                   oossffMMeennuu           FF44
                   oossffMMeennuuBBaarr        FF1100
                   oossffPPaaggeeDDoowwnn       NNeexxtt
                   oossffPPaaggeeLLeefftt       <<uunnbboouunndd>>
                   oossffPPaaggeeRRiigghhtt      <<uunnbboouunndd>>
                   oossffPPaaggeeUUpp         PPrriioorr
                   oossffPPaassttee          <<uunnbboouunndd>>
                   oossffPPrriimmaarryyPPaassttee   <<uunnbboouunndd>>
                   oossffQQuuiicckkPPaassttee     <<uunnbboouunndd>>
                   oossffRRiigghhtt          RRiigghhtt
                   oossffSSeelleecctt         SSeelleecctt
                   oossffUUnnddoo           UUnnddoo
                   oossffUUpp             UUpp

   RELATED INFORMATION
     xxmmbbiinndd((11XX))























   1-117






   WMShell(3X)



   NAME
     WWMMSShheellll-The WMShell widget class

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     WMShell is a top-level widget that encapsulates the interaction with the
     window manager.

     Classes

     WMShell inherits behavior and resources from CCoorree, CCoommppoossiittee, and SShheellll
     classes.

     The class pointer is wwmmSShheellllWWiiddggeettCCllaassss.

     The class name is WWMMSShheellll.

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource
     values for the inherited classes to set attributes for this widget.  To
     reference a resource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given resource can be set at creation time (C),
     set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   XmNbaseHeight      XmCBaseHeight      int       XtUnspecifiedShellInt   CSG
   XmNbaseWidth       XmCBaseWidth       int       XtUnspecifiedShellInt   CSG
   XmNheightInc       XmCHeightInc       int       XtUnspecifiedShellInt   CSG
   XmNiconMask        XmCIconMask        Pixmap    NULL                    CSG
   XmNiconPixmap      XmCIconPixmap      Pixmap    NULL                    CSG
   XmNiconWindow      XmCIconWindow      Window    NULL                    CSG
   XmNiconX           XmCIconX           int       -1                      CSG
   XmNiconY           XmCIconY           int       -1                      CSG
   XmNinitialState    XmCInitialState    int       NormalState             CSG
   XmNinput           XmCInput           Boolean   False                   CSG
   XmNmaxAspectX      XmCMaxAspectX      int       XtUnspecifiedShellInt   CSG
   XmNmaxAspectY      XmCMaxAspectY      int       XtUnspecifiedShellInt   CSG
   XmNmaxHeight       XmCMaxHeight       int       XtUnspecifiedShellInt   CSG
   XmNmaxWidth        XmCMaxWidth        int       XtUnspecifiedShellInt   CSG
   XmNminAspectX      XmCMinAspectX      int       XtUnspecifiedShellInt   CSG
   XmNminAspectY      XmCMinAspectY      int       XtUnspecifiedShellInt   CSG
   XmNminHeight       XmCMinHeight       int       XtUnspecifiedShellInt   CSG


   1-118






                                                                  WMShell(3X)


   XmNminWidth        XmCMinWidth        int       XtUnspecifiedShellInt   CSG
   XmNtitle           XmCTitle           String    dynamic                 CSG
   XmNtitleEncoding   XmCTitleEncoding   Atom      dynamic                 CSG
   XmNtransient       XmCTransient       Boolean   False                   CSG
   XmNwaitForWm       XmCWaitForWm       Boolean   True                    CSG
   XmNwidthInc        XmCWidthInc        int       XtUnspecifiedShellInt   CSG
   XmNwindowGroup     XmCWindowGroup     Window    dynamic                 CSG
   XmNwinGravity      XmCWinGravity      int       dynamic                 CSG
   XmNwmTimeout       XmCWmTimeout       int       5000 ms                 CSG

     XXmmNNbbaasseeHHeeiigghhtt
               Specifies the base for a progression of preferred heights for
               the window manager to use in sizing the widget.  The preferred
               heights are XXmmNNbbaasseeHHeeiigghhtt plus integral multiples of
               XXmmNNhheeiigghhttIInncc, with a minimum of XXmmNNmmiinnHHeeiigghhtt and a maximum of
               XXmmNNmmaaxxHHeeiigghhtt.  If an initial value is not supplied for
               XXmmNNbbaasseeHHeeiigghhtt but is supplied for XXmmNNbbaasseeWWiiddtthh, the value of
               XXmmNNbbaasseeHHeeiigghhtt is set to 0 when the widget is realized.

     XXmmNNbbaasseeWWiiddtthh
               Specifies the base for a progression of preferred widths for
               the window manager to use in sizing the widget.  The preferred
               widths are XXmmNNbbaasseeWWiiddtthh plus integral multiples of
               XXmmNNwwiiddtthhIInncc, with a minimum of XXmmNNmmiinnWWiiddtthh and a maximum of
               XXmmNNmmaaxxWWiiddtthh.  If an initial value is not supplied for
               XXmmNNbbaasseeWWiiddtthh but is supplied for XXmmNNbbaasseeHHeeiigghhtt, the value of
               XXmmNNbbaasseeWWiiddtthh is set to 0 when the widget is realized.

     XXmmNNhheeiigghhttIInncc
               Specifies the increment for a progression of preferred heights
               for the window manager to use in sizing the widget.  The pre-
               ferred heights are XXmmNNbbaasseeHHeeiigghhtt plus integral multiples of
               XXmmNNhheeiigghhttIInncc, with a minimum of XXmmNNmmiinnHHeeiigghhtt and a maximum of
               XXmmNNmmaaxxHHeeiigghhtt.  If an initial value is not supplied for
               XXmmNNhheeiigghhttIInncc but is supplied for XXmmNNwwiiddtthhIInncc, the value of
               XXmmNNhheeiigghhttIInncc is set to 1 when the widget is realized.

     XXmmNNiiccoonnMMaasskk
               Specifies a bitmap that could be used by the window manager to
               clip the XXmmNNiiccoonnPPiixxmmaapp bitmap to make the icon nonrectangular.

     XXmmNNiiccoonnPPiixxmmaapp
               Specifies a bitmap that could be used by the window manager as
               the application's icon.

     XXmmNNiiccoonnWWiinnddooww
               Specifies the ID of a window that could be used by the window
               manager as the application's icon.

     XXmmNNiiccoonnXX  Specifies a suitable place to put the application's icon; this
               is a hint to the window manager in root window coordinates.
               Since the window manager controls icon placement policy, this
               may be ignored.  If no initial value is specified, the value
               is set to -1 when the widget is realized.


   1-119






   WMShell(3X)



     XXmmNNiiccoonnYY  Specifies a suitable place to put the application's icon; this
               is a hint to the window manager in root window coordinates.
               Since the window manager controls icon placement policy, this
               may be ignored.  If no initial value is specified, the value
               is set to -1 when the widget is realized.

     XXmmNNiinniittiiaallSSttaattee
               Specifies the state in which the application wishes the widget
               instance to start.  It must be one of the constants NNoorrmmaall--
               SSttaattee or IIccoonniiccSSttaattee.

     XXmmNNiinnppuutt  Specifies the application's input model for this widget and
               its descendants.  The meaning of a True or False value for
               this resource depends on the presence or absence of a
               WWMM__TTAAKKEE__FFOOCCUUSS atom in the WWMM__PPRROOTTOOCCOOLLSS property:
                         IInnppuutt MMooddeell       XXmmNNiinnppuutt   WWMM__TTAAKKEE__FFOOCCUUSS
                         __________________________________________
                         No input          False      Absent
                         Passive           True       Absent
                         Locally active    True       Present
                         Globally active   False      Present
               For more information on input models, see the X Consortium
               Standard _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l.

     XXmmNNmmaaxxAAssppeeccttXX
               Specifies the numerator of the maximum aspect ratio (X/Y) that
               the application wishes the widget instance to have.

     XXmmNNmmaaxxAAssppeeccttYY
               Specifies the denominator of the maximum aspect ratio (X/Y)
               that the application wishes the widget instance to have.

     XXmmNNmmaaxxHHeeiigghhtt
               Specifies the maximum height that the application wishes the
               widget instance to have.  If an initial value is not supplied
               for XXmmNNmmaaxxHHeeiigghhtt but is supplied for XXmmNNmmaaxxWWiiddtthh, the value of
               XXmmNNmmaaxxHHeeiigghhtt is set to 32767 when the widget is realized.

     XXmmNNmmaaxxWWiiddtthh
               Specifies the maximum width that the application wishes the
               widget instance to have.  If an initial value is not supplied
               for XXmmNNmmaaxxWWiiddtthh but is supplied for XXmmNNmmaaxxHHeeiigghhtt, the value of
               XXmmNNmmaaxxWWiiddtthh is set to 32767 when the widget is realized.

     XXmmNNmmiinnAAssppeeccttXX
               Specifies the numerator of the minimum aspect ratio (X/Y) that
               the application wishes the widget instance to have.

     XXmmNNmmiinnAAssppeeccttYY
               Specifies the denominator of the minimum aspect ratio (X/Y)
               that the application wishes the widget instance to have.

     XXmmNNmmiinnHHeeiigghhtt


   1-120






                                                                  WMShell(3X)


               Specifies the minimum height that the application wishes the
               widget instance to have.  If an initial value is not supplied
               for XXmmNNmmiinnHHeeiigghhtt but is supplied for XXmmNNmmiinnWWiiddtthh, the value of
               XXmmNNmmiinnHHeeiigghhtt is set to 1 when the widget is realized.

     XXmmNNmmiinnWWiiddtthh
               Specifies the minimum width that the application wishes the
               widget instance to have.  If an initial value is not supplied
               for XXmmNNmmiinnWWiiddtthh but is supplied for XXmmNNmmiinnHHeeiigghhtt, the value of
               XXmmNNmmiinnWWiiddtthh is set to 1 when the widget is realized.

     XXmmNNttiittllee  Specifies the application name to be displayed by the window
               manager.  The default is the icon name if specified, otherwise
               the name of the application.

     XXmmNNttiittlleeEEnnccooddiinngg
               Specifies a property type that represents the encoding of the
               XXmmNNttiittllee string.  If a language procedure has been set, the
               default is None; otherwise, the default is XA_STRING.  When
               the widget is realized, if the value is None, the correspond-
               ing name is assumed to be in the current locale.  The name is
               passed to XXmmbbTTeexxttLLiissttTTooTTeexxttPPrrooppeerrttyy with an encoding style of
               XXSSttddIICCCCTTeexxttSSttyyllee.  The resulting encoding is "STRING" if the
               name is fully convertible to "STRING," otherwise
               "COMPOUND_TEXT."  The values of the encoding resources are not
               changed; they remain None.

     XXmmNNttrraannssiieenntt
               Specifies a Boolean value that is True if the widget instance
               is transient, typically a popup on behalf of another widget.
               The window manager may treat a transient widget's window dif-
               ferently from other windows.  For example, a window manager
               may not iconify a transient window separately from its associ-
               ated application.  Applications and users should not normally
               alter this resource.

     XXmmNNwwaaiittFFoorrWWmm
               When True, specifies that the Intrinsics waits the length of
               time given by the XXmmNNwwmmTTiimmeeoouutt resource for the window manager
               to respond to certain actions before assuming that there is no
               window manager present.  This resource is altered by the
               Intrinsics as it receives, or fails to receive, responses from
               the window manager.

     XXmmNNwwiiddtthhIInncc
               Specifies the base for a progression of preferred widths for
               the window manager to use in sizing the widget.  The preferred
               widths are XXmmNNbbaasseeWWiiddtthh plus integral multiples of
               XXmmNNwwiiddtthhIInncc, with a minimum of XXmmNNmmiinnWWiiddtthh and a maximum of
               XXmmNNmmaaxxWWiiddtthh.  If an initial value is not supplied for
               XXmmNNwwiiddtthhIInncc but is supplied for XXmmNNhheeiigghhttIInncc, the value of
               XXmmNNwwiiddtthhIInncc is set to 1 when the widget is realized.

     XXmmNNwwiinnddoowwGGrroouupp


   1-121






   WMShell(3X)


               Specifies the ID of a window with which this widget instance
               is associated.  By convention, this window is the "leader" of
               a group of windows.  A window manager may treat all windows in
               a group in some way; for example, it may always move or icon-
               ify them together.
               If no initial value is specified, the value is set to the win-
               dow of the first realized ancestor widget in the parent
               hierarchy when the widget is realized.  If a value of XXttUUnn--
               ssppeecciiffiieeddWWiinnddoowwGGrroouupp is specified, no window group is set.

     XXmmNNwwiinnGGrraavviittyy
               Specifies the window gravity for use by the window manager in
               positioning the widget.  If no initial value is specified, the
               value is set when the widget is realized.  If XXmmNNggeeoommeettrryy is
               not NULL, XXmmNNwwiinnGGrraavviittyy is set to the window gravity returned
               by XXWWMMGGeeoommeettrryy.  Otherwise, XXmmNNwwiinnGGrraavviittyy is set to NNoorrtthhWWeesstt--
               GGrraavviittyy.

     XXmmNNwwmmTTiimmeeoouutt
               Specifies the length of time that the Intrinsics waits for the
               window manager to respond to certain actions before assuming
               that there is no window manager present.  The value is in mil-
               liseconds and must not be negative.

     Inherited Resources

     WMShell inherits behavior and resources from the following superclasses.
     For a complete description of each resource, refer to the man page for
     that superclass.
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   XmNallowShellResize       XmCAllowShellResize       Boolean                  False            CG
   XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
   XmNgeometry               XmCGeometry               String                   NULL             CSG
   XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  False            CSG
   XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C
   XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
   XmNsaveUnder              XmCSaveUnder              Boolean                  False            CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
   XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
   XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
   XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG


   1-122






                                                                  WMShell(3X)


   XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderWidth                  XmCBorderWidth                  Dimension        1                      CSG
   XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
   XmNdepth                        XmCDepth                        int              dynamic                CG
   XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
   XmNheight                       XmCHeight                       Dimension        dynamic                CSG
   XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
   XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
   XmNscreen                       XmCScreen                       Screen *         dynamic                CG
   XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
   XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
   XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
   XmNx                            XmCPosition                     Position         0                      CSG
   XmNy                            XmCPosition                     Position         0                      CSG

     Translations

     There are no translations for WMShell.

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), and SShheellll((33XX)).



































   1-123



 c
