Welcome to XTeXShell, the X-Windows shell for TeX using Tcl/Tk
--------------------------------------------------------------

Version 0.91 beta (2/21/1994)


Compatibility:

    - XTeXShell was written in Tcl/Tk with extensions and will run most
      probably on all operating systems which support Tcl/TK *and* TclX.


Requirements:

    - X-Windows (X11R5)
    - Tcl/Tk *and* the TclX extensions
    - XTeXShell makes sense only if you have a working TeX environment
      with programs like tex, latex, dvips, xfig,... (not all needed).


How to install XTeXShell ?

    1)  Choose a parent directory, where XTeXShell should be installed.
        Usually /usr/local/src is a good choice. Copy the file
        XTeXShell-0.91.tgz there and unpack with

           tar xzf XTeXShell-0.91.tgz

        tar will create a new directory './XTeXShell-0.91' and will unpack
        the files to this directory

    2)  Create a link from one of your bin directories to the executable
        xtexsh

           ln  /usr/local/src/XTeXShell-0.91/xtexsh  /usr/bin/xtexsh

    3)  If you have installed XTeXShell to a directory other than
        /usr/local/src/XTeXShell-0.9, you will need to set a path-variable
        in the file xtexsh:

           - edit 'xtexsh' and set the variable 'xtexsh_path' in the 4th line
             to the directory you have chosen.

    4)  If your TclX interpreter is in a directory other than

            /usr/X11/bin/wishx
          
        you must edit the first line of the file xtexsh and insert the correct
        path.

    5)  Make sure to read the file 'LICENSE'

    6)  That's it. Go ahead and start with 'xtexsh'



    A)  If you update from a previous version of XTeXShell:

           - delete all files of the old XTeX release.

           - remove the link you made to xtex in your directory /usr/bin

           - the names of your private setup files have changed from
             .xtex.setup to .xtexsh.setup. If you haven't worked with the
             setup files, that's fine, you don't need to change anything.

             If you have created your own setup files, you can rename
             them to the new name. However, if you want to use all features
             of the new version, you should delete the old setup files and
             generate new setup files (see file README).


    B)  If you want to use TFC, a text file format converter, compile TFC.CC
        with a C++ Compiler and make a link to one of your 'bin' directories.
        On my 486DX Linux System for example:

           g++ -O2 -m486 -o tfc tfc.cc
           ln tfc /usr/bin/tfc


The following 2 items are for experts only:

    C)  If you wish to run the script "upd", make sure that

           - The Path to the Tcl-Interpreter "tclsh" is set in the PATH
             Variable. (That means that you can start "tclsh" from your
             command prompt)

           - If your Path for "tclsh" is not /usr/bin/tclsh, you need to
             modify the first line of the file help/convhelp.

    D)  If you wish to run the script bitmaps/mkbitmaps, make sure that
        the g++ (GNU-C++) Compiler is installed. If you have a C++ Compiler
        other than g++, you need to change the compiler call in this file.


Customization:

    If you encounter any problems or want to customize XTeXShell to your
    environment, try modifying the setup files.  Please refer to the section
    'setup' in the manual ('xtexshell.tex') to find out how the setup files
    work.


Error reports and flames:

    Please send error reports and your comments (if you like) on this
    program to

        hofmann@vipmzw.physik.uni-mainz.de


How you can help:

    The help pages are far from being complete.  Furthermore, some of them
    are buggy and probably full of grammatical errors (English isn't my
    native language...).  If you find errors, please send my a notice.  If
    you like, please write help pages for missing commands and TeX/LaTeX
    extensions.

    If you succeed in installing XTeXShell on operating systems other than
    Linux, please send me a notice.

    Many thanks


Future:

    For the next updates, you can expect:

       - complete help pages for LaTeX and help for NFSS and LaTeX2e
       - help page description converted to HTML.
       - ???? (what would you like?)


    If people like this program, it is planned to develop an IDE for the GNU
    C/C++ and Pascal compilers. Any volunteers (especially for the help
    system)?
                              
