home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
WordPerfect for Linux Bible
/
WP4LinuxBible.iso
/
readme
/
readme.adr
< prev
next >
Wrap
Text File
|
1999-06-25
|
3KB
|
86 lines
Address Book
------------ Information -------------------------
Corel WordPerfect will utilize a third-party
address book if installed as an executable or a
symbolic link as /<WPdir>/shbin10/addrbook
You can find more information about third party
addressbooks at http://www.sdcorp.com
If you already have a third party address book
that you would like to use with WordPerfect,
install it as follows (you may need to be the
administrator to do this):
1. Quit WordPerfect
2. Use the following shell commands to install
the address book:
cd /<WPdir>/shbin10
ln -s <path-to-addressbook> addrbook
3. Start WordPerfect
----------- Third Party Interface ---------------
The addressbook will be invoked with the following
options:
addrbook -wp -fd <filedscrptr> [-type <n>] [-single]
[-merge <filename>] [-mergeselect <filename>]
The file descriptor is a two-way pipe for reading
and writing. The type can be:
1: Tells addrbook to return a comma
delimited addressbook record which
should be null terminated. This type
is currently not used.
2: Tells addrbook to return individual
e-mail addresses (one e-mail address per
message) which should be null terminated.
3: Tells addrbook to return individual
pre-formatted addresses (one address per
message) which should be null terminated.
The -single option tells the address book to
return a maximum of one selection. In other
words, it will only send one message through the
pipe for the command line -type option rather than
multiple messages.
The -merge option tells the addressbook to write
all of its records to <filename> in WordPerfect
secondary merge format. The -mergeselect option
starts the addressbook so that the user can
select the records to write to the secondary
merge file. For both of these options, the
only data sent through the pipe to WordPerfect
is the MapNotify and DestroyNotify.
The address book communicates information to Corel
WordPerfect by sending two bytes telling WP how
many more bytes of data follow in the message.
The following two bytes (included in the count of
the total number of bytes being transmitted)
contain the type of message being transmitted.
This corresponds to the types described above.
When addrbook starts, it should send a two-byte
MapNotify (defined by X-windows to be 19) type
message to WP. After data is sent to WP, the
address book should exit. When it exits, it
should send a destroy notify (defined as 17) and
close the pipe.
Example:
| |<--------- message ------------>|
| length | type | remainder of message |
| 2 bytes | 2 bytes | n-bytes=(length-2) |
+---------+---------+----------------------+
| 2 | 19 | MapNotify
| 26 | 3 |Hello World\0| address type
| 10 | 3 |bye\0| address type
| 2 | 17 | DestroyNotify