.\"Text automatically generated by txt2man
.TH appmake 1 "01 December 2009" "" "z88 Development Kit"
.SH NAME
\fBappmake \fP- The z88dk application generator
.SH SYSNOPIS
appmake [+target] [options]
.SH DESCRIPIONS
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.
.PP
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.
.PP
This program is used to produce files which are suitable for use in
emulators or on the real hardware.
.SH OPTIONS
Options used in all targets:
.TP
.B
\fB-h\fP
\fB--help\fP            Display help
.TP
.B
\fB-b\fP
\fB--binfile\fP [file]  Linked binary file
.TP
.B
\fB-o\fP
\fB--output\fP [name]   Name of output file
.RE
.PP

.RS
.TP
.B
+[target]
generate file for target machine.
Targets with additional options are:
.RS
.TP
.B
abc80
.TP
.B
ace
Generates a .byt file suitable for loading into emulators
.TP
.B
acetap
Generates a .TAP for the Ace32 emulator
.TP
.B
aquarius
Creates a BASIC loader file and binary stored in variable array format
.TP
.B
cpc
Gegerates file for Amstrad CPC
.PP
Additional options:
.RS
.TP
.B
\fB-c\fP
\fB--crt0file\fP [file]  crt0 file used in linking
.RS
.TP
.B
\fB--exec\fP [nnnn]
Location address to start execution
.TP
.B
\fB--org\fP [nnnn]
Origin of the binary
.RE
.RE
.TP
.B
hex
Creates an intel hex record suitable for embedded devices
.PP
Additional options:
.RS
.TP
.B
\fB--org\fP [nnnn]
Origin of the binary
.RE
.TP
.B
msx
Adds a file header to enable the program to be loaded using 'bload "file.bin",r
.TP
.B
mz
.TP
.B
nas
Generates a .NAS file suitable for use by emulators
.PP
Additional options:
.RS
.TP
.B
\fB--org\fP [nnnn]
Origin of the binary
.RE
.TP
.B
rex
.PP
Additional options:
.RS
.TP
.B
\fB-n\fP
\fB--appname\fP [name] Application Name
.TP
.B
\fB-c\fP
\fB--comment\fP [text] Application Comment
.RS
.TP
.B
\fB--nt\fP
Don't pad out to 8k addin
.RE
.RE
.TP
.B
ti82
Creates a .82p file
.PP
Additional options:
.RS
.TP
.B
\fB--comment\fP [text]
File comment (42 chars)
.RE
.TP
.B
ti83
Creates a .83p file
.PP
Additional options:
.RS
.TP
.B
\fB--comment\fP [text]
File comment (42 chars)
.RE
.TP
.B
ti8x
Creates a .8xp file
.PP
Additional options:
.RS
.TP
.B
\fB--comment\fP [text]
File comment (42 chars)
.RE
.TP
.B
ti85
Creates a .85p file
.PP
Additional options:
.RS
.TP
.B
\fB--comment\fP [text]
File comment (42 chars)
.RE
.TP
.B
ti86
Creates a .86p file
.PP
Additional options:
.RS
.TP
.B
\fB--comment\fP [text]
File comment (42 chars)
.RE
.TP
.B
ti86s
Creates a .86s file
.PP
Additional options:
.RS
.TP
.B
\fB--comment\fP [text]
File comment (42 chars)
.RE
.TP
.B
svi
Creates a .cas file loadable with the SVI emulator
.TP
.B
z88
Generates .63 and .62 files suitable for burning to EPROM
.PP
Additional options:
.RS
.TP
.B
\fB-c\fP
\fB--crt0file\fP [file]   crt0 file used in linking
.RS
.TP
.B
\fB--nt\fP
Do not truncate bank 63
.RE
.RE
.TP
.B
z88shell
Patches the header to ensure that the program is recognised by the shell
.PP
Additional options:
.RS
.TP
.B
\fB-c\fP
\fB--crt0file\fP [file]   crt0 file used in linking
.RE
.TP
.B
zxvgs
Creates a zxvgs application file
.PP
Additional options:
.RS
.TP
.B
\fB-c\fP
\fB--crt0file\fP [file]   crt0 file used in linking
.RE
.TP
.B
zx
Generates a .TAP file complete with BASIC header
.PP
Additional options:
.RS
.TP
.B
\fB-c\fP
\fB--crt0file\fP [file]    crt0 file used in linking
.RS
.TP
.B
\fB--org\fP [nnnn]
Origin of the binary
.TP
.B
\fB--blockname\fP [name]
Name of the code block in tap file
.SH SEE ALSO
\fBz88dk\fP(1), \fBz88dk-zcc\fP(1), \fBz88dk-z80asm\fP(1), \fBz88dk-appmake\fP(1), \fBz88dk-copt\fP(1).
.SH 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.