           X    A P P E A L   -   D E M O   V E R S I O N   1 . 3
          ========================================================

           (c) Copyright Xtreme s.a.s. 1992 - All rights reserved


PURPOSE

   The purpose of this demo version is to show at no cost the features
   of X Appeal, our X Server for the DOS environment on 386 machines.


FEATURES

   The main features of X Appeal are:

   - Full X11R5 Server implementation (8 bit / pixel), including PEX and
     font server support (using a font server can save several megabytes
     on each PC running the X Server)
   - Support for most SVGA boards, with special features like run-time
     resolution switching and panning on a bigger virtual screen (this
     allows full use of video memory even with a low resolution monitor)
   - Very fast screen painting, exceeding 6000 Xstones in 1024x768
     resolution with 256 colors on a 386DX/33 (no 387)
   - 32 bit flat mode with virtual memory to remove client restrictions
     (more than 100 clients could run even on 2MB 386SX machines,
     providing enough disk space for swapping)
   - Built-in TCP/IP network support, using the packet driver for the
     Ethernet board (free packet driver collection included)
   - Built-in rcp/rsh server, to allow file transfers and the execution
     of useful DOS functions without leaving the X environment
   - X Display Manager Control Protocol support (for hosts running xdm)
   - X-Authorization (MIT-MAGIC-COOKIE-1)
   - Font compiler and RGB database utilities
   - Interactive configuration utility
   - Can emulate a 3-button mouse with a 2-button mouse
   - Support for European keyboard layouts


   The demo version has the same features of the production version,
   with the following limitations:

   - The maximum video resolution that can be set is 640x480
   - The maximum virtual screen that can be set is 640x480 + 10% in each
     direction (to show the panning feature)
   - The maximum number of TCP connections is 4.


SYSTEM REQUIREMENTS

   The equipment needed to run X Appeal must include the following
   items:

   - A PC with a 386 or 486 (DX or SX) processor (a floating point
     coprocessor is not required, but can help using PEX)
   - At least 2 MB RAM; extended memory can be used when configured with
     XMS or VCPI managers, but DPMI is unsupported.
   - A supported Super VGA board (see below)
   - MS-DOS 3.30 or later
   - A pointing device with Microsoft Mouse compatible driver
   - An Ethernet card compatible with packet drivers
   - At least 3 MB of free hard disk space (1.6 MB for executables, 1.4
     MB for the font subset); some more space can be needed for swapping
     if running with the minimum amount of RAM.


DEMO KIT CONTENTS

   The demo kit is made by two ZIP archives, both to be extracted using
   the "-d" option on the root directory.
   The first archive, XAP13EXE.ZIP, contains the executables and the
   support files, but no screen font.
   The second archive, XAP10FNT.ZIP, contains a subset of the X11R5
   fonts and is not needed when using a font server.
   A third ZIP archive, DRIVERS.ZIP, containing packet drivers from the
   well known Crynwr collection, is available if your network board is
   not provided with a packet driver.


INSTALLATION

   The installation of the demo version requires three steps: archive
   extraction, packet driver installation, configuration file
   customization. Optionally the rcp and rsh server functions can be
   enabled.
   Please make sure also you have at least FILES=20 in your CONFIG.SYS;
   lower FILES settings, or the default DOS value, may cause X Appeal
   to abort during initialization.
   The DOS extender looks for the environment variables GO32TMP, XAPTMP,
   TMP, TEMP (in that order) to locate the directory where to create the
   swap file. If none is set, it defaults to the root of the current
   drive.

   Archive extraction
   
   You should have the archive files on some temporary directory, or on
   floppies. Change directory to the root of the drive where you like to
   install the demo (e.g. C:\), then extract XAP13EXE.ZIP using the "-d"
   option (to create the needed subdirectories). Then do the same with
   XAP10FNT.ZIP, if you plan to use local fonts.
   At the end of this process, you should have this directory structure:

   C:\
   X11
       FONTS
          75DPI
          MISC
          PEX
       DRV

   If needed, you can relocate the directory tree on another drive
   and/or under a different path; you need to specify them during
   configuration.

   Packet driver installation

   Extract the archive DRIVERS.ZIP (or the other packet driver 
   collection you have) on some temporary directory, then find the
   correct packet driver for your network board (just to make an
   example, the packet driver for the Western Digital WD8003E board
   is WD8003E.COM). Then run the packet driver itself with the correct
   parameters (depending on your board jumper settings). A good choice
   can be to do a small .BAT file with the packet driver invocation, or
   to add it to your AUTOEXEC.BAT.
   A sample invocation for the WD8003E board is as follows:

     wd8003e 0x66 3 0x280 0xd000

   which installs the packet driver at the software interrupt 0x66
   (values between 0x60 and 0x6F are allowed) using a board configured
   for IRQ 3 and I/O address 0x280; Dual Port RAM is configured at
   0xd000:0. Depending on your board, the parameters may vary.
   Packet driver support and updates are available from Crynwr Software.

   Configuration file customization

   This is the part where you have to specify the correct parameters for
   your installation in the XCONFIG file under the X11 directory.
   The XCONFIG location can optionally be changed by setting the XCONFIG
   environment variable to the directory where the file is located.
   A sample file is included, with clear indications of the fields to be
   customized.
   The configuration file can also be created using the XINSTALL utility
   included in the demo kit. Just type "xinstall -c" and answer all the
   questions giving the correct answers for your network and hardware
   configuration. Do not select the optional 100dpi fonts, since they
   are not included in the demo kit.
   We will give the description of the meaning of the configurable
   items; please feel free to contact us in the case you find problems
   in setting up the configuration file.

   You may also want to create a static authorization file X0.HOS in
   the X11 directory, to specify systems that are allowed to connect to
   the X server; the IP address of the host(s) to be enabled must be
   listed in the X0.HOS file, one on each line. This file is not normally
   needed when using XDMCP.

   The sample XCONFIG file looks like this; please look at the comments
   and set the required parameters as appropriate. We will give more
   details at the end of the sample file. Please note that keyword names
   are not case-sensitive; mixed case is used only for readability.

   ---------------------------------------------------------------------
   Network
    MyIp     "aaa.bbb.ccc.ddd"   # REQUIRED, put your IP address here
    Netmask  "255.255.0.0"       # REQUIRED, must not be 255.255.255.255
    Gateway  "aaa.bbb.ccc.ddd"   # put your gateway IP address here
   # Nameserver   ""             # put your nameserver IP address here
   # Domainslist  ""             # put your domain name here

   RGBPath     "C:\X11\rgb"	 # the RGB database name

   FontPath    "C:\X11\fonts\misc\,C:\X11\fonts\75dpi\" # to use local fonts
   # FontPath  "tcp/aaa.bbb.ccc.ddd:7000"      # to use the font server
                                               # put its IP address here

   Keyboard
   # DontZap                     # if enabled, server cannot be stopped
   # ServerNumLock               # if enabled, forces the server to
                                 # handle the numlock key remotely
    Layout     "us"              # PC keyboard layout

   Mouse
   # Emulate3Buttons             # if enabled, simulates the middle
                                 # button on a two-button mouse

   VGA256
    Modes      "640x480" "640x400" "640x350"   # list of video modes to
                                               # be switched at run time
    Videoram   512
    Virtual    704 528           # the virtual screen resolution
    ViewPort   0 0               # where to place the upper left corner
   ---------------------------------------------------------------------

   The Network section includes the parameters needed to correctly set
   the TCP/IP network layer. You must correctly set your IP address, the
   netmask (according to your network class) and the IP address of your
   gateway.
   Optionally you can define your domain name(s) and name server; in
   that case you can specify symbolic host names when invoking X Appeal.
   If a BOOTP server is available on your network, it can be used to
   automatically set the network parameters: just put the word "Bootp"
   as the value of the MyIp field, and leave the other Network parameters
   unspecified.

   The FontPath keyword sets the search path for fonts. This path is a
   comma separated list of directories which the X server searches for
   fonts. The utilities BDFTOPCF.EXE and MKFNTDIR.EXE can be used to set
   up other font directories.
   If you plan to use a font server instead of local fonts, you have to
   uncomment the line with its definition, and to correctly set its IP
   address on the same line (the TCP port number can be changed if your
   font server uses a different port). The font server uses a TCP
   connection, so the limit on the client connections is lowered by one.

   The RGBPath sets the name of the RGB color database, which can be
   created from the ASCII description in the file RGB.TXT and converted
   back to the ASCII form using the two utilities RGB.EXE and SHOWRGB.EXE.

   The Keyboard section can include the following keywords:
     DontZap:
       disallows the use of the Ctrl+Alt+Backspace sequence. This
       sequence allows you to terminate the X server.
     Layout:
       selects the PC keyboard layout; the two-letter code is the same
       used with the DOS KEYB command.
     ServerNumLock:
       forces the server to handle the numlock key internally. The
       server sends virtual key-events so applications can use the
       numeric keypad.

   The Mouse section can include the following keywords:
     Emulate3Buttons:
       enables the emulation of the third mouse button for mice which
       only have two physical buttons. The third button is emulated by
       pressing both buttons simultaneously. Please note that this
       causes a slight delay in button and motion event handling.

   The Graphics section starts with the keyword	VGA256. After this
   keyword a variety of options may be specified:
     Staticgray, Grayscale, Staticcolor, Pseudocolor, Truecolor,
     Directcolor:
       set the visual class for the root window of the screen.
     Displaysize xdim ydim:
       set the display size (in mm) to xdim x ydim.
     Modes "mode" ... :
       selects the display modes for this screen. The first one in the
       list will be the default display mode for startup.
       Internally this list is converted into a circular list; with
       Ctrl+Alt+KeypadPlus and Ctrl+Alt+KeypadMinus the current display
       mode may be changed, and the next (upward/downward) entry in the
       list will be used.
     VideoRam mem:
       specifies the amount of videoram installed on the graphics board.
       This is measured in kBytes and defaults to 512.
     ViewPort x0 y0:
       set the upper left corner of the initial display. If the virtual
       resolution is larger than what is physically displayed, then the
       initial display  will be centered if viewport is not specified.
     Virtual xdim ydim:
       set the virtual resolution. For example you can use a display
       with 800x600, but a virtual resolution of 1152x900. If the mouse
       touches the borders of the display the image scrolls accordingly;
       this is called panning.

   Multiple key presses recognized directly by X Appeal are:

   Ctrl+Alt+Backspace
     Immediately kills the server -- no questions  asked.
     Can be disabled by specifying "DontZap" in the configuration file.
     In that case the server runs forever.

   Ctrl+Alt+KeypadPlus
     Change video mode to the next one specified in the configuration
     file.

   Ctrl+Alt+KeypadMinus
     Change video mode to the previous one specified in the
     configuration file.


   Activation of the rcp and rsh server functions

   The rcp and rsh server functions are enabled by creating a file named
   RCPUSERS in the X11 directory, containing the user IDs of the users
   which are enabled to access the functions (for security reasons these
   functions are disabled if the file does not exist). The special user
   ID "#EVERYBODY#" (without double quotes) enables unrestricted access.
   The file location can optionally be changed by setting the RCPUSERS
   environment variable to the directory where the file is located.
   When the functions are enabled, the user can transfer files between
   the PC and the host in both directions by using the rcp command.
   The rsh command can also be used to execute an useful subset of DOS
   functions, by simulating the following commands:

     pwd   display the PC current directory
     cd	   change the PC current directory
     rm    remove a file from the PC
     mv    rename a file on the PC
     lp    send rsh standard input to the PC printer
     ls    list the PC files.

   The following options are recognized by the lp command:

     -2    use LPT2 instead of LPT1
     -n    translate end-of-line (\n --> \r\n)

   The following options are recognized by the ls command:

     -1    list in one column format
     -F    mark directories with a trailing '\', executable files with
           a trailing '*' and system files with a trailing '@'
     -P    display the directory name before listing
     -S    sort by file size
     -a    list all files including hidden and system
     -d    list directories as normal files
     -f    list unsorted, in the order files appear in the directory
     -l    list in long format
     -r    reverse sort order
     -s    list file size in kilobytes
     -t    sort by time

   The rm command can only remove a file at a time (this limitation has
   the purpose to limit accidental file deletions on the PC).
   The mv command can move files between directories on the same DOS
   disk, but not between different disks.
   Remember to use the symbolic name of your PC, as it appears in your
   host database, as argument of the rcp and rsh commands (the same as
   the DISPLAY environment variable, without the trailing ':0').
   The directory separator for the rcp and rsh commands is '/'.
   The rcp/rsh server uses a TCP connection, so the limit on the client
   connections is lowered by one when these functions are active.


DEMO STARTUP

   To start the X Appeal Demo, cd to the X11 directory and issue

      x <host address>

   where <host address> is the IP address in dot notation or the
   symbolic name (if using a name server) where xdm is running waiting
   for connection requests.
   If you use the XINSTALL configuration utility, one of three methods
   of XDMCP interaction can be selected: direct query, indirect query,
   broadcast query. In the former two cases a default host address is
   included in the X.BAT file, and X Appeal can be started by just
   typing "x".
   After a greeting message and a 5 seconds delay which can be stopped
   by pressing any key, the screen should blank and then display the
   standard X11 background, with the X cursor. Then the xdm login
   request should appear, awaiting user identification.

   If no host on your network is running the xdm process, the screen
   will display nothing but the stippled background with the cursor.
   In that case an old-style method of running X application can be
   used. You have first to statically enable access for the host(s)
   that will run applications on your X Server (see above for the
   format of the X0.HOS file). Then you can run X clients from one of
   the enabled hosts, after setting the DISPLAY environment variable
   to <yourPC>:0 (<yourPC> being the IP address or the symbolic name
   of the PC where X Appeal is running).
   You can also do the same from the PC, by using a character-based
   Telnet emulation which uses a network packet driver interface (such
   as NCSA Telnet); when logged on the host, issue the command (assuming
   the Unix operating system):

      (sleep 30; xterm -ls -display <yourPC>:0)&exit

   and then exit Telnet and start X Appeal.


TROUBLESHOOTING

   If some problem arises when X Appeal is running, the error messages
   are recorded in the file ERRORS in the current directory. Please
   report all the information included in the file.
   When trying to connect to hosts without an active xdm process, some
   "ICMP: Port unreachable" messages can be recorded in the ERRORS file.
   They are normal and can safely be ignored.

   The message "CPU must be in real mode" appears when some 386 memory
   manager (like EMM386) has been installed in CONFIG.SYS, without EMS
   emulation enabled. Either enable EMS emulation, or remove the memory
   manager.

   If the screen shows strange patterns, or multiple cursor images,
   your VGA board is likely to be unsupported by X Appeal. Please report
   the problem with information about the VGA board, the chipset it uses,
   the amount of video memory.
   If you know you have one of the supported boards, maybe the automatic
   board detection code fails to identify it correctly. In that case you
   can set the XAPPEAL environment variable to specify the video driver
   to be used; an example setup for a Tseng ET4000 board follows:
      set XAPPEAL=svga tseng4k
   The driver names can be found by listing the files with the .GRD
   extension in the X11\DRV directory.
   If you use the XINSTALL configuration utility, the selection of the
   video driver is automatically included in X.BAT.

   The demo version currently supports the video adapters equipped with
   the following chipsets:

      Ahead (V5000B)
      ATI Technologies (18800 and others)
      Chips & Technologies (82C452)
      Genoa (6400)
      NCR (77C22E)
      Oak Technologies (OTI-067)
      Paradise (PVGA1A)
      Trident (8900B, 8900C)
      Tseng Labs (ET3000, ET4000)
      Western Digital (WD90C00 and others)

   Other drivers are under development (email for current status).

   The best performances have been obtained using ET4000 equipped
   boards.

   
COPYRIGHT

   X Appeal is a trademark of Xtreme s.a.s.

   The demo version of X Appeal is (c) Copyright Xtreme s.a.s., that
   retains the full ownership on it; no modification can be made on the
   executable files included in the demo kit.

   The demo version can be freely copied and redistributed, with no
   royalty whatsoever, and can be used for testing purposes on one
   machine at a time per testing site (this limitation is enforced by
   software).

   X Appeal is based on the X Window System, Version 11, Release 5.
   X Window System is a trademark of the  Massachusetts  Institute of
   Technology.


                        Portions Copyright by:

                 Massachusetts Institute of Technology

                                  and

                    AT&T, UNIX System Laboratories
                             Adam de Boor
                          Adobe Systems, Inc.
                         Apollo Computer, Inc.
                         Apple Computer, Inc.
                            Ardent Computer
                           Bigelow & Holmes
                            Bitstream, Inc.
                            Cognition Corp.
                         Daewoo Electronics Co
                            Dale Schumacher
                     Digital Equipment Corporation
                              Don Bennett
                Evans & Sutherland Computer Corporation
                               Franz Inc
                          Fuji Xerox Co, Ltd.
                            Fujitsu Limited
                        Hewlett Packard Company
                            IBM Corporation
                            Joseph Friedman
                              Larry Wall
                         MIPS Computer Systems
                            Marvin Solomon
                         Matra Datavision, Inc
                          Megatek Corporation
                       NTT Software Corporation
                National Computer Graphics Association
                    Network Computing Devices, Inc.
                      Nihon Sun Microsystems K.K.
              Nippon Telegraph and Telephone Corporation
                     O'Reilly and Associates, Inc.
                           OMRON Corporation
                  Oki Technosystems Laboratory, Inc.
                             Prentice Hall
                          SORD Computer Corp
                                  SRI
                 Snitily Graphics Consulting Services
                       Solbourne Computer, Inc.
                           Sony Corporation
                        Sun Microsystems, Inc.
                            Tektronix, Inc.
                    Texas Instruments Incorporated
                     The Open Software Foundation
              The Regents of the University of California
                             Thomas Roell
                          Toshiba Corporation
                        University of Michigan
                        University of Wisconsin
                           William Kucharski
                            Wyse Technology


   X Appeal internal TCP/IP network layer is partially derived from
   the free WATTCP networking library code.

   The DOS Extender included in the X Appeal executable is a modified
   version of GO32, Copyright DJ Delorie; redistributed under license.

   Ethernet is a trademark of Xerox Corporation.

   MS-DOS is a trademark of Microsoft.

   UNIX is a registered trademark of AT&T.

   All other product names used in this document are trademarks or
   registered trademarks of their respective owners.


DISCLAIMER

   XTREME DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
   INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS,
   IN NO EVENT SHALL XTREME BE LIABLE FOR ANY SPECIAL, INDIRECT OR
   CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
   LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
   NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
   CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.


ORDERING INFORMATION

   The license fee for a single user copy of X Appeal is US$ 240 (or
   the equivalent amount in local currency).
   License fees for multiple users at the same site are lower; they can
   be computed using the following formula:

                 20000                 N is the number of licensed users
      P =  40 + --------       where:
                 99 + N                P is the price per user in US$

   The site license fee for an unlimited number of users is US$ 24000.

   An additional 30% discount is available for academic and educational
   institutions.

   A contribution for shipping charges (US$ 20) will be added for orders
   under 5 users.

   All orders have to be confirmed in writing. Fax orders are
   accepted, followed by a copy of the order by ordinary mail.
   Orders from EEC countries must include the V.A.T. code.
   The package is usually shipped within one week after order
   reception.
   Payment on our bank account: no. 48901.21 c/o
   Banca Toscana, Ag. 1, Piazza Matteotti 1, 57125 Livorno, Italy.

   All orders must be placed to:

   Xtreme s.a.s.
   Fax:             +39-586-502310
   E-mail:          xappeal@xtreme.it
   Administration:  Via Marradi  149 - 57125 Livorno - Italy

