Babel Installation Guide

			       14 January 1997


	When you install the babel system you have first to decide
	whether you want to make a new format file. If you don't, you
	miss some of the functionality of the babel system, but you
	can then skip steps 2 through 6 . If you do want to build a
	new format, start with step 1.

	When you want to produce the full listing of all the source
	files in the babel system run babel.drv through LaTeX, then
	use MakeIndex to produce babel.ind using the command:
	makeindex -s bbind.ist babel
	and use MakeIndex to produce babel.gls using the command:
	makeindex -s bbglo.ist -o babel.gls babel.glo
	Then run LaTeX on babel.drv again.

	1 Make sure that you have the Docstrip (version 2) program
	  available (it is part of the LaTeX2e distribution); then
	  run the file babel.ins through TeX.
	  This strips all the .dtx files of the comments and produces
	  fast loadable versions of the files. It will tell that you
	  have to move the resulting .ldf, .sty, .def and .fd files
	  into a directory where TeX can find them.
	  Do that now.

	  Docstrip also produces two files called babel.drv and
	  user.drv. You can use babel.drv to produce the full
	  documented source listing of the babel system. (Which is
	  also provided as babel.dvi) You can use user.drv to produce
	  a short document that describes the features of each
	  language specific file.

	2 Make sure you have the hyphenation patterns available for
	  the languages that you intend to use. If you don't have
	  them, you may be able to find them in CTAN, in the directory:
	  /tex-archive/language/hyphenation.
	  If you happen to have a set of patterns that is not
	  available there you could make it available by either
	  putting it in the /incoming directory or sending it to me.

	3 The docstripping process will have produced a file called
	  hyphen.cfg. This file will be loaded when you build a
	  LaTeX format. To build a plain format with the babel system
	  preloaded you should make sure that the standard file
	  `hyphen.tex' has a different name. You could for instance
	  rename it to UShyphen.tex, to indicate American English
	  hyphenation patterns.

	4 Check the hyphenation patterns that you have available and
	  want to load into the format. For each language that you
	  want to hyphenate correctly you need a hyphenation pattern.
	  List them all in the file `language.dat'. The file that is
	  in the distribution serves as an example of what you have to
	  put in there.
	  The files containing hyphenation patterns should be found
	  somewhere on TeX's `input path'. What that means depends on
	  the implementation of TeX you use:
	  - With emTeX there is an environment variable TEXINPUT in
	    which you can list the directories to search through,
	    adding a ! to a directory will make emTeX do a recursive
	    search through the directory tree.
	  - With Unix TeX the `system directories' do not need to be
	    specified in the environment variable TEXINPUTS; there
	    adding a double / to a directory name means recursive
	    searching of the directory tree.
	  **NOTE The file language.dat that is in the distribution
	  ** loads hyphen.tex for english. When you want to use babel
	  ** with plain TeX you will have to rename the file
	  ** hyphen.tex and therefore you will have to change
	  ** language.dat to reflect that change.

	5 Run iniTeX, telling it to load your favorite macro package
	  (ie plain or latex).
	  When you build a LaTeX format iniTeX will find the file
	  hyphen.cfg (provided that you have stored it in the
	  correct place).
	  When you build a plain TeX format iniTeX tries to find
	  hyphen.tex. If you have renamed or moved that file iniTeX
	  will tell you that the file can't be found and ask you for a
	  different name. Enter `hyphen.cfg' at this point.
	  If you haven't renamed or moved hyphen.tex the format will be
	  built *without* the babel code.

	  *Beware*: some implementations of TeX only look in the
	  current directory when the \openin primitive is used. If
	  your TeX does that you need to put the file `languages.dat'
	  in the same directory where you build your format.

	6 When the iniTeX run in step 5 stops with a message about
	  not enough memory (trie_size = ...) and "you can ask a
	  wizard to enlarge me" You have tried to load more
	  hyphenation patterns into TeX's memory then it has room for.
	  In that case you can either remove one or more languages
	  from the file language.dat or be your own wizard and enlarge
	  TeX. I can not tell you how to do that for all
	  implementations of TeX as it differs with each
	  implementation. Your distribution should contain a
	  description of what to.
	  - With emTeX you can influence the size of some of the
	    memory arrays with command line switches (/mt:65000 for
	    the trie_size).
	  - With Unix TeX you have to change a file called tex.ch and
	    rebuild TeX using the supplied Makefile. The change you
	    need to make is to enlarge the trie_size and
	    trie_op_size.

--- Copyright 1997 Johannes Braams. All rights reserved ---