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

    teTeX-0.4 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
	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
# ftp sunsite.informatik.rwth-aachen.de [substitute the archive nearest to you]
ftp> cd /pub/comp/tex/teTeX/distrib     [modify as needed for the given archive]
ftp> bin
ftp> dir binaries
ftp> prompt
ftp> mget install.sh base doc fonts binaries/i386-linux.tar.gz
ftp> quit

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

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
===========================================================================
  - the archives will unpack into a subdirectory teTeX so you do not need
    to create a new subdirectory by hand.
  - cd to the directory where you want to have the teTeX installation, e.g.
    /usr/local:
	cd /usr/local
  - 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 (including binaries):
        gzip -dc tetex-base.tar.gz | tar -xvf -
        gzip -dc latex-base.tar.gz | tar -xvf -
        ...
   - you may optionally rename the teTeX directory. Example:
	mv teTeX TeX
  - optionally move the binaries one level up and remove the empty
    subdirectory, if you only want to use teTeX on one platform.
    Example:
	cd teTeX/bin/i386-linux
	mv * ..
	cd ..
	rmdir i386-linux
    You need to adjust the texmf.cnf file, too. See the README in teTeX/bin
    and edit teTeX/texmf.cnf:
	more README
	vi ../texmf.cnf
   - 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/i386-linux/* /usr/local/bin
        PATH change sh/ksh/bash:
		PATH=/usr/local/teTeX/bin/i386-linux:$PATH; export PATH
        PATH change csh/tcsh:
		setenv PATH /usr/local/teTeX/bin/i386-linux:$PATH
    - run texhash and texconfig and change what you need:
	texhash
	texconfig
    You are done!

===========================================================================
 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.tar.gz           DEC Alpha/Linux
  binaries/alpha-osf3.2.tar.gz		DEC Alpha/Digital Unix 3.2
  binaries/alpha-osf4.0.tar.gz          DEC Alpha/Digital Unix 4.0
  binaries/c1-bsd.tar.gz                Convex C-110
  binaries/c2-bsd.tar.gz                Convex C-210
  binaries/hppa-nextstep3.tar.gz        HPPA/NEXTSTEP 3
  binaries/hppa1.1-hpux10.tar.gz	HPPA/HP-UX 10.xx
  binaries/hppa1.1-hpux9.tar.gz         HPPA/HP-UX 9.xx
  binaries/i386-freebsd2.1.5.tar.gz	Intel x86/FreeBSD 2.1.5
  binaries/i386-linux.tar.gz		Intel x86/Linux (ELF)
  binaries/i386-linuxaout.tar.gz	Intel x86/Linux (a.out)
  binaries/i386-nextstep3.tar.gz        Intel x86/NEXTSTEP 3
  binaries/i386-solaris2.5.tar.gz       Intel x86/Solaris2.5
  binaries/m68k-hpux9.tar.gz		HP 400/HP-UX 9.xx
  binaries/m68k-nextstep3.tar.gz        Motorola 68k/NEXTSTEP 3
  binaries/mab-nextstep3.tar.gz		NEXTSTEP (NeXT,Intel,HP-PA,SPARC)
  binaries/mips-irix5.3.tar.gz		SGI Irix 5.3
  binaries/mips-irix6.2.tar.gz          SGI Irix 6.2
  binaries/mips-ultrix4.3.tar.gz	Mips/Ultrix 4.3
  binaries/rs6000-aix4.1.4.tar.gz	IBM RS6000 AIX 4.1.4
  binaries/rs6000-aix4.2.0.tar.gz       IBM RS6000 AIX 4.2.0
  binaries/sparc-nextstep3.tar.gz	SUN Sparc/NEXTSTEP 3
  binaries/sparc-solaris2.4.tar.gz	SUN Sparc/Solaris 2.4
  binaries/sparc-solaris2.5.tar.gz	SUN Sparc/Solaris 2.5
  binaries/sparc-sunos4.1.3.tar.gz	SUN Sparc/SunOS 4.1.3


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

  filename                            content
  --------------------------------------------------------------------------
  goodies/amstex.tar.gz               more mathematics for TeX
  goodies/bibtex.tar.gz               a tool to make a bibliography for (La)TeX
  goodies/eplain.tar.gz               expanded plain TeX
  goodies/latex-extra.tar.gz          a lot of extra packages for LaTeX
  goodies/metapost.tar.gz             the MetaPost system
  goodies/pictex.tar.gz               portable pictures with (La)TeX
  goodies/pstricks.tar.gz             PostScript macros for generic TeX
  goodies/texdraw.tar.gz              PostScript drawings for TeX
  goodies/xypic.tar.gz                typesetting graphs and diagrams in TeX

  filename                            documentation
  --------------------------------------------------------------------------
  doc/ams-doc.tar.gz                  d. about AMS fonts, AMSLaTeX and AMSTeX
  doc/bibtex-doc.tar.gz               d. about the bibtex program
  doc/eplain-doc.tar.gz               d. for the expanded plain format
  doc/fonts-doc.tar.gz                font related documentation
  doc/general-doc.tar.gz              TeX-FAQ, ftp locations, TDS, ...
  doc/generic-doc.tar.gz              d. for macros usable with several
                                      TeX formats, e.g. babel, xypic, texdraw.
  doc/latex-doc.tar.gz                much documentation about LaTeX
  doc/makeindex-doc.tar.gz            a general purpose index formater
  doc/metapost-doc.tar.gz             d. about MetaPost
  doc/programs-doc.tar.gz             Kpathsea, dvipsk, makeinfo, texinfo

  filename                            fonts
  --------------------------------------------------------------------------
  fonts/ams-fonts.tar.gz              AMS-fonts
  fonts/dc-fonts.tar.gz               DC-fonts
  fonts/misc-fonts.tar.gz             bbm, bbold, concrete, gothic,
                                      pandora, rsfs, stmary, wasy
  fonts/postscript-fonts.tar.gz       PostScript fonts (Adobe, Bitstream)
  fonts/sauter-fonts.tar.gz           sauter fonts
