This directory contains a patch for Texinfo version 2.151 to make it work
with almost every character encoding and/or language ...

... but you must have TeX version 3 or newer if you want to use more than
one set of hyphenation patterns within printed manuals.


The changes do not affect the default behavior of Texinfo in any way.
There are four new Texinfo commands controlling the formatting process:

	@setencoding
	@setcaptions
	@setlanguage
and
	@loadlanguage

The default character encoding is ASCII.  To change this, for example,
to ISO 8859-1 you have to say

	@setencoding latin1

at the beginning of your Texinfo input file.  This will load the file
`enc-latin1.texi' (which have to be somewhere in the search path for
TeX input files).

To change all fixed words of the Texinfo format (`chapter', `page', ...)
to another language, say

	@setcaptions german

This reads the required definitions from the file `lang-german.texi'.
You can do this only once within a document.

The `@setencoding' and `@setcaptions' command should be called before
typesetting begins.

All commands introduced so far didn't change the internal native language
support of TeX like selecting an alternate set of hyphenation patterns.
You have to activate this explicitly by saying

	@setlanguage german

The first call of `@setlanguage' automatically loads the hyphenation
patterns for that language.  Future calls to `@setlanguage' switches
only to the given language.  You can pre-load other languages without
selecting them with the `@loadlanguage' command.  Note: `@setlanguage'
is a no-op command if your TeX does not support multiple languages.

``! Too late for patterns'' is the normal response of TeX when you try
to call `@loadlanguage' or `@setlanguage' from within your Texinfo input
file.  There are two ways to avoid this error message.  You can either
use INITEX directly for typesetting (nobody forbids us to do so) or you
create a TeX format file before you format your Texinfo documents with
TeX.  The first case is simple; saying

	$ TEX=initex texi2dvi job.texi

should work fine.  The only problem which could arise is that some TeX
implementations have lower limits with INITEX.  This stops TeX with an
error messages starting with ``! TeX capacity exceeded, sorry''.  You
have to use the second way if this happens.  Create a file `texinfo.ini'
which contains, for example, the lines

	\input texinfo
	@loadlanguage german
	@loadlanguage french
	@dump

All lines except the first and last one are optional.  You can now build
a Texinfo format file by typing

	$ initex ./texinfo.ini

and you format your Texinfo files afterwards with the command

	$ TEX="virtex &./texinfo" texi2dvi job.texi

That's all folks.


Ralph <rs@purple.IN-Ulm.DE>
(soon <rs@purple.UL.BaWue.DE>)
