wp2x.1l

harvest是一个下载html网页得机器人

.TH WP2X 1
.SH NAME
 wp2x \- A WordPerfect 5.0 to whatever converter
.SH SYNOPSIS
.B wp2x
[
.B \-s
] [
.B \-v
] [
.BI \-n blip
] configfile wpfile
.SH DESCRIPTION
.de Tx
.if n TeX\\$1
.if t T\v'12u'E\v'-12u'X\\$1
..
.de Lt
.if n LaTeX\\$1
.if t L\v'-12u'A\v'12u'T\v'12u'E\v'-12u'X\\$1
..
.I Wp2x
is intended to convert
.I simple
files stored in WordPerfect 5.1 format into any other document processing
language that uses plain text files.  Examples include
.Tx ,
.Lt ,
troff, GML and HTML.
.PP
.I 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
.I .cfg
is appended.
The current directory is searched, as well as the lib directory
specified by the 
.I WP2X_DIR
variable in the Makefile. (Usually
.I /usr/local/lib/wp2x
) and the directories specified by the environment variables
.I PATH ,
.I DPATH ,
and
.I WP2XLIB .
.PP
.fi
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,
.I 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.)
.PP
As the program runs, a dot is printed to
.I stderr
for every 1024 characters converted.  This can be suppressed with the
.B \-s
switch, and the interval between dots can be changed with the
.B -n
switch.
.SH OPTIONS
.TP
.B \-s
Suppresses all non-error output to
.IR stderr ,
including the
.I typeout
banner, the progress dots, and warnings about undefined expansions.
.TP
.BI \-n blip
Every
.I blip
tokens, a dot is emitted to
.IR stderr ,
unless the
.B \-s
switch is given.
The value
.I blip
must appear imediately following the
.B \-n
without an intervening space.
If no
.B \-n
switch is supplied, then a value of 1024 is assumed.
.TP
.B \-v
prints the version number and the program usage.
.SH 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
.sp 1
.ce 1
identifier="list of codes"
.sp 1
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 \exFF for hex values.
You do not have to backslash-protect a newline.  Some identifiers
supply replacable parameters, which can be interpolated as follows:
.TP
%1
interpolate first parameter as a decimal integer.
.TP
%2
interpolate second parameter as a decimal integer.
.TP
%c
interpolate first parameter as an ASCII character.
.TP
%\en
interpolate a newline if the most-recently-output character was not
already a newline.
(The
.I \en
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,
.I 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.
.TP
%%
interpolate a percent-sign.
.PP
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
.I %\en
code.)
.PP
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'.
.sp 1
.PD 0
.TP 15
BEGIN
Expanded at the beginning of the file.
.TP
END
Expanded at the end of the file.
.TP
COMMENT
Expanded when wp2x needs to insert a comment into the output.
The comment is passed as %s.
.sp 1
.TP
PageNo
Insert current page number
.TP
RomanPage
Set page number to %1, and set roman-numeral mode
.TP
ArabicPage
Set page number to %1, and set arabic-numeral mode
.sp 1
.TP
Tab
What to do when you see a tab character.
.TP
BeginTabs
Emitted when tab settings are about to change.
The
.B 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.)
.TP
SetTab
Set a normal (left-justified) tabstop at column %1.
.TP
SetTabCenter
Set a centered tabstop at column %1.
.TP
SetTabRight
Set a right-justified tabstop at column %1.
.TP
SetTabDecimal
Set a decimal tab at column %1.
.TP
EndTabs
Finish the setting of tabstops.
.sp 1
.PP
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:
.nf

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

.fi
.TP
HSpace
Hard (nonbreakable) space.
.TP
HPg
Hard page break.
.TP
CondEOP
Force a new page if fewer than %1 half-lines remain on current page.
.sp 1
.TP
HRt
Hard return.
.TP
SRt
Soft return.
.sp 1
.TP
\-
Breakable hyphen.
.TP
\-\-
Breakable hyphen, appearing at the end of a line.
.TP
=
Non-breakable hyphen.
.TP
\e\-
Discretionary hyphen.
.TP
\e\-\-
Discretionary hyphen, appearing at the end of a line.
.sp 1
.TP
Marg
Set left margin at %1 characters and right margin at %2 characters.
.TP
TopMargin
Set top margin to %1 lines.
.TP
PageLength
Set page length to %1 lines.
.sp 1
.TP
SS
Single spacing.
.TP
DS
Double spacing.
.TP
1.5S
One-and-a-half spacing.
.TP
TS
Triple spacing.
.TP
LS
Other line spacing.  %1 is twice the desired spacing.
(For example, a request for 2.5-spacing sets %1=5.)
.TP
LPI
Set %1 lines per inch (%1 is either 6 or 8)
.sp 1
.TP
Bold
Begin boldface
.TP
bold
End boldface
.TP
Und
Begin underline
.TP
und
End underline
.TP
DoubleUnd
Begin double underline
.TP
doubleund
End double underline
.TP
Red
Begin redline
.TP
red
End redline
.TP
Strike
Begin strikeout
.TP
strike
End strikeout
.TP
Rev
Begin reverse video
.TP
rev
End reverse video
.TP
Outline
Begin outline text
.TP
outline
End outline text
.TP
Fine
Begin fine font size
.TP
fine
End fine font size
.TP
Over
Begin overstrike font
.TP
over
End overstrike font
.TP
Sup
Begin superscript
.TP
sup
End superscript
.TP
Sub
Begin subscript
.TP
sub
End subscript
.TP
Large
Begin large font size
.TP
large
End large font size
.TP
Small
Begin small font size
.TP
small
End small font size
.TP
VeryLarge
Begin very large font size
.TP
verylarge
End very large font size
.TP
ExtraLarge
Begin extra large font size
.TP
extralarge
End extra large font size
.TP
Italics
Begin an italics font
.TP
italics
End an italics font
.TP
Shadow
Begin shadow font
.TP
shadow
End shadow font
.TP
SmallCaps
Begin small capitals font (fixed width)
.TP
smallcaps
End small capitals font (fixed width)
.sp 1
.TP
UpHalfLine
Advance printer up 1/2 line
.TP
DownHalfLine
Advance printer down 1/2 line
.TP
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.
.sp 1
.TP
Indent
Expanded when an "Indent" code appears.
.TP
indent
Expanded at the end of an indented paragraph.
.TP
DIndent
Expanded when a "left-and-right-indent" code appears.
.TP 
dindent
Expanded at the end of an double indent
.TP
MarginRelease
Margin release.  %1 is the number of characters to move left.
.sp 1
.TP
Center
Center current line
.TP
center
End centering
.TP
CenterHere
Center line around current column
.TP
centerhere