About This Manual

This manual introduces the Display PostScript system extension of Digital's Worksystem Software (WS). This manual describes the WS-specific concepts, tasks, and facts that programmers must know to write Display PostScript applications for WS.

This manual supplements Display PostScript system documentation written by Adobe Systems, Inc.

Audience

This manual is intended for experienced Worksystem application programmers who are familiar with C language programming; it assumes that the reader is familiar with the PostScript language.

Organization

This manual comprises six chapters:

Chapter 1 Introduces the Display PostScript system and lists the capabilities it adds to WS.

Chapter 2 Describes the main components that make up the Display PostScript system and summarizes key concepts.

Chapter 3 Explains how to start writing applications for the Display PostScript system and presents a simple example program.

Chapter 4 Presents advanced concepts and tasks.

Chapter 5 Describes the WS-specific header file of the Display PostScript system Client Library and describes each WS-specific Client Library routine.

Chapter 6 Describes X-specific operators provided by WS.

Related Documents

The following books, published by Addison-Wesley Publishing Company, Inc., help you understand the PostScript language:

PostScript Language Reference Manual
PostScript Language Tutorial and Cookbook
PostScript Language Program Design

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 your system 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

The following typographical conventions are used in this manual:

. . . In syntax definitions, a horizontal ellipsis indicates that the preceding item can be repeated one or more times.

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.

symbol In text and examples, all directory names, file names, routine names, PostScript operator names, and code samples appear in this typeface.

Chapter 1	Introduces the Display PostScript system and lists the capabilities it adds to WS.
Chapter 2	Describes the main components that make up the Display PostScript system and summarizes key concepts.
Chapter 3	Explains how to start writing applications for the Display PostScript system and presents a simple example program.
Chapter 4	Presents advanced concepts and tasks.
Chapter 5	Describes the WS-specific header file of the Display PostScript system Client Library and describes each WS-specific Client Library routine.
Chapter 6	Describes X-specific operators provided by WS.

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

. . .	In syntax definitions, a horizontal ellipsis indicates that the preceding item can be repeated one or more times.
`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.
`symbol`	In text and examples, all directory names, file names, routine names, PostScript operator names, and code samples appear in this typeface.