DOSEMU installation instructions (from source)
==============================================

-> REQUIREMENTS for DOSEMU:
    - gcc >= 3.3 or clang >= 3.7.0
    - glibc >= 2.3.3
    - linux >= 3.16 for x86-64, >= 4.7 recommended.
      With older version than 3.16 there may be some problems
      with DPMI, especially make sure to not use 3.14 and 3.15.
      linux >= 4.3 for i386.
      linux >= 4.11 if you want to run 32bit dosemu under x86_64 kernel
      with multilib environment (you likely don't want to do this).
    - x86 (i386/x86-64) target CPU
    - bison and flex
    - SDL >= 2.0.3 is strongly recommended.
    - development libraries: Xext, slang, gpm, alsa, fluidsynth,
      ladspa, libao, binutils can be used when available.

--------------------------------------------------------------------------
1. Compile
--------------------------------------------------------------------------

First you should run:

./autogen.sh

Then either:

./default-configure
make

or

- create a seperate directory and run
    $SRCDIR/configure (or $SRCDIR/default-configure; see below)
    make
  in that directory.

--------------------------------------------------------------------------
2. Install 
--------------------------------------------------------------------------

- download dosemu-freedos-<version>bin.tgz from dosemu.org or one of its
  mirrors
- sudo make install

You can now start DOSEMU using "dosemu". By default, when you start it the
first time it creates a private C: drive in the directory
$HOME/.dosemu/drive_c. This directory initially only contains the
config.sys and autoexec.bat files, and a tmp directory. All FreeDOS files
can be found on the shared read-only drive D: and all DOSEMU support files
(exitemu.com and so on) are on drive E:.

Runtime configuration variables can be stored in the file ~/.dosemurc.
This file overrides the dosemu.conf file which is usually either in
/etc/dosemu or in /etc. By default, most error and debug messages are
logged to the file ~/.dosemu/boot.log.

If you do not want to use FreeDOS, a simple way to use a different DOS is
to copy or symbolically link the DOS system files (io.sys. msdos.sys,
command.com, and so on, or equivalents) to $HOME/.dosemu/drive_c, and
DOSEMU will automatically use them when you next boot it.

If you do not want to use the $HOME/.dosemu/drive_c location, then you
can adjust dosemu.conf or ~/.dosemurc yourself and point $_hdimage to the
right boot directory or hdimage (which can be a symbolic link).

--------------------------------------------------------------------------
3.  Want to use a different configuration ?
--------------------------------------------------------------------------

If you want a DOSEMU executable with development settings (debug info,
experimental features, and so on) then it is easier to use the file 
compiletime-settings.devel -- you can use it by running
	./default-configure -d
(*not* ./configure -d) prior to running make.
