EDMAC Version 1.1 June 15, 1987

COPYRIGHT 1987
by
ABACUS Computer Service
Donald J. Jackowski
16 Green Road
Mine Hill, NJ 07801
(201) 584-8201
All Rights Reserved

INTRODUCTION
EDMAC is a utility program that will allow a user to EDit a
WordPerfect MACro file using the WordPerfect key strokes which
are translated into human readable form. It can also be used via
the -s option to simply display the contents of a macro file in
human readable form. The numeric values will be displayed in
addition to the human readable description when the -d or -dd
option is given.

USAGE
The EDMAC program usage is:
EDMAC [-sndd] file ...
Where:
-s = Show file contents ONLY. (No Edit)
-n = add line Numbers to the -s output.
-d = Debug, show Decimal numeric values.
-dd = Debug, show Decimal, Hex, and Octal values.

When EDMAC is invoked with no arguments or if invalid
options are given, a short menu is displayed. When EDMAC is
invoked with filenames, each file name, file date and time is
displayed on a header line, which is immediately followed by the
first ten lines of the file followed by the editing status/prompt
line or if the -s option was given entire contents of the file is
displayed.

EDITING MACRO FILES
Edit mode is the default mode of EDMAC, that is if the -s
option is not given, edit mode is assumed. This editor is a line
editor in that it deals with the macro file in units of lines,
strings of characters ending with a 10 (^J) character or in
Wordperfect parlance the [HRt] character. Both the [HRt] and
[SRt] characters are recognized as End-Of-Line characters, as is
the End-Of-File condition since some macros simply terminate
without an ending EOL character.

The first operation of the editor is to rename the input
file with a .BAK file type. It then opens a new file with the
original file name, this file becomes the output file.

At initial start up EDMAC displays the first 10 lines of the
input file, which are also copied into the edit buffer. The
first line in the edit buffer becomes the current line, that line
is then displayed along with the status/prompt line:

(FILE.MAC 1 More) A,I,C,D,+,-,S,L,R,W,Q,?:

Where it waits for keyboard input. The left hand part of this
line is the "status" portion and contains the file name, the

Copyright 1987 (C) by ABACUS Computer Service Page 1 of 4




EDMAC Version 1.1 June 15, 1987

current line number and a "More/EOF" flag to indicate when the
last block from the input file has been read. The right hand
part of the line is the "prompt" portion, which shows the
commands that the user can select here.

A warning message is displayed before the status/prompt line
whenever the free space in the edit buffer is less than 50 bytes.

MENU
The "?" command or any illegal command key will produce the
following short menu of commands:

EDMAC Edit MENU
A = Append Line AFTER current line.
I = Insert Line BEFORE current line.
C = Change current line.
D = Delete current line.
+ = Move current line Forward.
- = Move current line Backward.
S = Substitute String in current line.
L = List (display) entire buffer.
R = Read next line from input file, into end (bottom)
of buffer.
W = Write first (top) line of buffer to output file.
Q = Quit, write ALL buffer lines to output file.

EDMAC COMMANDS
Each of the Edit commands and command aliases (command keys
that are taken as equivalent) will be discussed below
A - Append a new line AFTER the current line, a second
prompt is displayed and then it waits for key board
input, as with all EDMAC input the actual WordPerfect
key strokes should be used. The human readable
description, identical to the output produced by the -s
option will be displayed in response to each key
stroke. Input mode is terminated with the RETURN/ENTER
key or the Alt-9 key. (Alias: A, a).

I - Insert a new line BEFORE the current line, a second
prompt is displayed and the operation is otherwise
identical to the Append operation. (Alias: I, i,
"Ins")

C - Change current line, is really a Delete followed by an
Insert. It is included here for user convenience.
(Alias: C, c)

D - Delete current line, removes the current line from the
buffer. Causes the line numbers to be renumbered
appropriately. (Alias: D, d, "Del")

+ - Move the current line Forward. Selects as the
"current" line the next higher line. If the current
line is the last line in the buffer a message to that
effect is displayed and the current line remains
unchanged. The Q command should be used to get to
additional lines from the input file. (Alias: +, F, f,
"DownArrow", RETURN/ENTER)

Copyright 1987 (C) by ABACUS Computer Service Page 2 of 4




EDMAC Version 1.1 June 15, 1987

- - Move the current line Backward. Selects as the
"current" line the next lower line. If the current
line is the first line in the buffer a message to that
effect is displayed and the current line remains
unchanged. (Alias: -, B, b, "UpArrow")

S - Substitute String in current line. This operation is
similar to the UNIX "ed" command of the same name, i.e.
/old string/new string/
The current line is scanned for an occurrence of "old
string", if it is not found a message is displayed and
the operation is aborted. When "old string" is found
in the current line it is replaced by "new string".
(Alias: /, S, s)

L - List (display) the entire buffer. Each line in the
current buffer is displayed along with a line number.
The line numbers are the numbers you would expect to
see from the -sn option. (Alias: L, l)

R - Read next line from input file, into end (bottom) of
buffer. The R and W commands together provide a
mechanism for controlling the size of the current
buffer, and the length of the L command listing.
(Alias: R, r)

W - Write first (top) line of buffer to output file. This
command is similar to the Q command except this command
writes a SINGLE line to the output file. (Alias: W, w)

Q - Quit, write All buffer lines to the output file, and
read the next 10 lines from the input file. When the
last buffer is read from the input file the status line
"More" changes to "-EOF-". (Alias: Q, q)

KEYBOARD INPUT
The key strokes used as input to the buffer, namely the A,
I, C, and S commands, should be those key strokes required by
WordPerfect NOT the characters displayed on the screen. For
example the display: is the description of a
single character, the character produced by the Alt-F6 key
stroke. See the discussion of the "description string" under
OPERATION below for more details.

The Alt-0 (Alt-ZERO) key stroke can be used to input the
NULL character.

LINE NUMBERS
The line numbers shown in the list displayed by the L
command and the current line number displayed in the
status/prompt line are the numbers you would see if the file were
displayed using the -sn option. The line numbers are dynamically
adjusted to reflect inserted and deleted lines.






Copyright 1987 (C) by ABACUS Computer Service Page 3 of 4




EDMAC Version 1.1 June 15, 1987

OPERATION
EDMAC expects to find the full range of values from 0 to 255
in the macro files. The range of values from 0 through 31 are
CONTROL characters, with the exception of 9 the "tab", 10 the
"newline", and 13 the "return" characters. The range of values
32 through 126 are the printable ASCII characters. And the range
of values 127 through 255 are GRAPHIC characters.

The WordPerfect function keys and other operational keys are
represented in the macro files as values in the CONTROL and
GRAPHIC character ranges, printable ASCII characters are
represented as values in the usual 32 through 126 range and are
displayed by EDMAC as regular ASCII characters.

Values in the CONTROL and GRAPHIC ranges cause EDMAC to
display a "description string" except for cases where the
WordPerfect function is not known, in which case the ^A
convention for CONTROL characters, or the three digit decimal
numeric value for GRAPHIC characters is displayed.

The WordPerfect function/operation keys (the non-printable
CONTROL and GRAPHIC characters) are single byte values and since
EDMAC displays a variable number of characters in the
"description string", the description is ALWAYS displayed
surrounded by a pair of <> characters.

The "description string" consists of two parts. The first
part identifies the keyboard key that produced the character when
the macro was created. The FUNCTION keys all get two character
descriptions, where the first character is: C=Ctrl, S=Shft,
A=Alt, and F=Function. The second character is the numeric value
of the function key. None of the key descriptions contain the
'space' character. The second part is a WordPerfect functional
description. The first part is separated from the second by a
single 'space' character. Thus, if the Alt-F6 key were used in a
macro the EDMAC "description string" would be:


If the -d option was given the same Alt-F6 key would produce
the "description string":
<{181}A6 Flush right>
and the -dd option would produce:
<{181, B5, 265}A6 Flush right>

TRADEMARKS
WordPerfect is a registered trademark of WordPerfect
Corporation.

UNIX is a trademark of AT&T Bell Laboratories.

USER LICENSE
If you find this program useful you are requested to send a
$10 registration and license fee to ABACUS Computer Service.
This fee will entitle you to continue that use with a clear
conscience. If you don't use it, please pass a copy to a friend
who might! All registered users will receive notice of the first
update that is made after their registration.


Copyright 1987 (C) by ABACUS Computer Service Page 4 of 4