***********************
* compiling flexemu   *
***********************

	- optionally edit config/config.h
	- cd src
	- edit Makefile to select Your target operating system.
	  (Linux is the default)

	- make depend
	- make all

remarks:

	- There are several compiler switches modifyable. But the defaults
	  should always work.
	- If You only want to compile flexemu simply type make
	  (otherwise the tools fromflex, toflex and rcvflex will also be
	  compiled)
	- If You don't have X PixMap Extension, comment XPM switch
	  (You can get xpm with anonymous  ftp from avahi.inria.fr)
	- If You don't want native file system support comment NAFS switch
	  (in this case You need a flex disk image which is not supported
	  in this package)
	- If You don't want the disassembler to substitute some FLEX jump
	  vectors to print as labels comment FLEX_LABEL switch.
	- There are two MC6809 processor implementations. One of them is
	  about 20% slower but a very well structured implementation. Each
	  instruction is executed in it's own function. So it can easily be
	  debuged with gdb. The processor cycles are exactly calculated.
	  The second is faster, the complete processor is emulated in one
	  inline-function. The processor cycles are only aproximated
	  (4.8 cycles for each instruction). The faster processor can
	  be compiled with switch FASTFLEX uncommented.
	- If You want to compile flexemu only with XLib interface
	  (there is less functionality, but maybe You don't have X Toolkit)
	  comment switch XTK. Do a 'make clean; make depend; make all'
	- The Athena widgets can also be linked with a 3D-style look. You
	  simply have to replace -lXaw by -lXaw3d in line LIBS in file
	  Makefile.unx.
	- If You have problems in compilation or changed any option in
	  the Makefile recompile with:
	  'make clean; make depend; make all'
	- On Linux I get a warning
	  '# error architecture not supported by the Linux C library'
	  during 'make depend'. It comes from include-file bytesex.h and
	  can be ignored.

***********************
* install flexemu     *
***********************

	- make install      (needs write access to BINDIR and MANDIR)
	- make install.user (should be done for each user who wants to work
	                     with flexemu. It installs the application defaults
			     file and monitor program)
	- the FLEX disks system, work, source, pictures, test and games
	  should be copied by hand, as You need them (system is recommended)
	- the subdirectories man1, man2 man5 and man7 in $MANDIR must
	  already exist
	- an environment variable FLEXDISKDIR can be defined to the copied
	  disks directory

remarks:

	- If You don't have write access to the installation paths change
	  BINDIR in the Makefile. Be shure that BINDIR is part of Your
	  PATH environment variable.
	
***********************
* uninstall flexemu   *
***********************

	- make uninstall

remarks:

	- it does not uninstall the installation made by 'make install.user'.

***********************
* help, Documentation *
***********************

There are some html-pages for flexemu:

flexemu.htm	general description, command line options
flexuser.htm	the FLEX users manual
flexutil.htm	some FLEX utilities
flexdos.htm	description of the FLEX disk operating system
flexfms.htm	description of the FLEX file management system
flexfs.htm	'filesystems' supported by flexemu
flexerr.htm	description of the FLEX error messages
flexfcb.htm	description of a FLEX file control block
flexmem.htm	the FLEX memory map

