How To Install NTeX Release 1.2 =============================== 0. Read the whole file INSTALL (the one you are looking at right now) before you start to install anything! If you have an installed the version 1.1 of NTeX you should remove this installation with removepkg before you install 1.2 since the directory structure changed. If you do not have other packages starting with nt?-* you can do this with (assuming the package files are store in /usr/adm/packages) cd /var/adm/packages removepkg nt?-* Please also note that the dvi drivers xdvik, xdvipsk and dviljk use the kpathsea library 2.1, but TeX and MetaFont (web2c) still use version 1.7. So if you change the paths for kpathsea 2.1 by editing the file texmf.cnf, TeX and MetaFont will not use these paths. As soon as there is a version of web2c that supports kpathsea 2.1 I will install it. Right now the definitions in texmf.cnf and the one for web2c are equal. So there should be no problems with the default values. If you have to change them use the environment variables to do so. 1. Download the directories ntex01 to ntex13. The contents of each directory should be copied on a 3.5" HD disk (1.44MB) with a MS-DOS file system. If you are using another format and the files in one directory do not fit onto one disk you can copy them on different ones. Just make sure that each disk contains a empty file ntexN where N is a number from 01, 02, 03, ... Then edit the file disknam on the disk ntex01. This file should contain the names of the empty files. If you are not using a msdos filesystem you also have to change the file diskfs on ntex01. It contains the name of the filesystem used for the mount command. 2. To install NTeX mount the disk ntex01 with a command like mkdir /tmp/ntex01 mount -r -t msdos /dev/fd0 /tmp/ntex01 where msdos is the filesystem /dev/fd0 is the disk drive (you may change it to /dev/fd1) and /tmp/ntex01 is the directory under which the disk is installed. Then copy the install.sh script on your harddisc. For example cp /tmp/ntex01/install.sh /tmp/install.sh 3. Now call the installation script install.sh with the directory name you used for mounting ntex01. In the example above this would be cd /tmp install.sh /tmp/ntex01 (Don't stay in the /tmp/ntex01 directory during installation since it ntex01 will be unmounted by install.sh.) This script will copy some basic information for installing ntex in /tmp/install.ntex and calls the script installntex contained in install.tgz on ntex01. installntex does the real installation and could also be used to install the packages from the current directory. If you want to install the packages from the current directory create a directory on your hardisk, unzip and untar the package install.tgz in this directory. Copy the packages you want to install in the same directory and call the installntex script form there. 4. installntex asks you if you want to install from floppy or from the current directory. If you did not copy all the files from ntex01 to ntex13 in one directory on your harddisk, choose floppy (as supposed in step 1 and 2). In this case you also have to choose the device file of the floppy drive (/dev/fd0 for DOS drive A and /dev/fd1 for DOS drive B). Now you can choose the installation script which is used for installing the package. If you are using slackware you probably want to use the slackware installation script. I have included this in the installation package. If you do not want to use the slackware installation script, the installation will be done with a simple script provided by installntex. This simple script creates for each installed package a .files file in the installation directory which contains a list of the installed files. After this short configuration you get a list of the packages and have to choose which you want to install. If you have limited disk space you should choose the packages wisely and just install what you really need. All the packages have a status, which is either necessary, recommended or optional. You have to install the packages with the status necessary in order to run TeX. The recommended packages should be installed unless you are sure that you do never need them. You should just install the optional packages if you really want to use them. After you have chosen the packages, they will be installed and you are asked to insert disk ntex01 to ntex13. Of course if you are installing from current directory, you do not have to do this. After all the packages are installed you go through a basic configuration for NTeX. Here you can configure dvips, xdvi, LaTeX2e and MetaFont for your local printer and the hyphenation tables you want to use. If you do not know what you have to change, keep the default settings. You can change them later. To configure xdvi you have to change the file /usr/lib/texmf/X/XDvi. This is an app-defaults file and has to be linked to your app-defaults directory for X11/openwin (for openwin this is most likely /usr/openwin/lib/app-defaults and for X11 it is most likely /usr/X11/lib/X11/app-defaults). installntex can do this job for you if you know the name of your app-defaults directory or you can do it later with ln -s /usr/lib/texmf/X/XDvi /XDvi A general note: Don't change anything in the configuration files and the fonts unless you know exactly what you are doing. The default configuration should work for a lot of systems and should always do it for a beginner. You can run the configuration script for the packages you have installed from /usr/lib/texmf/tools. If the package has an configuration script you find a file .cfg in this directory which you can run at every time you want to change the configuration. The only thing that you really might have to change is the localfont mode in /usr/lib/texmf/mf/base/modes.mf. This is easiest done with the installntex script. You do not necessarily have to create the fonts after you have done this. The script MakeTeXPK will do this for you. 5. Note that the distribution does not contain any pk font files. They can be created with a shell script in /usr/lib/texmf/fonts/create. The shell script is called createallfonts. Before you build the fonts you have to set the localfont mode to your printer in the file /usr/lib/texmf/mf/base/modes.mf. You can do this either with the installntex script after you have installed MetaFont or later by hand. If you do not know how this works, do it with installntex when you are asked so. After you changed the localfont mode in modes.mf you also have to recreate the bases for MetaFont. installntex does this automatically. In order to build the pk font files type cd /usr/lib/texmf/fonts/create createallfonts This can take quite some time and you should run it over night. You can also run it as background process with cd /usr/lib/texmf/fonts/create createallfonts &>/dev/null & You can ignore the "font not installed" messages during creation. There might also be created some *.ferr files in /usr/lib/texmf/fonts/create. They document some errors in some of the fonts which are not removed... Don't care about them unless you have some problems with a font (send a report to me in this case). If you want to build just a part of the fonts you have installed you can call one of the create.sh scripts in the subdirectories of /usr/lib/texmf/fonts which just builds the fonts in this directory and below. Please note that the create.sh scripts are the old version of creating the fonts. They will not create all the fonts which are created by createallfonts! However you do not have to build any pk files. TeX and the printer drivers can do this automatically with the shell script MakeTeXPK. If you do not have a lot of diskspace or are not experienced with TeX this may be the best solution. You might have to wait for the creation of the fonts in the beginning, but just those fonts are creasted which you really need. If you let MakeTeXPK create the pk fonts they will be installed in the directory /usr/lib/texmf/fonts/tmp/pk. After you have created the fonts you should call /usr/lib/texmf/tools/create_ls-R in order to update the kpathsea ls-R databse. Note that also xdvi uses the localfont mode. If your localfont mode does not go along with xdvi, you should change the default mode of xdvi in the app-defaults file /usr/lib/texmf/X/XDvi (this could also be done with installntex or the ntb-xdvi.cfg script in /usr/lib/texmf/tools). 6. After the installation is complete you can remove the installation directory /tmp/install.ntex and the direcotry you used for mounting ntex01. In the example above this was /tmp/ntex01. The disk ntex01 is unmounted automatically by the script install.sh All the packages are installed in the directories /usr/bin (binaries), /usr/lib/texmf (fonts, macros, etc.), /usr/info (info files) and /usr/src/tex (sources). If you want to use /usr/local instead of /usr, just move the directory /usr/lib/texmf to /usr/local/lib/texmf and the binaries for ntex from /usr/bin to /usr/local/bin. To figure out which binaries are installed in /usr/bin, type grep ./usr/bin/ *.idx in the installation directory and you'll get a list of the binaries. You get a list of the info files with grep ./usr/info/ *.idx If you have a /usr/local/info directory, you can copy them there. To change the directories for the sources just move /usr/src/tex to /usr/local/src/tex. After you have copied all the files to /usr/local/... , you have to change the paths for TeX and MetaFont. See the manual pages of TeX and MetaFont for the environment variables which have to be changed. Note that you do not need these environment variables if you keep TeX where it is installed since these paths are used as default paths. Please also read the README file. You can find a list of the contents of the disks ntex01 to ntex13 in the file DISKS. The files contained in each package could be found in the .idx files on the installation disk. The .inf files on the installation disk contain a short description for each package. All these descriptions could also be found in INFO. If you have serious problems with the installation, please contact me. I will try my best to answer your mail. Comments, suggestions and bug reports to Frank Langbein - e94fla@student.tdb.uu.se (till November 1994), langbein@fermat.mathematik.uni-stuttgart.de