Corel WordPerfect for Unix(TM) Developers Kit Contents

This SDK is divided into two main sections. One for WordPerfect for XWindows found in the wpx directory on this CDROM. The second is the WordPerfect for Character Terminals found in the wpc directory on this CDROM.

The character terminal SDK includes information regarding the following: WordPerfect 8C, 7C, 5.1, 5.0 and 4.2 File Format document. The WordPerfect 7 File Format SDK documents the WordPerfect 7C, 5.1, 5.0 and 4.2 document formats and the WPG 1.0 format (WordPerfect Graphic format).

The Developers kit includes the following documents and directories:

sdk/

wpc/	WordPerfect character 7C and 8C For UNIX Third Party Interface. This Third Party Interface describes the APIs available for UNIX developers for the Character product.

code/	Subdirectory for the sample TPI example program

unixtpi.c	Source C code for the example TPI program

unixtpi.h	Source .h include file forexample TPI program

unixtpi2.c	Source C code for the example TPI program

docs/	Subdirectory for TPI documentation

sdk7c.wpd	Documentation file for TPI 7C, 8C

char.tst	Test print file used to check the ability of your printer

kern.tst	Test print file used to check kerning pairs of characters

printer.tst	Test print file used to check the ability of your printer

wp42ff.txt	Documentation for the WordPerfect 4.2 file format

wpx/	WordPerfect XWindows For UNIX Third Party Interface. The interface describes the APIs available for UNIX developers for the XWindow GUI product.

code/	Subdirectory for all SDK API code

uoapi.c	Sample Unix Open Application Interface source code

uoapi.h	Sample include header file

wt/	Subdirectory for Writing tools APIs code and documentation

makefile	Makefile to create both Client and Tool sample apps

readme	Basic Writing Tool information

wtapi.c	Writing Tools API C-Callable interface functions

wtapi.h	Platform specific API communication header file

wtcomm.c	Writing Tools API communication interface.

wtcomm.h	Writing Tools API header file

wtdef.h	Writing Tools API definitions for client and writing tools use. Platform specific API declarations.

client/	Subdirectory for Writing Tools Client TPI APIs

makefile	Client specific Makefile

wtapi.rc	Initialization file for Client WTAPI program

wtclient.h	Writing Tools API Client sample application header file

wtclient.xbm	Xwindows Icon bitmap for WTAPI program

wtclfile.c	WTAPI sample Client application File I/O functions

wtclient.c	Wrint Tools API Client main functions

wtcltmsg.c	Writing Tools product specific message handling routines

wtcltool.c	WTAPI sample Client application Tools menu handler

server/	Sub Directory containing tool specific source code

makefile	Tool Specific makefile

wtserver.h	Writing Tools API server sample .h header include file

wtserver.c	Writing Tools API server sample appplication. This is a sample writing tool which translate to and from pig latin

wtserver.xbm	Xwindows Icon bitmap for sample WTAPI server app

wtsrvmsg.c	Writing tools api server sample application API message handling routings

docs/

filefrmt1-9.wpd	These files contain detailed information about the WordPerfect file format.

filefset.wpd	The file format of the various .set settings files

sdkwto1-5.wpd	SDK Writing Tools API documentation. 7X SDK manual

uwpmrs.wpd	SDK definitions and macro resource technical documentation

wprint.wpd	Wprint file formats and WPC7.SET technical information

sdkuoapi.wpd	Overview and introduction to Unix Open API SDK manual

search.wpd	Detailed information about API search tokens

sdkindex.wpd	Topical index of SDK

contents.wpd	This document

cpyright.wpd	SDK copyright information

license.wpd	SDK License information

notice.wpd	Corel information, Support information and phone numbers

General information about he SDK.

Because WordPerfect for Unix file formats did not change from 6.X to 7 or from 7 to 8, any referece to 6.X level file formats are applicable to 7X and 8X files as well. Much of the documentation refers to 6.X, use this information when considering 7X and 8X issues. The same applies to 7C, 8C and 5.1. The 7C and 8C product use 5.1 file formats throughout.

WordPerfect documents have a prefix area and a document area. The prefix contains information about the currently selected printer, the fonts that are currently used in the document, document summary information, and so forth. The document area of a WordPerfect document contains text and function codes.

The 7X and 8X products use WPG 2.0 level graphics internally. 7C and 8C use WPG 1.0 level graphics internally. In both cases the WPG file contains records that describe the different attributes and objects that are contained within the graphic. This information is made of records that contain vector graphic information, and can also contain bitmapped graphic information. Developers who are converting to the WPG specification or from WPG to another format will find this information useful. See the documentation in the wpx SDK directory.

Unix Open API This is a general interface that allows an external program to control WordPerfect UNIX

7X and 8X. This section of the SDK covers the general principles of this interface, and then details the detection, initialization, and communication code needed for an interface program to work.

Writing Tools API The Writing Tools interface works with external programs that want to act only on the text of a given document. Such external programs could include spell checkers, grammar checkers, and language translators. This section of the SDK covers the general operating specifications of the interface, how the interface is used by the tool (such as a spell checker), how the interface is used by the Client (the WordPerfect or some other text- based application), and the specifics of how to use and code for the interface on the UNIX operating system.

Sample Applications

UOAPI Sample The UOAPI.C and UOAPI.H files compile into a working UOAPI program. It watches for specific tokens and then either gets or sets system variables. The writing tool sample shows how to interface both the client and the tools side.

WordPerfect 7C, 8C Developers Toolkit and APIs

WordPerfect 7C, 8C/5.1 Document File Formats The WordPerfect section contains information about the WordPerfect document specification. WordPerfect documents have a prefix area and a document area. The prefix contains information about the currently selected printer, the fonts that are currently used in the document, document summary information, and so forth. The document area of a WordPerfect document contains text and function codes. All of this is documented in the WPUnix 7C, 8C section of the SDK.

The Unix 7C, 8C Third-Party Interface section describes the interface available for WordPerfect 7C, 8C for UNIX. It is similar to WordPerfect 5.x for DOS interface that is keystroke-oriented for the UNIX text- based versions of WordPerfect. The graphical versions of WordPerfect for UNIX use more of a token-based interface, similar to WordPerfect for Windows.