z88dk-copt(1) [debian man page]

copt(1) 							z88 Development Kit							   copt(1)

NAME

       copt - peephole optimizer

SYSNOPIS

       copt file ...

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:

		 <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>

       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 %n 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

		 mov $%1,r%2
		 mov *r%2,r%2
		 =
		 mov %1,r%2

       commands copt to replace runs like

		 mov $_a,r3
		 mov *r3,r3

       with

		 mov _a,r3

       Note that a tab or newline can terminate a %n variable.

       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 vari-
       ables  instantiated,and	resumes  its search with the first instruction of the replacement. copt matches input patterns in reverse order to
       cascade optimizations without backing up.

BUGS

       Errors in optimization files are always possible.

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.

								 01 December 2009							   copt(1)

z80asm(1)							z88 Development Kit							 z80asm(1)

NAME

       z88dk-z80asm - Z80 assembler compiler.

SYSNOPIS

       z88dk-z80asm [options] [ @<modulefile> | {<filename>} ]

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.

       z88dk-z80asm is a Z80 assembler cross compiler.

       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.

OPTIONS

       -h     display help

       -n     defines option to be turned OFF (except -r -R -i -x -D -t -o)

       -v     verbose

       -l     listing file

       -s     symbol table,

       -m     map listing file

       -r<ORG>
	      Explicit relocation <ORG> defined in hex (ignore ORG in first module)

       -plus  Interpret 'Invoke' as RST 28h

       -R     Generate relocatable code (Automatical relocation before execution)

       -D<symbol>
	      define symbol as logically TRUE (used for conditional assembly)

       -b     assemble files & link to ORG address. -c split code in 16K banks

       -d     date  stamp  control,  assemble only if source file > object file -a: -b & -d (assemble only updated source files, then link & relo-
	      cate)

       -o<bin filename>
	      expl. output filename, -g XDEF reloc. addr. from all modules

       -i<library>
	      include <library> LIB modules with .obj modules during linking

       -x<library>
	      create library from specified modules ( e.g. with @<modules> )

       -t<n>  tabulator width for .map, .def, .sym files. Column width is 4 times -t

       Default options: -nv -nd -nb -nl -s -m -ng -nc -nR -t8

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.  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.

								 01 December 2009							 z80asm(1)