summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/engpron
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-01-01 01:30:46 +0000
committerKarl Berry <karl@freefriends.org>2010-01-01 01:30:46 +0000
commit71b40e8ec749d2bdb93cf522e3dbe5e10ddf8693 (patch)
treef25f42c276e5e51b984f9695080a5aa8dcdba134 /Master/texmf-dist/doc/latex/engpron
parent190be0f375907ce109add95341d6e9b85c60afba (diff)
engpron ^^ update from non-tds.zip
git-svn-id: svn://tug.org/texlive/trunk@16558 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/engpron')
-rw-r--r--Master/texmf-dist/doc/latex/engpron/engpron-en.ltx481
-rw-r--r--Master/texmf-dist/doc/latex/engpron/engpron-ex-en.tex211
-rw-r--r--Master/texmf-dist/doc/latex/engpron/engpron-ex-fr.tex215
-rw-r--r--Master/texmf-dist/doc/latex/engpron/engpron-fr.ltx506
4 files changed, 1413 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/engpron/engpron-en.ltx b/Master/texmf-dist/doc/latex/engpron/engpron-en.ltx
new file mode 100644
index 00000000000..5ca14403b12
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/engpron/engpron-en.ltx
@@ -0,0 +1,481 @@
+%%
+%% This is file `engpron-en.ltx',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% engpron.dtx (with options: `doc,en')
+%% This is a generated file.
+%%
+%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface
+%% <le.texnicien.de.surface@wanadoo.fr>
+%%
+%% This file may be distributed and/or modified under the conditions of
+%% the LaTeX Project Public License, either version 1.2 of this license
+%% or (at your option) any later version. The latest version of this
+%% license is in:
+%%
+%% http://www.latex-project.org/lppl.txt
+%%
+%% and version 1.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+\documentclass[a4paper]{article}
+\usepackage{xspace,array}
+\usepackage[latin1]{inputenc}
+\usepackage[tame,hyphenable]{engpron}
+\usepackage[T1]{fontenc}
+\usepackage[frenchb,english]{babel}
+\usepackage{engpron-tools}
+\usepackage{makeidx}
+\usepackage[colorlinks=true,
+ linkcolor=blue,
+ urlcolor=blue,
+ citecolor=blue]{hyperref}
+\makeindex
+\begin{document}
+\GetFileInfo{engpron.sty}
+\newcommand{\GBP}{\texttt{^^a3}\xspace}
+\title{The English documentation of the package
+ \textsf{engpron}\thanks{This document corresponds to the file
+ \textsf{engpron}~\fileversion, dated \filedate.}}
+\author{Le \TeX nicien de surface\\
+ \href{mailto:le.texnicien.de.surface@wanadoo.fr}%
+ {le.texnicien.de.surface@wanadoo.fr}}
+\date{\docdate}
+
+\maketitle
+
+\begin{abstract}
+ This package is a tiny handle hardly correctly sewn on the package
+ |tipa| the author of which, \textsc{Fukui}~Rei, I thank very much. I
+ also wish to thank T.~\textsc{Lachand-Robert} for his
+ book~\cite{tlachand}, without which I would far less able than I am
+ (poorly) nowadays, and Josselin~\textsc{Noirel} for his invaluable
+ pieces of advice with which he provided me on
+ \url{fr.comp.text.tex}.
+
+ This new (2) version can use the package \texttt{drac} created by
+ Josselin~\textsc{Noirel} if the relevant option is choosen as it is
+ the case by default.
+
+ This package provides macros beginning with the \GBP character, made
+ active, which enable us to write the British or American English
+ pronunciation as one can find it in the ``English Pronouncing
+ Dictionary'' by Daniel~Jones. There is an option to typeset the
+ pronunciation in the style of the Harrap's~\cite{harraps}.
+
+ I provide a table (page~\pageref{latable}) at the end of this
+ document in which one could find the macros beginning with a
+ \texttt{^^a3} and their effect when the options by default
+ |monstress| and |jones| are enforced.
+\end{abstract}
+
+\tableofcontents
+
+\section{Usage}
+
+This package loads \Pkg{tipa}, with which one can write with the
+API\footnote{Alphabet Phon^^e9tique International} through \LaTeX. It
+provides some macros which enable one to typeset the British or
+American English pronunciation \emph{^^e0 la}
+\textsc{Jones}~\cite{jones15} (default) or as
+\textsc{Harrap}~\cite{harraps} with the package option
+\Option{harraps}.
+
+The \Pkg{drac} package is used by default to make of \GBP a robust (in
+\LaTeX\ parlance) active character.
+
+\subsection{The Package and its Options}
+
+Here come the options of \Pkg{engpron}. You can load
+\Pkg{engpron} with
+e.~g.\ \cs{usepackage}|[|\BOP|wild|\BOP|]|\BOP|{|\BOP|engpron|\BOP|}|.
+
+I have tried to group the options according to their effect.
+
+\subsubsection{\GBP's Behaviour}
+
+By default or with the option \Option{wild} this package makes the
+\DescribeOption{wild}
+character \GBP active et redefines it to enable the definition of
+macros such as |^^a3a| and their usage in all the text. It also enables
+us to obtain a uniform presentation of the pronunciation with the
+macro \cs{pron}\marg{text in API}.
+If you prefer, you can chose the option \Option{tame} which
+reestablish the character \GBP in its usual category in the
+\DescribeOption{tame}
+encoding given by |fontenc|\oarg{T1} i.~e.\ makes it active and makes
+it print the symbol of the pound. You will have to use either the
+macro \cs{Pron}\marg{text in API} or \cs{PRON}\marg{text in API} \TO and
+thus obtain the presentation ensured by \cs{pron}\TF or the
+environment |LivreActive| in which \GBP is active.
+
+By default or explicitly with option \Option{drac} this package
+\DescribeOption{drac}
+uses the \Pkg{drac} package to turn \GBP into a \emph{robust} active
+character where \emph{robust} has the meaning it has in the context of
+\LaTeX{} moving arguments.
+\DescribeOption{nodrac}
+The opposite option is \Option{nodrac} with which \Pkg{drac} is not
+loaded and \GBP keeps the definition given in the version~1.
+
+\subsubsection{The Look of the Text}
+
+By default \Pkg{engpron} enforces the option \Option{jones} and so
+\DescribeOption{jones} gives the presentation of the final ``r''
+\PRON{a^^a3Z} and of the optional sounds according to~\cite{jones15}. You
+then obtain \PRON{n^^a3Xen} for the ``schwa \Pron{^^a3e}'' and
+\PRON{a^^a3Xt^^a3sa} for optional ``t''.
+
+There is also the option \Option{harraps} which then gives the
+presentation \DescribeOption{harraps}\label{harrapsrfin} which you
+find in~\cite{harraps}: the optional sounds are given in parenthesis
+and the final ``r'' looks like this \textsl{r}. Moreover
+\pron{\textsl{o}} denotes what Jones~\cite{jones15} writes \PRON{^^a3w}.
+
+\subsubsection{The Syllable Divisions and the Stresses}
+
+The package offers many options supporting the syllable division. With
+option \Option{hyphenable} you allow \LaTeX\ to cut\index{hyphenation}
+words on the explicit marks of syllable division\index{syllable
+ division} \TO see below |^^a3k|, page~\pageref{livrek} \TF and on the
+marks of primary or secondary stresses\index{stress} \TO |^^a3b|, |^^a3B|,
+|^^a3h| et |^^a3H|. In such a case I will say that the marks of syllable
+divisions and of stresses ar \emph{cuttable}\index{cuttable}.
+
+With the option \Option{unhyphenable} you forbid the cutting of words
+on those marks. Those marks are then said to be
+\emph{uncuttable}\index{uncuttable}. \DescribeOption{unhyphenable} To
+keep the behaviour of the preceding version, the option
+\Option{unhyphenable} is the default.
+
+\vspace{\baselineskip}
+
+You can chose between option \Option{visible} and option
+\DescribeOption{visible} \Option{invisible}. With the first,
+\Option{visible}, the macro of syllable division |^^a3k| produces a glyph
+which is defined by \cs{EPSyllabeMarque} \TO macro that you can
+redefine with \cs{renewcommand} and which by default gives a plain
+dot. When you enforce option \Option{invisible}, the macro |^^a3k|
+produces no glyph but is un\slash cuttable according to the chosen
+option between \Option{hyphenable} and \Option{unhyphenable}.
+
+\vspace{\baselineskip}
+
+\Pkg{engpron} offers two other options: \Option{monstress} which is
+\DescribeOption{monstress} the default and \Option{tipastress}. They
+are mutually exclusive and set the glyphs which present the primary
+and secondary stresses. The \DescribeOption{tipastress} user can
+redefine with \cs{renewcommand} the macros used by default \TO
+\cs{EPaccentprincipal} and \cs{EPaccentsecondaire}\TF and thus replace
+the default glyphs I provide. With the first, and default, option you
+obtain \Pron{^^a3h} and \Pron{^^a3b} as glyphs of primary and secondary
+stress respectively; with the second option you obtain
+\textprimstress{} and \textsecstress{} respectively, glyphs provided
+by \Pkg{tipa}.
+
+\subsubsection{Draft and Error}
+
+Some macros, \emph{viz.} |^^a3K|, |^^a3m|, and |^^a3M|, await a letter to
+\DescribeOption{final} determine what they have to do. However all the
+letters are not suitable. With option \Option{final} which is the
+opposite of \DescribeOption{draft} \Option{draft} \Pkg{engpron}
+doesn't produce anything in the document but emits a warning you can
+find in the |.log| file if you \DescribeOption{nice} have choosen
+option \Option{nice} or stops on an error if option
+\DescribeOption{tough} \Option{tough} is enforced. With option
+\Option{draft} you can read, in the document, the following
+``message'' \texttt{\string?\string!<*>\string!\string?} where
+\texttt{*} plays here the role of the \emph{erroneous} character.
+
+\subsubsection{Summary of Available Options}
+
+To sum it up:
+\nopagebreak{}\par\nopagebreak{}
+\noindent
+\begin{tabular}{*{2}{>{\scshape}l} l}
+ \multicolumn{1}{l}{The default option} &
+ \multicolumn{1}{l}{and the opposite option} &
+ act on\\
+ wild & tame & active status of \GBP\\
+ drac & nodrac & robustness of \GBP\\
+ jones & harraps & notation of the pronunciation\\
+ monstress & tipastress & notation of stresses\\
+ unhyphenable & hyphenable & creation of discretionary break\\
+ visible & invisible & visibility of syllable divisions\\
+ \multicolumn{3}{l}{\emph{In case of an error with} \texttt{^^a3K},
+ \texttt{^^a3M}, \emph{or} \texttt{^^a3m}}\\
+ final & draft & written trace in the doc \\
+ nice & tough & \TeX\ warning or error
+\end{tabular}
+
+\subsection{The \GBP Macros}
+\label{sec:macrospound}
+
+I will now present the macros the name of which begins with \GBP.
+
+To create these macros I used once again the book~\cite{tlachand} by
+T.~\textsc{Lachand-Robert}. It's from its example of macros using |^^a7|
+to write greek letters that came the idea of doing something on the
+same line to denote the pronunciation of English words. I needed that
+then for I was teaching maths in English to French pupils in ``Euro''
+section. I found bits every now and then which gave me the means of
+creating macros such as \cs{EP@haut}.
+
+In this section I present just some of the macros which are all given
+in the table on page~\pageref{latable}.
+
+\subsubsection{The Stress Marks}
+
+You will obtain the stress marks \TO as defined by the option
+\DescribePoundMacro{h}
+\Option{tipastress} or \Option{monstress}\TF with, for the primary
+\DescribePoundMacro{H}
+stress |^^a3h| or |^^a3H| and for the secondary stress with |^^a3b| or |^^a3B|.
+\DescribePoundMacro{b}
+\DescribePoundMacro{b} The ``rationale'' for them are, in French, |h| for
+\DescribePoundMacro{B}
+\emph{haut} and |b| for \emph{bas} but I think it is safe to think to
+\emph{high} and \emph{below}.
+
+\NOUVEAU{From version~2, when option \Option{hyphenable} have been
+ chosen these stress marks are cuttable i.~e.\ they give \TeX\
+ discretionary breaks.}
+
+\subsubsection{Syllable Division}
+
+\NOUVEAU{What pertains to syllable division, i.~e.\ marking the limits
+ of the syllables, is introduced in version~2 of the package.}
+
+You may want, or need, to show the limits of the syllables of words as
+\DescribeMacro{EPSyllabeCoupure}
+you can see it in the Jones~\cite{jones15}. To this effect, the
+package provides one macro \cs{EPSyllabeCoupure} linked to the
+|^^a3k|~macro.\label{livrek} Its behaviour is controlled by the following
+pairs of opposite options: \Option{hyphenable}\slash
+\Option{unhyphenable} and \Option{visible}\slash
+\Option{invisible}. With \Option{hyphenable} the macro gives \TeX\ a
+discretionary break which it doesn't with option
+\Option{unhyphenable}. With option \Option{visible} |^^a3k| produces the
+\DescribeMacro{EPSyllabeMarque}
+glyph determined by \cs{EPSyllabeMarque} whereas with
+\Option{invisible} it produces nothing.
+
+By default, \cs{EPSyllabeMarque} is equal to a period (full stop). You
+should take care of the fact that, for \cs{EPSyllabeMarque} is an
+argument of \cs{discretionary}, it suffers some restrictions such as
+e.~g.\ to not contain maths.
+
+Whatever are the enforced options, you can always give \TeX\ a
+\DescribePoundMacro{KX} discretionary break with |^^a3KX| which doesn't
+produce any glyph so |^^a3KX| is cuttable and invisible. With |^^a3KB| and
+|^^a3KH| you get \DescribePoundMacro{KB}\DescribePoundMacro{KH}
+respectively primary and secondary \emph{cuttable} stress marks. With
+|^^a3Kk| you get an always \emph{visible} and \emph{uncuttable} syllable
+division mark. Lastly |^^a3KK| \DescribePoundMacro{KK} produces an always
+visible and cuttable syllable division mark. The look of the marks is
+as a matter of course set by \cs{EPSyllabeMarque}. You will have
+remarked that lower case letters are linked to \emph{uncuttable} marks
+and upper case letters to \emph{cuttable} ones. I have feel no urge to
+provide a |^^a3Kx| which would have done strictly nothing, I tend to
+believe that then a void string is largely enough.
+
+\subsubsection{Optional Sounds}
+
+To note optional sounds \DescribePoundMacro{X} you will use the |^^a3X|
+macro as in |^^a3X|\meta{one letter} for |^^a3X| \textbf{must} be followed
+by \textbf{a single letter}. The macro doesn't work if followed by a
+group. It normally can deal with the optional sounds of the English
+language. It makes the difference, when option \Option{jones} is
+enforced, between the letter ``e'' which gives \PRON{^^a3Xe} and the
+others such as ``t'' which gives \PRON{^^a3Xt} with |^^a3Xe| and |^^a3Xt|
+respectively.
+
+To denote the final and \TO to use Jones' term\TF potential ``r''
+which is pronounced, in British English, when followed by a word
+beginning by a vowel, you will use \DescribePoundMacro{Z} |^^a3Z| which is
+redefined when option \Option{harraps} is chosen,
+see~\ref{harrapsrfin}.
+
+\subsection{Other Macros and one Environment}
+ \label{sec:autresmacros}
+
+I give the user an easy access to some macros which enable us to set
+some details of presentation. You can redefine them with
+\cs{renewcommand} and so doing obtain your own style.
+
+As already said above \TO see \Option{monstress} \TF the macros
+\cs{EPaccentprincipal} and \cs{EPaccentsecondaire} define the glyphs
+obtained with |^^a3H| and |^^a3B| respectively.
+
+\NOUVEAU{Since version~2} the \cs{EPAccentCoupure} macro set the
+\DescribeMacro{EPAccentCoupure}
+behaviour of the stress marks when there is a break. The default is to
+keep the stress mark with the text which begins the new line
+i.~e.\ \Pron{^^a3Bh^^a3p^^a3kf^^a3Xen^^a3H^^a3q^^a3k^^a3s^^a3Xen} is cut, if necessary, as
+\Pron{^^a3Bh^^a3p^^a3kf^^a3Xen}\verb+|+\Pron{^^a3H^^a3q^^a3k^^a3s^^a3Xen}.
+
+\NOUVEAU{Since version~2} the \cs{EPSyllabeMarque} set the mark for
+syllable division and \cs{EPSyllabe}\BOP|Coupure| defines the
+behaviour of \DescribeMacro{EPSyllabeCoupure} the mark in case of
+break. Default is to keep the mark at the end of the line so
+\Pron{^^a3Hh^^a3p^^a3kf^^a3Xen} is cut in \Pron{^^a3Hh^^a3p^^a3k}\verb+|+\Pron{f^^a3Xen}.
+
+The macros \cs{EPouvrante} (\emph{opening}) and \cs{EPfermante}
+(\emph{closing}) define \DescribeMacro{EPouvrante} what precedes and
+follows the pronunciation. The macro \cs{EPtextestyle} defines the
+style of the \DescribeMacro{EPfermante} text of the pronunciation. By
+default, the first two macros give \EPouvrante{} and
+\EPfermante{}; \DescribeMacro{EPtextestyle} \cs{EPtextestyle} is
+defined as |\rmfamily\upshape|.
+
+In what follows I will write that ``the pound is
+active''\index{pound!active} to mean that the
+character \GBP is active and \textbf{is not} defined to produce the
+glyph of the pound sterling but to give the macro beginning with
+\GBP. In all other cases I will write that ``the pound is
+inactive''\index{pound!inactive}.
+
+Those three macros are used by \cs{pron} and \cs{PRON} to produce a
+\DescribeMacro{pron} uniform presentation whatever the contexte and
+the activity of the pound. The macro \cs{pron}\marg{text} produces a
+presentation of the pronunciation as you can find it usually after a
+word in a text. You will use it when ``the pound is
+active\index{pound!active}.'' You will then write |\pron{ma^^a3i}| to
+obtain \PRON{ma^^a3i}.
+
+When ``the pound is inactive\index{pound!inactive}'' you will use
+\DescribeMacro{PRON} \cs{PRON}\marg{text} to obtain the same
+result. In fact as in this document I've loaded the package
+\Pkg{engpron} with option \Option{tame} I've obtained, in the
+preceding paragraph, \PRON{ma^^a3i} with |\PRON{ma^^a3i}|. And now I've said
+it all!
+
+Lastly when the pound is inactive\index{pound!inactive},
+\cs{Pron}\marg{text} give the means of enter API without the
+presentation given by \cs{pron}. With |\Pron{^^a3Hf^^a3in^^a3k^^a3i^^a3kg^^a3en}| you
+will simply obtain \Pron{^^a3Hf^^a3in^^a3k^^a3i^^a3kg^^a3en} without ``decoration.''
+
+The macro \cs{ActiveLaLivre} \DescribeMacro{ActiveLaLivre} makes the
+pound active\index{pound!active}, it is used by \cs{Pron}, \cs{PRON},
+and the following environment. You can use it for example in a array
+\TO with the package \Pkg{array}\TF to make the pound active in a
+column.
+
+
+
+\vspace{\baselineskip}
+
+\NOUVEAU{To conclude}, with the antagonistic macros
+\DescribeMacro{MakeHyphenable} \cs{MakeHyphenable}\slash
+\cs{MakeUnHyphenable} you can thwart the effect of options
+\Option{hyphenable}\slash\Option{unhyphenable}
+\DescribeMacro{MakeUnHyphenable}\index{hyphenation}.
+
+\cs{MakeHyphenable} redefines the macros linked to |^^a3H|, |^^a3h|, |^^a3B|,
+|^^a3b|, and |^^a3k|\index{stress}\index{syllable division} in order that
+they produce cuttable\index{mark!cuttable}\index{cuttable}
+marks. \cs{MakeUnHyphenable} redefines them to obtain uncuttable
+marks\index{mark!uncuttable}\index{uncuttable}. The
+visibility\index{mark!visibility}\index{visibility} of |^^a3k| is not
+modified.
+
+Other pair of opposite macros: \DescribeMacro{MakeVisible}
+\cs{MakeVisible}\slash\cs{MakeInVisible}. The macro
+\cs{Make}\BOP|Vi|\BOP|sible| redefines the macro linked to
+|^^a3k|\index{syllable division}\index{visibility} to make it produce
+visible marks\index{mark!visible}, \cs{MakeInVisible} does the
+opposite\index{mark!invisible}\DescribeMacro{MakeInVisible}. The
+cuttability\index{cuttability} of |^^a3k| is not modified.
+
+\subsection{Conclusion}
+\label{sec:conclusion}
+
+You will notice, if you look at the table~\ref{latable} or the code of
+this package, that there remain place to define other macros using
+an active pound.
+
+First of all some letters are not used and e.~g.\ |^^a3S| does nothing. On
+the other hand, you can define other macros with more than one letter
+behind \GBP but you will have to type |^^a3{aeiou}| to use a macro the
+true name of which would be |\^^a3aeiou|. I do believe it should be kept
+for macros with a substantial effect \Sourire.
+
+As a conclusion, I will freely admit that the chosen code is not
+necessarily optimal. Actually, I have made it along in view of my
+needs and I cannot say that there is a general rule for
+organization. Nevertheless you will be able to notice some efforts
+made towards systematization.
+
+You should feel free to make changes you want as long as \TO in accord
+with the license under which this package is made available\TF you
+change its name. You can, if you prefer, ask for modification and I
+will try to make it according to your requirement if feasible but I
+make \textbf{no} promise to be quick and clever.
+
+\begin{thebibliography}{99}
+\addcontentsline{toc}{section}{Bibliography}
+\bibitem{jones15} Daniel~\textsc{Jones} \dag.
+\emph{English Pronouncing Dictionary}.
+15th Edition. This major new edition edited by Peter Roach \& James
+Hartman.
+Cambridge University Press, \oldstylenums{1997}.\\
+\textsc{isbn} : \texttt{0-521-45903-6}
+\bibitem{jones} Daniel~\textsc{Jones} \dag.
+\emph{English Pronouncing Dictionary}.
+Cambridge University Press, \oldstylenums{1991}.
+\bibitem{tlachand} T.~\textsc{Lachand-Robert}.
+\emph{La ma^^eetrise de \TeX{} et \LaTeX{}}.
+Masson, Paris, Milan, Barcelone, \oldstylenums{1995}.\\
+\textsc{isbn} : \texttt{2-225-84832-7}.
+\bibitem{harraps} J. E. \textsc{Manson}, M.A.
+\emph{Harrap's New Shorter French And English Dictionary.}
+Revised edition \copyright{} George G. Harrap \&
+Co. Ltd. \oldstylenums{1967}.
+Bordas diffuseur, \oldstylenums{1980}.\\
+\textsc{isbn} : \texttt{0 245 59062 5}
+\end{thebibliography}
+
+\newpage
+
+\section{Table of the \GBP Macros}
+
+\thispagestyle{empty}{\LARGE
+\vspace*{\stretch{1}}
+\begin{LivreActive}
+\noindent
+\begin{tabular}[l]{|>{\ttfamily }c|>{\ActiveLaLivre }c||>{\ttfamily
+}c|c||>{\ttfamily }c|c||>{\ttfamily}c|c|}\hline
+\multicolumn{8}{|c|}{Vowels}\\ \hline
+\^^a3a & ^^a3a & \^^a3A & ^^a3A & \^^a3e & ^^a3e & \^^a3E & ^^a3E \\ \hline
+\^^a3i & ^^a3i & \^^a3I & ^^a3I & \^^a3o & ^^a3o & \^^a3O & ^^a3O \\ \hline
+\^^a3u & ^^a3u & \^^a3U & ^^a3U & \^^a3v & ^^a3v & \^^a3x & ^^a3x \\ \hline
+\^^a3c & ^^a3c & \^^a3C & ^^a3C & \^^a3y & ^^a3y & & \\ \hline
+\multicolumn{8}{|c|}{Diphthongs}\\ \hline
+\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3P & ^^a3P\\ \hline
+\^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3w & ^^a3w & \^^a3W & ^^a3W\\ \hline
+\^^a3V & ^^a3V & & & & & & \\ \hline
+\multicolumn{8}{|c|}{Consonants}\\ \hline
+\^^a3d & ^^a3d & \^^a3f & ^^a3f & \^^a3j & ^^a3j & \^^a3l & ^^a3l \\ \hline
+\^^a3n & ^^a3n & \^^a3s & ^^a3s & \^^a3t & ^^a3t & \^^a3z & ^^a3z \\ \hline
+\^^a3T & ^^a3T & \^^a3L & ^^a3L & & & & \\ \hline
+\multicolumn{8}{|c|}{Stresses}\\ \hline
+\^^a3b & ^^a3b & \^^a3B & ^^a3B & \^^a3h & ^^a3h & \^^a3H & ^^a3H \\ \hline
+\^^a3Kb & ^^a3Kb & \^^a3KB & ^^a3KB & \^^a3Kh & ^^a3Kh & \^^a3KH & ^^a3KH \\ \hline
+\multicolumn{8}{|c|}{Syllable division}\\ \hline
+\^^a3k & ^^a3k & \^^a3Kk & ^^a3Kk & \^^a3KK & ^^a3KK & \^^a3KX & ^^a3KX \\ \hline
+\multicolumn{8}{|c|}{French nasalised vowels}\\
+\multicolumn{8}{|c|}{French pronunciation}\\ \hline
+\^^a3Ma & ^^a3Ma & \^^a3Mi & ^^a3Mi & \^^a3Mo & ^^a3Mo & \^^a3Mu & ^^a3Mu \\ \hline
+\multicolumn{8}{|c|}{English pronunciation}\\ \hline
+\^^a3ma & ^^a3ma & \^^a3mi & ^^a3mi & \^^a3mo & ^^a3mo & \^^a3mu & ^^a3mu \\ \hline
+\end{tabular}\label{latable}
+\end{LivreActive}
+\vspace*{\stretch{1}}
+}
+
+\printindex
+\end{document}
+\endinput
+%%
+%% End of file `engpron-en.ltx'.
diff --git a/Master/texmf-dist/doc/latex/engpron/engpron-ex-en.tex b/Master/texmf-dist/doc/latex/engpron/engpron-ex-en.tex
new file mode 100644
index 00000000000..addeaec741b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/engpron/engpron-ex-en.tex
@@ -0,0 +1,211 @@
+%%
+%% This is file `engpron-ex-en.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% engpron.dtx (with options: `exemple,en')
+%% This is a generated file.
+%%
+%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface
+%% <le.texnicien.de.surface@wanadoo.fr>
+%%
+%% This file may be distributed and/or modified under the conditions of
+%% the LaTeX Project Public License, either version 1.2 of this license
+%% or (at your option) any later version. The latest version of this
+%% license is in:
+%%
+%% http://www.latex-project.org/lppl.txt
+%%
+%% and version 1.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+\documentclass[a4paper]{article}
+\usepackage{array,xspace}
+\usepackage[latin1]{inputenc}
+\usepackage[tame,hyphenable]{engpron}[2008/08/15]
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage[frenchb, english]{babel}
+\setlength{\parindent}{0pt}
+\newcommand\BOP{\discretionary{}{}{}}
+\newcommand{\TO}{\textemdash\ \ignorespaces}
+\newcommand{\TF}{\unskip\ \textemdash\xspace}
+\newcommand\Pkg[1]{\textsf{#1}}
+\newcommand\Option[1]{\textsc{#1}}
+\begin{document}
+\begin{center}\LARGE
+ Usage of the \Pkg{engpron} package
+\end{center}
+Here are some examples of the usage of the \texttt{^^a3}-macros. The
+\verb+engpron+ package is loaded whith the options \Option{jones},
+\Option{monstress}, \Option{unhyphenable}, \Option{visible},
+\Option{nice}, and \Option{final} \TO default options\TF and the
+explicit option \Option{tame} which replaces the default option
+\Option{wild}.
+\paragraph{The \texttt{^^a3X} macro} This macro \emph{must} be
+followed by a single letter. It notes the optional sounds the way
+Jones~\cite{jones15} does if option \Option{jones} has been chosen,
+or, the Harraps~\cite{harraps} does if option \Option{harraps} has
+been chosen.
+
+One would type for example
+\verb!\PRON{!\texttt{^^a3e^^a3h^^a3Xt^^a3s^^a3U^^a3kli^^a3k^^a3en}\verb!}!
+to obtain \PRON{^^a3e^^a3h^^a3Xt^^a3s^^a3U^^a3kli^^a3k^^a3en}.
+
+Followed by the letter `e' it gives \Pron{^^a3Xe}
+(\verb+\Pron{^^a3Xe}+) as in \PRON{^^a3B^^a3af^^a3kek^^a3Ht^^a3q^^a3k^^a3s^^a3Xen} one can
+obtain with \verb+\PRON{^^a3B^^a3af^^a3kek^^a3Ht^^a3q^^a3k^^a3s^^a3Xen}+.
+\paragraph{\texttt{^^a3M} and \texttt{^^a3m} macros} They give the French
+nasalised vowels, French way for the 1rst one and English way for the
+2nd. See the 2nd table. They must be followed by one of the following
+letters: a, i, o, u. One may think to the French
+`restaur\textbf{ant}', `v\textbf{in}', `b\textbf{on} march^^e9',
+`Verd\textbf{un}'.
+\paragraph{Macro \texttt{^^a3Z}} It notes the final `r' which is only
+pronunced when followed by a vowel. One has e.g. \Pron{^^a3H^^a3akt^^a3e^^a3Z} with
+\verb+\Pron{^^a3H^^a3akt^^a3e^^a3Z}+.
+\paragraph{Macro \texttt{^^a3k}} Its beheviour is controlled by the
+options \Option{hyphenable} \TO which is the contrary of
+\Option{unhyphenable}\TF and \Option{visible} \TO contrary of
+\Option{invisible}. It is used to mark the syllable limits.
+
+With the default option \Option{visible} it produces a glyph which is
+by default [.] and defined by the macro
+\verb+\EPSyllabeMarque+. This macro can be redefined with a
+\verb+\renewcommand+ if necessary. With option \Option{invisible} \verb+^^a3k+
+doesn't produce any glyph.
+
+With option \Option{hyphenable} \verb+^^a3k+ allows a break but prevent it
+with \Option{unhyphenable} which is the default.
+\paragraph{Macro \texttt{^^a3K}} Its behaviour is determined by the
+following letter. \texttt{X} gives an invisible breakable point,
+\texttt{k} a visible unbreakable mark of syllable limit, \texttt{K} a
+visible \emph{breakable} mark of syllable limit, \texttt{b} an
+unbreakable mark of secondary stress, \texttt{B} a \emph{breakable}
+mark of secondary stress, \texttt{h} an unbreakable mark of primary
+stress, and, avant last, \texttt{H} a \emph{breakable} mark of primary
+stress. Its behaviour \textbf{doesn't depend} on the enforced options.
+\vspace*{\stretch{1}}
+
+\begin{thebibliography}{99}
+\bibitem{jones15} Daniel~\textsc{Jones} \dag.
+\emph{English Pronouncing Dictionary}.
+15th Edition. This major new edition edited by Peter Roach \& James
+Hartman.
+Cambridge University Press, 1997.
+\textsc{isbn} : \texttt{0-521-45903-6}
+\bibitem{harraps} J. E. \textsc{Manson}, M.A.
+\emph{Harrap's New Shorter French And English Dictionary.}
+Revised edition \copyright{} George G. Harrap \&
+Co. Ltd. \oldstylenums{1967}.
+Bordas diffuseur, \oldstylenums{1980}.
+\textsc{isbn} : \texttt{0 245 59062 5}
+\end{thebibliography}
+\newpage
+
+\vspace*{\stretch{1}}
+
+\begin{LivreActive}\Large
+\hspace*{\stretch{1}}
+\begin{tabular}[c]{|>{\ttfamily }c|c||>{\ttfamily }c|c||>{\ttfamily
+ }c|c||>{\ttfamily }c|c||>{\ttfamily }c|c|}\hline
+\multicolumn{10}{|c|}{
+The macros in alphabetic order
+}\\
+\multicolumn{10}{|c|}{
+The star refers to the preceding explanations
+}\\ \hline
+\^^a3a & ^^a3a & \^^a3b & ^^a3b & \^^a3c & ^^a3c & \^^a3d & ^^a3d & \^^a3e & ^^a3e \\ \hline
+\^^a3f & ^^a3f & \^^a3g & ^^a3g & \^^a3h & ^^a3h & \^^a3i & ^^a3i & \^^a3j & ^^a3j \\ \hline
+\^^a3k & $\ast$ & \^^a3l & ^^a3l & \^^a3m & $\ast$ & \^^a3n & ^^a3n & \^^a3o & ^^a3o \\ \hline
+\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3s & ^^a3s & \^^a3t & ^^a3t \\ \hline
+\^^a3u & ^^a3u & \^^a3v & ^^a3v & \^^a3w & ^^a3w & \^^a3x & ^^a3x & \^^a3y & ^^a3y \\ \hline
+\^^a3z & ^^a3z & & & & & & & & \\ \hline
+\^^a3A & ^^a3A & \^^a3B & ^^a3B & \^^a3C & ^^a3C & \^^a3D & ^^a3D & \^^a3E & ^^a3E \\ \hline
+\^^a3F & ^^a3F & \^^a3G & ^^a3G & \^^a3H & ^^a3H & \^^a3I & ^^a3I & \^^a3J & ^^a3J \\ \hline
+\^^a3K & $\ast$ & \^^a3L & ^^a3L & \^^a3M & $\ast$ & \^^a3N & ^^a3N & \^^a3O & ^^a3O \\ \hline
+\^^a3P & ^^a3P & \^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3S & ^^a3S & \^^a3T & ^^a3T \\ \hline
+\^^a3U & ^^a3U & \^^a3V & ^^a3V & \^^a3W & ^^a3W & \^^a3X & $\ast$ & \^^a3Y & ^^a3Y \\ \hline
+\^^a3Z & ^^a3Z & & & & & & & & \\ \hline
+\end{tabular}
+\hspace*{\stretch{1}}
+\end{LivreActive}
+
+\vspace*{\stretch{1}}
+\newpage
+\thispagestyle{empty}
+
+\vspace*{\stretch{1}}
+\begin{LivreActive}
+\hspace*{\stretch{1}}
+{\Large
+\begin{tabular}[c]{|>{\ttfamily }c|c||>{\ttfamily }c|c||>{\ttfamily
+ }c|c||>{\ttfamily }c|c|}\hline
+\multicolumn{8}{|c|}{
+Vowels
+}\\ \hline
+\^^a3a & ^^a3a & \^^a3A & ^^a3A & \^^a3e & ^^a3e & \^^a3E & ^^a3E \\ \hline
+\^^a3i & ^^a3i & \^^a3I & ^^a3I & \^^a3o & ^^a3o & \^^a3O & ^^a3O \\ \hline
+\^^a3u & ^^a3u & \^^a3U & ^^a3U & \^^a3v & ^^a3v & \^^a3x & ^^a3x \\ \hline
+\^^a3c & ^^a3c & \^^a3C & ^^a3C & \^^a3y & ^^a3y & & \\ \hline
+\multicolumn{8}{|c|}{
+Diphtongs
+}\\ \hline
+\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3P & ^^a3P\\ \hline
+\^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3w & ^^a3w & \^^a3W & ^^a3W\\ \hline
+\^^a3V & ^^a3V & & & & & & \\ \hline
+\multicolumn{8}{|c|}{
+Consonants
+}\\ \hline
+\^^a3d & ^^a3d & \^^a3f & ^^a3f & \^^a3j & ^^a3j & \^^a3l & ^^a3l \\ \hline
+\^^a3n & ^^a3n & \^^a3s & ^^a3s & \^^a3t & ^^a3t & \^^a3z & ^^a3z \\ \hline
+\^^a3T & ^^a3T & \^^a3L & ^^a3L & & & & \\ \hline
+\multicolumn{8}{|c|}{
+Stress
+}\\ \hline
+\^^a3b & ^^a3b & \^^a3B & ^^a3B & \^^a3h & ^^a3h & \^^a3H & ^^a3H \\ \hline
+\^^a3Kb & ^^a3Kb & \^^a3KB & ^^a3KB & \^^a3Kh & ^^a3Kh & \^^a3KH & ^^a3KH \\ \hline
+\multicolumn{8}{|c|}{
+Nasalised vowels
+}\\
+\multicolumn{8}{|c|}{
+French pronunciation
+}\\ \hline
+\^^a3Ma & ^^a3Ma & \^^a3Mi & ^^a3Mi & \^^a3Mo & ^^a3Mo & \^^a3Mu & ^^a3Mu \\ \hline
+\multicolumn{8}{|c|}{
+English pronunciation
+}\\ \hline
+\^^a3ma & ^^a3ma & \^^a3mi & ^^a3mi & \^^a3mo & ^^a3mo & \^^a3mu & ^^a3mu \\ \hline
+\multicolumn{8}{|c|}{
+Syllables marking
+}\\ \hline
+\^^a3k & ^^a3k & \^^a3Kk & ^^a3Kk & \^^a3KK & ^^a3KK & \^^a3KX& ^^a3KX\\ \hline
+\end{tabular}}
+\hspace*{\stretch{1}}
+\vspace*{\stretch{4}}
+
+{\footnotesize
+The preceding table is written in a \verb+LivreActive+-environment and
+one must use the \verb+\+\texttt{\^^a3}-macro to obtain the character
+\^^a3. But one can type `^^a3a' with a straightforward `\texttt{\^^a3a}'.
+
+Inside a \verb+LivreActive+-environment, one obtains \pron{^^a3H^^a3akt^^a3e^^a3Z}
+with \verb+\pron{+\texttt{\^^a3H}\BOP\texttt{\^^a3akt}\BOP\texttt{\^^a3e}\BOP%
+\texttt{\^^a3Z}\verb+}+ but one will notice by reading the present
+\texttt{engpron-ex-en.tex} file what is required to obtain a semblance of
+\texttt{verbatim}.
+}
+
+\vspace{2\baselineskip}
+\newlength{\montruc}\settowidth{\montruc}{Yvon \textsc{Henel}, \TeX
+ nicien de surface.}
+\hspace*{\stretch{1}}\makebox[\montruc][c]{Yvon \textsc{Henel}, \TeX
+ nicien de surface.}\\[.5\baselineskip]
+\hspace*{\stretch{1}}\makebox[\montruc][c]{2008-07-15}
+
+\vspace*{\stretch{1}}
+\end{LivreActive}
+\end{document}
+\endinput
+%%
+%% End of file `engpron-ex-en.tex'.
diff --git a/Master/texmf-dist/doc/latex/engpron/engpron-ex-fr.tex b/Master/texmf-dist/doc/latex/engpron/engpron-ex-fr.tex
new file mode 100644
index 00000000000..d48f4a369bf
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/engpron/engpron-ex-fr.tex
@@ -0,0 +1,215 @@
+%%
+%% This is file `engpron-ex-fr.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% engpron.dtx (with options: `exemple,fr')
+%% This is a generated file.
+%%
+%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface
+%% <le.texnicien.de.surface@wanadoo.fr>
+%%
+%% This file may be distributed and/or modified under the conditions of
+%% the LaTeX Project Public License, either version 1.2 of this license
+%% or (at your option) any later version. The latest version of this
+%% license is in:
+%%
+%% http://www.latex-project.org/lppl.txt
+%%
+%% and version 1.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+\documentclass[a4paper]{article}
+\usepackage{array,xspace}
+\usepackage[latin1]{inputenc}
+\usepackage[tame,hyphenable]{engpron}[2008/08/15]
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage[english, frenchb]{babel}
+\setlength{\parindent}{0pt}
+\newcommand\BOP{\discretionary{}{}{}}
+\newcommand{\TO}{\textemdash\ \ignorespaces}
+\newcommand{\TF}{\unskip\ \textemdash\xspace}
+\newcommand\Pkg[1]{\textsf{#1}}
+\newcommand\Option[1]{\textsc{#1}}
+\newcommand{\CAD}{c.-^^e0-d.\xspace}
+\begin{document}
+\begin{center}\LARGE
+ Utilisation du module \Pkg{engpron}
+\end{center}
+Voici quelques exemples d'utilisation des macros avec \texttt{^^a3}. Le
+module \verb+engpron+ est charg^^e9 avec les options \Option{jones},
+\Option{monstress}, \Option{unhyphenable}, \Option{visible},
+\Option{nice} et \Option{final} \TO options par d^^e9faut\TF et l'option
+explicite \Option{tame} qui remplace l'option par d^^e9faut
+\Option{wild}.
+\paragraph{Macro \texttt{^^a3X}} Cette macro \emph{doit} ^^eatre suivie d'une
+lettre seule. Elle note les sons optionnels ^^e0 la mani^^e8re de
+Jones~\cite{jones15}, avec l'option \Option{jones}, ou ^^e0 la mani^^e8re du
+Harraps~\cite{harraps}, avec l'option \Option{harraps}.
+
+On aura par exemple
+\verb!\PRON{!\texttt{^^a3e^^a3h^^a3Xt^^a3s^^a3U^^a3kli^^a3k^^a3en}\verb!}!
+qui donnera \PRON{^^a3e^^a3h^^a3Xt^^a3s^^a3U^^a3kli^^a3k^^a3en}.
+
+Suivie de la lettre \og e \fg elle donne \Pron{^^a3Xe}
+(\verb+\Pron{^^a3Xe}+) comme dans \PRON{^^a3B^^a3af^^a3kek^^a3Ht^^a3q^^a3k^^a3s^^a3Xen} qui
+s'obtient avec \verb+\PRON{^^a3B^^a3af^^a3kek^^a3Ht^^a3q^^a3k^^a3s^^a3Xen}+.
+\paragraph{Macros \texttt{^^a3M} et \texttt{^^a3m}} Elles permettent
+d'obtenir les voyelles nasalis^^e9s, ^^e0 la mode fran^^e7aise pour la 1\iere
+et ^^e0 la mode anglaise pour la 2\up{de}. Se reporter ^^e0 la 2\ieme
+table. Elles doivent ^^eatre suivies d'une des lettres : a, i, o,
+u. Penser ^^e0 \og ban \fg, \og vin \fg, \og long \fg et \og parfum \fg
+(dans la prononciation tr^^e8s correcte du fran^^e7ais soutenu).
+\paragraph{Macro \texttt{^^a3Z}} Elle note le \og r \fg final qui n'est
+prononc^^e9 qu'en cas de liaison. On a, p. ex. \Pron{^^a3H^^a3akt^^a3e^^a3Z} avec
+\verb+\Pron{^^a3H^^a3akt^^a3e^^a3Z}+.
+\paragraph{Macro \texttt{^^a3k}} Son comportement est d^^e9termin^^e9e par les
+options \Option{hyphenable} \TO qui s'oppose ^^e0
+\Option{unhyphenable}\TF et \Option{visible} \TO qui s'oppose ^^e0
+\Option{invisible}. Elle sert ^^e0 marquer les limites de syllabes.
+
+Avec l'option \Option{visible}, option par d^^e9faut, on obtient une
+marque qui est par d^^e9faut [.] et est d^^e9finie par la
+macro \verb+\EPSyllabeMarque+. Cette derni^^e8re peut ^^eatre red^^e9finie ^^e0
+l'aide de \verb+\renewcommand+. Avec l'option \Option{invisible},
+\verb+^^a3k+ ne produit aucun glyphe.
+
+Avec l'option \Option{hyphenable}, \verb+^^a3k+ permet la c^^e9sure mais
+l'interdit avec l'option \Option{unhyphenable} qui est l'option par
+d^^e9faut.
+\paragraph{Macro \texttt{^^a3K}} Son comportement est d^^e9termin^^e9e par la
+lettre suivante. \texttt{X} donne un point de c^^e9sure invisible,
+\texttt{k} une marque ins^^e9cable et visible de syllabisation,
+\texttt{K} une marque \emph{s^^e9cable} et visible de syllabisation,
+\texttt{b} une marque d'accent tonique secondaire ins^^e9cable,
+\texttt{B} une marque d'accent tonique secondaire \emph{s^^e9cable},
+\texttt{h} une marque d'accent tonique principal ins^^e9cable et, enfin,
+\texttt{H} une marque d'accent tonique principal \emph{s^^e9cable}. Son
+comportement \textbf{ne d^^e9pend pas} des options en vigueur.
+\vspace*{\stretch{1}}
+
+\begin{thebibliography}{99}
+\bibitem{jones15} Daniel~\textsc{Jones} \dag.
+\emph{English Pronouncing Dictionary}.
+15th Edition. This major new edition edited by Peter Roach \& James
+Hartman.
+Cambridge University Press, 1997.
+\textsc{isbn} : \texttt{0-521-45903-6}
+\bibitem{harraps} J. E. \textsc{Manson}, M.A.
+\emph{Harrap's New Shorter French And English Dictionary.}
+Revised edition \copyright{} George G. Harrap \&
+Co. Ltd. \oldstylenums{1967}.
+Bordas diffuseur, \oldstylenums{1980}.
+\textsc{isbn} : \texttt{0 245 59062 5}
+\end{thebibliography}
+\newpage
+
+\vspace*{\stretch{1}}
+
+\begin{LivreActive}\Large
+\hspace*{\stretch{1}}
+\begin{tabular}[c]{|>{\ttfamily }c|c||>{\ttfamily }c|c||>{\ttfamily
+ }c|c||>{\ttfamily }c|c||>{\ttfamily }c|c|}\hline
+\multicolumn{10}{|c|}{
+Classement par ordre alphab^^e9tique
+}\\
+\multicolumn{10}{|c|}{
+L'^^e9toile renvoie aux explications ci-dessus
+}\\ \hline
+\^^a3a & ^^a3a & \^^a3b & ^^a3b & \^^a3c & ^^a3c & \^^a3d & ^^a3d & \^^a3e & ^^a3e \\ \hline
+\^^a3f & ^^a3f & \^^a3g & ^^a3g & \^^a3h & ^^a3h & \^^a3i & ^^a3i & \^^a3j & ^^a3j \\ \hline
+\^^a3k & $\ast$ & \^^a3l & ^^a3l & \^^a3m & $\ast$ & \^^a3n & ^^a3n & \^^a3o & ^^a3o \\ \hline
+\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3s & ^^a3s & \^^a3t & ^^a3t \\ \hline
+\^^a3u & ^^a3u & \^^a3v & ^^a3v & \^^a3w & ^^a3w & \^^a3x & ^^a3x & \^^a3y & ^^a3y \\ \hline
+\^^a3z & ^^a3z & & & & & & & & \\ \hline
+\^^a3A & ^^a3A & \^^a3B & ^^a3B & \^^a3C & ^^a3C & \^^a3D & ^^a3D & \^^a3E & ^^a3E \\ \hline
+\^^a3F & ^^a3F & \^^a3G & ^^a3G & \^^a3H & ^^a3H & \^^a3I & ^^a3I & \^^a3J & ^^a3J \\ \hline
+\^^a3K & $\ast$ & \^^a3L & ^^a3L & \^^a3M & $\ast$ & \^^a3N & ^^a3N & \^^a3O & ^^a3O \\ \hline
+\^^a3P & ^^a3P & \^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3S & ^^a3S & \^^a3T & ^^a3T \\ \hline
+\^^a3U & ^^a3U & \^^a3V & ^^a3V & \^^a3W & ^^a3W & \^^a3X & $\ast$ & \^^a3Y & ^^a3Y \\ \hline
+\^^a3Z & ^^a3Z & & & & & & & & \\ \hline
+\end{tabular}
+\hspace*{\stretch{1}}
+\end{LivreActive}
+
+\vspace*{\stretch{1}}
+\newpage
+\thispagestyle{empty}
+
+\vspace*{\stretch{1}}
+\begin{LivreActive}
+\hspace*{\stretch{1}}
+{\Large
+\begin{tabular}[c]{|>{\ttfamily }c|c||>{\ttfamily }c|c||>{\ttfamily
+ }c|c||>{\ttfamily }c|c|}\hline
+\multicolumn{8}{|c|}{
+Voyelles
+}\\ \hline
+\^^a3a & ^^a3a & \^^a3A & ^^a3A & \^^a3e & ^^a3e & \^^a3E & ^^a3E \\ \hline
+\^^a3i & ^^a3i & \^^a3I & ^^a3I & \^^a3o & ^^a3o & \^^a3O & ^^a3O \\ \hline
+\^^a3u & ^^a3u & \^^a3U & ^^a3U & \^^a3v & ^^a3v & \^^a3x & ^^a3x \\ \hline
+\^^a3c & ^^a3c & \^^a3C & ^^a3C & \^^a3y & ^^a3y & & \\ \hline
+\multicolumn{8}{|c|}{
+Diphtongues
+}\\ \hline
+\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3P & ^^a3P\\ \hline
+\^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3w & ^^a3w & \^^a3W & ^^a3W\\ \hline
+\^^a3V & ^^a3V & & & & & & \\ \hline
+\multicolumn{8}{|c|}{
+Consonnes
+}\\ \hline
+\^^a3d & ^^a3d & \^^a3f & ^^a3f & \^^a3j & ^^a3j & \^^a3l & ^^a3l \\ \hline
+\^^a3n & ^^a3n & \^^a3s & ^^a3s & \^^a3t & ^^a3t & \^^a3z & ^^a3z \\ \hline
+\^^a3T & ^^a3T & \^^a3L & ^^a3L & & & & \\ \hline
+\multicolumn{8}{|c|}{
+Accents toniques
+}\\ \hline
+\^^a3b & ^^a3b & \^^a3B & ^^a3B & \^^a3h & ^^a3h & \^^a3H & ^^a3H \\ \hline
+\^^a3Kb & ^^a3Kb & \^^a3KB & ^^a3KB & \^^a3Kh & ^^a3Kh & \^^a3KH & ^^a3KH \\ \hline
+\multicolumn{8}{|c|}{
+Voyelles nasalis^^e9es
+}\\
+\multicolumn{8}{|c|}{
+prononciation fran^^e7aise
+}\\ \hline
+\^^a3Ma & ^^a3Ma & \^^a3Mi & ^^a3Mi & \^^a3Mo & ^^a3Mo & \^^a3Mu & ^^a3Mu \\ \hline
+\multicolumn{8}{|c|}{
+prononciation anglaise
+}\\ \hline
+\^^a3ma & ^^a3ma & \^^a3mi & ^^a3mi & \^^a3mo & ^^a3mo & \^^a3mu & ^^a3mu \\ \hline
+\multicolumn{8}{|c|}{
+Syllabisation
+}\\ \hline
+\^^a3k & ^^a3k & \^^a3Kk & ^^a3Kk & \^^a3KK & ^^a3KK & \^^a3KX& ^^a3KX\\ \hline
+\end{tabular}}
+\hspace*{\stretch{1}}
+\vspace*{\stretch{4}}
+
+{\footnotesize
+Le tableau ci-dessus est ^^e9crit dans un environnement
+\verb+LivreActive+ et l'on doit utiliser la macro \verb+\+\texttt{\^^a3}
+pour obtenir le caract^^e8re \^^a3. Mais on peut ^^e9crire \og ^^a3a \fg
+directement avec \og \texttt{\^^a3a} \fg.
+
+Lorsque l'on se trouve dans l'environnement \verb+LivreActive+, on
+obtient \pron{^^a3H^^a3akt^^a3e^^a3Z} avec
+\verb+\pron{+\texttt{\^^a3H}\BOP\texttt{\^^a3akt}\BOP\texttt{\^^a3e}\BOP%
+ \texttt{\^^a3Z}\verb+}+ mais on remarquera, en lisant ce fichier
+\texttt{engpron-ex-fr.tex} ce qu'il faut faire comme \og gymnastique \fg
+pour obtenir un semblant de \texttt{verbatim}.
+}
+
+\vspace{2\baselineskip}
+\newlength{\montruc}\settowidth{\montruc}{Yvon \textsc{Henel}, \TeX
+ nicien de surface.}
+\hspace*{\stretch{1}}\makebox[\montruc][c]{Yvon \textsc{Henel}, \TeX
+ nicien de surface.}\\[.5\baselineskip]
+\hspace*{\stretch{1}}\makebox[\montruc][c]{2008-07-15}
+
+\vspace*{\stretch{1}}
+\end{LivreActive}
+\end{document}
+\endinput
+%%
+%% End of file `engpron-ex-fr.tex'.
diff --git a/Master/texmf-dist/doc/latex/engpron/engpron-fr.ltx b/Master/texmf-dist/doc/latex/engpron/engpron-fr.ltx
new file mode 100644
index 00000000000..9da46c323ed
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/engpron/engpron-fr.ltx
@@ -0,0 +1,506 @@
+%%
+%% This is file `engpron-fr.ltx',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% engpron.dtx (with options: `doc,fr')
+%% This is a generated file.
+%%
+%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface
+%% <le.texnicien.de.surface@wanadoo.fr>
+%%
+%% This file may be distributed and/or modified under the conditions of
+%% the LaTeX Project Public License, either version 1.2 of this license
+%% or (at your option) any later version. The latest version of this
+%% license is in:
+%%
+%% http://www.latex-project.org/lppl.txt
+%%
+%% and version 1.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+\documentclass[a4paper]{article}
+\usepackage{xspace,array}
+\usepackage[latin1]{inputenc}
+\usepackage[tame,hyphenable]{engpron}
+\usepackage[T1]{fontenc}
+\usepackage[english,frenchb]{babel}
+\usepackage{engpron-tools}
+\usepackage{makeidx}
+\usepackage[colorlinks=true,
+ linkcolor=blue,
+ urlcolor=blue,
+ citecolor=blue]{hyperref}
+\makeindex
+\begin{document}
+\GetFileInfo{engpron.sty}
+\newcommand{\GBP}{\texttt{^^a3}\xspace}
+\title{Documentation fran^^e7aise de l'extension
+ \textsf{engpron}\thanks{%
+ Ce document correspond au fichier
+ \textsf{engpron}~\fileversion,
+ du \filedate, ^^e9dition du cinquantenaire.}}
+\author{Le \TeX nicien de surface\\
+ \href{mailto:le.texnicien.de.surface@wanadoo.fr}%
+ {le.texnicien.de.surface@wanadoo.fr}}
+\date{\docdate}
+
+\maketitle
+
+\begin{abstract}
+ Ce module n'est qu'une petite poign^^e9e fix^^e9e tant bien que mal sur
+ le module \Pkg{tipa} dont je tiens ^^e0 remercier l'auteur,
+ \textsc{Fukui}~Rei, tr^^e8s cordialement. Je remercie ^^e9galement
+ T.~\textsc{Lachand-Robert} pour son ouvrage~\cite{tlachand} sans
+ lequel je ne serais que peu de chose |;)| et
+ Josselin~\textsc{Noirel} pour ses conseils sur
+ \url{fr.comp.text.tex} ainsi que pour \og notre \fg module
+ \Pkg{drac}.
+
+ Ce module fournit des macros\footnote{appel^^e9es ensuite \og macros
+ en \GBP \fg.} commen^^e7ant par le caract^^e8re \GBP, rendu actif, qui
+ permettent d'^^e9crire la prononciation de l'anglais britannique ou
+ am^^e9ricain ^^e0 l'aide de l'API telle qu'on la trouve dans le \og
+ English Pronouncing Dictionary \fg de Daniel~\textsc{Jones}. Une
+ option permet d'obtenir le style adopt^^e9 par le
+ Harraps~\cite{harraps}.
+
+ Le module \Pkg{engpron} utilise, si l'option \Option{drac} est
+ choisie comme c'est le cas par d^^e9faut, le module \Pkg{drac} pour
+ faire de \GBP un caract^^e8re actif robuste, ce qui permet d'utiliser
+ les macros en \GBP dans des arguments \og mobiles \fg au sens de
+ \LaTeX.
+
+ On trouvera en fin de document (page~\pageref{latable}) une table
+ des commandes commen^^e7ant par un \GBP dans la configuration par
+ d^^e9faut : \Option{monstress} et \Option{jones}.
+\end{abstract}
+
+\tableofcontents
+
+\section{Utilisation}
+
+Ce module charge \Pkg{tipa}, merveilleux module qui permet
+d'^^e9crire en API, alphabet phon^^e9tique international, avec
+\LaTeX{}. Il fournit quelques macros qui permettent de reprendre la
+prononciation de l'anglais britannique et am^^e9ricain telle qu'on la
+trouve dans le \textsc{Jones}~\cite{jones15} ou dans~\cite{jones}.
+
+L'extension \Pkg{drac} est utilis^^e9, par d^^e9faut, pour faire de \GBP un
+caract^^e8re actif robuste au sens de \LaTeX.
+
+\subsection{Le module et ses options}
+
+On pr^^e9sente ici les options de \Pkg{engpron}. On chargera
+\Pkg{engpron} avec, p.~ex.,
+\cs{usepackage}|[|\BOP|wild|\BOP|]|\BOP|{|\BOP|engpron|\BOP|}|.
+
+J'ai tent^^e9 de regrouper les options par rapport ^^e0 leurs effets.
+
+\subsubsection{Comportement de \GBP}
+
+Par d^^e9faut, ou explicitement avec l'option \Option{wild}, ce module
+rend le caract^^e8re \GBP actif et le red^^e9finit de mani^^e8re ^^e0
+\DescribeOption{wild} permettre la d^^e9finition de macros comme
+|^^a3a| et leur utilisation dans tout le texte. Il permet ^^e9galement
+d'obtenir une pr^^e9sentation uniforme de la prononciation ^^e0 l'aide de
+la macro \cs{pron}\marg{texte en API}.
+Si l'on pr^^e9f^^e8re, on peut choisir l'option \Option{tame}
+qui r^^e9tablit le caract^^e8re \GBP dans sa cat^^e9gorie dans le
+\DescribeOption{tame}
+codage fournit par |fontenc|\oarg{T1} et donc le rend actif et lui
+permet d'^^e9crire le symbole de la livre sterling. Il faudra alors
+utiliser soit la macro \cs{Pron}\marg{texte en API}, soit
+\cs{PRON}\marg{texte en API} \TO et obtenir ainsi la pr^^e9sentation
+donn^^e9e par \cs{pron}\TF soit enfin l'environnement |LivreActive| dans
+lequel \GBP est activ^^e9.
+
+Par d^^e9faut, ou explicitement avec l'option \Option{drac}, ce module
+\DescribeOption{drac}
+utilise l'extension \Pkg{drac} pour faire de \GBP un caract^^e8re
+actif et \emph{robuste} au sens des arguments mouvants de \LaTeX.
+\DescribeOption{nodrac}
+L'option oppos^^e9e est \Option{nodrac} qui ne charge pas l'extension
+\Pkg{drac} est conserve les d^^e9finitions de \GBP donn^^e9es par la
+version~1.
+
+\subsubsection{Aspect du texte}
+
+Par d^^e9faut \Pkg{engpron} active l'option \Option{jones} qui
+\DescribeOption{jones} permet d'obtenir une pr^^e9sentation du \og r \fg
+final \PRON{a^^a3Z} et des sons optionnels conforme ^^e0~\cite{jones15}. On
+obtient \PRON{n^^a3Xen} pour le \og schwa \Pron{^^a3e} \fg et \PRON{a^^a3Xt^^a3sa}
+pour un \og t \fg optionnel.
+
+\Pkg{engpron} propose ^^e9galement l'option \Option{harraps} qui permet
+d'obtenir \DescribeOption{harraps}\label{harrapsrfin} alors une
+pr^^e9sentation conforme ^^e0~\cite{harraps} \CAD que les sons optionnels
+sont repr^^e9sent^^e9s entre parenth^^e8ses et que le \og r \fg final se
+pr^^e9sente comme ceci : \textsl{r}. De plus \pron{\textsl{o}} note ce
+que Jones~\cite{jones15} ^^e9crit \PRON{^^a3w}.
+
+\subsubsection{Syllabisation et accents toniques}
+
+Le module propose plusieurs options g^^e9rant la syllabisation. Avec
+\Option{hyphenable} on \DescribeOption{hyphenable} autorise \LaTeX\ ^^e0
+couper\index{coupure} sur les marques explicites de
+syllabisation\index{syllabisation} \TO voir plus loin |^^a3k|,
+page~\pageref{livrek}\TF et sur les marques d'accents
+toniques\index{accent tonique} \TO |^^a3b|, |^^a3B|, |^^a3h| et |^^a3H|. On dira
+alors que les marques de syllabisation et d'accents toniques sont
+\emph{s^^e9cables}\index{s^^e9cable}.
+
+Avec l'option \Option{unhyphenable}, on interdit la coupure des mots
+sur ces marques. Les marques sont dites alors
+\emph{ins^^e9cables}\index{ins^^e9cable}. \DescribeOption{unhyphenable} Pour
+conserver le comportement des versions pr^^e9c^^e9dentes, c'est l'option
+\Option{unhyphenable} qui est choisie par d^^e9faut.
+
+\vspace{\baselineskip}
+
+On peut choisir entre l'option \Option{visible} et l'option
+\Option{invisible}. Avec la premi^^e8re, \Option{visible}, la marque de
+\DescribeOption{visible} syllabisation, |^^a3k|, produit un glyphe qui
+est d^^e9fini par \cs{EPSyllabeMarque} \TO macro que l'on peut red^^e9finir
+^^e0 coup de \cs{renewcommand} et qui, par d^^e9faut, donne un simple
+point. Lorsque l'option \Option{invisible} est en vigueur, la macro
+\DescribeOption{invisible} |^^a3k| ne produit aucun glyphe mais la c^^e9sure
+y reste possible si l'option \Option{hyphenable} est en vigueur.
+
+\vspace{\baselineskip}
+
+\Pkg{engpron} propose deux autres options : \Option{monstress},
+\DescribeOption{monstress} option par d^^e9faut, et
+\Option{tipastress}. Elles sont exclusives l'une de l'autre et
+d^^e9finissent les glyphes repr^^e9sentant les accents toniques principaux
+et secondaires. L'utilisateur peut \DescribeOption{tipastress}
+red^^e9finir ^^e0 sa convenance les deux macros utilis^^e9es par d^^e9faut
+\cs{EPaccentprincipal} et \cs{EPaccent}\BOP|secondaire| et remplacer
+ainsi les \og glyphes \fg que je fournis par d^^e9faut. Avec la
+premi^^e8re, on obtient \Pron{^^a3h} et \Pron{^^a3b} comme marque d'accent
+tonique principal et secondaire respectivement et avec la deuxi^^e8me
+\textprimstress{} et \textsecstress{} respectivement, glyphes fournis
+par \Pkg{tipa}.
+
+\subsubsection{Brouillon et erreur}
+
+Certaines macros, ^^e0 savoir |^^a3K|, |^^a3m| et |^^a3M|, attendent une lettre
+pour d^^e9terminer ce qu'elles ont ^^e0 faire. Cependant toutes les lettres
+ne conviennent pas. Avec l'option \Option{final},
+\DescribeOption{final}qui s'oppose ^^e0 \Option{draft}, \Pkg{engpron} ne
+produit rien dans le document mais ^^e9met un \DescribeOption{draft}
+avertissement dont on trouve la trace dans le fichier |.log|, avec
+l'option \Option{nice}, ou s'arr^^eate sur une erreur
+\DescribeOption{nice} avec l'option \Option{tough}. Avec
+\Option{draft}, on lit le texte suivant dans le document produit:
+\texttt{\string?\string!<*>\string!\string?} o^^f9 \DescribeOption{tough}
+\texttt{*} tient ici la place du caract^^e8re \emph{erron^^e9}.
+
+\subsubsection{R^^e9sum^^e9 des options disponibles}
+
+Bref, pour r^^e9sumer:
+\nopagebreak{}\par\nopagebreak{}
+\noindent
+\begin{tabular}{*{2}{>{\scshape}l} l}
+ \multicolumn{1}{l}{L'option par d^^e9faut} &
+ \multicolumn{1}{l}{et l'option oppos^^e9e} &
+ agissent sur\\
+ wild & tame & activit^^e9 de \GBP\\
+ drac & nodrac & robustesse de \GBP\\
+ jones & harraps & notation de la prononciation\\
+ monstress & tipastress & notation des accents toniques\\
+ unhyphenable & hyphenable & cr^^e9ation de points de c^^e9sure\\
+ visible & invisible & visibilit^^e9 de la syllabisation\\
+ \multicolumn{3}{l}{\emph{En cas d'erreur avec} \texttt{^^a3K},
+ \texttt{^^a3M} \emph{ou} \texttt{^^a3m}}\\
+ final & draft & trace \og ^^e9crite\fg \\
+ nice & tough & avertissement ou message d'erreur
+\end{tabular}
+
+\subsection{Les macros \og \GBP \fg}
+\label{sec:macrospound}
+
+Nous allons maintenant pr^^e9senter les macros commen^^e7ant par \GBP.
+
+Pour r^^e9aliser ces macros, je me suis appuy^^e9 une fois encore sur
+T.~\textsc{Lachand-Robert} dans~\cite{tlachand}. C'est son exemple
+de macros utilisant |^^a7| pour ^^e9crire les lettres grecques qui m'a
+donn^^e9 l'id^^e9e de faire pareil pour pouvoir noter la phon^^e9tique
+anglaise, ce dont j'avais besoin pour mes classes\footnote{On finit
+ par faire des choses ^^e9tranges lorsque l'on enseigne les
+ math^^e9matiques \emph{en anglais} en section europ^^e9enne de
+ lyc^^e9e\Sourire.}. Et c'est en piochant de ci de l^^e0 que j'ai trouv^^e9
+les techniques pour r^^e9aliser les macros comme \cs{EP@haut}.
+
+Je ne pr^^e9sente dans cette section que quelques unes des macros
+reprises dans la table situ^^e9e page~\pageref{latable}.
+
+\subsubsection{Accents toniques}
+
+On obtient les accents toniques \TO tels que d^^e9finit par l'option
+\DescribePoundMacro{h} \Option{tipastress} ou \Option{monstress}\TF
+avec, pour l'accent tonique principal\index{accent
+principal}\index{accent tonique}, \DescribePoundMacro{H} |^^a3h| \TO |h|
+comme \emph{haut}\TF ou encore, pour des raisons de commodit^^e9s de
+frappe au clavier, par |^^a3H|. \DescribePoundMacro{b}Pour l'accent
+tonique secondaire\index{accent secondaire}, on utilisera
+\DescribePoundMacro{B}
+indiff^^e9remment soit |^^a3b| soit |^^a3B| \TO |b| pour \emph{bas}.
+
+\NOUVEAU{D^^e9sormais, quand l'option \Option{hyphenable} est choisie, les
+ marques d'accents toniques fournissent ^^e0 \TeX\ des points de
+ coupure de mot \TO \emph{c^^e9sure}. Ils sont s^^e9cables.}
+
+\subsubsection{Syllabisation}
+
+\NOUVEAU{Ce qui concerne la \emph{syllabisation}, \CAD l'indication
+ des limites de syllabes, est introduit par la version~2 du
+ module.}
+
+On peut avoir envie, ou besoin, d'indiquer la limite des syllabes
+des mots, comme on le voit dans le Jones~\cite{jones15}. Pour ce
+faire, le module fournit une seule macro \cs{EPSyllabeCoupure}
+\DescribeMacro{EPSyllabeCoupure} rattach^^e9e ^^e0 la macro\label{livrek}
+|^^a3k|\DescribePoundMacro{k}. Son comportement est contr^^f4l^^e9 par les
+couples d'options \Option{hyphenable}\slash \Option{unhyphenable} et
+\Option{visible}\slash \Option{invisible}. Avec
+\Option{hyphenable}, elle indique ^^e0 \LaTeX\ un point de coupure de
+mot, ce qu'elle ne fait pas avec \Option{unhyphenable}. Avec
+\Option{visible}, elle place un glyphe dont \cs{EPSyllabeMarque}
+\DescribeMacro{EPSyllabeMarque} d^^e9termine
+l'aspect. Avec \Option{invisible}, elle ne produit rien.
+
+Par d^^e9faut, \cs{EPSyllabeMarque} est d^^e9finie comme un b^^eate point. On
+prendra garde au fait que, \cs{EPSyllabeMarque} intervenant comme
+argument de \cs{discretionary}, elle est soumise ^^e0 certaines
+restrictions comme, p.~ex. le fait de ne pas pouvoir contenir de
+math^^e9matiques.
+
+Quelles que soient les options en vigueur, on peut
+toujours\label{livreK} indiquer un point de coupure possible ^^e0 l'aide
+de |^^a3KX|, dans ce cas aucun glyphe n'est \DescribePoundMacro{KX}
+produit et le point est \emph{invisible}. Avec |^^a3KB| et |^^a3KH| on
+produit un \DescribePoundMacro{KB} \DescribePoundMacro{KH} accent
+tonique secondaire ou principal \emph{s^^e9cable}. Avec |^^a3Kb| ou |^^a3Kh|,
+les accents toniques sont \emph{ins^^e9cables}. Avec |^^a3Kk|, on place une
+marque de syllabisation toujours visible et toujours
+ins^^e9cable. \DescribePoundMacro{Kk} Enfin, |^^a3KK|
+\DescribePoundMacro{KK} produit toujours une marque de syllabisation
+visible et s^^e9cable. L'aspect des marques de syllabisation est, bien
+entendu, fix^^e9 par \cs{EPSyllabeMarque}. On aura remarqu^^e9 que les
+minuscules sont li^^e9es ^^e0 des objets \emph{ins^^e9cables} et les capitales
+^^e0 des objets \emph{s^^e9cables}\footnote{Si c'est pas du souci du d^^e9tail
+ et de la syst^^e9matique!}. Je n'ai pas ^^e9prouv^^e9 le besoin de fournir un
+|^^a3Kx| qui ne ferait strictement rien: une chaine de caract^^e8res vide me
+semble faire tout aussi bien l'affaire.
+
+\subsubsection{Sons optionnels}
+
+Pour indiquer les sons optionnels \DescribePoundMacro{X} on
+utilisera la macro |^^a3X|\meta{une lettre} qui \textbf{doit} ^^eatre suivie
+d'\emph{une lettre}. La macro ne fonctionne pas si elle est suivie
+d'un groupe\footnote{Peut-^^eatre pour la prochaine version, qui sait ?}.
+Cette macro fournit normalement ce qu'il faut pour les sons optionnels
+de l'anglais. Elle traite diff^^e9remment (avec l'option \Option{jones})
+la lettre \og e \fg qui donne \PRON{^^a3Xe} et les autres comme \og t \fg
+qui donne \PRON{^^a3Xt} avec |^^a3Xe| et |^^a3Xt| respectivement.
+
+Pour noter le \og r \fg final qui n'est prononc^^e9 qu'en cas de liaison,
+on \DescribePoundMacro{Z} utilisera |^^a3Z| qui est red^^e9finit lors du
+choix de l'option \Option{harraps} \TO voir~\ref{harrapsrfin}.
+
+\subsection{Autres macros et un environnement}
+ \label{sec:autresmacros}
+
+L'utilisateur a acc^^e8s \TO facilement\TF ^^e0 un certain nombres de
+commandes qui permettent de r^^e9gler des d^^e9tails de pr^^e9sentation. Il
+peut les red^^e9finir par \cs{renewcommand} et obtenir ainsi son propre
+style.
+
+Comme indiqu^^e9e ci-dessus, cf. \Option{monstress}, les macros
+\cs{EPaccentprincipal} et \cs{EPaccent}\BOP|secondaire| d^^e9finissent
+les glyphes obtenus par |^^a3H| et |^^a3B| respectivement.
+
+\NOUVEAU{Apparue avec la version~2}, la macro \cs{EPAccentCoupure}
+\DescribeMacro{EPAccentCoupure} d^^e9finit le comportement des marques
+d'accents toniques en cas de c^^e9sure. Par d^^e9faut, la marque d'accent
+tonique passe ^^e0 la ligne avec la syllabe qui porte l'accent, autrement
+dit, \Pron{^^a3Bh^^a3p^^a3kf^^a3Xen^^a3H^^a3q^^a3k^^a3s^^a3Xen} est coup^^e9, si n^^e9cessaire, en
+\Pron{^^a3Bh^^a3p^^a3kf^^a3Xen}\verb+|+\Pron{^^a3H^^a3q^^a3k^^a3s^^a3Xen}.
+
+\NOUVEAU{Depuis la version~2}, la macro \cs{EPSyllabeMarque} d^^e9finit
+la marque de limite de syllabe et \cs{EPSyllabeCoupure} d^^e9finit le
+comportement de la coupure sur une telle marque. Par d^^e9faut,
+\DescribeMacro{EPSyllabeCoupure} la c^^e9sure sur \Pron{^^a3Hh^^a3p^^a3kf^^a3Xen}
+donne \Pron{^^a3Hh^^a3p^^a3k}\verb+|+\Pron{f^^a3Xen}, autrement dit, la marque
+de syllabisation est conserv^^e9e avant le saut de ligne.
+
+Les macros \cs{EPouvrante}, \cs{EPfermante} et \cs{EPtextestyle}
+d^^e9finissent \DescribeMacro{EPouvrante} ce qui entoure la
+prononciation et, pour la troisi^^e8me, le style du
+\DescribeMacro{EPfermante} texte de cette prononciation. Par
+d^^e9faut, les deux premi^^e8re donnent \EPouvrante{}
+\DescribeMacro{EPtextestyle} et \EPfermante{} et \cs{EPtextestyle}
+est d^^e9finie comme |\rmfamily\upshape|.
+
+Pour ce qui suit je noterai que \og la livre est active
+\fg\index{livre!active} pour signifier que le
+caract^^e8re \GBP est actif et \textbf{n'est pas} d^^e9fini pour donner le
+glyphe de la livre sterling mais bien pour renvoyer la macro
+commen^^e7ant par \GBP. J'^^e9crirai que \og la livre est
+inactive\index{livre!inactive} \fg dans tous les
+autres cas.
+
+Ces trois macros sont utilis^^e9e par \cs{pron} et \cs{PRON} pour
+permettre \DescribeMacro{pron} l'obtention d'une pr^^e9sentation uniforme
+quelque soit le contexte et l'activit^^e9 de la livre. La macro
+\cs{pron}\marg{texte} permet d'obtenir une pr^^e9sentation de la
+prononciation comme on la trouve habituellement apr^^e8s un mot dans un
+texte au long. On l'utilise lorsque \og la livre est
+active\index{livre!active} \fg. On ^^e9crira alors
+|\pron{ma^^a3i}| pour obtenir \PRON{ma^^a3i}.
+
+Lorsque \og la livre est inactive\index{livre!inactive} \fg, on
+utilisera \DescribeMacro{PRON} \cs{PRON}\marg{texte} pour obtenir le
+m^^eame r^^e9sultat. En fait, comme dans ce document je charge le module
+\Pkg{engpron} avec l'option \Option{tame} j'ai obtenu, au paragraphe
+pr^^e9c^^e9dent, \PRON{ma^^a3i} avec |\PRON{ma^^a3i}|. Et l^^e0 je vous ai tout dit !
+
+Enfin, la livre ^^e9tant inactive\index{livre!inactive},
+\cs{Pron}\marg{texte} fournit le \DescribeMacro{Pron} moyen de taper
+de l'API sans la pr^^e9sentation donn^^e9e par \cs{pron}. En tapant
+|\Pron{^^a3Hf^^a3in^^a3k^^a3i^^a3kg^^a3en}| on obtiendra simplement
+\Pron{^^a3Hf^^a3in^^a3k^^a3i^^a3kg^^a3en} sans \og d^^e9coration \fg.
+
+La macro \cs{ActiveLaLivre} \DescribeMacro{ActiveLaLivre} rend la
+livre active\index{livre!active}, elle est utilis^^e9e par \cs{Pron},
+\cs{PRON} et l'environnement qui suit. On peut l'utiliser dans un
+tableau \TO avec le module \Pkg{array}\TF pour obtenir la livre active
+dans une colonne, par exemple.
+
+L'environnement \DescribeEnv{LivreActive} fait ce que son
+nom indique et active la livre. C'est tout ce qu'il fait. On pourra
+donc taper l'horrible \\[2pt]
+|\begin{LivreActive} \pron{^^a3Hstj^^a3U^^a3kp^^a3id} \end{LivreActive}|\\[2pt]
+au lieu de |\PRON{^^a3Hklev^^a3k^^a3E^^a3Z}|. On aura compris qu'il s'utilise pour
+de long texte, des tables\dots
+
+\vspace{\baselineskip}
+
+\NOUVEAU{Pour finir}, avec les macros antagonistes
+\DescribeMacro{MakeHyphenable} \cs{MakeHyphenable}\slash
+\cs{MakeUnHyphenable} on peut contrarier l'effet des options
+\Option{hyphenable}\slash\Option{unhyphenable}
+\DescribeMacro{MakeUnHyphenable}\index{coupure}.
+
+\cs{MakeHyphenable} red^^e9finit les macros li^^e9es ^^e0 |^^a3H|, |^^a3h|, |^^a3B|,
+|^^a3b| et |^^a3k|\index{accent tonique}\index{syllabisation} pour qu'elles
+fournissent des marques
+s^^e9cables\index{marque!s^^e9cable}\index{s^^e9cable}. \cs{MakeUnHyphenable} les
+red^^e9finit pour que les marques soient
+ins^^e9cables\index{marque!ins^^e9cable}\index{ins^^e9cable}. La
+visibilit^^e9\index{marque!visibilit^^e9}\index{visibilit^^e9} de |^^a3k| n'est
+pas modifi^^e9e.
+
+Autre couple de macros oppos^^e9es: \DescribeMacro{MakeVisible}
+\cs{MakeVisible}\slash\cs{MakeInVisible}. La macro
+\cs{Make}\BOP|Vi|\BOP|si|\BOP|ble| red^^e9finit la macro li^^e9e ^^e0
+|^^a3k|\index{syllabisation}\index{visibilit^^e9} pour qu'elle fournisse des
+marques visibles\index{marque!visible},
+\cs{MakeInVisible}\index{marque!visible} fait le
+\DescribeMacro{MakeInVisible} contraire. La
+s^^e9cabilit^^e9\index{s^^e9cabilit^^e9} de |^^a3k| n'est pas modifi^^e9e.
+
+\subsection{Conclusion}
+\label{sec:conclusion}
+
+On remarquera en regardant la table~\ref{latable} ou le code de
+l'extension qu'il reste de la place pour d^^e9finir d'autres macros
+utilisant la livre active.
+
+Tout d'abord quelques lettres ne sont pas employ^^e9es et, par exemple,
+|^^a3S| ne fait rien. Par ailleurs, on peut d^^e9finir d'autre macros avec
+plus d'une lettre derri^^e8re le \GBP mais on devra alors taper
+|^^a3{aeiou}| pour utiliser en fait la macro |\^^a3aeiou|. Je pense qu'il
+faudrait r^^e9server cela ^^e0 des macros ayant un effet substantiel
+\Sourire.
+
+En dernier lieu, j'avouerais que le codage
+choisi n'est pas forc^^e9ment optimal. En fait, je l'ai ^^e9labor^^e9 au fur
+^^e0 mesure des besoins et il n'y a pas de r^^e8gle g^^e9n^^e9rale
+d'organisation. Toutefois on pourra remarquer quelques efforts de
+syst^^e8me.
+
+L'utilisateur devrait se sentir libre d'effectuer les changements
+qu'il souhaite \TO mais dans ce cas, conform^^e9ment ^^e0 la licence sous
+laquelle est publi^^e9 ce module, on devra en changer le nom\TF ou,
+s'il le pr^^e9f^^e8re me demander de les mettre en \oe uvre. Je ne fais
+cependant aucune promesse quant ^^e0 la rapidit^^e9 ^^e0 laquelle
+j'interviendrais.
+
+\begin{thebibliography}{99}
+\addcontentsline{toc}{section}{Bibliographie}
+\bibitem{jones15} Daniel~\textsc{Jones} \dag.
+\emph{English Pronouncing Dictionary}.
+15th Edition. This major new edition edited by Peter Roach \& James
+Hartman.
+Cambridge University Press, \oldstylenums{1997}.\\
+\textsc{isbn} : \texttt{0-521-45903-6}
+\bibitem{jones} Daniel~\textsc{Jones} \dag.
+\emph{English Pronouncing Dictionary}.
+Cambridge University Press, \oldstylenums{1991}.
+\bibitem{tlachand} T.~\textsc{Lachand-Robert}.
+\emph{La ma^^eetrise de \TeX{} et \LaTeX{}}.
+Masson, Paris, Milan, Barcelone, \oldstylenums{1995}.\\
+\textsc{isbn} : \texttt{2-225-84832-7}.
+\bibitem{harraps} J. E. \textsc{Manson}, M.A.
+\emph{Harrap's New Shorter French And English Dictionary.}
+Revised edition \copyright{} George G. Harrap \&
+Co. Ltd. \oldstylenums{1967}.
+Bordas diffuseur, \oldstylenums{1980}.\\
+\textsc{isbn} : \texttt{0 245 59062 5}
+\end{thebibliography}
+
+\newpage
+
+\section{Table des macros \GBP}
+
+\thispagestyle{empty}{\LARGE
+\vspace*{\stretch{1}}
+\begin{LivreActive}
+\noindent
+\begin{tabular}[l]{|>{\ttfamily }c|>{\ActiveLaLivre }c||>{\ttfamily
+}c|c||>{\ttfamily }c|c||>{\ttfamily}c|c|}\hline
+\multicolumn{8}{|c|}{Voyelles}\\ \hline
+\^^a3a & ^^a3a & \^^a3A & ^^a3A & \^^a3e & ^^a3e & \^^a3E & ^^a3E \\ \hline
+\^^a3i & ^^a3i & \^^a3I & ^^a3I & \^^a3o & ^^a3o & \^^a3O & ^^a3O \\ \hline
+\^^a3u & ^^a3u & \^^a3U & ^^a3U & \^^a3v & ^^a3v & \^^a3x & ^^a3x \\ \hline
+\^^a3c & ^^a3c & \^^a3C & ^^a3C & \^^a3y & ^^a3y & & \\ \hline
+\multicolumn{8}{|c|}{Diphtongues}\\ \hline
+\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3P & ^^a3P\\ \hline
+\^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3w & ^^a3w & \^^a3W & ^^a3W\\ \hline
+\^^a3V & ^^a3V & & & & & & \\ \hline
+\multicolumn{8}{|c|}{Consonnes}\\ \hline
+\^^a3d & ^^a3d & \^^a3f & ^^a3f & \^^a3j & ^^a3j & \^^a3l & ^^a3l \\ \hline
+\^^a3n & ^^a3n & \^^a3s & ^^a3s & \^^a3t & ^^a3t & \^^a3z & ^^a3z \\ \hline
+\^^a3T & ^^a3T & \^^a3L & ^^a3L & & & & \\ \hline
+\multicolumn{8}{|c|}{Accents toniques}\\ \hline
+\^^a3b & ^^a3b & \^^a3B & ^^a3B & \^^a3h & ^^a3h & \^^a3H & ^^a3H \\ \hline
+\^^a3Kb & ^^a3Kb & \^^a3KB & ^^a3KB & \^^a3Kh & ^^a3Kh & \^^a3KH & ^^a3KH \\ \hline
+\multicolumn{8}{|c|}{Syllabisation}\\ \hline
+\^^a3k & ^^a3k & \^^a3Kk & ^^a3Kk & \^^a3KK & ^^a3KK & \^^a3KX & ^^a3KX \\ \hline
+\multicolumn{8}{|c|}{Voyelles nasalis^^e9es}\\
+\multicolumn{8}{|c|}{prononciation fran^^e7aise}\\ \hline
+\^^a3Ma & ^^a3Ma & \^^a3Mi & ^^a3Mi & \^^a3Mo & ^^a3Mo & \^^a3Mu & ^^a3Mu \\ \hline
+\multicolumn{8}{|c|}{prononciation anglaise}\\ \hline
+\^^a3ma & ^^a3ma & \^^a3mi & ^^a3mi & \^^a3mo & ^^a3mo & \^^a3mu & ^^a3mu \\ \hline
+\end{tabular}\label{latable}
+\end{LivreActive}
+\vspace*{\stretch{1}}
+}
+
+\printindex
+\end{document}
+\endinput
+%%
+%% End of file `engpron-fr.ltx'.