X Window System Environment

Product Version: Digital UNIX Version 4.0 or higher March 1996

This manual contains information for system administrators and programmers about the Digital UNIX implementation of the X Window System, Release 6 (X11 R6). This manual also contains information about customizing the Digital UNIX window system workstation environment.

The following are trademarks of Digital Equipment Corporation: ALL-IN-1, Alpha AXP, AlphaGeneration, AXP, Bookreader, CDA, DDIS, DEC, DEC Ada, DEC Fortran, DEC FUSE, DECnet, DECstation, DECsystem, DECterm, DECUS, DECwindows, DTIF, Massbus, MicroVAX, OpenVMS, POLYCENTER, Q-bus, TruCluster, ULTRIX, ULTRIX Mail Connection, ULTRIX Worksystem Software, UNIBUS, VAX, VAXstation, VMS, XUI, and the Digital logo.

This manual is derived from MIT documentation, which contains the following permission notice: Permission to use, copy, modify, and distribute this documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appears in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of MIT or DIGITAL not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. MIT and DIGITAL make no representations about the suitability of the software described herein for any purpose. It is provided "as is," without express or implied warranty. Open Software Foundation, OSF, OSF/1, OSF/Motif, and Motif are trademarks of the Open Software Foundation, Inc. Adobe, PostScript, and Display PostScript are registered trademarks of Adobe Systems, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd.

Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii).

Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor.

Digital conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community.

About This Manual

The Digital UNIX X Window System Environment manual discusses various aspects of the X Window System (X11) Release 6 implementation on the Digital UNIX (R) (formerly DEC OSF/1) operating system. Digital has changed the name of its UNIX operating system from DEC OSF/1 to Digital UNIX. The new name reflects Digital's commitment to UNIX and its conformance to UNIX standards.

Audience

This manual provides general information as well as specific information about the X Window System as supplied by the Digital UNIX operating system. The audience for this information includes end users, system administrators, and applications programmers.

New and Changed Features

This manual has been revised to document X11 R6.

Organization

This document has four chapters:

Chapter 1	Provides introductory information and lists the books that this manual complements.
Chapter 2	Discusses X Window System system administration topics for Digital UNIX systems.
Chapter 3	Explains how to customize X environment resources and `keysyms` on Digital UNIX systems.
Chapter 4	Discusses X server extensions that are part of the Digital UNIX X Window System environment as well as other programming topics that apply to Digital UNIX systems.

Related Documents

The following books are part of the Digital UNIX hardcopy documentation set. The information in the Digital UNIX X Window System Environment supplements information found in these books:

X Window System Administrator's Guide, Linda Mui and Eric Pearce, O'Reilly & Associates, Inc.
PostScript Language Reference Manual, Adobe Systems Incorporated, Addison-Wesley Publishing Company, Inc.

For Digital UNIX, the X Consortium provides programming documentation. See the Documentation Overview, Glossary, and Master Index for information on where this documentation is located.

The following manuals are available on Digital UNIX through Bookreader as well as being part of the hardcopy documentation set:

DECwindows User's Guide
DECwindows Companion to the OSF/Motif Style Guide
DECwindows Extensions to Motif
DECwindows Motif Guide to Application Programming
OSF/Motif Style Guide
OSF/Motif Programmer's Guide

The following book provides extensive information about the Motif window interface, including topics on the mwm window manager, font specification, graphics utilities, and customizing your X Window System working environment:

X Window System User's Guide, OSF/Motif 1.2 Edition, Valerie Quercia and Tim O'Reilly, O'Reilly & Associates, Inc.

Programmers creating Display PostScript applications can find detailed information in the following book:

Programming the Display PostScript System with X, Addison-Wesley Publishing Company, Inc.
The Digital UNIX operating system includes online PostScript files of several technical papers from Adobe Systems Incorporated. These files are located in the /usr/share/doclib/dps directory.

Documents from the X Consortium describing the X Image Extension, Version 5, protocols and architecture are provided in PostScript files in the /usr/share/doclib/xie directory.

Reference pages document all Digital UNIX X Window System commands, OSF/Motif routines, DECwindows routines, and most X Window System routines. Use the man or xman command to review these pages.

The printed version of the Digital UNIX documentation set is color coded to help specific audiences quickly find the books that meet their needs. (You can order the printed documentation from Digital.) This color coding is reinforced with the use of an icon on the spines of books. The following list describes this convention:

Audience	Icon	Color Code
General users	G	Blue
System and network administrators	S	Red
Programmers	P	Purple
Device driver writers	D	Orange
Reference page users	R	Green

Some books in the documentation set help meet the needs of several audiences. For example, the information in some system books is also used by programmers. Keep this in mind when searching for information on specific topics.

The Documentation Overview, Glossary, and Master Index provides information on all of the books in the Digital UNIX documentation set.

Reader's Comments

Digital welcomes any comments and suggestions you have on this and other Digital UNIX manuals.

You can send your comments in the following ways:

Fax: 603-881-0120 Attn: UEG Publications, ZK03-3/Y32
Internet electronic mail: readers_comment@zk3.dec.com
A Reader's Comment form is located on line in the following location:
```
/usr/doc/readers_comment.txt
```
Mail:
```
Digital Equipment Corporation
UEG Publications Manager
ZK03-3/Y32
110 Spit Brook Road
Nashua, NH 03062-9987
```
A Reader's Comment form is located in the back of each printed manual. The form is postage paid if you mail it in the United States.

Please include the following information along with your comments:

The full title of the book and the order number. (The order number is printed on the title page of this book and on its back cover.)
The section numbers and page numbers of the information on which you are commenting.
The version of Digital UNIX that you are using.
If known, the type of processor that is running the Digital UNIX software.

The Digital UNIX Publications group cannot respond to system problems or technical support inquiries. Please address technical questions to your local system vendor or to the appropriate Digital technical support office. Information provided with the software media explains how to send problem reports to Digital.

Conventions

This document uses the following typographical and symbol conventions:

%
$: A percent sign represents the C shell system prompt. A dollar sign represents the system prompt for the Bourne and Korn shells.
% cat: Boldface type in interactive examples indicates typed user input.
file: Italic (slanted) type indicates variable values, placeholders, and function argument names.
[|]
{|}: In syntax definitions, brackets indicate items that are optional and braces indicate items that are required. Vertical bars separating items inside brackets or braces indicate that you choose one item from among those listed.
cat(1): A cross-reference to a reference page includes the appropriate section number in parentheses. For example, cat(1) indicates that you can find information on the cat command in Section 1 of the reference pages.