README.initex last mods: 07/06/95 ============= (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). 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 1095 -rw------- 1 gaulle 1385 Apr 11 18:19 ALIRE.initex -rw-r--r-- 1 gaulle 7334 Apr 5 14:38 README.initex -rw-r--r-- 1 gaulle 2452 Jan 13 1994 compatible.tex -rw------- 1 gaulle 419 Apr 11 18:19 dumyhyph.tex -rw-r--r-- 1 gaulle 6722 Sep 30 1994 extdef-next.tex lrwxrwxrwx 1 gaulle 12 Dec 15 1994 extdef-pc850.tex -> xtdef850.tex -rw-r--r-- 1 gaulle 7121 May 2 1995 extdef.tex -rw------- 1 gaulle 29960 Apr 11 18:19 f7hyph.tex -rw------- 1 gaulle 30022 Apr 11 18:19 f8hyph.tex -rw------- 1 gaulle 3313 Apr 11 18:19 frhyph.tex -rw------- 1 gaulle 5534 Apr 11 18:19 hyconfig.tex -rw------- 1 gaulle 4943 Apr 11 18:19 hymltex2.tex -rw------- 1 gaulle 5354 Apr 11 18:19 hymltex3.tex -rw-r--r-- 1 gaulle 3251 Mar 8 1995 hyphen.cfg -rw------- 1 gaulle 1194 Apr 11 18:19 keyboard.sty -rw------- 1 gaulle 620598 Apr 11 13:19 latex.fmt -rw-r--r-- 1 gaulle 2679 May 31 1994 lhyphen.tex -rw------- 1 gaulle 349885 Apr 11 13:18 plain.fmt drwxr-xr-x 2 gaulle 512 Apr 11 18:19 tests -rw-r--r-- 1 gaulle 7051 Dec 19 1994 xtdef850.tex %%<============================================================================