!!! Warning !!!

DISPLAY is a 32-bit protected mode application, thus more restrictions are
imposed on this program than traditional 16-bit applications. I can't guarantee
that this program will run well on your machine, especially with 3rd-party
memory managers(such as QEMM). I suggest that you turn off the advanced features
of these memory managers(such as the Stealth Technology in QEMM) before running
DISPLAY.


1. Hardware Requirements
========================

  PC 386 or better. MSDOS 3.3 or higher.
  I recommend a minimum of 4Mb for better performance.
  Hard disk for swapping (virtual memory).

  The following description is borrowed from DJGPP.

  Supported Wares:

  * Up to 128M of extended memory (expanded under VCPI)
  * Up to 128M of disk space used for swapping
  * SuperVGA up to 1280 x 1024.
  * 80387
  * XMS & VDISK memory allocation strategies
  * VCPI programs, such as QEMM, DESQview, and 386MAX
  * Windows, OS/2 (in DOS Box).

  Features: 80387 emulator, 32-bit unix-ish environment, flat memory
  model, SVGA graphics.


2 Unpack package
================

  There are subdirectories in this package.
  If you use PKUNZIP to unpack this package, make sure that you add the
    '-d' switch.


3 Installation
==============

  ***** Important *****

  If you have used DISPLAY older than version 1.70, please delete all old
  video drivers, go32.exe and emu387.
  Don't use vesanew.grn because it doesn't work for GO32 1.11 or later.

+ Please don't use GO32.EXE whose version is 1.12.maint3 or earlier.
+ Use the GO32.EXE in this package. Version is 1.12.maint3-disp.

  *********************

  Video drivers, emu387 and go32.exe are borrowed from DJGPP and GRX.
+ This go32.exe is based on the one from DJGPP 1.12.maint3.
+ A serious bug of go32.exe in graphics mode is fixed by me. Version is changed
+ to 1.12.maint3-disp.

  1. run INSTALL.EXE.
     install.exe will generate the correct runme.bat for you. Use it to run
     DISPLAY.
     If you still prefer DIY(Do-It-Yourself), go to step 2.
     Otherwise installation is complete and please read Notes at
     the end of this file.

  2. Place GO32.EXE within system search path.

  3. Video Driver Setup:

    If possible, choose .grn, then .grd.
    .GRD drivers support only 256-color modes. .GRN drivers can support
    Hi/TrueColor modes. You should look at the source code(*.asm) to see
    if your driver supports these modes.
    All video drivers are in the DRIVER subdirectory.
    Please read VDRIVER.DOC for a brief description of each driver.

    If you choose xxxxx.grn as video driver. add 'driver xxxxx.grn' to
      environment variable GO32.
    For example, 'set go32=driver x:/xxxxx/xxxxx.grn'

    If you can't find any suitable driver for your video card or you want
      to use VESA interface, there are two ways you can choose:

      (a).
        Just DON'T add anything to GO32. The default video driver in GO32 is
        VESA driver.
        For example, 'set go32='

      OR

      (b).
        Use vesa111.vdr or vesa112.vdr.
        For example, 'set go32=driver x:/xxxxx/vesa111.vdr'

    For VESA user :
      Please use vesainfo.com to check if your VGA BIOS supports VESA
        standard.
      I suggest that you try (a) first. If (a) doesn't work then try (b).
      If your VESA BIOS works under PROTECTED mode, you can
        add 'driver ::p' to GO32(for (a)) or
        append '::p' to vesa111(for (b))
        to speed up graphics operations.
      For example, 'set go32=driver ::p'                         for (a)
                   'set go32=driver x:/xxxxx/vesa111.vdr::p'     for (b)

  4. 80x87 Emulator Setup:

    If you do not have an 80x87, add 'emu x:/xxxxx/emu387' to GO32.
    For example, 'set go32=driver x:/xxxxx/xxxxx.grd emu x:/xxxxx/emu387'
    emu387 is included in this package.

    For DPMI(Windows, OS/2) user :
      You must have a REAL 80x87. Emulator doesn't work under DPMI.

  5. Supress DPMI(for DOS user only):

    If your memory manager supports both DPMI & VCPI(i.e. 386MAX), I suggest
      that you add 'nodpmi' to GO32.

    For Windows or OS/2 user :
      You can't add 'nodpmi' to GO32.
      If your memory manager supports both DPMI & VCPI and you are planning
        to run DISPLAY under both DOS and Windows(OS/2), I suggest that you
        disable the DPMI support in your memory manager. So you don't have to
        keep two copies(one for DOS, supresses DPMI; one for Windows, enables
        DPMI) of runme.bat.

  6. Change Resources/Parameters:

    Please use a text editor to modify the configuration file, CONFIG.DIS.
    You MUST change the SYSTEM section at least.

  7. Run:
                
    Read DISPLAY.FAQ.
    Edit RUNME.BAT and use it to run DISPLAY.


4 Notes
=======

  1. For VESA user :
    You can find VESA BIOS extension at:
      wuarchive.wustl.edu: /mirrors/msdos/graphics
      godzilla.cgl.rmit.oz.au: /kjb/MGL

  2. For DPMI(Windows, OS/2) user :
    Mouse is not supported.

+ 3. For Windows, OS/2 user :
+   Sound plaing is not supported.

  4.
    You can get the whole DJGPP and GRX packages from :
+     oak.oakland.edu: /SimTel/msdos/djgpp
      or simtel20 mirror sites.