              Documentation of the Editor/Assembler Utilities
                (c)82-83 by Mary Bell, Mu Alpha Beta Assoc.

General information:
These utilities are for use with the Editor/Assembler program as supplied 
with NEWDOS-80 version 2 or higher. All programs load at the location of 
7000 hex in memory, and should not be moved to other areas or improper 
operation may result.

System Requirements: 
32K or 48K RAM
1-4 disk drives
Model I/III
NEWDOS-80 version 2
EDTASM version 1.1

--------------------------------------------------------------------------
 
Utility GETSYM/CMD 
This program will recover the symbol table present in memory after EDTASM 
has completed an assembly operation, producing a text file for the purposes 
of chaining multiple modules together.  Symbols that are not defined or are 
defined as zero are not included in the output listing, so as to avoid 
multiple definition errors on the next assembly. 

Specific directions: 
1. Use the Editor/Assembler to perform an assembly with the following 
   switches;
       A.  Do not use the /WE switch to pause on assembly errors.
       B.  Use the /NO switch to prevent the Editor/Assembler from 
           producing a binary output.
    (While using or not using the above does not affect utility operation, 
      they will slow down the assembly and resulting output.)
2. Use the EDTASM command of "B" to return to NEWDOS.
3. Enter the command of GETSYM
4. Enter a filespec for the text listing; MYTEXT/SYM
5. Restart the EDTASM.
6. Load the file generated. Add in any known Zero defined symbols.
7. Load the next assembly module with the CONCATENATE option.
8. Go to step 1 as required.

Limits: 
All text, symbol list and module(s) must be capable of fitting into 
available memory during the EDTASM assembly operation, and must have space 
upon the disk fort storage. Multiple diskettes may be used, but the EDTASM 
program is limited to the system memory available only.

Notes:
This program relies on memory based information produced by the EDTASM 
package, such that its operation must be performed after running EDTASM and 
before running any other program that may alter the information, including 
that of a reset or power down operation.

--------------------------------------------------------------------------

Utility SPLIT/CMD
This program is designed to be used in conjunction with NEWDOS-80's 
DISASSEM/CMD which produces the source text of any program written for the 
Z80.  Because these listings are often quite large to the point of filling 
available disk space, these listings cannot be used with the 
Editor/Assembler for reproduction or modification of the source module as 
they stand.  This utility will split apart such listings into 1000 line 
files, allowing the multiple assembly chaining of the source together as 
listed for GETSYM/CMD.

Specific directions: 
1. Use the DISASSEM/CMD program to produce the source listing desired to be 
   examined. Use the G option to assign symbols generated names, and F to 
   dump the output to a file.
2. Enter the command of SPLIT
3. Specify the source filespec.
4. Specify the starting destination filespec;
   Note: destination filespecs are specified with a single at-sign (@) 
   contained in the name; e.g., MYTEXT@/TXT. The SPLIT program will use the 
   at-sign as the rotating filespec digit, producing the files of MYTEXTA, 
   MYTEXTB, MYTEXTC, and so on.
5. Upon completion, the program will exit.

Limits:
There must enough disk space for the output files in addition to the 
source file. Use of a 3 disk or more system is recommended for very 
lengthly sources.

--------------------------------------------------------------------------

Utility EDTXFR/CMD
This program transfers EDTASM text files to and from a tape cassette and a 
DOS disk for use by both the tape and disk versions of the EDTASM program.
The utility may also be used to transfer EDASM text files between two 
TRS-80's using the cassette port as the common medium. During operation, 
the program will list the contents of the file being transferred on the 
screen as it is moved into and out of memory for verification of contents.

Specific directions: 
1.  Enter command of EDTXFR
2.  Enter the mode; 1 for tape to disk, 2 for disk to tape.
3.  Enter the filespec or start tape.  In tape to disk operation, the 
    filespec is taken from the cassette listed name.

Limits:
File listing must fit into available memory and target disk must have space 
available to contain result.

--------------------------------------------------------------------------
-end of file-
