% README_distrib of the french style files distribution for \AllTeX  2007/06/28
%                                 LPPL Copyright 
%
CAUTION : ALL FILES IN V5,9994 HAVE CHANGED since the last distribution.

\begin{french}
<< Desole, mais les fichiers README sont tous en anglais. Par contre les 
   pages web et la documentation sont en francais. >> --bg
\end{french}

This material was designed to help (La)TeX users to print french documents
i.e. according to french typographic habits.
Before installation ask yourself the question: is my TeX engine
installation able to process any 8-bit character (ie a char with
decimal code upper than 127)? If not, may be you don’t have:
   either the good fonts (look at the EC for example),
   or the good TeX V3 engine (look also at MlTeX).


Description of the files includes in the package

ALIRE         : this file (README).

frnotes.pdf     :  PRINT IT FIRST, here is the 
                         installation procedure to follow --in french. 

Changements.pdf: (in french) list of improvments.
Copyright.htm : you must read it to know your rights and your duties.
FAQ.pdf       : basic Frequently Asked Questions about (All)TeX and french.
FrenchPro     : the unix command to use when installed in home directory.
FTPinfos.pdf  : warning about binary files (for ftp users).
GNUmakefile   : author's GNU Makefile for Unix, to configure then type "gmake"
GUTenberg.pdf : just a pointer to the french association of users.
Gaulle.-bg    : my name and shortest signature as id for archives purpose.
install.sh    : the most automatic shell for French Pro installation.
Makefile.in   : one used to generate final makefile.gen file.
Mirrors.pdf   : short list of ftp servers mirroring the whole distribution.
MlTeX   dir.  : for information about Multi-Lingual TeX.
README        : this file in ASCII or in pdf:
README_distrib.pdf
TDSfr.pdf     : where to put the french files in your TDS compliant tree.
contrib dir.  : you will find other language-styles running friendly
                    with the french style. Look at its README file.
doc directory : the source files to produce the documentation.
engines directory : TeX engines directory contains:
*.pdf         : related documentation about each TeX engine, few 
                recommandations for installation (sometimes still to write).
                * is the name of a TeX engine (web2c, textures, tetex, ...).
frmsgPB       : a form to fill and send to the author if any pb.
initex  dir.  : look at its README for the INITEX time material
                   (contains a subdirectory for testing purposes)
inputs  dir.  : here are the files used for input to (All)TeX
kb2lex.tex    : a (La)TeX pgm generating .lex files in order to
                generate 7-bit <==> 8-bit translators. For people
                having no lex pgm, the following is provided (lex output):
kb7to8.c      : a sample C pgm to  translate 7-bit to 8-bit accordingly
                to "my" keyboard.dat (given in directory inputs)
kb8to7.c      : a sample C pgm to  transle 8-bit to 7-bit accordingly
                to "my" keyboard.dat (given in directory inputs)
uninstall.sh  : script file created by makefile.gen to remove installed files
latexenv      : environnement setting example to configure to your own needs.
makefile.gen  : a default makefile for people not having GNU make (gmake)
makefile.org  : if available, is the copy of the original makefile.gen file.
tst directory : useful tests for french.sty validation. (torture tests).
web directory : all related French Pro web pages are here.

Windows only files:
install.bat   : end user batch file for installing French Pro automatically.
installFP.bat : unix like install command for whole French Pro files.
uninstall.bat : batch file for removing French Pro files.
makeFP.bat    : unix like make command to use for executing GNUmakefile.


YOUR "TO DO" LIST if you have Unix/Linux but not GNU make command (or don't
=================    want to modify the complex makefile.gen file);
                  if you have Win* but not want to use install.bat 
                                               or mikinstall.bat for MikTeX;
                  if you have MacOs X or heigher but don't want to use the 
                                               prepared makefiles,
                  THEN:
1- Print and read frnotes.pdf (which is in french). This is the users
   guide and the installation guide _for you_. A users guide is also provided
   in the doc directory, this one is _for users_. 
   Print also the file engines/*.pdf where
   * is the name of your TeX engine (web2c, textures, tetex, ...).
2- Are you willing to use keyboard.dat? to generate the 
   7-bit <==> 8-bit translators you will need to complete installation, 
   so update it to your needs in directory inputs.
3- kb7to8 and kb8to7 generation: look at kb2lex.tex
4- Are you willing to create a new format with the french files? If yes, go
   to the initex directory and then come back here.
5- If you are not using the default keyboard encoding, 
   translate fxabbrev.tex to frabbrev.tex with the pgm kb7to8.
6- compile frlicense.dat (in the inputs directory) with LaTeX to start
   your own one month trial period.
7- Go to the tst directory for validation.
8- If not already done: copy the inputs directory files to your usual
   directory TEXINPUT (i.e. for everybody).

Optionally, look at the contrib directory.
 
I hope you enjoy it,
    
    Bernard GAULLE   + e-French team
==============================================================================
