summaryrefslogtreecommitdiffstats
path: root/development/z88dk/man/z80asm.1
blob: d993446e1e337ef03776f3a7814cc37aac924a0b (plain)
.\"Text automatically generated by txt2man
.TH z80asm 1 "01 December 2009" "" "z88 Development Kit"
.SH NAME
\fBz88dk-z80asm \fP- Z80 assembler compiler.
.SH SYSNOPIS
z88dk-z80asm [options] [ @<modulefile> | {<filename>} ]
.SH 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.
.PP
z88dk-z80asm is a Z80 assembler cross compiler.
.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.
.SH OPTIONS
.TP
.B
\fB-h\fP
display help
.TP
.B
\fB-n\fP
defines option to be turned OFF (except \fB-r\fP \fB-R\fP \fB-i\fP \fB-x\fP \fB-D\fP \fB-t\fP \fB-o\fP)
.TP
.B
\fB-v\fP
verbose
.TP
.B
\fB-l\fP
listing file
.TP
.B
\fB-s\fP
symbol table,
.TP
.B
\fB-m\fP
map listing file
.TP
.B
\fB-r\fP<ORG>
Explicit relocation <ORG> defined in hex (ignore ORG in first module)
.TP
.B
\fB-plus\fP
Interpret 'Invoke' as RST 28h
.TP
.B
\fB-R\fP
Generate relocatable code (Automatical relocation before execution)
.TP
.B
\fB-D\fP<symbol>
define symbol as logically TRUE (used for conditional assembly)
.TP
.B
\fB-b\fP
assemble files & link to ORG address. \fB-c\fP split code in 16K banks
.TP
.B
\fB-d\fP
date stamp control, assemble only if source file > object file
\fB-a\fP: \fB-b\fP & \fB-d\fP (assemble only updated source files, then link & relocate)
.TP
.B
\fB-o\fP<bin filename>
expl. output filename, \fB-g\fP XDEF reloc. addr. from all modules
.TP
.B
\fB-i\fP<library>
include <library> LIB modules with .obj modules during linking
.TP
.B
\fB-x\fP<library>
create library from specified modules ( e.g. with @<modules> )
.TP
.B
\fB-t\fP<n>
tabulator width for .map, .def, .sym files. Column width is 4 times \fB-t\fP
.PP
Default options: \fB-nv\fP \fB-nd\fP \fB-nb\fP \fB-nl\fP \fB-s\fP \fB-m\fP \fB-ng\fP \fB-nc\fP \fB-nR\fP \fB-t8\fP
.SH SEE ALSO
\fBz88dk\fP(1), \fBz88dk-zcc\fP(1), \fBz88dk-z80asm\fP(1), \fBz88dk-appmake\fP(1), \fBz88dk-copt\fP(1).
.RE
.PP

.SH AUTHOR
z88dk was written by Dominic Morris <dom@z88dk.org>, and others.
z80asm was written by Gunther Strube <gbs@image.dk>.
This manual page was written by Krystian Wlosek <tygrys@waw.pdi.net> using exists documentation, for the Debian GNU/Linux system.