!!! 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.
It is reported that DISPLAY is incompatible with Double-Space driver and
VSHIELD.


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.

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

  Video drivers, emu387 and go32.exe are borrowed from DJGPP and GRX.
  This go32.exe is the original one from DJGPP 1.11.maint5.

  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.
        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.
    You can get the whole DJGPP and GRX packages from :
      omnigate.clarkson.edu: /pub/msdos/djgpp
      or simtel20 mirror sites.
       