Please refer to the z88dk documentation in /usr/share/doc/z88dk-doc for the complete description of the system. If /usr/share/doc/z88dk-doc not exists, please install the package z88dk-doc.

The frontend of z88dk is called zcc, it is this that you should call if you want to do any compilations.

The files can be either C files (.c), preprocessed C files(.i), compiled C files (.asm), optimised compiled file (.opt) or assembled files (.obj), any combination of them can be mixed together and the relevant processed done on them.

Processing of a file list is done on each file in turn (i.e. preprocess, compile, optimise, assemble) at the end all files may be linked into a single executable if desired.

   Predefined alternate configs:


     abc80        ABC80


     aceansi      Jupiter ACE, using VT-ANSI engine


     cpm          CP/M


     msx          MSX 1


     mz           Sharp MZ


     mzansi       Sharp MZ, using VT-ANSI


     nc           Amstrad NC100


     rex          REX 6000


     sam          Sam Coupe


     svi          Spectravideo SVI


     m5           SORD M5


     ti82         Ti82, using ROM text routines


     ti82ansi     Ti82, using VT-ANSI


     ti83         Ti83, using ROM text routines


     ti83ansi     Ti83, using VT-ANSI


     ti85         Ti85, using ROM text routines


     ti85ansi     Ti85, using VT-ANSI


     ti86         Ti86, using ROM text routines


     ti86ansi     Ti86, using VT-ANSI


     ti8x         Ti83+, using ROM text routines


     [ti8xansi]   Ti83+, using VT-ANSI


     vz           VZ / Laser 200


     vzansi       VZ / Laser 200, using VT-ANSI


     z88          Cambridge Z88


     z88ansi      Cambridge Z88, using VT-ANSI


     z88net       Cambridge Z88 with TCP/IP


     zx           ZX Spectrum


     zx81         ZX 81


     zx81ansi     ZX 81, using VT-ANSI


     zxansi       ZX Spectrum, using VT-ANSI

Options to control library usage:

-l[name]

Link in a library - supply just the name (after placing them in the correct directory).

      The 'name' are:


      farz88       Z88 far support


      gfx          Z88 BASIC graphics lib


      gfxapp       Z88 application graphics lib


      m            Generic math routines


      malloc       Generic near malloc routine


      mz           OZ's math routines


      ndos         Fake file-routines, return errors only


      net          Z88 socket routines for ZSock


      netdev       Z88 socket routines for devices


      p3           +3 file support library


      tigray82     Ti82 graylib routines


      tigray83     Ti83 graylib routines


      tigray83p    Ti83+ graylib routines


      tigray85     Ti85 graylib routines


      tigray86     Ti86 graylib routines


      z88          Some Z88 application routines, like mailboxing


      zxmath       ZX Spectrum ROM based math routines


      zxvgs        ZXVGS hardware support

-m

Generate .map files when assembling/linking

Options to control the type code produced:

-unsigned

Implicitly define everything as unsigned unless explicitly told otherwise.

-create-app

Create an application image (i.e. bank 63,62 etc)

-make-app

(App) Notify the compiler that you're trying to make an application

-reqpag=

(App) Number of 256 byte pages required for bad application

-zorg=

(App) Origin for a Z88 application

-safedata=

(App) Amount of safedata required by your code

-defvars=

(App) Where static variables should be dropped (only valid for single file compilations, but see later)

-expandz88

(App) Expanded z88 required -no-expandz88 (App) Expanded z88 not required (these two flags toggle some startup code to check for an expanded machine)

-startup=3

Produce standalone code that can be run from a set address from BASIC. Use -zorg= to change the address

-R

(Use with above) produces relocatable code that can be loaded into a DIM'd BASIC array.

-smartpf

Intelligent printf routine handling

-no-smartpf

Turn off the intelligent printf handling

-make-lib

Shortcut to generate .o files from library .c files

-stackoffset

Sets the stack offset for shared libs (see package.txt for details)

Miscellaneous options:

-z80-verb

Allow z80asm to be verbose, this tends to generate a lot of output to the screen so may not be desired.

-cc

Intersperse C code as comments in the assembler output, warning: this *will* clobber some optimizations.

-Wall

Turn on all the compiler warnings

-Wnone

Turn off all compiler warnings

-Wn[num]

Turn off the compiler warning [num]

-W[num]

Turn on the compiler warning [num]

-asxx

Cause the compiler to emit asxx compatible code

-Cp[option]

Pass an option through to the pre-processor

-Ca[option]

Pass an option through to the assembler

In addition, the flags, -D, -I, -U are passed through to the preprocessor.