Version 4 as of 19. August 1993 TeX3.141 and Metafont2.71 for AIX 3.2 on the IBM RISC System/6000 With this Release you will not need anymore a "german" latex or tex, as tex and latex are built with both hyphenation patterns, and if you specify \documentstyle[...,german]{...}, the right hyphenation-patterns will be selected automatically for you. (look at the according *.initex files.) Please note, that xlc prior to version 01.02.0000.0012 has a problem with the optimizer in tex2.c and mf2.c (get_next will be beaten to death). So if you need to recompile, please get new version from SW-Support or leave the optimizer off for this two sourcefiles. I have put xlc.01.02.0000.0013 on 129.69.1.12 in soft/aix/3.2 for your convenience.) Installation notes How to Install -------------- Be aware, that both 0.25" and 8mm tapes are written by me with a blocksize of 512; so you might look with smit, if you have also set the blocksize to 512. read i/o errors or messages like "can not read media" may result, if your blocksize does not equal 512! With this distribution, I start to have TeX and MF in /usr/local, to keep it separate from the IBM-lpps. If you do not already have created /usr/local, either create a new jfs filesystem with the appropriate space or, if you have enough space in /usr left over, mkdir /usr/local. There should be about 50 MByte free in /usr/local!! If you want to recompile the sources, you may need at least 70 MByte. You have to recompile if you choose another directory than /usr/local to install my distribution in. (And don't forget to change the PATHs in the according Makefiles...). Insert the tape; su to root authority, cd /usr/local (use pwd to check!). Say "tar -xvf/dev/rmt0" or whatever your tape is called. Add /usr/local/tex/bin32 to your $PATH and after that you should be able to start using TeX and MF. If you see some strange owner or group you may correct this with: cd /usr/local/tex chown -R bin.bin * (or root.system, as you like...) cd /usr/local/mf chown -R bin.bin * (or root.system, as you like...) This procedure may take a while. Directory Structure ------------------- Once installation has completed, you will have the following directory structure: /usr/local/ Root of Installation-tree tex/ TeX installation Adobe/ Contains the *.afm files for the ps fonts README The file you are currently reading bib/ Some *.bst files bin32/ Executable TeX and MF binaries and shell scripts for AIX3.2 doc/ TeX, Metafont documentation dvi2xx/ Printer driver for HP-Laserjet; This is the new version 0.51 of G. Neumann; thanks. If you have problems, try qprt -d p -P "pclqueue" "filename" dvidvi/ do "magic" things with dvi-files, see /usr/lpp/tex/bin/dvips2s for an example :-) dvips5518/ Printer driver for postscript; you may imbed *.eps files or use true postscriptfonts for printing. dvips5518.config/Contains the definition and headerfiles for dvips5490 fonts/ TeX font files; "devices" file 4216/ Font files for IBM 4216 Personal Pageprinter as well as the fonts generated for postscript laserjet/ Symbolic link to /usr/lpp/tex/fonts/4216 PStfms/ Contains the Adobe-tfms for dvips PSvfms/ Contains the Adobe-vfms for dvips tfm/ TeX tfm-files formats/ TeX format files ("plain.fmt", etc.) foiltex/ Another utility to make foils inputs/ TeX macros manpages/ Obvious pool/ String pool rulers/ two nice, little tools!!! web-5.851d/ Obvious... tgrind Utilities to beatifully print sourcecode files! transfig/ Drivers to convert xfig-files to TeX-usable pictures. untested/ obvious, or? util/ texindex, dimen_check.tex xdvi/ An X11 previewer (uses *pk fonts) xlatex/ An X11-frontend to TeX and friends mf/ Metafont installation bases/ Metafont base files ("plain.base", etc.); inputs/ Metafont macros makefont/ Source for "makefont" command pool/ String pool, for mf Printing documentation ---------------------- Some sort of documentation supplied with this installation is found in the /usr/local/tex/doc directory, in the form of TeX source files. The documents are: texcmds A manual of commands which make up the TeX and Metafont package. This document is currently NOT under work to be more specific for the RISC System/6000. local Lamport's "Local Guide to LaTeX". This document is currently NOT under work to be more specific for the RISC System/6000. btxdoc Oren Patashnik's paper on how to use BibTeX, the bibliography-processing package for LaTeX. btxhak Patashnik's paper on how to construct a new BibTeX bibliography style. Before you can preview or print these documents, you will have to process them with TeX (and BibTeX, for the two BibTeX documents). Log in and do the following: cd /usr/local/tex/doc tex texcmds latex local latex local latex btxdoc bibtex btxdoc latex btxdoc latex btxdoc latex btxhak bibtex btxhak latex btxhak latex btxhak The multiple invocations of `latex' are to resolve cross-references properly and to incorporate the bibliographic citations generated by bibtex. Such multiple invocations are not usually required once a document has been processed once all the way through; further editing usually needs only a single pass. If you are running the X Window System, you can preview any of these documents directly in an X window. The command to do this is called xdvi.sh, in which case you will use shrinked 300dpi-fonts found in /usr/local/tex/fonts/4216/*. The shellscript takes as argument the name of the dvi file to be previewed (with or without the ".dvi" suffix) To look at the "texcmds" document, for example: cd /usr/local/tex/doc xdvi.sh texcmds Depending on the window manager you are running, you may have to position and size the window using the mouse when you start. To print a document, use the command named "dvips". As shipped, the "dvips" is set up to print TeX documents on an IBM 4216-20 (300 dot/inch PostScript printer). If a font in your TeX-document is not found in /usr/local/tex/fonts/4216/*, MakeTeXPK is invoked to immediately generate the missing font with METAFONT. If you have an HP Laser, look in the dvi2xx.051 directory for the driver, that meets your needs. To print a file to your postscript printer: cd /usr/local/tex/doc dvips texcmds lpr -h texcmds.ps This will print the entire 47-page document. There are many other options which you can specify on the command line See the dvips.1 manpage in /usr/local/tex/dvips5490/dvips. Day-to-day use of TeX and Metafont ---------------------------------- Once you have installed everything and printed the documentation for reference, you will want to consider specifying some environment variables in your .profile or .login shell scripts. These are described in the texcmds document, but the more important ones are: TEXINPUTS This tells where TeX should look for input files. If you do nothing, TeX will look on the current directory and then in the system-wide TeX library, /usr/local/tex/inputs. This is sufficient for many purposes, but if you have your own private library you will want to put its name in TeX's search path. If your library is /u/smith/tex, you can specify: TEXINPUTS=.:/u/smith/tex:/usr/local/tex/inputs export TEXINPUTS for the Korn or Bourne shells, or setenv TEXINPUTS .:/u/smith/tex:/usr/local/tex/inputs for the C shell. Note that TeX doesn't expand the "~" character, so you will have to use actual path names. TEXFONTS This tells where TeX should look for tfm files, and where the previewer and printer program should look for font (character image) files. If not set, defaults to the current directory followed by the system-wide TeX font directory, /usr/local/tex/fonts. If you have a private font library, specify it in a manner similar to TEXINPUTS, above. Be carefull, if you use dvips with true Postscriptfonts, you may bomb this feature, if you alter TEXFONTS. MFINPUTS This tells where Metafont should look for input files. Default is the current directory followed by /usr/local/mf/inputs. Specify as for TEXINPUTS, above. SOURCE ------ You will find the source for this distribution in /usr/local/tex/src-5.851c. Change to this directory and: make make formats make bases make manpages make install Be sure, the paths provided in "site.h" and "Makefile" suit your needs. AND PLEASE USE ONLY THE vi-editor TO EDIT MAKEFILES. I am sorry to say that INed, the editor you get with the "e" command is unable to maintain tabs on which Makefiles rely on. PICTeX ------ Please see the README in /usr/local/tex/inputs/pictex! How do i get this distribution without access to a network?? ------------------------------------------------------------ Well, how did you get this README??? :-) You might try to ask DANTE e.V. and send them a QIC150 .25" streamer tape cartridge. (or an 8mm video tape) DISCLAIMER ---------- I have done this port as well as the INSTALL script to the best of my knowledge. I have tested it on my own RISC System/6000. Nevertheless there may be some glitches and pitfalls. I will not be responsible for any damage of machine or filesystems due to installing this distribution. If all else fails and you have read all the common sources about RISC System/6000 and TeX, you may reach me via untermarzoner@vnet.ibm.com. Always happy \TeX{}ing! Uwe Untermarzoner, AIX Sitecoordinator for TeX, DANTE e.V.