z88dk(1) [debian man page]
z88dk(1) z88 Development Kit z88dk(1) NAME
z88dk - The z88 Development Kit. DESCRIPTION
The z88 Development Kit (hereafter known as z88dk) is an advanced set of tools allowing the production of complex programs for z80 based computers in either C or assembly language. The name z88dk originates from the time when the project was founded and targetted only the Cambridge z88 portable. The compiler featured in z88dk is much enhanced Small C compiler, the compiler accepts many features of ANSI C and is only deficient in a few areas where implementation on a z80 processor might prove inefficient. The compiler performs simple optimizations, but the bulk of the optimization is done by a set of peep-hole rules, which will typically reduce the size of a large project by up to a third. The libraries supplied with z88dk are designed to be as generic as possible, indeed it is possible to port to a new machine simply by supplying two library routines and some startup code. It is hoped that one day z88dk will support as many z80 based machines as there is information available and sufficient interest in. z88dk contains usable tools: o zcc - the frontend of z88dk is called zcc, it is this that you should call if you want to do any compilations. o z80asm - Z80 assembler compiler o copt - Z80 asm optimizer code o appmake - produce files which are suitable for use in emulators or on the real hardware o sccz80 - Small-C/Plus compiler SEE ALSO
z88dk(1), z88dk-zcc(1), z88dk-z80asm(1), z88dk-appmake(1), z88dk-copt(1). AUTHOR
z88dk was written by Dominic Morris <dom@z88dk.org>, and others. This manual page was written by Krystian Wlosek <tygrys@waw.pdi.net> using exists documentation, for the Debian GNU/Linux system. 01 December 2009 z88dk(1)
Check Out this Related Man Page
zcc(1) z88 Development Kit zcc(1) NAME
zcc - The frontend of z88dk SYSNOPIS
zcc [flags] [files to be compiled/linked] DESCRIPTION
This manual page documents briefly the z88dk tools. This manual page was written for the Debian GNU/Linux distribution (but may be used by others), because the original program does not have a manual page. 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. OPTIONS
Options to control the action of the frontend: +[file] Name of alternate config file (must be the first argument). 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 -a Produce .asm (or .opt) file only -c Do not link object files -E Preprocess files only, leave output in .i file -o [file] Specify output file for binary (default is a.bas for BASIC programs and a.bin for application binaries) -On Optimize compiler output (to .opt file) n can be either 0 (none) 1,2,3, level 2 is recommended. Level 3 is suitable for large pro- grams (includes certain lib functions to reduce size of code(!)) -v Verbose - echo commands as they are executed -vn Don't be verbose 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. SEE ALSO
z88dk(1), z88dk-zcc(1), z88dk-z80asm(1), z88dk-appmake(1), z88dk-copt(1). AUTHOR
z88dk was written by Dominic Morris <dom@z88dk.org>, and others. This manual page was written by Krystian Wlosek <tygrys@waw.pdi.net> using exists documentation, for the Debian GNU/Linux system. 01 December 2009 zcc(1)