README.initex                                               last mods: 12/16/94
=============
(consignes d'installation en francais dans la documentation francaise ALIRE.dvi
 ou ALIRE.ps).

NB : All files have changed since the last release.

The following files are given in order:
 A) to allow a generic definition of languages and an easy switch between 
    languages. 
    The code provided (hyconfig.tex) used at INITEX time define
    dynamically the language control sequences (such as \english) and load
    automatically the patterns and exceptions files (via language.dat).
    This is the quickest way to do (La)TeX run with one or more specific
    languages with less modifications.
    >>> To teach your TeX motor to create french formats you need AT LEAST 
    >>> either MlTeX or 8bits fonts (native like DC or virtual like DM) ;  
    >>> outside this, NO WAY!
 B) to simplify TeX adaptation to your own keyboard (via a definition of the
    specific keys of your keyboard or display, keyboard.dat). A special
    coding is provided for that purpose (kbconfig.tex) in the inputs directory.

These files were fully tested using MlTeX V2, Ml/TeX V3 with DC or CMR fonts,
with NFSS V1 and V2, and the new LaTeX.

Here are the corresponding files for part A:
===========================================
ALIRE.initex  people must be aware of...
README.initex what you are reading.
language.dat  (as designed by Johannes Braams in Babel is extended) it contains
              lines defining at least 2 names: language and patterns_file>
              A 3rd file name for hyph. exceptions is allowed and optional.
              An = sign can be provided in front of the language name for 
              defining a dialect (see comments inside the file).        

hyconfig.tex  the code which is used to initiate hyphenation processing.
              (code to read and understand language.dat with TeX V3 included)
hymltex2.tex  the code which is called automatically with MLTeX V2.
hymltex3.tex  the code which is called automatically with MLTeX V3.

dumyhyph.tex  a pseudo hyphenation file that will allow to test new languages

hyphen.cfg    A proposed local LaTeX modification to make the latex2e format. 
(lhyphen.tex  A proposed local LaTeX modification to make the latex209 format.)

frhyph.tex    the master code to load automatically the appropriate patterns
              in 7-bit or 8-bit (look at it for PC and Mac encodings):
[the french exceptions to the proposed hyphenation mechanism is provided
 in the inputs directory under the name frhyphex.tex]  
f7hyph.tex    the french patterns for non-ec/dc (7-bit) fonts (usually CMR)
              (i.e. using the OT1 font encoding as defined with NFSS2).
f8hyph.tex    the french patterns for     ec/dc (8-bit) fonts
              (i.e. using the T1 font encoding as defined with NFSS2).
f8hyph.mac    the french patterns only for Mac encoding (don't use then
              any filter mechanism)
f8hyph.850    the french patterns only for PC 850 code-page (don't use then
              any filter mechanism)

Here are the corresponding files for part B:
===========================================
[The file in which you specify the special keys of your keyboard (keyboard.dat)
 is in directory inputs  (this is of course a 8-bit binary file).
 The code which is used to read keyboard.dat, kbconfig.tex is also in the
 directory inputs.]

Normally, your favorite linguistic keys have to be defined in keyboard.dat
and then incorporated in the format file at initex time.

keyboard.sty  a style file (in test) to allow the user to define his
              special character set (keyboard.dat) when running (La)TeX

Materials for people not using keyboard.dat:
compatible.tex and extdef.tex:
(versions ISO-Latin-1 & for NEXT and PC with code-page 850)
             Original compatibility codes coming from M. Ferguson 
             for MlTeX users. But MlTeX users will better take advantage
             to use kbconfig.tex.

"TO DO" list:
============
Before running INITeX do the following: (to be adapted to your system)
Either: use the makefile in the root directory, if you are under Unix.
Either do it step by step:
1- Try a quick installation (eg without deep modifications):
   a) for plain TeX, replace in plain.tex the line:
                              \input hyphen by: \input kbconfig 
                                                \input hyconfig
      NB: - dont use \input kbconfig if your TeX is running with I/O filters
            (such like the TCP pgms with emtex which do the job)
          - look at the hyphen.cfg provided for additional informations.
   b) for latex (LaTeX2e) use hyphen.cfg given or modified as in a)
(Obsolate:
(   b) for lplain (LaTeX209) use lhyphen.tex given or modified as in a)
(      [Older versions dont provide lhyphen.tex, so modify lplain.tex]
   c) modify your TEXINPUT path variable used for INITEX to point firstly 
      to this directory (e.g. initex) AND to the inputs directory.
   d) INITEX must run now...
      if not look at language.dat for comments about hyphen files, 
          or look at keyboard.dat for comments about 8-bit chars.
2- If you are using kbconfig.tex, update keyboard.dat according to your 
   keyboard-screen and rerun INITEX.
3- Update language.dat according to the languages you are using at your 
   installation and rerun INITEX.
4- If you will use LaTeX209 emulation of LaTeX2e, please copy (or eventually
   merge with the existing file) latex209.cfg file, generated with kbconfig,
   directly to the appropriate directory (for 2e) of your TEXINPUT. 
5- Move to the tests sub-directory (see README.tests) for validation.
6- Are the master and tst directories already processed?  
7- Then terminate installation:
   Have you any file in your usual TEXINPUT of the same names as those
   in the directory inputs? If yes, it would be appropriate to have backups.
   Copy directory inputs to the usual TEXINPUT (i.e. for everybody).
   Copy the formats created to the usual directory (TEXFMTS).

And enjoy it.
                  Bernard GAULLE                     9/11/91
                                   lastly  updated  12/16/94

Here is a directory listing at the time of distribution:
                                (The number of bytes of this README may differ)
%%>============================================================================
total 187
-rw-------  1 gaulle       1385 Mar 13 10:35 ALIRE.initex
-rw-------  1 gaulle       7665 Mar 13 09:58 README.initex
-rw-r--r--  1 gaulle       2452 Jan 13  1994 compatible.tex
-rw-------  1 gaulle        419 Mar 13 10:35 dumyhyph.tex
-rw-r--r--  1 gaulle       6722 Sep 30 13:27 extdef-next.tex
lrwxrwxrwx  1 gaulle         12 Dec 15 09:15 extdef-pc850.tex -> xtdef850.tex
-rw-r--r--  1 gaulle       6786 Mar  6 16:46 extdef.tex
-rw-------  1 gaulle      29960 Mar 13 10:35 f7hyph.tex
-rw-------  1 gaulle      30104 Mar 13 10:36 f8hyph.850
-rw-------  1 gaulle      30733 Mar 13 10:35 f8hyph.mac
-rw-------  1 gaulle      30022 Mar 13 10:35 f8hyph.tex
-rw-------  1 gaulle       3454 Mar 13 10:36 frhyph.tex
-rw-------  1 gaulle       5400 Mar 13 10:36 hyconfig.tex
-rw-------  1 gaulle       4943 Mar 13 10:36 hymltex2.tex
-rw-------  1 gaulle       5281 Mar 13 10:36 hymltex3.tex
-rw-r--r--  1 gaulle       3251 Mar  8 12:02 hyphen.cfg
-rw-------  1 gaulle        939 Mar 13 10:36 keyboard.sty
-rw-r--r--  1 gaulle       2679 May 31  1994 lhyphen.tex
drwxr-xr-x  2 gaulle        512 Mar 13 10:36 tests
-rw-r--r--  1 gaulle       7051 Dec 19 17:41 xtdef850.tex
%%<============================================================================
