---------------------------------------------------------------------
- Some Quick Jaguar Notes on how to assemble Jaguar Programs..      -
-  Roine Stenberg '95                                              -
- Last update 951205 for V. 1.06                                    -
---------------------------------------------------------------------

1. To be sure that object lists and such are alligned to a 16 byte or 32
   byte in the Jaguars main ram, i use Devpac 3 CNOP directive as a macro.
   This way, the Atari standard dphase and phase are used. 

.dphase  MACRO
         CNOP 0,32
         ENDM

.phase   MACRO
         CNOP 0,16
         ENDM

2. When writing GPU program's and compiling with madmac from within
   Devpac 3's menu, use the command line %?
   This passes the filename to madmac automaticly. Of course you
   should have set the "Save files" to YES, as madmac reads the file from
   disk.
   To be able to link this file and later include it with "incbin" into
   the binary file assembled from Devpac, it is necessary to strip the
   headers with ALN, the Jaguar Linker.
   Command line to ALN linker should be -a 5000 5000 5000 -n %?
   The 5000 is just a dummy number. This way, the GPU code can be used:
   
;================================================================================================
gpuinit
	lea	gpucode,a0
	lea	gpucode_e,a1
	move.l	#$f03000,a2		* GPU local ram.
cloop	move.w	(a0)+,(a2)+
	cmp.l	a0,a1
	bne	cloop
	rts
	
gpurun
	move.l	#$f03000,$f02110	* GPU program counter
	move.l	#$1,$f02114		* Set GPUGO flag
	rts

gpucode
	incbin		"gpu.abs"	* Output from Madmac, linked
					* with ALN.
gpucode_e

;================================================================================================

3. The Jaguar server software accepts command lines also. If you output
   a filename named "L:\JAGTEST.JAG" from Devpac, command line to Jaguar
   Server should be "L:\JAGTEST.JAG -Q". The "-Q" is optional, and will
   cause Jaguar Server to return to Devpac, right after uploading.
   
Well, that was some notes that popped up right now. Hope they are at
least a little bit usefull....
