--- generator/INSTALL 2020/03/04 04:46:40 1.1 +++ generator/INSTALL 2020/03/04 04:46:56 1.1.1.3 @@ -16,9 +16,17 @@ Generator version This source can be compiled for three different types of interface: - --enable-svgalib - --enable-allegro - --enable-tcltk (deprecated - will re-write soon) + --with-svgalib + --with-allegro + --with-gtk + --with-tcltk (deprecated) + +One and only one of these options must be given to configure. + +The source also needs a z80 emulation: + + --with-raze (i386 assembler - uses nasm to compile) + --with-cmz80 (portable C) One and only one of these options must be given to configure. @@ -27,10 +35,33 @@ Example An example compilation: - ./configure --enable-svgalib --with-gcc=3 --prefix=/home/james + ./configure --with-gtk --with-raze --prefix=/home/james make make install +Cross compile +============= + +Generator's build tree should cope well with cross compilation. To +compile using djgpp/allegro use: + + PATH=/usr/i586-pc-msdosdjgpp/bin:$PATH ./configure --with-allegro \ + --with-raze --host=i586-pc-msdosdjgpp --build=i686-pc-linux-gnu \ + --with-coffasm + PATH=/usr/i586-pc-msdosdjgpp/bin:$PATH make + +The option --with-coffasm is for raze compilation - it does two things, +it switches to 'coff' output instead of 'elf' with nasm, and it also +modifies a macro in raze.asm that inserts underscores before all globals. + +Generator has two binaries 'def68k' and 'gen68k' that need to be run on +the host machine, so if you see the error: + + ./def68k: ./def68k: cannot execute binary file + +You will need to copy local versions of def68k and gen68k (that you compiled +earlier) into place so that the compilation can continue. + Basic Installation ==================