QuickStart: Instructions on how to quickly get DOSEMU up and running.
==========

Well, you are impatient? Ok, maybe you succeed with this SHORT description.
However, if you are reasonable just execute ViewDocs to read the docs.
                                            ========

--------------------------------------------------------------------------
1. Install and use the ready-to-use DOSEMU binary distribution
--------------------------------------------------------------------------

The most easiest way to get DOSEMU working on your maschine is to use
the ready-to-use DOSEMU binary distribution. This one comes in 2 packages:

  - ftp://ftp.dosemu.org/dosemu/dosemu-freedos-bin.tgz
    (A tarball containing a collection of suitable FreeDos binaries)

  - ftp://ftp.dosemu.org/dosemu/dosemu-<version>-bin.tgz
    (A tarball containing the recent DOSEMU binaries)

You have to unpack both tarballs (as normal user, NOT as root) into
the same directory in your HOME, such as:

  $ mkdir mydos
  $ cd mydos
  $ tar -zxf dosemu-freedos-bin.tgz
  $ tar -zxf dosemu-1.0.2-bin.tgz
  $ cd dosemu

Now execute DOSEMU

  $ ./xdosemu

For a more detailed description have a look at README.bindist

--------------------------------------------------------------------------
2. Compile
--------------------------------------------------------------------------

- make

--------------------------------------------------------------------------
2a. Want to install systemwide? 
--------------------------------------------------------------------------

- download dosemu-freedos-bin.tgz from dosemu.org or its mirrors
- su -		(become root)
- ./install_systemwide -fd dosemu-freedos-bin.tgz

--------------------------------------------------------------------------
2b. Want to update a systemwide installation? 
--------------------------------------------------------------------------

- su -		(become root)
- ./install_systemwide

--------------------------------------------------------------------------
3.  Want to use not standard configuration ?
--------------------------------------------------------------------------

Then you have to edit compiletime-settings (changing on/off) and run
./default-configure _prior_ to running make.

Or (if you have Tcl/Tk installed) alternatively you can use the new menu
driven configuration tool:

- ./setup-dosemu

then chose "Compile configiration / compilation", when you have
finished toggling the configuration switches, klick < Ok> and chose
the appropriate action ...
... well it should be self descriptive.


--------------------------------------------------------------------------
4.  Configure for a system wide suid-root installation
--------------------------------------------------------------------------

(Note: You normally don't need it for a non-suid-root DOSEMU.
       and for an suid-root one your Linux distributor will hav done
       it for you)

(BIG FAT WARNING: you have to be _very_ skilled to do it right !!)

- Copy ./etc/dosemu.conf to /etc if you are installing for the first time.
  ( make install would have done this, if /etc/dosemu.conf dosen't exist )
  Modify /etc/dosemu.setup by using the info in the file ./doc/README.txt
  chapter 2

- Copy ./etc/dosemu.users.easy to /etc/dosemu.users which contains a list of
  users who are privileged to use dosemu.  The user "all" will allow anyone
  to run dosemu. example:

    root c_all
    all c_all

  Note that the above example is _insecure_, because it allows all to any
  user. If you want security, then copy ./etc/dosemu.users.secure to
  /etc/dosemu.users and have a look at an other example in
  ./doc/README.txt chapter 2.

  For a more detailed decription on 'running as user' have a look
  at ./doc/README.txt 'Running dosemu as a normal user' (chapter 7).

--------------------------------------------------------------------------
5.  Something's not right!!!
--------------------------------------------------------------------------

- For suid-root installations:
  Check your dosemu.users file (maybe insufficient privileges set)

- Read your dosemu.config file carefully and make corrections.

- Try disabling certain features.  The video options and some of the
  rawkeyboard options sometimes cause problems.

- If the video support does not work, ensure that the video BIOS address
  in dosemu.conf (variable $_vbios_seg) is correct.

- Read all documentation files carefully, and try to get some help from
  others who have used DOSEMU.

- Read the dosemu-HOWTO for Q&A's.

- If no luck, please send us a debug report by typing 'dos -D+a -o debug'
  and send the file debug together with your config files and a
  description of your problem to

    dosemu-bugs@dosemu.org

  Don't forget to mention the versions of DOSEMU, GCC, LIBC, Binutils e.t.c.
  For problems together with DOSEMU installationa made by Linux distributors,
  please bother them directly, we won't hunt after those bugs.

  For general discussion on dosemu use the mailing list
  linux-msdos@vger.kernel.org

- Please be patient with us.  We get flooded with bug reports and do our
  best to respond in a timely fashion.

--------------------------------------------------------------------------
6.  Available documentation -- mostly somewhat outdated :(
--------------------------------------------------------------------------

./README.bindist
	Describes the ready-to-use DOSEMU binary distribution, which
	frees you from all bothering about compilation, installation
	and configuration ... just _use_ it.
./README.distributors
	Not intended for 'Joe User' but for Linux distributors.
./doc/dosemu-HOWTO.txt
	This is the F.A.Q. for DOSEMU.  It is a little bit outdated,
	but still very helpful.  (Read this file first, however.)
./ChangeLog
	This is a log file of progress that have been done on
	DOSEMU since previous versions.
./doc/DANG.txt
	The Dosemu Alterning Novice's Guide, for interested hackers
	and programmers alike, if they want to look at the internals
	of DOSEMU and how it works.
./doc/DPR
	The Dosemu Project Registry, an outdated document keeping
	track of who's doing what kind of programming for DOSEMU.
./man/dosemu.bin.1
	This is the 'lowlevel' DOSEMU man page. It is now up to date with 1.0.2.
./man/dosemu.1
	This is the DOSEMU man page of the wrapper script.
./man/mkfatimage16.1
	This discribes how to create (empty) hdimages of various sizes.
./doc/announce
	The announcement textfile for DOSEMU.
./doc/README.txt
	Readme file for various applications and general purpose settings.
./doc/README-tech.txt
	Readme file for various technical details and settings.
./doc/configuration.txt
	How to use the menu driven configuration tools


----------

Many thanks to all involved, including all those who submitted debug
output for our viewing pleasure, keep it coming.


       Hans Lermen

SnailMail:
       Am Muehlenweg 38
       D53424 REMAGEN-Unkelbach
       Germany

Email: lermen@fgan.de
