               7                     Compaq DECwindows Motif for OpenVMS C                     _______________________________________________   *                     Documentation Overview    -                     Order Number: AA-Q1E8B-TE                          April 2001  C                     This overview provides information about Compaq G                     DECwindows Motif for OpenVMS product documentation.               H                     Revision/Update Information:  This manual supersedesA                                                   the Overview of F                                                   DECwindows Motif forH                                                   OpenVMS Documentation.  G                     Operating System:             OpenVMS Alpha Version =                                                   6.2, 7.1-2, ?                                                   7.2-1, or 7.3 E                                                   OpenVMS VAX Version ;                                                   6.2, 7.1, =                                                   7.2, or 7.3 C                                                   VMS Version 5.5-2   I                     Software Version:             Compaq DECwindows Motif D                                                   for OpenVMS Alpha,?                                                   Version 1.2-6 C                                                   Compaq DECwindows H                                                   Motif for OpenVMS VAX,?                                                   Version 1.2-6         /                     Compaq Computer Corporation "                     Houston, Texas                 N               ________________________________________________________________               April 2001  0                2001 Compaq Computer Corporation  E               COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo =               Registered in U.S. Patent and Trademark Office.   H               Motif, OSF/1, UNIX, the "X" device, and The Open Group are+               trademarks of The Open Group.   A               All other product names mentioned herein may be the E               trademarks or registered trademarks of their respective                companies.  G               Confidential computer software. Valid license from Compaq H               or authorized sublicensor required for possession, use, orH               copying. Consistent with FAR 12.211 and 12.212, CommercialE               Computer Software, Computer Software Documentation, and E               Technical Data for Commercial Items are licensed to the I               U.S. Government under vendor's standard commercial license.   C               Compaq shall not be liable for technical or editorial F               errors or omissions contained herein. The information in@               this document is subject to change without notice.  F               The information in this publication is subject to changeE               without notice and is provided "AS IS" WITHOUT WARRANTY D               OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OFF               THIS INFORMATION REMAINS WITH THE RECIPIENT. IN NO EVENTC               SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, H               INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVERI               (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS A               PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS B               INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THED               POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLYC               REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHER F               PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS INF               CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGALE               LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL ,               PURPOSE OF ANY LIMITED REMEDY.  H               The limited warranties for Compaq products are exclusivelyH               set forth in the documentation accompanying such products.B               Nothing herein should be construed as constituting a-               further or additional warranty.   I                                                                    ZK5638   F               The Compaq OpenVMS documentation set is available on CD-               ROM.                                 F      _________________________________________________________________  F                                                               Contents      F      Preface...................................................      v  !      1  Documentation Description   F            1.1   Installation Documentation....................    1-1F            1.2   User Documentation............................    1-3F            1.3   New Desktop Documentation (Alpha Only)........    1-4F            1.4   Programming Documentation.....................    1-7F            1.4.1     Application Programming...................    1-9F            1.4.2     Xlib Programming..........................   1-151            1.4.3     Device Support and Transport F                      Programming...............................   1-19  -      2  Ordering and Availability Information   F            2.1   Installation Documentation....................    2-1F            2.2   User Documentation............................    2-2F            2.3   New Desktop Documentation (Alpha Only)........    2-3F            2.4   Programming Documentation.....................    2-4F            2.4.1     Ordering Third-Party Manuals..............    2-5F            2.4.2     Other Third-Party Manuals.................    2-7        Tables   2            1-1       DECwindows Motif InstallationF                      Documentation.............................    1-2  F            1-2       DECwindows Motif User Documentation.......    1-4  1            1-3       DECwindows Motif New Desktop F                      Documentation.............................    1-5  =            1-4       DECwindows Motif Application Programming F                      Documentation.............................   1-10  F                                                                    iii                   9               1-5       DECwindows Motif Xlib Programming I                         Documentation.............................   1-16   ;               1-6       DECwindows Motif Device Support and I                         Transport Programming Documentation.......   1-19   ;               2-1       Installation Documentation Ordering I                         Information...............................    2-2   I               2-2       User Kit Ordering Information.............    2-3   ?               2-3       New Desktop Ordering Information (Alpha I                         Only).....................................    2-4   I               2-4       Programming Kit Ordering Information......    2-5   <               2-5       Ordering Information for Third-PartyI                         Publishers................................    2-6                                                       
         iv                             I         _________________________________________________________________   I                                                                   Preface       =               This guide lists and describes the contents and F               organization of the Compaq DECwindows Motif for OpenVMS,F               Version 1.2-6 documentation set and provides informationB               about the availability of the product documentation.           Intended Audience   C               This overview is intended for DECwindows Motif users, /               programmers, and system managers.            Related Documents   G               For additional information on the OpenVMS System Software F               Group (OSSG) products and services, access the following-               OpenVMS World Wide Web address:   +               http://www.openvms.compaq.com            Reader's Comments   ;               Compaq welcomes your comments on this manual.   H               Please send comments to either of the following addresses:  /               Internet    openvmsdoc@compaq.com   5               Mail        Compaq Computer Corporation >                           OSSG Documentation Group, ZKO3-4/U08,                           110 Spit Brook Rd./                           Nashua, NH 03062-2698         I                                                                         v                    -         How To Order Additional Documentation   ?               Use the following World Wide Web address to order '               additional documentation:   1               http://www.openvms.compaq.com:8000/                                                                               
         vi                            Conventions   D               In this manual, every use of DECwindows and DECwindowsA               Motif refers to Compaq DECwindows Motif for OpenVMS                software.   B               In this manual, every use of OpenVMS Alpha means theF               OpenVMS Alpha operating system, every use of OpenVMS VAXF               means the OpenVMS VAX operating system, and every use ofG               OpenVMS means both the OpenVMS Alpha operating system and /               the OpenVMS VAX operating system.   C               The name of the OpenVMS AXP operating system has been E               changed to OpenVMS Alpha. Any references to OpenVMS AXP @               or AXP are synonymous with OpenVMS Alpha or Alpha.                                                            I                                                                       vii                          I                                                                         1 I         _________________________________________________________________   I                                                 Documentation Description     A               This chapter provides descriptions of the following                documentation:  =               o  Installation Documentation (see Section 1.1)   5               o  User Documentation (see Section 1.2)   I               o  New Desktop Documentation (Alpha Only) (see Section 1.3)   <               o  Programming Documentation (see Section 1.4)  D               This manual describes all the manuals that make up the@               extended DECwindows documentation set. This set isD               currently a combination of industry-standard referenceI               materials and DECwindows product documentation published by                Compaq.   E               Note that the manuals produced by Compaq are shipped as I               part of the DECwindows Motif documentation kit and subkits. I               However, the industry-standard reference materials are not.   H               For complete information about the availability of manuals3               not shipped by Compaq, see Chapter 2.   &         1.1 Installation Documentation  D               Installation documentation for Compaq DECwindows MotifC               for OpenVMS consists of an installation guide, CD-ROM I               guide, product cover letter, and release notes. The Getting E               Started With the New Desktop manual is also included in D               this category since it is shipped with the media kits.  G               Table 1-1 lists the installation documents and the latest B               product version for which each document was updated.    I                                             Documentation Description 1-1            !         Documentation Description &         1.1 Installation Documentation    I               Table_1-1_DECwindows_Motif_Installation_Documentation______   I               Title_and_Description__________________Software_Version____   E               Compaq DECwindows Motif for OpenVMS    DECwindows Motif B               Cover Letter                           Version 1.2-6,               Describes the kit and contains/               any late-breaking information not ,               included in the release notes.  E               Guide to Compaq DECwindows Motif for   DECwindows Motif B               OpenVMS CD-ROM                         Version 1.2-62               Describes the contents of the Compaq2               DECwindows Motif for OpenVMS CD-ROM.  E               Compaq DECwindows Motif for OpenVMS    DECwindows Motif B               Release Notes                          Version 1.2-63               Contains information not found in the 0               other manuals in the documentation0               set. This information includes new-               information, known problems and -               restrictions, and documentation 0               corrections. Although not required2               for installation, this manual should2               be reviewed before making DECwindows               Motif available.  E               Compaq DECwindows Motif for OpenVMS    DECwindows Motif B               Installation Guide                     Version 1.2-6*               Describes how to install the1               Compaq DECwindows Motif for OpenVMS                software.   I                                                  (continued on next page)                       %         1-2 Documentation Description            I                                                 Documentation Description I                                            1.1 Installation Documentation     =               Table 1-1 (Cont.) DECwindows Motif Installation I               __________________Documentation____________________________   I               Title_and_Description__________________Software_Version____   E               Getting Started With the New Desktop   DECwindows Motif E               This manual is designed for users      Version 1.2-4[1] -               of the New Desktop component of ,               DECwindows Motif (Alpha-only).)               It provides information for -               general users, system managers, *               and programmers. This manual3               describes the differences between the 0               DECwindows New Desktop environment1               and the Common Desktop Environment.   E               Compaq DECwindows Motif for OpenVMS    DECwindows Motif B               Documentation Overview                 Version 1.2-6,               This is the manual you are now               reading.I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Release   D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCII                format. I               ___________________________________________________________            1.2 User Documentation  I               The DECwindows Motif user documentation consists of manuals G               for the general user and manuals for the DECwindows Motif /               administrator or systems manager.   G               Table 1-2 lists the user documents and the latest product :               version for which each document was updated.                    I                                             Documentation Description 1-3            !         Documentation Description          1.2 User Documentation    I               Table_1-2_DECwindows_Motif_User_Documentation______________   I               Title_and_Description__________________Software_Version____   E               Using DECwindows Motif for OpenVMS     DECwindows Motif C               (Digital Press)                        Version 1.1[1] .               Provides information about using)               DECwindows Motif techniques ,               and features, customizing your2               environment, and advanced techniques.               such as using hyperapplications.  2               Although published by Digital Press,3               this manual is specific to DECwindows 0               and is shipped with the DECwindows"               Motif documentation.  E               DECwindows Motif for OpenVMS           DECwindows MotifoC               Applications Guide                     Version 1.2[1]_3               Describes how to start, use, and exit 1               from DECwindows Motif applications.   E               Managing DECwindows Motif for OpenVMS  DECwindows Motif G               Systems                                Version 1.2[1] [2] 3               Provides information about setting upa2               and maintaining the DECwindows Motif/               environment on both Alpha and VAX 1               systems. It describes customizationr0               options for a DECwindows clustered/               system or a standalone system, as /               well as system tuning informationt0               when certain customization options               are in effect.I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Release   D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCII                format. A               [2]Version 1.2 available in Bookreader format only. I               ___________________________________________________________o  2         1.3 New Desktop Documentation (Alpha Only)  H               This section provides information about the Common Desktop"               Environment manuals.  F               Table 1-3 lists the New Desktop documents and the latestB               product version for which each document was updated.  %         1-4 Documentation Description     n      I                                                 Documentation Description I                                1.3 New Desktop Documentation (Alpha Only)s    I               Table_1-3_DECwindows_Motif_New_Desktop_Documentation________  I               Title_and_Description__________________Software_Version____0  A               Common Desktop Environment: User's     DIGITAL UNIX C               Guide                                  Version 4.0[1]P1               Describes the basic features of the,2               Common Desktop Environment (CDE) and0               how to use the desktop and desktop               applications.c  A               Common Desktop Environment: Advanced   DIGITAL UNIXiC               User's and System Administrator's      Version 4.0[1]                Guidei2               Covers advanced tasks in customizing0               the appearance and behavior of the/               Common Desktop Environment (CDE).i  A               Common Desktop Environment:            DIGITAL UNIXSC               Programmer's Overview                  Version 4.0[1]a+               Provides a high-level view ofh,               the Common Desktop Environment-               development environment and the /               developer documentation set. Readt3               this book before starting applicatione%               design and development.   A               Common Desktop Environment:            DIGITAL UNIXhC               Programmer's Guide                     Version 4.0[1] (               Provides information about1               integrating an existing applicationR1               into the Common Desktop EnvironmentS3               or about developing a new application (               that uses the features and#               functionality of CDE.   I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Release   D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCIIN               format.P  I                                                  (continued on next page)R    I                                             Documentation Description 1-5F T         !         Documentation DescriptionH2         1.3 New Desktop Documentation (Alpha Only)    <               Table 1-3 (Cont.) DECwindows Motif New DesktopI               __________________Documentation____________________________P  I               Title_and_Description__________________Software_Version____   A               Common Desktop Environment: Help       DIGITAL UNIXnC               System Author's and Programmer's       Version 4.0[1]c               Guidei2               Describes how to develop online help,               for Common Desktop Environment-               application software. It covers /               how to create help topics and howl.               to integrate online help into an$               OSF/Motif application.  A               Common Desktop Environment: Style      DIGITAL UNIX C               Guide and Certification Checklist      Version 4.0[1]e)               Provides application design..               style guidelines and the list of-               requirements for Common Desktope+               Environment application-level +               certification. Common Desktop..               Environment requirements consist*               of the OSF/Motif Version 1.2.               requirements with Common Desktop-               Environment-specific additions.a  A               Common Desktop Environment:            DIGITAL UNIX C               Internationalization Programmer's      Version 4.0[1]v               Guidep&               Provides information for-               internationalizing the desktop, .               enabling applications to support,               various languages and cultural.               conventions in a consistent user               interface.  I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Release.  D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCII.               format.4  I                                                  (continued on next page)   %         1-6 Documentation Descriptionl i         I                                                 Documentation Description I                                1.3 New Desktop Documentation (Alpha Only)     <               Table 1-3 (Cont.) DECwindows Motif New DesktopI               __________________Documentation____________________________i  I               Title_and_Description__________________Software_Version____.  A               Common Desktop Environment: Glossary   DIGITAL UNIX C               Provides a comprehensive list of       Version 4.0[1] .               terms used in the Common Desktop-               Environment. It is a source and.2               reference base for all users of CDE.I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Releaser  D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCII.               format..I               ___________________________________________________________.  %         1.4 Programming Documentation   G               DECwindows Motif Version 1.2-6 is based on Release 5 (R5).I               of the MIT X11 Window System and incorporates Motif Version I               1.2, an industry-standard interface to the X Window System.IE               DECwindows Motif contains several layers of programming.               resources:  I               o  Xlib, the lowest-level interface to the X Window System, A                  provides routines for creating windows, managing_D                  windows, performing graphic functions, and handling                  input events.  D               o  The X Toolkit (also called the Intrinsics) providesD                  routines for combining existing widgets into a user8                  interface and for creating new widgets.  F               o  The OSF/Motif Toolkit provides routines for includingF                  Motif widgets within an application. The Motif WindowG                  Manager and the User Interface Language (UIL) compiler,'                  are integral to Motif.   F               o  Compaq extensions to Motif include additional widgets@                  and convenience routines to manipulate widgets.F                  Compaq also provides non-C bindings for all levels of'                  programming resources.     I                                             Documentation Description 1-7n i  a      !         Documentation Descriptionn%         1.4 Programming Documentation:    D               DECwindows Motif programming documentation covers eachI               layer of programming resources. Industry-standard referencenB               materials are discussed for Xlib, the X Toolkit, andG               OSF/Motif. Compaq documentation supplements the industry- H               standard documentation and provides additional information%               in the following areas:o  F               o  Reference information for DECwindows-specific widgets  *               o  Non-C binding information                                                                      %         1-8 Documentation Description            I                                                 Documentation Description I                                             1.4 Programming Documentation     E               o  Porting guidelines for moving applications from XUI- ?                  based DECwindows to UIL-based DECwindows MotifA  ?               o  Additional style guidelines for both Motif and ,                  DECwindows-specific widgets  B               o  Tutorial guides that supplement industry-standard?                  reference manuals and that describe how to useh0                  DECwindows added-value features  I               The DECwindows Motif programming documentation is organized G               into three categories, which are further described in thee!               following sections:l  (               o  Application programming  !               o  Xlib programming   9               o  Device support and transport programming   %         1.4.1 Application Programming   A               If you are an application programmer, you will need_A               information about the OSF/Motif Toolkit, the Compaq B               extensions to Motif, and the X Toolkit. You may alsoG               require information about non-C bindings and porting yourw-               applications from XUI to Motif.   G               Table 1-4 lists the application programming documents andeD               the latest product version for which each document was               updated.                            I                                             Documentation Description 1-9s n         !         Documentation Descriptione%         1.4 Programming Documentationu    @               Table 1-4 DECwindows Motif Application ProgrammingI               __________Documentation____________________________________d  I               Title_and_Description__________________Software_Version____   I               Industry-Standard_Material_________________________________w  >               OSF/Motif Style Guide (Prentice Hall)  OSF/Motif@               Describes the behavior and appearance  Release 1.2*               of user interface components,               that comply with the OSF/Motif.               specification. Use this guide if2               you are an applications developer, a0               widget developer, a user interface,               developer, or a window manager               developer.  >               OSF/Motif Programmer's Guide           OSF/Motif@               (Prentice Hall)                        Release 1.22               Describes how to write programs with/               the OSF/Motif Toolkit. The manual-&               covers three main areas:  !               o  Motif Widget Sets  %               o  Motif Window Manager   .               o  Motif User Interface Language1                  (UIL) and Motif Resource Manager                   (MRM)  -               Use this manual as your primary 0               source of tutorial information for1               programming with the Motif Toolkit.e  I                                                  (continued on next page)i                  &         1-10 Documentation Description o         I                                                 Documentation DescriptionnI                                             1.4 Programming Documentation     H               Table 1-4 (Cont.) DECwindows Motif Application ProgrammingI               __________________Documentation____________________________   I               Title_and_Description__________________Software_Version____   I               Industry-Standard_Material_________________________________w  >               OSF/Motif Programmer's Reference       OSF/Motif@               (Prentice Hall)                        Release 1.2.               Describes all OSF/Motif Toolkit,3               Motif Window Manager (MWM), and MotifT2               Resource Manager (MRM) routines. The1               routines are documented as standards-               manual pages with the following.               parts:  &               o  Syntax of the routine  ,               o  Description of the routine,3                  including the names and classes of 2                  all resources, the default values2                  of the resources, the data types,)                  and the method of access                  o  Examplese                 o  Return values                 o  Errors   $               o  Related information  -               Use this manual as your primarya1               source of reference information foro                the Motif Toolkit.  I                                                  (continued on next page)                 I                                            Documentation Description 1-11l -  C      !         Documentation Description %         1.4 Programming Documentationo    H               Table 1-4 (Cont.) DECwindows Motif Application ProgrammingI               __________________Documentation____________________________w  I               Title_and_Description__________________Software_Version____   I               Industry-Standard_Material_________________________________   >               X Window System Toolkit (Digital       X ToolkitB               Press)                                 X11 Release 4+               Documents the X Toolkit (more 0               commonly known as the Intrinsics).2               The X Toolkit enables programmers to3               create a user interface from existing 0               widgets and to create new widgets.  1               The manual contains two main parts.i-               The first part is a programming ,               guide to using the Intrinsics..               Each chapter in the guide covers,               a topic on two levels: one for0               application writers, the other for-               widget writers. The second parto-               of the manual is the complete X 3               Toolkit specification, which contains_-               reference information for all X 2               Toolkit routines. Appendixes contain-               information about the following                topics:   %               o  Resource file formatw  )               o  Translation table syntaxe  (               o  Compatibility functions  *               o  Intrinsics error messages  )               o  StringDefs.h header file   +               o  Parameter and return types   #               o  Naming conventionst                 o  X Registry   I                                                  (continued on next page)   &         1-12 Documentation Description o  e      I                                                 Documentation DescriptionfI                                             1.4 Programming DocumentationD    H               Table 1-4 (Cont.) DECwindows Motif Application ProgrammingI               __________________Documentation____________________________w  I               Title_and_Description__________________Software_Version____   I               Compaq_Documentation_______________________________________e  E               DECwindows Companion to the OSF/Motif  DECwindows Motif C               Style Guide                            Version 1.2[1]s3               Supplements material in the OSF/Motifu1               Style Guide and provides guidelines /               for using the DECwindows-specifice               widgets.  E               DECwindows Extensions to Motif         DECwindows MotifnC               Provides reference information about   Version 1.2[1]m-               DECwindows-specific widgets ando1               the UIL extensions to support these 0               widgets. The manual also describes-               additional convenience routines 1               provided by DECwindows. The routine -               descriptions are for C bindingsn.               and include the same information+               as provided for the OSF/Motifi.               routines. The UIL portion of the0               manual includes tables showing the2               complete DECwindows Motif widget set0               (OSF/Motif and DECwindows-specific               widgets).   I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Release   D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCII                format.L  I                                                  (continued on next page)b                I                                            Documentation Description 1-13u s  a      !         Documentation Description %         1.4 Programming Documentationi    H               Table 1-4 (Cont.) DECwindows Motif Application ProgrammingI               __________________Documentation____________________________   I               Title_and_Description__________________Software_Version____   I               Compaq_Documentation_______________________________________   E               DECwindows Motif Guide to Application  DECwindows Motif C               Programming                            Version 1.2[1] 1               Provides a tutorial for programmerse3               using the DECwindows-specific widgetsl2               and additional convenience routines.1               DECwindows-specific widgets includeu               the following:                 o  Color mix  %               o  Compound string text                  o  Help-                 o  Print  3               o  Structured visual navigation (SVN)u  /               The manual contains many examples .               of how to use Compaq proprietary               routines.   E               DECwindows Motif for OpenVMS Guide to  DECwindows MotiftC               Non-C Bindings                         Version 1.2[1] .               Describes non-C bindings for all*               DECwindows Motif programming.               libraries. The bindings for Xlib0               are standard OpenVMS bindings that0               support all OpenVMS languages. The3               bindings for the X Toolkit, the Motif 0               Toolkit, and the Compaq extensions.               to the Motif Toolkit are generic-               bindings that currently supportu!               Fortran and Pascal.   I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Released  D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCIIm               format.e  I                                                  (continued on next page)   &         1-14 Documentation Description           I                                                 Documentation DescriptionhI                                             1.4 Programming Documentation     H               Table 1-4 (Cont.) DECwindows Motif Application ProgrammingI               __________________Documentation____________________________d  I               Title_and_Description__________________Software_Version____n  I               Compaq_Documentation_______________________________________   E               Porting XUI Applications to Motif      DECwindows Motif C               Describes how to port applications     Version 1.0[1] -               developed for earlier XUI-based 0               DECwindows to the DECwindows Motif0               platform. The manual documents the3               porting tools and provides additional                guidelines.-I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Release_  D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCII                format.iI               ___________________________________________________________s           1.4.2 Xlib Programming  E               Xlib programming documentation consists of an industry- C               standard reference manual, and two Compaq programming(               guides.   @               Table 1-5 lists the Xlib programming documents andD               the latest product version for which each document was               updated.                              I                                            Documentation Description 1-15     i      !         Documentation Description %         1.4 Programming Documentationa    I               Table_1-5_DECwindows_Motif_Xlib_Programming_Documentation__t  I               Title_and_Description__________________Software_Version____   I               Industry-Standard_Material_________________________________   B               X Window System Third Edition          X EnvironmentB               (Digital Press)                        X11 Release 5)               Provides complete reference 0               information about Xlib. The manual&               describes the following:  ,               o  All Xlib Release 5 routines                 o  X Protocol   /               o  The Inter-Client Communication 2                  Conventions Manual (ICCCM), which0                  covers conventions that clients/                  should use to communicate with                   each other_  ,               o  X Logical Font Descriptions0                  (XLFD), which specifies server-1                  independent conventions for font %                  names and properties   -               o  Xlib routines and X protocol1,                  requests equivalence tables                 o  X font cursorsk                  o  Extensions to X  (               o  Compatibility functions                  o  Keysym encoding  "               o  Protocol encoding  0               o  X Consortium standard character                  set  1               o  Bitmap Distribution Format (BDF) 2                  Version 2.1, which specifies font                  file format  -               o  Glossary of standard X terms:  I                                                  (continued on next page)g  &         1-16 Documentation Description f  e      I                                                 Documentation Description I                                             1.4 Programming Documentationn    A               Table 1-5 (Cont.) DECwindows Motif Xlib Programming I               __________________Documentation____________________________   I               Title_and_Description__________________Software_Version____s  I               Industry-Standard_Material_________________________________.  B               X and Motif Quick Reference Guide      X EnvironmentB               (Digital Press)                        X11 Release 50               Contains C binding information for.               all Xlib, Intrinsic, and Toolkit0               routines. The manual also contains+               summaries of widget resources -               and data structures, as well as 0               information on X fonts and colors.  I               ___________________________________________________________ I               Compaq_Documentation_______________________________________   I                                                  (continued on next page)                                                   I                                            Documentation Description 1-17D i  w      !         Documentation Description %         1.4 Programming Documentation     A               Table 1-5 (Cont.) DECwindows Motif Xlib Programming I               __________________Documentation____________________________   I               Title_and_Description__________________Software_Version____i  I               Compaq_Documentation_______________________________________t  E               VMS DECwindows Guide to Xlib (Release  DECwindows Motif C               4) Programming: MIT C Binding and VMS  Version 1.0[1]12               DECwindows Guide to Xlib (Release 4)&               Programming: VAX Binding0               Two Compaq Xlib programming guides/               are provided: one for MIT C styleI3               bindings and one for OpenVMS bindings /               that support the standard OpenVMS -               languages. These books serve asy,               tutorials for Xlib programming/               and contain many sample programs.n-               Examples are in C for the MIT CD3               manual and in Fortran for the OpenVMS                binding.  ,               Each book covers the following               topics:e  +                  Managing the client-server                   connectionr%                  Working with windows 2                  Defining graphics characteristics                  Using color!                  Drawing graphicst)                  Using pixmaps and imagesc                  Writing text                    Handling events-                  Using the X Resource Manager                   Using grabs0                  Complying with the Inter-Client+                  Communications Conventions                    Compiling fonts  I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Releasec  D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCIIc               format. I               ___________________________________________________________   &         1-18 Documentation Description r         I                                                 Documentation Description0I                                             1.4 Programming Documentationm    6         1.4.3 Device Support and Transport Programming  E               This programming documentation includes a device driverm,               manual and a transport manual.  >               Table 1-6 lists the device support and transportF               programming documents and the latest product version for.               which each document was updated.  E               Table 1-6 DECwindows Motif Device Support and Transport I               __________Programming_Documentation________________________g  I               Title_and_Description__________________Software_Version____h  I               Compaq_Documentation_______________________________________   E               VMS DECwindows Device Driver Manual    DECwindows Motif C               Describes DECwindows device driver     Version 1.0[1] /               software for programmers who want 1               to write a DECwindows driver for anI2               input device. Topics covered include               the following:  )               o  DECwindows driver/server                   architecturec  .               o  DECwindows drivers and driver                  componentso  2               o  Driver routines, macros, and data                  structures   I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Releasew  D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCIIn               format.S  I                                                  (continued on next page)             I                                            Documentation Description 1-19t    c      !         Documentation Descriptione%         1.4 Programming Documentatione    C               Table 1-6 (Cont.) DECwindows Motif Device Support andwI               __________________Transport_Programming_Documentation_______  I               Title_and_Description__________________Software_Version_____  I               Compaq_Documentation_______________________________________   E               VMS DECwindows Transport Manual        DECwindows MotifrC               Describes the DECwindows transport     Version 1.0[1]v2               for those wanting to write their own1               transport. The manual describes thec               following topics:t  (               o  Theory of operation and2                  interconnection of each component2                  in the DECwindows transport layer  *               o  Transport-common routines  ,               o  Transport-specific routines  1               o  Transport-layer utility routines   !               o  Sample transportl  I               [1]Refer_to_the_Compaq_DECwindows_Motif_for_OpenVMS_Releasem  D               Notes for Version 1.2-6 information. The release notesG               are available on Bookreader and on the media kit in ASCIIt               format. I               ___________________________________________________________a                            &         1-20 Documentation Description T  U                    I                                                                         2pI         _________________________________________________________________t  I                                     Ordering and Availability Informationa    C               You can order the Compaq DECwindows Motif for OpenVMSsE               documentation in two ways. You can order the individualC@               subkits of selected manuals, or in some cases, the!               individual manuals.n  &         2.1 Installation Documentation  @               All DECwindows Motif installation documentation isF               currently published by Compaq. These manuals are shippedC               with the media kits and cannot be ordered separately.   ?               Most of the installation manuals are available in @               PostScript and ASCII format in the [DOCUMENTATION]H               directory on the DECwindows Motif CD-ROM. The installationG               guide, release notes, and getting started manual are also B               available in HTML format in the [DOCUMENTATION.HTML]@               directory on the DECwindows CD-ROM. For additionalE               information about the availability of DECwindows onlinenI               documentation, see the Guide to the Compaq DECwindows Motifi!               for OpenVMS CD-ROM.   B               Table 2-1 lists the titles and order numbers for theG               installation documentation in the Compaq DECwindows Motif F               for OpenVMS documentation set. These manuals (except forI               the release notes) are supplied in hardcopy format with the F               DECwindows Motif media kit and with the DECwindows MotifG               media upgrade kits. Note, however, that the upgrade mediaMG               kits do not include the book Getting Started With the NewX               Desktop.              I                                 Ordering and Availability Information 2-1o y  m      -         Ordering and Availability Informationa&         2.1 Installation Documentation    I               Table_2-1_Installation_Documentation_Ordering_Information__t  I               Kit_Manual_Title_________________________Order_Number______   B               Media Kit for OpenVMS Alpha              QA-MV4AB-H8  ;                   Compaq DECwindows Motif for OpenVMS  Nonel                   Cover Letter  B                   Guide to the Compaq DECwindows       AA-Q4BXE-RE*                   Motif for OpenVMS CD-ROM  ;                   Compaq DECwindows Motif for OpenVMS  Nonei                   Release Notes   B                   Compaq DECwindows Motif for OpenVMS  AA-Q1EAE-TE$                   Installation Guide  B                   Getting Started With the New         AA-QUW1A-TE                   Desktopa  B                   Compaq DECwindows Motif for OpenVMS  AA-Q1E8B-TE(                   Documentation Overview  B               Media Kit for OpenVMS VAX                QA-XA1AB-H8  ;                   Compaq DECwindows Motif for OpenVMS  None                    Cover Letter  B                   Guide to the Compaq DECwindows       AA-Q4BXE-RE*                   Motif for OpenVMS CD-ROM  ;                   Compaq DECwindows Motif for OpenVMS  None                    Release Notesi  B                   Compaq DECwindows Motif for OpenVMS  AA-Q1EAE-TE$                   Installation Guide  B                   Compaq DECwindows Motif for OpenVMS  AA-Q1E8B-TEI               ____Documentation_Overview_________________________________n           2.2 User Documentation  F               All the DECwindows Motif user documentation is currentlyC               available from Compaq. These manuals can no longer beeH               ordered individually. Instead, you must order the completeB               user kit. The manual part numbers are given here for               reference.  I               Most of these manuals are available in Bookreader format inoG               the [DOCUMENTATION.DECW$BOOK] directory on the DECwindowsvD               CD-ROM and can be read with Bookreader. For additionalE               information about the availability of DECwindows onlinen  1         2-2 Ordering and Availability Information            I                                     Ordering and Availability InformationeI                                                    2.2 User Documentation     I               documentation, see the Guide to the Compaq DECwindows Motif_!               for OpenVMS CD-ROM._  I               Table 2-2 lists the titles and order numbers for the Compaq_>               DECwindows Motif for OpenVMS user documentation.  I               Table_2-2_User_Kit_Ordering_Information____________________t  I               Kit_Manual_Title_________________________Order_Number______V  G               User Kit                                 QA-XA1AA-GZ.1.26   B                   Managing DECwindows Motif for        AA-Q1E9A-TE!                   OpenVMS Systems   B                   Using DECwindows Motif for OpenVMS   AA-Q2WXA-TE!                   (Digital Press)   B                   DECwindows Motif for OpenVMS         AA-PGZ6B-TEI               ____Applications_Guide_____________________________________u  2         2.3 New Desktop Documentation (Alpha Only)  F               All the new desktop documentation is currently publishedF               by Compaq. However, these manuals are not orderable as aG               kit. Only the first two manuals are orderable in hardcopy                format.o  F               All of these manuals are available in HTML format in theB               [DOCUMENTATION.HTML] directory on the DECwindows CD-D               ROM. For additional information about the availabilityF               of DECwindows online documentation, see the Guide to theI               Compaq DECwindows Motif for OpenVMS CD-ROM. For informationnH               about the Getting Started With the New Desktop manual, see               Section 2.1.  F               Table 2-3 lists the titles and order numbers for manuals+               that support the New Desktop.T              I                                 Ordering and Availability Information 2-3m           -         Ordering and Availability Information 2         2.3 New Desktop Documentation (Alpha Only)    I               Table_2-3_New_Desktop_Ordering_Information_(Alpha_Only)____   I               Manual_Title___________________________Order_Number________   @               Common Desktop Environment: User's     AA-QTLNA-TE               Guidet  @               Common Desktop Environment: Advanced   AA-QTLQA-TE/               User's and System Administrator's                Guideo  @               Common Desktop Environment:            AA-QTLWA-TE#               Programmer's Overview_  @               Common Desktop Environment:            AA-QTLXA-TE                Programmer's Guide  @               Common Desktop Environment: Help       AA-QTLYA-TE.               System Author's and Programmer's               GuideE  @               Common Desktop Environment:            AA-QTM2A-TE/               Internationalization Programmer's                Guidel  @               Common Desktop Environment: Style      AA-QTM3A-TE/               Guide and Certification Checklist   I               Common_Desktop_Environment:_Glossary___AA-QTM4A-TE_________e  %         2.4 Programming Documentation   <               Compaq does not publish all of the programmingH               documentation. Many of the manuals are published by third-B               party publishers. The Compaq-produced manuals can noE               longer be ordered individually. Instead, you must order G               the complete programming kit. The manual part numbers arem'               given here for reference.t  I               All manuals published by Compaq are available in Bookreader B               format in the [DOCUMENTATION.DECW$BOOK] directory onD               the DECwindows CD-ROM and can be read with Bookreader.B               For additional information about the availability ofC               DECwindows online documentation, see the Guide to the 9               Compaq DECwindows Motif for OpenVMS CD-ROM.   1         2-4 Ordering and Availability Information_ _  _      I                                     Ordering and Availability InformationnI                                             2.4 Programming Documentation     E               Table 2-4 lists the titles and ordering information forl3               DECwindows programming documentation.:  I               Table_2-4_Programming_Kit_Ordering_Information_____________o  I               Kit_Manual_Title_________________________Order_Number______e  G               Programming Kit (Compaq-produced)        QA-XA1AB-GZ.1.26n  B                   DECwindows Motif Guide to            AA-Q8YTA-TE)                   Application ProgrammingF  B                   DECwindows Extensions to Motif       AA-Q8YSA-TE  B                   DECwindows Companion to the          AA-Q8YUA-TE'                   OSF/Motif Style Guidei  B                   DECwindows Motif for OpenVMS Guide   AA-PGZ8B-TE#                   to Non-C Bindingsk  B                   VMS DECwindows Guide to Xlib         AA-PGZCA-TE0                   (Release 4) Programming: MIT C                   Bindingn  B                   VMS DECwindows Guide to Xlib         AA-PGZDA-TE.                   (Release 4) Programming: VAX                   Binding   B                   VMS DECwindows Device Driver Manual  AA-MG28B-TE  B                   VMS DECwindows Transport Manual      AA-PGZBA-TE  B                   Porting XUI Applications to Motif    AA-PGZFA-TE  !               Third-party manualse  I                   X Window System                      See Section 2.4.1.t  I                   X Window System Toolkit              See Section 2.4.1.o  I                   X and Motif Quick Reference Guide    See Section 2.4.1.   I                   OSF/Motif Style Guide                See Section 2.4.1.   I                   OSF/Motif Programmer's Reference     See Section 2.4.1.   I               ____OSF/Motif_Programmer's_Guide_________See_Section_2.4.1.   *         2.4.1 Ordering Third-Party Manuals  D               The Compaq DECwindows Motif documentation was designedA               to accompany the manuals described in this section. H               Formerly, Compaq shipped these manuals with the DECwindowsI               documentation set. To allow you to choose the specific type E               and quantity of manuals you want to purchase, Compaq nofG               longer includes the third-party manuals in the DECwindows_  I                                 Ordering and Availability Information 2-5_ _  _      -         Ordering and Availability Information %         2.4 Programming Documentation     E               documentation set. You must order these manuals through E               their respective companies or their authorized dealers.u  G               Digital Press is now a division of Butterworth Heinemann. H               For information about the Digital Press manuals, see their+               website at http://www.bh.com._  B               Prentice Hall is now a division of Pearson EducationG               Company. For information about the Prentice Hall manuals,_@               see the website for the Prentice Hall ProfessionalA               Technical Reference series at http://www.phptr.com.IB               Specific ordering information is given in Table 2-5.  I         Table_2-5_Ordering_Information_for_Third-Party_Publishers________w  I         ____Manual_Title__________Author_________Year________ISBN________t           Digital Press Manualso  I             X Window System X     Robert W.      January     1-55558-088- >             Third Edition         Scheifer       1992        2.             Version 11 Release 5  James Gettys  I             X Window System       Paul J.        1990        1-55558-051- >             Toolkit               Asenti                     3*             The Complete          Ralph R.'             Programmer's Guide    Swick              and Specification               X Version 11 Release             4[1]  I             X and Motif Quick     Randi Rost     October     1-55558-118-r>             Reference Guide                      1993        8             Second Edition           Prentice Hall Manuals   I             OSF/Motif Style       Open Software  September   0-13-643123-i>             Guide                 Foundation     1992        2             Release 1.2   I         [1]This_manual_is_out_of_print._A_manual_for_Release_5_through_7_            is available.   I                                                  (continued on next page)   1         2-6 Ordering and Availability Informationl e  t      I                                     Ordering and Availability Information I                                             2.4 Programming Documentation_    I         Table_2-5_(Cont.)_Ordering_Information_for_Third-Party_Publishers   I         ____Manual_Title__________Author_________Year________ISBN________   I             OSF/Motif             Open Software  August      0-13-643115- >             Programmer's          Foundation     1992        1             Referencec             Release 1.2i  I             OSF/Motif             Open Software  August      0-13-643107-l>             Programmer's Guide    Foundation     1992        0I         ____Release_1.2__________________________________________________a  '         2.4.2 Other Third-Party Manualsa  E               Other publishers have produced documentation sets about_D               the X Window system and Motif. Although the DECwindows@               documentation set was not specifically designed toH               incorporate these manuals, they nonetheless provide usefulG               information about X Windows and Motif. One popular set isiH               from O'Reilly and Associates. Titles in the series include               the following:  6               o  Volume 0: X Protocol Reference Manual  2               o  Volume 1: Xlib Programming Manual  0               o  Volume 2: Xlib Reference Manual  8               o  Volume 3M: X Window System User's Guide  C               o  Volume 4M: X Toolkit Intrinsics Programming Manual   @               o  Volume 5: X Toolkit Intrinsics Reference Manual  4               o  Volume 6A: Motif Programming Manual  ?               o  Volume 6B: Motif Reference Manual, 2nd Edition   @               o  Volume 8: X Window System Administrator's Guide  F               For more information about these manuals, visit the UNIXF               page of the O'Reilly website at http://unix.oreilly.com.H               Note that Volume 7A covers XView programming. XView is not?               supported by Compaq DECwindows Motif for OpenVMS.t  I                                 Ordering and Availability Information 2-7a