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 <app-defaults-directory>/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 <packagename>.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