Note� o� Assembler� an� Linkers
                           Jo� Wright
                          1� Jun� 1990

I� �m� ow� wor� an� play� � us� � combinatio� o� �assembler� �an� �
linker� fo� variou� purposes�  

AS�       CP/M'� simpl� i808� assemble�      AS� .� HE�
MA�       CP/M'� Macr� i808� assemble�       AS� .� HE�
RMA�      CP/M'� Relocatin� Macr� assemble�  AS� .� RE�

SLRMA�    SL� Supe� i808� Macr� assemble�    MA� .� REL/HEX/COM
M8�       MicroSof� 8080/Z8� Macr� assemble� ASM/MA�/Z80 .� REL

Z80AS�    SL� Supe� Z8� Macr� assemble�      Z8� .� REL/HEX/COM
Z80ASM�   SL� Supe� Z8� Virtua� assemble�    Z8� .� REL/HEX/COM
ZMA�      A� Hawley'� Z8� Macr� assemble�    Z8� .� REL


MLOA�     Ro� Fowler'� HE� fil� loade�       HE� .� COM/BIN
LIN�      CP/M'� Linke�                      RE� .� COM/SRL/PRL
L8�       MicroSoft'� Linke�                 RE� .� COM/BIN
SLRN�     SL� Memor� base� Linke�            RE� .� COM/BIN
SLRNK�    SL� Virtua� Linke�                 RE� .� COM/BIN
ZM�       A� Hawley'� Linke�                 RE� .� COM/SRL/PRL

I� �general� �FILE.AS� �file� ar� i808� sourc� �file� �whic� �ar� �
complet� �i� an� o� themselves�  FILE.MA� file� ar� i808� �sourc� �
whic� us� th� Libraries� Z3LIB� SYSLIB� etc�  FILE.Z8� file� �ar� �
Zilo� Z8� sourc� whic� ma� us� th� Libraries.

Wit� th� exceptio� o� AS� an� MAC� al� o� th� assembler� �produc� �
MicroSof� RE� (MREL� file� and� wit� th� exceptio� o� MLOAD� �al� �
th� linker� wil� accep� MRE� a� input�  Thi� allow� � certai� mi� �
an� �matc� �o� assemble� an� linke� dependin� o� whic� �o� �thei� �
feature� i� desired�  

� �usuall� us� th� SL� product� becaus� the� ar� s� �muc� �faste� �
tha� th� other� an� satisf� m� NEE� fo� SPEED�  � us� th� �other� �
fo� �variou� reasons� largel� t� ensur� tha� m� sourc� file� �ar� �
compatibl� wit� assembler� an� linker� m� audienc� ma� have�  No� �
everyon� enjoy� suc� � ric� mi� o� produc� a� � do�  

Becaus� �M8� an� RMA� generat� si�-characte� publi� an� �externa� �
reference� �i� thei� MRE� output� � hav� configure� th� �SL� �an� �
ZMA� assembler� fo� si� significan� character� also�  

Assembler� �ar� �somewha� unique� on� fro� another� �an� �ca� �b� �
chose� fo� thei� particula� characteristics:

RMA� �ca� b� use� fo� 808� cod� i� mos� case� excep� �that� �lik� �
MAC� �imbedde� �'$� �i� �label� ar� ignore� �an� �no� �place� �i� �
externals�  Thi� make� i� impossibl� t� addres� F$OPEN� etc� �an� �
it� companio� fil� routine� i� SYSLIB.

�M8� �ca� �assembl� i808� an� z8� instruction� i� th� �sam� �file�  �
Thi� �ca� �b� mos� usefu� durin� progra� developmen� whe� �i� �i� �
usefu� t� 'fol� in� cod� writte� i� th� 'other� language.

SL� �assembler� �ar� muc� faste� tha� th� others� � Availabl� �i� �
bot� 808� an� z8� versions� the� ar� preferre� i� mos� cases�  

Linker� �ar� als� uniqu� an� shoul� b� chosen:

L8� an� SLRN� automaticall� plac� th� DSE� are� a� th� �beginnin� �
o� th� outpu� file�  Thi� i� terribl� inconvenien� i� mos� �case� �
tha� �us� DSE� i� CO� files�  I� yo� wan� i� elsewhere� �yo� �ca� �
declar� it� addres� o� th� comman� line.

LINK� �ZM� an� SLRNK� (i� yo� tel� it� wil� plac� DSE� �wher� �w� �
normall� �wan� �it� �immediatel� �followin� �CSEG� � Thes� �thre� �
linker� wil� als� creat� PR� an� SP� outpu� files�  SLRNK� ha� a� �
erro� �associate� wit� PR� an� SP� file� an� i� no� �reccommende� �
fo� thi� purpose.

                               end