						5826 Southwest Ave.
						St.Louis, MO 63139
						April 18, 1982

FILES
--------------------------------------------------------------------
CROWLINK:  These  are the linkages between CP/M and the  Crowe  Z-80 
assembler.   I bought this assembler two years ago from Byte Nybbles 
for  $4!   It  was available only as an assembly listing  and  so  I 
entered  it  manually in machine language.   The assembler is  quite 
good  providing  all the features of Zilog's  assembler  except  for 
macros,  conditional assembly and lower case.   It was written to be 
used  with  cassette  or paper tape,  with the desired  pass  number 
entered from the console.   For each pass, the source is re-read and 
the  appropriate output generated.   Pass 1 builds the symbol  table 
and is required.  Pass 2 outputs the assembly listing, pass 3 writes 
Intel  format  hex object and pass 4 gives an  assembly  listing  of 
those lines containing errors on the console.
     The  linkage routines are written so that the assembler can  be 
run  as a standard CP/M .COM file with the following command format. 
CROWEASM  FILENAME.YY   The characters in the normal file  extension 
position are Y/N selects (default is Y),  the first for listing file 
and the second for the hex object file.  The source must have a file 
extension of .Z80 while the listing is created with an extension  of 
 .PRN and the object with an extension of .HEX.   Only minimal error 
checking and reporting is done.   If no source file with the correct 
name is found a message is displayed.   If any other disk error on a 
BDOS  call occurs,  that is reported.   In either case,  the routine 
waits for a keystroke before exiting to CP/M.
___________________________________________________________________

	An additional note about the assembler the way it stands:  there
is a limit of 32 characters for a quoted string as operand of a DEFM
statement.  If this limit is exceeded NO error message is generated, the
string is truncated.  If you're not careful, the terminating '$' for
a CP/M output string could be lost and the results would be unpredictable.

___________________________________________________________________


	The CROWE.Z80 file has the linkages incorporated into it, near the
end.  As it now stands, the symbol table is limited only by the amount of
available memory since the assembler reads the start address of BDOS from
locations 6&7 and sets that as the top of available symbol space.  
	There has been one minor improvement to the assembler: you can now
specify that the .LST or .HEX files should be sent to drive B rather than
the current default drive by putting a B in the proper position in the 
normal filename extension.  E.g. CROWE2 CROWE.NB would assemble the file
CROWE.Z80, skip the .LST file and send the .HEX file to drive B.  The 
source file must still reside on the same drive as the assembler.
	The source is currently set up for the CROWE assembler.  To 
assemble it with M80 you will need to add ASEG and .Z80 commands to it.

John Jones

************************************************************************

But fixes from Thomas Hameenaho

The first bug resulted when the single quote character in EX AF,AF'
caused the assembler to expect the following characters
to be a text string. Now I test if the character preceding the ' is
a 'F', if so, the 'QUOTE' flag should not be set.

The other bug (LBFSZ-1) resulted because the minus character (instead
of the "_" character) was declared legal in a label.
Probably a typing error when entering the source code.

So now CROWE3.COM will assemble CROWE3.Z80.

	Thomas Hameenaho
	Djaknegatan 7
	S-754 23 Uppsala
	Sweden
