			Abandon All Hope, Ye Who Enter Here


This is undoubtedly the most ugly program in the distribution.  It was one of
the first "serious" programs ported, and still has a lot of historical baggage.
Ideally, there would be a general tty widget and then vt102 and tek4014 
subwidgets so that they could be used in other programs.  We are trying to 
clean things up as we go, but there is still a lot of work to do.

If you are porting this to a machine that has problems with overlapping
bcopy's, watch out!

There are two documents on xterm: the man page, xterm.man, which describes
how to use it, and ctlseqs.ms, which describes the control sequences it
understands.

-------------
Installation instructions.

  1) To compile, type: 

     xmkmf
     make

     (Skip this step to use included precompiled binaries)


  2) To install, type: 

     sh install.sh
     
     (This installs these files: ansi_xterm  resize  XTerm-ansi  vga.pcf)



Additions by Ton (Document updated by Mark Rejhon):
  - Applied the ansi-xterm patches like it existed in the linux dosemu
    directory on the R6-xterm (this gives you essentially a color xterm +
    a few more DOS type extras)  This included fixing a few bugs that 
    survived al color-xterm generations) activated by the -DANSI 
    compilation option.  If you compile like this, you'd better install 
    by hand, using the name ansi_xterm for the executable and XTerm-ansi 
    as the appdefaults file.  (replace the old XTerm by the XTerm-ad here 
    and make a (symbolic) link from XTerm to XTerm-ansi, since the extra 
    entries don't clash with the ones from vanilla xterm)  The app-defaults 
    are usually put in /usr/lib/X11/app-defaults
  - xterm copies settings from the starting tty. However, if you don't start
    from a tty (e.g. through rsh) you often end up with disgusting tty
    settings. Compiling with -DSANE_TTY makes the defaults close to what you
    get from stty sane.
  - Will also compile on AIX ESA
  - Imakefile now also works for linux (but see above for install as 
     ansi-xterm)
  - The VGA font file 'vga.pcf' is included if you want to use the IBM PC
    character set.  Install this file in /usr/lib/X11/fonts/misc and
    then type "mkfontdir" while in that directory.  For a very nice
    looking, true IBM-ANSI emulation, use this command line:
    ansi_xterm -bg black -fg gray -font vga
    The normal color xterm can also do this, but does not emulate
    true IBM ANSI in all 16 colors.
  - fixed linux /var/adm/wtmp    handling    -> use -DWTMP
      "     "   /var/adm/lastlog   "         -> use -DLASTLOG
  - mixed in the XFree86 diffs
