
	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 - Emulacion con ImcZ80 y desensamblado con rutinas propias.

	2 - Emulacion con ImcZ80 y desensamblado con libz80

	3 - Emulacion y desensamblado con libz80.

La opcion 1 es la recomendada y la que se toma por defecto. Para
usar alguna de las otras dos hay que editar la seccion "Emulation
and disassembly options" del Makefile, comentando el primer bloque
y descomentando uno de los otros dos.

Para cualquiera de las que usan libz80 hay que compilar e instalar
libz80 antes de compilar aliados.

Para compilar:

	Ejecutar make.

Para instalar:

	No hay instalador por ahora, simplemnete copiar el ejecutable
	a un directorio del PATH.

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: julian.notfound@gmail.com




			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 - Emulation with ImcZ80 and disassembly with own routines.

	2 - Emulation with ImcZ80 and disassembly with libz80.

	3 - Emulation and disassembly with libz80.

The option 1 is the recommended and is taken by default. To use
any of the other it is neccesary to edit the "Emulation and
disassembly options" of the Makefile, commenting out the first
block an uncommenting one of the other two.

To use any of the options that use libz80 is neccessary to compile
and install libz80 before compiling aliados.

To compile:

	Execute make.

To install:

	There is no installer yet, you must copy the executable to a
	directory in the PATH.

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: julian.notfound@gmail.com

