[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

HP DECwindows Motif for OpenVMS Alpha

HP DECwindows Motif for
OpenVMS Alpha

Documentation Overview

Order Number: AA--RT25B--TE

October 2003

This overview provides information about HP DECwindows Motif for OpenVMS Alpha Version 1.3--1 documentation.

Revision/Update Information: This manual supersedes the HP DECwindows Motif for HP OpenVMS Documentation Overview for Version 1.3

Operating System: HP OpenVMS Alpha Version 7.3--2

Software Version: HP DECwindows Motif for OpenVMS Alpha Version 1.3--1

Hewlett-Packard Company
Palo Alto, California

Motif, OSF/1, UNIX, and the "X" device are registered trademarks and The Open Group is a trademark of The Open Group in the U.S. and other countries.

The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

Proprietary computer software. Valid license from HP 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.

ZK5638

The HP DECwindows Motif for OpenVMS Alpha Version 1.3--1 documentation set is available on CD-ROM.

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

Contents

Preface

This guide describes the contents, organization, and availability of the
HP DECwindows Motif for OpenVMS Alpha Version 1.3--1 (DECwindows Motif) documentation.

Intended Audience

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

Reader's Comments

HP welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet	openvmsdoc@hp.com
Mail	Hewlett-Packard Company OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

How To Order Additional Documentation

For information about how to order additional documentation, visit the following World Wide Web address:

http://www.hp.com/go/openvms/doc/order

Chapter 1
Documentation Description

This chapter describes all the manuals that make up the extended DECwindows Motif documentation set. This set is currently a combination of industry-standard reference materials and DECwindows Motif product documentation available from HP.

Specifically, this chapter provides brief descriptions of the following documentation:

Note

Only manuals produced by HP are shipped as part of the DECwindows Motif documentation kit. All industry-standard reference manuals can be ordered separately through their respective publishers. See Chapter 2 for further information on ordering these manuals.

1.1 Installation Documentation

The DECwindows Motif installation documentation consists of manuals intended for system administrators.

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
HP DECwindows Motif for OpenVMS Alpha Cover Letter Describes the kit and contains any late-breaking information not included in the release notes.	DECwindows Motif Version 1.3--1
Guide to the HP DECwindows Motif for OpenVMS Alpha CD-ROM Describes the contents of the DECwindows Motif CD-ROM.	DECwindows Motif Version 1.3--1
HP DECwindows Motif for OpenVMS Alpha New Features Describes the enhancements and features introduced with the current release of DECwindows Motif. This manual also describes features from previous releases not documented in other manuals. This manual should be reviewed before installing or using DECwindows Motif.	DECwindows Motif Version 1.3--1
HP DECwindows Motif for OpenVMS Alpha Release Notes Describes corrections, known problems, and restrictions introduced with the current release of DECwindows Motif. This manual also describes problems and restrictions from previous releases not documented in other manuals. This manual should be reviewed before installing or using DECwindows Motif.	DECwindows Motif Version 1.3--1
HP DECwindows Motif for OpenVMS Alpha Installation Guide Describes how to install the DECwindows Motif software.	DECwindows Motif Version 1.3--1
Getting Started With the New Desktop This manual is designed for users of the New Desktop component of DECwindows Motif. It provides information for general users, system managers, and programmers. This manual describes the differences between the New Desktop environment and the Common Desktop Environment.	DECwindows Motif Version 1.2--4 ¹
HP DECwindows Motif for OpenVMS Alpha Documentation Overview This manual lists and describes the contents and organization of the DECwindows Motif documentation set and provides information about the availability of the product documentation.	DECwindows Motif Version 1.3--1

¹Refer to the latest version of the HP DECwindows Motif for OpenVMS Alpha Release Notes and HP DECwindows Motif for OpenVMS Alpha New Features for additional information on system configuration.

1.2 User Documentation

The DECwindows Motif user documentation consists of manuals intended for general users and system administrators.

Due to the manual being discontinued by the publisher (Butterworth-Heinemann), the hardcopy form of Using DECwindows Motif for OpenVMS is no longer orderable. However, online formats of the manual remain available from the DECwindows Motif CD-ROM as well as from the DECwindows Motif section of the OpenVMS Documentation web site. See Chapter 2 for further information on ordering and availability as well as information on accessing this web site.

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
DECwindows Motif for OpenVMS Applications Guide Describes how to start, use, and exit from DECwindows Motif applications.	DECwindows Motif Version 1.2 ¹
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 ¹

¹Refer to the latest version of the HP DECwindows Motif for OpenVMS Alpha Release Notes and HP DECwindows Motif for OpenVMS Alpha New Features for additional information on using DECwindows Motif.

1.3 New Desktop Documentation

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

¹Refer to the latest version of the HP DECwindows Motif for OpenVMS Alpha Release Notes and HP DECwindows Motif for OpenVMS Alpha New Features for additional information on the New Desktop.

1.4 Programming Documentation

DECwindows Motif for OpenVMS Alpha Version 1.3--1 is based on the X Window System, Version 11 Release 6.6 (X11R6.6) 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.
HP (Digital) extensions to Motif include additional widgets and convenience routines to manipulate widgets. HP 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. HP 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 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

1.4.1 Application Programming

If you are an application programmer, you will need information about the OSF/Motif Toolkit, the HP (Digital) 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 Defined strings Parameter and return types Naming conventions X Registry	X Toolkit X11 Releases 5 to 7
HP 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 ¹
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 ¹
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 HP proprietary routines.	DECwindows Motif Version 1.2 ¹
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 HP (Digital) extensions to the Motif Toolkit are generic bindings that currently support Fortran and Pascal.	DECwindows Motif Version 1.2 ¹
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 ¹

¹Refer to the latest version of the HP DECwindows Motif for OpenVMS Alpha Release Notes and HP DECwindows Motif for OpenVMS Alpha New Features for additional information on application programming.

1.4.2 Xlib Programming

Xlib programming documentation consists of three industry-standard reference manuals, and two HP 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: Core Library and Standards (Digital Press) Provides complete reference information about Xlib. The manual describes the following: All Xlib Release 6 routines 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 Bitmap Distribution Format (BDF), which specifies font file format	X Environment X11 Releases 6 and 6.1
X Window System: Core and Extension Protocols (Digital Press) Provides reference information about the core X Protocol and for many of the new language-independent extension protocols. The manual describes the following: X Window System Protocol X Display Manager Protocol X Font Service Protocol X Input Method Protocol Inter-Client Exchange Protocol X Session Management Protocol X Nonrectangular Window Shape Protocol X Synchronization Extension Protocol X Double Buffer Extension Protocol X Keyboard Extension Protocol X Input Device Extension Protocol X Image Extension Protocol X Big-Request Extension Protocol XC-MISC Extension Protocol X Record Extension Protocol XTest Extension Protocol	X Environment X11 Releases 6 and 6.1
X Window System: Extension Libraries (Digital Press) Provides reference information about the C language extension libraries provided that support the X Window System extension protocols. The manual describes the C functions available in each of the following libraries: Inter-Client Exchange library X Session Management library X Nonrectangular Window Shape library X Synchronization Extension library X Double Buffer Extension library X Keyboard Extension library X Input Device Extension library X Image Extension library X Record Extension library XTest Extension library	X Environment X11 Releases 6 and 6.1
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
HP Documentation
VMS DECwindows Guide to Xlib (Release 4) Programming: MIT C Binding and VMS DECwindows Guide to Xlib (Release 4) Programming: VAX Binding Two HP 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 ¹

¹Refer to the latest version of the HP DECwindows Motif for OpenVMS Alpha Release Notes and HP DECwindows Motif for OpenVMS Alpha New Features for additional information on Xlib programming.