home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Phoenix CD 2.0
/
Phoenix_CD.cdr
/
24b
/
headers.zip
/
HEADERS.DOC
next >
Wrap
Text File
|
1986-04-28
|
9KB
|
258 lines
Version 4.01 HEADERS - Operating Instructions
HEADERS.EXE is a compiled Modular BASIC program and runs on an
IBM PC/XT/AT under PC-DOS 2.10, 3.00, 3.10, or 3.20. Unless you
have a large amount of memory dedicated to resident software or
RAM disks, you should be able to run this program in 128K of RAM.
The program prints ASCII text files in a variety of formats. The
printer must be an IBM Personal Computer Matrix Printer or
Graphics Printer. The Graphics Printer is required only for the
high-density formats (lines per page > 88).
The intended use of HEADERS is to produce listings of source code
files (programs) and other ASCII data files. It is not intended
to support the printing of files which have embedded form feeds
or existing headers.
The program was called HEADERS because it allows customized
headers to be placed at the top of each page. As you will see
below, many other options are also available.
Header Line Format
HEADERS will produce a header at the top of each page if you use
the DOS "SET" command to assign strings to HEADER1 or HEADER2
before running the program. The string assigned to HEADER1
determines what will appear on the left-hand side of the heading,
and HEADER2 the middle part of the heading. If you set either
HEADER1 or HEADER2 (or both), the right-hand side of the heading
will contain the name of the file being printed and a pagenumber.
No heading is produced if both HEADER1 and HEADER2 are empty
strings.
Typical use of the SET command might be:
SET HEADER1=April 28, 1986
SET HEADER2=(C) Copyright 1986 by John & Mary Doe
You can also use special strings to set HEADER1 so that HEADERS
will supply the current date or time (or both). The formats are
shown below:
SET HEADER1=DATE
SET HEADER1=TIME
SET HEADER1=DATE,TIME
SET HEADER1=TIME,DATE
Note that the values you set for HEADER1 and HEADER2 remain in
effect until you change them (or reboot).
COMMAND LINE FORMAT
HEADERS FileSpec [/ Option [,Option]...]
FileSpec is used to specify the input file. FileSpec may contain
a drive specification and path specification. Output always goes
to the printer named "LPT1:".
If you type simply "HEADERS" (with no arguments) you will get a
command summary displayed on your screen.
Option may assume any of the formats below.
W=www Width of page (characters per line)
L=lll Left margin size
R=rrr Right margin size
H=hhh Height of page (lines per page)
G=ggg Gap between pages
S=sss Spacing of lines
B=bbb Beginning page
E=eee Ending page
D Double strike
WIDTH OF PAGE
Page width is specified with the option "W=www". The "www" must
be one of the numbers 40, 66, 80, or 132. If this option is not
used, HEADERS assumes a default of W=80.
LEFT MARGIN SIZE
Margin size is specified with the option "L=lll". The "lll" must
be a non-negative number smaller than the page width. If this
option is not used, HEADERS assumes a default of L=0.
Note that a non-zero value must be specified to take advantage of
HEADERS's capability to handle input lines which are longer than
the selected page width. If left margin size is 0, HEADERS
simply truncates long lines to the page width. If a margin size
greater than 0 exists, HEADERS will print "continuation" lines
which are recogized by the occurrence of a vertical bar "|" in
the left margin.
RIGHT MARGIN SIZE
The size of the right-hand margin is specified with the option
"R=rrr". The "rrr" must be a non-negative number smaller than
the page width. If this option is not used, HEADERS assumes a
default of R=0.
NOTE: For obvious reasons, the sum of the left-hand and right-
hand margins must be less than the page width.
HEIGHT OF PAGE
Page height is specified with the option "H=hhh". The "hhh" must
be one of the numbers 11, 22, 33, 44, 66, 88, 99, 108, 132, or
165. A graphics printer is required for page heights 99, 108,
132, or 165. If this option is not used, HEADERS assumes a
default of H=66.
GAP BETWEEN PAGES
Interpage gap is specified with the option "G=ggg". The "ggg"
must be a non-negative number smaller than the page height. If
this option is not used, HEADERS sets the page gap to the page
height divided by 11 (discarding any remainder).
SPACING
Spacing (of lines) is specified with the option "S=sss". Single
spacing is obtained if sss = 1, double spacing if sss= 2, etc.
If this option is not used, HEADERS assumes a default of S=1.
BEGINNING PAGE
The page number of the first page to be printed is specified with
the option "B=bbb", where "bbb" is a non-negative number. If
this option is not used, HEADERS assumes a default of B=1.
ENDING PAGE
The page number of the last page to be printed is specified with
the option "E=eee", where "eee" is a non-negative number. If
this option is not used, HEADERS assumes a default of E=32767.
DOUBLE STRIKE
Double strike is specified with the option "D". Double strike is
used automatically for page heights of 99, 108, 132, or 165.
Otherwise, double strike is used only if you use the "D" option.
Other Documentation
Detailed information on this program can be obtained by reading
the Modular BASIC source code (HEADERS.MB).
Sample Command Lines
HEADERS SAMPLE.TXT
Prints SAMPLE.TXT using all of HEADER's defaults. This is the
same as the command:
HEADERS SAMPLE.TXT/W=80,L=0,R=0,H=66,G=6,S=1,B=1,E=32767
Lines longer that 80 characters are truncated. Left and right
margins are not used. 60 lines of text are printed per page
with an interpage gap of 6 lines. Lines are printed using
single-spacing (no blank lines between lines of text).
Double-strike is not used.
HEADERS SAMPLE.TXT/L=4,R=4,D
This is the same as the command:
HEADERS SAMPLE.TXT/W=80,L=4,R=4,H=66,G=6,S=1,B=1,E=32767,D
Lines longer than 72 (80-4-4) characters result in
continuation lines being printed. The left and right margin
are each 4 columns wide. 60 lines of text are printed per
page with an interpage gap of 6 lines. The lines are single-
spaced and printed using double-strike.
HEADERS SAMPLE.TXT/L=4,R=4,D,B=4,E=7
This is the same as the command above, except that only pages
4, 5, 6, and 7 will be printed.
HEADERS SAMPLE.TXT/W=132,L=20,R=32,H=88,S=2
This is the same as the command:
HEADERS SAMPLE.TXT/W=132,L=20,R=32,H=88,G=8,S=2,B=1,E=32767
Lines longer than 80 (132-20-32) characters result in
continuation lines being printed. The left margin will be 20
columns, and the right margin will be 32 columns. There will
be 80 (88-8) printed lines per page with an interpage gap of 8
lines. 40 of the lines printed will be blank because double-
spacing is requested (one blank line between lines of text).
HEADERS SAMPLE.TXT /W=132,L=4,R=8,H=165,G=15
This command will generate 150 (165-15) lines per page with
120 (132-4-8) characters printed per line. The left margin is
4 columns wide and the right margin 8 columns. Continuation
lines are used for lines containing more than 120 characters.
Suggestion: Unless you have already printed this document and
HEADERS.MB, use HEADERS to do so. This can be done with the
following commands:
SET HEADER1=DATE,TIME
SET HEADER2=Public Domain Software
HEADERS HEADERS.DOC/L=5,R=10
HEADERS HEADERS.MB/W=132,L=16,R=36,H=88
If your printer ribbon is getting used up, you can append ",D" to
the end of each HEADERS command to get a better printout.
Remember, though, double-strike printing takes twice as long, so
use it only if a high-quality listing is required.
NOTE: Double-strike is automatically used is you select a page
height greater than 88 lines per page (assuming you have a
Graphics Printer). The double-strike is done by the printer
itself and not by the HEADERS program.
It is relatively easy to set up batch files which contain fixed
options you use frequently.
Payment
There is no fee or license associated with this program. It is
being placed in the Public Domain to be used as you see fit.
If you have problems with this program, contact:
software, etc.
P.O. Box 25469
Rochester NY 14625
(716) 671-8311