[VAX81B.ARAP]AAAREADME.TXT
A.R.A.P. Submissions
Los Angeles, Fall 1981 - RSX/IAS and VAX SIG tape
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].
1. 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
Page 2
template.
2. XNO.CMD
TKB format task-build command file. In 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.
3. 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.
4. 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.
5. RNO.COM
VMS version of RNO.CMD
6. 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.
7. 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.
8. 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
Page 3
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.