home *** CD-ROM | disk | FTP | other *** search
/ ftp.muug.mb.ca / 2014.06.ftp.muug.mb.ca.tar / ftp.muug.mb.ca / pub / tex / tetex / INSTALL.bin < prev    next >
Text File  |  1996-11-17  |  9KB  |  208 lines
  1. ===========================================================================
  2.  
  3.     teTeX-0.4 installation instructions (using precompiled binaries)
  4.  
  5. ===========================================================================
  6.  
  7.     1) getting the archives
  8.     2) unpack the files with install.sh or manually:
  9.       a) run install.sh
  10.           b) manual installation
  11.     3) post-installation
  12.     A) appendix: overview about the files in this distribution
  13.  
  14. ===========================================================================
  15.  1) getting the archives
  16. ===========================================================================
  17.  
  18. If starting from nil, and you do not wish to recompile the binaries,
  19. approximately the following sequence of commands will get the files you
  20. need to install teTeX (replace /usr/local/temp with any temporal directory
  21. where you have enough free space):
  22.  
  23. # mkdir /usr/local/temp
  24. # cd /usr/local/temp
  25. # mkdir binaries base doc fonts goodies
  26. # ftp sunsite.informatik.rwth-aachen.de [substitute the archive nearest to you]
  27. ftp> cd /pub/comp/tex/teTeX/distrib     [modify as needed for the given archive]
  28. ftp> bin
  29. ftp> dir binaries
  30. ftp> prompt
  31. ftp> mget install.sh base doc fonts goodies binaries/i386-linux.tar.gz
  32. ftp> quit
  33.  
  34. You should look at the output of the "dir binaries" command and substitute
  35. the appropriate file(s) in place of "i386-linux.tar.gz".
  36.  
  37. When you are done with the installation (below), you may go back and delete
  38. the contents of /usr/local/temp.
  39.  
  40. ===========================================================================
  41.  2a) run install.sh
  42. ===========================================================================
  43. To run install.sh, you need a sh compatible shell that knows the feature
  44. of shell functions. /bin/sh is ok on most systems, but on Ultrix, you
  45. cannot use /bin/sh. Use /bin/sh5 or bash instead. Then run the install.sh
  46. script with that shell. Similar with AIX-4.x.y: there you can use /bin/bsh
  47. instead of /bin/sh (which is the korn shell on these systems :-(
  48.  
  49. Example 1:
  50.     /bin/sh install.sh
  51.  
  52. Example 2: (Ultrix)
  53.     /bin/sh5 install.sh
  54.  
  55. Example 3: (AIX-4)
  56.     /bin/bsh install.sh
  57.  
  58. ===========================================================================
  59.  2b) manual installation
  60. ===========================================================================
  61.   - the archives will unpack into a subdirectory teTeX so you do not need
  62.     to create a new subdirectory by hand.
  63.   - cd to the directory where you want to have the teTeX installation, e.g.
  64.     /usr/local:
  65.     cd /usr/local
  66.   - set your umask to 0 to unpack with the correct permissions (or use
  67.     the 'p' flag of tar, but this does not work with some broken tar versions)
  68.   - unpack the archives you want to install (including binaries):
  69.         gzip -dc tetex-base.tar.gz | tar -xvf -
  70.         gzip -dc latex-base.tar.gz | tar -xvf -
  71.         ...
  72.    - you may optionally rename the teTeX directory. Example:
  73.     mv teTeX TeX
  74.   - optionally move the binaries one level up and remove the empty
  75.     subdirectory, if you only want to use teTeX on one platform.
  76.     Example:
  77.     cd teTeX/bin/i386-linux
  78.     mv * ..
  79.     cd ..
  80.     rmdir i386-linux
  81.     You need to adjust the texmf.cnf file, too. See the README in teTeX/bin
  82.     and edit teTeX/texmf.cnf:
  83.     more README
  84.     vi ../texmf.cnf
  85.    - make sure, the binaries are found along your PATH. Either create
  86.      symlinks to a standard directory or change your PATH. Example:
  87.     symlinks:
  88.         ln -s /usr/local/teTeX/bin/i386-linux/* /usr/local/bin
  89.         PATH change sh/ksh/bash:
  90.         PATH=/usr/local/teTeX/bin/i386-linux:$PATH; export PATH
  91.         PATH change csh/tcsh:
  92.         setenv PATH /usr/local/teTeX/bin/i386-linux:$PATH
  93.     - run texhash and texconfig and change what you need:
  94.     texhash
  95.     texconfig
  96.     You are done!
  97.  
  98. ===========================================================================
  99.  3) post installation
  100. ===========================================================================
  101.  
  102. Run the command
  103.   texconfig confall
  104. and
  105.   - verify that all programs are found from the directory containing the
  106.     teTeX binaries.
  107.        !! ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  108.        !! A common problem is mentioning the teTeX
  109.        !! binaries too late in your PATH variable so that some utilities
  110.        !! from overlooked remnants of an old installation get used.
  111.        !! ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  112.  
  113.   - pay attention to any environment variable shown in the last section.
  114.     If they point to a different TeX installation, you might get trouble
  115.     by that. Unset them and have a look at TETEXDOC.dvi (in $TEXMF/doc/tetex)
  116.     and kpathsea.dvi (in $TEXMF/doc/programs).
  117.   - if any problem with program x try
  118.       which x
  119.     to verify if there is another x file in your system.
  120.  
  121. If you install teTeX for several users, tell your users to check their
  122. environment by the command
  123.   texconfig confall
  124. if they run into trouble.
  125.  
  126. ===========================================================================
  127.  A) appendix: overview about the files in this distribution
  128. ===========================================================================
  129.  
  130. The installation script:
  131.   install.sh
  132.  
  133. The packages that contain the binaries:
  134.  
  135.   filename                platform
  136.   --------------------------------------------------------------------------
  137.   binaries/alpha-linux.tar.gz           DEC Alpha/Linux
  138.   binaries/alpha-osf3.2.tar.gz        DEC Alpha/Digital Unix 3.2
  139.   binaries/alpha-osf4.0.tar.gz          DEC Alpha/Digital Unix 4.0
  140.   binaries/c1-bsd.tar.gz                Convex C-110
  141.   binaries/c2-bsd.tar.gz                Convex C-210
  142.   binaries/hppa-nextstep3.tar.gz        HPPA/NEXTSTEP 3
  143.   binaries/hppa1.1-hpux10.tar.gz    HPPA/HP-UX 10.xx
  144.   binaries/hppa1.1-hpux9.tar.gz         HPPA/HP-UX 9.xx
  145.   binaries/i386-bsdi2.1.tar.gz        Intel x86/BSDI 2.1
  146.   binaries/i386-freebsd2.1.5.tar.gz    Intel x86/FreeBSD 2.1.5
  147.   binaries/i386-linux.tar.gz        Intel x86/Linux (ELF)
  148.   binaries/i386-linuxaout.tar.gz    Intel x86/Linux (a.out)
  149.   binaries/i386-netbsd1.2.tar.gz    Intel x86/NetBSD 1.2
  150.   binaries/i386-nextstep3.tar.gz        Intel x86/NEXTSTEP 3
  151.   binaries/i386-solaris2.5.tar.gz       Intel x86/Solaris2.5
  152.   binaries/m68k-hpux9.tar.gz        HP 400/HP-UX 9.xx
  153.   binaries/m68k-nextstep3.tar.gz        Motorola 68k/NEXTSTEP 3
  154.   binaries/mab-nextstep3.tar.gz        NEXTSTEP (NeXT,Intel,HP-PA,SPARC)
  155.   binaries/mips-irix5.3.tar.gz        SGI Irix 5.3
  156.   binaries/mips-irix6.2.tar.gz          SGI Irix 6.2
  157.   binaries/mips-ultrix4.3.tar.gz    Mips/Ultrix 4.3
  158.   binaries/powerpc-aix3.2.5.tar.gz    PowerPC/AIX 3.2.5
  159.   binaries/powerpc-aix4.1.4.tar.gz    PowerPC/AIX 4.1.1
  160.   binaries/rs6000-aix3.2.5.tar.gz    IBM RS6000 AIX 3.2.5
  161.   binaries/rs6000-aix4.1.4.tar.gz    IBM RS6000 AIX 4.1.4
  162.   binaries/rs6000-aix4.2.0.tar.gz       IBM RS6000 AIX 4.2.0
  163.   binaries/sparc-nextstep3.tar.gz    SUN Sparc/NEXTSTEP 3
  164.   binaries/sparc-solaris2.4.tar.gz    SUN Sparc/Solaris 2.4
  165.   binaries/sparc-solaris2.5.tar.gz    SUN Sparc/Solaris 2.5
  166.   binaries/sparc-sunos4.1.3.tar.gz    SUN Sparc/SunOS 4.1.3
  167.  
  168.  
  169.   filename                            content
  170.   --------------------------------------------------------------------------
  171.   base/latex-base.tar.gz              a basic LaTeX system, needs tetex-base
  172.   base/tetex-base.tar.gz              a basic TeX system
  173.  
  174.   filename                            content
  175.   --------------------------------------------------------------------------
  176.   goodies/amstex.tar.gz               more mathematics for TeX
  177.   goodies/bibtex.tar.gz               a tool to make a bibliography for (La)TeX
  178.   goodies/eplain.tar.gz               expanded plain TeX
  179.   goodies/latex-extra.tar.gz          a lot of extra packages for LaTeX
  180.   goodies/metapost.tar.gz             the MetaPost system
  181.   goodies/pictex.tar.gz               portable pictures with (La)TeX
  182.   goodies/pstricks.tar.gz             PostScript macros for generic TeX
  183.   goodies/texdraw.tar.gz              PostScript drawings for TeX
  184.   goodies/xypic.tar.gz                typesetting graphs and diagrams in TeX
  185.  
  186.   filename                            documentation
  187.   --------------------------------------------------------------------------
  188.   doc/ams-doc.tar.gz                  d. about AMS fonts, AMSLaTeX and AMSTeX
  189.   doc/bibtex-doc.tar.gz               d. about the bibtex program
  190.   doc/eplain-doc.tar.gz               d. for the expanded plain format
  191.   doc/fonts-doc.tar.gz                font related documentation
  192.   doc/general-doc.tar.gz              TeX-FAQ, ftp locations, TDS, ...
  193.   doc/generic-doc.tar.gz              d. for macros usable with several
  194.                                       TeX formats, e.g. babel, xypic, texdraw.
  195.   doc/latex-doc.tar.gz                much documentation about LaTeX
  196.   doc/makeindex-doc.tar.gz            a general purpose index formater
  197.   doc/metapost-doc.tar.gz             d. about MetaPost
  198.   doc/programs-doc.tar.gz             Kpathsea, dvipsk, makeinfo, texinfo
  199.  
  200.   filename                            fonts
  201.   --------------------------------------------------------------------------
  202.   fonts/ams-fonts.tar.gz              AMS-fonts
  203.   fonts/dc-fonts.tar.gz               DC-fonts
  204.   fonts/misc-fonts.tar.gz             bbm, bbold, concrete, gothic,
  205.                                       pandora, rsfs, stmary, wasy
  206.   fonts/postscript-fonts.tar.gz       PostScript fonts (Adobe, Bitstream)
  207.   fonts/sauter-fonts.tar.gz           sauter fonts
  208.