Current File : //usr/share/doc/brltty/French/BRLTTY-3.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<TITLE>Manuel de r�f�rence de BRLTTY: La proc�dure de compilation</TITLE>
<LINK HREF="BRLTTY-4.html" REL=next>
<LINK HREF="BRLTTY-2.html" REL=previous>
<LINK HREF="BRLTTY.html#toc3" REL=contents>
</HEAD>
<BODY>
<A HREF="BRLTTY-4.html">Page suivante</A>
<A HREF="BRLTTY-2.html">Page pr�c�dente</A>
<A HREF="BRLTTY.html#toc3">Table des mati�res</A>
<HR>
<H2><A NAME="s3">3.</A> <A HREF="BRLTTY.html#toc3">La proc�dure de compilation</A></H2>
<P>On peut t�l�charger BRLTTY depuis son site Web (voir la section
<A HREF="BRLTTY-1.html#contact">Contacts</A> pour son adresse). Toutes les versions
sont fournies en
<A HREF="#tar">archives tar</A> compress�s. Les
versions r�centes sont aussi fournies en fichiers
<A HREF="#rpm">RPM</A> (RedHat paquet Manager).</P>
<P>Ces information �parses ont probablement piqu� votre
curiosit� et vous �tes impatient de d�marrer.
Cependant, nous vous recommandons de vous familiariser d'abord
avec les fichiers qui seront finalement install�s.</P>
<H2><A NAME="hierachy"></A> <A NAME="ss3.1">3.1</A> <A HREF="BRLTTY.html#toc3.1">Hi�rarchie des fichiers install�s</A>
</H2>
<P>La proc�dure de compilation devrait aboutir � l'installation des
fichiers suivants:
<DL>
<DT><B>/bin/</B><DD>
<P>
<DL>
<DT><B>brltty</B><DD>
<P>Le programme BRLTTY.</P>
<DT><B>
<A HREF="#utility-brltty-install">brltty-install</A></B><DD>
<P>Un outil pour la copie de la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> de BRLTTY d'un emplacement �
un autre...</P>
<DT><B>
<A HREF="#utility-brltty-config">brltty-config</A></B><DD>
<P>Un outil qui assigne un certain nombre de variables
d'environnement � des valeurs refl�tant l'installation
courante de BRLTTY.</P>
</DL>
</P>
<DT><B>/lib/brltty/rw/</B><DD>
<P>Fichiers cr��s lors de l'ex�cution, comme ceux n�cessaires mais absents
du syst�me.</P>
<DT><B>/etc/</B><DD>
<P>
<DL>
<DT><B>brltty.conf</B><DD>
<P>Param�tres syst�me par d�faut pour BRLTTY.</P>
<DT><B>brlapi.key</B><DD>
<P>Cl�s d'acc�s pour BrlAPI.</P>
</DL>
</P>
<DT><B>/etc/brltty/</B><DD>
<P>Il se peut que votre installation de BRLTTY n'ait pas tous les
types de fichiers suivants. Ils ne sont cr��s qu'en fonction des
besoins d�duits des options de compilation que vous s�lectionnez
(voir
<A HREF="#build">Options de compilation</A>).
<DL>
<DT><B>*.conf</B><DD>
<P>Base de configuration sp�cifique au pilote. Leur nom ressemble
plus ou moins � <CODE>brltty-</CODE><EM>pilote</EM><CODE>.conf</CODE>, o�
<EM>pilote</EM> correspond aux deux lettres du
<A HREF="BRLTTY-10.html#drivers">code d'identification du pilote</A>.</P>
<DT><B>*.atb</B><DD>
<P>Tables d'attributs
(voir la section
<A HREF="BRLTTY-6.html#table-attributes">Tables d'attributs</A> pour plus de d�tails).
Leur nom ressemble � <EM>name</EM><CODE>.atb</CODE>.</P>
<DT><B>*.ati</B><DD>
<P>Fichiers include pour les tables d'attributs.</P>
<DT><B>*.ctb</B><DD>
<P>Tables de braille abr�g� (voir
<A HREF="BRLTTY-6.html#table-contraction">Tables de braille abr�g�</A> pour plus de d�tails). Leur nom ressemble plus ou
moins �
<EM>langue</EM><CODE>-</CODE><EM>pays</EM><CODE>-</CODE><EM>niveau</EM><CODE>.ctb</CODE>.</P>
<DT><B>*.cti</B><DD>
<P>Fichiers include pour les tables de traduction.</P>
<DT><B>*.ktb</B><DD>
<P>Tables de touches
(voir la section
<A HREF="BRLTTY-6.html#table-key">Tables de touches</A> pour plus de d�tails).
Leurs noms ressemble � <EM>name</EM><CODE>.ktb</CODE>.</P>
<DT><B>*.kti</B><DD>
<P>Fichiers Include pour les tables de touches.</P>
<DT><B>*.ttb</B><DD>
<P>Tables de texte
(voir la section
<A HREF="BRLTTY-6.html#table-text">Tables de texte</A> pour plus de d�tails).
Leurs noms ressemble � <EM>language</EM><CODE>.ttb</CODE>.</P>
<DT><B>*.tti</B><DD>
<P>Fichiers Include pour les tables de texte.</P>
<DT><B>*.hlp</B><DD>
<P>Pages d'aide sp�cifiques � chaque pilote. Leur nom ressemble
plus ou moins � <CODE>brltty-</CODE><EM>pilote</EM><CODE>.hlp</CODE>, o�
<EM>pilote</EM> correspond aux deux lettres du
<A HREF="BRLTTY-10.html#drivers">code d'identification du pilote</A>.</P>
</DL>
</P>
<DT><B>/var/lib/</B><DD>
<P>Sockets locaux pour la connexion � l'interface de programmation de
l'application.</P>
<DT><B>/include/</B><DD>
<P>Les fichiers d'en-t�te C pour l'interface de programmation de
l'application. Leurs noms ressemblent � <EM>brlapi-fonction</EM><CODE>.h</CODE>.
L'en-t�te principale est brlapi.h.</P>
<DT><B>/include/brltty/</B><DD>
<P>Les fichiers d'en-t�te C pour l'interface de programmation de
l'application. Leurs noms ressemblent � <EM>brldefs-pilote</EM><CODE>.h</CODE> o�
<EM>pilote</EM><CODE>-</CODE><EM>pilote</EM><CODE>.h</CODE> (o� <EM>pilote</EM> correspond
aux deux lettres du
<A HREF="BRLTTY-10.html#drivers">Code d'identification du pilote</A>). Les en-t�tes brldefs.h et api.h sont fournies pour une
compatibilit� avec des version pr�c�dentes et ne devraient pas �tre
utilis�es.</P>
<DT><B>/lib/</B><DD>
<P>
<DL>
<DT><B>libbrlapi.a</B><DD>
<P>biblioth�que statique de l'interface de programmation de
l'application (Application Programming Interface).</P>
<DT><B>libbrlapi.so</B><DD>
<P>biblioth�que dynamique pour l'interface de programmation de
l'application.</P>
</DL>
</P>
<DT><B>/lib/brltty/</B><DD>
<P>Il se peut que votre installation de BRLTTY n'ait pas tous les
types de fichiers suivants. Ils ne sont cr��s qu'en fonction des
besoins d�duits des options de compilation que vous s�lectionnez
(voir
<A HREF="#build">Options de compilation</A>).
<DL>
<DT><B>brltty-brl.lst</B><DD>
<P>Une liste des pilotes des afficheurs braille qui ont �t�
compil�s en tant qu'objets dynamiques et, ainsi, qui peuvent
�tre utilis�s. Chaque ligne contient les deux lettres
du code d'identification pour un pilote, une tabulation, et
une description de l'afficheur braille pour lequel ce pilote
existe.</P>
<DT><B>libbrlttyb<EM>pilote</EM>.so.1</B><DD>
<P>Le pilote dynamique pour un afficheur braille, o� <EM>pilote</EM>
correspond aux deux lettres du
<A HREF="BRLTTY-10.html#drivers">code d'identification du pilote</A>.</P>
<DT><B>brltty-spk.lst</B><DD>
<P>Une liste des pilotes de synth�se vocale qui ont �t�
compil�s en tant qu'objets dynamiques, et, ainsi, qui peuvent
�tre utilis�s. Chaque ligne contient les deux lettres
du code d'identification pour un pilote, une tabulation, et
une description de la synth�se vocale pour laquelle ce pilote
existe.</P>
<DT><B>libbrlttys<EM>pilote</EM>.so.1</B><DD>
<P>Le pilote dynamique pour une synth�se vocale, o� <EM>pilote</EM>
correspond aux deux lettres du
<A HREF="BRLTTY-10.html#drivers">Code d'identification du pilote</A>.</P>
</DL>
</P>
<DT><B>/man/</B><DD>
<P>Pages de manuel.
<DL>
<DT><B>man1/<EM>nom</EM>.1</B><DD>
<P>Pages de manuel pour les commandes utilisateur li�es �
BRLTTY.</P>
<DT><B>man3/<EM>nom</EM>.3</B><DD>
<P>Pages de manuel pour la biblioth�que de
l'interface de programmation de l'application.</P>
</DL>
</P>
</DL>
</P>
<P>D'autres fichiers optionnels que vous devriez conna�tre, bien qu'ils ne
fassent pas partie de la hi�rarchie des fichiers install�s, sont :
<DL>
<DT><B>/etc/brltty.conf</B><DD>
<P>Le fichier des param�tres syst�me par d�faut. Il est cr�� par
l'administrateur syst�me. Voir
<A HREF="BRLTTY-4.html#configure">Le fichier de configuration</A> pour plus de d�tails.</P>
<DT><B>/etc/brltty-<EM>pilote</EM>.prefs</B><DD>
<P>Le fichier de sauvegarde des param�tres de pr�f�rence (<EM>pilote</EM>
correspond aux deux lettres du
<A HREF="BRLTTY-10.html#drivers">code d'identification de pilote</A>). Il est cr�� par la commande
<A HREF="BRLTTY-4.html#command-PREFSAVE">PREFSAVE</A>. Voir
<A HREF="BRLTTY-5.html#preferences">Param�tres de Pr�f�rences</A> pour plus de
d�tails.</P>
</DL>
</P>
<H2><A NAME="tar"></A> <A NAME="ss3.2">3.2</A> <A HREF="BRLTTY.html#toc3.2">Installation � partir d'un TAR Ball</A>
</H2>
<P>Voici ce que vous avez � faire si vous voulez seulement installer
BRLTTY � toute vitesse, en esp�rant que tous
nos param�tres par d�faut soient corrects.
<OL>
<LI>T�l�chargez les sources. Il s'agira d'un fichier nomm�
<CODE>brltty-</CODE><EM>version</EM><CODE>.tar.gz</CODE>, par exemple
<CODE>brltty-3.0.tar.gz</CODE>.</LI>
<LI>D�compressez les sources dans une structure hi�rarchique native.
<BLOCKQUOTE><CODE>
tar xzf brltty-<EM>version</EM>.tar.gz
</CODE></BLOCKQUOTE>
Cela devrait cr�er le r�pertoire <CODE>brltty-</CODE><EM>version</EM>.</LI>
<LI>Allez dans le r�pertoire des sources, configurez, compilez et installez BRLTTY.
<BLOCKQUOTE><CODE>
cd brltty-<EM>version</EM><BR>
./configure<BR>
make<BR>
make install
</CODE></BLOCKQUOTE>
Vous devez effectuer cette derni�re commande en tant que <B>root</B>.</LI>
</OL>
</P>
<P>Pour d�sinstaller BRLTTY, faites :
<BLOCKQUOTE><CODE>
cd brltty-<EM>version</EM><BR>
make uninstall
</CODE></BLOCKQUOTE>
</P>
<P>C'est tout ce que vous avez � faire.
Pour ceux qui veulent vraiment savoir ce qui se passe, voici
maintenant les d�tails.</P>
<H3><A NAME="build"></A> Options de compilation</H3>
<P>La premi�re �tape dans la compilation de BRLTTY est de le configurer
en fonction de votre syst�me et/ou de vos besoins personnels. Cela se
fait par l'ex�cution du script de <CODE>configuration</CODE> dans le
r�pertoire racine de BRLTTY. Nous avons tent� de faire correspondre les param�tres
par d�faut suffisants � la plupart des cas communs, donc, en
supposant que vous ne tentez pas de faire quelque chose sortant de
l'ordinaire, il se peut que vous n'ayez rien besoin d'autre
que d'appeler ce script sans sp�cifier d'options.
<BLOCKQUOTE><CODE>
./configure
</CODE></BLOCKQUOTE>
Si toutefois vous avez des besoins particuliers, ou si vous
�tes simplement un aventurier, vous devriez trouver plus loin quels sont
vos choix.
<BLOCKQUOTE><CODE>
./configure --help
</CODE></BLOCKQUOTE>
Vous devriez aussi lire le fichier README dans le sous-r�pertoire
contenant le pilote pour votre afficheur braille pour toutes les
instructions suppl�mentaires sp�cifiques.</P>
<H3><A NAME="build-defaults"></A> Param�tres syst�me par d�faut</H3>
<P>
<DL>
<DT><B><CODE>--with-braille-driver=</CODE><EM>pilote</EM>
<A NAME="build-braille-driver"></A> </B><DD>
<P>Sp�cifie les pilotes des terminaux braille que vous voulez lier �
l'ex�cutable de BRLTTY. Les pilotes qui ne figureront pas dans la
liste de cette option seront compil�s en tant qu'objets dynamiques
et pourront toujours �tre s�lectionn�s au moment de l'ex�cution. Chaque
pilote doit �tre identifi� soit par les 2 lettres de son
<A HREF="BRLTTY-10.html#drivers">code d'identification de pilote</A> ou par son vrai nom (complet ou
abr�g�). Ces noms et/ou identifiants de pilotes doivent �tre s�par�s les uns des
autres par une simple virgule. Si un identifiant de pilote est
pr�c�d� du signe moins (<CODE>-</CODE>), ce pilote est alors exclu de la
compilation. Le premier pilote non-exclu devient le pilote par
d�faut. Il n'y a pas de pilote par d�faut si vous n'utilisez pas
cette option. Un des mots suivants peut �tre aussi utilis� comme
op�rateur pour l'option:</P>
<P>(<CODE>-</CODE>),
<DL>
<DT><B>all</B><DD>
<P>Lie tous les pilotes � l'ex�cutable. Ne les compile pas en
tant qu'objets dynamiques. Vous pouvez sp�cifier ce mot comme
�l�ment terminant une liste de pilotes. C'est une fa�on de
sp�cifier un pilote par d�faut quand tous les pilotes seront
compil�s.</P>
<DT><B>-all</B><DD>
<P>Ne compile que les pilotes qui ont �t� explicitement inclus
par cette option.</P>
<DT><B>no</B><DD>
<P>Ne compile aucun pilote. Cela revient � sp�cifier
<CODE>--without-braille-driver</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile tous les pilotes en tant qu'objets dynamiques. Ne les
lie pas � l'ex�cutable. Cela revient � sp�cifier
<CODE>--with-braille-driver</CODE>.</P>
</DL>
Voir la ligne
<A HREF="BRLTTY-4.html#configure-braille-driver">braille-driver</A> du fichier de configuration
et l'option
<A HREF="BRLTTY-4.html#options-braille-driver">-b</A> de la ligne de commande pour une s�lection � l'ex�cution.</P>
<DT><B><CODE>--with-braille-parameters=</CODE>[<EM>pilote</EM><CODE>:</CODE>]<EM>nom</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-braille-parameters"></A> </B><DD>
<P>Sp�cifie les param�tres par d�faut pour les pilotes des afficheurs
braille. Si un m�me param�tre est sp�cifi� plus d'une fois, sa
valeur la plus � droite est prise en compte. Si le nom d'un
param�tre est sp�cifique � un pilote, (voir la section
<A HREF="BRLTTY-10.html#drivers">Codes d'identification de pilotes</A>) cette
valeur ne s'applique qu'� ce pilote; sinon, il
s'applique � tous les pilotes. Pour une description des param�tres
accept�s par un pilote particulier, reportez-vous � la
documentation de ce pilote. Voir la ligne
<A HREF="BRLTTY-4.html#configure-braille-parameters">braille-parameters</A> du
fichier de configuration et l'option
<A HREF="BRLTTY-4.html#options-braille-parameters">-B</A> de la ligne de commande
pour la s�lection � l'ex�cution.</P>
<DT><B><CODE>--with-braille-device=</CODE><EM>pilote</EM><CODE>,</CODE>...
<A NAME="build-braille-device"></A> </B><DD>
<P>Sp�cifie le port par d�faut auquel l'afficheur braille est reli�
(voir la section
<A HREF="BRLTTY-12.html#operand-braille-device">Sp�cification du port braille</A>). Si vous ne sp�cifiez pas
cette option, usb: est suppos� si le support USB est disponible,
bluetooth: est suppos� si le support Bluetooth est disponible, et
usb:,bluetooth: est suppos� si les deux sont disponibles. Si ni le support
USB ni le support Bluetooth ne sont disponibles, un
chemin appropri� pour le p�riph�rique du port s�rie primaire correspondant au syst�me
d'exploitation est suppos�. Voir la ligne
<A HREF="BRLTTY-4.html#configure-braille-device">braille-device</A> du
fichier de configuration et l'option
<A HREF="BRLTTY-4.html#options-braille-device">-d</A> de la ligne de commande
pour la s�lection � l'ex�cution.</P>
<DT><B><CODE>--with-libbraille=</CODE><EM>r�pertoire</EM>
Sp�cifie l'endroit o� se trouve le paquet libbraille, et compile le pilote
pour l'afficheur braille libbraille (voir
<A HREF="#restrictions-flite">Restrictions dans la compilation</A>).
Un des mots suivants peut �tre aussi utilis� comme
op�rateur pour l'option:</B><DD>
<P>(<CODE>-</CODE>),
<DL>
<DT><B>no</B><DD>
<P>Ne compile pas le pilote. Cela revient � sp�cifier
<CODE>--without-libbraille</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile le pilote si le paquet est pr�sent dans <CODE>/usr</CODE>,
<CODE>/usr/local</CODE>, <CODE>/usr/local/Libbraille</CODE>,
<CODE>/usr/local/libbraille</CODE>, <CODE>/opt/Libbraille</CODE>, ou
<CODE>/opt/libbraille</CODE>. Cela revient � � sp�cifier <CODE>--with-libbraille</CODE>.</P>
</DL>
</P>
<DT><B><CODE>--with-text-table=</CODE><EM>fichier</EM>
<A NAME="build-text-table"></A> </B><DD>
<P>Sp�cifie la table de traduction de texte compil�e en dur (celle par d�faut) (voir la section
<A HREF="BRLTTY-6.html#table-text">Tables de texte</A> pour plus de
d�tails). La table sp�cifi�e est li�e au binaire BRLTTY et elle est utilis�e
au cas o� la s�lection automatique � partir de la locale �choue ou si la table
demand�e ne peut pas �tre charg�e.
Vous pouvez fournir le chemin absolu d'une table hors de
l'arborescence source. L'extension <CODE>.ttb</CODE> est facultative. Pour un
nom de fichier simple, le pr�fixe <CODE>text.</CODE> est facultatif. Si
vous ne sp�cifiez pas cette option, <CODE>en-nabcc</CODE>, une table commune (en
Am�rique du Nord) utilisant la variante 8 points du
<A HREF="BRLTTY-15.html#nabcc">North American Braille Computer Code</A>, est
utilis�e. Voir la ligne
<A HREF="BRLTTY-4.html#configure-text-table">text-table</A> du fichier de configuration et l'option
<A HREF="BRLTTY-4.html#options-text-table">-t</A> en ligne de commande pour la
s�lection � l'ex�cution. Ce param�tre peut �tre modifi� par la
pr�f�rence
<A HREF="BRLTTY-5.html#preference-text-table">Text Table</A>.</P>
<DT><B><CODE>--with-attributes-table=</CODE><EM>fichier</EM>
<A NAME="build-attributes-table"></A> </B><DD>
<P>Sp�cifie la table des attributs compil�e en dur (celle par d�faut) (voir la section
<A HREF="BRLTTY-6.html#table-attributes">Tables d'attributs</A>
pour plus de d�tails). La table sp�cifi�e est li�e au binaire BRLTTY et elle est utilis�e
au cas o� la s�lection automatique � partir de la locale �choue ou si la table
demand�e ne peut pas �tre charg�e.
Vous pouvez fournir le chemin absolu d'une
table hors de l'arborescence source. L'extension <CODE>.atb</CODE> est
facultative. Si vous ne sp�cifiez pas cette option,
<CODE>attributes</CODE> est alors utilis�. Changez cette option en
<CODE>attrib</CODE> pour maintenir l'ancienne forme. Voir la ligne
<A HREF="BRLTTY-4.html#configure-attributes-table">attributes-table</A> du
fichier de configuration et l'option
<A HREF="BRLTTY-4.html#options-attributes-table">-a</A> en ligne de commande pour
la s�lection � l'ex�cution. Ce param�tre peut �tre modifi� par la
pr�f�rence
<A HREF="BRLTTY-5.html#preference-attributes-table">Attributes Table</A>.</P>
<DT><B><CODE>--with-speech-driver=</CODE><EM>pilote</EM>
<A NAME="build-speech-driver"></A> </B><DD>
<P>Sp�cifie les pilotes de synth�se vocale que vous voulez lier �
l'ex�cutable de BRLTTY. Les pilotes qui ne figureront pas dans la
liste de cette option seront compil�s en tant qu'objets dynamiques
et pourront toujours �tre s�lectionn�s � l'ex�cution. Chaque
pilote doit �tre identifi� soit par les 2 lettres de son
<A HREF="BRLTTY-10.html#drivers">code d'identification de pilote</A> ou par son
vrai nom (complet ou abr�g�). Ces noms et/ou les identifiants de pilotes doivent �tre
s�par�s les uns des autres par une simple virgule. Si un
identifiant de pilote est pr�c�d� du signe moins (<CODE>-</CODE>), ce
pilote est alors exclu de la compilation. Un des mots
suivants peut aussi �tre utilis� comme op�rateur pour l'option:
<DL>
<DT><B>all</B><DD>
<P>Lie tous les pilotes � l'ex�cutable. Ne les compile pas en
tant qu'objets dynamiques. Vous pouvez sp�cifier ce mot comme
�l�ment terminant une liste de pilotes. C'est une fa�on de
sp�cifier un pilote par d�faut quand tous les pilotes seront
compil�s.</P>
<DT><B>-all</B><DD>
<P>Ne compile que les pilotes qui ont �t� explicitement inclus
par cette option.</P>
<DT><B>no</B><DD>
<P>Ne compile aucun pilote. Cela revient � sp�cifier
<CODE>--without-speech-driver</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile tous les pilotes en tant qu'objets dynamiques. Ne les
lie pas � l'ex�cutable. Cela revient � sp�cifier
<CODE>--with-speech-driver</CODE>.</P>
</DL>
Voir la ligne
<A HREF="BRLTTY-4.html#configure-speech-driver">speech-driver</A> du fichier de configuration et
l'option
<A HREF="BRLTTY-4.html#options-speech-driver">-s</A> de la ligne de commande pour une s�lection � l'ex�cution.</P>
<DT><B><CODE>--with-speech-parameters=</CODE>[<EM>pilote</EM><CODE>:</CODE>]<EM>nom</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-speech-parameters"></A> </B><DD>
<P>Sp�cifie les param�tres par d�faut pour les pilotes de synth�se
vocale. Si un m�me param�tre est sp�cifi� plus d'une fois, sa
valeur la plus � droite est prise en compte. Si le nom d'un
param�tre est sp�cifique � un pilote, (voir la section
<A HREF="BRLTTY-10.html#drivers">Codes d'identification de pilotes</A>) cette valeur ne s'applique
qu'� ce pilote; sinon, il s'applique � tous les
pilotes. Pour une description des param�tres accept�s par un
pilote sp�cifique, reportez-vous � la documentation de ce
pilote. Voir la ligne
<A HREF="BRLTTY-4.html#configure-speech-parameters">speech-parameters</A> du fichier de
configuration et l'option
<A HREF="BRLTTY-4.html#options-speech-parameters">-S</A> de la ligne de commande pour la
s�lection � l'ex�cution.</P>
<DT><B><CODE>--with-flite=</CODE><EM>directory</EM>
<A NAME="build-flite"></A> </B><DD>
<P>Sp�cifie l'emplacement d'installation de FestivalLite
et compile le pilote pour cette synth�se vocale
(voir
<A HREF="#restrictions-flite">Restrictions dans la compilation</A> L'un des
mots suivants peut aussi �tre utilis� comme op�rateur de cette
option:
<DL>
<DT><B>no</B><DD>
<P>Ne compile pas le pilote.
Cela revient � sp�cifier <CODE>--without-flite</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile le pilote si le paquet existe dans <CODE>/usr</CODE>,
<CODE>/usr/local</CODE>, <CODE>/usr/local/FestivalLite</CODE>,
<CODE>/usr/local/flite</CODE>, <CODE>/opt/FestivalLite</CODE> ou
<CODE>/opt/flite</CODE>. Cela revient �
sp�cifier<CODE>--with-flite</CODE>.</P>
</DL>
</P>
<DT><B><CODE>--with-flite-language=</CODE><EM>language</EM>
<A NAME="build-flite-language"></A> </B><DD>
<P>Sp�cifie la langue qu'utilisera le moteur de FestivalLite.
La langue utilis�e par d�faut est <CODE>l'anglais</CODE>.</P>
<DT><B><CODE>--with-flite-lexicon=</CODE><EM>lexicon</EM>
<A NAME="build-flite-lexicon"></A> </B><DD>
<P>Sp�cifie le dictionnaire que le moteur de FestivalLite
utilisera. Le dictionnaire par d�faut est <CODE>cmulex</CODE>.</P>
<DT><B><CODE>--with-flite-voice=</CODE><EM>voice</EM>
<A NAME="build-flite-voice"></A> </B><DD>
<P>Sp�cifie la personne que le moteur de FestivalLite doit utiliser.
La voix par d�faut est <CODE>cmu_us_kal16</CODE>.</P>
<DT><B><CODE>--with-mikropuhe=</CODE><EM>directory</EM>
<A NAME="build-mikropuhe"></A> </B><DD>
<P>Sp�cifie l'emplacement d'installation du paquet
Mickropuhe et compile le pilote pour la synth�se
vocale Mikropuhe (voir
<A HREF="#restrictions-mikropuhe">Restrictions dans la compilation</A>). L'un
des mots suivants peut aussi �tre utilis� comme op�rateur de cette
option:
<DL>
<DT><B>no</B><DD>
<P>Ne compile pas le pilote.
Cela revient � sp�cifier <CODE>--without-mikropuhe</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile le pilote si le paquet existe dans <CODE>/usr</CODE>,
<CODE>/usr/local</CODE>, <CODE>/usr/local</CODE>, <CODE>/usr/local/Mikropuhe</CODE>,
<CODE>/usr/local/mikropuhe</CODE>, <CODE>/opt/Mikropuhe</CODE>
ou <CODE>/opt/mikropuhe</CODE>. Cela revient � sp�cifier
<CODE>--with-mikropuhe</CODE>.</P>
</DL>
</P>
<DT><B><CODE>--with-speechd=</CODE><EM>repertoire</EM>
<A NAME="build-theta"></A> </B><DD>
<P>Sp�cifie l'endroit o� est install� le paquet de la synth�se vocale speech-dispatcher
(multiplexeur de synth�se vocale) et compile le pilote pour speech-dispatcher.
L'un des mots suivants peut aussi �tre utilis� comme op�rateur de cette
option:
<DL>
<DT><B>no</B><DD>
<P>Ne compile pas le pilote.
Cela revient � sp�cifier <CODE>--without-speechd</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile le pilote si le paquet existe dans <CODE>/usr</CODE>, <CODE>/usr/local</CODE>,
<CODE>/usr/local/speech-dispatcher</CODE>, <CODE>/usr/local/speechd</CODE>,
<CODE>/opt/speech-dispatcher</CODE>, ou <CODE>/opt/speechd</CODE>. Cela revient
� sp�cifier <CODE>--with-speechd</CODE>.</P>
</DL>
</P>
<DT><B><CODE>--with-swift=</CODE><EM>repertoire</EM>
<A NAME="build-theta"></A> </B><DD>
<P>Sp�cifie l'endroit o� est install� le paquet de la synth�se vocale, et
compile le pilote pour la synth�se vocale Swift.
L'un des mots suivants peut aussi �tre utilis� comme op�rateur de cette
option:
<DL>
<DT><B>no</B><DD>
<P>Ne compile pas le pilote.
Cela revient � sp�cifier <CODE>--without-swift</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile le pilote si le paquet existe dans <CODE>/usr</CODE>, <CODE>/usr/local</CODE>,
<CODE>/usr/local/Swift</CODE>, <CODE>/usr/local/swift</CODE>,
<CODE>/opt/Swift</CODE>, ou <CODE>/opt/swift</CODE>. Cela revient
� sp�cifier <CODE>--with-swift</CODE>.</P>
</DL>
</P>
<DT><B><CODE>--with-theta=</CODE><EM>repertoire</EM>
<A NAME="build-theta"></A> </B><DD>
<P>Sp�cifie l'emplacement d'installation du paquet Theta
et compile le pilote pour la synth�se vocale Theta
(voir
<A HREF="#restrictions-theta">Restrictions dans la compilation</A>). L'un des mots
suivants peut aussi �tre utilis� comme op�rateur de cette option:
<DL>
<DT><B>no</B><DD>
<P>Ne compile pas le pilote.
Cela revient � sp�cifier <CODE>--without-theta</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile le pilote si le paquet existe dans <CODE>/usr</CODE>, <CODE>/usr/local</CODE>,
<CODE>/usr/local/Theta</CODE>, <CODE>/usr/local/theta</CODE>,
<CODE>/opt/Theta</CODE>, ou <CODE>/opt/theta</CODE>.
Cela revient � sp�cifier <CODE>--with-theta</CODE>.</P>
</DL>
</P>
<DT><B><CODE>--with-screen-driver=</CODE><EM>pilote</EM>
<A NAME="build-screen-driver"></A> </B><DD>
<P>Sp�cifie les pilotes pour l'�cran qui seront li�s � l'ex�cutable BRLTTY.
Ceux qui ne sont pas mentionn�s dans cette option sont compil�s en tant
qu'objets dynamiques et peuvent �tre choisis lors de
l'ex�cution. Chaque pilote doit �tre identifi� soit par les deux lettres de
son code d'identification (voir la section Ecrans support�s) soit par
son nom (complet ou abr�g�). Vous devez s�parer les identifiants des
pilotes les uns des autres par une virgule. Si l'identifiant d'un pilote
est pr�c�d� du signe moins (<CODE>-</CODE>), il est exclu de la compilation.
Un des mots suivants peut �tre aussi utilis� comme
op�rateur pour l'option:</P>
<P>(<CODE>-</CODE>),
<DL>
<DT><B>all</B><DD>
<P>Lie tous les pilotes � l'ex�cutable. Ne les compile pas en
tant qu'objets dynamiques. Vous pouvez sp�cifier ce mot comme
�l�ment terminant une liste de pilotes. C'est la fa�on de
sp�cifier un pilote par d�faut quand tous les pilotes seront
compil�s.</P>
<DT><B>-all</B><DD>
<P>Ne compile que les pilotes qui ont �t� explicitement inclus
par cette option.</P>
<DT><B>no</B><DD>
<P>Ne compile aucun pilote. Cela revient � sp�cifier
<CODE>--without-screen-driver</CODE>.</P>
<DT><B>yes</B><DD>
<P>Compile tous les pilotes en tant qu'objets dynamiques. Ne les
lie pas � l'ex�cutable. Cela revient � sp�cifier
<CODE>--with-braille-driver</CODE>.</P>
</DL>
</P>
<P>Le premier pilote non exclu devient celui par d�faut.
Si cette option n'est pas sp�cifi�e, une s�lection adapt�e au
syst�me d'exploitation est faite. Si un pilote sp�cifique au
syst�me d'exploitation en cours est fiable, il est utilis�. Sinon,
<CODE>sc</CODE> est utilis�.</P>
<P>Voir la ligne
<A HREF="BRLTTY-4.html#configure-screen-driver">screen-driver</A> du fichier de configuration
et l'option
<A HREF="BRLTTY-4.html#options-screen-driver">-x</A> de la ligne de commande pour une s�lection � l'ex�cution.</P>
<DT><B><CODE>--with-screen-parameters=</CODE><EM>name</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-screen-parameters"></A> </B><DD>
<P>Sp�cifie les param�tres par d�faut pour le pilote d'�cran. Si le
m�me param�tre est sp�cifi� plus d'une fois, c'est sa valeur la
plus � droite qui est retenue. Si le nom d'un param�tre est affect� � un
pilote (voir section Pilotes d'�cran support�s) alors ce param�tre ne
s'applique qu'au pilote; sinon il s'applique � tous les pilotes.
Pour une description des param�tres
accept�s par un pilote sp�cifique, reportez-vous � la
documentation de celui-ci. Voir la ligne
<A HREF="BRLTTY-4.html#configure-screen-parameters">screen-parameters</A> du
fichier de configuration et l'option
<A HREF="BRLTTY-4.html#options-screen-parameters">-X</A> en ligne de commande
pour la s�lection � l'ex�cution.</P>
<DT><B><CODE>--with-usb-paquet=</CODE><EM>paquet</EM><CODE>,</CODE>...
<A NAME="build-usb-paquet"></A> </B><DD>
<P>Sp�cifie le paquet qui sera utilis� pour l'E/S USB.
Vous devez sp�arer les noms de paquets les uns des
autres par une virgule, ils sont trait�s de la gauche vers la droite.
Le premier install� sur le syst�me est s�lectionn�.
Les paquets suivants sont support�s:
<OL>
<LI>libusb</LI>
<LI>libusb-1.0</LI>
</OL>
Un des mots suivants peut �tre aussi utilis� comme op�rande pour cette
option:
<DL>
<DT><B>no</B><DD>
<P>Ne supporte pas l'E/S USB.
Cela revient � sp�cifier <CODE>--without-usb-paquet</CODE>.</P>
<DT><B>yes</B><DD>
<P>Utiliser le support natif pour l'E/S USB.
Si un support natif n'est pas disponible pour la
plateforme actuelle, utiliser alors le premier paquet support�
disponible (comme pour l'ordre sp�cifi� ci-dessus).
Cela revient � sp�cifier <CODE>--with-usb-paquet</CODE>.</P>
</DL>
</P>
<DT><B><CODE>--with-bluetooth-paquet=</CODE><EM>paquet</EM><CODE>,</CODE>...
<A NAME="build-bluetooth-paquet"></A> </B><DD>
<P>Sp�cifie le paquet qui sera utilis� pour l'E/S Bluetooth.
Vous devez sp�arer les noms de paquets les uns des
autres par une virgule, ils sont trait�s de la gauche vers la droite.
Le premier install� sur le syst�me est s�lectionn�.
Les paquets suivants sont support�s:
<OL>
<LI>(aucun paquet n'est actuellement support�)</LI>
</OL>
Un des mots suivants peut �tre aussi utilis� comme op�rande pour cette
option:
<DL>
<DT><B>no</B><DD>
<P>Ne supporte pas l'E/S Bluetooth.
Cela revient � sp�cifier <CODE>--without-bluetooth-paquet</CODE>.</P>
<DT><B>yes</B><DD>
<P>Utiliser le support natif pour l'E/S Bluetooth.
Si un support natif n'est pas disponible pour la
plateforme actuelle, utiliser alors le premier paquet support�
disponible (comme pour l'ordre sp�cifi� ci-dessus).
Cela revient � sp�cifier <CODE>--with-bluetooth-paquet</CODE>.</P>
</DL>
</P>
</DL>
</P>
<H3><A NAME="hierarchy"></A> Sp�cification du r�pertoire</H3>
<P>
<DL>
<DT><B><CODE>--with-execute-root=</CODE><EM>repertoire</EM>
<A NAME="build-execute-root"></A> </B><DD>
<P>Sp�cifie le r�pertoire dans lequel la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> aura sa racine lors de
l'ex�cution. Vous devriez fournir un chemin absolu. Si cette
option n'est pas sp�cifi�e, le r�pertoire racine du syst�me est
utilis�. Utilisez cette option si vous avez besoin d'installer les
ex�cutables de BRLTTY dans un emplacement non standard. Par
exemple, vous devez utiliser cette option si vous voulez avoir
plusieurs versions de BRLTTY install�es en m�me temps (voir la
section
<A HREF="BRLTTY-7.html#multiple">Installiation de plusieurs versions</A> pour un exemple de cette op�ration).</P>
<DT><B><CODE>--with-install-root=</CODE><EM>repertoire</EM>
<A NAME="build-install-root"></A> </B><DD>
<P>Sp�cifie le r�pertoire o� la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> sera install�e. Vous devriez
fournir un chemin absolu. Si cette option n'est pas sp�cifi�e, la racine
d'ex�cution du paquet (voir l'option de compilation
<A HREF="#build-execute-root">--with-execute-root</A>) est
utilis�e. Ce r�pertoire n'est utilis� que par
<A HREF="#make-install">make-install</A> et
<A HREF="#make-uninstall">make-uninstall</A>.
Utilisez cette option si vous avez besoin d'installer
BRLTTY dans un r�pertoire diff�rent de celui o� il sera ex�cut� en
d�finitive. Par exemple, vous avez besoin d'utiliser cette
caract�ristique si vous compilez BRLTTY sur un syst�me pour
l'utiliser sur un autre.</P>
<DT><B><CODE>--prefix=</CODE><EM>repertoire</EM>
<A NAME="build-portable-root"></A> </B><DD>
<P>Indique le r�pertoire dans lequel la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> constitue le r�pertoire par d�faut, ind�pendant de
l'architecture, et qui sera utilis� comme r�pertoire
racine. Ces sous-r�pertoires comprennent les dossiers:
<UL>
<LI>le
<A HREF="#build-data-directory">r�pertoire writable</A></LI>
<LI>le
<A HREF="#build-data-directory">r�pertoire data</A></LI>
<LI>le
<A HREF="#build-configuration-directory">r�pertoire configuration</A></LI>
<LI>le
<A HREF="#build-manpage-directory">r�pertoire manpage</A></LI>
<LI>le
<A HREF="#build-include-directory">r�pertoire include</A></LI>
</UL>
Vous devriez fournir un chemin absolu. Si vous ne sp�cifiez pas
cette option, c'est le r�pertoire racine du syst�me qui est
utilis�. Ce r�pertoire est li� � celui pr�cis� par l'option de
compilation
<A HREF="#build-execute-root">--with-execute-root</A>.</P>
<DT><B><CODE>--with-writable-directory=</CODE><EM>r�pertoire</EM>
<A NAME="build-architecture-root"></A> </B><DD>
<P>Sp�cifie le r�pertoire dans lequel la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A>
pourra �tre �crite. Vous devriez fournir un chemin absolu. Un des mots
suivants peut �tre utilis� comme op�rateur pour cette option.</P>
<P>(<CODE>-</CODE>),
<DL>
<DT><B>no</B><DD>
<P>Ne d�finit pas de r�pertoire inscriptible (writable). Cela revient �
sp�cifier
<CODE>--without-writable-directory</CODE>.</P>
<DT><B>yes</B><DD>
<P>Utilise l'endroit par d�faut. Cela revient � sp�cifier
<CODE>--with-writable-directory</CODE>.</P>
</DL>
Si vous ne sp�cifiez pas cette option, le sous-r�pertoire autoris� en rw
(lecture/�criture) dans le dossier sp�cifi� par l'option --with-library-directory
est suppos�. Le r�pertoire est cr�� s'il n'existe pas.</P>
<DT><B><CODE>--exec-prefix=</CODE><EM>r�pertoire</EM>
<A NAME="build-architecture-root"></A> </B><DD>
<P>Sp�cifie le r�pertoire de la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A>
o� les r�pertoires par d�faut pour les
fichiers d�pendant de l'architecture doivent �tre plac�s.
Ces r�pertoires incluent:
<UL>
<LI>le
<A HREF="#build-program-directory">r�pertoire programme</A></LI>
<LI>le
<A HREF="#build-library-directory">r�pertoire des biblioth�ques compil�es</A></LI>
<LI>le
<A HREF="#build-api-directory">r�pertoire d'API compil�</A></LI>
</UL>
Vous devriez fournir un chemin absolu. Si vous ne sp�cifiez pas
cette option, c'est le r�pertoire sp�cifi� par l'option de
compilation
<A HREF="#build-portable-root">--prefix</A> qui est utilis�.
Ce r�pertoire est li� � celui
sp�cifi� par l'option de compilation
<A HREF="#build-execute-root">--with-execute-root</A>.</P>
<DT><B><CODE>--libdir=</CODE><EM>repertoire</EM>
<A NAME="build-api-directory"></A> </B><DD>
<P>Sp�cifie le r�pertoire situ� dans la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A>
o� les modules statiques et les objets chargeables
dynamiquement pour l'Interface Programmatique de l'Application sont � copier. Le chemin absolu doit �tre
indiqu�. Si cette option est absente le r�pertoire indiqu� dans
l'option <CODE>--libdir</CODE> (qui, par d�faut, est le r�pertoire racine <CODE>/lib</CODE>
du r�pertoire sp�cifi� par l'option de construction
<A HREF="#build-architecture-root">--exec-prefix</A>) est utilis�. Le r�pertoire est cr�� s'il n'existe
pas.</P>
<DT><B><CODE>--sysconfdir=</CODE><EM>directory</EM>
<A NAME="build-configuration-directory"></A> </B><DD>
<P>Sp�cifie le r�pertoire situ� dans la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A>
o� les fichiers de configuration sont � installer. Vous devez
fournir un chemin absolu. Si vous ne sp�cifiez pas cette option,
c'est le r�pertoire sp�cifi� par l'option de configuration standard <CODE>--sysconfdir</CODE>
(qui, par d�faut, est le r�pertoire racine de <CODE>/etc</CODE> sp�cifi�
par l'option de compilation
<A HREF="#build-portable-root">--prefix</A>) qui est utilis�.
Le r�pertoire est cr�� s'il n'existe pas.</P>
<DT><B><CODE>--with-program-directory=</CODE><EM>directory</EM>
<A NAME="build-program-directory"></A> </B><DD>
<P>Sp�cifie le r�pertoire situ� dans la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> o� les ex�cutables
(binaires, ex�cutables), doivent �tre install�s. Vous devez
fournir un chemin absolu. Si cette option n'est pas utilis�e,
c'est le r�pertoire sp�cifi� par l'option de configuration
standard <CODE>--bindir</CODE> (qui, par d�faut, est le r�pertoire-racine
sp�cifi� par l'option de compilation
<A HREF="#build-architecture-root">--exec-prefix</A>) qui est utilis�.
Le r�pertoire est cr�� s'il n'existe pas.</P>
<DT><B><CODE>--with-library-directory=</CODE><EM>directory</EM>
<A NAME="build-library-directory"></A> </B><DD>
<P>Sp�cifie le r�pertoire situ� dans la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> o� les pilotes et
d'autres fichiers ind�pendants de l'architecture doivent �tre install�s. Vous devez
fournir un chemin absolu. Si cette option n'est pas sp�cifi�e,
c'est le sous-r�pertoire du r�pertoire <CODE>brltty</CODE>
sp�cifi� par l'option de configuration standard <CODE>--libdir</CODE>
(qui par d�faut est le r�pertoire racine sp�cifi� par l'option de
compilation
<A HREF="#build-architecture-root">--exec-prefix</A>) qui est utilis�.
Le r�pertoire est cr�� s'il n'existe pas.</P>
<DT><B><CODE>--with-data-directory=</CODE><EM>directory</EM>
<A NAME="build-data-directory"></A> </B><DD>
<P>Sp�cifie le r�pertoire situ� dans la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> o� les tables, les pages
d'aide et d'autres fichiers ind�pendants de l'architecture doivent �tre
install�s. Vous devez fournir un chemin absolu. Si cette option
n'est pas sp�cifi�e, c'est le sous-r�pertoire du
r�pertoire <CODE>brltty</CODE> sp�cifi� par l'option de configuration
standard <CODE>--sysconfdir</CODE> (qui par d�faut est le r�pertoire
racine <CODE>/etc</CODE> sp�cifi� par
l'option de compilation
<A HREF="#build-portable-root">--prefix</A>) qui est utilis�. Le r�pertoire est cr��
s'il n'existe pas.</P>
<DT><B><CODE>--with-manpage-directory=</CODE><EM>directory</EM>
<A NAME="build-manpage-directory"></A> </B><DD>
<P>Sp�cifie le r�pertoire situ� dans la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> o� les tables et les
pages de manuel doivent �tre install�es. Vous devez fournir un
chemin absolu. Si cette option n'est pas sp�cifi�e, c'est le
sous-r�pertoire du r�pertoire <CODE>brltty</CODE> sp�cifi�
par l'option de configuration standard <CODE>--mandir</CODE> (qui par
d�faut est le r�pertoire racine <CODE>/man</CODE> sp�cifi� par l'option
de compilation
<A HREF="#build-portable-root">--prefix</A>) qui
est utilis�. Le r�pertoire est cr�� s'il n'existe pas.</P>
<DT><B><CODE>--with-include-directory=</CODE><EM>directory</EM>
<A NAME="build-include-directory"></A> </B><DD>
<P>Sp�cifie le r�pertoire situ� dans la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> o� les fichiers d'en-t�te
C pour l'Interface Programmatique de l'Application doivent �tre
install�s. Vous devez fournir un chemin absolu. Si cette option
n'est pas sp�cifi�e, c'est le sous-r�pertoire du r�pertoire <CODE>brltty</CODE> sp�cifi� par
l'option de configuration standard <CODE>--includedir</CODE> (qui par
d�faut est le r�pertoire racine <CODE>/include</CODE> sp�cifi� par l'option
de compilation
<A HREF="#build-portable-root">--prefix</A> qui
est utilis�. Le r�pertoire est cr�� s'il n'existe pas.</P>
</DL>
</P>
<H3><A NAME="build-features"></A> Caract�ristiques de la compilation</H3>
<P>Ces options sont surtout utiles quand vous compilez BRLTTY pour une
disquette de d�marrage. Elles visent � r�duire la taille des programmes en supprimant
les fonctions inutiles.
<DL>
<DT><B><CODE>--enable-standalone-programs</CODE>
<A NAME="build-standalone-programs"></A> </B><DD>
<P>Cr�e des programmes li�s de fa�on statique plut�t que de fa�on
dynamique. Cette option supprime toutes les d�pendances sur les
objets partag�s � l'ex�cution. Seuls les pilotes par d�faut (voir
les options de compilation
<A HREF="#build-braille-driver">--with-braille-driver</A>,
<A HREF="#build-speech-driver">--with-speech-driver</A> et
<A HREF="#build-screen-driver">--with-screen-driver</A>) sont compil�s.</P>
<DT><B><CODE>--disable-stripping</CODE>
<A NAME="build-stripping"></A> </B><DD>
<P>Ne supprime pas les symboles des tables des ex�cutables et des objets
partag�s lors de leur installation.</P>
<DT><B><CODE>--enable-relocatable-install</CODE>
<A NAME="build-table-selection"></A> </B><DD>
<P>Si cette fonctionnalit� est activ�e, tous les chemins internes sont
recalcul�s afin d'englober le r�pertoire du programme. Si elle n'est pas
utilis�e, tous les chemins internes sont absolus. Cette fonctionnalit�
vise � ce que toute la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> soit
copi�e ou d�plac�e proprement d'un endroit � l'autre, tout particuli�rement
pour un usage sur des plateformes Windows.</P>
<DT><B><CODE>--disable-strippingl</CODE>
<A NAME="build-strippingl"></A> </B><DD>
<P>Ne supprime pas les tables de symboles des ex�cutables et des objets
partag�s lors de leur installation.</P>
<DT><B><CODE>--disable-learn-mode</CODE>
<A NAME="build-learn-mode"></A> </B><DD>
<P>R�duit la taille du programme en excluant le mode apprentissage
des commandes (voir la section
<A HREF="BRLTTY-5.html#learn">Mode apprentissage des commandes</A>).</P>
<DT><B><CODE>--disable-contracted-braille</CODE>
<A NAME="build-contracted-braille"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support pour le
braille abr�g� (voir la section
<A HREF="BRLTTY-6.html#table-contraction">Braille abr�g�</A>).</P>
<DT><B><CODE>--disable-speech-support</CODE>
<A NAME="build-speech-support"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support des synth�ses vocales.</P>
<DT><B><CODE>--disable-iconv</CODE>
<A NAME="build-table-selection"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support pour la conversion
des codages.</P>
<DT><B><CODE>--disable-icu</CODE>
<A NAME="build-icu"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support pour
l'internationalisation bas�e sur l'Unicode.</P>
<DT><B><CODE>--disable-x</CODE>
<A NAME="build-x"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support pour X11.</P>
<DT><B><CODE>--disable-beeper-support</CODE>
<A NAME="build-beeper-support"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support pour le
g�n�rateur des "none" en console.</P>
<DT><B><CODE>--disable-pcm-support</CODE>
<A NAME="build-pcm-support"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support pour
l'interface Digital Audio sur la carte son.</P>
<DT><B><CODE>--enable-pcm-support=</CODE><EM>interface</EM></B><DD>
<P>Si une plateforme propose plus d'une interface Digital Audio,
celle qui sera utilis�e peut �tre sp�cifi�e.
<BR><CENTER>
<TABLE BORDER><TR><TD>
Plateforme</TD><TD>Interface</TD><TD>Description</TD></TR><TR><TD>
Linux</TD><TD>oss</TD><TD>Open Sound System</TD></TR><TR><TD>
</TD><TD>alsa</TD><TD>Advanced Linux Sound Architecture</TD></TR><TR><TD>
</TD></TR></TABLE>
</CENTER><BR>
</P>
<DT><B><CODE>--disable-midi-support</CODE>
<A NAME="build-midi-support"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support pour
l'interface num�rique d'instruments de musique sur la carte son.</P>
<DT><B><CODE>--enable-midi-support=</CODE><EM>interface</EM></B><DD>
<P>Si une plateforme propose plus d'une interface num�rique d'instrument de
musique, vous pouvez sp�cifier celle qui sera utilis�e.
<BR><CENTER>
<TABLE BORDER><TR><TD>
Platte-forme</TD><TD>Interface</TD><TD>Description</TD></TR><TR><TD>
Linux</TD><TD>oss</TD><TD>Open Sound System</TD></TR><TR><TD>
</TD><TD>alsa</TD><TD>Advanced Linux Sound Architecture</TD></TR><TR><TD>
</TD></TR></TABLE>
</CENTER><BR>
</P>
<DT><B><CODE>--disable-fm-support</CODE>
<A NAME="build-fm-support"></A> </B><DD>
<P>R�duit la taille du programme en excluant le support pour le
synth�tiseur FM sur une carte son AdLib, OPL3, Sound Blaster, ou
�quivalent.</P>
<DT><B><CODE>--disable-pm-configfile</CODE>
<A NAME="build-pm-configfile"></A> </B><DD>
<P>Inclut une interface avec l'application <CODE>gpm</CODE> de telle sorte que,
sur les syst�mes qui le supportent, BRLTTY interagisse avec le
pilote du pointeur (souris) (voir la section
<A HREF="BRLTTY-5.html#gpm">Support du pointeur (souris) via GPM</A>).</P>
<DT><B><CODE>--disable-gpm</CODE>
<A NAME="build-api"></A> </B><DD>
<P>R�duit la taille du programme en excluant l'interface avec l'application gpm
qui permet � BRLTTY d'interagir avec le p�riph�rique du pointeur (la souris)
(voir Support du pointeur (souris) par GPM).</P>
<DT><B><CODE>--disable-api</CODE>
<A NAME="build-api"></A> </B><DD>
<P>R�duit la taille du programme en excluant l'interface de programmation de l'application.</P>
<DT><B><CODE>--with-api-parameters=</CODE><EM>name</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-api-parameters"></A> </B><DD>
<P>Sp�cifie les param�tres par d�faut pour l'interface de programmation
de l'application. Si le m�me param�tre est sp�cifi� plus d'une
fois, sa valeur la plus � droite est utilis�e. Pour une
description des param�tres accept�s par l'interface, voir le
manuel de r�f�rence de <B>BrlAPI</B>. Voir la ligne
<A HREF="BRLTTY-4.html#configure-api-parameters">api-parameters</A> du
fichier de configuration et l'option
<A HREF="BRLTTY-4.html#options-api-parameters">-A</A>
en ligne de commande pour la s�lection � l'ex�cution.</P>
<DT><B><CODE>--disable-caml-bindings=</CODE><EM>nom</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-api-parameters"></A> </B><DD>
<P>Ne compile pas les bindings Caml (interfaces de programmation) pour l'interface de programmation de l'application.</P>
<DT><B><CODE>--disable-java-bindings=</CODE><EM>nom</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-api-parameters"></A> </B><DD>
<P>Ne compile pas les bindings Java (interfaces de programmation) pour l'interface de programmation de l'application.</P>
<DT><B><CODE>--disable-lisp-bindings=</CODE><EM>nom</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-api-parameters"></A> </B><DD>
<P>Ne compile pas les bindings Lisp (interfaces de programmation) pour l'interface de programmation de l'application.</P>
<DT><B><CODE>--disable-python-bindings=</CODE><EM>nom</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-api-parameters"></A> </B><DD>
<P>Ne compile pas les bindings Python (interfaces de programmation) pour l'interface de programmation de l'application.</P>
<DT><B><CODE>--disable-tcl-bindings=</CODE><EM>nom</EM><CODE>=</CODE><EM>valeur</EM><CODE>,</CODE>...
<A NAME="build-api-parameters"></A> </B><DD>
<P>Ne compile pas les bindings Tcl (interfaces de programmation) pour l'interface de programmation de l'application.</P>
<DT><B><CODE>--with-tcl-config=</CODE><EM>chemin</EM>
Sp�cifie l'endroit o� se trouve le script de configuration Tcl
(tclConfig.sh). Vous pouvez fournir le chemin, soit vers le script lui-m�me,
soit vers le r�pertoire o� il se trouve. Un des mots suivants peut �tre
aussi utilis� comme op�rateur pour l'option:</B><DD>
<P>(<CODE>-</CODE>),
<DL>
<DT><B>no</B><DD>
<P>Utilise d'autres moyens pour savoir si Tcl est disponible et, s'il
l'est, o� il a �t� install�. Cela revient � sp�cifier
<CODE>--without-tcl-config.</CODE>.</P>
<DT><B>yes</B><DD>
<P>Cherche le script dans quelques r�pertoires couramment utilis�s.
Cela revient � sp�cifier
<CODE>--with-tcl-config</CODE>.</P>
</DL>
</P>
</DL>
</P>
<H3><A NAME="build-miscellaneous"></A> Options diverses</H3>
<P>
<DL>
<DT><B><CODE>--with-init-path=</CODE><EM>path</EM>
<A NAME="build-init-path"></A> </B><DD>
<P>Sp�cifie le chemin du programme r�el de d�marrage pour le
syst�me. Vous devriez fournir le chemin absolu. Si vous ne
sp�cifiez pas cette option:
<OL>
<LI>Vous devriez d�placer le programme <CODE>init</CODE> dans un nouvel
emplacement.</LI>
<LI>Vous devriez d�placer <CODE>brltty</CODE> dans l'emplacement original
du programme.</LI>
<LI>Finalement, quand le syst�me ex�cute <CODE>init</CODE> au d�marrage,
<CODE>brltty</CODE> est ex�cut�. Il se met automatiquement en
arri�re-plan
et ex�cute le <CODE>init</CODE> r�el au premier plan. C'est
l'une des mani�res quelque peu tordue d'avoir droit au braille d�s le
d�but. C'est surtout utile pour certains disques
d'installation/sauvegarde.</LI>
</OL>
Si vous ne sp�cifiez pas cette option, cette possibilit� n'est pas
activ�e. Elle vise tout particuli�rement la compilation d'une image pour
un installeur en braille.</P>
<DT><B><CODE>--with-stderr-path==</CODE><EM>chemin</EM>
<A NAME="build-init-path"></A> </B><DD>
<P>Sp�cifie le chemin du fichier ou du p�riph�rique o� la sortie standard
des erreurs sera �crite. Vous devriez fournir un chemin absolu. Si vous
ne sp�cifiez pas cette option, cette possibilit� n'est pas activ�e.
Cette option vise tout particuli�rement la compilation d'une image pour
un installeur en braille.</P>
</DL>
</P>
<H3><A NAME="make"></A> Pr�parer les cibles de fichier</H3>
<P>Une fois que BRLTTY a �t� configur�, les �tapes suivantes consistent
en la compilation et l'installation de ce dernier. Elles sont
effectu�es en entrant la commande make du syst�me dans le fichier make
principal de BRLTTY (<CODE>Makefile</CODE> dans le r�pertoire principal). Le
fichier make de BRLTTY supporte la plupart des cibles de maintenance
d'application courants. Ils incluent:
<DL>
<DT><B>make</B><DD>
<P>Un raccourci pour tout pr�parer.</P>
<DT><B>make all
<A NAME="make-all"></A> </B><DD>
<P>Compile et fait l'�dition de liens pour l'ex�cutable BRLTTY, ses pilotes et leurs pages
de manuel, ses programmes de texte, et quelques autres petits
outils.</P>
<DT><B>make install
<A NAME="make-install"></A> </B><DD>
<P>Compl�te la compilation et la phase d'�dition de liens (voir
<A HREF="#make-all">make all</A>), et
installe alors l'ex�cutable BRLTTY, ses fichiers de donn�es
(data), pilotes et pages d'aide, aux emplacements corrects et avec
les bonnes permissions.</P>
<DT><B>make uninstall
<A NAME="make-uninstall"></A> </B><DD>
<P>Enl�ve du syst�me l'ex�cutable BRLTTY, ses fichiers de donn�es,
pilotes et pages de manuel.</P>
<DT><B>make clean
<A NAME="make-clean"></A> </B><DD>
<P>Garantit que la compilation � venir et l'�dition de liens (voir see
<A HREF="#make-all">make all</A>)
se feront � vide en enlevant les r�sultats de la
compilation pr�c�dente, en liant et en testant depuis la structure du
r�pertoire source. Cela comprend la suppression des fichiers
objets, des ex�cutables, des objets dynamiques, des listes de
pilote, des pages de manuel, des fichiers d'en-t�te temporaires,
et des fichiers li�s.</P>
<DT><B>make distclean
<A NAME="make-distclean"></A> </B><DD>
<P>Au-del� de la suppression des r�sultats de la compilation pr�c�dente et de
l'edition de liens (voir
<A HREF="#make-clean">make clean</A>):
<UL>
<LI>
Supprime les r�sultats de la configuration de BRLTTY (voir
<A HREF="#build">Options de compilation</A>). Cela inclut la suppression de
<CODE>config.mk</CODE>, <CODE>config.h</CODE>,
<CODE>config.cache</CODE>, <CODE>config.status</CODE>, et <CODE>config.log</CODE>.</LI>
<LI>Supprime les autres fichiers de la structure du r�pertoire
source, qui prennent beaucoup de place mais qui ne leur
appartient pas. Cela inclut la suppression de fichiers �diteur de sauvegarde (backup), r�sultats de test, les reliquats du patch, et copies de fichiers source originaux.</LI>
</UL>
</P>
</DL>
</P>
<H2><A NAME="ss3.3">3.3</A> <A HREF="BRLTTY.html#toc3.3">Tester BRLTTY</A>
</H2>
<P>Apr�s la compilation, l'�dition de liens, et l'installation de BRLTTY,
c'est peut-�tre une bonne id�e de faire un petit test avant de
l'activer en permanence. Pour cela, appelez-le avec:</P>
<P>
<BLOCKQUOTE><CODE>
brltty -b<EM>pilote</EM> -d<EM>p�riph�rique</EM>
</CODE></BLOCKQUOTE>
Pour <EM>pilote</EM>, sp�cifiez les deux lettres du
<A HREF="BRLTTY-10.html#drivers">code d'identification de pilote</A> correspondant � votre
afficheur braille. Pour <EM>p�riph�rique</EM>, sp�cifiez le chemin complet
du p�riph�rique auquel votre afficheur braille est connect�.</P>
<P>Si vous ne voulez pas identifier explicitement le pilote et le
p�riph�rique � chaque fois que vous d�marrez BRLTTY, vous pouvez
proc�der de deux fa�ons. Vous pouvez �tablir des param�tres syst�me
par d�faut via les lignes
<A HREF="BRLTTY-4.html#configure-braille-driver">braille-driver</A> et
<A HREF="BRLTTY-4.html#configure-braille-device">braille-device</A> du
fichier de configuration, et/ou compiler tout ce dont vous avez besoin
dans BRLTTY via les options de compilation
<A HREF="#build-braille-driver">--with-braille-driver</A>
et
<A HREF="#build-braille-device">--with-braille-device</A>.</P>
<P>Si tout va bien, le message d'identification de BRLTTY devrait
appara�tre sur l'afficheur braille pendant quelques secondes (voir
l'option
<A HREF="BRLTTY-4.html#options-message-timeout">-M</A> de la ligne de commande). Apr�s qu'il ait disparu, (ce
que vous pouvez acc�l�rer en appuyant sur n'importe quelle touche de
l'afficheur), la zone de l'�cran o� le curseur se situe devrait
appara�tre. Cela signifie que vous devriez vous attendre � voir
s'afficher les commande du shell. Alors, comme vous avez entr� votre
commande pr�c�dente, chaque caract�re devrait appara�tre sur
l'afficheur d�s qu'il est tap� sur le clavier.</P>
<P>Si les choses se passent ainsi, arr�tez l'ex�cution de BRLTTY, et
r�jouissez-vous. Sinon, il peut �tre n�cessaire de tester chaque pilote
s�par�ment de fa�on � isoler la source du probl�me. Vous pouvez tester
le pilote de l'�cran par
<A HREF="#utility-scrtest">scrtest</A>, et celui de l'afficheur braille
par
<A HREF="#utility-brltest">brltest</A>.</P>
<P>Si vous rencontrez un probl�me qui n�cessite de farfouiller,
vous voudrez peut-�tre ex�cuter les options suivantes de la ligne de commande de
<CODE>brltty</CODE>:
<UL>
<LI>...
<A HREF="BRLTTY-4.html#options-log-level">-ldebug</A>
pour mettre dans un journal beaucoup de messages de diagnostique.</LI>
<LI>
<A HREF="BRLTTY-4.html#options-no-daemon">-n</A>
pour mettre BRLTTY au premier plan.</LI>
<LI>
<A HREF="BRLTTY-4.html#options-standard-error">-e</A>
pour diriger les messages de diagnostique vers l'erreur standard et
non dans le journal syst�me.</LI>
</UL>
</P>
<H2><A NAME="ss3.4">3.4</A> <A HREF="BRLTTY.html#toc3.4">D�marrer BRLTTY</A>
</H2>
<P>Quand BRLTTY est correctement install�, on l'appelle par la simple
commande <CODE>brltty</CODE>. Vous pouvez cr�er un fichier de configuration
(voir la section
<A HREF="BRLTTY-4.html#configure">le fichier de configuration</A> pour plus de d�tails)
afin de d'�tablir des param�tres syst�me par d�faut pour des choses
telles que l'emplacement du fichier de pr�f�rences, le pilote
d'afficheur braille � utiliser, le p�riph�rique auquel l'afficheur
braille est connect�, et la table de texte � utiliser.
Beaucoup d'options (voir la section
<A HREF="BRLTTY-4.html#options">Options en ligne de commande</A>
pour plus de d�tails) permettent de sp�cifier lors de l'ex�cution des
choses telles que le fichier de configuration, les param�tres par
d�faut fix�s dans le fichier de configuration, et quelques
caract�ristiques qui ont des param�tres par d�faut raisonnables mais
avec lesquelles seuls ceux qui pensent savoir ce qu'ils font peuvent
souhaiter modifier. L'option
<A HREF="BRLTTY-4.html#options-help">-h</A> affiche un r�sum� de toutes les
options. L'option
<A HREF="BRLTTY-4.html#options-version">-V</A> affiche la version courante du programme,
de l'API et des pilotes s�lectionn�s. L'option ``-v'' affiche les valeurs
des options apr�s que toutes les sources aient �t� examin�es.</P>
<P>C'est probablement mieux d'avoir BRLTTY d�marr� automatiquement par le
syst�me, d�s la s�quence d'amor�age, de fa�on � ce
que l'afficheur braille soit d�j� pr�t � fonctionner quand l'invite du
logging appara�t. La plupart (probablement toutes) des distributions
fournissent un script dans lequel les applications fournies par
l'utilisateur peuvent �tre d�marr�es en s�curit�, presqu'� la fin de
la s�quence de boot. Le nom de ce script d�pend de votre
distribution. Voici celles que nous connaissons:
<DL>
<DT><B>Red Hat</B><DD>
<P><CODE>/etc/rc.d/rc.local</CODE></P>
</DL>
</P>
<P>C'est une bonne id�e que de d�marrer BRLTTY depuis ce script (surtout
pour les nouveaux utilisateurs). Ajustez simplement des lignes du
type:
<BLOCKQUOTE><CODE>
<PRE>
if [ -x /bin/brltty -a -f /etc/brltty.conf ]
then
/bin/brltty
fi
</PRE>
</CODE></BLOCKQUOTE>
Normalement, cela peut s'abr�ger en une forme un peu moins
lisible du type:
<BLOCKQUOTE><CODE>
<PRE>
[ -x /bin/brltty -a -f /etc/brltty.conf ] && /bin/brltty
</PRE>
</CODE></BLOCKQUOTE>
N'ajoutez pas ces lignes avant la premi�re ligne (qui ressemble
g�n�ralement � <CODE>#!/bin/sh</CODE>).</P>
<P>Si l'afficheur braille doit �tre utilis� par un administrateur syst�me, il
devrait probablement �tre d�marr� le plus t�t possible, pendant la
s�quence de boot (comme par exemple avant que les syst�mes de fichier
ne soient v�rifi�s) afin que l'afficheur soit utilisable si quelque
chose ne va pas dans ces tests et que le syst�me bascule en mode
mono-utilisateur. De nouveau, l� o� il est l'id�al de faire cela
d�pend de la distribution. Voici les emplacements que nous connaissons:
<DL>
<DT><B>Debian</B><DD>
<P><CODE>/etc/init.d/boot</CODE> (pour les vieilles versions)<BR>
<CODE>/etc/init.d/</CODE> (pour les versions r�centes)<BR>
Un paquet <CODE>brltty</CODE> est fourni
(voir [
<A HREF="http://paquets.debian.org/brltty">http://paquets.debian.org/brltty</A>])
en tant que version <CODE>3.0</CODE> (<CODE>Woody</CODE>).
Comme ce paquet prend soin du d�marrage de BRLTTY, il n'y a pas
besoin pour l'utilisateur de fournir quoique ce soit, s'il est
install�. Si vous avez besoin que le d�mon se lance avec des options en ligne
de commande, vous pouvez modifier le contenu entre guillemets du fichier
<CODE>/etc/default/brltty</CODE>. Si vous avez besoin que le d�mon se lance avec
des options en ligne de commande, vous pouvez modifier le contenu entre
guillemets de la ligne <CODE>ARGUMENTS</CODE> du fichier <CODE>/etc/default/brltty</CODE>.</P>
<DT><B>RedHat</B><DD>
<P><CODE>/etc/rc.d/rc.sysinit</CODE><BR>
Sachez que les versions r�centes, afin de supporter une proc�dure
d'initialisation du syst�me plus orient�e vers les utilisateurs,
font rappeler ce script par lui-m�me de telle sorte qu'il soit
sous le contr�le de <CODE>initlog</CODE>. Recherchez des lignes comme celles-ci:
<BLOCKQUOTE><CODE>
<PRE>
# Rerun ourselves through initlog
if [ -z "$IN_INITLOG" ]; then
[ -f /sbin/initlog ] && exec /sbin/initlog $INITLOG_ARGS -r /etc/rc.sysinit
fi
</PRE>
</CODE></BLOCKQUOTE>
D�marrer BRLTTY avant ce rappel donne deux processus BRLTTY en
m�me temps, et cela vous causera des foules de probl�mes. Si votre
version de ce script a cette caract�ristique, assurez-vous de
d�marrer BRLTTY apr�s les lignes qui le mettent en action.</P>
<DT><B>Slackware</B><DD>
<P><CODE>/etc/rc.d/rc.S</CODE></P>
<DT><B>SuSE</B><DD>
<P><CODE>/sbin/init.d/boot</CODE></P>
</DL>
</P>
<P>Une autre solution est de d�marrer BRLTTY depuis /etc/inittab. Si vous
choisissez cette solution, vous avez deux possibilit�s.
<UL>
<LI>Si vous voulez qu'il d�marre vraiment tr�s t�t, mais que vous
n'avez pas besoin qu'il soit red�marr� automatiquement s'il
�choue, ajoutez une ligne comme la suivante avant la premi�re
ligne <CODE>:sysinit:</CODE> qui est d�j� dans le fichier.</LI>
<LI>Une autre solution est de d�marrer BRLTTY depuis /etc/inittab. Si
vous choisissez cette solution, vous avez deux possibilit�s. Si
vous voulez qu'il d�marre vraiment tr�s t�t, mais que vous n'avez
pas besoin qu'il soit red�marr� automatiquement en cas d'�chec,
ajoutez une ligne comme la suivante avant la premi�re ligne
:sysinit: qui est d�j� dans le fichier.
<BLOCKQUOTE><CODE>
brl:12345:respawn:/bin/brltty -n
</CODE></BLOCKQUOTE>
L'option
<A HREF="BRLTTY-4.html#options-no-daemon">-n</A> (--nodaemon) quand BRLTTY est ex�cut� avec la
facilit� respawn de l'inittab. Si vous oubliez de la
sp�cifier, vous allez vous retrouver avec des centaines de
processus BRLTTY, tous ex�cut�s en m�me temps.</LI>
</UL>
V�rifiez que l'identificateur (<CODE>brl</CODE> dans ces exemples) n'est pas d�j�
utilis� par une autre entr�e, et, si c'est le cas, choisissez-en un
autre.</P>
<P>Remarquez qu'une commande telle que <CODE>kill -TERM</CODE> suffit pour arr�ter
BRLTTY dans ses op�rations. Si, par exemple, il meurt lors de
l'entr�e en mode mono-utilisateur, il se pourrait bien que cela vienne
d'un probl�me de cette nature.</P>
<P>Certains syst�mes rencontrent des probl�mes si une application tente
d'utiliser le sous-syst�me son du noyau avant qu'il ait �t�
initialis�. Si votre syst�me en fait partie, vous aurez peut-�tre
besoin de d�sactiver le d�marrage automatique du pilote de la synth�se
vocale avec l'option
<A HREF="BRLTTY-4.html#options-no-speech">-N</A>.</P>
<P>Certains syst�mes, dans une �tape de leur s�quence de boot, testent
(probe) les ports s�rie (normalement afin de d�tecter automatiquement
la souris et d�duire son type). Si votre afficheur braille utilise un
port s�rie, ce genre de d�tection peut suffir � le g�ner. Si cela vous
arrive, essayez de red�marrer le pilote braille (voir la commande
<A HREF="BRLTTY-4.html#command-RESTARTBRL">RESTARTBRL</A>). Ou mieux, d�sactiver le test du port s�rie. Voici ce
que nous savons sur la mani�re de r�aliser cela:
<DL>
<DT><B>Red Hat</B><DD>
<P>Le test se fait par un service appel� <CODE>kudzu</CODE>. Utilisez la commande
<BLOCKQUOTE><CODE>
chkconfig --list kudzu
</CODE></BLOCKQUOTE>
pour voir s'il a �t� activ�.
Utilisez la commande
<BLOCKQUOTE><CODE>
chkconfig kudzu off
</CODE></BLOCKQUOTE>
pour le d�sactiver.
Les derni�res versions permettent de laisser <CODE>kudzu</CODE> s'ex�cuter sans
tester les ports s�rie.
Pour cela, �ditez le fichier <CODE>/etc/sysconfig/kudzu</CODE>,, et r�glez <CODE>SAFE</CODE> � <CODE>yes</CODE>.</P>
</DL>
</P>
<P>Si vous voulez d�marrer BRLTTY avant que les syst�mes de fichiers ne
soient mont�s, assurez-vous que tous leurs composants sont install�s
dans le fichier racine du syst�me. Voir les options de compilation
<A HREF="#build-execute-root">--with-execute-root</A>,
<A HREF="#build-program-directory">--bindir</A>,
<A HREF="#build-data-directory">--with-data-directory</A>,
et
<A HREF="#build-library-directory">--libdir</A> ref id="build-execute-root" name="--with-writable-directory"> et ref id="build-execute-root" name="--with-data-directory'' build">.</P>
<H2><A NAME="ss3.5">3.5</A> <A HREF="BRLTTY.html#toc3.5">Consid�rations sur la s�curit�</A>
</H2>
<P>L'ex�cution de BRLTTY n�cessite les privil�ges root parce que le
programme a besoin, lorsqu'il s'ex�cute, des droits d'acc�s de lecture
et d'�criture pour le port auquel l'afficheur braille est connect�,
les droits d'acc�s en lecture � /dev/vcsa ou �quivalent (pour avoir
les dimensions de l'�cran et la position du curseur, et pour revoir le
contenu et les choses mises en valeur sur l'�cran courant), ainsi que
les acc�s en lecture et �criture � la console syst�me (pour l'entr�e
des fl�ches de direction pendant le d�placement du curseur) pour
l'insertion de caract�res lors du Coller, pour la simulation de
touches sp�ciales en utilisant celles de l'afficheur braille, pour la
recherche de traduction des caract�res en sortie et les tables faisant
la correspondance des polices de l'�cran, et pour l'activation
du beeper interne). Vous pouvez, bien entendu, autoriser les
utilisateurs ordinaires � acc�der aux p�riph�riques n�cessaires, en
changeant les permissions du fichier associ� au
p�riph�rique. Toutefois, le simple acc�s � la console ne suffit pas
car l'activation du beeper interne et des fonctions de
simulation du clavier requiert les privil�ges root. Ainsi, si vous
voulez arr�ter le d�placement du curseur, utiliser Copier/Coller les
beep et tout cela, vous pouvez ex�cuter BRLTTY sans les privil�ges
root.</P>
<H2><A NAME="ss3.6">3.6</A> <A HREF="BRLTTY.html#toc3.6">Restrictions applicables � la compilation et � l'ex�cution</A>
</H2>
<P>
<DL>
<DT><B>les beeps d'Alerte</B><DD>
<P>
<A NAME="restriction-tunes"></A>
Certaines plateformes ne supportent pas tous les p�riph�riques
sonores. Voir
<A HREF="BRLTTY-5.html#preference-tune-device">P�riph�rique pour le son</A> pour plus de d�tails.</P>
<DT><B>Pilote pour la synth�se FestivalLite</B><DD>
<P>
<A NAME="restrictions-flite"></A>
Le pilote pour le moteur FestivalLite n'est compil�
que si ce paquet a �t� install�.</P>
<P>Ce pilote et celui pour le moteur Theta (voir
l'option de compilation ``--with-theta'') ne peuvent �tre li�s
tous les deux � l'ex�cutable BRLTTY (voir l'option de compilation
<A HREF="#build-theta">--with-speech-driver</A>) car les biblioth�ques n�cessaires � leur
ex�cution contiennent des �l�ments conflictuels.</P>
<DT><B>Pilote pour l'afficheur braille Libbraille</B><DD>
<P>
<A NAME="restrictions-mikropuhe"></A>
Le pilote pour le paquet libbraille n'est compil� que si le paquet a
�t� install�. </P>
<DT><B>Pilote pour la synth�se Mikropuhe</B><DD>
<P>
<A NAME="restrictions-mikropuhe"></A>
Le pilote pour le moteur Mikropuhe n'est compil�
que si ce paquet a �t� install�.</P>
<P>Vous ne pouvez inclure ce pilote si l'ex�cutable BRLTTY est li�
statiquement (voir l'option de compilation
<A HREF="#build-standalone-programs">--enable-standalone-programs</A>) car le paquet n'inclut pas
de biblioth�que statique.</P>
<DT><B>Le pilote pour la synth�se Theta</B><DD>
<P>
<A NAME="restrictions-theta"></A>
Le pilote pour le moteur Theta n'est compil� que si
ce paquet a �t� install�.</P>
<P>Ce pilote et celui pour le moteur FestivalLite
(voir l'option de compilation
<A HREF="#build-flite">--with-flite</A>) ne peuvent �tre
li�s tous les deux � l'ex�cutable BRLTTY (voir l'option de
compilation
<A HREF="#build-speech-driver">--with-speech-driver</A>) car les biblioth�ques
n�cessaires � leur ex�cution contiennent des �l�ments conflictuels.</P>
<P>Si ce pilote est compil� comme objet dynamique, vous devez
rajouter <CODE>$THETA_HOME/lib</CODE> � la variable d'environnement
<CODE>LD_LIBRARY_PATH</CODE> avant que BRLTTY ne soit appel�, car les objets �
l'int�rieur du paquet ne contiennent pas les chemins de recherche
pour l'ex�cution et leurs d�pendances.</P>
<DT><B>ViaVoice Speech Synthesizer Driver</B><DD>
<P>
<A NAME="restrictions-viavoice"></A>
Le pilote pour le moteur ViaVoice n'est compil� que
si ce paquet a �t� install�.</P>
<P>Vous ne pouvez inclure ce pilote si l'ex�cutable BRLTTY est li�
statiquement (voir l'option de compilation
the
<A HREF="#build-standalone-programs">--enable-standalone-programs</A>) car le paquet n'inclut pas
de biblioth�que statique.</P>
<DT><B>Pilote pour l'afficheur braille VideoBraille</B><DD>
<P>
<A NAME="restrictions-videobraille"></A>
Le pilote pour l'afficheur braille VideoBraille est compil� sur
tous les syst�mes, mais ne fonctionne que sur Linux.</P>
</DL>
</P>
<H2><A NAME="rpm"></A> <A NAME="ss3.7">3.7</A> <A HREF="BRLTTY.html#toc3.7">Installation � partir d'un fichier RPM</A>
</H2>
<P>Pour installer BRLTTY � partir d'un fichier RPM (RedHat paquet
Manager), proc�der comme suit:
<OL>
<LI>T�l�chargez le paquet ex�cutable correspondant � votre
mat�riel. Ce sera un fichier nomm�
<CODE>brltty-</CODE><EM>version</EM><CODE>-</CODE><EM>version</EM><CODE>.</CODE><EM>architecture</EM><CODE>.rpm</CODE>,
par exemple, <CODE>brltty-3.0-1.i386.rpm</CODE>.</LI>
<LI>Installez le paquet.
<BLOCKQUOTE><CODE>
rpm -Uvh brltty-<EM>version</EM>-<EM>version</EM>.<EM>architecture</EM>.rpm
</CODE></BLOCKQUOTE>
Vous devez faire cela en tant que <B>root</B>.
A proprement parler, l'option <CODE>-U</CODE> (Update) est la seule
n�cessaire. L'option <CODE>-v</CODE> (verbose) affiche le nom du paquet
lorsqu'il va �tre install�. L'option <CODE>-h</CODE> (hashes) affiche une barre
de progression (utilisant des hachures).</LI>
</OL>
Pour les gens courageux, nous fournissons le fichier RPM source
(<CODE>.src.rpm</CODE>) mais cela d�passe l'objectif de ce document.</P>
<P>Pour d�sinstaller BRLTTY, faites:
<BLOCKQUOTE><CODE>
rpm -e brltty
</CODE></BLOCKQUOTE>
</P>
<H2><A NAME="ss3.8">3.8</A> <A HREF="BRLTTY.html#toc3.8">Autres outils</A>
</H2>
<P>La compilation de BRLTTY donne aussi celle de quelques petits
outils d'aide et de diagnostic.</P>
<H3><A NAME="utility-brltty-config"></A> brltty-config</H3>
<P>Cet outil affecte un certain nombre de variables d'environnement
� des valeurs refl�tant l'installation courante de BRLTTY (voir les
<A HREF="#build">options de compilation</A>). Vous devriez l'ex�cuter dans un
environnement shell existant, donc ce n'est pas une v�ritable commande,
et seuls les scripts supportant la syntaxe <CODE>Bourne Shell</CODE>
peuvent l'utiliser.
<BLOCKQUOTE><CODE>
. brltty-config
</CODE></BLOCKQUOTE>
</P>
<P>Les variables d'environnement suivantes sont affect�es:
<DL>
<DT><B>BRLTTY_VERSION</B><DD>
<P>Le num�ro de version du paquet BRLTTY.</P>
<DT><B>BRLTTY_EXECUTE_ROOT</B><DD>
<P>La racine de l'ex�cution du paquet install�. Configur�e par
l'option de compilation
<A HREF="#build-execute-root">--with-execute-root</A>.</P>
<DT><B>BRLTTY_PROGRAM_DIRECTORY</B><DD>
<P>R�pertoire des programmes ex�cutables (binaires
ex�cutables). Configur� par l'option de compilation
<A HREF="#build-program-directory">--with-program-directory</A>.</P>
<DT><B>BRLTTY_LIBRARY_DIRECTORY</B><DD>
<P>R�pertoire des pilotes. Configur� par l'option de compilation
<A HREF="#build-library-directory">--with-library-directory</A>.</P>
<DT><B>BRLTTY_WRITABLE_DIRECTORY</B><DD>
<P>R�pertoire dans lequel il est possible d'�crire. Configur� par l'option
de compilation
<A HREF="#build-program-directory">--with-writable-directory</A>.</P>
<DT><B>BRLTTY_DATA_DIRECTORY</B><DD>
<P>R�pertoire des tables et des pages de manuel. Configur� par
l'option de compilation
<A HREF="#build-data-directory">--with-data-directory</A>.</P>
<DT><B>BRLTTY_MANPAGE_DIRECTORY</B><DD>
<P>R�pertoire des pages de manuel. Configur� par l'option de
compilation
<A HREF="#build-manpage-directory">--with-manpage-directory</A>.</P>
<DT><B>BRLTTY_INCLUDE_DIRECTORY</B><DD>
<P>R�pertoire pour les fichiers d'en-t�te C de BrlAPI. Configur�
par l'option de compilation
<A HREF="#build-include-directory">--with-include-directory</A>.</P>
<DT><B>BRLAPI_VERSION</B><DD>
<P>Le num�ro de version de BrlAPI (BRLTTY's Application
Programming Interface).</P>
<DT><B>BRLAPI_RELEASE</B><DD>
<P>Le num�ro de version complet de BrlAPI.</P>
<DT><B>BRLAPI_AUTH</B><DD>
<P>Le nom du fichier de cl�s de BrlAPI.</P>
</DL>
</P>
<P>En plus, les variables d'environnement standard <CODE>autoconf</CODE>
suivantes sont aussi assign�es:
<DL>
<DT><B>prefix</B><DD>
<P>Sous-r�pertoire pour les fichiers ind�pendants de l'architecture.
Configur� par l'option de compilation
<A HREF="#build-portable-root">--prefix</A>.</P>
<DT><B>exec_prefix</B><DD>
<P>Sous-r�pertoire pour les fichiers d�pendants de l'architecture.
Configur� par l'option de compilation
<A HREF="#build-architecture-root">--exec-prefix</A>.</P>
<DT><B>bindir</B><DD>
<P>Emplacement par d�faut du
<A HREF="#build-program-directory">r�pertoire du programme</A>.
Configur� par l'option de compilation <CODE>--bindir</CODE>.</P>
<DT><B>libdir</B><DD>
<P>R�pertoire pour les objets dynamiques et statiques de
BrlAPI, la localisation par d�faut pour le
<A HREF="#build-library-directory">r�pertoire des biblioth�ques</A>. Configur� par l'option de compilation
<A HREF="#build-api-directory">--libdir</A>.</P>
<DT><B>sysconfdir</B><DD>
<P>R�pertoire des fichiers de configuration, emplacement par d�faut du
<A HREF="#build-data-directory">r�pertoire de donn�es</A>. Configur� par
l'option de compilation
<A HREF="#build-configuration-directory">--sysconfdir</A>.</P>
<DT><B>mandir</B><DD>
<P>Emplacement par d�faut pour le
<A HREF="#build-manpage-directory">r�pertoire des pages de manuel</A>.
Configur� par l'option de compilation <CODE>--mandir</CODE>.</P>
<DT><B>includedir</B><DD>
<P>Emplacement par d�faut du
<A HREF="#build-include-directory">r�pertoire des fichiers d'en-t�te</A>.
Configur� par l'option de compilation <CODE>--includedir</CODE>.</P>
</DL>
</P>
<H3><A NAME="utility-brltty-install"></A> brltty-install</H3>
<P>Cet outil copie la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A> de
BRLTTY d'un emplacement � un autre.
<BLOCKQUOTE><CODE>
brltty-install <EM>destination</EM> [<EM>origine</EM>]
</CODE></BLOCKQUOTE>
<DL>
<DT><B><EM>destination</EM></B><DD>
<P>L'emplacement o� la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A>
sera copi�e. Cela doit �tre un r�pertoire existant.</P>
<DT><B><EM>from</EM></B><DD>
<P>L'emplacement � partir duquel la
<A HREF="#hierarchy">hi�rarchie des fichiers install�s</A>
sera copi�e. S'il est sp�cifi�, le r�pertoire doit
exister. S'il n'est pas sp�cifi�, l'emplacement utilis� pour la
compilation est utilis�.</P>
</DL>
Par exemple, vous pouvez utiliser cette outil pour copier BRLTTY
� partir d'un disque racine. Si une disquette racine est mont�e dans
<CODE>/mnt</CODE>, et que BRLTTY est install� sur le syst�me principal, taper
<BLOCKQUOTE><CODE>
brltty-install /mnt
</CODE></BLOCKQUOTE>
copie BRLTTY, en entier avec ses fichiers de donn�es et ses biblioth�ques, sur
la disquette racine.</P>
<P>Quelques probl�mes ont �t� rencontr�s en copiant BRLTTY entre des
syst�mes avec diff�rentes versions de la biblioth�que C. Si vous avez
des difficult�s, cela vaut la peine d'enqu�ter.</P>
<H3><A NAME="utility-brltest"></A> brltest</H3>
<P>Cet outil teste un pilote d'afficheur braille, et fournit presque
une fa�on interactive d'apprendre ce que font les touches de
l'afficheur braille. Vous devriez l'ex�cuter en tant que root.
<BLOCKQUOTE><CODE>
brltest -<EM>option</EM> ... [<EM>pilote</EM> [<EM>nom</EM>=<EM>valeur</EM> ...]]
</CODE></BLOCKQUOTE>
<DL>
<DT><B><EM>pilote</EM></B><DD>
<P>Le pilote de l'afficheur braille. Doit �tre les deux lettres du
<A HREF="BRLTTY-10.html#drivers">code d'identification du pilote</A>. S'il n'est pas sp�cifi�, le
premier pilote configur� par l'option de compilation
<A HREF="#build-braille-driver">--with-braille-driver</A> est utilis�.</P>
<DT><B><EM>nom</EM><CODE>=</CODE><EM>valeur</EM></B><DD>
<P>Affecte un param�tre d'afficheur braille. Pour une description des
param�tres accept�s par un pilote sp�cifique, voir la
documentation de ce pilote.</P>
<DT><B><CODE>-d</CODE><EM>device</EM> <CODE>--device=</CODE><EM>p�riph�rique</EM></B><DD>
<P>Le chemin absolu pour le p�riph�rique auquel l'afficheur braille
est connect�. S'il n'est pas sp�cifi�, c'est le p�riph�rique
configur� par l'option de compilation
<A HREF="#build-braille-device">--with-braille-device</A> qui est
utilis�.</P>
<DT><B><CODE>-D</CODE><EM>directory</EM> <CODE>--data-directory=</CODE><EM>r�pertoire</EM></B><DD>
<P>Vous devriez fournir un chemin absolu pour le r�pertoire o� les
fichiers de donn�es des pilotes sont plac�s. S'il n'est pas sp�cifi�,
c'est le r�pertoire configur� par l'option de compilation
<A HREF="#build-data-directory">--with-data-directory</A> qui est utilis�.</P>
<DT><B><CODE>-L</CODE><EM>directory</EM> <CODE>--library-directory=</CODE><EM>repertoire</EM></B><DD>
<P>Le chemin absolu pour le r�pertoire dans lequel sont situ�s les
pilotes. S'il n'est pas sp�cifi�, c'est le r�pertoire configur� par
l'option de compilation
<A HREF="#build-library-directory">--libdir</A> qui est utilis�.</P>
<DT><B><CODE>-W</CODE><EM>r�pertoire</EM> <CODE>--writable-directory=</CODE><EM>repertoire</EM></B><DD>
<P>Le chemin absolu vers un r�pertoire o� il est possible d'�crire. S'il
n'est pas sp�cifi�, le r�pertoire configur� avec l'option >e compilation --with-writable-directory
est utilis�.</P>
<DT><B><CODE>-h</CODE> <CODE>--help</CODE></B><DD>
<P>Affiche un r�sum� des options de la ligne de commande, puis quitte.</P>
</DL>
</P>
<P>Cet outil utilise le ``mode apprentissage des commandes'' de
BRLTTY. Le d�lai d'appui sur une touche (apr�s lequel cet outil
quitte) est de 10 secondes. Le temps d'affichage du message (utilis�
pour les segments non-finaux de longs messages) est de <CODE>4</CODE> secondes.</P>
<H3><A NAME="utility-spktest"></A> spktest</H3>
<P>Cet outil teste un pilote de synth�se vocale. Il se peut qu'il
doive �tre ex�cut� en tant que root.
<BLOCKQUOTE><CODE>
spktest -<EM>option</EM> ... [<EM>pilote</EM> [<EM>nom</EM>=<EM>value</EM> ...]]
</CODE></BLOCKQUOTE>
<DL>
<DT><B><EM>pilote</EM></B><DD>
<P>Le pilote pour la synth�se vocale. Doit �tre les deux lettres
du
<A HREF="BRLTTY-10.html#drivers">code d'identification de pilote</A>. S'il n'est pas sp�cifi�,
c'est le premier pilote sp�cifi� par l'option de compilation
<A HREF="#build-speech-driver">--with-speech-driver</A> qui est utilis�.</P>
<DT><B><EM>nom</EM><CODE>=</CODE><EM>valeur</EM></B><DD>
<P>R�gle le param�tre du pilote de la synth�se vocale. Pour une
description des param�tres accept�s par un pilote sp�cifique,
voir la documentation de ce pilote.</P>
<DT><B><CODE>-t</CODE><EM>string</EM> <CODE>--text-string=</CODE><EM>string</EM></B><DD>
<P>Le texte qui sera dit. S'il n'est pas sp�cifi�, c'est l'entr�e
standard (stdin) qui est lue.</P>
<DT><B><CODE>-D</CODE><EM>repertoire</EM> <CODE>--data-directory=</CODE><EM>repertoire</EM></B><DD>
<P>Le chemin absolu pour le r�pertoire dans lequel se situent les
fichiers de donn�es du pilote. S'il n'est pas sp�cifi�, c'est le
r�pertoire configur� par l'option de compilation
<A HREF="#build-data-directory">--with-data-directory</A> qui est utilis�.</P>
<DT><B><CODE>-L</CODE><EM>repertoire</EM> <CODE>--library-directory=</CODE><EM>repertoire</EM></B><DD>
<P>Le chemin absolu du r�pertoire o� se situe les pilotes. S'il n'est
pas sp�cifi�, c'est le r�pertoire configur� par l'option de
compilation
<A HREF="#build-library-directory">--libdir</A> qui est utilis�.</P>
<DT><B><CODE>-h</CODE> <CODE>--help</CODE></B><DD>
<P>Affiche un r�sum� des options de la ligne de commande, puis quitte.</P>
</DL>
</P>
<H3><A NAME="utility-scrtest"></A> scrtest</H3>
<P>Cet outil teste le pilote d'�cran. Il doit �tre ex�cut� en tant
que root.
<BLOCKQUOTE><CODE>
scrtest -<EM>option</EM> ... [<EM>nom</EM>=<EM>valeur</EM> ...]
</CODE></BLOCKQUOTE>
<DL>
<DT><B><EM>nom</EM><CODE>=</CODE><EM>valeur</EM></B><DD>
<P>R�gle le param�tre du pilote de l'�cran. Pour une
description des param�tres accept�s par un pilote sp�cifique
voir la documentation de ce pilote.</P>
<DT><B><CODE>-l</CODE><EM>colonne</EM> <CODE>--left=</CODE><EM>colonne</EM></B><DD>
<P>Sp�cifie la colonne du d�but (� gauche) de l'�cran (origine �
z�ro). Si vous ne fournissez pas cette valeur, une valeur par
d�faut, bas�e sur la largeur sp�cifi�e, est s�lectionn�e, de telle
sorte que la fen�tre soit centr�e � l'horizontal, est utilis�e.</P>
<DT><B><CODE>-c</CODE><EM>coompte</EM> <CODE>--columns=</CODE><EM>compte</EM></B><DD>
<P>Sp�cifie la largeur de la fen�tre (en colonnes). Si vous ne
fournissez pas cette valeur, une valeur par d�faut, bas�e sur la
colonne de d�but, est s�lectionn�e, de telle sorte que la fen�tre
soit centr�e � l'horrizontal.</P>
<DT><B><CODE>-t</CODE><EM>ligne</EM> <CODE>--top=</CODE><EM>ligne</EM></B><DD>
<P>Sp�cifie la ligne de d�but (en haut) de l'�cran (origine �
z�ro). Si vous ne fournissez pas cette valeur, une valeur par
d�faut, bas�e sur la hauteur sp�cifi�e, est s�lectionn�e, de telle
sorte que la fen�tre soit centr�e � la verticale.</P>
<DT><B><CODE>-r</CODE><EM>compte</EM> <CODE>--rows=</CODE><EM>compte</EM></B><DD>
<P>Sp�cifie la hauteur de la fen�tre (en lignes). Si vous ne
fournissez pas cette valeur, une valeur par d�faut, bas�e sur la
rang�e de d�but sp�cifi�e, est s�lectionn�e, de telle sorte que la
fen�tre soit centr�e � la verticale.</P>
<DT><B><CODE>-h</CODE> <CODE>--help</CODE></B><DD>
<P>Affiche un r�sum� des options de la ligne de commande, puis
quitte.</P>
</DL>
</P>
<P>Remarques:
<UL>
<LI>Si vous ne sp�cifiez ni la colonne de d�but, ni la largeur de la
fen�tre, la r�gion est centr�e horizontalement et commence � la
colonne 5.</LI>
<LI>Si vous ne sp�cifiez ni la rang�e de d�but, ni la hauteur de la
fen�tre, la r�gion est centr�e verticalement et commence � la ligne
5.</LI>
</UL>
</P>
<P>Les �l�ments suivants sont �crits sur la sortie standard (stdout):
<OL>
<LI>Une ligne d�taillant les dimensions de l'�cran.
<BLOCKQUOTE><CODE>
Screen: <EM>largeur</EM>x<EM>hauteur</EM>
</CODE></BLOCKQUOTE>
</LI>
<LI>Une ligne d�taillant la position (� l'origine z�ro) du curseur.
<BLOCKQUOTE><CODE>
Cursor: [<EM>colonne</EM>,<EM>ligne</EM>]
</CODE></BLOCKQUOTE>
</LI>
<LI>Une ligne d�taillant les dimensions de la zone d'�cran
s�lectionn�e, et la position (� l'origine z�ro) de son coin en
haut � gauche.
<BLOCKQUOTE><CODE>
Region: <EM>largeur</EM>x<EM>hauteur</EM>@[<EM>colonne</EM>,<EM>ligne</EM>]
</CODE></BLOCKQUOTE>
</LI>
<LI>Le contenu de la r�gion d'�cran s�lectionn�e. Les caract�res
non-imprimables sont repr�sent�s par des espaces.</LI>
</OL>
</P>
<H3><A NAME="utility-ttbtest"></A> ttbtest</H3>
<P>Cet outil teste une table de texte (section
<A HREF="BRLTTY-6.html#table-text">Tables de texte</A>).
<BLOCKQUOTE><CODE>
ttbtest -<EM>option</EM> ... <EM>input-table</EM> <EM>output-table</EM>
</CODE></BLOCKQUOTE>
<DL>
<DT><B><EM>table-en-entr�e</EM></B><DD>
<P>Le chemin du fichier vers la table de texte en entr�e du test. S'il
est relatif, il est ancr� au r�pertoire configur� avec l'option de
compilation --with-data-directory.</P>
<DT><B><EM>table-en-sortie</EM></B><DD>
<P>Le chemin du fichier vers la table de texte en sortie du test. S'il
est relatif, il est ancr� au r�pertoire de travail courant. Si vous ne
fournissez pas ce param�tre, aucune table en sortie ne sera �crite.</P>
<DT><B><CODE>-i</CODE> <CODE>--input-format=</CODE><EM>format</EM></B><DD>
<P>Sp�cifie le format de la table d'entr�e. S'il vous ne fournissez pas cette
option, le format de la table en entr�e est d�duit de l'extension de son
fichier.</P>
<DT><B><CODE>-o</CODE> <CODE>--output-format=</CODE><EM>format</EM></B><DD>
<P>Sp�cifie le format de la table en sortie. S'il vous ne fournissez pas cette
option, le format de la table en entr�e est d�duit de l'extension de son
fichier.</P>
<DT><B><CODE>-c</CODE><EM>charset</EM> <CODE>--charset=</CODE><EM>charset</EM></B><DD>
<P>Sp�cifie le nom de l'encodage 8-bit � utiliser lors de l'interpr�tation des
tables. Si vous ne fournissez pas cette option, le codage de l'h�te est
utilis�.</P>
<DT><B><CODE>-e</CODE> <CODE>--edit</CODE></B><DD>
<P>Appelle l'�diteur de tables de texte. Si vous sp�cifiez table de sortie,
les changements seront �crits dessus. Sinon, la table d'entr�e et r��crite.</P>
<DT><B><CODE>-h</CODE> <CODE>--help</CODE></B><DD>
<P>Affiche un r�sum� des options en ligne de commande, et quitte.</P>
</DL>
</P>
<P>Si vous ne demandez aucune action en particulier, la table de sortie est
facultative. Si vous ne la sp�cifiez pas, la table d'entr�e est v�rifi�e.
Si vous la sp�cifiez, la table d'entr�e est convertie.
Les formats de table suivants sont support�s:
<DL>
<DT><B>ttb</B><DD>
<P>BRLTTY</P>
<DT><B>sbl</B><DD>
<P>SuSE Blinux</P>
<DT><B>a2b</B><DD>
<P>Gnopernicus</P>
<DT><B>gnb</B><DD>
<P>Braille Gnome</P>
</DL>
</P>
<H3><A NAME="utility-ctbtest"></A> ctbtest</H3>
<P>Cet outil teste une table de braille abr�g� (section
<A HREF="BRLTTY-6.html#table-contraction">Tables de braille abr�g�</A>). Le texte lu � partir de l'entr�e standard (stdin) est r��crit sur
la sortie standard (stdout) en braille abr�g�.
<BLOCKQUOTE><CODE>
ctbtest -<EM>fichier-en-entr�e</EM>
</CODE></BLOCKQUOTE>
<DL>
<DT><B><EM>fichier-en-entr�e</EM></B><DD>
<P>La liste des fichiers � traiter. Vous pouvez sp�cifier n'importe quel
nombre de fichiers. Ils sont trait�s de la gauche vers la droite. Le nom
de fichier sp�cial - est interpr�t� comme l'entr�e standard (stdin). Si
vous ne sp�cifiez aucun fichier, l'entr�e standard est trait�e.</P>
<DT><B><CODE>-c</CODE><EM>fichier</EM> <CODE>--contraction-table=</CODE><EM>fichier</EM></B><DD>
<P>Le chemin vers le fichier de la table de braille abr�g�. S'il est relatif, il
est ancr� au r�pertoire configur� par l'option de compilation
<A HREF="#build-data-directory">--with-data-directory</A>.
L'extension .ctb est facultative. Si vous ne fournissez pas cette option,
en-us-g2 est suppos�.</P>
<DT><B><CODE>-t</CODE><EM>file</EM>|<CODE>auto</CODE> <CODE>--text-table=</CODE><EM>file</EM>|<CODE>auto</CODE></B><DD>
<P>Sp�cifie la table de texte (voir
la section
<A HREF="BRLTTY-6.html#table-text">Tables de texte</A> pour les d�tails).
Si vous fournissez un chemin relatif, il est ancr� �
<CODE>/etc/brltty</CODE> (voir les options de compilation
<A HREF="#build-data-directory">--with-data-directory</A> et
<A HREF="#build-execute-root">--with-execute-root</A> pour plus de d�tails).
L'extension <CODE>.ttb</CODE> est facultative.
Voir la ligne
<A HREF="BRLTTY-4.html#configure-text-table">text-table</A>
du fichier de configuration pour le param�trage par d�faut au moment de l'ex�cution. Vous pouvez modifier
ce param�tre avec la pr�f�rence
<A HREF="BRLTTY-5.html#preference-text-table">Text Table</A>.</P>
<DT><B><CODE>-w</CODE><EM>colonnes</EM> <CODE>--output-width==</CODE><EM>colonnes</EM></B><DD>
<P>La longueur maximale d'une ligne en sortie. Chaque ligne d'entr�e en
braille abr�g� est d�velopp�e sur autant de lignes que n�cessaire. Si
vous ne sp�cifiez pas cette option, il n'y a pas de limites et s'op�re
une correspondance ligne par ligne entre les lignes en entr�e et celles en
sortie.</P>
<DT><B><CODE>-h</CODE> <CODE>--help</CODE></B><DD>
<P>Affiche un r�sum� des options en ligne de commande, et quitte.</P>
</DL>
</P>
<P>La table de texte est utilis�e:
<UL>
<LI>Pour d�finir l'encodage de sortie de mani�re � ce que le
braille abr�g� soit correctement affich�. Vous devriez sp�cifier
la m�me table devant �tre utilis�e par BRLTTY lorsque la sortie sera lue.</LI>
<LI>Pour d�finir les repr�sentations braille de ces caract�res
d�finies dans le braille abr�g� (voir la section
<A HREF="BRLTTY-6.html#contraction-opcodes-translation">Traduction de caract�re</A>).</LI>
</UL>
</P>
<P>C'est la table de traduction de texte <CODE>text.brf.ttb</CODE> qui est
fournie pour l'utilisation de cet outil. Il d�finit le format
utilis� dans les fichiers .brf. C'est aussi le format que pr�f�rent
utiliser les imprimantes braille et les documents braille
�lectroniques. Cette table permet � cet outil d'�tre r�ellement
utilis� en tant que traducteur de braille en texte.</P>
<H3><A NAME="utility-tunetest"></A> tunetest</H3>
<P>Cet outil teste la facilit� des sons d'avertissement, et fournit aussi
un moyen facile de cr�er de nouveaux sons. Il se peut que vous
soyez oblig�s de l'ex�cuter en tant que root.
<BLOCKQUOTE><CODE>
tunetest -<EM>option</EM> ... {<EM>note</EM> <EM>dur�e</EM>} ...
</CODE></BLOCKQUOTE>
<DL>
<DT><B><EM>note</EM></B><DD>
<P>Un num�ro de note MIDI standard. Il doit �tre un entier de <CODE>1</CODE> � <CODE>127</CODE>,
avec 60 repr�sentant la valeur moyenne. Chaque valeur repr�sente un
demi-ton chromatique standard, donc des notes les
plus basses aux notes les plus hautes. La valeur la plus faible (<CODE>1</CODE>)
repr�sente le cinqui�me sous Middle C, et la valeur la plus haute
(<CODE>127</CODE>) repr�sente le sixi�me G au-dessus de Middle C (notation anglosaxonne).</P>
<DT><B><EM>dur�e</EM></B><DD>
<P>La dur�e de la note est en millisecondes. Elle doit �tre un
entier de <CODE>1</CODE> � <CODE>255</CODE>..</P>
<DT><B><CODE>-d</CODE><EM>p�riph�rique</EM> <CODE>--device=</CODE><EM>p�riph�rique</EM></B><DD>
<P>Le p�riph�rique sur lequel jouer le son.
<DL>
<DT><B>beeper</B><DD>
<P>Le beeper interne (g�n�rateur de sons en console).</P>
<DT><B>pcm</B><DD>
<P>L'interface digital audio sur la carte son.</P>
<DT><B>midi</B><DD>
<P>L'interface num�rique d'instrument de musique sur la carte
son.</P>
<DT><B>fm</B><DD>
<P>Le synth�tiseur FM sur une carte son AdLib, OPL3, Sound
Blaster, ou �quivalente.</P>
</DL>
Vous pouvez abr�ger le nom du p�riph�rique. Voir la pr�f�rence
<A HREF="BRLTTY-5.html#preference-tune-device">Tune Device</A> pour plus de d�tails concernant le p�riph�rique
par d�faut et les restrictions de la plateforme.</P>
<DT><B><CODE>-v</CODE><EM>volume</EM> <CODE>--volume=</CODE><EM>volume</EM></B><DD>
<P>Sp�cifie le volume � la sortie (intensit�) sous la forme d'un
pourcentage du maximum. Le volume de sortie par d�faut est de <CODE>50</CODE>.</P>
<DT><B><CODE>-p</CODE><EM>device</EM> <CODE>--pcm-device=</CODE><EM>device</EM></B><DD>
<P>Sp�cifie le p�riph�rique � utiliser pour le son (voir la
section
<A HREF="BRLTTY-12.html#operand-pcm-device">sp�cification du p�riph�rique PCM</A>). Cette option ne
fonctionne pas si vous avez sp�cifi� l'option de compilation
<A HREF="#build-pcm-support">--disable-pcm-support</A>.</P>
<DT><B><CODE>preferences-file</CODE> <EM>file</EM>
<A NAME="configure-preferences-file"></A> </B><DD>
<P>Sp�cifie l'emplacement du fichier qui doit �tre utilis� pour sauvegarder
et charger les pr�f�rences de l'utilisateur. Si vous fournissez un chemin
relatif, il est ancr� sur <CODE>/var/lib/brltty</CODE>. Le r�glage par d�faut
consiste � utiliser <CODE>brltty.prefs</CODE>. Vous pouvez outre-passer cette
ligne avec l'option
<A HREF="BRLTTY-4.html#options-preferences-file">-F</A> en
ligne de commande.</P>
<DT><B><CODE>-m</CODE><EM>peripherique</EM> <CODE>--midi-device=</CODE><EM>peripherique</EM></B><DD>
<P>Sp�cifie le p�riph�rique � utiliser pour l'interface num�rique d'instrument
de musique (voir la section
<A HREF="BRLTTY-12.html#operand-midi-device">sp�cification du p�riph�rique MIDI</A>). Cette option ne fonctionne pas si vous avez
sp�cifi� l'option de compilation
<A HREF="#build-midi-support">--disable-midi-support</A>.</P>
<DT><B><CODE>-i</CODE><EM>instrument</EM> <CODE>--instrument=</CODE><EM>instrument</EM></B><DD>
<P>L'instrument � utiliser si le p�riph�rique s�lectionn� est
midi. Pour la liste compl�te des instruments, voir la
<A HREF="BRLTTY-12.html#operand-midi-device">Table des instrument MIDI</A>. L'instrument par d�faut est un <CODE>piano grand
accoustique</CODE>. Les mots comportant le nom de l'instrument doivent
�tre s�par�s les uns des autres par un simple signe moins plut�t
que par des espaces, et chacun des mots peut �tre abr�g�.</P>
<DT><B><CODE>-h</CODE> <CODE>--help</CODE></B><DD>
<P>Affiche un r�sum� des options de la ligne de commande.</P>
</DL>
</P>
<HR>
<A HREF="BRLTTY-4.html">Page suivante</A>
<A HREF="BRLTTY-2.html">Page pr�c�dente</A>
<A HREF="BRLTTY.html#toc3">Table des mati�res</A>
</BODY>
</HTML>
Mini Shell