===========================================================================

    teTeX installation instructions (using precompiled binaries)

===========================================================================

        1) getting the archives
        2) unpack the files with install.sh or manually:
          a) run install.sh
          b) manual installation
        3) post-installation
        A) appendix: overview about the files in this distribution

===========================================================================
 1) getting the archives
===========================================================================

If starting from nil, and you do not wish to recompile the binaries,
approximately the following sequence of commands will get the files you
need to install teTeX (replace /usr/local/temp with any temporal directory
where you have enough free space):

# mkdir /usr/local/temp
# cd /usr/local/temp
# mkdir binaries base doc fonts goodies
# ftp sunsite.informatik.rwth-aachen.de [substitute the archive nearest to you]
ftp> cd /pub/comp/tex/teTeX/current/distrib  [modify as needed for the given archive]
ftp> bin
ftp> dir binaries
ftp> prompt
ftp> mget install.sh base doc fonts goodies binaries/sparc-solaris.tar.gz
ftp> quit

You should look at the output of the "dir binaries" command and substitute
the appropriate file(s) in place of "sparc-solaris.tar.gz".

For a minimal installation you need the following files:
  install.sh
  base/latex-base.tar.gz
  base/tetex-base.tar.gz
  binaries/<the binary for your platform>

You can find an overview about the files in the distribution later in
this document for additional packages. Unless you are short of disk space,
I recommend to install the full distribution.

When you are done with the installation (below), you may go back and delete
the contents of /usr/local/temp.

===========================================================================
 2a) run install.sh
===========================================================================
To run install.sh, you need a sh compatible shell that knows the feature
of shell functions. /bin/sh is ok on most systems, but on Ultrix, you
cannot use /bin/sh. Use /bin/sh5 or bash instead. Then run the install.sh
script with that shell. Similar with AIX-4.x.y: there you can use /bin/bsh
instead of /bin/sh (which is the korn shell on these systems :-(

Example 1:
        /bin/sh install.sh

Example 2: (Ultrix)
        /bin/sh5 install.sh

Example 3: (AIX-4)
        /bin/bsh install.sh

===========================================================================
 2b) manual installation
===========================================================================
  These instructions tell you how to install teTeX "by hand" into the
  default directories. Feel free to change the directory names as you
  like.

  - create the destination directories:
        mkdir -p /usr/local/teTeX/bin/sparc-solaris \
                 /usr/local/teTeX/share/texmf \
                 /usr/local/teTeX/man \
                 /usr/local/teTeX/info
  - set your umask to 0 to unpack with the correct permissions (or use
    the 'p' flag of tar, but this does not work with some broken tar versions)
  - unpack the archives you want to install:
        gzip -dc sparc-solaris.tar.gz \
          | (cd /usr/local/teTeX/bin/sparc-solaris; tar xvf -)
        # ... install other binaries
        gzip -dc info.tar.gz \
          | (cd /usr/local/teTeX/info; tar xvf -)
        gzip -dc man.tar.gz \
          | (cd /usr/local/teTeX/man; tar xvf -)
        # everything except binaries, info and man goes into texmf:
        gzip -dc tetex-base.tar.gz \
          | (cd /usr/local/teTeX/share/texmf; tar xvf -)
        gzip -dc latex-base.tar.gz \
          | (cd /usr/local/teTeX/share/texmf; tar xvf -)
        ...
  - make sure, the binaries are found along your PATH. Either create
    symlinks to a standard directory or change your PATH. Example:
       symlinks:
               ln -s /usr/local/teTeX/bin/sparc-solaris/* /usr/local/bin
       PATH change sh/ksh/bash:
               PATH=/usr/local/teTeX/bin/sparc-solaris:$PATH; export PATH
       PATH change csh/tcsh:
               setenv PATH /usr/local/teTeX/bin/sparc-solaris:$PATH
  - make sure that the main texmf.cnf files is correctly found:
       kpsewhich texmf.cnf
    If that file is not found correctly, you have to set the TEXMFCNF
    environment variable (again with export or setenv), e.g. like this:
       TEXMFCNF=/usr/local/teTeX/share/texmf/web2c; export TEXMFCNF
    or like this:
       setenv TEXMFCNF /usr/local/teTeX/share/texmf/web2c
  - make sure that TEXMFMAIN expands correctly:
       kpsewhich --expand-var='$TEXMFMAIN'
    That should give you the name of the main texmf tree, e.g.
       /usr/local/teTeX/share/texmf
    If it does not, please change the TEXMFMAIN definition in
    the texmf.cnf (see previous step).
  - run texhash and texconfig and change what you need:
       texhash
       texconfig
    You are done!

===========================================================================
 3) post installation
===========================================================================

Run the command
  texconfig conf
and
  - verify that all programs are found from the directory containing the
    teTeX binaries.
       !! ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
       !! A common problem is mentioning the teTeX
       !! binaries too late in your PATH variable so that some utilities
       !! from overlooked remnants of an old installation get used.
       !! ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

  - pay attention to any environment variable shown in the last section.
    If they point to a different TeX installation, you might get trouble
    by that. Unset them and have a look at TETEXDOC.dvi (in $TEXMF/doc/tetex)
    and kpathsea.dvi (in $TEXMF/doc/programs).
  - if any problem with program x try
      which x
    to verify if there is another x file in your system.

If you want to make letter paper (in contrast to A4) the default papersize,
just:
  texconfig xdvi us
  texconfig dvips paper letter

Run texconfig interactively (i.e. invoke the command without any
arguments) and see if there are other things you can adjust to your site,
e.g. printers.

If you install teTeX for several users, tell your users to check their
environment by the command
  texconfig conf
if they run into trouble.

If you have chosen to create symbolic links in install.sh or by the manual
installation, you need to create these links on all your local machines if
the destination directories that hold the links are not shared. Something
like the following command can be used to create the symlinks:
  ln -s /usr/local/teTeX/bin/sparc-solaris/* /usr/local/bin
  ln -s /usr/local/teTeX/man/man1/* /usr/local/man/man1
  ln -s /usr/local/teTeX/man/man5/* /usr/local/man/man5
  ln -s /usr/local/teTeX/info/*info* /usr/local/info

===========================================================================
 A) appendix: overview about the files in this distribution
===========================================================================

The installation script:
  install.sh

The packages that contain the binaries:

  filename                              platform
  --------------------------------------------------------------------------
  binaries/alpha-linux-libc6.tar.gz     DEC Alpha / Linux (glibc 2)
  binaries/alpha-osf.tar.gz             DEC Alpha / Digital Unix 3.2 or later
  binaries/hppa1.1-hpux9.tar.gz         HPPA / HP-UX 9.xx
  binaries/hppa1.1-hpux10.tar.gz        HPPA / HP-UX 10.xx
  binaries/ix86-freebsd3.tar.gz         Intel x86 / FreeBSD 3.x
  binaries/ix86-linux-libc5.tar.gz      Intel x86 / Linux (libc 5)
  binaries/ix86-linux-libc6.tar.gz      Intel x86 / Linux (glibc 2)
  binaries/ix86-netbsd.tar.gz           Intel x86 / NetBSD >= 1.3 and < 1.5
  binaries/mab-nextstep3.tar.gz         NEXTSTEP (NeXT,Intel,HP-PA,SPARC)
  binaries/mips-irix5.tar.gz            SGI Irix 5.3 or later
  binaries/mips-irix6.tar.gz            SGI Irix 6.2 or later
  binaries/mips-ultrix.tar.gz           Mips / Ultrix 4.4 or later
  binaries/powerpc-aix4.tar.gz          PowerPC / AIX 4.2 or later
  binaries/powerpc-linux-libc60.tar.gz  PowerPC / Linux (glibc 1.99)
  binaries/powerpc-linux-libc61.tar.gz  PowerPC / Linux (glibc 2.1.1)
  binaries/powerpc-rhapsody.tar.gz      PowerPC / MacOS X
  binaries/rs6000-aix3.tar.gz           RS6000 / AIX 3.2.5 or later
  binaries/rs6000-aix4.tar.gz           RS6000 / AIX 4.1.4 or later
  binaries/sparc-linux-libc60.tar.gz    Sparc / Linux (glibc 2)
  binaries/sparc-linux-libc61.tar.gz    Sparc / Linux (glibc 2.1)
  binaries/sparc-solaris.tar.gz         Sparc / Solaris 2.4 or later
  binaries/sparc-sunos.tar.gz           Sparc / SunOS 4.1.1 or later

  filename                content
  --------------------------------------------------------------------------
  base/tetex-base.tar.gz  a basic TeX system
  base/latex-base.tar.gz  a basic LaTeX system, needs tetex-base

  filename                documentation
  --------------------------------------------------------------------------
  doc/catalogue.tar.gz    comprehensive catalogue of TeX packages
  doc/faqs.tar.gz         frequently asked questions
  doc/info.tar.gz         documentation in GNU info format
  doc/man.tar.gz          documentation in UNIX man format

  filename                fonts
  --------------------------------------------------------------------------
  fonts/ae.tar.gz         virtual Cork encoded Computer Modern
  fonts/ams.tar.gz        AMS fonts
  fonts/blackboard.tar.gz blackboard math and doublestroke
  fonts/concrete.tar.gz   Concrete, Concrete Math and European Concrete
  fonts/ec.tar.gz         European Computer Modern (EC / TC)
  fonts/hplj.tar.gz       metrics for HP Laserwriter built-in fonts
  fonts/misc-mf.tar.gz    cmbright cmextra euxm gothic pandora rsfs stmary wasy
  fonts/misc-type1.tar.gz Adobe Utopia, Bitstream Charter, Martin Vogels Symbole
  fonts/sauter.tar.gz     the sauter fonts package
  fonts/yandy.tar.gz      metrics for Mathtime and Lucida Bright            

  filename                    content
  --------------------------------------------------------------------------
  goodies/context.tar.gz      Parameter driven macro package (like LaTeX).
  goodies/drawing.tar.gz      pstricks texdraw xypic
  goodies/fontinst.tar.gz     fontinst utility
  goodies/latex-extra.tar.gz  a lot of extra packages for LaTeX
  goodies/metapost.tar.gz     the MetaPost system
  goodies/misc-macros.tar.gz  eplain, amstex, eijkhout, localloc
  goodies/omega.tar.gz        TeX variant with support for non-latin languages
  goodies/polish.tar.gz       support for using the Polish language
  goodies/greek.tar.gz        support for using the Greek language
  goodies/cyrillic.tar.gz     fonts (lh) and macros (cyrplain) for Cyrillic