This is a VMS version of Xterm, the VT102 and Tektronix 4014 emulator for
Xwindows.  This version is known to work under VMS 5.1-1, 5.2 and 5.3.

There are a number of features of Xterm that are not implemented under VMS
either because they do not make sense in VMS or because I didn't have the
time to make them work.

There are two important points about the behavior of the VMS version of
Xterm.

   o   The terminal only has input focus (ie. accepts keyboard input) when
       the window is both selected (ie. the top of the window is highlighted)
       and the cursor is in the terminal window.

   o   The display is not set in the Xterm session.  This means you can
       not run DECwindows applications (such as XDVI) from that terminal
       without first typing SET DISPLAY/CREATE (or defining DECW$DISPLAY).

This version of Xterm is capable of setting the terminal width and page 
size based on the geometry specified either in the command line or using
the Xdefaults (in the file sys$login:decw$xdefautls.dat).  The Xterm
executable must be installed with the privileges SHARE and PHY_IO in
order to do this.

Starting up Xterm

VMS 5.2 or before

   We recommend that Xterm be started when you login to your DECWindows
   session.  To do this you can enter the following commands in the file
   SYS$LOGIN:DECW$LOGIN.COM

       $XTERM := $DISK:[DIR]XTERM.EXE
       $SPAWN/NOWAIT/IN=NL: XTERM  [options]

   where DISK:[DIR] is the disk and directory where the Xterm executable
   resides, and [options] are any of the command line options for Xterm
   (see Xterm.hlp).


VMS 5.3

   Xterm can be started at any time from the session manager by defining
   an Xterm menu entry.  To define an Xterm menu entry do the following:

        Select the Applications Definitions... item from the session
        manager's Customize menu. Fill in the two lines at the bottom
        of the dialog box as follows:

            Xterm
            RUN DISK:[DIR]XTERM.EXE
        
        Where DISK:[DIR] is the disk and directory where the Xterm excutable
        resides.  After filling in these two lines click the ADD and OK
        buttons to add Xterm to the list.  Select the Applications menu...
        item from the session manager's Customize menu and scroll down the
        list on the left side of the dialog box and select Xterm.  After
        you click on the OK button Xterm will be in the session manager's
        Applications menu.
    
    At this point you can start an Xterm session.  You can also start up
    one or more Xterm session at login time by choosing Xterm in the dialog
    box that appears when you select the Auto start... item of the session
    manager's Customize menu.

Xdefaults

    You can define the Xdefaults of Xterm by entering the defaults in a 
    file called SYS$LOGIN:DECW$XDEFAULTS.DAT (see Xterm.hlp for more 
    information).  The following is an example of this file

    wm*default.startupFocus:    TRUE
    wm*flash:                   TRUE
    xterm*geometry:             80x50-10+50
    xterm*c132:                 TRUE
    xterm*pointerColor:         blue
    xterm*scrollBar:            TRUE
    xterm*cursorColor:          red
    xterm*Scrollbar.foreground: green
    xterm*borderColor:          orange
    xterm*font:  -DEC-Terminal-Medium-R-Normal--14-140-75-75-C-8-ISO8859-1
    xterm*boldFont: -DEC-Terminal-Bold-R-Normal--14-140-75-75-C-8-ISO8859-1


Fonts

    It appears that a number of the "standard" X fonts are not available
    under DECWindows.  In order to find which fonts are available and what
    their full names are,  I have included a short program that prints the
    font names from the 75dpi directory path.  This program is called 
    LISTFONTNAMES.