mirror of
https://github.com/Ponce/slackbuilds
synced 2024-11-24 10:02:29 +01:00
development/z88dk: Added (C cross compiler targetting the Z80).
Signed-off-by: David Spencer <idlemoor@slackbuilds.org>
This commit is contained in:
B. Watson
Willy Sudiarto Raharjo
parent
07d87cae39
commit
19e983380b
9 changed files with 900 additions and 0 deletions
12
development/z88dk/README
Normal file
12
development/z88dk/README
Normal file
|
|
@ -0,0 +1,12 @@
|
|||
z88dk (C cross compiler targetting the Z80)
|
||||
|
||||
z88dk is a z80 C cross compiler supplied with an assembler/linker and
|
||||
a set of libraries implementing the C standard library for a number of
|
||||
different z80 based machines. The name z88dk originates from the time when
|
||||
the project was founded and targetted only the Cambridge z88 portable.
|
||||
|
||||
Very little documentation is shipped with z88dk, and what's present is
|
||||
often outdated. For more extensive and updated docs, see the z88dk wikis:
|
||||
|
||||
https://github.com/z88dk/z88dk/wiki
|
||||
https://www.z88dk.org/wiki/doku.php
|
||||
272
development/z88dk/man/appmake.1
Normal file
272
development/z88dk/man/appmake.1
Normal file
|
|
@ -0,0 +1,272 @@
|
|||
.\"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.
|
||||
79
development/z88dk/man/copt.1
Normal file
79
development/z88dk/man/copt.1
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
.\"Text automatically generated by txt2man
|
||||
.TH copt 1 "01 December 2009" "" "z88 Development Kit"
|
||||
.SH NAME
|
||||
\fBcopt \fP- peephole optimizer
|
||||
.SH SYSNOPIS
|
||||
copt file \.\.\.
|
||||
.SH DESCRIPTION
|
||||
copt is a general-purpose peephole optimizer. It reads
|
||||
code from its standard input and writes an improved version to its standard output.
|
||||
copy reads the named files for its optimizations, which are encoded as follows:
|
||||
.PP
|
||||
.nf
|
||||
.fam C
|
||||
<pattern for input line 1>
|
||||
<pattern for input line 2>
|
||||
\.\.\.
|
||||
<pattern for input line n>
|
||||
=
|
||||
<pattern for output line 1>
|
||||
<pattern for output line 2>
|
||||
\.\.\.
|
||||
<pattern for output line m>
|
||||
<blank line>
|
||||
|
||||
.fam T
|
||||
.fi
|
||||
Pattern matching uses literal string comparison, with one
|
||||
exception: ``%%'' matches the ``%'' character, and ``%''
|
||||
followed by a digit matches everything up to the next
|
||||
occurrence of the next pattern character, though all
|
||||
occurrences of %\fIn\fP must denote the same string. For example,
|
||||
the pattern ``%1=%1.'' matches exactly those strings
|
||||
that begin with a string X, followed by a ``='' (the
|
||||
first), followed by a second occurrence of X, followed by
|
||||
a period. In this way, the input/output pattern
|
||||
.PP
|
||||
.nf
|
||||
.fam C
|
||||
mov $%1,r%2
|
||||
mov *r%2,r%2
|
||||
=
|
||||
mov %1,r%2
|
||||
|
||||
.fam T
|
||||
.fi
|
||||
commands copt to replace runs like
|
||||
.PP
|
||||
.nf
|
||||
.fam C
|
||||
mov $_a,r3
|
||||
mov *r3,r3
|
||||
|
||||
.fam T
|
||||
.fi
|
||||
with
|
||||
.PP
|
||||
.nf
|
||||
.fam C
|
||||
mov _a,r3
|
||||
|
||||
.fam T
|
||||
.fi
|
||||
Note that a tab or newline can terminate a %\fBn\fP variable.
|
||||
.PP
|
||||
copt compares each run of input patterns with the current
|
||||
input instruction and its predecessors. If no match is
|
||||
found, it advances to the next input instruction and tries
|
||||
again. Otherwise, it replaces the input instructions with
|
||||
the corresponding output patterns, pattern variables
|
||||
instantiated,and resumes its search with the \fIfirst\fP
|
||||
instruction of the replacement. copt matches input patterns
|
||||
in reverse order to cascade optimizations without
|
||||
backing up.
|
||||
.SH BUGS
|
||||
Errors in optimization files are always possible.
|
||||
.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.
|
||||
92
development/z88dk/man/z80asm.1
Normal file
92
development/z88dk/man/z80asm.1
Normal file
|
|
@ -0,0 +1,92 @@
|
|||
.\"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.
|
||||
42
development/z88dk/man/z88dk.1
Normal file
42
development/z88dk/man/z88dk.1
Normal file
|
|
@ -0,0 +1,42 @@
|
|||
.\"Text automatically generated by txt2man
|
||||
.TH z88dk 1 "01 December 2009" "" "z88 Development Kit"
|
||||
.SH NAME
|
||||
\fBz88dk \fP- The z88 Development Kit.
|
||||
\fB
|
||||
.SH 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.
|
||||
.RE
|
||||
.PP
|
||||
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.
|
||||
.RS
|
||||
.PP
|
||||
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.
|
||||
.PP
|
||||
z88dk contains usable tools:
|
||||
.IP \(bu 3
|
||||
zcc - the frontend of z88dk is called zcc, it is this that you should call if you want to do any compilations.
|
||||
.IP \(bu 3
|
||||
z80asm - Z80 assembler compiler
|
||||
.IP \(bu 3
|
||||
copt - Z80 asm optimizer code
|
||||
.IP \(bu 3
|
||||
appmake - produce files which are suitable for use in emulators or on the real hardware
|
||||
.IP \(bu 3
|
||||
sccz80 - Small-C/Plus compiler
|
||||
.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.
|
||||
This manual page was written by Krystian Wlosek <tygrys@waw.pdi.net> using exists documentation, for the Debian GNU/Linux system.
|
||||
255
development/z88dk/man/zcc.1
Normal file
255
development/z88dk/man/zcc.1
Normal file
|
|
@ -0,0 +1,255 @@
|
|||
.\"Text automatically generated by txt2man
|
||||
.TH zcc 1 "01 December 2009" "" "z88 Development Kit"
|
||||
.SH NAME
|
||||
\fBzcc \fP- The frontend of z88dk
|
||||
.SH SYSNOPIS
|
||||
zcc [flags] [files to be compiled/linked]
|
||||
.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.
|
||||
.RE
|
||||
.PP
|
||||
|
||||
.RS
|
||||
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
|
||||
The frontend of z88dk is called zcc, it is this that you should call
|
||||
if you want to do any compilations.
|
||||
.PP
|
||||
The files can be either C files (.c), preprocessed C \fBfiles\fP(.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.
|
||||
.PP
|
||||
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.
|
||||
.SH OPTIONS
|
||||
Options to control the action of the frontend:
|
||||
.TP
|
||||
.B
|
||||
+[file]
|
||||
Name of alternate config file (must be the first argument).
|
||||
.PP
|
||||
.nf
|
||||
.fam C
|
||||
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
|
||||
|
||||
.fam T
|
||||
.fi
|
||||
.TP
|
||||
.B
|
||||
\fB-a\fP
|
||||
Produce .asm (or .opt) file only
|
||||
.TP
|
||||
.B
|
||||
\fB-c\fP
|
||||
Do not link object files
|
||||
.TP
|
||||
.B
|
||||
\fB-E\fP
|
||||
Preprocess files only, leave output in .i file
|
||||
.TP
|
||||
.B
|
||||
\fB-o\fP [file]
|
||||
Specify output file for binary (default is a.bas for BASIC programs and a.bin for application binaries)
|
||||
.TP
|
||||
.B
|
||||
\fB-On\fP
|
||||
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 programs (includes certain lib functions to reduce size of \fBcode\fP(!))
|
||||
.TP
|
||||
.B
|
||||
\fB-v\fP
|
||||
Verbose - echo commands as they are executed
|
||||
.TP
|
||||
.B
|
||||
\fB-vn\fP
|
||||
Don't be verbose
|
||||
.RE
|
||||
.PP
|
||||
|
||||
|
||||
.RS
|
||||
Options to control library usage:
|
||||
.TP
|
||||
.B
|
||||
\fB-l\fP[name]
|
||||
Link in a library - supply just the name (after placing them in the correct directory).
|
||||
.PP
|
||||
.nf
|
||||
.fam C
|
||||
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
|
||||
|
||||
.fam T
|
||||
.fi
|
||||
.TP
|
||||
.B
|
||||
\fB-m\fP
|
||||
Generate .map files when assembling/linking
|
||||
.RE
|
||||
.PP
|
||||
|
||||
|
||||
.RS
|
||||
Options to control the type code produced:
|
||||
.TP
|
||||
.B
|
||||
\fB-unsigned\fP
|
||||
Implicitly define everything as unsigned unless explicitly told otherwise.
|
||||
.TP
|
||||
.B
|
||||
\fB-create-app\fP
|
||||
Create an application image (i.e. bank 63,62 etc)
|
||||
.TP
|
||||
.B
|
||||
\fB-make-app\fP
|
||||
(App) Notify the compiler that you're trying to make an application
|
||||
.TP
|
||||
.B
|
||||
\fB-reqpag\fP=
|
||||
(App) Number of 256 byte pages required for bad application
|
||||
.TP
|
||||
.B
|
||||
\fB-zorg\fP=
|
||||
(App) Origin for a Z88 application
|
||||
.TP
|
||||
.B
|
||||
\fB-safedata\fP=
|
||||
(App) Amount of safedata required by your code
|
||||
.TP
|
||||
.B
|
||||
\fB-defvars\fP=
|
||||
(App) Where static variables should be dropped (only valid for single file compilations, but see later)
|
||||
.TP
|
||||
.B
|
||||
\fB-expandz88\fP
|
||||
(App) Expanded z88 required
|
||||
\fB-no-expandz88\fP (App) Expanded z88 not required (these two flags toggle some startup code to check for an expanded machine)
|
||||
.TP
|
||||
.B
|
||||
\fB-startup\fP=3
|
||||
Produce standalone code that can be run from a set address from BASIC. Use \fB-zorg\fP= to change the address
|
||||
.TP
|
||||
.B
|
||||
\fB-R\fP
|
||||
(Use with above) produces relocatable code that can be loaded into a DIM'd BASIC array.
|
||||
.TP
|
||||
.B
|
||||
\fB-smartpf\fP
|
||||
Intelligent printf routine handling
|
||||
.TP
|
||||
.B
|
||||
\fB-no-smartpf\fP
|
||||
Turn off the intelligent printf handling
|
||||
.TP
|
||||
.B
|
||||
\fB-make-lib\fP
|
||||
Shortcut to generate .o files from library .c files
|
||||
.TP
|
||||
.B
|
||||
\fB-stackoffset\fP
|
||||
Sets the stack offset for shared libs (see package.txt for details)
|
||||
.RE
|
||||
.PP
|
||||
|
||||
|
||||
.RS
|
||||
Miscellaneous options:
|
||||
.TP
|
||||
.B
|
||||
\fB-z80-verb\fP
|
||||
Allow z80asm to be verbose, this tends to generate a lot
|
||||
of output to the screen so may not be desired.
|
||||
.TP
|
||||
.B
|
||||
\fB-cc\fP
|
||||
Intersperse C code as comments in the assembler output, warning:
|
||||
this *will* clobber some optimizations.
|
||||
.TP
|
||||
.B
|
||||
\fB-Wall\fP
|
||||
Turn on all the compiler warnings
|
||||
.TP
|
||||
.B
|
||||
\fB-Wnone\fP
|
||||
Turn off all compiler warnings
|
||||
.TP
|
||||
.B
|
||||
\fB-Wn\fP[num]
|
||||
Turn off the compiler warning [num]
|
||||
.TP
|
||||
.B
|
||||
\fB-W\fP[num]
|
||||
Turn on the compiler warning [num]
|
||||
.TP
|
||||
.B
|
||||
\fB-asxx\fP
|
||||
Cause the compiler to emit asxx compatible code
|
||||
.TP
|
||||
.B
|
||||
\fB-Cp\fP[option]
|
||||
Pass an option through to the pre-processor
|
||||
.TP
|
||||
.B
|
||||
\fB-Ca\fP[option]
|
||||
Pass an option through to the assembler
|
||||
.PP
|
||||
In addition, the flags, \fB-D\fP, \fB-I\fP, \fB-U\fP are passed through to the preprocessor.
|
||||
.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.
|
||||
This manual page was written by Krystian Wlosek <tygrys@waw.pdi.net> using exists documentation, for the Debian GNU/Linux system.
|
||||
19
development/z88dk/slack-desc
Normal file
19
development/z88dk/slack-desc
Normal file
|
|
@ -0,0 +1,19 @@
|
|||
# HOW TO EDIT THIS FILE:
|
||||
# The "handy ruler" below makes it easier to edit a package description.
|
||||
# Line up the first '|' above the ':' following the base package name, and
|
||||
# the '|' on the right side marks the last column you can put a character in.
|
||||
# You must make exactly 11 lines for the formatting to be correct. It's also
|
||||
# customary to leave one space after the ':' except on otherwise blank lines.
|
||||
|
||||
|-----handy-ruler------------------------------------------------------|
|
||||
z88dk: z88dk (C cross compiler targetting the Z80)
|
||||
z88dk:
|
||||
z88dk: z88dk is a z80 C cross compiler supplied with an assembler/linker
|
||||
z88dk: and a set of libraries implementing the C standard library for a
|
||||
z88dk: number of different z80 based machines. The name z88dk originates
|
||||
z88dk: from the time when the project was founded and targetted only the
|
||||
z88dk: Cambridge z88 portable.
|
||||
z88dk:
|
||||
z88dk:
|
||||
z88dk:
|
||||
z88dk:
|
||||
119
development/z88dk/z88dk.SlackBuild
Normal file
119
development/z88dk/z88dk.SlackBuild
Normal file
|
|
@ -0,0 +1,119 @@
|
|||
#!/bin/sh
|
||||
|
||||
# Slackware build script for z88dk
|
||||
|
||||
# Written by B. Watson (yalhcru@gmail.com)
|
||||
|
||||
# Licensed under the WTFPL. See http://www.wtfpl.net/txt/copying/ for details.
|
||||
|
||||
# TODO: someday include the zsdcc stuff. Probably sometime after z88dk's
|
||||
# 2.0 release. If no 2.0 release exists by, say, the start of 2019, I'll
|
||||
# probably change this build so it works with a git snapshot instead
|
||||
# of a release. I'll admit, my motivation for that will be that I want
|
||||
# to have a C compiler that targets Pac-Man arcade hardware (the 1.99B
|
||||
# release doesn't, current git does).
|
||||
|
||||
PRGNAM=z88dk
|
||||
VERSION=${VERSION:-1.99B}
|
||||
BUILD=${BUILD:-1}
|
||||
TAG=${TAG:-_SBo}
|
||||
|
||||
if [ -z "$ARCH" ]; then
|
||||
case "$( uname -m )" in
|
||||
i?86) ARCH=i586 ;;
|
||||
arm*) ARCH=arm ;;
|
||||
*) ARCH=$( uname -m ) ;;
|
||||
esac
|
||||
fi
|
||||
|
||||
CWD=$(pwd)
|
||||
TMP=${TMP:-/tmp/SBo}
|
||||
PKG=$TMP/package-$PRGNAM
|
||||
OUTPUT=${OUTPUT:-/tmp}
|
||||
|
||||
if [ "$ARCH" = "i586" ]; then
|
||||
SLKCFLAGS="-O2 -march=i586 -mtune=i686"
|
||||
LIBDIRSUFFIX=""
|
||||
elif [ "$ARCH" = "i686" ]; then
|
||||
SLKCFLAGS="-O2 -march=i686 -mtune=i686"
|
||||
LIBDIRSUFFIX=""
|
||||
elif [ "$ARCH" = "x86_64" ]; then
|
||||
SLKCFLAGS="-O2 -fPIC"
|
||||
LIBDIRSUFFIX="64"
|
||||
else
|
||||
SLKCFLAGS="-O2"
|
||||
LIBDIRSUFFIX=""
|
||||
fi
|
||||
|
||||
set -e
|
||||
|
||||
rm -rf $PKG
|
||||
mkdir -p $TMP $PKG $OUTPUT
|
||||
cd $TMP
|
||||
rm -rf $PRGNAM
|
||||
unzip $CWD/$PRGNAM-src-$VERSION.zip
|
||||
cd $PRGNAM
|
||||
|
||||
# Upstream permissions are bad. Please don't replace with "find . -L
|
||||
# ..." boilerplate.
|
||||
find . -name CVS -print0 | xargs -0 rm -rf
|
||||
find . -type f -print0 | xargs -0 chmod 0644
|
||||
find . -type d -print0 | xargs -0 chmod 0755
|
||||
chmod +x *.sh
|
||||
|
||||
# Sneaky ways to inject CFLAGS.
|
||||
sed -i "s/CC=gcc/CC='gcc $SLKCFLAGS'/" build.sh
|
||||
export CXX="g++ $SLKCFLAGS"
|
||||
|
||||
# Default prefix.
|
||||
sed -i "s,/usr/local,/usr," Makefile
|
||||
|
||||
# Upstream seems to be in the middle of migrating from /usr/lib to
|
||||
# /usr/share or vice versa. The compiler looks for stuff in lib that's
|
||||
# actually installed to share, if I don't do this:
|
||||
sed -i '/^prefix_share/s,/share,/lib,' Makefile
|
||||
|
||||
# Note to well-intentioned maintainers: please don't try to move
|
||||
# this stuff to /usr/lib64 on 64-bit systems. There's no native code
|
||||
# (no ELF executables, no shared or static libraries full of x86_64
|
||||
# code). Everthing in /usr/lib/z88dk is either headers, source, or
|
||||
# z88dk's own .lib format for z80 object code. From Linux's point
|
||||
# of view, it's just data. It's no different from Pat keeping udev
|
||||
# rules in /lib/udev on 64-bit.
|
||||
|
||||
# Parallel make of the compiler itself works OK, but not of the
|
||||
# z80 native libraries.
|
||||
sed -i '/^\$MAKE *-e/aexport MAKEFLAGS="-j1"' build.sh
|
||||
|
||||
./build.sh
|
||||
|
||||
# install-libs doesn't seem to support DESTDIR.
|
||||
make install prefix=$PKG/usr
|
||||
make install-libs prefix=$PKG/usr
|
||||
|
||||
# 'make install' doesn't install everything the compiler needs...
|
||||
# Trying to build the examples I got "sh: zpragma: command not found".
|
||||
cp -a bin/* $PKG/usr/bin/
|
||||
|
||||
# strip strips everything but chokes on the perl script.
|
||||
strip $PKG/usr/bin/* 2>/dev/null || true
|
||||
|
||||
# man pages from Debian:
|
||||
# http://http.debian.net/debian/pool/main/z/z88dk/z88dk_1.8.ds1-10.debian.tar.gz
|
||||
# They're for an older version of z88dk, and there's not a complete
|
||||
# set of them, but it's better than nothing I hope.
|
||||
mkdir -p $PKG/usr/man/man1
|
||||
for i in $CWD/man/*.1; do
|
||||
gzip -9c < $i > $PKG/usr/man/man1/$( basename $i ).gz
|
||||
done
|
||||
|
||||
mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
|
||||
cp -a README* LICENSE EXTENSIONS doc examples support \
|
||||
$PKG/usr/doc/$PRGNAM-$VERSION
|
||||
cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild
|
||||
|
||||
mkdir -p $PKG/install
|
||||
cat $CWD/slack-desc > $PKG/install/slack-desc
|
||||
|
||||
cd $PKG
|
||||
/sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.${PKGTYPE:-tgz}
|
||||
10
development/z88dk/z88dk.info
Normal file
10
development/z88dk/z88dk.info
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
PRGNAM="z88dk"
|
||||
VERSION="1.99B"
|
||||
HOMEPAGE="https://www.z88dk.org/forum/"
|
||||
DOWNLOAD="http://downloads.sourceforge.net/project/z88dk/z88dk/1.99B/z88dk-src-1.99B.zip"
|
||||
MD5SUM="6412a730d1b38a8ecf393683981a33ae"
|
||||
DOWNLOAD_x86_64=""
|
||||
MD5SUM_x86_64=""
|
||||
REQUIRES=""
|
||||
MAINTAINER="B. Watson"
|
||||
EMAIL="yalhcru@gmail.com"
|
||||
Loading…
Reference in a new issue