wp2x - Online in the Cloud

PROGRAM:

NAME

wp2x - A WordPerfect 5.0 to whatever converter

SYNOPSIS

wp2x [ -s ] [ -v ] [ -nblip ] configfile wpfile

DESCRIPTION

Wp2x is intended to convert simple files stored in WordPerfect 5.1 format into any other
document processing language that uses plain text files. Examples include TeX, LaTeX,
troff, GML and HTML. For a quick result without manual configuration you can try the
following command to convert a WP file into HTML: wp2x html foo.wp > foo.html.

Wp2x reads a configuration file and a WordPerfect 5.1 input file, and uses the information
in them to produce an output file, which is sent to stdout. If the configuration file
cannot be found, a suffix of .cfg is appended. The current directory is searched, as well
as the lib directory specified by the WP2X_DIR variable in the Makefile. (Usually
/usr/local/lib/wp2x ) and the directories specified by the environment variables PATH ,
DPATH , and WP2XLIB .

Some codes are not translated because documents that require these codes typically would
require significant hand-editing. Hence, there's no point in trying to emulate something
you're going to delete anyway. (Remember, wp2x is not intended to be used as an automated
conversion program. Rather, it is intended to be used as a single step in the document
conversion process, which gets most of the the grunt work of conversion done and out of
the way, so that you can concentrate your efforts on converting the trickier parts of the
document. The object of the game is to produce a readable conversion, rather than a
perfect conversion.)

As the program runs, a dot is printed to stderr for every 1024 characters converted. This
can be suppressed with the -s switch, and the interval between dots can be changed with
the -n switch.

OPTIONS

-s Suppresses all non-error output to stderr, including the typeout banner, the
progress dots, and warnings about undefined expansions.

-nblip Every blip tokens, a dot is emitted to stderr, unless the -s switch is given. The
value blip must appear immediately following the -n without an intervening space.
If no -n switch is supplied, then a value of 1024 is assumed.

-v prints the version number and the program usage.

USAGE

The configuration file controls how the file is converted from WordPerfect 5.1 format.
Each line of the configuration file is of the form

identifier="list of codes"

where the list of codes is a string which will be placed in the output stream whenever the
corresponding WordPerfect code is encountered. Standard C-style backslash-escape
sequences are recognized, as well as \xFF for hex values. You do not have to backslash-
protect a newline. Some identifiers supply replaceable parameters, which can be
interpolated as follows:

%1 interpolate first parameter as a decimal integer.

%2 interpolate second parameter as a decimal integer.

%c interpolate first parameter as an ASCII character.

%\n interpolate a newline if the most-recently-output character was not already a
newline. (The \n can be either the C-style escape sequence, or an actual newline
character.) Use this if the expansion must take place at the beginning of a line.
(For example, troff control characters must appear as the first character in the
line in order to take effect.) This sequence is meaningful only at the beginning
of the string; if it appears elsewhere, it is flagged as erroneous.

%% interpolate a percent-sign.

A percent sign followed by any other character is considered an error. It is also an
error to interpolate a parameter that is not applicable to the identifier being defined.
You may interpolate the parameters as many times as, and in whatever order, you wish.
(With the exception of the %\n code.)

Here follows a list of the accepted identifiers. In the discussion, `%1' represents the
first parameter, and `%2' the second. Remember that the character version of %1 is
available as `%c'.

BEGIN Expanded at the beginning of the file.
END Expanded at the end of the file.
COMMENT Expanded when wp2x needs to insert a comment into the output. The comment
is passed as %s.

PageNo Insert current page number
RomanPage Set page number to %1, and set roman-numeral mode
ArabicPage Set page number to %1, and set arabic-numeral mode

Tab What to do when you see a tab character.
BeginTabs Emitted when tab settings are about to change. The BeginTabs code should
delete all existing tabs and prepare for new tab settings to start. All
tab values are given in columns measured from the physical left edge of the
paper. (Not from the left margin.)
SetTab Set a normal (left-justified) tabstop at column %1.
SetTabCenter Set a centered tabstop at column %1.
SetTabRight Set a right-justified tabstop at column %1.
SetTabDecimal Set a decimal tab at column %1.
EndTabs Finish the setting of tabstops.

For example, if the WordPerfect file contains a code that says `Set new tabstops as
follows: Regular tab at column 15, a centered tab at column 40, a right-justified tab at
column 59, and a regular tab at column 60', then the following expansions are made in
succession:

BeginTabs
SetTab(15)
SetTabCenter(40)
SetTabright(59)
SetTab(60)
EndTabs

HSpace Hard (nonbreakable) space.
HPg Hard page break.
CondEOP
Force a new page if fewer than %1 half-lines remain on current page.

HRt Hard return.
SRt Soft return.

- Breakable hyphen.
-- Breakable hyphen, appearing at the end of a line.
= Non-breakable hyphen.
\- Discretionary hyphen.
\-- Discretionary hyphen, appearing at the end of a line.

Marg Set left margin at %1 characters and right margin at %2 characters.
TopMargin
Set top margin to %1 lines.
PageLength
Set page length to %1 lines.

SS Single spacing.
DS Double spacing.
1.5S One-and-a-half spacing.
TS Triple spacing.
LS Other line spacing. %1 is twice the desired spacing. (For example, a request for
2.5-spacing sets %1=5.)
LPI Set %1 lines per inch (%1 is either 6 or 8)

Bold Begin boldface
bold End boldface
Und Begin underline
und End underline
DoubleUnd
Begin double underline
doubleund
End double underline
Red Begin redline
red End redline
Strike Begin strikeout
strike End strikeout
Rev Begin reverse video
rev End reverse video
Outline
Begin outline text
outline
End outline text
Fine Begin fine font size
fine End fine font size
Over Begin overstrike font
over End overstrike font
Sup Begin superscript
sup End superscript
Sub Begin subscript
sub End subscript
Large Begin large font size
large End large font size
Small Begin small font size
small End small font size
VeryLarge
Begin very large font size
verylarge
End very large font size
ExtraLarge
Begin extra large font size
extralarge
End extra large font size
Italics
Begin an italics font
italics
End an italics font
Shadow Begin shadow font
shadow End shadow font
SmallCaps
Begin small capitals font (fixed width)
smallcaps
End small capitals font (fixed width)

UpHalfLine
Advance printer up 1/2 line
DownHalfLine
Advance printer down 1/2 line
AdvanceToHalfLine
Advance to absolute vertical position. %1 is what WordPerfect thinks the current
vertical page position is, in half-lines. %2 is the desired position, also in
half-lines.

Indent Expanded when an "Indent" code appears.
indent Expanded at the end of an indented paragraph.
DIndent
Expanded when a "left-and-right-indent" code appears.
dindent
Expanded at the end of an double indent
MarginRelease
Margin release. %1 is the number of characters to move left.

Center Center current line
center End centering
CenterHere
Center line around current column
centerhere
End centering

Align Begin alignment
align End alignment
AlignChar
Set alignment character
FlushRight
Begin flush right
flushright
End flush right

Math Begin math mode
math End math mode
MathCalc
Begin math calc mode
MathCalcColumn
Math calc column

SubTotal
Do subtotal
IsSubTotal
Subtotal entry
Total Do total
IsTotal
Total entry
GrandTotal
Do grand total

Col Begin column mode
col End column mode

Fn Expanded at the beginning of a footnote.
fn Expanded at the end of a footnote.
En Expanded at the beginning of an endnote.
en Expanded at the end of an endnote.
SetFn# Set the number for the next footnote to %1.
FNote# Footnote number.
ENote# Endnote number.
Figure#
Figure number.
TableMarker
Insert table of contents here

Hyph Enable hyphenation.
hyph Disable hyphenation.
Just Enable justification.
just Disable justification.
Wid Enable widow/orphan protection.
wid Disable widow/orphan protection.
HZone The hyphenation zone. %1 and %2 are the two magical values that WordPerfect uses
to control hyphenation.
DAlign Set the decimal alignment character to that whose ASCII value is %1. (`%c' is
useful here.)

Header Begin header text
header End header text
Footer Begin footer text
footer End footer text

Supp Suppress page number/header/footer information for one page. %1 argument is a bit
field which describes what sort of suppression is desired. Here's what the bits
mean:
1 = all
2 = page number
4 = page numbers moved to bottom
8 = all headers
16 = header a
32 = header b
64 = footer a
128 = footer b
CtrPg Center page vertically

SetFont
Change pitch or font. %1 is the desired pitch. (Negative means proportionally-
spaced.) %2 is the font number.
SetBin Select paper bin to %1 = 0, 1, ...

PN0 No page numbering.
PN1 Page number in top left.
PN2 Page number in top center.
PN3 Page number in top right.
PN4 Page number on top outside corners (even/odd).
PN5 Page number in lower left.
PN6 Page number in bottom center.
PN7 Page number in lower right.
PN8 Page number on bottom outside corners (even/odd).

If no expansion is supplied for an identifier, then nothing is emitted to stdout, but a
warning message is sent to stderr. This warning message will appear at most once per
identifier, and it can be suppressed completely by the -s option.

The special identifier typeout causes its replacement text to be displayed on the screen
every time the configuration file is read. This is useful for identification messages, or
reminders to the user.

A special identifier is any character enclosed in single quotation marks, which represent
themselves. For example,

'α'="{\\alpha}"

causes the string "{\alpha}" to be emitted when an α is encountered. This could also have
been written as

'\xE0'="{\\alpha}"

if the character α has ASCII value 0xE0. (Which is true for the IBM PC encoding.)

If no definition exists for a particular special character, it is transmitted undisturbed.
If a special character is encountered from the upper half of the ASCII character set, and
if it has no definition, then a warning message is also emitted. (Which can be suppressed
with the -s option.)

Lines beginning with the # character are comments.

NOTES

This is based on an original WP 4.2 to anything translator. The file format has changed a
lot between 4.2 and 5.0. This translator no longer reads WP 4.2 files, although it could
be extended to do so.

The 5.0+ format starts with a standard header file. There is a four byte magic number at
the head of the file, followed by various product and version information. All WordPerfect
Corporation utilities use this standard header. See the WPproducts array in wp2x.c

Once the contents of the file have been located, there are three kinds of codes: simple
one byte controls (WP 4.2 had only these kinds), fixed length controls, and variable
length controls. There are a large number of undefined types defined for future use. If
wp2x detects something it doesn't understand, it can extract the length and skip that
code. There are a number of defined codes that are unimplemented. Please see the code,
specifically tokens.c where much of the input processing is done.

Use wp2x online using onworks.net services