README.md
Los Angeles, Fall 1981 - RSX/IAS and VAX SIG tape
The following are contributions from:
A.R.A.P.
Box 2229
Princeton, NJ 08540
Contact: John Leonard (609) 452-2950
A.R.A.P. modified Triangle/Duke/Rockwell RUNOFF for technical documents
In addition to the excellent changes that are part of the
base line TRIANGLE RUNOFF, ARAP has added a number of
features to RUNOFF to enable us to produce technical reports.
We required support for greek characters, extended sub/super
script capability, ability to produce very complex
mathematical equations etc. We have successfully been using RUNOFF
in conjunction with a screen editor to produce reports on a
production basis. Some of the features include:
a) Support for Greek/Math character set. Output is produced
on a DIABLO 1640 in two passes. Lines up amazingly well.
Implemented with meta-characters like underline function.
b) Super/subscripts adjustable in 1/8 line increments. Can
set to super/sub 3/8 line instead of 1/2 and change
amount througout document as needed. (meta-characters)
c) Line spacing adjustable to 1/8 line (.SP) and also
.BLANK can use 1/8 spacing. e.g. .BLANK 1+5/8
d) Overbar function, implemented similar to underline.
Adjusts to highest superscipt to be overscored.
e) Equation mode command. Allows reasonable description
of equations, set spacing around equation, sets line
spacing (to 1/8), allows '#' to be horizontal half-space
for aligning 1 character above 2 (a/bc) for example.
f) Justified output uses a horizontal half-space to fill.
g) Overstrike ability using backspace, justifies properly.
h) String substitution definitions. Similar to the
numeric substituion, but allows strings within the text
to be identified and substituted for.
e.g .SUB ARAP = 'Aeronautical Research Associates of P'
Any occurence of ARAP within text will be substituted.
or | = <esc>Y to get a vertical bar on a QUME letter
Gothic print wheel.
The following is a brief description of the files used to build
and run RUNOFF. Most command files are in VAX command format but
should be easily changed for M or IAS. On the RSX sig tape the
files should be in [360,235].
XNOMAC.COM
To assemble all of the RUNOFF source modules. Uses
XNPRE.MAC which does not build for READ-ONLY psects.
Use RNPRE to build for READ-ONLY psects.
MAC.COM is used for the MACRO command line template.
XNO.CMD
TKB format task-build command file. (on Vax compatibility
mode. May want to edit the options for M or IAS.
TKB @XNO or MCR TKB @XNO
The .TSK or .EXE file is XNO but can be installed as RNO.
RNO.RNO
After RUNOFF is built the documentation can be produced
from this file. Use it as input to the newly built version
or RUNOFF -
MCR RNO output-spec=RNO
If you have a DIABLO specify the /DI/UL:L switches on the
RNO side. Output-spec can be a printer, terminal or file.
RNO.CMD
This is a command file we used on IAS for running RUNOFF.
It prompts for certain information and assists in
alligning paper on the second pass.
It also calls RNO.MCR and runs DEVUIC. This is specific
to the IAS command language but should be adaptable to M
if need-be.
RNO.COM
VMS version of RNO.CMD
RNOERR.COM
This command file creates the error message file from
the source error message file. RNOERR.MSG should be
placed on LB0:[1,2].
Note: VM users !
RUNOFFrefers to LB00 (two zeros) so ASSIGN
SYS$SYSDIK TO LB00: or RNOERR.MSG will not
be able to be accessed.
KEYBOARD.RNO
This RUNOFF file will print out the greek symbol layout
for the terminal keyboard. It is set to use the same
positions as and IBM selectric typewriter.
HYPHEN.MAC
I've substitued a null version of the hyphenation routine.
If you want to use the hyphenation feature, link in
HYPHEN.OBJ instead of XYPHEN.OBJ
Notes
This version of RUNOFF assumes you are using a QUME symbol-2 wheel
for the greek/math. Within XUNOFF.MAC is an alternate table to
map into the greek/math wheel Diablo makes. We have found the
QUME wheel to be more satisfactory and, works fine in the Diablo.
If you have questions or problems regarding RUNOFF after sifting through the
documentation etc., please feel free to call me.