






                                      X APPEAL

                                     Version 1.4



                                      USER AND
                                    INSTALLATION
                                       MANUAL








                                   c XTREME s.a.s.





























































                                          2






                             USER LICENSE AGREEMENT FOR
                                THE X APPEAL SOFTWARE
                                  BY XTREME S.A.S.


          Read the  following  clauses  of  the  license  agreement  before
          opening the envelope  containing the user  disks of this  program
          product. By opening the  package you unconditionally accept  this
          agreement.
          If you refuse to  accept the license  conditions, you can  return
          the closed envelope for a refund.

          1. OWNERSHIP
             The program, including  the supporting  documentation, is  the
             property  and  constitutes  a  trade  secret  of  Xtreme.  The
             customer does  not  acquire  any title  or  ownership  in  the
             program  other  than  the  license  rights  granted  by   this
             agreement.

          2. SECURITY
             The program is  delivered to  the customer  on a  confidential
             basis;  the  customer  is  responsible  for  taking  all   the
             necessary actions  to  avoid  unauthorized  diffusion  of  the
             program to third  parties. The customer  can make copies  only
             for backup purposes.
             The customer  is not  authorized in  any  case to  modify  the
             program,  reverse  engineer  it   or  remove  any   trademark,
             copyright notice, serial number or customer name from it.

          3. LICENSE
             The customer has the right to use a binary copy of the program
             on the licensed number of machines. The concurrent use of  the
             program on a  greater number of  machines is  not allowed  and
             constitutes a violation of the license agreement.

          4. DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY
             Xtreme grants  no  warranties  with respect  to  the  licensed
             program, and all implied warranties, including merchantability
             and fitness  for  purpose, are  excluded.  IN NO  EVENT  SHALL
             XTREME BE  LIABLE  FOR  SPECIAL,  INDIRECT,  CONSEQUENTIAL  OR
             INCIDENTAL  DAMAGES  RESULTING  FROM  LOSS  OF  USE,  DATA  OR
             PROFITS, ARISING  OUT OF  OR IN  CONNECTION  WITH THE  USE  OR
             PERFORMANCE OF THIS SOFTWARE, EVEN IF XTREME HAS BEEN  ADVISED
             OF THE POSSIBILITY OF SUCH  DAMAGES; THE MAXIMUM LIABILITY  OF
             XTREME SHALL BE LIMITED  TO REFUND TO  THE CUSTOMER THE  PRICE
             PAID BY THE CUSTOMER FOR THE PROGRAM.









                                          3






          5. TRANSFER OF THE AGREEMENT
             The license granted by this agreement cannot be transferred or
             sublicensed by the  customer to  any third  party without  the
             prior written permission of Xtreme.

          6. TERM AND TERMINATION
             The license will automatically terminate if you fail to comply
             with any term or condition of  this agreement. You agree  upon
             such termination  to  destroy  the licensed  program  and  all
             materials delivered therewith, along with any backup or  other
             copies in your possession.

          7. ENTIRE AGREEMENT
             YOU  ACKNOWLEDGE  THAT  YOU  HAVE  READ  THIS  AGREEMENT   AND
             UNDERSTAND  IT  AND  AGREE  TO  BE  BOUND  BY  ITS  TERMS  AND
             CONDITIONS. YOU  FURTHER AGREE  THAT IT  IS THE  COMPLETE  AND
             EXCLUSIVE  STATEMENT  OF  THE   AGREEMENT  BETWEEN  US   WHICH
             SUPERSEDES ANY PROPOSAL OR  PRIOR AGREEMENT, ORAL OR  WRITTEN,
             AND ANY  OTHER  COMMUNICATIONS  BETWEEN  US  RELATING  TO  THE
             SUBJECT MATTER OF THIS AGREEMENT.



































                                          4






                                      COPYRIGHT


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

          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.

                                          5






                                  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.

          X Appeal  is  packaged  on the  install  disks  using  Info-ZIP's
          compression     utility.  The installation program uses UnZip  to
          read zip files from the disks.   Info-ZIP's software (Zip,  UnZip
          and related utilities) is free and can be obtained as source code
          or  executables  from  various  anonymous-ftp  sites,   including
          ftp.uu.net, directory /pub/archiving/zip/*.


          MS-DOS  and  Microsoft   Windows  are   trademark  of   Microsoft
          Corporation.

          UNIX is a registered trademark of AT&T.

          Ethernet is a trademark of Xerox Corporation.

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

















                                          6






                                      CONTENTS


          CHAPTER 1 - INTRODUCTION                                9

          CHAPTER 2 - SYSTEM REQUIREMENTS                        11

          CHAPTER 3 - WHAT'S NEW IN VERSION 1.4                  13

          CHAPTER 4 - INSTALLING X APPEAL                        15

          CHAPTER 5 - STARTING X APPEAL                          33

          APPENDIX A - TROUBLESHOOTING                           35

          APPENDIX B - X WINDOW SYSTEM AND CLIENTS               37

          APPENDIX C - PROGRAMS IN THE X APPEAL PRODUCT          41

          APPENDIX D - XCONFIG PARAMETERS                        51



































                                          7





























































                                          8






                                      CHAPTER 1
                                    INTRODUCTION


          X Appeal is a DOS application for 386 machines developed for  the
          users who wish to turn their PC into a X Window System server.

          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 20000 Xstones in 1024x768
             resolution  with   256  colors   on   a  486SX/33   (no   math
             coprocessor).

          -  32 bit flat mode with virtual memory to remove restrictions on
             the number of client connections (more than 100 clients  could
             be handled even on a 2MB 386SX machine, providing enough space
             for swapping).

          -  Built-in TCP/IP  network  support,  using  the  packet  driver
             interface  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   easy
             connection to hosts running xdm).

          -  X-Authorization (MIT-MAGIC-COOKIE-1).

          -  Font compiler and RGB database utilities.

          -  Interactive installation and configuration utility.

          -  Can emulate a 3-button mouse with a 2-button mouse.

          -  Support for national keyboard layouts.






                                          9






          Documentation

          A printable version of this manual is included on the second disk
          of  the  installation  kit,  both  in  plain  ASCII  text  format
          (MANUAL.TXT) and  in  PostScript format  (MANUAL.PS).  The  ASCII
          version has no  MS-DOS line-drawing characters  to allow  viewing
          and  printing   on  any   environment;  therefore   the   graphic
          information in the Installation section showing the appearance of
          the screen when running the XINSTALL  program is missing in  this
          version.













































                                         10






                                      CHAPTER 2
                                 SYSTEM REQUIREMENTS

          The following hardware and software items are needed to run the X
          Appeal software package.

          Hardware Requirements

          Computer
          A Personal Computer with ISA, EISA or Vesa Local Bus architecture
          equipped with  a  386  or  higher  processor.  A  floating  point
          coprocessor is not required, but can help using PEX.

          Memory
          At  least  2  megabytes  of  memory  (4  megabytes  reccomended).
          Extended memory  can be  used when  configured with  XMS or  VCPI
          managers; DPMI is unsupported (therefore X Appeal cannot run from
          within a DOS window under MS Windows).

          Hard Disk
          A Hard  Disk with  at  least 2.5  megabytes  of free  space  (for
          executables) if using a font server. A total of 9 MB is  required
          for the installation when  using the local fonts  (13 MB if  also
          the optional 100dpi fonts are installed). Some more space can  be
          needed for swapping if running with the minimum amount of RAM.

          Floppy Disk
          A high-density 3.5-inch (or 5.25-inch) disk drive.

          Monitor
          A monitor with VGA resolution or better.

          Graphic Card
          A Super VGA card using a supported chipset.
          The current list of supported chipsets includes:

          Acumos AVGA2
          Ahead (V5000A, V5000B)
          ATI Technologies (18800, 28800, MACH8, MACH32)
          Avance Logic AL2101
          Chips & Technologies (82C452, 82C453)
          Cirrus Logic (GD5422, GD5424, GD5426, GD5428)
          Everex (Ev236, Ev620, Ev629, Ev673, Ev678)
          Genoa (6400, 7900)
          MXIC 68010
          NCR (77C22E, 77C22E+)
          Oak Technologies (OTI-067, OTI-077, OTI-087)
          Paradise (PVGA1A )
          Primus P2000
          Realtek (RT3106)
          S3 (86c911, 86c924, 86c801/805, 86c928)
          Trident (8900B, 8900C)
          Tseng Labs (ET3000, ET4000, ET4000/W32)
          Video Seven

                                         11






          Western Digital (WD90C00, WD90C10, WD90C11, WD90C30, WD90C31)

          Other drivers are under development.


          Ethernet Card
          An Ethernet Card with a compatible packet driver.

          Mouse
          A pointing device with a Microsoft Mouse compatible driver.




          Software Requirements

          Operating System
          MS-DOS or PC-DOS 3.30 or later.

          Mouse Driver
          A Microsoft Mouse compatible driver.

          Packet Driver
          Free collection included.































                                         12






                                      CHAPTER 3
                              WHAT'S NEW IN VERSION 1.4


          The new features  available in X  Appeal Version  1.4 are  listed
          below. Please refer to the relevant manual sections when needed.

          -  X Appeal Version 1.4 is based  on the MIT X11R5 Sample  Server
             source tree, updated to Patch Level 26 (the most recent one at
             the release date).

          -  Support for  Adobe Type  1 scalable  fonts has  been added;  a
             sample font is included in the distribution.

          -  Support for compressed bitmap fonts has been added; users  can
             choose to compress local fonts (by  means of a MS-DOS  version
             of the compress  utility or doing  the compression  on a  Unix
             machine), to save  some disk space.  The local font  directory
             must then be rebuilt using MKFNTDIR.

          -  The ASCII files in the font directories (FONTS.DIR, FONTS.ALI,
             FONTS.SCA) are now in the standard MS-DOS text format with CR-
             LF  line   terminators   (former   versions   used   only   LF
             terminators).

          -  The Display Class sent by the server to the xdm process when a
             XDMCP connection  is established  is  now "X-Appeal",  for  an
             easier configuration of xdm defaults.

          -  The right Control key is now  mapped as the Compose key;  this
             can be  useful  when  using national  keyboard  mappings  with
             diacritical characters. The default assignment of this key can
             be changed by means of the xmodmap utility.

          -  The keyboard  mappings for  all  the major  national  keyboard
             layouts are now included in the  distribution. The code to  be
             used for the mapping selection is the same used by the  MS-DOS
             KEYB utility.

          -  Several new video  drivers have been  added, and the  existing
             ones have  been  improved.  The  drivers  have  now  the  .GXN
             extension, to avoid improper use of the original video drivers
             in the  DJGPP  distribution. A  VESA  driver is  included,  to
             support VESA  compliant video  cards  which are  not  directly
             supported; the driver can anyway be  used only with VESA  BIOS
             extensions which can run in protected mode.

          -  An utility to detect the VGA chip used on the display card  is
             included in  the first  installation disk  (WHICHVGA.EXE);  in
             some cases the detection mechanism can fail to reset the video
             card in plain text  mode, and the  display can be  unreadable.
             Rerun WHICHVGA redirecting  the output to  a file, reboot  the
             machine and read the file contents.


                                         13






          -  X Appeal can now  work also when  memory managers like  EMM386
             are configured without EMS emulation (NOEMS option).

          -  A specific interrupt  vector for the  packet driver  interface
             can be  specified  during  installation;  this  overrides  the
             default search of  the first  packet driver  installed on  the
             machine (useful when two or more packet drivers are installed,
             and X Appeal must use a specific one).

          -  SLIP serial connections are now supported, allowing the use of
             X Appeal  through  modem  links.  A  fast  modem  (V32bis)  is
             recommended to obtain useful performance levels. In some cases
             the MSS value in XCONFIG must be set to a level lower than the
             default one.

          -  A set  of freeware  networking utilities  is included  on  the
             install disk 3, to help with  setups not using a plain  packet
             driver. Uncompress with UNZIP.EXE on the first disk and  refer
             to the included documentation for setup instructions. The  set
             includes:

             - PKTMUX12.EXE  a  packet  driver  multiplexer   useful  when
                             another TCP/IP  application  must  share  the
                             same  network  card  using  a  packet  driver
                             interface (self-extracting ZIP archive);
             - CONVERT.ZIP   a collection of converters to set up a packet
                             driver interface over NDIS drivers (DIS_PKT),
                             over ODI  drivers  (ODIPKT) and  over  Banyan
                             Vines (BANPKT);
             - SLIPPR13.ZIP  an  alternative  SLIP   driver  including   a
                             version handling Compressed SLIP.
























                                         14






                                      CHAPTER 4
                                 INSTALLING X APPEAL


          PC Installation

          If you do not know  the VGA chip used  on your display card,  you
          can run the utility  program WHICHVGA.EXE on  the first disk;  it
          will try to  determine the chip  brand and model  and the  driver
          needed during installation;  remember the driver  name and  start
          installation.  If  you  do  not  already  have  a  packet  driver
          installed on your machine, make sure  you know the model of  your
          network interface card and its hardware settings.

          Insert the disk labeled "X Appeal Disk 1" into drive A (or B) and
          type:

                                 C:\>a:xinstall
          or:
                                 C:\>b:xinstall


          Install Introduction





                   Welcome to the X Appeal Installation Program !
                   X Appeal is Copyright  (c)  1992  Xtreme s.a.s.


          This program will install the X Appeal X Server on your computer.

             Press the Alt-X key at any time to abort the installation.
              Press the F1 key to get a context-sensitive Help screen.

           Many questions have a default answer. If the default answer is
                  correct, press the ENTER key to accept the value.
               Otherwise type the answer and then press the ENTER key.

                    Do you want to continue installation (Y/N) ?


          [F1]=Help                                         [Alt-X]=Exit






          If you press "N" you exit the installation and go back to the Dos
          prompt, otherwise if  you want  to begin  the installation  press
          "Y".

                                         15






          If you want to  cancel the installation, you  can do it in  every
          moment just by pressing ALT+X.
          If you need help during installation press the F1 key.


          Drive and Directory selection




           [ Disk drive and directory]

            You must specify the Disk Drive and the Directory on which to
                                  install X Appeal

           Disk Drive    C

           Directory     XAPPEAL

                                                          [ESC]=Cancel




          Disk Drive

          Enter the drive  where you  want to  install X  Appeal and  press
          ENTER.
          The default drive is C.

          Directory

          Enter the  directory on  the selected  drive  where you  want  to
          install X Appeal and press ENTER.
          The default directory is \XAPPEAL.





                         Accept Information (Y/N) ?  N





          If you type "Y" you accept  Disk and Directory selection and  you
          proceed with  the Network  Configuration, otherwise  if you  type
          "N", you go back to the drive selection.






                                         16






          Network Configuration





            You can use a BOOTP Server to get Network parameters such as:
           MyIP address, Gateway address, Netmask and NameServer address.
                      Otherwise you can specify them directly.

                     Do you want to use a BOOTP server  (Y/N) ?

                                                          [ESC]=Cancel




          If you want to use a  BOOTP server you must press "Y",  otherwise
          "N".
          When using BOOTP, a broadcast request for a server is sent on the
          network.


          BOOTP server selection




          [ Configure  Network ]

          BOOTP Time Out           30


          Domains  List
          Domain  Name Server  Time  Out     120
          Maximum  Segment   Size  (MSS)     1400
          Packet Driver Vector (hex)    .
          Ethernet card
                                                          [ESC]=Cancel





          BOOTP Time Out

          Insert the Time  Out value  in seconds  for the  answer from  the
          BOOTP server. The default value is 30.







                                         17






          Domains List

          This is the comma-separated list of the Domain names that  can be
          used when querying  a Domain Name Server  for the name-to-address
          translation.

          Domain Name Server Time Out

          Insert the Time  Out value  in seconds  for the  answer from  the
          Domain Name Server . The default value is 120.

          Maximum Segment Size

          This parameter  can  be  used  to set   the Maximum Segment  Size
          for the Ethernet board  you are using. Some  old boards and  SLIP
          connections may require  a smaller  value. The  default value  is
          1440.

          Packet Driver Vector

          This parameter  can  be  used to  select  a  particular  software
          interrupt vector for the packet driver interface (useful when two
          or more packet drivers are installed on the same machine, and one
          must be selected for X Appeal).  If this parameter is omitted,  a
          search is done and the first packet driver found is used.

          Ethernet card




                     3Com 3C501
                     3Com 3C503
                     3Com 3C505
                     3Com 3C507
                     3Com 3C523
                     Arcether
                     AT&T
                     AT&T_LP
                     BICC ISOLAN 4110
                     D-Link DE-600
                     David Systems Inc
                     Digital Equipment Corp.




          Use the arrows to highlight your Ethernet card and press ENTER to
          activate that selection.






                                         18






          After your selection, the following Message Box will appear:





                         Accept Information (Y/N) ?  N





          If you  type "N",  you go  back to  the Configure  Network  Menu,
          otherwise if you type "Y", you proceed with Font Configuration.


          No BOOTP protocol selection




          [ Configure  Network]

          IP Address           .  .  .
          Net Mask             .  .  .
          Gateway  Address     .  .  .
          Domain Name Server Address .  .    .
          Domains  List
          Domain Name Server Time  Out  120
          Maximum  Segment   Size  (MSS)     1400
          Packet Driver Vector (hex)    .
          Ethernet card

          [F10]=Confirm                                   [ESC]=Cancel




          IP Address

          Each machine   (including X servers)  on  a  network must have  a
          unique IP address.  You will  get this address from your  network
          administrator.

          Net Mask

          If your network is divided into subnets, you need to specify  the
          right subnet mask for  your  local subnet  (also called simply  a
          Netmask).  If  your network is not divided in this way, then  you
          need to specify the right subnet mask for the  network class  you
          are  using.    Get   this    information     from  your   network
          administrator.



                                         19






          Gateway address

          If your network  uses one  or more  gateways to  connect it  with
          other networks,  the X  server needs  to know  the address  of  a
          gateway to communicate  out of the  local network.  If you  don't
          have a gateway, don't configure any address.

          Domain Name Server Address

          Insert the address of the Name server.

          Domains List

          This is the comma-separated list of the Domain names that  can be
          used when querying  a Domain Name Server  for the name-to-address
          translation.

          Domain Name Server Time Out

          Insert the Time  Out value  in seconds  for the  answer from  the
          Domain Name Server . The default value is 120.

          Maximum Segment Size

          This parameter  can  be  used  to set   the Maximum Segment  Size
          for the Ethernet board  you are using. Some  old boards and  SLIP
          connections may require  a smaller  value. The  default value  is
          1440.

          Packet Driver Vector

          This parameter  can  be  used to  select  a  particular  software
          interrupt vector for the packet driver interface (useful when two
          or more packet drivers are installed on the same machine, and one
          must be selected for X Appeal).  If this parameter is omitted,  a
          search is done and the first packet driver found is used.



















                                         20






          Ethernet card




                     3Com 3C501
                     3Com 3C503
                     3Com 3C505
                     3Com 3C507
                     3Com 3C523
                     Arcether
                     AT&T
                     AT&T_LP
                     BICC ISOLAN 4110
                     D-Link DE-600
                     David Systems Inc
                     Digital Equipment Corp.




          Use the arrows to highlight your Ethernet card and press ENTER to
          activate that selection.
          After your selection, the following Message Box will appear:





                         Accept Information (Y/N) ?  N





          If you  type "N",  you go  back to  the Configure  Network  Menu,
          otherwise if you type "Y", you proceed with Font Configuration.


          Font Configuration





             You can use Local Fonts or access them using a Font Server.
          The use of Local Fonts will require at least 6.5 Mb of disk space

                      Do you want to use a Font Server (Y/N) ?






                                         21






          If some host on your network is running a X11R5 font server,  you
          can use it to provide the fonts to X Appeal, instead of having  a
          local copy of the fonts.

          If you want to use a Font Server you must press "Y".
          If you want to install the local X Appeal fonts press "N".


          Font Server Configuration





           [ Configure Font Server ]


             Font Server Address .                 .   .    Connection
          Timeout  30

             Font Server Port  7000

                                                          [ESC]=Cancel




          Font Server Address

          Enter the IP Address of the host where  the X11R5 font server  is
          running

          Connection Timeout

          Insert the timeout for the connection  with the font server.  The
          default value is 30 seconds.

          Font Server Port

          Enter the  Port Number  for the  connection to   the  X11R5  font
          server. The default value is 7000.














                                         22






          After the  value  has been  accepted  with ENTER,  the  following
          Message Box will appear:





                          Accept Information (Y/N) ?     N





          If you type "N" you go back to the Configure Font Menu.
          If you type  "Y" you accept  the Font  Configuration and  proceed
          with the Keyboard Configuration.


          Local Fonts Installation





          You can install the optional 100dpi fonts (4 Mb more disk space)

              Do you want to install the Optional 100dpi Fonts (Y/N) ?





          If you want  to install also  the set of  optional 100dpi  fonts,
          type "Y", otherwise type "N".

          After the choice  has been specified,  the following Message  Box
          will appear:





                          Accept Information (Y/N) ?     N





          If you type "N" you go back to the Configure Font Menu.
          If you type  "Y" you accept  the Font  Configuration and  proceed
          with Keyboard Configuration.




                                         23






          Keyboard Configuration





           [ Configure Keyboard ]


            Allow Exit using Ctrl-Alt-Backspace  (Y/N)

            Handle NumLock on Xserver (L) or Remotely (R)

            Select Keyboard Layout:


                                                         [ESC]=Cancel




          Allow Exit via Ctrl-Alt-Backspace

          If you want to log  out, you can use  the "Exit" key. The  "Exit"
          key is activated by holding down  the "CTRL" and the "ALT"  keys,
          simultaneously pressing  the "BACKSPACE".  If you  want to  allow
          this "Exit" activation, type "Y" otherwise type the "N" key.

          Handle NumLock Locally on the Xserver or Remotely

          If you want  to handle the  NumLock locally on  the Xserver  type
          "L", otherwise  type "R".  If you  choose "R",  the server  sends
          virtual key-events so applications can use the numeric keypad.

          Keyboard Layout Selection




                                    US
                                    UK
                                    IT
                                    GR
                                    FR




          Use the arrow keys  to highlight your  keyboard layout and  press
          ENTER to activate that selection.





                                         24






          After your selection, the following Message Box will appear:





                          Accept Information (Y/N) ?     N





          If you type "N" you go back to the Configure Keyboard Menu.
          If you type "Y" you accept  the Keyboard Configuration and go  on
          with the mouse configuration.


          Mouse Configuration





                   If you have a two-button mouse, you can emulate
                                  the third button
                     by pressing both buttons at the same time.

                   Do you want to emulate the third button (Y/N) ?





          If you have a mouse which has only two physical buttons and  want
          to enable  the emulation  of the  third  mouse button  type  "Y",
          otherwise type "N".
          The  third   button  is   emulated  by   pressing  both   buttons
          simultaneously.
          After your selection you continue with the Display Configuration.
















                                         25






          Display Configuration




          [Configure Display]

          Super VGA Board:
                              Acumos AVGA2
                              Ahead V5000 Version A
                              Ahead V5000 Version B
                              ATI Technologies 18800
                              ATI Technologies 28800
                              Avance Logic AL2101
                              Chips & Technologies 82c452

                                                       [ESC]=Cancel




          Super VGA Board

          Use the arrows to highlight your super VGA board and press ENTER.




          [Configure Display]

          Super VGA Board:                        Selected board

          Video Modes:
                              640x350
                              640x400
                              640x480
                              720x512
                              800x600
                             1024x768
                             1280x1024

                                                       [ESC]=End













                                         26






          Video Modes

          Your display card and monitor combination may allow more than one
          video mode to be selected. Check your hardware documentation. The
          most common modes are 640x480, 800x600, 1024x768, 1280x1024.
          Use the arrows to  highlight your selection  and press ENTER  for
          each video mode you want to  include in your list. The first  one
          in the list will be the default display mode at startup.
          Internally the  list is  converted into  a circular  list;  using
          Ctrl+Alt+KeypadPlus or Ctrl+Alt+KeypadMinus  the current  display
          mode may be changed, and the  next or previous entry in the  list
          will be configured.




          [Configure Display]

          Super VGA Board:                        Selected board

          Video Modes:                            Selected modes

          Video Ram Size  <Kb>   1024    Virtual Display Size   1152  900

          Start View Address   0        0

                                                       [ESC]=Cancel




          Video Ram Size

          Insert the amount   of Video Ram installed  on your graphic  card
          (in KiloBytes).
          The default value is 1024, the maximum value is 1344.

          Virtual Display Size

          Set the virtual screen size. As an example you can use a physical
          resolution  of  800x600,  with  a  virtual  screen  of   1152x900
          (virtualX x virtualY). If  the mouse touches  the borders of  the
          display the image  scrolls accordingly; this  function is  called
          panning.
          The virtual display size you can select is related to the  amount
          of video RAM  installed on the  graphic card  (the above  example
          assumes 1 MB). Graphic  cards equipped with  512KB can work  only
          with a virtual  screen size slightly  greater than 800x600  (i.e.
          832x630).
          Some S-VGA Board can work only with some values of the horizontal
          virtual display size (e.g. older S3 chips work only with 640  and
          1024; newer models support some other values).
          The product  of virtualX by virtualY must be less then 1376256.


                                         27






          Start View Address

          Set the upper left corner of the physical display in the  virtual
          display.

          After the  selection of  the Start  View Address,  the  following
          message box will appear:





                          Accept Information (Y/N) ?     N





          If you type "N" you go back to the Configure Display Menu.
          If you  type "Y"  you accept  the Display  Configuration and  the
          installation program continues with the Activation Method.


          Activation method




          [Activation method]

                 You can start your session using XDM (X Display Manager).
                 The X server can find a XDM in one of three ways:
                 - it can send a Query to a specific host that is running
                   the XDM program
                 - it can send a Broadcast message to the network to find
                   any host that is running the XDM program
                 - it can send a message to a host running the XDM program
                   that will show a list of the hosts accepting
                   connections using an indirect query through the chooser
                   program

                 Enter (Q) query, (B) broadcast or (I) indirect     Q

                                                       [ESC]=Cancel




          If you select Q  or I, the installation  program will ask the  IP
          address to which  you want  to send  the XDMCP  request. You  can
          override this  value  at  run time,  by  specifying  a  different
          address on the command line.



                                         28









          [Activation method]

                 You can start your session using XDM (X Display Manager).
                 The X server can find a XDM in one of three ways:
                 - it can send a Query to a specific host that is running
                   the XDM program
                 - it can send a Broadcast message to the network to find
                   any host that is running the XDM program
                 - it can send a message to a host running the XDM program
                   that will show a list of the hosts accepting
                   connections using an indirect query through the chooser
                   program

                 Enter (Q) query, (B) broadcast or (I) indirect

                 Host IP Address  .  .  .
                                                       [ESC]=Cancel




          After the selection of the Host IP Address, the following message
          box will appear :





                          Accept Information (Y/N) ?     N





          If you type "N" you go back to the Activation Method Menu.
          If you  type  "Y"  you  accept  the  Activation  Method  and  the
          installation program begins the archive extraction.















                                         29






          Packet driver installation

          When the archive  extraction is complete,  an additional step  is
          needed before  running  X  Appeal. The  packet  driver  for  your
          Ethernet board has been copied to the DRV\NET subdirectory of the
          path you specified at the beginning of the installation, together
          with the INSTALL.DOC file which can  be useful to see the  packet
          driver parameters to be specified (depending on your board jumper
          settings). If you do not already have a packet driver  installed,
          you have to add the command  to install it to your  AUTOEXEC.BAT,
          or to another batch file to be run before starting X Appeal.  The
          software interrupt for the packet driver must be between 0x60 and
          0x7f.

          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
          using a board configured  for IRQ 3 and  I/O address 0x280;  Dual
          Port RAM is configured  at 0xd000:0. Depending  on the brand  and
          model of the Ethernet board, the parameters may vary.

          Packet driver  support  and  updates are  available  from  Crynwr
          Software.



          Configuration parameters

          The 32  bit DOS  extender  included in  X  Appeal looks  for  the
          environment variables GO32TMP, XAPTMP, TMP, TEMP (in that  order)
          to locate the  directory where to  create the swap  file used  to
          implement virtual memory. If none is set, it defaults to the root
          directory of the current drive.

          The configuration file XCONFIG is created by the XINSTALL utility
          during installation.
          The XCONFIG location  can optionally  be changed  by setting  the
          XCONFIG environment variable to the  directory where the file  is
          located; this can be useful in network configurations where all X
          Appeal files are on a file server.

          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.









                                         30






          Activation of the rcp and rsh server functions

          X Appeal  contains  a  rcp  and  rsh  server  which  allows  file
          transfers  to/from  the  PC  and  the  execution  of  useful  DOS
          functions, without leaving the X environment.

          The rcp and rsh server functions  are enabled by creating a  file
          named RCPUSERS in the X Appeal installation directory, containing
          the user  IDs (one  ID for  each  line) 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 to all users.
          The file  location  can  optionally be  changed  by  setting  the
          RCPUSERS environment variable to the directory where the file  is
          located; this can be useful in network configurations where all X
          Appeal files are on a file server.

          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 Unix 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



                                         31






          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 '/'.

          Some usage examples follow:

               rsh <yourPC> pwd
                    show your PC cuurent directory
               rcp unixfile <yourPC>:dosfile
                    copy unixfile to dosfile on the PC current directory
               rcp <yourPC>:dosfile unixfile
                    copy dosfile on the PC current directory to unixfile
               rsh <yourPC> ls -l
                    list the  files on  the PC  current directory  in  long
          format

          The usage  of the  rcp and  rsh commands  can be  made easier  by
          setting some shell aliases.































                                         32






                                      CHAPTER 5
                                  STARTING X APPEAL


             To start X Appeal, issue the command

                   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.

          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  (the IP address  of
          the host(s) to be  enabled must be listed  in the X0.HOS file  in
          the same directory where the  XAPPEAL.EXE file is installed,  one
          IP address on each line). 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.













                                         33





























































                                         34






                                     APPENDIX A
                                   TROUBLESHOOTING


          If some  problem  arises when  X  Appeal is  running,  the  error
          messages  are  recorded  in  the  file  ERRORS  in  the   current
          directory. If you cannot solve  the problem with the  indications
          included  in  the  error  messages,  send  a  performance  report
          including all  the  information  contained in  the  file  (e-mail
          preferred).

          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.

          If the screen shows strange patterns, or multiple cursor  images,
          your VGA card  is likely to  be unsupported by  X Appeal, or  you
          selected the wrong video driver. Try to identify the VGA chip  by
          using the WHICHVGA utility on the first installation disk; if the
          problem cannot be solved, please  send a report with  information
          about the VGA  card, the  chipset it  uses, the  amount of  video
          memory.

          Errors during  startup  related  to  the  Packet  Driver  can  be
          generated  by  an   incorrectly  installed   driver.  Check   the
          parameters, which  must match  with  the Ethernet  card  hardware
          configuration.

          The message "CPU must be in REAL mode (not V86 mode) to run  this
          program" appears when trying  to run X Appeal  from within a  DOS
          window in the  MS Windows environment,  or when  some 386  memory
          manager has been installed in CONFIG.SYS, with settings that  are
          not compatible with X Appeal (e.g. DPMI mode). Run X Appeal  from
          plain DOS and/or modify the memory manager settings or remove it.





















                                         35





























































                                         36






                                     APPENDIX B
                             X WINDOW SYSTEM AND CLIENTS

          X Window System

          The X Window System is a network-based graphics windowing system.
          It was developed  by the Massachussetts  Institute of  Technology
          (MIT).
          The architecture of the X Window  System is based on the  client-
          server model.
          The system is divided into two parts:
               1) the display server
               2) the client.
          The X architecture allows the two  parts to work together on  the
          same machine or to  reside on different  machines connected by  a
          network, as implemented by X Appeal.

          The X Display Server

          The X Display Server is a program that manages all input from the
          input devices, such as  keyboard and pointing devices,  conveying
          it to the client applications; the server also manages the output
          from the client and updates the display to reflect that output.
          User input and other informations are  passed from the server  to
          the client  in  the form  of  events. An  event  is a  packet  of
          information that tells the client to perform an action. When  the
          client receives a meaningful event, it sends back to the server a
          display request; at this point the server performs the update  on
          his display.
          Events and display requests  are communicated across the  network
          using the X protocol.
          As implemented by X  Appeal, the display server  resides on a  PC
          Dos, while the clients reside on a host computer.
          In this way the client program runs on the more powerful  system,
          and the display  server can use  all the resources  of the PC  to
          display graphics, track the mouse and use the keyboard functions.

          Clients

          A client  is a  program application  that displays  in a  private
          window. An X  client, generally, displays  his results and  takes
          input  from  a  single  display  server;  in  addition  a  client
          sometimes  need   to   communicate  with   other   clients.   The
          communication between clients  is based on  use of properties.  A
          property contains informations  on a client,  accessible  to  the
          other clients.
          At the moment, there are more than 50 clients programs  available
          from the MIT and X allows you to run many of them simultaneously.







                                         37






          X Window Clients

          The Window Manager

          Window management functions  are provided  by a  type of  program
          called window manager.  The window manager  controls the  general
          operations of the window system, allowing the user to change  the
          size and position of  windows on the display. The window  manager
          provides the "look and feel" of the X Window System.
          In the standard distribution of X  from MIT, the official  window
          manager is called twm ("Tom's window  manager", in honour of  its
          developer).
          Other popular window managers are:

          uwm, the "universal window manager", available as part of the MIT
          X distribution.

          awm, the ArdentTM window manager

          mwm, the OSF/MotifTM window manager

          olwm, the OPEN LookTM window manager

          rtl, the tiled window manager, developed at Siemens Research  and
          Technology Laboratories.


          XTerm

          Xterm is the  terminal emulator of  X. It emulates  a DEC VT  102
          terminal or a Tektronix 4014 terminal.  X11 has been designed  to
          support only bitmapped  graphic. Xterm gives  the possibility  to
          log in to a multiuser system and to run applications designed for
          alphanumeric terminals.


          The Display Manager

          Xdm, the display manager, is the login daemon for X, and has been
          designed to start the X server  automatically. A list of  servers
          is kept  in a  configuration file  and user  can customize  their
          sessions,  automatically  running  several  clients  and  setting
          personal resources.


          Other X Clients

          DESK ACCESSORIES

          xbiff      Mail notification program.

          xclock, oclock Analog/digital clock applications.

          xcalc      Scientific calculator.

                                         38







          xload      System load monitor.

          xman       Manual page browser.

          xkill      Terminates a client application.

          xedit      Text editor for X.

          DISPLAY AND KEYBOARD PREFERENCES

          xset       It is used to control server parameters, such as bell
                     volume, key  click,  mouse acceleration,  and  screen
                     saver operations.

          xmodmap    it gives  the possibility  to map  keyboard keys  and
                     mouse buttons to particular functions.

          FONT UTILITIES

          xlsfonts   Server font list displayer for X.

          xfd        Font displayer for X.

          xfontsel   It is used to select a font for another application.

          GRAPHIC UTILITIES

          bitmap     Bitmap editor for X.

          atobm, bmtoa   Converts   ASCII   characters   to   bitmaps   and
                     viceversa.

          PRINTING APPLICATIONS

          xwd        Dump an image of an X window into a file.

          xpr        Translates an image produced  by xwd to a  PostScript
                     or a printable format.

          xwud       Redisplays an image produced by xwd.

          DISPLAY AND WINDOW UTILITIES

          xload      Load average display for X.

          xlsclients List the clients running on the display.

          xdpyinfo   Lists characteristics of the display.

          xwininfo   List     s characteristics of a window.

          xprop      List the properties of a window.


                                         39





























































                                         40






                                     APPENDIX C
                         PROGRAMS IN THE   X APPEAL PRODUCT


          XAPPEAL

          XAPPEAL - X Window System server for 386 PC

          SYNOPSIS
          XAPPEAL [-option ...]

          DESCRIPTION
          XAPPEAL.EXE is the name of the X Window System server executable.

          STARTING THE SERVER
          The  server  is  usually  started  from  the  X.BAT  batch  file,
          automatically created during the installation procedure.

          NETWORK CONNECTIONS
          The X  server  supports  connections  made  using  the  following
          reliable byte-stream:

          TCP/IP
              The server listens on  port 6000+n, where  n is the  display
              number.

          OPTIONS
          The XAPPEAL server accepts the following command line options:

          -a number
              sets pointer acceleration  (i.e. the  ratio of  how much  is
              reported to how much the user actually moved the pointer).

          bc  disables  certain   kinds  of   error  checking,   for   bug
              compatibility with previous releases  (e.g., to work  around
              bugs in R2 and R3 xterms and toolkits). Deprecated.

          -bs disables backing store support on all screens.

          -cc class
              sets the visual class for the root window of color  screens.
              The class numbers are  as specified in  the X protocol.  Not
              obeyed by all servers.

          -co filename
              sets name of RGB color database.

          -dpi resolution
              sets the resolution of the screen,  in dots per inch. To  be
              used when the server cannot  determine the screen size  from
              the hardware.




                                         41






          -fc cursorFont
              sets default cursor font.

          -fn font
              sets the default font.

          -fp fontPath
              sets the  search  path  for fonts.  This  path  is  a  comma
              separated list of  directories which the  X server  searches
              for font databases.

          -help     prints a usage message.

          -r  turns off auto-repeat.

          r   turns on auto-repeat.

          -s minutes
              sets screen-saver timeout time in minutes.

          -su disables save under support on all screens.

          -t number
              sets pointer acceleration threshold in pixels (i.e.after how
              many pixels pointer acceleration should take effect).

          -to seconds
              sets default connection timeout in seconds.

          -wm forces  the  default   backing-store  of   all  windows   to
              beWhenMapped; a cheap trick way of getting backing-store  to
              apply to all windows.

          You can have the XAPPEAL server  connect to xdm using XDMCP.  For
          more information  on this  protocol, see  the X  Display  Manager
          Control Protocol specification. The following options control the
          behavior of XDMCP.

          -query host-name
              Enable XDMCP and send Query packets to the specified host.

          -broadcast
              Enable XDMCP  and broadcast  BroadcastQuery packets  to  the
              network.The first responding display manager will be  chosen
              for the session. This is the default.

          -indirect host-name
              Enable XDMCP and send IndirectQuery packets to the specified
              host.

          -once     Normally, the server keeps starting sessions, one after
              the other. This option makes the server exit after the first
              session is over.


                                         42






          -class display-class
              XDMCP has an additional  display qualifier used in  resource
              lookup for display-specific options.  This option sets  that
              value, by default it is "X-Appeal".

          -displayID display-id
              Yet another  XDMCP  specific  value,  this  one  allows  the
              display manager  to identify  each display  so that  it  can
              locate the shared key.

          SECURITY
          The X server implements a simplistic authorization protocol, MIT-
          MAGIC-COOKIE-1 which uses data private to authorized clients  and
          the server. This is a rather trivial scheme; if the client passes
          authorization data which  is the same  as the server  has, it  is
          allowed access. This scheme is  worse than the host-based  access
          control mechanisms in environments  with unsecure networks as  it
          allows any  host to  connect, given  that it  has discovered  the
          private key. But in many environments, this level of security  is
          better than the  host-based scheme  as it  allows access  control
          per-user instead of per-host.

          The X  server also  uses a  host-based  access control  list  for
          deciding whether or not to accept  connections from clients on  a
          particular machine. If no other authorization mechanism is  being
          used, this list initially consists of any machines listed in  the
          file <your_base_directory>/X0.hos. Each line  of the file  should
          contain either an Internet hostname (e.g. expo.lcs.mit.edu) or IP
          address (e.g.  192.47.65.23).  There  should  be  no  leading  or
          trailing spaces on any lines.
          For example:

              joesworkstation
              corporate.company.com
              192.77.21.50

          Users can  add or  remove  hosts from  this  list and  enable  or
          disable access  control using  the xhost  command from  the  same
          machine as the server.

          The X protocol intrinsically does not  have any notion of  window
          operation permissions or place any restrictions on what a  client
          can do; if a program can connect to a display, it has full run of
          the screen.

          FONTS
          Fonts are usually stored as individual files in directories.  The
          X server  can  obtain fonts  from  directories and/or  from  font
          servers. The list of  directories and font  servers the X  server
          uses when trying to open a  font is controlled by the font  path.
          Although most sites  will choose to  have the X  server start  up
          with the appropriate  font path (using  the -fp option  mentioned
          above), it can be overridden using the xset program.


                                         43






          The default font path for the X server contains four directories:

          <your_base_directory>/fonts/misc
          This directory contains many miscellaneous bitmap fonts that  are
          useful on all systems. It contains a family of fixed-width fonts,
          a family of fixed-width fonts from Dale Schumacher, several  Kana
          fonts from Sony Corporation, the standard cursor font, two cursor
          fonts from Digital  Equipment Corporation, and  cursor and  glyph
          fonts from Sun Microsystems.It also has various font name aliases
          for the fonts, including fixed and variable.

          <your_base_directory>/fonts/Speedo
          This directory  contains  outline fonts  for  Bitstream's  Speedo
          rasterizer. A single font face, in normal, bold, italic, and bold
          italic, is provided, contributed by Bitstream, Inc.

          <your_base_directory>/fonts/Type1
          This  directory  contains   outline  fonts  for   Adobe  Type   1
          rasterizer. A single font face, in normal, bold, italic, and bold
          italic, is provided, contributed by IBM Corp.

          <your_base_directory/fonts>/75dpi
          This  directory  contains  bitmap  fonts  contributed  by   Adobe
          Systems, Inc.,  Digital Equipment  Corporation, Bitstream,  Inc.,
          Bigelow and Holmes, and  Sun Microsystems, Inc.  for 75 dots  per
          inch displays.  An  integrated  selection  of  sizes,  styles,and
          weights are provided for each family.

          <your_base_directory>/fonts/100dpi
           This directory contains 100 dots per inch versions of the  fonts
          in the 75dpi directory. It  is useful when using  high-resolution
          displays.

           Font databases are created by  running the mkfnntdir program  in
          the directory containing the compiled versions of the fonts  (the
          .pcf files).Whenever fonts  are added to  a directory,  mkfnntdir
          should be rerun  so that the  server can find  the new fonts.  If
          mkfnntdir is not  run, the server  will not be  able to find  any
          fonts in the directory.

          DIAGNOSTICS
          They are sent to standard output,  and should be redirected to  a
          file for diagnostic purposes.

          FILES
          <your_base_directory>/X0.hos  Initial access control list

          <your_base_directory>/fonts/100dpi
          <your_base_directory>/fonts/misc,
          <your_base_directory>/fonts/75dpi, Bitmap font directories

          <your_base_directory>/fonts/Speedo,
          <your_base_directory>/fonts/Type1  Outline font directories


                                         44






          <your_base_directory>/fonts/PEX    PEX font directories

          <your_base_directory>/rgb/rgb.pag
          <your_base_directory>/rgb/rgb.dir  Color database

          <current_directory>/errors    Error log file

















































                                         45






          RGB.EXE

          Compile a rgb color-name database.

          SYNOPSIS
          rgb [ database ]

          DESCRIPTION
          The rgb program reads from standard input a rgb  color-name  text
          source file and converts it to  a compiled form for use with  the
          dbm database routines.
          The  default  database is the one that X was built with, and  may
          be overridden on  the command line.   Specify  the database  name
          without the .pag or .dir suffix.



          SHOWRGB.EXE

          Uncompile a rgb color-name database.

          SYNOPSIS
          showrgb [ database ]

          DESCRIPTION
          The showrgb program reads an rgb  color-name  database   compiled
          for use with the  dbm database routines and  converts it back  to
          source form, printing the result to standard output.
          The  default  database is the one that X was built with, and  may
          be overridden on  the command line.   Specify  the database  name
          without the .pag or .dir suffix.
























                                         46






          BDFTOPCF.EXE

          Convert font  from  Bitmap  Distribution   Format    to  Portable
          Compiled Format.

          SYNOPSIS
          bdftopcf [-option ...] font-file.bdf

          DESCRIPTION
           Bdftopcf is the  release 5 font  compiler.  Fonts  in   Portable
          Compiled  Format  can  be read by any architecture, although  the
          file is structured to allow one particular  architecture to  read
          them  directly  without reformatting.   This allows fast  reading
          on the appropriate machine, but the files are still portable (but
          read more slowly) on other machines.

          OPTIONS
          -pn  Sets the font  glyph padding. Each  glyph in  the font  will
               have each scanline padded in to a multiple of n bytes, where
               n is 1, 2, 4 or 8.

          -un  Sets the font scanline  unit.   When   the  font  bit  order
               is  different  from  the font byte order, the scanline  unit
               n describes  what   unit  of   data  (in  bytes)  are to  be
               swapped; the unit i can be 1, 2 or 4 bytes.

          -m   Sets the font bit order   to  MSB   (most  significant  bit)
               first.  Bits for  each glyph will be  placed in this  order;
               i.e. the left most bit on the screen will be in the  highest
               valued bit in each unit.

          -l   Sets the  font  bit order  to  LSB (least  significant  bit)
               first.   The left  most bit  on the  screen will  be in  the
               lowest valued bit in each unit.

          -M   Sets the font byte order to MSB first. All multibyte data in
               the file (metrics,  bitmaps and  every thing  else) will  be
               written most significant  byte first.

          -L   Sets the font byte order to LSB first. All multibyte data in
               the file  (metrics, bitmaps  and  everything else)  will  be
               written least significant  byte first.

          -t   When this option is  specified, bdftopcf will convert  fonts
               into "terminal" fonts  when possible.   A terminal font  has
               each glyph image  padded  to   the  same size; the X  server
               can usually render these types of fonts more quickly.








                                         47






          -i   This option  inhibits  the  normal  computation    of    ink
               metrics. When a font has glyph images which do not fill  the
               bitmap  image   (i.e. the  "on" pixels don't  extend to  the
               edges of the  metrics)  bdftopcf  computes   the actual  ink
               metrics and  places them  in the  .pcf file;  the -t  option
               inhibits this behaviour.

          -o <output-file-name>
               By default bdftopcf writes the pcf file to standard  output;
               this option gives the name of a file to be used instead.













































                                         48






          MKFNTDIR

          Create fonts.dir file  from  directory  of  font files.

          SYNOPSIS
          mkfntdir [directory-names]

          DESCRIPTION
          Mkfntdir For each  directory argument, mkfntdir   reads   all  of
          the font files  in the directory  searching for properties  named
          "FONT", or (failing that)  the name of the  file stripped of  its
          suffix. These are used  as font names, which  are written out  to
          the file  "fonts.dir"  in  the  directory along with the name  of
          the font file.
          The kinds of font files read by mkfntdir depends on configuration
          parameters,  but  typically   include  PCF  (suffix ".pcf"),  SNF
          (suffix ".snf")  and BDF  (suffix ".bdf").  If a  font exists  in
          multiple formats, mkfntdir  will first choose  PCF, then SNF  and
          finally BDF.

          SCALABLE FONTS
          Because scalable font  files do not  usually include  the X  font
          name, the  fonts.dir file  in directories  containing such  fonts
          must be edited by hand to  include the  appropriate entries   for
          those   fonts.   However,  when mkfntdir  is  run, all  of  those
          additions will be lost, so be careful.

          FONT NAME ALIASES
          The file "fonts.alias" which can be  put in any directory of  the
          font-path   is   used to  map new  names to  existing fonts,  and
          should be  edited by  hand.   The format  is   straight   forward
          enough,  two  white-space separated columns, the first containing
          aliases and the second containing font-name  patterns.
          When a font alias is used, the name it references is  search  for
          in  the  normal manner, looking  through each  font directory  in
          turn. This means that the aliases need not  mention fonts in  the
          same directory as the alias file.
          To embed  white-space  in either  name,  simply enclose  them  in
          double-quote  marks,   to   embed   double-quote   marks (or  any
          other character), precede them with back-slash:
          "magic-alias with spaces"     "\"font\name\" with quotes"
               regular-alias  fixed
          If the string "FILE_NAMES_ALIASES" stands  alone on a line,  each
          file-name  in  the directory (stripped  of it's  suffix) will  be
          used as an alias for that font.

          USAGE
          Both the X server  and the Font Server  look for "fonts.dir"  and
          "fonts.alias" files in each directory in the font path each  time
          it is set.





                                         49





























































                                         50






                                     APPENDIX D
                                 XCONFIG PARAMETERS


          The configuration file XCONFIG is created by the XINSTALL utility
          during installation. This  appendix contains  the description  of
          the keywords in the configuration file.

          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      specify      a       fontpath      of      the       form
          "tcp/<fontserver_hostIP>:<port>, and  to  correctly  set  its  IP
          address and TCP port number (the default is 7000).

          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 keyword:
            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.


                                         51






          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.
            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.
            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.



























                                         52
