Order Number: AA--Q1E8A--TE

This overview provides information about Compaq DECwindows Motif for OpenVMS product documentation.

Revision/Update Information: This manual supersedes the Overview of DECwindows Motif for OpenVMS Documentation.

Operating System: OpenVMS Alpha Version 6.2, 7.1--2,
7.2--1, or 7.3
OpenVMS VAX Version 6.2, 7.1,
7.2, or 7.3
VMS Version 5.5--2

Software Version: Compaq DECwindows Motif for OpenVMS Alpha, Version 1.2--6
Compaq DECwindows Motif for OpenVMS VAX, Version 1.2--6

Compaq Computer Corporation Houston, Texas

© 2001 Compaq Computer Corporation

COMPAQ, VAX, VMS, the Compaq logo, and the DIGITAL logo Registered in U.S. Patent and Trademark Office.

Motif, OSF/1, UNIX, the "X" device, and The Open Group are trademarks of The Open Group.

All other product names mentioned herein may be the trademarks or registered trademarks of their respective companies.

Confidential computer software. Valid license from Compaq or authorized sublicensor required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice.

The information in this publication is subject to change without notice and is provided "AS IS" WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK ARISING OUT OF THE USE OF THIS INFORMATION REMAINS WITH THE RECIPIENT. IN NO EVENT SHALL COMPAQ BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL, INCIDENTAL, SPECIAL, PUNITIVE, OR OTHER DAMAGES WHATSOEVER (INCLUDING WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, OR LOSS OF BUSINESS INFORMATION), EVEN IF COMPAQ HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING SHALL APPLY REGARDLESS OF THE NEGLIGENCE OR OTHER FAULT OF EITHER PARTY AND REGARDLESS OF WHETHER SUCH LIABILITY SOUNDS IN CONTRACT, NEGLIGENCE, TORT, OR ANY OTHER THEORY OF LEGAL LIABILITY, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY.

The limited warranties for Compaq products are exclusively set forth in the documentation accompanying such products. Nothing herein should be construed as constituting a further or additional warranty.

ZK5638

The Compaq OpenVMS documentation set is available on CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2n.

Contents

This guide lists and describes the contents and organization of the Compaq DECwindows Motif for OpenVMS, Version 1.2--6 documentation set and provides information about the availability of the product documentation.

Intended Audience

This overview is intended for DECwindows Motif users, programmers, and system managers.

Related Documents

For additional information on the OpenVMS System Software 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.

Please send comments to either of the following addresses:

Internet	openvmsdoc@compaq.com
Mail	Compaq Computer Corporation OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following World Wide Web address to order additional documentation:

http://www.openvms.compaq.com:8000/

Conventions

In this manual, every use of DECwindows and DECwindows Motif refers to Compaq DECwindows Motif for OpenVMS software.

In this manual, every use of OpenVMS Alpha means the OpenVMS Alpha operating system, every use of OpenVMS VAX means the OpenVMS VAX operating system, and every use of OpenVMS means both the OpenVMS Alpha operating system and the OpenVMS VAX operating system.

The name of the OpenVMS AXP operating system has been changed to OpenVMS Alpha. Any references to OpenVMS AXP or AXP are synonymous with OpenVMS Alpha or Alpha.

This chapter provides descriptions of the following documentation:

• Installation Documentation
• User Documentation
• New Desktop Documentation (Alpha Only)
• Programming Documentation

This manual describes all the manuals that make up the extended DECwindows documentation set. This set is currently a combination of industry-standard reference materials and DECwindows product documentation published by Compaq.

Note that the manuals produced by Compaq are shipped as part of the DECwindows Motif documentation kit and subkits. However, the industry-standard reference materials are not.

For complete information about the availability of manuals not shipped by Compaq, see Chapter 2.

1.1 Installation Documentation

Installation documentation for Compaq DECwindows Motif for OpenVMS consists of an installation guide, CD-ROM guide, product cover letter, and release notes. The Getting Started With the New Desktop manual is also included in this category since it is shipped with the media kits.

Table 1-1 lists the installation documents and the latest product version for which each document was updated.

Table 1-1 DECwindows Motif Installation Documentation

Title and Description	Software Version
Compaq DECwindows Motif for OpenVMS Cover Letter Describes the kit and contains any late-breaking information not included in the release notes.	DECwindows Motif Version 1.2--6
Guide to Compaq DECwindows Motif for OpenVMS CD-ROM Describes the contents of the Compaq DECwindows Motif for OpenVMS CD-ROM.	DECwindows Motif Version 1.2--6
Compaq DECwindows Motif for OpenVMS Release Notes Contains information not found in the other manuals in the documentation set. This information includes new information, known problems and restrictions, and documentation corrections. Although not required for installation, this manual should be reviewed before making DECwindows Motif available.	DECwindows Motif Version 1.2--6
Compaq DECwindows Motif for OpenVMS Installation Guide Describes how to install the Compaq DECwindows Motif for OpenVMS software.	DECwindows Motif Version 1.2--6
Getting Started With the New Desktop This manual is designed for users of the New Desktop component of DECwindows Motif (Alpha-only). It provides information for general users, system managers, and programmers. This manual describes the differences between the DECwindows New Desktop environment and the Common Desktop Environment.	DECwindows Motif Version 1.2--4 1
Compaq DECwindows Motif for OpenVMS Documentation Overview This is the manual you are now reading.	DECwindows Motif Version 1.2--6

The DECwindows Motif user documentation consists of manuals for the general user and manuals for the DECwindows Motif administrator or systems manager.

Table 1-2 lists the user documents and the latest product version for which each document was updated.

Table 1-2 DECwindows Motif User Documentation

Title and Description	Software Version
Using DECwindows Motif for OpenVMS (Digital Press) Provides information about using DECwindows Motif techniques and features, customizing your environment, and advanced techniques such as using hyperapplications. Although published by Digital Press, this manual is specific to DECwindows and is shipped with the DECwindows Motif documentation.	DECwindows Motif Version 1.1 1
DECwindows Motif for OpenVMS Applications Guide Describes how to start, use, and exit from DECwindows Motif applications.	DECwindows Motif Version 1.2 1
Managing DECwindows Motif for OpenVMS Systems Provides information about setting up and maintaining the DECwindows Motif environment on both Alpha and VAX systems. It describes customization options for a DECwindows clustered system or a standalone system, as well as system tuning information when certain customization options are in effect.	DECwindows Motif Version 1.2 1 2

This section provides information about the Common Desktop Environment manuals.

Table 1-3 lists the New Desktop documents and the latest product version for which each document was updated.

Table 1-3 DECwindows Motif New Desktop Documentation

Title and Description	Software Version
Common Desktop Environment: User's Guide Describes the basic features of the Common Desktop Environment (CDE) and how to use the desktop and desktop applications.	DIGITAL UNIX Version 4.0 1
Common Desktop Environment: Advanced User's and System Administrator's Guide Covers advanced tasks in customizing the appearance and behavior of the Common Desktop Environment (CDE).	DIGITAL UNIX Version 4.0 1
Common Desktop Environment: Programmer's Overview Provides a high-level view of the Common Desktop Environment development environment and the developer documentation set. Read this book before starting application design and development.	DIGITAL UNIX Version 4.0 1
Common Desktop Environment: Programmer's Guide Provides information about integrating an existing application into the Common Desktop Environment or about developing a new application that uses the features and functionality of CDE.	DIGITAL UNIX Version 4.0 1
Common Desktop Environment: Help System Author's and Programmer's Guide Describes how to develop online help for Common Desktop Environment application software. It covers how to create help topics and how to integrate online help into an OSF/Motif application.	DIGITAL UNIX Version 4.0 1
Common Desktop Environment: Style Guide and Certification Checklist Provides application design style guidelines and the list of requirements for Common Desktop Environment application-level certification. Common Desktop Environment requirements consist of the OSF/Motif Version 1.2 requirements with Common Desktop Environment-specific additions.	DIGITAL UNIX Version 4.0 1
Common Desktop Environment: Internationalization Programmer's Guide Provides information for internationalizing the desktop, enabling applications to support various languages and cultural conventions in a consistent user interface.	DIGITAL UNIX Version 4.0 1
Common Desktop Environment: Glossary Provides a comprehensive list of terms used in the Common Desktop Environment. It is a source and reference base for all users of CDE.	DIGITAL UNIX Version 4.0 1

DECwindows Motif Version 1.2--6 is based on Release 5 (R5) of the MIT X11 Window System and incorporates Motif Version 1.2, an industry-standard interface to the X Window System. DECwindows Motif contains several layers of programming resources:

• Xlib, the lowest-level interface to the X Window System, provides routines for creating windows, managing windows, performing graphic functions, and handling input events.
• The X Toolkit (also called the Intrinsics) provides routines for combining existing widgets into a user interface and for creating new widgets.
• The OSF/Motif Toolkit provides routines for including Motif widgets within an application. The Motif Window Manager and the User Interface Language (UIL) compiler are integral to Motif.
• Compaq extensions to Motif include additional widgets and convenience routines to manipulate widgets. Compaq also provides non-C bindings for all levels of programming resources.

DECwindows Motif programming documentation covers each layer of programming resources. Industry-standard reference materials are discussed for Xlib, the X Toolkit, and OSF/Motif. Compaq documentation supplements the industry-standard documentation and provides additional information in the following areas:

• Reference information for DECwindows-specific widgets
• Non-C binding information

• Porting guidelines for moving applications from XUI-based DECwindows to UIL-based DECwindows Motif
• Additional style guidelines for both Motif and DECwindows-specific widgets
• Tutorial guides that supplement industry-standard reference manuals and that describe how to use DECwindows added-value features

The DECwindows Motif programming documentation is organized into three categories, which are further described in the following sections:

• Application programming
• Xlib programming
• Device support and transport programming

If you are an application programmer, you will need information about the OSF/Motif Toolkit, the Compaq extensions to Motif, and the X Toolkit. You may also require information about non-C bindings and porting your applications from XUI to Motif.

Table 1-4 lists the application programming documents and the latest product version for which each document was updated.

Table 1-4 DECwindows Motif Application Programming Documentation

Title and Description	Software Version
Industry-Standard Material
OSF/Motif Style Guide (Prentice Hall) Describes the behavior and appearance of user interface components that comply with the OSF/Motif specification. Use this guide if you are an applications developer, a widget developer, a user interface developer, or a window manager developer.	OSF/Motif Release 1.2
OSF/Motif Programmer's Guide (Prentice Hall) Describes how to write programs with the OSF/Motif Toolkit. The manual covers three main areas: Motif Widget Set Motif Window Manager Motif User Interface Language (UIL) and Motif Resource Manager (MRM) Use this manual as your primary source of tutorial information for programming with the Motif Toolkit.	OSF/Motif Release 1.2
OSF/Motif Programmer's Reference (Prentice Hall) Describes all OSF/Motif Toolkit, Motif Window Manager (MWM), and Motif Resource Manager (MRM) routines. The routines are documented as standard manual pages with the following parts: Syntax of the routine Description of the routine, including the names and classes of all resources, the default values of the resources, the data types, and the method of access Examples Return values Errors Related information Use this manual as your primary source of reference information for the Motif Toolkit.	OSF/Motif Release 1.2
X Window System Toolkit (Digital Press) Documents the X Toolkit (more commonly known as the Intrinsics). The X Toolkit enables programmers to create a user interface from existing widgets and to create new widgets. The manual contains two main parts. The first part is a programming guide to using the Intrinsics. Each chapter in the guide covers a topic on two levels: one for application writers, the other for widget writers. The second part of the manual is the complete X Toolkit specification, which contains reference information for all X Toolkit routines. Appendixes contain information about the following topics: Resource file format Translation table syntax Compatibility functions Intrinsics error messages StringDefs.h header file Parameter and return types Naming conventions X Registry	X Toolkit X11 Release 4
Compaq Documentation
DECwindows Companion to the OSF/Motif Style Guide Supplements material in the OSF/Motif Style Guide and provides guidelines for using the DECwindows-specific widgets.	DECwindows Motif Version 1.2 1
DECwindows Extensions to Motif Provides reference information about DECwindows-specific widgets and the UIL extensions to support these widgets. The manual also describes additional convenience routines provided by DECwindows. The routine descriptions are for C bindings and include the same information as provided for the OSF/Motif routines. The UIL portion of the manual includes tables showing the complete DECwindows Motif widget set (OSF/Motif and DECwindows-specific widgets).	DECwindows Motif Version 1.2 1
DECwindows Motif Guide to Application Programming Provides a tutorial for programmers using the DECwindows-specific widgets and additional convenience routines. DECwindows-specific widgets include the following: Color mix Compound string text Help Print Structured visual navigation (SVN) The manual contains many examples of how to use Compaq proprietary routines.	DECwindows Motif Version 1.2 1
DECwindows Motif for OpenVMS Guide to Non-C Bindings Describes non-C bindings for all DECwindows Motif programming libraries. The bindings for Xlib are standard OpenVMS bindings that support all OpenVMS languages. The bindings for the X Toolkit, the Motif Toolkit, and the Compaq extensions to the Motif Toolkit are generic bindings that currently support Fortran and Pascal.	DECwindows Motif Version 1.2 1
Porting XUI Applications to Motif Describes how to port applications developed for earlier XUI-based DECwindows to the DECwindows Motif platform. The manual documents the porting tools and provides additional guidelines.	DECwindows Motif Version 1.0 1

Xlib programming documentation consists of an industry-standard reference manual, and two Compaq programming guides.

Table 1-5 lists the Xlib programming documents and the latest product version for which each document was updated.

Table 1-5 DECwindows Motif Xlib Programming Documentation

Title and Description	Software Version
Industry-Standard Material
X Window System Third Edition (Digital Press) Provides complete reference information about Xlib. The manual describes the following: All Xlib Release 5 routines X Protocol The Inter-Client Communication Conventions Manual (ICCCM), which covers conventions that clients should use to communicate with each other X Logical Font Descriptions (XLFD), which specifies server-independent conventions for font names and properties Xlib routines and X protocol requests equivalence tables X font cursors Extensions to X Compatibility functions Keysym encoding Protocol encoding X Consortium standard character set Bitmap Distribution Format (BDF) Version 2.1, which specifies font file format Glossary of standard X terms	X Environment X11 Release 5
X and Motif Quick Reference Guide (Digital Press) Contains C binding information for all Xlib, Intrinsic, and Toolkit routines. The manual also contains summaries of widget resources and data structures, as well as information on X fonts and colors.	X Environment X11 Release 5
Compaq Documentation
VMS DECwindows Guide to Xlib (Release 4) Programming: MIT C Binding and VMS DECwindows Guide to Xlib (Release 4) Programming: VAX Binding Two Compaq Xlib programming guides are provided: one for MIT C style bindings and one for OpenVMS bindings that support the standard OpenVMS languages. These books serve as tutorials for Xlib programming and contain many sample programs. Examples are in C for the MIT C manual and in Fortran for the OpenVMS binding. Each book covers the following topics: Managing the client-server connection Working with windows Defining graphics characteristics Using color Drawing graphics Using pixmaps and images Writing text Handling events Using the X Resource Manager Using grabs Complying with the Inter-Client Communications Conventions Compiling fonts	DECwindows Motif Version 1.0 1