wordst.htm

各种文件格式说明及程序描述

specifies the new value for footnote numbering. optionally specifies whether footnote
numbering should restart every page or be consecutive throughout the document.<br>
<br>
.fi&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; file insert. prints the specified file at that
point in the document. .fi commands may be nested up to 7 levels deep. .fi files can be in
ascii, wordstar, or lotus 123, symphony, quattro, or vp-planner worksheets.<br>
<br>
.fm&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; footer margin. the number of blank lines from
the end of the text on a page to the first footer line. default is 2. the sum of the
footer margin plus the number of footer lines must be less than or equal to the bottom
margin. <br>
<br>
.fo or f1&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; footer. the text following the command .f1
will be printed as the first footer line on this and all subsequent pages. a .fo (or .f1)
followed by one or zero blanks cancels the footer line. the footer uses the character
width and line height in effect at the time the .fo (or .f1) command is encountered in the
text. .fo can optionally specify even or odd numbered page footers.<br>
<br>
.f2&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; second footer.<br>
<br>
.f3&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; third footer.<br>
<br>
.f4&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; fourth footer.<br>
<br>
.f5&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; fifth footer.<br>
<br>
.go&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; go to top or bottom of document.<br>
<br>
.he or h1&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; header. the text following the command .h1
is printed as the first header line on all subsequent pages. if the header command is one
of the first dot commands on a page it takes effect for that page, otherwise it affects
the following pages. a .he or .h1 followed by one or zero blanks cancels the header line.
the header uses the character width and line height in effect at the time the .he or .h1
command is encountered in the text. .he can optionally specify even or odd numbered page
headers.<br>
<br>
.h2&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; second header.<br>
<br>
.h3&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; third header.<br>
<br>
.h4&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; fourth header.<br>
<br>
.h5&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; fifth header.<br>
<br>
.hm&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; header margin. the number of blanks lines
between the top of the text on a page and the last header line. default is 2. the sum of
the header margin plus the number of header lines must be less than or equal to the top
margin.<br>
<br>
.hy&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; turn auto-hyphenation on/off. enables or
disables the hyphenator. starting with wordstar 6.0 rev. d.<br>
<br>
.if&nbsp;&nbsp;&nbsp; m&nbsp;&nbsp;&nbsp; if. used for conditional merge printing in
conjunction with the .el and .ei commands. only simple conditions can be tested using the
following operators:<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; = strings
alphabetically equal.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;&gt; strings
unequal.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &gt; greater than.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt; less than.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #= numbers equal.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #&lt;&gt; numbers
unequal.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #&gt; greater than.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; #&lt; less than.<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; .if commands may be nested up to 255 levels
deep.<br>
<br>
.ig or..&nbsp;&nbsp;&nbsp; e&nbsp;&nbsp;&nbsp; ignore. the text on the remainder of .. the
line is treated as an unprinted comment.<br>
<br>
.ix&nbsp;&nbsp;&nbsp; i&nbsp;&nbsp;&nbsp; index. the text on the remainder of the line is
put in the index. a comma is used to separate a main index entry from a subentry. if a
dash is the first character following the .ix, the index entry is treated as a cross
reference entry. if a plus sign is the first character following the .ix, the page number
for that index entry is printed in boldface.<br>
<br>
.kr&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; kerning. adjusts space between certain pairs of
printed characters for fonts that contain kerning information.<br>
<br>
.l#&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; line numbering. specifies whether to turn line
numbering off, or the spacing and position of the line numbering. also optional is whether
to start numbering at the beginning of each page or the beginning of the document.<br>
<br>
.lh&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; line height. changes current line height in
1/48 inch increments. the default is 8/48 or 6 lines per inch. all lines following this
command are set based on the current line height value. optionally, an argument of 'a' or
'a' will turn on &quot;auto-leading&quot;, and all subsequent lines will use the line
height of the largest font in the line.<br>
<br>
.lm&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; left margin. determines the left edge of
subsequent text.<br>
<br>
.lq&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; letter quality on/off. enables or disables
letter quality printing on dot matrix printers (ignored if not supported on the printer).<br>
<br>
.ls&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; line spacing. selects a line spacing of
between 1 and 9 for subsequent typing or paragraph alignment. a value of 1 is for single
spacing, 2 for double spacing, etc.<br>
<br>
.ma&nbsp;&nbsp;&nbsp; m&nbsp;&nbsp;&nbsp; math. stores the results of a complex equation
in a variable.<br>
<br>
.mb&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; bottom margin. the footer or page number is
printed within this margin. the default value is 8 lines.<br>
<br>
.mt&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; top margin. the number of lines from the
beginning of the page to the beginning of printed text. the header is printed within this
margin. default value is 3 lines.<br>
<br>
.oc&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; centering on/off. when on, further lines in
the document will be centered within the left and right margins until a .oc off command is
encountered.<br>
<br>
.oj&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; output justification on/off. command which
turns right justification on or off for subsequent typing or paragraph realignment. when
off, text is ragged at the right margin. when on, text is flush right.<br>
<br>
.oj&nbsp;&nbsp;&nbsp; c&nbsp;&nbsp;&nbsp; center.<br>
.oj&nbsp;&nbsp;&nbsp; r&nbsp;&nbsp;&nbsp; right flush.<br>
<br>
.op&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; omit page number. at print time no page numbers
are printed unless the &quot;#&quot; has been used in footers or headers.<br>
<br>
.p#&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; paragraph number. specifies the initial value
and/or the format to use for paragraph numbering. also optionally specifies whether
compound or outline numbering is to be used.<br>
<br>
.pa&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; page break. begin a new page here.<br>
<br>
.pc&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; page column. indicates the column at which the
page number will be printed. this is active only when the footers are not in use and page
numbering is turned on. if the column specified is 0, then the page number is centered
between the margins in effect where the .pc command is given.<br>
<br>
.pe&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; print endnotes. when encountered during
printing, endnotes will be printed at this point in the document.<br>
<br>
.pf&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; paragraph realignment while printing. may be on,
off, or dis (for discretionary). when on, subsequent paragraphs are realigned as they are
printed. when off, paragraphs are not realigned. when dis, paragraphs are realigned only
when merge print data is substituted in the document. paragraphs are aligned using the
left, right, and paragraph margins currently in effect.<br>
<br>
.pg&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; number pages. at print time the page number is
printed at the bottom of the page unless a footer overrides it. usually used to restore
page numbering after being turned off with .op.<br>
<br>
.pl&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; page length. the total number of lines in a
page assuming 6 lines per inch. an eleven inch page contains 66 lines.<br>
<br>
.pm&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; paragraph margin. the left margin to use for
the first line of every subsequent paragraph. used for both regular and hanging indents.<br>
<br>
.pn&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; page number. the current page number.<br>
<br>
.po&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; page offset. the number of print columns from
the left edge of the paper to the left margin of text. the current setting of character
width (.cw) deter mines the actual amount of indentation. .po can optionally specify even
or odd number page offsets.<br>
<br>
.pr&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; printer information. currently used to select
the print orientation for laser printers (use .pr or=l for landscape, and .pr or=p for
portrait).<br>
<br>
.ps&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; proportional spacing on/off. subsequent text is
to be printed using a proportional font.<br>
<br>
.rm&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; right margin. determines the right edge of
subsequent paragraphs.<br>
<br>
.rp&nbsp;&nbsp;&nbsp; m&nbsp;&nbsp;&nbsp; repeat. command to repetitively print copies of
a document. the .df command may interfere with the .rp command.<br>
<br>
.rr&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; ruler. embeds a ruler line to be used for
subsequent typing and alignment. the text following the .rr is the exact image of the
ruler line above the text on the screen. a .rr with a # (0-9) specifies a preformatted
ruler line (stored in the user area).<br>
<br>
.rv&nbsp;&nbsp;&nbsp; m&nbsp;&nbsp;&nbsp; read variable. merge print command used to read
one or more of the next data from a file into variables.<br>
<br>
.sb&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; suppress blank lines on/off. starting with
wordstar 6.0 rev. d, soft lines at the beginning of pages will be automatically
suppressed. this dot command controls the display and printing of blank hard returns at
the beginning of pages.<br>
<br>
.sr&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; sub/superscript roll. the increments (in 1/48ths
of an inch) which the carriage is to roll up or down for subscript and superscript
printing. default is 3 (3/48ths of an inch).<br>
<br>
.sv&nbsp;&nbsp;&nbsp; m&nbsp;&nbsp;&nbsp; set variable. merge print command used to store
data in a variable.<br>
<br>
.tb&nbsp;&nbsp;&nbsp; e p&nbsp;&nbsp;&nbsp; tab stops. sets multiple tab stops for further
editing/printing in the document.<br>
<br>
.tc&nbsp;&nbsp;&nbsp; t&nbsp;&nbsp;&nbsp; table of contents. the text following the .tc is
a table of contents entry. a &quot;#&quot; indicates where the page number is to go in the
entry. .tc1 through .tc9 are used to simultaneously build nine other tables.<br>
<br>
.uj&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; micro justify. specifies whether subsequent
lines are to be micro- justified at print time. when on, the white space necessary to
right justify a line is spread in very fine increments evenly over the line. when off,
whole blanks are used to spread the white space. when dis, the printer driver decides;
microjustification is not performed if it slows down printing dramatically.<br>
<br>
.ul&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; continuous underlining on/off. enables or
disables underlining of blanks between words.<br>
<br>
.xe .xq&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; custom print control. the hex pairs<br>
.xr .xw&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; following the dot command define the
custom print control for ^e, ^q, ^r, and ^w encountered in the text respectively. the
definition may include up to five bytes.<br>
<br>
.xl&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; form feed. the hex pairs following .xl define
the print control string to be sent to eject the paper to the following page when
printing.<br>
<br>
.xx&nbsp;&nbsp;&nbsp; p&nbsp;&nbsp;&nbsp; strikeout character. redefines the character
used for strikeouts.<br>
<br>
symmetrical sequences<br>
<br>
symmetrical sequences are used for features that cannot be handled by dot commands or
print control characters, or that belong embedded in the text instead of in dot commands.
all symmetrical sequences begin with the control character 1dh, followed by a count (2
bytes), and a type byte. symmetrical sequences end with a count (2 bytes), and the control
character 1dh. the count is stored low order byte first and is the sum of all the
characters in the symmetrical sequence minus 3 (thus the count can be added to the start
address of the sequence to point to the end count). symmetrical sequences can contain any
character including 1ah.<br>
<br>
note that some symmetrical sequences can contain symmetrical sequences themselves
(annotations, for example). currently only one level of this recursion is used.<br>
<br>
also note that all of these sequences are subject to change.<br>
<br>
the present interpretation of symmetrical sequences is:<br>
<br>
<br>
header sequence<br>
<br>
type: <br>
<br>
0&nbsp;&nbsp;&nbsp; header:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; byte: version number in bcd (50h for release
5.0, 55h for release 5.5, 60h for release 6.0)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 9 bytes: null terminated driver name for this
document.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2 bytes: reserved.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2 words: 32-bit pointer to the beginning of the
file's style library (lo word in lo,hi format, high word in lo,hi format).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 107 bytes: reserved. (total 128 bytes for
header sequence including counts and leading/trailing 1dh).<br>
<br>
print controls<br>
<br>
1&nbsp;&nbsp;&nbsp; color:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; byte: color number (see below).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; byte: previous color in file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; the color number is as follows:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0 - black<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 1 - blue<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2 - green<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 3 - cyan<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 4 - red<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 5 - magenta<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 6 - brown<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 7 - light grey<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 8 - dark grey<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 9 - light blue<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0ah - light green<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0bh - light cyan<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0ch - light red<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0dh - light magenta<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0eh - yellow<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 0fh - white on black<br>
2&nbsp;&nbsp;&nbsp; font:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; word: font width in hmis (1/1800ths)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; word: font height in vmis (1/1440ths)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; word: typestyle (see below)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; word: previous font width<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; word: previous font height<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; word: previous typestyle<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; please note that the typestyle definitions
listed below are partial (more are being added) and may change.<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; typestyles are defined by a word with the high
order seven bits defined as follows:<br>
<br>
<br>
bit #:&nbsp;&nbsp;&nbsp; usage:<br>