















        Chapter 1.  IInnttrroodduuccttiioonn








             This chapter introduces the user environment volume of
             the AES. Section 1.1 defines the AES.  Section 1.2 is
             the AES/UE service outline.  Section 1.3 is a table of
             AES support levels ordered by functional area.



        1.1  TThhee AApppplliiccaattiioonn EEnnvviirroonnmmeenntt SSppeecciiffiiccaattiioonn DDeeffiinniittiioonn



             This section provides a detailed description of the
             Application Environment Specification (AES).



        1.1.1  IInnttrroodduuccttiioonn ttoo tthhee AAEESS DDeeffiinniittiioonn



             Part of the charter of the Open Software Foundation
             (OSF) is to foster the development of portable software
             applications that will run on a wide variety of
             hardware platforms.  The software required to support
             such applications is an ``application environment''
             provided by systems or software vendors. An application
             environment is a set of programming and user interfaces
             and their associated semantics, available to
             applications and users.






        August 26, 1994                                          1-1







        Application Environment Specification - User Environment Volume


             The AES is a specification for a consistent application
             environment across different hardware platforms.  This
             definition uses the term ``implementation'' to describe
             the application environment that vendors supply to
             application developers, because such software is an
             implementation of the AES.

             The AES specifies the following:

                +o Application-level interfaces that an
                  implementation must provide in order to support
                  portable applications

                +o Semantics or protocols associated with each of
                  these interfaces

             This definition describes the purpose, contents, and
             organization of the AES. It also discusses the meaning
             of AES compliance for applications and implementations,
             the relationship of the AES to other industry documents
             (standards and specifications) and to implementations.
             Finally, the document describes the AES development
             process and the support levels used to characterize
             interfaces within the AES.



        1.1.2  PPuurrppoossee ooff tthhee AAEESS



             The primary purpose of the AES is to provide a common
             definition of application interfaces that both systems
             providers and systems users can rely on in the
             development of portable applications.  The composite
             AES defines the stable, reliable, application-level
             interfaces in several functional areas.  Systems
             sellers who comply with the AES know exactly what
             interfaces they must provide, and how each element of
             those interfaces must behave.  Systems buyers who look
             for AES conformance know unequivocally the interfaces
             they can rely on.

             A secondary purpose of the AES is to take advantage of
             OSF's organizational charter to expedite the
             specification of application environments.  Unlike
             specifications and standards bodies, OSF also provides
             vendor-neutral, hardware-independent implementations.
             The task of providing these implementations gives
             practical experience and feedback that enables the AES





        1-2                                          August 26, 1994







                                                        Introduction


             to expand faster than standards documents can. Also,
             OSF's technical staff is chartered to provide an
             expeditious resolution of the conflicts that can delay
             the decision process in other types of organizations.

             By integrating functionality that is already
             standardized with newer functionality that is suitable
             for eventual standardization, the AES provides material
             that contributes to future standards.  Because of OSF's
             timely, vendor-neutral decision process, this newer
             functionality can be added relatively quickly.



        1.1.3  CCoonntteennttss ooff tthhee AAEESS



             As previously stated, the AES is a set of
             specifications for programming and user interfaces and
             their associated semantics.  The library routines, user
             commands, and data objects specified in the AES have
             the following characteristics:

                +o They provide valuable services to portable
                  applications.

                +o They can be implemented on a wide variety of
                  hardware platforms and support hardware-
                  independent applications.

                +o They are stable (they are not likely to need to
                  change).

                +o They are reliable (because they are tightly
                  specified, applications writers can rely on
                  consistent behavior across applications
                  platforms).

             We call AES-specified program and user interfaces
             ``portability interfaces'' because they provide support
             for portable (hardware-independent) applications.

             In order to be useful for applications development
             within these criteria, the AES must provide the richest
             possible function set.  Development of the AES requires
             a balance between expansion to provide richer
             functionality, and conservatism to guarantee the
             stability of included interfaces.






        August 26, 1994                                          1-3







        Application Environment Specification - User Environment Volume


             Internal interfaces are interfaces that are not visible
             to applications.  Internal interfaces are not part of
             the AES.  The AES specifies only application-level
             portability interfaces (as previously defined).



        1.1.4  OOrrggaanniizzaattiioonn ooff tthhee AAEESS



             The AES is an evolving set of aarreeaa ssppeecciiffiiccaattiioonnss.
             Each area specification describes portability
             interfaces for one ffuunnccttiioonnaall aarreeaa of the application
             environment.  OSF has identified the following
             functional areas:

                +o Operating System Programming Interfaces

                +o Operating System Commands and Utilities

                +o Network Services

                +o User Environment Services

                +o Graphics Services

                +o Database Management Services

                +o Programming Languages (BASIC, Fortran, Pascal, C,
                  COBOL, Ada, and Lisp)

             In certain functional areas, OSF publishes its own area
             specifications, which add to or extend existing
             standards and specifications.  This definition focuses
             on the development process for the specifications that
             OSF publishes.  In other areas, the AES just points to
             widely known existing standards and specifications.

             The initial AES area specifications for OSF publication
             are in three functional areas.

                +o The _A_E_S/_O_p_e_r_a_t_i_n_g _S_y_s_t_e_m area specification
                  describes the programming interfaces that an AES-
                  conforming operating system must provide.

                +o The _A_E_S/_N_e_t_w_o_r_k _S_e_r_v_i_c_e_s area specification
                  describes protocol-independent and protocol-
                  specific interfaces to network services.






        1-4                                          August 26, 1994







                                                        Introduction


                +o The _A_E_S/_U_s_e_r _E_n_v_i_r_o_n_m_e_n_t area specification
                  describes the programming interfaces that an AES-
                  compliant user interface must provide.

             An area specification can consist of one or more
             volumes, and the term "AES Volume" describes the
             document that contains all or part of an area
             specification.

             OSF's goal is to promote usability and coherence of the
             AES documents themselves; therefore, document titles
             are as descriptive as possible.  Also, OSF uses
             revisions, rather than supplements, to add functions to
             existing AES volumes.

             Each revision of an AES Volume includes, for reference,
             the complete list of standards and specifications that
             make up the Application Environment.  (This list first
             appeared as "AES Level 0" in May, 1988.)  Because,
             unless otherwise stated, the standards and
             specifications that comprise the Application
             Environment are independent of one another, this list
             is provided only for user reference.  Any direct
             dependencies that an area AES has on specifications in
             another area are listed within the AES Volume for the
             first area.



        1.1.5  TThhee MMeeaanniinngg ooff AAEESS CCoonnffoorrmmaannccee



             This section provides a brief, general discussion of
             AES conformance for implementations and applications.
             This document does not discuss the specific means of
             measuring or proving conformance or such issues as
             validation, compliance, branding, and waivers.

             Implementations and applications that conform to the
             AES do so on the basis of area functionality. An
             implementation or application that conforms to one AES
             area is considered to be AES-conforming for that area.

             Implementations and applications conform to the AES
             differently, since implementations provide services and
             applications use interfaces specified in the AES to
             access these services.  A conforming implementation
             provides at least the interfaces defined in the AES.  A
             conforming application uses only the interfaces defined
             in the AES and those defined in any standards or




        August 26, 1994                                          1-5







        Application Environment Specification - User Environment Volume


             specifications that the AES depends on.  Such
             dependencies are called out explicitly in AES area
             specifications.



        1.1.5.1  AAEESS CCoonnffoorrmmaannccee ffoorr IImmpplleemmeennttaattiioonnss



             For an implementation to be AES conforming in a
             functional area, it must implement each interface
             element as specified by the AES volume for that
             functional area.

             AES area-conforming implementations may offer
             additional interfaces not specified in the AES, or
             extensions to AES interfaces, provided they do not
             affect the conformance of any element of the AES-
             specified interfaces.

             Unless specifically called out within the area
             specification, an implementation that conforms to one
             functional area need not provide services from other
             functional areas, or to conform to other functional
             areas.



        1.1.5.2  CCoonnffoorrmmaannccee DDooccuummeenntt



             Vendors of AES-conforming implementations should make
             available to their customers a conformance document
             that describes:

                +o The AES area and revision the implementation
                  conforms to

                +o The values of all implementation-defined variables
                  and limits that the implementation supports

                +o The actual behavior of all features described in
                  the AES as implementation defined

             If the implementation supports any nonstandard
             extensions that change the behavior of interfaces
             specified in the AES, the conformance document must
             specify how to create an environment that provides the
             AES-specified behavior. If conformance information




        1-6                                          August 26, 1994







                                                        Introduction


             exists in other documents provided with the
             implementation, the AES conformance document can
             provide a reference to that information rather than
             repeat it.



        1.1.5.3  AAEESS CCoonnffoorrmmaannccee ffoorr AApppplliiccaattiioonnss



             For an application to be AES conforming in a functional
             area, it must use only the interfaces in the relevant
             AES area specification or those in other standards and
             specifications the area specification depends on.
             Standards or specifications included by reference are
             considered to be part of the AES for conforming
             applications.

             The application must depend only on AES-specified
             behavior for AES interfaces.  An application should not
             depend on any behavior that the AES describes as
             unspecified, undefined, or implementation defined.



        1.1.5.4  AAEESS SSuuppppoorrtt LLeevveellss aanndd CCoonnffoorrmmaannccee



             Each AES interface element has a support level, which
             specifies the commitment OSF makes to its definition.
             The higher the support level, the longer the warning
             period required before OSF can delete the element, or
             make an incompatible change in the element's
             definition. (An incompatible change is one that might
             require conforming applications to be rewritten.)

             Conforming implementations will provide all AES
             interfaces for the relevant area at all support levels.
             Developers of conforming applications can choose to use
             or not use elements at any support level. Support
             levels serve as advisories for application developers
             because they indicate the length of time that an
             interface specification is guaranteed to remain stable.

             During the AES development process, OSF staff members
             propose support levels for interface elements, based on
             criteria defined later in this document.  OSF members
             review and comment on these support levels along with
             the rest of the document.




        August 26, 1994                                          1-7







        Application Environment Specification - User Environment Volume


             Section 1.1.9 provides detailed information about AES
             support levels.



        1.1.6  RReellaattiioonnsshhiipp ooff tthhee AAEESS ttoo SSttaannddaarrddss aanndd OOtthheerr
               SSppeecciiffiiccaattiioonnss



             The AES incorporates relevant industry standards and
             selected industry specifications.  When an AES area
             specification incorporates an industry standard or
             specification, the area specification either points to
             that standard or specification, or includes the text.
             (Document revision schedules, source availability, and
             document usability influence the decision to use
             pointers or text.)

             The AES may extend or further specify interface
             elements derived from an included standard or
             specification, and when such extensions occur, they are
             clearly marked as such within the appropriate AES
             Volume.

             An AES-conforming implementation of an interface should
             also conform to all included standards and
             specifications that contain the interface.  If this is
             not possible, because of conflicts between definitions
             in included standards, the AES resolves conflicts based
             on a defined precedence order of standards.  AES
             Volumes define, in an introductory chapter, the order
             of precedence of any included standards and
             specifications.

             Inclusion of whole standards and specifications in the
             AES sometimes results in inclusion of interfaces or
             interface elements that might not have been selected
             for inclusion on their own merit.  In such cases, OSF
             still includes the element because it is in the
             standard and the standard takes precedence.  However,
             the AES interface definition notes any problems and
             discourages applications' use of the problematic
             interface.  OSF also works within the standards or
             specification bodies to remove or modify such
             interfaces.









        1-8                                          August 26, 1994







                                                        Introduction


        1.1.7  RReellaattiioonnsshhiipp ooff tthhee AAEESS ttoo IImmpplleemmeennttaattiioonnss



             The AES is a specification to which vendors can build
             implementations.  OSF itself provides implementations
             for some of the AES functional areas.  These OSF
             implementations include the portability interfaces
             defined in the AES, and may also include interfaces not
             specified in the AES, or extensions to AES-specified
             interfaces. These extensions may be obsolete interfaces
             provided for support of existing applications, or they
             may be experimental, new interfaces.  Only those
             interfaces that are recommended for use by new portable
             applications will be included in the AES.  Some of the
             interfaces that are not in the AES may be candidates
             for inclusion in a subsequent AES revision.



        1.1.8  TThhee AAEESS DDeevveellooppmmeenntt PPrroocceessss



             This section describes the processes for development of
             the AES, for document revision control, and for
             membership review cycles.

             For each functional area, OSF produces one or more AES
             area specification drafts for its membership to review
             (see Section 1.1.8.3). After incorporating review
             comments, OSF produces a final AES area specification.
             A final AES area specification for a particular
             revision includes the interface definitions for a
             stable set of portability interfaces in one functional
             area of the OSF-supported Application Environment.



        1.1.8.1  DDooccuummeenntt CCoonnttrrooll aanndd tthhee AAEESS



             OSF labels the AES for each functional area with a
             revision letter.  As the collection of revisions grows,
             OSF may group the existing revisions into an AES Level.
             For example, an AES Level might include AES/UE Revision
             B, AES/OS Revision A, and so on.







        August 26, 1994                                          1-9







        Application Environment Specification - User Environment Volume


        1.1.8.2  TThhee SSeerrvviiccee OOuuttlliinnee



             A Service Outline is a document that lists all the
             elements in each AES interface for a functional area
             and indicates the support level for each element
             without giving detailed descriptions.  OSF makes two
             uses of Service Outlines.

                +o In some functional areas, a Service Outline may be
                  a draft document that precedes a full AES volume.
                  (A full AES volume provides complete interface
                  definitions or pointers to other information or
                  conceptual descriptions.)  A draft Service Outline
                  proposes the interfaces to be included in a full
                  AES volume.  In this case, the full AES volume
                  draft, when complete, supersedes the Service
                  Outline draft.

                +o In other functional areas, a Service Outline may
                  become a permanent document.  If all the
                  interfaces for a functional area are completely
                  specified, with no conflicts, in industry
                  standards or other specification documents, the
                  AES area specification for that functional area
                  may remain as a Service Outline and never evolve
                  into a full AES volume.

             When appropriate, a Service Outline also contains a
             table that shows each element and lists relevant
             industry standards, specifications, and implementations
             that include the element.

             Complete AES documents (not Service Outlines) provide
             complete interface definitions and pointers to other
             information or conceptual descriptions.



        1.1.8.3  TThhee MMeemmbbeerrsshhiipp RReevviieeww



             In general, membership review proceeds as follows:

               1.  OSF prepares a draft Service Outline and/or AES
                   Volume for a functional area, and circulates it
                   to OSF members.  This review period may last from
                   one to several months.





        1-10                                         August 26, 1994







                                                        Introduction


               2.  Members submit comments using a prescribed
                   comment template.

               3.  OSF responds to members' comments in the next
                   version of the document, or in a discussion that
                   takes place in an electronic news group or at a
                   meeting.

             OSF considers all review comments during the
             development of AES documents and brings important or
             controversial issues up for further discussion.
             However, the review process is not a voting process,
             and OSF does not wait for consensus among the
             membership before adding new interfaces to the AES or
             making other technical decisions.



        1.1.9  AAEESS SSuuppppoorrtt LLeevveellss



             This section defines the support levels assigned to
             each AES interface element.  As previously mentioned,
             support levels define OSF's commitment to interface
             definitions by indicating the warning period required
             to make an incompatible modification or deletion of the
             definition.

             New AES revisions may introduce upwardly compatible
             changes at any time, regardless of the support level.
             Any such changes will be noted in the associated
             SSppeecciiffiiccaattiioonn CCoonntteexxtt section.

             The support levels are:

                +o Full use

                +o Trial use

                +o Temporary use

             Typically, elements in the AES have full-use or trial-
             use support levels.  Conforming implementations must
             provide them, and application developers can use them
             freely (with the knowledge that trial-use elements are
             subject to more rapid change than full-use elements).
             The temporary-use support level appears only rarely in
             area specifications; it is for special cases, as
             described below.  Implementations must provide
             temporary-use elements too, when they appear.




        August 26, 1994                                         1-11







        Application Environment Specification - User Environment Volume


             The following sections explain each support level.
             Section 1.1.9.4 describes how elements move from
             proposed status (in draft specifications) to final
             status (in published specifications).



        1.1.9.1  FFuullll UUssee



             A full-use element has the highest support level, so it
             is the most protected from incompatible modification or
             deletion from the AES.

             OSF assigns a support level of full use to elements for
             reasons such as the following:

                +o The element already exists in an approved de-jure
                  standard.  (A de-jure standard is one that is set
                  by an official standards body.)

                +o The element as specified in the AES is considered
                  stable and already in widespread use in
                  applications.

                +o The element has been upgraded to full-use status
                  after a period of trial-use status in an earlier
                  AES revision.

             There should rarely be a need to remove a full-use
             element, or make incompatible modifications to it.
             However, if this ever becomes necessary, a full-use
             element keeps its full-use status, but a warning
             describing the proposed future change must be published
             in at least two successive revisions of the AES area
             volume before the change can be made.  This provides
             time for applications to be altered to deal with a
             different behavior, and for implementations to prepare
             for the change.

             For example, suppose it becomes necessary to modify a
             full-use element that appeared in Revision A of an AES
             Volume. The draft for Revision B shows the element as
             "proposed-for-modification/removal."  Assuming the
             review concludes that this change is appropriate, the
             element in Revision B still has full-use status, but is
             accompanied by a warning.  The warning states that the
             element is scheduled for modification after Revision C,
             and describes the modified behavior. Application
             developers can now allow for either the original or the




        1-12                                         August 26, 1994







                                                        Introduction


             modified behavior.  Revision C contains the same
             warning.  Revision D provides the modified definition
             only.  The SSppeecciiffiiccaattiioonn CCoonntteexxtt section of the
             interface element definition documents the history of
             such changes.



        1.1.9.2  TTrriiaall UUssee



             A trial-use element is easier to modify or delete than
             a full-use element.  There are several reasons that OSF
             classifies elements as trial use instead of full use.
             An element may be under consideration for inclusion in
             a de-jure standard and so may possibly change as a
             result of the standards process.  Or, OSF may perceive
             that the element is new compared to other included
             elements and, therefore, the implementation and use of
             the element may suggest revisions in its definition.

             If it becomes necessary to modify or delete a trial-use
             element, it keeps its trial-use status, with warnings
             about its removal or incompatible change, for one full
             revision of the AES.  In the example above, if the
             element to be modified were a trial-use element,
             Revision B would include the unmodified definition with
             a warning and description of the change, and Revision C
             would include the modified definition only.



        1.1.9.3  TTeemmppoorraarryy UUssee



             A temporary-use element is a special case. Because it
             is limited in use, not sufficiently general, or faulty
             in some other way, it is likely to be changed.  As
             such, it does not meet the criteria for inclusion in
             the AES with a full-use or trial-use support level, but
             it provides necessary functionality not available
             through other full-use or trial-use interface elements.
             Conforming applications may use these elements as
             necessary; an application containing a temporary-use
             element should be labeled as such.  The AES replaces
             temporary-use interface elements when appropriate full-
             or trial-use elements become available.






        August 26, 1994                                         1-13







        Application Environment Specification - User Environment Volume


             Giving an element temporary-use status makes it clear
             from the outset that OSF intends to replace it.  In the
             meantime, the element provides necessary and clearly
             specified functionality.  Compliant implementations
             must provide services classified as temporary use, and
             applications can use them, although it is clear that
             the element will eventually be replaced. Once a
             replacement exists, the AES includes a warning in the
             temporary-use element's definition and lists the
             removal date. As in the case of a trial-use element,
             the warning exists for one revision only.

             For example, certain network interfaces provide a
             general service using a protocol-specific algorithm.
             These might be candidates for temporary-use status,
             because as time passes, interfaces based on protocol-
             independent algorithms will become available to replace
             them.



        1.1.9.4  PPrrooppoosseedd UUssaaggee LLeevveellss



             Draft versions of specifications give newly added or
             changed elements a ``proposed-for-_l_e_v_e_l'' status, where
             _l_e_v_e_l is one of those defined previously.  In final
             versions, these elements move from ``proposed-for-
             _l_e_v_e_l'' status to level status.

             In the review draft of the first revision of an AES
             area specification, all elements are at ``proposed-
             for-_l_e_v_e_l'' status.  In review drafts of subsequent
             revisions, the elements may have one of several
             statuses.  Most existing elements retain their support
             level from the existing revision.  A few may carry a
             proposed-for-_c_h_a_n_g_e status (described below).  New
             elements carry a proposed-for-_l_e_v_e_l status.

             The following list defines more exactly the AES
             proposed-for-inclusion and proposed for-change levels.

             PPrrooppoosseedd--ffoorr--_l_e_v_e_l--uussee
                  A review level leading to _l_e_v_e_l-use inclusion on
                  acceptance, and no change in status otherwise.
                  This status may be used to propose a new element
                  for _l_e_v_e_l-use, or to move an existing element to a
                  higher status.






        1-14                                         August 26, 1994







                                                        Introduction


             PPrrooppoosseedd--ffoorr--mmooddiiffiiccaattiioonn//rreemmoovvaall
                  A review level for existing elements that OSF
                  proposes to make an incompatible modification in
                  or remove from the AES. If this proposal is
                  accepted during the review process, a full-use
                  element remains as is, with a warning, for two
                  revisions; a trial-use or temporary-use element
                  remains as is with a warning, for one revision.
                  If the proposal is rejected, the element remains
                  as is.

             PPrrooppoosseedd--ffoorr--ccoorrrreeccttiioonn
                  A review level for elements of any support level
                  in which OSF wishes to correct a specification
                  error. OSF will propose correcting an element if a
                  definition was obviously wrong (and
                  implementations and applications could never
                  follow the specification as it is written), if
                  clarification of an unclear section is required,
                  or if an error makes a definition clearly
                  internally inconsistent or inappropriate. Elements
                  proposed for correction return to their original
                  status, in corrected form, on acceptance of the
                  correction. They return to their original status
                  in uncorrected form on rejection of the
                  correction.  (Proposal for correction is not
                  required for OSF to fix a typographical error.)

             PPrrooppoosseedd--ffoorr--eennhhaanncceemmeenntt
                  A review level for elements in which OSF wants to
                  make an upwardly compatible change in definition.
                  If accepted, the definition change is effective in
                  the published revision after the draft in which
                  the proposal for enhancement occurred.



        1.2  SSeerrvviiccee OOuuttlliinnee



             This Service Outline lists all the services included in
             the AES/UE.

                +o The first column is the name of the service.  The
                  table is organized alphabetically by this column.
                  All services that are new in this revision are
                  marked by an asterisk (*).

                +o The second column is the type of the service.  The
                  type is widget, function, command, data type, or




        August 26, 1994                                         1-15







        Application Environment Specification - User Environment Volume


                  file format.

                +o The third column is the proposed AES support
                  level.

                        TTAABBLLEE 11--11..  Service Outline

             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             ApplicationShell                 widget         full-use
             Composite                        widget         full-use
             Constraint                       widget         full-use
             Core                             widget         full-use
             MrmCloseHierarchy                function       full-use
             MrmFetchColorLiteral             function       full-use
             MrmFetchIconLiteral              function       full-use
             MrmFetchLiteral                  function       full-use
             MrmFetchSetValues                function       full-use
             MrmFetchWidget                   function       full-use
             MrmFetchWidgetOverride           function       full-use
             MrmInitialize                    function       full-use
             MrmOpenHierarchy                 function       trial-use
             MrmOpenHierarchyPerDisplay*      function       trial-use
             MrmRegisterClass                 function       trial-use
             MrmRegisterNames                 function       trial-use
             MrmRegisterNamesInHierarchy      function       trial-use
             Object                           widget         full-use
             OverrideShell                    widget         full-use
             RectObj                          widget         full-use
             Shell                            widget         full-use
             TopLevelShell                    widget         full-use
             TransientShell                   widget         full-use
             Uil                              function       full-use
             VendorShell                      widget         full-use
             WMShell                          widget         full-use
             XmActivateProtocol               function       trial-use
             XmActivateWMProtocol             function       trial-use
             XmAddProtocolCallbacks           function       trial-use
             XmAddProtocols                   function       trial-use
             XmAddTabGroup                    function       full-use
             XmAddWMProtocolCallbacks         function       trial-use
             XmAddWMProtocols                 function       trial-use
             XmArrowButton                    widget         full-use
             XmArrowButtonGadget              widget         full-use
             XmBulletinBoard                  widget         full-use
             XmCascadeButton                  widget         full-use
             XmCascadeButtonGadget            widget         full-use
             XmCascadeButtonGadgetHighlight   function       trial-use
             XmCascadeButtonHighlight         function       full-use
             XmClipboardCancelCopy            function       full-use
             XmClipboardCopy                  function       full-use




        1-16                                         August 26, 1994







                                                        Introduction


             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             XmClipboardCopyByName            function       full-use
             XmClipboardEndCopy               function       full-use
             XmClipboardEndRetrieve           function       full-use
             XmClipboardInquireCount          function       full-use
             XmClipboardInquireFormat         function       full-use
             XmClipboardInquireLength         function       full-use
             XmClipboardInquirePendingItems   function       full-use
             XmClipboardLock                  function       full-use
             XmClipboardRegisterFormat        function       full-use
             XmClipboardRetrieve              function       full-use
             XmClipboardStartCopy             function       full-use
             XmClipboardStartRetrieve         function       full-use
             XmClipboardUndoCopy              function       full-use
             XmClipboardUnlock                function       full-use
             XmClipboardWithdrawFormat        function       full-use
             XmCommand                        widget         full-use
             XmCommandAppendValue             function       full-use
             XmCommandError                   function       full-use
             XmCommandGetChild                function       full-use
             XmCommandSetValue                function       full-use
             XmConvertUnits                   function       trial-use
             XmCreateArrowButton              function       full-use
             XmCreateArrowButtonGadget        function       full-use
             XmCreateBulletinBoard            function       full-use
             XmCreateBulletinBoardDialog      function       full-use
             XmCreateCascadeButton            function       full-use
             XmCreateCascadeButtonGadget      function       full-use
             XmCreateCommand                  function       full-use
             XmCreateDialogShell              function       full-use
             XmCreateDrawingArea              function       full-use
             XmCreateDrawnButton              function       full-use
             XmCreateErrorDialog              function       full-use
             XmCreateFileSelectionBox         function       full-use
             XmCreateFileSelectionDialog      function       full-use
             XmCreateForm                     function       full-use
             XmCreateFormDialog               function       full-use
             XmCreateFrame                    function       full-use
             XmCreateInformationDialog        function       full-use
             XmCreateLabel                    function       full-use
             XmCreateLabelGadget              function       full-use
             XmCreateList                     function       full-use
             XmCreateMainWindow               function       full-use
             XmCreateMenuBar                  function       full-use
             XmCreateMenuShell                function       full-use
             XmCreateMessageBox               function       full-use
             XmCreateMessageDialog            function       full-use
             XmCreateOptionMenu               function       full-use
             XmCreatePanedWindow              function       full-use
             XmCreatePopupMenu                function       full-use




        August 26, 1994                                         1-17







        Application Environment Specification - User Environment Volume


             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             XmCreatePromptDialog             function       full-use
             XmCreatePulldownMenu             function       full-use
             XmCreatePushButton               function       full-use
             XmCreatePushButtonGadget         function       full-use
             XmCreateQuestionDialog           function       full-use
             XmCreateRadioBox                 function       full-use
             XmCreateRowColumn                function       full-use
             XmCreateScale                    function       full-use
             XmCreateScrollBar                function       full-use
             XmCreateScrolledList             function       full-use
             XmCreateScrolledText             function       full-use
             XmCreateScrolledWindow           function       full-use
             XmCreateSelectionBox             function       full-use
             XmCreateSelectionDialog          function       full-use
             XmCreateSeparator                function       full-use
             XmCreateSeparatorGadget          function       full-use
             XmCreateText                     function       full-use
             XmCreateTextField*               function       trial-use
             XmCreateToggleButton             function       full-use
             XmCreateToggleButtonGadget       function       full-use
             XmCreateWarningDialog            function       full-use
             XmCreateWorkArea                 function       trial-use
             XmCreateWorkingDialog            function       full-use
             XmCvtCTToXmString                function       trial-use
             XmCvtXmStringToCT                function       trial-use
             XmDeactivateProtocol             function       trial-use
             XmDeactivateWMProtocol           function       trial-use
             XmDestroyPixmap                  function       full-use
             XmDialogShell                    widget         full-use
             XmDrawingArea                    widget         full-use
             XmDrawnButton                    widget         full-use
             XmFileSelectionBox               widget         full-use
             XmFileSelectionBoxGetChild       function       full-use
             XmFileSelectionDoSearch          function       full-use
             XmFontList                       data type      full-use
             XmFontListAdd                    function       trial-use
             XmFontListAppendEntry*           function       trial-use
             XmFontListCopy*                  function       trial-use
             XmFontListCreate                 function       trial-use
             XmFontListEntryCreate*           function       trial-use
             XmFontListEntryFree*             function       trial-use
             XmFontListEntryGetFont*          function       trial-use
             XmFontListEntryGetTag*           function       trial-use
             XmFontListEntryLoad*             function       trial-use
             XmFontListFree                   function       full-use
             XmFontListFreeFontContext*       function       trial-use
             XmFontListInitFontContext*       function       trial-use
             XmFontListNextEntry*             function       trial-use
             XmFontListRemoveEntry*           function       trial-use




        1-18                                         August 26, 1994







                                                        Introduction


             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             XmForm                           widget         full-use
             XmFrame                          widget         full-use
             XmGadget                         widget         full-use
             XmGetAtomName                    function       full-use
             XmGetColors                      function       trial-use
             XmGetMenuCursor                  function       full-use
             XmGetPixmap                      function       full-use
             XmGetPostedFromWidget            function       trial-use
             XmInstallImage                   function       full-use
             XmInternAtom                     function       full-use
             XmIsMotifWMRunning               function       full-use
             XmLabel                          widget         full-use
             XmLabelGadget                    widget         full-use
             XmList                           widget         full-use
             XmListAddItem                    function       full-use
             XmListAddItems                   function       full-use
             XmListAddItemUnselected          function       full-use
             XmListDeleteAllItems             function       full-use
             XmListDeleteItem                 function       full-use
             XmListDeleteItems                function       full-use
             XmListDeleteItemsPos             function       full-use
             XmListDeletePos                  function       full-use
             XmListDeselectAllItems           function       full-use
             XmListDeselectItem               function       full-use
             XmListDeselectPos                function       full-use
             XmListGetMatchPos                function       full-use
             XmListGetSelectedPos             function       full-use
             XmListItemExists                 function       full-use
             XmListItemPos                    function       trial-use
             XmListReplaceItems               function       full-use
             XmListReplaceItemsPos            function       full-use
             XmListSelectItem                 function       full-use
             XmListSelectPos                  function       full-use
             XmListSetAddMode                 function       trial-use
             XmListSetBottomItem              function       full-use
             XmListSetBottomPos               function       full-use
             XmListSetHorizPos                function       full-use
             XmListSetItem                    function       full-use
             XmListSetPos                     function       full-use
             XmMainWindow                     widget         full-use
             XmMainWindowSep1                 function       full-use
             XmMainWindowSep2                 function       full-use
             XmMainWindowSep3                 function       full-use
             XmMainWindowSetAreas             function       full-use
             XmManager                        widget         full-use
             XmMenuPosition                   function       full-use
             XmMenuShell                      widget         full-use
             XmMessageBox                     widget         full-use
             XmMessageBoxGetChild             function       full-use




        August 26, 1994                                         1-19







        Application Environment Specification - User Environment Volume


             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             XmOptionButtonWidget             function       full-use
             XmOptionLabelWidget              function       full-use
             XmPanedWindow                    widget         full-use
             XmPrimitive                      widget         full-use
             XmProcessTraversal               function       full-use
             XmPushButton                     widget         full-use
             XmPushButtonGadget               widget         full-use
             XmRemoveProtocolCallbacks        function       trial-use
             XmRemoveProtocols                function       trial-use
             XmRemoveTabGroup                 function       full-use
             XmRemoveWMProtocolCallbacks      function       trial-use
             XmRemoveWMProtocols              function       trial-use
             XmResolvePartOffsets             function       full-use
             XmRowColumn                      widget         full-use
             XmScale                          widget         full-use
             XmScaleGetValue                  function       full-use
             XmScaleSetValue                  function       full-use
             XmScrollBar                      widget         full-use
             XmScrollBarGetValues             function       full-use
             XmScrollBarSetValues             function       full-use
             XmScrolledWindow                 widget         full-use
             XmScrolledWindowSetAreas         function       full-use
             XmSelectionBox                   widget         full-use
             XmSelectionBoxGetChild           function       full-use
             XmSeparator                      widget         full-use
             XmSeparatorGadget                widget         full-use
             XmSetMenuCursor                  function       full-use
             XmSetProtocolHooks               function       trial-use
             XmSetWMProtocolHooks             function       trial-use
             XmString                         data type      full-use
             XmStringBaseline                 function       trial-use
             XmStringByteCompare              function       trial-use
             XmStringCompare                  function       trial-use
             XmStringConcat                   function       trial-use
             XmStringCopy                     function       trial-use
             XmStringCreate*                  function       trial-use
             XmStringCreateLocalized*         function       temporary-use
             XmStringCreateSimple             function       trial-use
             XmStringDirection                data type      full-use
             XmStringDraw                     function       trial-use
             XmStringDrawImage                function       trial-use
             XmStringDrawUnderline            function       trial-use
             XmStringEmpty                    function       trial-use
             XmStringExtent                   function       trial-use
             XmStringFree                     function       trial-use
             XmStringFreeContext              function       trial-use
             XmStringGetNextSegment           function       trial-use
             XmStringHasSubstring             function       trial-use
             XmStringHeight                   function       trial-use




        1-20                                         August 26, 1994







                                                        Introduction


             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             XmStringInitContext              function       trial-use
             XmStringLength                   function       trial-use
             XmStringLineCount                function       trial-use
             XmStringNConcat                  function       trial-use
             XmStringNCopy                    function       trial-use
             XmStringSegmentCreate            function       trial-use
             XmStringSeparatorCreate          function       trial-use
             XmStringTable                    data type      full-use
             XmStringWidth                    function       trial-use
             XmText                           widget         full-use
             XmTextClearSelection             function       full-use
             XmTextCopy                       function       full-use
             XmTextCut                        function       full-use
             XmTextField*                     widget         trial-use
             XmTextFieldClearSelection*       function       trial-use
             XmTextFieldCopy*                 function       trial-use
             XmTextFieldCut*                  function       trial-use
             XmTextFieldGetBasename*          function       trial-use
             XmTextFieldGetEditable*          function       trial-use
             XmTextFieldGetInsertPosition*    function       trial-use
             XmTextFieldGetLastPosition*      function       trial-use
             XmTextFieldGetMaxLength*         function       trial-use
             XmTextFieldGetSelection*         function       trial-use
             XmTextFieldGetSelectionPosition* function       trial-use
             XmTextFieldGetString*            function       trial-use
             XmTextFieldInsert*               function       trial-use
             XmTextFieldPaste*                function       trial-use
             XmTextFieldPosToXY*              function       trial-use
             XmTextFieldRemove*               function       trial-use
             XmTextFieldReplace*              function       trial-use
             XmTextFieldSetAddMode*           function       trial-use
             XmTextFieldSetEditable*          function       trial-use
             XmTextFieldSetHighlight*         function       trial-use
             XmTextFieldSetInsertionPosition* function       trial-use
             XmTextFieldSetMaxLength*         function       trial-use
             XmTextFieldSetSelection*         function       trial-use
             XmTextFieldSetString*            function       trial-use
             XmTextFieldShowPosition*         function       trial-use
             XmTextFieldXYToPos*              function       trial-use
             XmTextGetBaseline                function       full-use
             XmTextGetEditable                function       full-use
             XmTextGetInsertionPosition       function       full-use
             XmTextGetLastPosition            function       full-use
             XmTextGetMaxLength               function       full-use
             XmTextGetSelection               function       full-use
             XmTextGetSelectionPosition       function       full-use
             XmTextGetSource                  function       trial-use
             XmTextGetString                  function       full-use
             XmTextGetTopCharacter            function       full-use




        August 26, 1994                                         1-21







        Application Environment Specification - User Environment Volume


             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             XmTextInsert                     function       full-use
             XmTextPaste                      function       full-use
             XmTextPosToXY                    function       full-use
             XmTextPosition                   data type      full-use
             XmTextRemove                     function       full-use
             XmTextReplace                    function       full-use
             XmTextScroll                     function       full-use
             XmTextSetAddMode                 function       trial-use
             XmTextSetEditable                function       full-use
             XmTextSetHighlight               function       full-use
             XmTextSetInsertionPosition       function       full-use
             XmTextSetMaxLength               function       full-use
             XmTextSetSelection               function       full-use
             XmTextSetSource                  function       trial-use
             XmTextSetString                  function       full-use
             XmTextSetTopCharacter            function       full-use
             XmTextShowPosition               function       full-use
             XmTextXYToPos                    function       full-use
             XmToggleButton                   widget         full-use
             XmToggleButtonGadget             widget         full-use
             XmToggleButtonGadgetGetState     function       full-use
             XmToggleButtonGadgetSetState     function       full-use
             XmToggleButtonGetState           function       full-use
             XmToggleButtonSetState           function       full-use
             XmTrackingLocate                 function       trial-use
             XmUninstallImage                 function       full-use
             XmUpdateDisplay                  function       full-use
             mwm                              command        full-use

























        1-22                                         August 26, 1994







                                                        Introduction


        1.3  OOvveerrvviieeww ooff SSeerrvviicceess bbyy TTyyppee aanndd FFuunnccttiioonn



             All the services are broken into four types in the
             tables below.

                +o Window manager

                +o Widgets and widget functions

                +o Toolkit functions

                +o User interface language

             Within each table components are organized by function.



        1.3.1  WWiinnddooww mmaannaaggeerr



                    TTAABBLLEE 11--22..  Window Manager Services

             SSeerrvviiccee NNaammee   SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _______________________________________________
             mwm            command        full-use



























        August 26, 1994                                         1-23







        Application Environment Specification - User Environment Volume


        1.3.2  WWiiddggeettss aanndd WWiiddggeett FFuunnccttiioonnss



             This table organizes widgets by hierarchy. Position in
             the hierarchy is shown by the indentation of the
             service name.  The functions for each widget
             immediately follow the widget.

                        TTAABBLLEE 11--33..  Widget Services

             SSeerrvviiccee NNaammee                                      SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             __________________________________________________________________________________
             CCoorree                                              widget         full-use
               OObbjjeecctt                                          widget         full-use
                 RReeccttOObbjj                                       widget         full-use
                     XXmmPPrriimmiittiivvee                               widget         full-use
                       XXmmAArrrroowwBBuuttttoonn                           widget         full-use
                         XmCreateArrowButton                   function       full-use
                       XXmmLLaabbeell                                 widget         full-use
                         XmCreateLabel                         function       full-use
                         XXmmCCaassccaaddeeBBuuttttoonn                       widget         full-use
                           XmCreateCascadeButton               function       full-use
                           XmCascadeButtonHighlight            function       full-use
                         XXmmDDrraawwnnBBuuttttoonn                         widget         full-use
                           XmCreateDrawnButton                 function       full-use
                         XXmmPPuusshhBBuuttttoonn                          widget         full-use
                           XmCreatePushButton                  function       full-use
                         XXmmTToogggglleeBBuuttttoonn                        widget         full-use
                           XmCreateToggleButton                function       full-use
                           XmToggleButtonGetState              function       full-use
                           XmToggleButtonSetState              function       full-use
                       XXmmLLiisstt                                  widget         full-use
                         XmCreateList                          function       full-use
                         XmListAddItem                         function       full-use
                         XmListAddItems                        function       full-use
                         XmListAddItemUnselected               function       full-use
                         XmListDeleteAllItems                  function       full-use
                         XmListDeleteItem                      function       full-use
                         XmListDeleteItems                     function       full-use
                         XmListDeleteItemsPos                  function       full-use
                         XmListDeletePos                       function       full-use
                         XmListDeselectAllItems                function       full-use
                         XmListDeselectItem                    function       full-use
                         XmListDeselectPos                     function       full-use
                         XmListGetMatchPos                     function       full-use
                         XmListGetSelectedPos                  function       full-use
                         XmListItemExists                      function       full-use
                         XmListItemPos                         function       trial-use
                         XmListReplaceItems                    function       full-use
                         XmListReplaceItemsPos                 function       full-use




        1-24                                         August 26, 1994







                                                        Introduction


             SSeerrvviiccee NNaammee                                      SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             __________________________________________________________________________________
                         XmListSelectItem                      function       full-use
                         XmListSelectPos                       function       full-use
                         XmListSetAddMode                      function       trial-use
                         XmListSetBottomItem                   function       full-use
                         XmListSetBottomPos                    function       full-use
                         XmListSetHorizPos                     function       full-use
                         XmListSetItem                         function       full-use
                         XmListSetPos                          function       full-use
                       XXmmSSccrroollllBBaarr                             widget         full-use
                         XmCreateScrollBar                     function       full-use
                         XmScrollBarGetValues                  function       full-use
                         XmScrollBarSetValues                  function       full-use
                       XXmmSSeeppaarraattoorr                             widget         full-use
                         XmCreateSeparator                     function       full-use
                       XXmmTTeexxtt                                  widget         full-use
                         XmCreateText                          function       full-use
                         XmTextClearSelection                  function       full-use
                         XmTextCopy                            function       full-use
                         XmTextCut                             function       full-use
                       XXmmTTeexxttFFiieelldd*                            widget         trial-use
                         XmCreateTextField*                    function       trial-use
                         XmTextFieldClearSelection*            function       trial-use
                         XmTextFieldCopy*                      function       trial-use
                         XmTextFieldCut*                       function       trial-use
                         XmTextFieldGetBasename*               function       trial-use
                         XmTextFieldGetEditable*               function       trial-use
                         XmTextFieldGetInsertPosition*         function       trial-use
                         XmTextFieldGetLastPosition*           function       trial-use
                         XmTextFieldGetMaxLength*              function       trial-use
                         XmTextFieldGetSelection*              function       trial-use
                         XmTextFieldGetSelectionPosition*      function       trial-use
                         XmTextFieldGetString*                 function       trial-use
                         XmTextFieldInsert*                    function       trial-use
                         XmTextFieldPaste*                     function       trial-use
                         XmTextFieldPosToXY*                   function       trial-use
                         XmTextFieldRemove*                    function       trial-use
                         XmTextFieldReplace*                   function       trial-use
                         XmTextFieldSetAddMode*                function       trial-use
                         XmTextFieldSetEditable*               function       trial-use
                         XmTextFieldSetHighlight*              function       trial-use
                         XmTextFieldSetInsertionPosition*      function       trial-use
                         XmTextFieldSetMaxLength*              function       trial-use
                         XmTextFieldSetSelection*              function       trial-use
                         XmTextFieldSetString*                 function       trial-use
                         XmTextFieldShowPosition*              function       trial-use
                         XmTextFieldXYToPos*                   function       trial-use
                         XmTextGetBaseline                     function       full-use
                         XmTextGetEditable                     function       full-use
                         XmTextGetInsertionPosition            function       full-use




        August 26, 1994                                         1-25







        Application Environment Specification - User Environment Volume


             SSeerrvviiccee NNaammee                                      SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             __________________________________________________________________________________
                         XmTextGetLastPosition                 function       full-use
                         XmTextGetMaxLength                    function       full-use
                         XmTextGetSelection                    function       full-use
                         XmTextGetSelectionPosition            function       full-use
                         XmTextGetSource                       function       trial-use
                         XmTextGetString                       function       full-use
                         XmTextGetTopCharacter                 function       full-use
                         XmTextInsert                          function       full-use
                         XmTextPaste                           function       full-use
                         XmTextPosToXY                         function       full-use
                         XmTextRemove                          function       full-use
                         XmTextReplace                         function       full-use
                         XmTextScroll                          function       full-use
                         XmTextSetAddMode                      function       trial-use
                         XmTextSetEditable                     function       full-use
                         XmTextSetHighlight                    function       full-use
                         XmTextSetInsertionPosition            function       full-use
                         XmTextSetMaxLength                    function       full-use
                         XmTextSetSelection                    function       full-use
                         XmTextSetSource                       function       trial-use
                         XmTextSetString                       function       full-use
                         XmTextSetTopCharacter                 function       full-use
                         XmTextShowPosition                    function       full-use
                         XmTextXYToPos                         function       full-use
                     CCoommppoossiittee                                 widget         full-use
                       SShheellll                                   widget         full-use
                         OOvveerrrriiddeeSShheellll                         widget         full-use
                           XXmmMMeennuuSShheellll                         widget         full-use
                             XmCreateMenuShell                 function       full-use
                         WWMMSShheellll                               widget         full-use
                           VVeennddoorrSShheellll                         widget         full-use
                             XmGetAtomName                     function       full-use
                             XmInternAtom                      function       full-use
                             TTooppLLeevveellSShheellll                     widget         full-use
                               AApppplliiccaattiioonnSShheellll                widget         full-use
                             TTrraannssiieennttSShheellll                    widget         full-use
                               XXmmDDiiaallooggSShheellll                   widget         full-usE
                                 XmCreateDialogShell           function       full-use
                       CCoonnssttrraaiinntt                              widget         full-use
                         XXmmMMaannaaggeerr                             widget         full-use
                           XXmmBBuulllleettiinnBBooaarrdd                     widget         full-use
                             XmCreateBulletinBoard             function       full-use
                             XmCreateBulletinBoardDialog       function       full-use
                             XXmmFFoorrmm                            widget         full-use
                               XmCreateForm                    function       full-use
                               XmCreateFormDialog              function       full-use
                             XXmmMMeessssaaggeeBBooxx                      widget         full-use
                               XmCreateMessageBox              function       full-use
                               XmCreateErrorDialog             function       full-use




        1-26                                         August 26, 1994







                                                        Introduction


             SSeerrvviiccee NNaammee                                      SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             __________________________________________________________________________________
                               XmCreateInformationDialog       function       full-use
                               XmCreateMessageDialog           function       full-use
                               XmCreateQuestionDialog          function       full-use
                               XmCreateWarningDialog           function       full-use
                               XmCreateWorkingDialog           function       full-use
                               XmMessageBoxGetChild            function       full-use
                             XXmmSSeelleeccttiioonnBBooxx                    widget         full-use
                               XmCreateSelectionBox            function       full-use
                               XmCreatePromptDialog            function       full-use
                               XmCreateSelectionDialog         function       full-use
                               XmSelectionBoxGetChild          function       full-use
                               XXmmCCoommmmaanndd                       widget         full-use
                                 XmCreateCommand               function       full-use
                                 XmCommandAppendValue          function       full-use
                                 XmCommandError                function       full-use
                                 XmCommandGetChild             function       full-use
                                 XmCommandSetValue             function       full-use
                               XXmmFFiilleeSSeelleeccttiioonnBBooxx              widget         full-use
                                 XmCreateFileSelectionBox      function       full-use
                                 XmCreateFileSelectionDialog   function       full-use
                                 XmFileSelectionBoxGetChild    function       full-use
                                 XmFileSelectionDoSearch       function       full-use
                           XXmmDDrraawwiinnggAArreeaa                       widget         full-use
                             XmCreateDrawingArea               function       full-use
                           XXmmFFrraammee                             widget         full-use
                             XmCreateFrame                     function       full-use
                           XXmmPPaanneeddWWiinnddooww                       widget         full-use
                             XmCreatePanedWindow               function       full-use
                           XXmmRRoowwCCoolluummnn                         widget         full-use
                             XmCreateRowColumn                 function       full-use
                             XmCreateMenuBar                   function       full-use
                             XmCreateOptionMenu                function       full-use
                             XmCreatePopupMenu                 function       full-use
                             XmCreatePulldownMenu              function       full-use
                             XmCreateRadioBox                  function       full-use
                             XmCreateWorkArea                  function       trial-use
                             XmGetMenuCursor                   function       full-use
                             XmGetPostedFromWidget             function       trial-use
                             XmMenuPosition                    function       full-use
                             XmOptionButtonWidget              function       full-use
                             XmOptionLabelWidget               function       full-use
                             XmSetMenuCursor                   function       full-use
                           XXmmSSccaallee                             widget         full-use
                             XmCreateScale                     function       full-use
                             XmScaleGetValue                   function       full-use
                             XmScaleSetValue                   function       full-use
                           XXmmSSccrroolllleeddWWiinnddooww                    widget         full-use
                             XmCreateScrolledWindow            function       full-use
                             XmCreateScrolledList              function       full-use




        August 26, 1994                                         1-27







        Application Environment Specification - User Environment Volume


             SSeerrvviiccee NNaammee                                      SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             __________________________________________________________________________________
                             XmCreateScrolledText              function       full-use
                             XmScrolledWindowSetAreas          function       full-use
                             XXmmMMaaiinnWWiinnddooww                      widget         full-use
                               XmCreateMainWindow              function       full-use
                               XmMainWindowSep1                function       full-use
                               XmMainWindowSep2                function       full-use
                               XmMainWindowSep3                function       full-use
                               XmMainWindowSetAreas            function       full-use
                   XXmmGGaaddggeett                                    widget         full-use
                     XXmmAArrrroowwBBuuttttoonnGGaaddggeett                       widget         full-use
                       XmCreateArrowButtonGadget               function       full-use
                     XXmmLLaabbeellGGaaddggeett                             widget         full-use
                       XmCreateLabelGadget                     function       full-use
                       XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett                   widget         full-use
                         XmCascadeButtonGadgetHighlight        function       trial-use
                         XmCreateCascadeButtonGadget           function       full-use
                       XXmmPPuusshhBBuuttttoonnGGaaddggeett                      widget         full-use
                         XmCreatePushButtonGadget              function       full-use
                       XXmmTToogggglleeBBuuttttoonnGGaaddggeett                    widget         full-use
                         XmCreateToggleButtonGadget            function       full-use
                         XmToggleButtonGadgetGetState          function       full-use
                         XmToggleButtonGadgetSetState          function       full-use
                     XXmmSSeeppaarraattoorrGGaaddggeett                         widget         full-use
                       XmCreateSeparatorGadget                 function       full-use





























        1-28                                         August 26, 1994







                                                        Introduction


        1.3.3  TToooollkkiitt FFuunnccttiioonnss aanndd DDaattaa TTyyppeess



                        TTAABBLLEE 11--44..  Toolkit Services

             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             XmActivateProtocol               function       trial-use
             XmActivateWMProtocol             function       trial-use
             XmAddProtocolCallbacks           function       trial-use
             XmAddProtocols                   function       trial-use
             XmAddTabGroup                    function       full-use
             XmAddWMProtocolCallbacks         function       trial-use
             XmAddWMProtocols                 function       trial-use
             XmClipboardCancelCopy            function       full-use
             XmClipboardCopy                  function       full-use
             XmClipboardCopyByName            function       full-use
             XmClipboardEndCopy               function       full-use
             XmClipboardEndRetrieve           function       full-use
             XmClipboardInquireCount          function       full-use
             XmClipboardInquireFormat         function       full-use
             XmClipboardInquireLength         function       full-use
             XmClipboardInquirePendingItems   function       full-use
             XmClipboardLock                  function       full-use
             XmClipboardRegisterFormat        function       full-use
             XmClipboardRetrieve              function       full-use
             XmClipboardStartCopy             function       full-use
             XmClipboardStartRetrieve         function       full-use
             XmClipboardUndoCopy              function       full-use
             XmClipboardUnlock                function       full-use
             XmClipboardWithdrawFormat        function       full-use
             XmConvertUnits                   function       trial-use
             XmCvtCTToXmString                function       trial-use
             XmCvtXmStringToCT                function       trial-use
             XmDeactivateProtocol             function       trial-use
             XmDeactivateWMProtocol           function       trial-use
             XmDestroyPixmap                  function       full-use
             XmFontList                       data type      full-use
             XmFontListAdd                    function       trial-use
             XmFontListAppendEntry*           function       trial-use
             XmFontListCopy*                  function       trial-use
             XmFontListCreate                 function       trial-use
             XmFontListEntryCreate*           function       trial-use
             XmFontListEntryFree*             function       trial-use
             XmFontListEntryGetFont*          function       trial-use
             XmFontListEntryGetTag*           function       trial-use
             XmFontListEntryLoad*             function       trial-use
             XmFontListFree                   function       full-use
             XmFontListFreeFontContext*       function       trial-use
             XmFontListInitFontContext*       function       trial-use




        August 26, 1994                                         1-29







        Application Environment Specification - User Environment Volume


             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________
             XmFontListNextEntry*             function       trial-use
             XmFontListRemoveEntry*           function       trial-use
             XmGetColors                      function       trial-use
             XmGetPixmap                      function       full-use
             XmInstallImage                   function       full-use
             XmIsMotifWMRunning               function       full-use
             XmProcessTraversal               function       full-use
             XmRemoveProtocolCallbacks        function       trial-use
             XmRemoveProtocols                function       trial-use
             XmRemoveTabGroup                 function       full-use
             XmRemoveWMProtocolCallbacks      function       trial-use
             XmRemoveWMProtocols              function       trial-use
             XmResolvePartOffsets             function       full-use
             XmSetProtocolHooks               function       trial-use
             XmSetWMProtocolHooks             function       trial-use
             XmString                         data type      full-use
             XmStringBaseline                 function       trial-use
             XmStringByteCompare              function       trial-use
             XmStringCompare                  function       trial-use
             XmStringConcat                   function       trial-use
             XmStringCopy                     function       trial-use
             XmStringCreate*                  function       trial-use
             XmStringCreateLocalized*         function       temporary-use
             XmStringCreateSimple             function       trial-use
             XmStringDirection                data type      full-use
             XmStringDraw                     function       trial-use
             XmStringDrawImage                function       trial-use
             XmStringDrawUnderline            function       trial-use
             XmStringEmpty                    function       trial-use
             XmStringExtent                   function       trial-use
             XmStringFree                     function       trial-use
             XmStringFreeContext              function       trial-use
             XmStringGetNextSegment           function       trial-use
             XmStringHasSubstring             function       trial-use
             XmStringHeight                   function       trial-use
             XmStringInitContext              function       trial-use
             XmStringLength                   function       trial-use
             XmStringLineCount                function       trial-use
             XmStringNConcat                  function       trial-use
             XmStringNCopy                    function       trial-use
             XmStringSegmentCreate            function       trial-use
             XmStringSeparatorCreate          function       trial-use
             XmStringTable                    data type      full-use
             XmStringWidth                    function       trial-use
             XmTextPosition                   data type      full-use
             XmTrackingLocate                 function       trial-use
             XmUninstallImage                 function       full-use
             XmUpdateDisplay                  function       full-use





        1-30                                         August 26, 1994







                                                        Introduction


             SSeerrvviiccee NNaammee                     SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             _________________________________________________________________


        1.3.4  UUsseerr IInntteerrffaaccee LLaanngguuaaggee



                TTAABBLLEE 11--55..  User Interface Language Services

             SSeerrvviiccee NNaammee                  SSeerrvviiccee TTyyppee   AAEESS LLeevveell
             ______________________________________________________________
             MrmCloseHierarchy             function       full-use
             MrmFetchColorLiteral          function       full-use
             MrmFetchIconLiteral           function       full-use
             MrmFetchLiteral               function       full-use
             MrmFetchSetValues             function       full-use
             MrmFetchWidget                function       full-use
             MrmFetchWidgetOverride        function       full-use
             MrmInitialize                 function       full-use
             MrmOpenHierarchy              function       trial-use
             MrmOpenHierarchyPerDisplay*   function       trial-use
             MrmRegisterClass              function       trial-use
             MrmRegisterNames              function       trial-use
             MrmRegisterNamesInHierarchy   function       trial-use
             Uil                           function       full-use





























        August 26, 1994                                         1-31





 
