
	See english version below.



			SPANISH VERSION.
			****************


	Aliados version preliminar.
	(C) 2004 Julian Albo.
	Utilizable y distribuible bajo la licencia GPL.

Aliados puede usar dos emulaciones del procesador Z80:

- La librera libz80 de Gabriel Gambetta, obtenible en
	http://libz80.sourceforge.net/

- La incluida con Aliados, a la que llamaremos ImcZ80, que es una
adaptacin de la emulacin de Z80 de Joyce, emulador de Amstrad PCW
de John Elliott, http://www.seasip.demon.co.uk/Unix/Joyce/ , que a
su vez es una adaptacin de la del emulador de Spectrum xz80, de Ian
Collier.

Las opciones posibles para compilar son:

	1- Si se quire usar la librera libz80:

	Primero hay que compilar e instalar libz80.

	Hecho esto, ejecutar: make aliadoslz


	2- Si se quiere usar ImcZ80, pero usar el desensamblador de
	libz80 en modo depuracin de CPU:

	Editar el fichero cpm.cpp y descomentar la siguiente lnea si
	est comentada.

	//#define DISASM_WITH_libz80

	Editar el Makefile, en donde dice:

	# Uncomment this if you compile with ImcZ80 and with libz80.
	#aliados: aliados.o cpm.o Z80.o realconsole.o
	#	g++ $(CPPFLAGS) $(LDFLAGS) -o aliados \
	#		aliados.o cpm.o realconsole.o Z80.o -lz80

	# Comment this if you compile with ImcZ80 and with libz80.
	aliados: aliados.o cpm.o Z80.o realconsole.o
		g++ $(CPPFLAGS) $(LDFLAGS) -o aliados \
			aliados.o cpm.o realconsole.o Z80.o disasm.o

	Compilar e instalar libz80.
	
	Hecho esto, ejecutar: make


	3- Si se quiere usar exclusivamente ImcZ80:

	Ejecutar: make


La opcin recomendada es la 3, ya que Aliados incluye su propio
desensambador y la librera libz80 no est bien depurada.


Para instalar:

	No hay instalador por ahora, simplemnete copiar el ejecutable
	a un directorio del PATH. Si se ha usado la opcin 1 habr
	que renombrar aliadoslz a aliados.

Para ejecutar:

	aliados [opciones] [programa [argumentos] ]

	Si no se especifica programa arrancar la lnea de comandos de
Aliados, que se comporta de forma parecida a una lnea de comandos de
CP/M, dar "@exit" para salir. El fichero aliados.doc contiene la
documentacin de los comandos admitidos.

	Si se especifica programa, ste es buscado como fichero normal
en el sistema de ficheros nativo, no con las convenciones de uso de
ficheros de la emulacin. Adems los argumentos no son convertidos a
maysculas.

	Opciones:

	-d 	-->	Debug all. Activa todos los modos de depuracin.

	-s	-->	Debug system. Muestra infomacin de depuracin
			en muchas de las llamadas a BDOS y BIOS.

	-z	-->	Debug Z80. Muestra el estado de los registros
			del Z80 antes de ejecutar cada instruccin y, si
			las opciones de compilacin lo permiten, el
			desensamblado de la instruccin.

	--rawout-->	Salida a conosola en modo crudo: los cdigos de
			control no son convertidos y los caracteres no
			son remapaeados. Si no se especifica esta opcin
			la salida se comporta de forma similar a la
			emulacin de terminal Zenith Z19/Z29 de las versiones
			de CP/M Plus de Amstrad.

	--rawin	-->	Entrada de consola en modo crudo. Las teclas
			especiales no son remapeadas.

	--raw	-->	Es lo mismo que especificar --rawin y --rawout.

	--ws	-->	Teclado WordStar. Asigna a varias teclas especiales
			el significado adecuado para WordStar. Sin efecto
			en modo --rawin.

	--printer -->	Dirige la salida de impresora a un fichero. Si no
			se especifica la salida ir dirigida al comando lp.

				*	*	*



Comentarios y crticas a: ninsesabe@arrakis.es




			ENGLISH VERSION.
			****************


	Aliados preliminary version.
	(C) 2004 Julian Albo.
	Usable and distributable under the terms of the GPL license.

	Aliados can use two emulations of the Z80 processor:

- The libz80 library from Gabriel Gambetta, available in 
	http://libz80.sourceforge.net/

- The included in Aliados, called ImcZ80, that is an adaptation of the Z80
emulation of Joyce, an Amstrad PCW emulator from John Elliot,
http://www.seasip.demon.co.uk/Unix/Joyce/, that is itself an adaptation
from the xz80 Spectrum emulator from Ian Collier.

The possible options to compile are:


	1- If you want to use libz80.

	First you must compile and install libz80.

	Then execute: make aliadoslz


	2- If you want to use ImcZ80 but want to use the libz80
	disassembler in the mode of CPU debugging.

	Edit the cpm.cpp and uncomment the following line:

	//#define DISASM_WITH_libz80

	Edit the Makefile, and where it says:

	# Uncomment this if you compile with ImcZ80 and with libz80.
	# aliados: aliados.o cpm.o Z80.o realconsole.o
	#	g++ $(CPPFLAGS) $(LDFLAGS) -o aliados \
	#		aliados.o cpm.o realconsole.o Z80.o -lz80

	# Comment this if you compile with ImcZ80 and with libz80.
	aliados: aliados.o cpm.o Z80.o realconsole.o
		g++ $(CPPFLAGS) $(LDFLAGS) -o aliados \
			aliados.o cpm.o realconsole.o Z80.o disasm.o

	Uncomment the first block and comment the second.

	Compile and install libz80.

	Then execute: make.


	3- If you want to use ImcZ80 exlusively:

	Execute: make.


The recomended option is 3, Aliados include his own disassembler and the
libz80 library is not sufficiently debugged.


To install:

	There is no installer yet, you must copy the executable to a
	directory in the PATH. If you have used the option 1 you must
	raname aliadoslz to aliados.

To execute:

	aliados [options] [program [arguments] ]

	If no program is specified the Aliados command line is started,
that works in a way similar to a CP/M command line, give @exit to exit.
The file aliados.doc contains the documentation of the commands admitted.

	If program is specified this is searched as a regular file in the
native filesystem, not with the emulator file conventions. Arguments are
not converted to uppercase.

	Options:

	-d	-->	Debug all. All debugging modes are activated.

	-s	-->	Debug system. Show debugging information in most
			BDOS and BIOS calls.

	-z	-->	Debug Z80. Shows register status before executing
			any instruction and, if compiling options allow it,
			the disassembly of the instruction.

	--rawout-->	Console output in raw mode. Control codes are not
			converted and characters are not remapped. If this
			option is no specified the console behavour is
			similar to the Zenith Z19/Z29 terminal emulation of
			an Amstrad PCW CP/M Plus version.

	--rawin	-->	Console input in raw mode. Special keys are not
			remapped.

	--raw	-->	Same as specifying both --rawin and --rawout.

	--ws	-->	WordStar keyboard. Assigns to several special keys
			the meaning appropriate for WordStar. No effect
			in --rawin mode.

	--printer -->	Directs printer output to a file. If not specified
			the ouput is directed to the lp command.


				*	*	*



Comments and criticisms to: ninsesabe@arrakis.es

