Jaguar Developer Software Distriution, 17-Nov-1993

Contents of the archive JAG2.ZIP (packed with ZIPJR V.2.2). To unpack use ZIPJR
on TOS machines or PKUNZIP on PC Combatibles. Both should work.

GULAM.PRG                       commandline shell
GULAM.G                         shell setup (adjust to your environment !)
BIN\ALN.PRG                     the Atari LiNker
BIN\AR68.PRG                    Atari librarian utility
BIN\BLIT.INC                    include file for blitter relevant defs
BIN\DOINDEX.TOS                 index file generator for libs
BIN\DUMP.PRG                    dumps object code
BIN\EMACS.TTP                   MicroEmacs programmers editor (see printed doc)
BIN\EMACS.RC                    some setup macros etc. for emacs
BIN\FILEFIX.TTP
BIN\GASM.PRG                    Jaguar GPU/DSP Assembler
BIN\JAGUAR.INC                  include file for jaguar relevant defs
BIN\LTXCONV.PRG                 Jaguar GPU file format converter
BIN\MAC.PRG                     MADMAC 68000 macro assembler
BIN\MAKE.TTP                    make utility
BIN\NM68.PRG
BIN\RDBJAG.TOS                  Remote DeBugger for JAGuar
BIN\SIZE68.PRG
BIN\STRIP68.TOS
BIN\REGDUMP.BIN                 
BIN\RDB.RC                      commands for db startup
BIN\OD.DB                       db support for db
BIN\GPU.DB                      gpu support for db
JAGUAR\EXAMPLES\BLITBLCK.S      sample for blitting a block
JAGUAR\EXAMPLES\BLITLINE.S      sample for blitting single line
JAGUAR\EXAMPLES\BLITSHAD.S      sample for blitting a shaded block
JAGUAR\EXAMPLES\BLITSKEW.S      sample for blitting a skewed block
JAGUAR\EXAMPLES\BLITSLNT.S      sample for blitting a slanted line
JAGUAR\EXAMPLES\CLEARJAG.S
JAGUAR\EXAMPLES\CLEARBAR.S      sample to clear object data
JAGUAR\EXAMPLES\CRY.PAL         palette for jagmand
JAGUAR\EXAMPLES\INTSERV.S       sample for 68k interrupt service
JAGUAR\EXAMPLES\JAGLINE.S	sample line draw
JAGUAR\EXAMPLES\JAGMAND.S       sample mandlebrod program
JAGUAR\EXAMPLES\LISTBAR.S       sample object list setup for all line samples
JAGUAR\EXAMPLES\JLISTER.S       sample onject list setup for jagmand
JAGUAR\EXAMPLES\MAKEFILE        makefile (adjust to your environment !)
JAGUAR\EXAMPLES\MANDLE.GAS      GPU code for main loop of mandelbrod
JAGUAR\EXAMPLES\MANDLE.S        sample mandelbrod program
JAGUAR\EXAMPLES\VIDINIT.S       video init stuff
JAGUAR\EXAMPLES\SIMPLE.S        mini sound demo using ROM wavetable/I2S Bus
JAGUAR\EXAMPLES\SIMPSYN.DAS     the DSP part of this sound demo

We highly recommend to use a machine running under MultiTOS and equipped
with a big monitor as frontend of a Jaguar development environment. In this
case, TCSH is recommended as a shell. We generally recommend EMACS as editor.

To meet the need for getting a working setup for users of less advanced
frontends we pack GULAM into this distribution, which meets the needs of
a programming environment.

NOTE: The MAKEFILE and the GULAM.G setup file will probably need to be edited
to adjust to your programming environment.

The versions of programs in this archive have been chosen with thought.
Please don't mixup versions. Changed version to the previous distribution 
are marked with an asterisk '*'. This archive contains:

GASM.PRG       V1.5.3
LTXCONV.PRG    V1.5
MAC.PRG        V2.02
ALN.PRG        V90/01/24
FILEFIX.TTP    V5
RDBJAG.TOS   * V93/08/06 

Most of the GEMDOS 68k programmers tools (NM68, DUMP68, SIZE68, AR68)
do not have version numbers and are likely to remain unchanged.

CHANGES 
-------
17-Nov-93 nbk

* Please always use the latest includefiles. Many old sample sources 
  are containing old video setup routines. The development system
  and machines now configure themselves. The newer VidInit routine
  therefore can run correctly on PAL and NTSC. Please stay as flexible
  as possible and adjust older sources.

* The previous problem of crashing on the attempt to unpack with the 
  V2.2 GEM-Shell-version of STZIP has been adjusted by slightly 
  changing the directory structure of the archive (though STZIP 
  has the bug).

* The demo sources did forget to set the stack. This is fixed.

* The demo sources stop the Object Processor first.

* The setup file GULAM.G does set RDBRC instead of HOMED to let RDBJAG 
  find its .RC file.
  
* By having more used pins in the parallel port compared to its 
  predecessors the old RDBJAG could not establish the communication
  beetween the ROM STUB in the developer machine and Falcon030 with
  the standard cable we deliver. We included a small routine in RDBJAG
  to set pin 17 to high if running on a Falcon030 and fixed this.
 
