home *** CD-ROM | disk | FTP | other *** search
/ ftp.mayn.de / ftp.mayn.de-pub.zip / ftp.mayn.de-pub / aix / 3.2 / TeX+MF.README (.txt) < prev    next >
LaTeX Document  |  2017-03-05  |  10KB  |  214 lines
  1.     Version 4 as of 19. August 1993
  2.     TeX3.141 and Metafont2.71 for AIX 3.2 on the IBM RISC System/6000
  3.     With this Release you will not need anymore a "german" latex or tex,
  4.     as tex and latex are built with both hyphenation patterns, and if you
  5.     specify \documentstyle[...,german]{...}, the right hyphenation-patterns
  6.     will be selected automatically for you. (look at the according *.initex
  7.     files.)
  8.     Please note, that xlc prior to version 01.02.0000.0012 has a problem
  9.     with the optimizer in tex2.c and mf2.c (get_next will be beaten to death).
  10.     So if you need to recompile, please get new version from SW-Support or
  11.     leave the optimizer off for this two sourcefiles.
  12.     I have put xlc.01.02.0000.0013 on 129.69.1.12 in soft/aix/3.2 for your
  13.     convenience.)
  14.                 Installation notes
  15.    How to Install
  16.    --------------
  17.    Be aware, that both 0.25" and 8mm tapes are written by me with a blocksize
  18.    of 512; so you might look with smit, if you have also set the blocksize
  19.    to 512. read i/o errors or messages like "can not read media" may result,
  20.    if your blocksize does not equal 512!
  21.    With this distribution, I start to have TeX and MF in /usr/local, to keep
  22.    it separate from the IBM-lpps.
  23.    If you do not already have created /usr/local, either create a new
  24.    jfs filesystem with the appropriate space or, if you have enough space
  25.    in /usr left over, mkdir /usr/local.
  26.    There should be about 50 MByte free in /usr/local!!
  27.    If you want to recompile the sources, you may need at least 70 MByte.
  28.    You have to recompile if you choose another directory than /usr/local
  29.    to install my distribution in. (And don't forget to change the PATHs in
  30.    the according Makefiles...).
  31.    Insert the tape; su to root authority, cd /usr/local (use pwd to check!).
  32.    Say "tar -xvf/dev/rmt0" or whatever your tape is called.
  33.    Add /usr/local/tex/bin32 to your $PATH and after that you should be
  34.    able to start using TeX and MF.
  35.    If you see some strange owner or group you may correct this with:
  36.    cd /usr/local/tex
  37.    chown -R bin.bin * (or root.system, as you like...)
  38.    cd /usr/local/mf
  39.    chown -R bin.bin * (or root.system, as you like...)
  40.    This procedure may take a while.
  41.    Directory Structure
  42.    -------------------
  43.    Once installation has completed, you will have the following
  44.    directory structure:
  45.    /usr/local/          Root of Installation-tree
  46.        tex/             TeX installation
  47.        Adobe/        Contains the *.afm files for the ps fonts
  48.        README           The file you are currently reading
  49.        bib/             Some *.bst files
  50.        bin32/        Executable TeX and MF binaries and shell scripts
  51.             for AIX3.2
  52.        doc/        TeX, Metafont documentation 
  53.        dvi2xx/          Printer driver for HP-Laserjet;
  54.             This is the new version 0.51 of G. Neumann; thanks.
  55.             If you have problems, try qprt -d p -P "pclqueue"
  56.             "filename"
  57.        dvidvi/        do "magic" things with dvi-files,
  58.                see /usr/lpp/tex/bin/dvips2s for an example :-)     
  59.        dvips5518/       Printer driver for postscript; you may imbed *.eps
  60.              files or use true postscriptfonts for printing.
  61.        dvips5518.config/Contains the definition and headerfiles for dvips5490
  62.        fonts/        TeX font files; "devices" file
  63.      4216/          Font files for IBM 4216 Personal Pageprinter
  64.               as well as the fonts generated for postscript
  65.      laserjet/      Symbolic link to /usr/lpp/tex/fonts/4216
  66.       PStfms/      Contains the Adobe-tfms for dvips     
  67.       PSvfms/      Contains the Adobe-vfms for dvips     
  68.      tfm/          TeX tfm-files
  69.        formats/        TeX format files ("plain.fmt", etc.)
  70.        foiltex/         Another utility to make foils    
  71.        inputs/        TeX macros
  72.        manpages/    Obvious
  73.        pool/        String pool
  74.        rulers/        two nice, little tools!!!    
  75.        web-5.851d/      Obvious...
  76.        tgrind        Utilities to beatifully print sourcecode files!
  77.        transfig/        Drivers to convert xfig-files to TeX-usable pictures.
  78.        untested/    obvious, or?
  79.        util/            texindex, dimen_check.tex
  80.        xdvi/            An X11 previewer (uses *pk fonts)
  81.        xlatex/        An X11-frontend to TeX and friends
  82.      mf/        Metafont installation
  83.        bases/        Metafont base files ("plain.base", etc.);  
  84.        inputs/        Metafont macros
  85.        makefont/    Source for "makefont" command
  86.        pool/        String pool, for mf
  87.    Printing documentation
  88.    ----------------------
  89.    Some sort of documentation supplied with this installation is found in the 
  90.    /usr/local/tex/doc directory, in the form of TeX source files.
  91.    The documents are:
  92.       texcmds       A manual of commands which make up the
  93.             TeX and Metafont package.
  94.             This document is currently NOT under work to be more
  95.             specific for the RISC System/6000.
  96.       local         Lamport's "Local Guide to LaTeX".
  97.             This document is currently NOT under work to be more
  98.             specific for the RISC System/6000.
  99.       btxdoc        Oren Patashnik's paper on how to use BibTeX, the
  100.             bibliography-processing package for LaTeX.
  101.       btxhak        Patashnik's paper on how to construct a new BibTeX
  102.             bibliography style.
  103.    Before you can preview or print these documents, you will have to
  104.    process them with TeX (and BibTeX, for the two BibTeX documents).
  105.    Log in and do the following:
  106.         cd /usr/local/tex/doc
  107.     tex texcmds
  108.     latex local
  109.     latex local
  110.     latex btxdoc
  111.     bibtex btxdoc
  112.     latex btxdoc
  113.     latex btxdoc
  114.     latex btxhak
  115.     bibtex btxhak
  116.     latex btxhak
  117.     latex btxhak    
  118.    The multiple invocations of `latex' are to resolve cross-references
  119.    properly and to incorporate the bibliographic citations generated
  120.    by bibtex.  Such multiple invocations are not usually required once
  121.    a document has been processed once all the way through; further
  122.    editing usually needs only a single pass.
  123.    If you are running the X Window System, you can preview any of these
  124.    documents directly in an X window.  The command to do this is called
  125.    xdvi.sh, in which case you will use shrinked 300dpi-fonts found
  126.    in /usr/local/tex/fonts/4216/*.
  127.    The shellscript takes as argument the name of the dvi file to be
  128.    previewed (with or without the ".dvi" suffix)
  129.    To look at the "texcmds" document, for example:
  130.         cd /usr/local/tex/doc
  131.     xdvi.sh texcmds
  132.    Depending on the window manager you are running, you may have to 
  133.    position and size the window using the mouse when you start.
  134.    To print a document, use the command named "dvips".
  135.    As shipped, the "dvips" is set up to print TeX documents
  136.    on an IBM 4216-20 (300 dot/inch PostScript printer).
  137.    If a font in your TeX-document is not found in /usr/local/tex/fonts/4216/*,
  138.    MakeTeXPK is invoked to immediately generate the missing font with
  139.    METAFONT.
  140.    If you have an HP Laser, look in the dvi2xx.051 directory for the driver,
  141.    that    meets your needs.
  142.        
  143.    To print a file to your postscript printer:
  144.         cd /usr/local/tex/doc
  145.     dvips texcmds
  146.     lpr -h texcmds.ps
  147.    This will print the entire 47-page document.
  148.    There are many other options which you can specify on the command line
  149.    See the dvips.1 manpage in /usr/local/tex/dvips5490/dvips.
  150.    Day-to-day use of TeX and Metafont
  151.    ----------------------------------
  152.    Once you have installed everything and printed the documentation for
  153.    reference, you will want to consider specifying some environment
  154.    variables in your .profile or .login shell scripts.  These are described
  155.    in the texcmds document, but the more important ones are:
  156.    TEXINPUTS
  157.      This tells where TeX should look for input files.  If you do nothing,
  158.      TeX will look on the current directory and then in the system-wide
  159.      TeX library, /usr/local/tex/inputs.  This is sufficient for many 
  160.      purposes, but if you have your own private library you will want to
  161.      put its name in TeX's search path.  If your library is /u/smith/tex,
  162.      you can specify:
  163.       TEXINPUTS=.:/u/smith/tex:/usr/local/tex/inputs
  164.       export TEXINPUTS
  165.      for the Korn or Bourne shells, or
  166.           setenv TEXINPUTS .:/u/smith/tex:/usr/local/tex/inputs
  167.      for the C shell.  Note that TeX doesn't expand the "~" character,
  168.      so you will have to use actual path names.
  169.    TEXFONTS
  170.      This tells where TeX should look for tfm files, and where the previewer
  171.      and printer program should look for font (character image) files.
  172.      If not set, defaults to the current directory followed by the 
  173.      system-wide TeX font directory, /usr/local/tex/fonts.  If you have 
  174.      a private font library, specify it in a manner similar to TEXINPUTS,
  175.      above.
  176.      Be carefull, if you use dvips with true Postscriptfonts, you may bomb
  177.      this feature, if you alter TEXFONTS.
  178.    MFINPUTS
  179.      This tells where Metafont should look for input files.  Default is the
  180.      current directory followed by /usr/local/mf/inputs.  Specify as for
  181.      TEXINPUTS, above.
  182.    SOURCE
  183.    ------
  184.    You will find the source for this distribution in /usr/local/tex/src-5.851c.
  185.    Change to this directory and:
  186.     make
  187.     make formats
  188.     make bases
  189.     make manpages
  190.     make install
  191.    Be sure, the paths provided in "site.h" and "Makefile" suit your needs.
  192.    AND PLEASE USE ONLY THE vi-editor TO EDIT MAKEFILES.
  193.    I am sorry to say that INed, the editor you get with the "e" command
  194.    is unable to maintain tabs on which Makefiles rely on.
  195.    PICTeX
  196.    ------
  197.    Please see the README in /usr/local/tex/inputs/pictex!
  198.    How do i get this distribution without access to a network??
  199.    ------------------------------------------------------------
  200.    Well, how did you get this README??? :-)
  201.    You might try to ask DANTE e.V. and send them a QIC150 .25" streamer
  202.    tape cartridge. (or an 8mm video tape)        
  203.    DISCLAIMER
  204.    ----------
  205.    I have done this port as well as the INSTALL script to the best of my
  206.    knowledge. I have tested it on my own RISC System/6000. Nevertheless
  207.    there may be some glitches and pitfalls.
  208.    I will not be responsible for any damage of machine or filesystems
  209.    due to installing this distribution.
  210.    If all else fails and you have read all the common sources about RISC
  211.    System/6000 and TeX, you may reach me via untermarzoner@vnet.ibm.com.
  212.    Always happy \TeX{}ing!
  213.    Uwe Untermarzoner, AIX Sitecoordinator for TeX, DANTE e.V.
  214.