Import brltty

This commit is contained in:
Vladimir Serbinenko committed 2013-10-28 16:46:36 +01:00
1 parent 93c120754a
commit 16fba4d65d
982 files changed
+326586

No files matched your search

File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,58 @@
Adi Dascal <ad@baum.ro>
Alex Bernier <alex.bernier@free.fr>
Andreas Gross <andi@andi-bika.de>
Attila Hammer <hammera@pickup.hu>
August Hörandl <august.hoerandl@gmx.at>
Boris Daix <Boris.Daix@insa-lyon.fr>
Cheryl Homiak <chomiak@shellworld.net>
Christian Comaschi <christian_comaschi@libero.it>
Coscell Kao <coscell@molerat.net>
Daniel Dalton <d.dalton@iinet.net.au>
Dave Mielke <dave@mielke.cc>
David Sauer <sauer@brailcom.cz>
Hans Schou <chlor@schou.dk>
Helge Havnegjerde <helge.havnegjerde@c2i.net>
Hermann Bender <meinelisten@onlinehome.de>
James Teh <jamie@jantrid.net>
Jan Buchal <buchal@brailcom.org>
Jean-Philippe Mengual <jmengual@linuxfromscratch.org>
John J. Boyer <john.boyer@jjb-software.com>
Kazunori Minatani <99112004@gakushuin.ac.jp>
Lars Bjørndal <lars.bjorndal@broadpark.no>
Lee Maschmeyer <leemer1@comcast.net>
Luke Yelavich <themuso@ubuntu.com>
Mario Lang <mlang@delysid.org>
Mark Mielke <mark@mielke.cc>
Matthew Miller <mattdm@mattdm.org>
Michael Curran <mick@kulgan.net>
Michel Such <michel.such@free.fr>
Mike Pedersen <mpedersen@mindspring.com>
Nicolas Pitre <nico@fluxnic.net>
Olivier Bert <obert01@mistigri.org>`
Oscar Fernandez <ofa@once.es>
Pete De Vasto <pdevasto@incyte.com>
Peter Lundblad <plundblad@google.com>
Regiane Mendonça Villela <regianevillela@gmail.com>
Rich Burridge <Rich.Burridge@Sun.COM>
Rudolf Weeber <Rudolf.Weeber@gmx.de>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Samuel Yang <mison@bbs.ee.ntu.edu.tw>
Sébastien Hinderer <sebastien.hinderer@ens-lyon.org>
Sérgio Neves <sergionevess@gmail.com>
Simon Kainz <simon@familiekainz.at>
Simon Meers <drmeers@gmail.com>
Stepan Kasal <kasal@ucw.cz>
Stephane Dalton <sdalton@videotron.ca>
Stéphane Doyon <s.doyon@videotron.ca>
Tapio Kelloniemi <tapio.kelloniemi@thack.org>
Thu Trang <phamtrang2002@softhome.net>
Timothy Spaulding <spaulding@icanbrew.com>
Timo Matsinen <matsinen@jyu.fi>
Tom spot Callaway <tcallawa@redhat.com>
Tomáš Janoušek <tomi@nomi.cz>
Tomoyuki Kudou <kudou@cypac.co.jp>
Willi Lutzenberger <willutz@gmx.net>
William Hubbs <w.d.hubbs@gmail.com>
Wolfgang Astleitner <wolfgang.astleitner@liwest.at>
Yair K. <caesium@hotpop.com>
Yannick Plassiard <yan@mistigri.org>
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,36 @@
The BRLTTY project started in July, 1995. The initial team consisted of Nikhil
Nair and James Bowden.
The first version ran with Blazie Engineering's Braille Lite. Since, at that
time, the Braille Lite wasn't designed to be a dedicated refreshable braille
display for a computer, its response time was far too slow. This situation has
now been corrected.
The second version, BRLTTY-0.22-BETA, was released in September of 1995. It was
the first to be released publicly. As well as the Braille Lite, it also
supported Tieman B.V.'s CombiBraille series.
James Bowden stopped being an active developer, although his continued help in
other areas (including documentation) was much appreciated. Two new members,
Nicolas Pitre and Stéphane Doyon, joined the team. They added support for Alva
and Telesensory Systems Inc. displays, as well as many excellent features for
the system as a whole.
A stable version (1.0) was released sometime around the end of 1996.
Support for Papenmeier displays was contributed by a team from The Technical
High School, Department of Electrical Engineering, Vienna, Austria. Support for
the TSI displays was completed, and support for the EuroBraille brand was
added. New features were also continually being added to the system.
Regretably, Nikhil Nair stopped working on the BRLTTY project. Nicolas Pitre
assumed the job of maintainer.
Version 2.0 was released during the summer of 1998, and version 2.1 was
released in March of 1999. It added support for EcoBraille (thanks to Oscar
Fernandez), Alva Delphi (thanks to Terry Barnaby), and Braille Lite 18 (from
Nikhil Nair), as well as Some small improvements and fixes.
Dave Mielke began to submit fixes and enhancements during 2000,
and joined the team as the next maintainer in June of 2001.
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,135 @@
<sect>Sujets avancés<p>
<sect1>Installation de plusieurs versions<label id="multiple"><p>
Il est facile d'avoir plus d'une version de BRLTTY installée sur le même
système en même temps. Cette possibilité vous permet de tester une nouvelle
version avant de supprimer l'ancienne.
L'option de compilation <ref id="build-execute-root" name="--with-execute-root">
vous permet d'installer la <ref id="hierarchy" name="hiérarchie des fichiers installés"> complète là où
vous le voulez de sorte qu'elle soit totalement autonome dans son contenu.
Tout en vous rappelant qu'il vaut mieux prendre tous les composants de
BRLTTY dans le système de fichier racine, vous pouvez le compiler ainsi:
<tscreen><verb>
./configure --with-execute-root=/brltty-3.1
make install
</verb></tscreen>
Vous pouvez alors l'exécuter ainsi:
<tscreen>/brltty-3.1/bin/brltty</tscreen>
Quand vous avez fait la version 3.2, installez-la simplement dans un
emplacement différent et exécutez le nouvel exécutable à partir de là.
<tscreen><verb>
./configure --with-execute-root=/brltty-3.2
make install
/brltty-3.2/bin/brltty
</verb></tscreen>
Jusque-là, tout cela est quelque peu maladroit pour au moins deux raisons.
La première est que ces longs chemins sont trop difficiles à taper, et l'autre
est que vous ne voulez pas bricoler avec
la séquence de démarrage de votre système chaque fois que vous souhaitez aller
à une version différente de BRLTTY.
Ces problèmes se résolvent facilement en ajoutant un lien symbolique pour
l'exécutable.
<tscreen>ln -s /brltty-3.1/bin/brltty /bin/brltty</tscreen>
Quand il est temps d'utiliser la version la plus récente, pointez de nouveau
simplement le lien symbolique.
<tscreen>ln -s /brltty-3.2/bin/brltty /bin/brltty</tscreen>
Si vous aimez vraiment faire de la fantaisie, introduisez un autre niveau
de redirection de façon à rendre tous les fichiers de chaque version de BRLTTY
tels qu'ils sont dans tous les emplacements standards.
D'abord, créez un lien symbolique à travers un emplacement où on peut
repointer aisément à partir de chacun des emplacements standards de BRLTTY.
<tscreen><verb>
ln -s /brltty/bin/brltty /bin/brltty
ln -s /brltty/etc/brltty /etc/brltty
ln -s /brltty/lib/brltty /lib/brltty
</verb></tscreen>
Ensuite, tout ce que vous devez faire est de pointer <tt>/brltty</tt> vers la
version désirée.
<tscreen>ln -s /brltty-3.1 /brltty</tscreen>
<sect1>Disques racines d'Installation/Secours pour Linux<p>
BRLTTY peut s'exécuter comme un seul exécutable. Tout ce qu'il a besoin de
savoir peut être configuré explicitement lors de la compilation (voir
<ref id="build" name="Options de compilation">).
Si le répertoire de données (voir les options de compilation
<ref id="build-data-directory" name="--with-data-directory"> et
<ref id="build-execute-root" name="--with-execute-root">) n'existe pas, BRLTTY
cherche dans <tt>/etc</tt> les fichiers dont il a besoin.
Même si un de ces fichiers n'existe pas, BRLTTY fonctionne encore!
Si, pour une raison quelconque, vous avez déjà créé le répertoire de données
(habituellement, <tt>/etc/brltty</tt>) à la main, il est important de régler
ses permissions de telle sorte que seul le super-utilisateur puisse y créer des
fichiers.
<tscreen>chmod 755 /etc/brltty</tscreen>
Le périphérique d'inspection du contenu de l'écran (habituellement
<tt>/dev/vcsa</tt>) est nécessaire. Il devrait déjà exister, à moins que votre
distribution de Linux ne soit trop vieille. Si nécessaire, vous pouvez le créer
avec:
<tscreen><verb>
mknod /dev/vcsa c 7 128
chmod 660 /dev/vcsa
chown root.tty /dev/vcsa
</verb></tscreen>
Un problème souvent rencontré lorsqu'on essaie d'utiliser BRLTTY dans un
environnement instable, comme un disque racine ou un système incomplet, est
qu'il pourrait ne pas trouver les bibliothèques partagées (ou des parties
de celles-ci) dont il a besoin.
Les disques racines utilisent souvent des versions des bibliothèques
sous-paramétrées et/ou non à jour qui peuvent être inadéquates. La solution est de configurer BRLTTY avec l'optfon de
compilation <ref id="build-standalone-programs" name="--enable-standalone-programs">.
Cela supprime toutes les dépendances des bibliothèques partagées, mais
malheureusement, crée aussi un exécutable plus gros.
Il y a un certain nombre d'options de compilation que vous pouvez utiliser
pour supprimer de façon sélective les possibilités de BRLTTY dont vous n'avez pas
besoin de façon à atténuer ce problème (voir la section
<ref id="build-features" name="possibilitéés de la compilation">).
L'exécutable est nettoyé pendant le
<ref id="make-install" name="make install">. Cela réduit de façon
significative sa taille en supprimant sa table de symboles.
Vous obtiendrez un exécutable beaucoup plus petit, puis copiez-le de son emplacement
d'installation.
Cependant, si vous le copiez depuis le répertoire de compilation, n'oubliez pas de le nettoyer.
<tscreen>strip brltty</tscreen>
<sect1>Avancées futures<p>
Outre la réparation de bugs et le support de plus de types d'afficheurs
brailles, nous espérons, si le temps nous le permet, travailler sur:
<descrip>
<tag>Meilleure prise en charge des attributs</tag>
<itemize>
<item>Poursuite des attributs.
<item>Mode mixte texte et attributs.
</itemize>
<tag>Poursuite du défilement</tag>
Alignement de la plage braille sur une ligne alors qu'elle défile à
l'écran.
<tag>Meilleur support de voix</tag>
<itemize>
<item>Braille et voix mélangés pour une lecture plus rapide du texte.
<item>Meilleur navigation vocale.
<item>Plus de synthèses vocales.
</itemize>
<tag>Sous-régions sur l'écran</tag>
Ignorer le déplacement du curseur hors de la région, et rendre fluide les
limites de navigation aux bords de la région.
</descrip>
Voir le fichier <tt>TODO</tt> pour une liste plus complète.
<sect1>Bogues connus<p>
A l'heure où nous écrivons (décembre 2001), les problèmes suivants sont
connus.
La routine-curseur est considérée comme un sous-processus en boucle qui s'exécute
avec une priorité réduite pour éviter de trop utiliser le temps du processeur.
Les chargements de systèmes différents nécessitent des réglages différents de
ses paramètres. Ceux par défaut fonctionnent très bien dans un éditeur Unix
classique sur un système chargé normalement, mais très mal dans d'autres
situations, par exemple sur une liaison série lente vers un nom de machine
supprimé.
@@ -0,0 +1,144 @@
<!doctype linuxdoc system[
<!ENTITY introduction SYSTEM "Introduction.sgml">
<!ENTITY compilation SYSTEM "Compilation.sgml">
<!ENTITY utilisation SYSTEM "Utilisation.sgml">
<!ENTITY features SYSTEM "Features.sgml">
<!ENTITY translation SYSTEM "Translation.sgml">
<!ENTITY advanced SYSTEM "Advanced.sgml">
<!ENTITY displays SYSTEM "Displays.sgml">
<!ENTITY synthesizers SYSTEM "Synthesizers.sgml">
<!ENTITY drivers SYSTEM "Drivers.sgml">
<!ENTITY screen SYSTEM "Screen.sgml">
<!ENTITY syntaxe SYSTEM "Syntax.sgml">
<!ENTITY dots SYSTEM "Dots.sgml">
<!ENTITY nabcc SYSTEM "nabcc.sgml">
<!ENTITY fr2007 SYSTEM "fr-2007.sgml">
<!ENTITY midi SYSTEM "Midi.sgml">
]>
<article>
<titlepag>
<title>Manuel de référence de BRLTTY
<subtitle>Accès à l'écran d'une console pour les personnes non-voyantes utilisant des afficheurs braille
<author>
<name>Nikhil Nair <tt><htmlurl url="mailto:nn201@cus.cam.ac.uk" name="&lt;nn201@cus.cam.ac.uk&gt;"></tt>
<and>
<name>Nicolas Pitre <tt><htmlurl url="mailto:nico@fluxnic.net" name="&lt;nico@fluxnic.net&gt;"></tt>
<and>
<name>Stéphane Doyon <tt><htmlurl url="mailto:s.doyon@videotron.ca" name="&lt;s.doyon@videotron.ca&gt;"></tt>
<and>
<name>Dave Mielke <tt><htmlurl url="mailto:dave@mielke.cc" name="&lt;dave@mielke.cc&gt;"></tt>
<and>
<name>Traduction française
<and>
<name>
Jean-Philippe Mengual
<tt><htmlurl url="mailto:jmengual@linuxfromscratch.org" name="&lt;jmengual@linuxfromscratch.org&gt;"></tt>
pour
<tt><htmlurl url="http://www.traduc.org/" name="Traduc.org"></tt>
<date>Version 4.3, oct 2011
<abstract>
Copyright &copy; 1995-2012 by Les Développeurs de BRLTTY.
BRLTTY est un logiciel libre, et n'est fourni avec AUCUNE
GARANTIE. Il est placé sous les termes de la version 2 ou
ultérieure de la <bf>GNU General Public License</bf> publiée par
<bf>The Free Software Foundation</bf>.
</abstract>
</titlepag>
<toc>
<lof>
<lot>
<sect>Préambule<p>
<sect1>Licence<p>
Ce programme est un logiciel libre. Vous pouvez le redistribuer et/ou
le modifier sous les termes de la <htmlurl url="http://www.gnu.org/licenses/licenses.html#GPL" name="GNU General Public License">
stipulée par la <htmlurl url="http://www.gnu.org/fsf/fsf.html" name="Free Software Foundation">. Vous pouvez utiliser une version 2 (ou supérieure) de la licence.
Vous devriez avoir reçu une copie de la licence avec le
programme. Elle devrait être dans le fichier <tt/LICENSE-GPL/ du
répertoire principal. Si ce n'est pas le cas, écrivez à la Free Software
Foundation Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
<sect1>Mise en garde<p>
Ce programme est distribué avec l'espoir d'être utile, mais SANS
AUCUNE GARANTIE, même pas celle d'être COMMERCIALISABLE ou
de CONVENIR À UNE FINALITÉ EN PARTICULIER. Voir la <bf>GNU General
Public License</bf> pour plus de détails.
<sect1>Contacts<label id="contact"><p>
BRLTTY est le travail d'une équipe. Pour des informations actualisées,
voyez la page Web de BRLTTY sur [<htmlurl url="http://mielke.cc/brltty/" name="http://mielke.cc/brltty/">]. Ont
participé à ce document et au logiciel:
<itemize>
<item>
Dave Mielke (responsable, actif)
<descrip>
<tag/Web/<htmlurl url="http://mielke.cc/" name="http://mielke.cc/">
<tag/E-Mail/<htmlurl url="mailto:dave@mielke.cc" name="&lt;dave@mielke.cc&gt;">
</descrip>
<item>
Samuel Thibault (actif)
<descrip>
<tag/Web/<htmlurl url="http://dept-info.labri.fr/~thibault/" name="http://dept-info.labri.fr/~thibault/">
<tag/E-Mail/<htmlurl url="mailto:samuel.thibault@ens-lyon.org" name="&lt;samuel.thibault@ens-lyon.org&gt;">
</descrip>
<item>
Mario Lang (actif)
<descrip>
<tag/Web/<htmlurl url="http://delysid.org/" name="http://delysid.org/">
<tag/E-Mail/<htmlurl url="mailto:mlang@delysid.org" name="&lt;mlang@delysid.org&gt;">
</descrip>
<item>
Nicolas Pitre
<descrip>
<tag/Web/<htmlurl url="http://www.cam.org/~nico/" name="http://www.cam.org/~nico/">
<tag/E-Mail/<htmlurl url="mailto:nico@fluxnic.net" name="&lt;nico@fluxnic.net&gt;">
</descrip>
<item>
Stéphane Doyon
<descrip>
<tag/Web/<htmlurl url="http://pages.infinit.net/sdoyon/" name="http://pages.infinit.net/sdoyon/">
<tag/E-Mail/<htmlurl url="mailto:s.doyon@videotron.ca" name="&lt;s.doyon@videotron.ca&gt;">
</descrip>
<item>
Nikhil Nair (auteur)
<descrip>
<tag/E-Mail/<htmlurl url="mailto:nn201@cus.cam.ac.uk" name="&lt;nn201@cus.cam.ac.uk&gt;">
</descrip>
</itemize>
Toute question, tout commentaire, toute suggestions, critiques et contributions
sont les bienvenus. Même si nos adresses de messagerie sont listées ci-dessus,
le meilleur moyen de nous contacter est la liste de diffusion BRLTTY. Vous
pouvez poster sur la liste en envoyant votre message à
<htmlurl url="mailto:BRLTTY@mielke.cc" name="&lt;BRLTTY@mielke.cc&gt;">. Si
vous n'êtes pas abonné à la liste, vos messages seront soumis à l'approbation
du modérateur. Pour vous abonner, vous désabonner, modifier les paramètres de
voir les archives, etc, rendez-vous sur la page d'information de la liste, sur
<htmlurl url="http://mielke.cc/mailman/listinfo/brltty" name="http://mielke.cc/mailman/listinfo/brltty">.
&introduction
&compilation
&utilisation
&features
&translation
&advanced
&displays
&synthesizers
&drivers
&screen
&syntaxe
&dots
&nabcc
&fr2007
&midi
</article>
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,106 @@
<sect>Afficheurs braille supportés<label id="displays"><p>
BRLTTY supporte les afficheurs braille suivants:
<table loc="h">
<tabular ca="ll">
Nom|Modèles@<hline>
Albatross
|46/80@
Alva
|ABT (3nn)@
|Delphi (4nn)@
|Satellite (5nn)@
|Braille System 40@
|Braille Controller 640/680@
Baum
|Inka@
|Vario/RBT@
|SuperVario/Brailliant@
|PocketVario@
|VarioPro@
|EcoVario@
|VarioConnect/BrailleConnect@
|Refreshabraille@
BrailComm
|III@
BrailleLite
|18/40/M20/M40@
BrailleNote
|18/32@
BrlAPI@
CombiBraille
|25/45/85@
EcoBraille
|20/40/80@
EuroBraille
|AzerBraille@
|Clio@
|Iris@
|NoteBraille@
|Scriba@
|Esys 12/40@
FreedomScientific
|Focus 1 44/70/84@
|Focus 2 40/80@
|Focus Blue 40@
|PAC Mate 20/40@
HandyTech
|Modular 20/40/80@
|Modular Evolution 64/88@
|Active Braille@
|Braille Wave@
|Easy Braille@
|Braille Star 40/80@
|Bookworm@
|Braillino@
HIMS
|Braille Sense@
|SyncBraille@
Libbraille@
LogText
|32@
MDV
|MB208/MB408L/MB408S (protocol 5)@
Metec
|BD-40@
MiniBraille
|20@
MultiBraille
|MB125CR/MB145CR/MB185CR@
Papenmeier
|Compact 486@
|Compact/Tiny@
|IB 80 CR Soft@
|2D Lite (plus)@
|2D Screen Soft@
|EL 80@
|EL 2D 40/66/80@
|EL 40/66/70/80 S@
|EL 2D 80 S@
|EL 40 P@
|EL 80 II@
|Elba 20/32@
|Trio 40/Elba20/Elba32@
Pegasus
|20/27/40/80@
Seika
|40@
TSI
|Navigator 20/40/80@
|PowerBraille 40/65/80@
TTY
|terminfo@
VideoBraille
|40@
Virtual
|TCP/Unix, client/server@
VisioBraille
|20/40@
Voyager
|44/70@
|Part232 (adaptateur série)@
|BraillePen/EasyLink@
XWindow
|X11@
|Windows@
</tabular>
</table>
@@ -0,0 +1,27 @@
<sect>Convention standard du nombre de points brailles<label id="dots"><p>
Une cellule braille standard consiste en six points répartis en trois lignes
et deux colonnes.
Chaque point peut être identifié par son numéro, comme suit:
<descrip>
<tag>1</tag>En haut à gauche (ligne 1, colonne 1).
<tag>2</tag>Milieu gauche (ligne 2, colonne 1).
<tag>3</tag>Bas gauche (ligne 3, colonne 1).
<tag>4</tag>En haut droite (ligne 1, colonne 2).
<tag>5</tag>Milieu droite (ligne 2, colonne 2).
<tag>6</tag>Bas droite (ligne 3, colonne 2).
</descrip>
Le braille informatique a introduit une quatrième rangée en bas.
<descrip>
<tag>7</tag>Dessous gauche (ligne 4, colonne 1).
<tag>8</tag>Dessous droite (ligne 4, colonne 2).
</descrip>
Peut-être qu'une image rendra cette convention numérique plus facile à
comprendre.
<tscreen><verb>
1 o o 4
2 o o 5
3 o o 6
7 o o 8
</verb></tscreen>
@@ -0,0 +1,48 @@
<sect>Codes d'identification de pilote<label id="drivers"><p>
<table loc="h">
<tabular ca="ll">
Code|Name@<hline>
al|Alva@
at|Albatross@
ba|BrlAPI@
bc|BrailComm@
bc|BrailComm@
bl|BrailleLite@
bm|Baum (Native, HT, PB1, PB2)@
bn|BrailleNote@
cb|CombiBraille@
ec|EcoBraille@
es|eSpeak@
eu|EuroBraille@
fl|FestivalLite@
fs|FreedomScientific@
fv|Festival@
gs|GenericSay@
hm|HIMS@
ht|HandyTech@
il|IrisLinux@
lb|Libbraille@
lt|LogText@
mb|MultiBraille@
md|MDV@
mn|MiniBraille@
mp|Mikropuhe@
mt|Metec@
no|no driver@
pg|Pegasus@
pm|Papenmeier@
sd|SpeechDispatcher@
sk|Seika@
sw|Swift@
th|Theta@
ts|Telesensory Systems Inc.@
tt|TTY@
vd|VideoBraille@
vo|Voyager@
vr|Virtual@
vs|VisioBraille@
vv|ViaVoice@
xs|ExternalSpeech@
xw|XWindow@
</tabular>
</table>
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,166 @@
<sect>Introduction<p>
BRLTTY donne à un utilisateur brailliste un accès aux consoles texte
d'un système Linux/Unix. Il exécute un processus en arrière-plan
(démon) qui fait fonctionner l'afficheur braille, et
peut être démarré très tôt dans la séquence de démarrage du
système. Ainsi, il permet à un utilisateur brailliste, de prendre en main
facilement et de façon indépendante des aspects de l'administration du
système, comme l'entrée en mode mono-utilisateur, la restauration de systèmes de fichiers, et
l'analyse de problèmes de démarrage. Il facilite aussi beaucoup des
opérations de bases telles que l'identification.
BRLTTY reproduit une portion rectangulaire de l'écran (appelée
dans ce document `la fenêtre') sous forme de texte braille sur l'afficheur.
Vous pouvez utiliser des contrôles de l'affichage pour déplacer la fenêtre sur
l'écran, pour activer et désactiver des options de revue
variées, et pour exécuter des fonctions spéciales.
<sect1>Résumé des possibilités<p>
BRLTTY donne les possibilités suivantes:
<itemize>
<item>
Totale mise en oeuvre des facilités de revue d'écran habituelles.
<item>
Choix d'un curseur en forme de <tt>bloc</tt>, <tt>souligné</tt>, ou
<tt>aucun</tt>.
<item>
<tt>Soulignement</tt> possible pour indiquer un texte particulièrement
en surbrillance.
<item>
Utilisation possible du <tt>clignotement</tt> (fréquences réglables
individuellement) pour le curseur, le soulignement des caractères en
surbrillance, et/ou les lettres en majuscule.
<item>
Gel de l'écran pour en faire une relecture plus lente.
<item>
Routine-curseur intelligente, permettant un rapide
rapatriment du curseur dans les éditeurs de texte, les navigateurs
web, etc., sans bouger les mains de l'afficheur braille.
<item>
Une fonction copier-coller (linéaire ou rectangulaire) qui est
particulièrement utile pour la copie de longs noms de fichier, de
texte entre des terminaux virtuels, la saisie de commandes
compliquées, etc.
<item>
Gestion des tables de braille abrégé (fournie en anglais et en français).
<item>
Support pour de multiples codes braille.
<item>
Possibilité d'identifier un caractère inconnu.
<item>
Possibilité d'inspecter un caractère en surbrillance.
<item>
Une facilité dans l'aide en ligne pour les commandes de
l'afficheur braille.
<item>
Un menu préférences.
<item>
Support de synthèses basiques.
<item>
Une conception en modules permettant d'ajouter relativement
facilement d'autres afficheurs braille et d'autres synthèses
vocales.
<item>
Une Interface de programmation de l'Application.
</itemize>
<sect1>Système requis<p>
Actuellement, BRLTTY fonctionne sur Linux, Solaris, OpenBSD, FreeBSD,
NetBSD et Windows. Les portages sur d'autres systèmes d'exploitation
dérivés de Unix ne sont pas encore prévues, nous apprécierions vraiment
tout intérêt pour de tels projets.
<descrip>
<tag>Linux</tag>
Ce logiciel a été testé sur un grand nombre de systèmes Linux:
<itemize>
<item>
Ordinateurs de bureau, portables, et quelques PDAs.
<item>
Des processeurs 386SX20 à Pentium.
<item>
Une large échelle de capacité de mémoire.
<item>
Plusieurs distributions dont Debian, Red Hat, Slackware et SuSE.
<item>
La plupart des noyaux, dont les 1.2.13, 2.0, 2.2, et 2.4.
</itemize>
<tag>Solaris</tag>
Ce logiciel a été testé sur les systèmes Solaris suivants:
<itemize>
<item>
L'architecture Sparc (versions 7, 8, et 9).
<item>
L'architecture Intel (version 9).
</itemize>
<tag>OpenBSD</tag>
Ce logiciel a été testé sur les systèmes OpenBSD suivants:
<itemize>
<item>
L'architecture Intel (version 3.4).
</itemize>
<tag>FreeBSD</tag>
Ce logiciel a été testé sur les systèmes FreeBSD suivants:
<itemize>
<item>
L'architecture Intel (version 5.1).
</itemize>
<tag>NetBSD</tag>
Ce logiciel a été testé sur les systèmes NetBSD suivants:
<itemize>
<item>
L'architecture Intel (version 1.6).
</itemize>
<tag>Windows</tag>
Ce logiciel a été testé sur Windows 95, 98 et XP.
</descrip>
Sur Linux, BRLTTY peut inspecter le contenu de l'écran de façon
totalement indépendante de l'utilisateur. Cela est possible
grâce à l'utilisation d'un périphérique spécial offrant un accès
facile aux contenus de la console virtuelle courante. Ce périphérique
a été ajouté à la version 1.1.92 du noyau Linux, et s'appelle
normalement <tt>/dev/vcsa</tt> ou <tt>/dev/vcsa0</tt> (sur les systèmes
avec <tt>devfs</tt>, il s'appelle <tt>/dev/vcc/a</tt>). C'est pourquoi le noyau
Linux 1.1.92 ou supérieur est nécessaire si BRLTTY est utilisé de
cette façon. Cette possibilité:
<itemize>
<item>
Permet à BRLTTY d'être démarré très tôt dans la séquence de
démarrage du système.
<item>
Active l'afficheur braille pour qu'il soit totalement opérationnel
à l'invite de logging.
<item>
Facilite fortement pour un utilisateur brailliste
des tâches d'administration lors du démarrage.
</itemize>
Un correctif pour le programme <tt>d'écran</tt> est fourni (voir le sous-répertoire
<tt>Patches</tt>). Il permet à BRLTTY d'accéder à l'image d'un écran
via une mémoire partagée, et, ainsi, permet à BRLTTY d'être utilisé
beaucoup plus efficacement sur des plateformes qui n'ont pas leurs
propres facilité d'inspection du contenu de leur écran. La faiblesse
principale de cette approche de l'écran est que BRLTTY ne peut être
démarré tant que l'utilisateur n'est pas connecté.
BRLTTY ne fonctionne qu'avec des consoles et des applications basées
sur du texte. Il peut être utilisé avec les applications basées sur
<tt>curses</tt>, mais pas avec une application utilisant des caractéristiques
spéciales VGA ou qui requièrent une console graphique (comme le système X
Window).
Bien entendu, vous devez aussi posséder un afficheur braille supporté
(voir la section <ref id="displays" name="Afficheurs braille
supportés"> pour la liste complète). Nous espérons que des afficheurs
supplémentaires seront supportés dans le futur, donc si vous disposez de quelques
vagues informations de programmation techniques pour un pilote que
vous aimeriez voir supporté, faites-le nous savoir (voir la section
<ref id="contact" name="Contacts">).
Enfin, vous avez besoin d'outils pour compiler l'exécutable depuis le
source, <tt>make</tt>, les compilateurs <tt>C</tt> et <tt>C++</tt>, <tt>yacc</tt>,
<tt>awk</tt>, etc. Les outils de développement fournis avec les
distributions Unix standards devraient suffire. Si vous rencontrez des
problèmes, contactez-nous et nous vous compilerons un exécutable.
@@ -0,0 +1,149 @@
<sect>Table d'instruments MIDI<label id="midi"><p>
<table loc="h">
<tabular ca="lrl">
<hline>Piano
|0|Piano à queue accoustique@
|1|Piano accoustique brillant@
|2|Piano à queue électrique@
|3|Piano bastringue@
|4|Piano 1@
|5|Piano électrique 2@
|6|clavecin@
|7|Claviers@
<hline>Percussions chromatiques
|8|Célesta@
|9|Glockenspiel@
|10|Boîte à rythme@
|11|Vibraphone@
|12|Marimba@
|13|Xylophone@
|14|Tubular Bells@
|15|Dulcimer@
<hline>Orgue
|16|Orgue de barbarie@
|17|Orgue percussive@
|18|Orgue rock@
|19|Orgue d'église@
|20|Orgue de hanche@
|21|Accordéon@
|22|Harmonica@
|23|Accordéon de tango@
<hline>Guitare
|24|Guitare accoustique Nylon Acoustic Guitar@
|25|Guitare accoustique métal@
|26|Guitare électrique Jazz@
|27|Guitare électrique propre@
|28|Guitare électrique bouchée@
|29|Guitare overdriven@
|30|Distortion Guitar@
|31|Harmoniques de guitare@
<hline>Basse
|32|Basse accoustique@
|33|Basse électrique au doigt@
|34|Pick Electric Bass@
|35|Fretless Bass@
|36|Slap Bass 1@
|37|Slap Bass 2@
|38|Synth Bass 1@
|39|Synth Bass 2@
<hline>Pistons
|40|Violon@
|41|Alto@
|42|Violoncelle@
|43|Contrebasse@
|44|Pistons Tremolo@
|45|Pisstons pizzicato@
|46|Harpe Orchestrale@
|47|timbales@
<hline>Ensemble
|48|String Ensemble 1@
|49|String Ensemble 2@
|50|Synth Strings 1@
|51|Synth Strings 2@
|52|Aahs choeur@
|53|Oohs voix@
|54|Voice synthétique@
|55|Orchestra Hit@
<hline>Cuivre
|56|Trompette@
|57|Trombonne@
|58|Tuba@
|59|Trompette bouchée@
|60|Cor français@
|61|Section cuivre@
|62|Cuivre synthétique 1@
|63|Cuivre synthétique 2@
<hline>Anche
|64|Saxophone soprano@
|65|Saxophone Alto@
|66|Saxophone Tenor@
|67|Saxophone Bariton@
|68|Hautbois@
|69|Cor anglais@
|70|Basson@
|71|Clarinette@
<hline>Tuyau
|72|Piccolo@
|73|Flûte@
|74|Flûte à bec@
|75|Flûte de pan@
|76|Blown Bottle@
|77|Shakuhachi@
|78|Sifflet@
|79|Ocarina@
<hline>Synth Lead
|80|Lead 1 (square)@
|81|Lead 2 (dent de scie)@
|82|Lead 3 (calliope)@
|83|Lead 4 (chiff)@
|84|Lead 5 (charang)@
|85|Lead 6 (voix)@
|86|Lead 7 (cinquièmes)@
|87|Lead 8 (basse + lead)@
<hline>Synth Pad
|88|Pad 1 (nOuvel âge)@
|89|Pad 2 (chaud)@
|90|Pad 3 (polysynth)@
|91|Pad 4 (choeur)@
|92|Pad 5 (bowed)@
|93|Pad 6 (métalique)@
|94|Pad 7 (halo)@
|95|Pad 8 (sweep)@
<hline>Synth FM
|96|FX 1 (pluie)@
|97|FX 2 (soundtrack)@
|98|FX 3 (cristal)@
|99|FX 4 (atmosphère)@
|100|FX 5 (brightness)@
|101|FX 6 (goblins)@
|102|FX 7 (échos)@
|103|FX 8 (science-fiction)@
<hline>Ethnic
|104|Sitar@
|105|Banjo@
|106|Shamisen@
|107|Koto@
|108|Kalimba@
|109|Bag Pipe@
|110|Fiddle@
|111|Shanai@
<hline>Percussive
|112|Tinkle Bell@
|113|Agogo@
|114|Steel Drum@
|115|Wooden Block@
|116|Taiko Drum@
|117|Melodic Tom@
|118|Synth Drum@
|119|Reverse Cymbal@
<hline>Effets sonores
|120|Bruit de touche de guitare@
|121|Bruit de souffle@
|122|Bord de mer@
|123|Bruit d'oiseau@
|124|Sonnerie de télphone@
|125|Helicoptère@
|126|Applaudissements@
|127|Gunshot@
</tabular>
</table>
@@ -0,0 +1,23 @@
<sect>Pilotes d'écran supportés <label id="screen"><p>
BRLTTY supporte les pilotes d'écran suivants:
<descrip>
<tag/as/
AT-SPI
<tag/hd/
Ce pilote fournit un accès direct à l'écran d'une console Hurd.
Il n'est sélectionnable et par défaut oque sur les systèmes Hurd.
<tag/lx/
Ce pilote fournit un accès direct à l'écran d'une console Linux
Il n'est sélectionnable et par défaut oque sur les systèmes Linux.
<tag/sc/
Ce pilote fournit un accès direct au programme <tt/screen/.
Vous pouvez le sélectionner sur tous les systèmes, et il l'est par défaut
si aucun pilote d'écran d'origine n'est disponible. Vous devez appliquer le
correctif de <tt/screen/ que nous fournissons (voir le sous-répertoire
<tt/Patches/ ). Du fait que screen doit être exécuté simultanément,
l'utilisation de ce pilote rend BRLTTY opérationnel uniquement après que
l'utilisateur s'est identifié.
<tag/wn/
Ce pilote fournit un accès direct à l'écran d'une console Windows.
Il n'est sélectionnable et par défaut que sur les systèmes Windows/Cygwin.
</descrip>
@@ -0,0 +1,110 @@
<sect>Syntaxe des opérateurs<p>
<sect1>Spécification de pilote<label id="operand-driver"><p>
Vous devez spécifier un pilote pour un afficheur braille ou une synthèse vocale
via les deux lettres de son
<ref id="drivers" name="Code d'identification de pilote">.
Vous pouvez spécifier une liste de pilotes délimités par des virgules. Dans
ce cas, une détection automatique s'effectue en utilisant chaque pilote listé dans la
séquence.
Il se peut que vous soyez obligé de faire des essais afin de déterminer l'ordre le plus
fiable, étant donné que certains pilotes se détectent mieux automatiquement que d'autres.
Si vous ne spécifiez que le mot <tt>auto</tt>, la détection automatique s'effectue
en n'utilisant que les pilotes connus pour leur fiabilité dans le but
recherché.
<sect1>Spécification du périphérique braille<label id="operand-braille-device"><p>
La forme générale de la spécification d'un périphérique braille (voir l'option
<ref id="options-braille-device" name="-d"> en ligne de commande, la ligne
<ref id="configure-braille-device" name="braille-device"> du fichier de
configuration, et l'option de compilation
<ref id="build-braille-device" name="--with-braille-device">) est
<tt>qualificateur:</tt><em>donnée</em>.
Par compatibilité entre d'anciennes versions et les plus récentes, si vous ommettez
le qualificateur c'est <tt>serial:</tt> qui est utilisé.
Les types de périphérique suivants sont supportés:
<descrip>
<tag>Bluetooth</tag>
Pour un périphérique bluetooth, spécifiez <tt>bluetooth:</tt><em>addresse</em>
?vous pouvez aussi utiliser bt: et bluez: ).
L'adresse doit se composer de six nombres hexadécimaux à deux chiffres
séparés par des "deux-points", par exemple <tt>01:23:45:67:89:AB</tt>.
<tag>Série</tag>
Pour un périphérique en port série, spécifiez
<tt>serial:</tt><em>/chemin/vers/peripherique</em>. Le qualificateur <tt>serial:</tt>
est facultatif (pour compatibilité). Si vous donnez un chemin
relatif, il est déterminé par rapport à <tt>/dev</tt> (l'emplacement habituel
où les périphériques sont définis sur un système de type Unix).
Les spécifications de périphérique suivantes se réfèrent toutes au port
série 1 sur Linux:
<itemize>
<item><tt>serial:/dev/ttyS0</tt>
<item><tt>serial:ttyS0</tt>
<item><tt>/dev/ttyS0</tt>
<item><tt>ttyS0</tt>
</itemize>
<tag>USB</tag>
Pour un périphérique USB, spécifiez <tt>usb:</tt>. BRLTTY cherchera le premier
périphérique USB qui entraîne l'utilisation du pilote d'afficheur braille.
Par exemple, si vous avez plus d'un afficheur braille USB nécessitant le
même pilote, vous pouvez affiner la spécification de pilote en y affectant
le numéro de série de l'afficheur, comme par exemple <tt>usb:12345</tt>.
N.B.: La possibilité "identification par le numéro de série" ne
fonctionne pas avec certains modèles car certains fabricants, soit
n'indiquent pas la description du numéro de série, soit l'indiquent
mais pas en une valeur unique.
</descrip>
Vous pouvez spécifier une liste de pilotes délimités par des virgules. Dans
ce cas, une détection automatique s'effectue en utilisant chaque pilote listé dans la
séquence. Cette possibilité est particulièrement utile si vous avez un
afficheur braille à plusieurs interfaces, par exemple un port série et un USB.
Dans ce cas, il est en général préférable de lister d'abord le port USB, comme
par exemple <tt>usb:,serial:/dev/ttyS0</tt>, étant donné que l'ancien a
tendance à être mieux détecté que le plus récent.
<sect1>Spécification d'un périphérique PCM<label id="operand-pcm-device"><p>
Dans la plupart des cas, le périphériqve PCM est le chemin complet vers un
périphérique du système approprié. Les exceptions sont:
<descrip>
<tag>ALSA</tag>
Le nom et ses arguments pour le périphérique logique ou physique, comme
<em>nom</em>[<tt>:</tt><em>argument</em><tt>,</tt>...].
</descrip>
Le périphérique PCM par défaut est:
<table loc="h">
<tabular ca="ll">
Plateforme|Périphérique@<hline>
FreeBSD|/dev/dsp@
Linux/ALSA|hw:0,0@
Linux/OSS|/dev/dsp@
NetBSD|/dev/audio@
OpenBSD|/dev/audio@
Qnx|le périphérique de sortie PCM préféré@
Solaris|/dev/audio@
</tabular>
</table>
<sect1>Spécification de périphérique MIDI<label id="operand-midi-device"><p>
Dans la plupart des cas, le périphérique MIDI est le chemin complet vers un
périphérique du système approprié. Les exceptions sont:
<descrip>
<tag>ALSA</tag>
Le client et le port séparés par "deux-points" tel que
<em>client</em><tt>:</tt><em>port</em>.
Vous pouvez spécifier chacun soit comme un nombre soit comme une
sous-chaîne sensible à la casse de son nom.
</descrip>
Le périphérique MIDI par défaut est:
<table loc="h">
<tabular ca="ll">
Plateforme|Périphérique@<hline>
Linux/ALSA|le premier port de sortie MIDI disponible@
Linux/OSS|/dev/sequencer@
</tabular>
</table>
@@ -0,0 +1,31 @@
<sect>Synthèses vocales supportées<label id="synthesizers"><p>
BRLTTY supporte les synthèses vocales suivantes:
<table loc="h">
<tabular ca="ll">
Nom|Modèle@<hline>
Alva
|Delphi (4nn)@
BrailleLite
|@
CombiBraille
|@
eSpeak
|text to speech engine@
ExternalSpeech
|exécute /usr/local/bin/externalspeech@
Festival
|text to speech engine@
FestivalLite
|text to speech engine@
GenericSay
|redirige vers /usr/local/bin/say@
Mikropuhe
|text to speech engine@
Swift
|text to speech engine@
Theta
|text to speech engine@
ViaVoice
|text to speech engine@
</tabular>
</table>
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,257 @@
<sect>Table française unifiée<label id="nabcc"><p>
<tscreen><verb>
Num Hex Points Description
+-------------------------------------------------------------------------+
| 0 00 [ 32145 8] code nul |
| 1 01 [73214 68] début de lecture |
| 2 02 [ 21 5 8] début de texte |
| 3 03 [ 3214 68] fin de texte |
| 4 04 [7 145 8] fin de transmission |
| 5 05 [ 1 5 8] ENQUIRY |
| 6 06 [7 214 8] Connaissance |
| 7 07 [ 2145 8] son (bell) |
| 8 08 [7 21 5 8] effacement |
| 9 09 [7 214 68] tabulation |
| 10 0A [ 2 4568] LINE FEED (LF) |
| 11 0B [ 3 1 8] tabulation |
| 12 0C [7321 8] pied FORM FEED (FF) |
| 13 0D [73 14 8] retour chariot |
| 14 0E [ 3 145 8] SHIFT OUT |
| 15 0F [ 32 68] SHIFT IN |
| 16 10 [73214 8] échapper lien noir |
| 17 11 [732145 8] contrôle de périphérique 1 |
| 18 12 [7321 5 8] contrôle de périphérique 2 |
| 19 13 [732 4 8] contrôle de périphérique 3 |
| 20 14 [732 45 8] contrôle de périphérique 4 |
| 21 15 [73 1 6 8] Connaissance négative |
| 22 16 [7321 68] [SYNCHRONOUS IDLE] |
| 23 17 [7 2 4568] fin du bloc de transmission |
| 24 18 [73 14 68] annule | |
| 25 19 [ 321 68] fin du milieu |
| 26 1A [7 1 568] remplacer |
| 27 1B [7 21 568] échappement |
| 28 1C [7 14 68] séparateur 4 |
| 29 1D [7 21 68] séparateur 3 |
| 30 1E [732 5 ] séparateur 2 |
| 31 1F [732 6 ] flèche droite |
| 32 20 [ ] espace |
| 33 21 [ 32 5 ] point d'exclamation |
| 34 22 [ 32 56 ] guillemet |
| 35 23 [ 3 4568] dièse |
| 36 24 [73 5 ] dollar |
| 37 25 [ 3 4 68] pour cent |
| 38 26 [ 3214568] e commercial |
| 39 27 [ 3 ] apostrophe |
| 40 28 [ 32 6 ] parenthèse ouvrant |
| 41 29 [ 3 56 ] parenthèse fermant |
| 42 2A [ 3 5 ] astérisque (étoile) |
| 43 2B [732 5 8] plus |
| 44 2C [ 2 ] virgule | |
| 45 2D [ 3 6 ] tiret |
| 46 2E [ 2 56 ] point |
| 47 2F [ 3 4 ] barre oblique |
| 48 30 [ 3 456 ] zéro |
| 49 31 [ 1 6 ] un |
| 50 32 [ 21 6 ] deux |
| 51 33 [ 14 6 ] trois |
| 52 34 [ 1456 ] quatre |
| 53 35 [ 1 56 ] cinq |
| 54 36 [ 214 6 ] six |
| 55 37 [ 21456 ] sept |
| 56 38 [ 21 56 ] huit |
| 57 39 [ 2 4 6 ] neuf |
| 58 3A [ 2 5 ] deux-points |
| 59 3B [ 32 ] inférieur |
| 60 3C [ 32 8] inférieur |
| 61 3D [732 568] égal |
| 62 3E [7 56 ] supérieur |
| 63 3F [ 2 6 ] point d'interrogation |
| 64 40 [ 3 45 ] arrobas |
| 65 41 [7 1 ] a majuscule |
| 66 42 [7 21 ] b majuscule |
| 67 43 [7 14 ] c majuscule |
| 68 44 [7 145 ] d majuscule |
| 69 45 [7 1 5 ] e majuscule |
| 70 46 [7 214 ] f majuscule |
| 71 47 [7 2145 ] g majuscule |
| 72 48 [7 21 5 ] h majuscule |
| 73 49 [7 2 4 ] i majuscule |
| 74 4A [7 2 45 ] j majuscule |
| 75 4B [73 1 ] k majuscule |
| 76 4C [7321 ] l majuscule |
| 77 4D [73 14 ] m majuscule |
| 78 4E [73 145 ] n majuscule |
| 79 4F [73 1 5 ] o majuscule |
| 80 50 [73214 ] p majuscule |
| 81 51 [732145 ] q majuscule |
| 82 52 [7321 5 ] r majuscule |
| 83 53 [732 4 ] s majuscule |
| 84 54 [732 45 ] t majuscule |
| 85 55 [73 1 6 ] u majuscule |
| 86 56 [7321 6 ] v majuscule |
| 87 57 [7 2 456 ] w majuscule |
| 88 58 [73 14 6 ] x majuscule |
| 89 59 [73 1456 ] y majuscule |
| 90 5A [73 1 56 ] z majuscule |
| 91 5B [732 68] crochet ouvrant |
| 92 5C [ 3 4 8] barre oblique inversée |
| 93 5D [73 568] crochet fermant |
| 94 5E [ 4 ] accent circonflexe |
| 95 5F [7 5 8] souligné |
| 96 60 [ 6 ] accent grave |
| 97 61 [ 1 ] a minuscule |
| 98 62 [ 21 ] b minuscule |
| 99 63 [ 14 ] c minuscule |
| 100 64 [ 145 ] d minuscule |
| 101 65 [ 1 5 ] e minuscule |
| 102 66 [ 214 ] f minuscule |
| 103 67 [ 2145 ] g minuscule |
| 104 68 [ 21 5 ] h minuscule |
| 105 69 [ 2 4 ] i minuscule |
| 106 6A [ 2 45 ] j minuscule |
| 107 6B [ 3 1 ] k minuscule |
| 108 6C [ 321 ] l minuscule |
| 109 6D [ 3 14 ] m minuscule |
| 110 6E [ 3 145 ] n minuscule |
| 111 6F [ 3 1 5 ] o minuscule |
| 112 70 [ 3214 ] p minuscule |
| 113 71 [ 32145 ] q minuscule |
| 114 72 [ 321 5 ] r minuscule |
| 115 73 [ 32 4 ] s minuscule |
| 116 74 [ 32 45 ] t minuscule |
| 117 75 [ 3 1 6 ] u minuscule |
| 118 76 [ 321 6 ] v minuscule |
| 119 77 [ 2 456 ] w minuscule |
| 120 78 [ 3 14 6 ] x minuscule |
| 121 79 [ 3 1456 ] y minuscule |
| 122 7A [ 3 1 56 ] z minuscule |
| 123 7B [732 8] ouvre accolade |
| 124 7C [ 4568] barre verticale |
| 125 7D [7 568] ferme accolade |
| 126 7E [ 3 8] tilde minuscule |
| 127 7F [ 321 8] effacement |
| 128 20AC [7 1 5 8] euro |
| 129 201A [7 6 ] guillemet bas simple |
| 130 0192 [ 214 8] florin |
| 131 201E [ 56 ] guillemet bas double |
| 132 2026 [ 3 68] points de suspension |
| 133 2020 [ 3 568] obel |
| 134 2021 [73 56 ] double obel |
| 135 2C6 [ 4 8] circonflexe minuscule |
| 136 2030 [73 4 68] pour mille |
| 137 0160 [732 4 68] s carron majuscule |
| 138 2039 [7 5 ] guillemet fermant |
| 139 0152 [7 2 4 6 ] e dans o majuscule |
| 140 017D [73 1 568] z carron majuscule |
| 141 2018 [ 68] guillemet simple ouvrant |
| 142 2019 [73 ] guillemet simple fermant |
| 143 201C [73 8] guillemet double ouvrant |
| 144 201D [7 68] guillemett double fermant |
| 145 2022 [7 2145 8] puce |
| 146 2013 [7 4 8] tiret cadre atteint |
| 147 2014 [7 45 8] tiret EM |
| 148 02DC [7 4 6 ] tilde minuscule |
| 149 2122 [ 32 45 8] marque déposée |
| 150 0161 [ 32 4 68] s avec carron minuscule |
| 151 203A [ 5 8] guillemet ouvrant |
| 152 0153 [ 2 4 68] e dans o minuscule |
| 153 017E [73 1 568] z carron minuscule |
| 154 0178 [7 14568] y tréma majuscule |
| 160 A0 [7 ] espace insécable (forcé) |
| 161 A1 [ 32 5 8] point d'exclamation inversé |
| 162 A2 [7 14 8] cent |
| 163 A3 [732 ] livre |
| 164 A4 [ 45 ] devise |
| 165 A5 [7 2 568] yen |
| 166 A6 [ 45 8] trait coupé vertical |
| 167 A7 [ 3214 8] paragraphe |
| 168 A8 [ 4 6 ] tréma |
| 169 A9 [ 14 8] copyright |
| 170 AA [7 1 68] ordinal féminin |
| 171 AB [ 32 568] guillemet français ouvrant |
| 172 AC [7 2 56 ] négation logique |
| 173 AD [7 8] trait d'union conditionne |
| 174 AE [ 321 5 8] marque déposée |
| 175 AF [ 3 14 8] macron |
| 176 B0 [7 2 6 ] degré |
| 177 B1 [73 68] plus ou moins |
| 178 B2 [7 45 ] carré (puissance 2) |
| 179 B3 [7 456 ] cube (puissance 3) |
| 180 B4 [ 5 ] accent aigu |
| 181 B5 [7 2 5 ] micro |
| 182 B6 [7 4568] pied de mouche |
| 183 B7 [ 8] point médiant |
| 184 B8 [ 456 ] cédille |
| 185 B9 [7 4 ] exposant |
| 186 BA [7 2 68] ordinal masculin |
| 187 BB [732 56 ] guillemetts français fermant |
| 188 BC [ 3 1 68] un quart |
| 189 BD [ 4 68] un demi |
| 190 BE [ 3 14 68] trois quart |
| 191 BF [ 2 68] point d'interrogation inversé |
| 192 C0 [7321 56 ] a grave majuscule |
| 193 C1 [7321 568] a aigu majuscule |
| 194 C2 [7 1 6 ] a circonflexe majuscule |
| 195 C3 [7 1 8] a tilde majuscule |
| 196 C4 [73 456 ] a tréma majuscule |
| 197 C5 [7 2 ] a avec rond au-dessus majuscule |
| 198 C6 [73 45 ] a e majuscule |
| 199 C7 [73214 6 ] c cédille majuscule |
| 200 C8 [732 4 6 ] e grave majuscule |
| 201 C9 [7321456 ] e aigu majuscule |
| 202 CA [7 21 6 ] e circonflexe majuscule |
| 203 CB [7 214 6 ] e tréma majuscule |
| 204 CC [7 2 4 8] i grave majuscule |
| 205 CD [73 4 ] i aigu majuscule |
| 206 CE [7 14 6 ] i circonflexe majuscule |
| 207 CF [7 21456 ] i tréma majuscule |
| 208 D0 [7 21 8] Eth majuscule |
| 209 D1 [73 145 8] n tilde majuscule |
| 210 D2 [73 1 5 8] o grave majuscule |
| 211 D3 [73 4 6 ] o aigu majuscule |
| 212 D4 [73 1456 ] o circonflexe majuscule |
| 213 D5 [73 1 8] o tilde majuscule |
| 214 D6 [7 2 4 68] o tréma majuscule |
| 215 D7 [73 5 8] multipilé par |
| 216 D8 [73 4568] o barré majuscule |
| 217 D9 [732 456 ] u grave majuscule |
| 218 DA [732 4568] u aigu majuscule |
| 219 DB [7 1 56 ] u circonflexe majuscule |
| 220 DC [7 21 56 ] u tréma majuscule |
| 221 DD [73 14568] y aigu majuscule |
| 222 DE [ 2 45 8] Thorn majuscule |
| 223 DF [ 32 4 8] szeth |
| 224 E0 [ 321 56 ] a grave minuscule |
| 225 E1 [ 321 568] a aigu minuscule |
| 226 E2 [ 1 68] a circonflexe minuscule |
| 227 E3 [ 1 8] a qilde minuscule |
| 228 E4 [73 45 8] a tréma minuscule |
| 229 E5 [ 2 8] a avec rond en tête minuscule |
| 230 E6 [ 3 45 8] a e minuscule |
| 231 E7 [ 3214 6 ] c cédille minuscule |
| 232 E8 [ 32 4 6 ] e grave minuscule |
| 233 E9 [ 321456 ] e aigu minuscule |
| 234 EA [ 21 68] e circonflexe minuscule |
| 235 EB [ 214 68] e tréma minuscule |
| 236 EC [ 2 4 8] i grave minuscule |
| 237 ED [73 4 8] i aigu minuscule |
| 238 EE [ 14 68] i circonflexe minuscule |
| 239 EF [ 214568] i tréma minuscule |
| 240 F0 [ 21 8] Eth minuscule |
| 241 F1 [7 214568] n tilde minuscule |
| 242 F2 [ 3 1 5 8] o grave minuscule |
| 243 F3 [ 3 4 6 ] o aigu minuscule |
| 244 F4 [ 14568] o circonflexe minuscule |
| 245 F5 [7 4 68] o tilde minuscule |
| 246 F6 [ 3 5 8] o tréma minuscule |
| 247 F7 [7 2 5 8] divisé par |
| 248 F8 [ 568] o barré minuscule |
| 249 F9 [ 32 456 ] u grave minuscule |
| 250 FA [ 32 4568] u aigu minuscule |
| 251 FB [ 1 568] u circonflexe minuscule |
| 252 FC [ 21 568] u tréma minuscule |
| 253 FD [ 3 14568] y aigu minuscule |
| 254 FE [ 2 45 8] thorn minuscule |
| 255 FF [ 2 568] y tréma minuscule |
+-------------------------------------------------------------------------+
</verb></tscreen>
@@ -0,0 +1,262 @@
<sect>Code informatique braille Nord Américain<label id="nabcc"><p>
<tscreen><verb>
Num Hex Points Description
+-----------------------------------------------------------------+
| 0 00 [7 4 8] NUL (null) |
| 1 01 [7 1 8] SOH (start of header) |
| 2 02 [7 21 8] STX (start of text) |
| 3 03 [7 14 8] ETX (end of text) |
| 4 04 [7 145 8] EOT (end of transmission) |
| 5 05 [7 1 5 8] ENQ (enquiry) |
| 6 06 [7 214 8] ACK (acknowledge) |
| 7 07 [7 2145 8] BEL (bell) |
| 8 08 [7 21 5 8] BS (back space) |
| 9 09 [7 2 4 8] HT (horizontal tab) |
| 10 0A [7 2 45 8] LF (line feed) |
| 11 0B [73 1 8] VT (vertical tab) |
| 12 0C [7321 8] FF (form feed) |
| 13 0D [73 14 8] CR (carriage return) |
| 14 0E [73 145 8] SO (shift out) |
| 15 0F [73 1 5 8] SI (shift in) |
| 16 10 [73214 8] DLE (data link escape) |
| 17 11 [732145 8] DC1 (direct control 1) |
| 18 12 [7321 5 8] DC2 (direct control 2) |
| 19 13 [732 4 8] DC3 (direct control 3) |
| 20 14 [732 45 8] DC4 (direct control 4) |
| 21 15 [73 1 68] NAK (negative acknowledge) |
| 22 16 [7321 68] SYN (synchronize) |
| 23 17 [7 2 4568] ETB (end of text block) |
| 24 18 [73 14 68] CAN (cancel) |
| 25 19 [73 14568] EM (end of medium) |
| 26 1A [73 1 568] SUB (substitute) |
| 27 1B [7 2 4 68] ESC (escape) |
| 28 1C [7 21 568] FS (file separator) |
| 29 1D [7 214568] GS (group separator) |
| 30 1E [7 45 8] RS (record separator) |
| 31 1F [7 4568] US (unit separator) |
| 32 20 [ ] space |
| 33 21 [ 32 4 6 ] exclamation point |
| 34 22 [ 5 ] quotation mark |
| 35 23 [ 3 456 ] number sign |
| 36 24 [ 214 6 ] signe dollar |
| 37 25 [ 14 6 ] signe pour cent |
| 38 26 [ 3214 6 ] ampersand |
| 39 27 [ 3 ] accent aigu |
| 40 28 [ 321 56 ] left parenthesis |
| 4 291 [ 32 456 ) right parenthesis |
| 42 2A [ 1 6 ] asterisk |
| 43 2B [ 3 4 6 ] plus sign |
| 44 2C [ 6 ] comma |
| 45 2D [ 3 6 ] minus sign |
| 46 2E [ 4 6 ] period |
| 47 2F [ 3 4 ] forward slash |
| 48 30 [ 3 56 ] zero |
| 49 31 [ 2 ] one |
| 50 32 [ 32 ] two |
| 51 33 [ 2 5 ] three |
| 52 34 [ 2 56 ] four |
| 53 35 [ 2 6 ] five |
| 54 36 [ 32 5 ] six |
| 55 37 [ 32 56 ] seven |
| 56 38 [ 32 6 ] eight |
| 57 39 [ 3 5 ] nine |
| 58 3A [ 1 56 ] colon |
| 59 3B [ 56 ] semicolon |
| 60 3C [ 21 6 ] less-than sign |
| 61 3D [ 321456 ] equals sign |
| 62 3E [ 3 45 ] greater-than sign |
| 63 3F [ 1456 ] question mark |
| 64 40 [7 4 ] commercial at |
| 65 41 [7 1 ] capital a |
| 66 42 [7 21 ] capital b |
| 67 43 [7 14 ] capital c |
| 68 44 [7 145 ] capital d |
| 69 45 [7 1 5 ] capital e |
| 70 46 [7 214 ] capital f |
| 71 47 [7 2145 ] capital g |
| 72 48 [7 21 5 ] capital h |
| 73 49 [7 2 4 ] capital i |
| 74 4A [7 2 45 ] capital j |
| 75 4B [73 1 ] capital k |
| 76 4C [7321 ] capital l |
| 77 4D [73 14 ] capital m |
| 78 4E [73 145 ] capital n |
| 79 4F [73 1 5 ] capital o |
| 80 50 [73214 ] capital p |
| 81 51 [732145 ] capital q |
| 82 52 [7321 5 ] capital r |
| 83 53 [732 4 ] capital s |
| 84 54 [732 45 ] capital t |
| 85 55 [73 1 6 ] capital u |
| 86 56 [7321 6 ] capital v |
| 87 57 [7 2 456 ] capital w |
| 88 58 [73 14 6 ] capital x |
| 89 59 [73 1456 ] capital y |
| 90 5A [73 1 56 ] capital z |
| 91 5B [7 2 4 6 ] left bracket |
| 92 5C [7 21 56 ] backward slash |
| 93 5D [7 21456 ] right bracket |
| 94 5E [7 45 ] circumflex accent |
| 95 5F [ 456 ] underscore |
| 96 60 [ 4 ] grave accent |
| 97 61 [ 1 ] small a |
| 98 62 [ 21 ] small b |
| 99 63 [ 14 ] small c |
| 100 64 [ 145 ] small d |
| 101 65 [ 1 5 ] small e |
| 102 66 [ 214 ] small f |
| 103 67 [ 2145 ] small g |
| 104 68 [ 21 5 ] small h |
| 105 69 [ 2 4 ] small i |
| 106 6A [ 2 45 ] small j |
| 107 6B [ 3 1 ] small k |
| 108 6C [ 321 ] small l |
| 109 6D [ 3 14 ] small m |
| 110 6E [ 3 145 ] small n |
| 111 6F [ 3 1 5 ] small o |
| 112 70 [ 3214 ] small p |
| 113 71 [ 32145 ] small q |
| 114 72 [ 321 5 ] small r |
| 115 73 [ 32 4 ] small s |
| 116 74 [ 32 45 ] small t |
| 117 75 [ 3 1 6 ] small u |
| 118 76 [ 321 6 ] small v |
| 119 77 [ 2 456 ] small w |
| 120 78 [ 3 14 6 ] small x |
| 121 79 [ 3 1456 ] small y |
| 122 7A [ 3 1 56 ] small z |
| 123 7B [ 2 4 6 ] left brace |
| 124 7C [ 21 56 ] vertical bar |
| 125 7D [ 21456 ] right brace |
| 126 7E [ 45 ] tilde accent |
| 127 7F [7 456 ] DEL (delete) |
| 128 80 [ 4 8] <control> |
| 129 81 [ 1 8] <control> |
| 130 82 [ 21 8] BPH (break permitted here) |
| 131 83 [ 14 8] NBH (no break here) |
| 132 84 [ 145 8] <control> |
| 133 85 [ 1 5 8] NL (next line) |
| 134 86 [ 214 8] SSA (start of selected area) |
| 135 87 [ 2145 8] ESA (end of selected area) |
| 136 88 [ 21 5 8] CTS (character tabulation set) |
| 137 89 [ 2 4 8] CTJ (character tabulation justification) |
| 138 8A [ 2 45 8] LTS (line tabulation set) |
| 139 8B [ 3 1 8] PLD (partial line down) |
| 140 8C [ 321 8] PLU (partial line up) |
| 141 8D [ 3 14 8] RLF (reverse line feed) |
| 142 8E [ 3 145 8] SS2 (single shift two) |
| 143 8F [ 3 1 5 8] SS3 (single shift three) |
| 144 90 [ 3214 8] DCS (device control string) |
| 145 91 [ 32145 8] PU1 (private use one) |
| 146 92 [ 321 5 8] PU2 (private use two) |
| 147 93 [ 32 4 8] STS (set transmit state) |
| 148 94 [ 32 45 8] CC (cancel character) |
| 149 95 [ 3 1 68] MW (message waiting) |
| 150 96 [ 321 68] SGA (start of guarded area) |
| 151 97 [ 2 4568] EGA (end of guarded area) |
| 152 98 [ 3 14 68] SS (start of string) |
| 153 99 [ 3 14568] <control> |
| 154 9A [ 3 1 568] SCI (single character introducer) |
| 155 9B [ 2 4 68] CSI (control sequence introducer) |
| 156 9C [ 21 568] ST (string terminator) |
| 157 9D [ 214568] OSC (operating system command) |
| 158 9E [ 45 8] PM (privacy message) |
| 159 9F [ 4568] APC (application program command) |
| 160 A0 [7 8] no-break space |
| 161 A1 [732 4 6 ] inverted exclamation mark |
| 162 A2 [7 214 6 ] cent sign |
| 163 A3 [73 456 ] pound sign |
| 164 A4 [7 14 6 ] currency sign |
| 165 A5 [73214 6 ] yen sign |
| 166 A6 [7 1 56 ] broken bar |
| 167 A7 [73 5 ] section sign |
| 168 A8 [7 5 ] diaeresis |
| 169 A9 [732 56 ] copyright sign |
| 170 AA [ 8] feminine ordinal indicator |
| 171 AB [7 21 6 ] left-pointing double angle quotation mark |
| 172 AC [7 2 56 ] not sign |
| 173 AD [73 6 ] soft hyphen |
| 174 AE [732 6 ] registered sign |
| 175 AF [7 2 6 ] macron |
| 176 B0 [73 56 ] degree sign |
| 177 B1 [73 4 6 ] plus-minus sign |
| 178 B2 [732 ] superscript two |
| 179 B3 [7 2 5 ] superscript three |
| 180 B4 [73 ] acute accent |
| 181 B5 [7 56 ] micro sign |
| 182 B6 [732 5 ] pilcrow sign |
| 183 B7 [7 4 6 ] middle dot |
| 184 B8 [7 6 ] cedilla |
| 185 B9 [7 2 ] superscript one |
| 186 BA [7 ] masculine ordinal indicator |
| 187 BB [73 45 ] right-pointing double angle quotation mark |
| 188 BC [7321 56 ] vulgar fraction one quarter |
| 189 BD [7321456 ] vulgar fraction one half |
| 190 BE [732 456 ] vulgar fraction three quarters |
| 191 BF [7 1456 ] inverted question mark |
| 192 C0 [732 5 8] capital a grave |
| 193 C1 [7 1 68] capital a acute |
| 194 C2 [7 2 8] capital a circumflex |
| 195 C3 [7 5 8] capital a tilde |
| 196 C4 [73214 68] capital a diaeresis |
| 197 C5 [73 45 8] capital a ring above |
| 198 C6 [73 8] capital ae |
| 199 C7 [73 4 68] capital c cedilla |
| 200 C8 [732 568] capital e grave |
| 201 C9 [7 21 68] capital e acute |
| 202 CA [732 8] capital e circumflex |
| 203 CB [73214568] capital e diaeresis |
| 204 CC [732 68] capital i grave |
| 205 CD [7 14 68] capital i acute |
| 206 CE [7 2 5 8] capital i circumflex |
| 207 CF [7321 568] capital i diaeresis |
| 208 D0 [7 68] capital eth |
| 209 D1 [7 4 68] capital n tilde |
| 210 D2 [73 5 8] capital o grave |
| 211 D3 [7 14568] capital o acute |
| 212 D4 [7 2 568] capital o circumflex |
| 213 D5 [7 568] capital o tilde |
| 214 D6 [732 4 68] capital o diaeresis |
| 215 D7 [7 1 6 ] multiplication sign |
| 216 D8 [73 4 8] capital o stroke |
| 217 D9 [73 568] capital u grave |
| 218 DA [7 1 568] capital u acute |
| 219 DB [7 2 68] capital u circumflex |
| 220 DC [732 4568] capital u diaeresis |
| 221 DD [7 214 68] capital y acute |
| 222 DE [73 68] capital thorn |
| 223 DF [73 4568] small sharp s |
| 224 E0 [ 32 5 8] small a grave |
| 225 E1 [ 1 68] small a acute |
| 226 E2 [ 2 8] small a circumflex |
| 227 E3 [ 5 8] small a tilde |
| 228 E4 [ 3214 68] small a diaeresis |
| 229 E5 [ 3 45 8] small a ring above |
| 230 E6 [ 3 8] small ae |
| 231 E7 [ 3 4 68] small c cedilla |
| 232 E8 [ 32 568] small e grave |
| 233 E9 [ 21 68] small e acute |
| 234 EA [ 32 8] small e circumflex |
| 235 EB [ 3214568] small e diaeresis |
| 236 EC [ 32 68] small i grave |
| 237 ED [ 14 68] small i acute |
| 238 EE [ 2 5 8] small i circumflex |
| 239 EF [ 321 568] small i diaeresis |
| 240 F0 [ 68] small eth |
| 241 F1 [ 4 68] small n tilde |
| 242 F2 [ 3 5 8] small o grave |
| 243 F3 [ 14568] small o acute |
| 244 F4 [ 2 568] small o circumflex |
| 245 F5 [ 568] small o tilde |
| 246 F6 [ 32 4 68] small o diaeresis |
| 247 F7 [73 4 ] division sign |
| 248 F8 [ 3 4 8] small o stroke |
| 249 F9 [ 3 568] small u grave |
| 250 FA [ 1 568] small u acute |
| 251 FB [ 2 68] small u circumflex |
| 252 FC [ 32 4568] small u diaeresis |
| 253 FD [ 214 68] small y acute |
| 254 FE [ 3 68] small thorn |
| 255 FF [ 3 4568] small y diaeresis |
+-----------------------------------------------------------------+
</verb></tscreen>
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,69 @@
Pairing a Bluetooth Device on Linux
===================================
You need to "pair" your device with the host on which you wish to use it. You
can pair a device with more than one host, but you can usually only use it with
one host at a time.
Pairing a Bluetooth device on Linux is relatively easy if you're comfortable
working within the graphical (X) environment. All you need to do is to run
"bluetooth-applet" and follow the steps it presents to you. It's a little
trickier to pair a Bluetooth device via the command line, but it can be done.
One way to do it is as follows:
You need to find out your host's Bluetooth Device Address (referred to later in
this document as <host-address>). To do this, run the command "hciconfig hci0".
Look for the (indented) line which begins with "BD Address:". The very next
"word" on that line is your host's Bluetooth Device Address. It'll be six
two-digit hexadecimal numbers separated by colons (:). Examples in this
document use the value "01:23:45:67:89:AB".
You need to find out your device's Bluetooth Device Address (referred to later
in this document as <device-address>). To do this, run the command "hcitool
scan". This command can take a while to complete as it gives devices a fair bit
of time to respond. Each device which responds creates one two-column output
line. The first column is its Bluetooth Device Address (examples in this
document use the value "12:34:56:78:9A:BC"), and the second column is its
current name. Manufacturers usually set a device's initial name to its product
name and model number so that it's easy to spot within the scan output. If your
device allows you to change its name, it's okay to do so even after you've
paired it.
A device needs to be "visible" in order for the scan to find it. Most devices
are "invisible" by default, but have a way to be made temporarily visible. You
should check your device's manual to find out how to do this. In many cases
there's either a button which needs to be pressed or a menu item which needs to
be selected. Since both the device's temporary visibility and the host's scan
time out, Make your device visible just before you initiate the scan.
You need to know what PIN (password) your device is expecting. Your device's
documentation should contain this information. Many devices allow you to set
the PIN, in which case they'll have a menu which allows you to do this.
Examples in this document use the value "1234".
Go into the directory "/var/lib/bluetooth/<host-address>. In there (create if
necessary) is the file "pincodes". Each line in this file associates a device
with its PIN. It has two fields separated by space. The first field is the
device's Bluetooth Device Address and the second field is its PIN. The
Bluetooth Device Address must be in uppercase. For example:
cat /var/lib/bluetooth/01:23:45:67:89:AB/pincodes
12:34:56:78:9A:BC 1234
Using a Bluetooth Device with BRLTTY
====================================
After your device has been paired with your host, it's ready to be used by
BRLTTY. You can tell BRLTTY to use your Bluetooth device either via the -d (or
--braille-device=) command line option or via the braille-device line in the
file "/etc/brltty.conf". The device should be specified as the word
"bluetooth", a colon (:), and the device's Bluetooth Device Address. For
example:
brltty -d bluetooth:12:34:56:78:9A:BC
or
cat /etc/brltty.conf
braille-device bluetooth:12:34:56:78:9A:BC
@@ -0,0 +1,45 @@
Serial Support
--------------
The default DOS serial driver does not support speeds above 9600 baud. For
higher speeds a more capable serial driver (like ADF) must be used.
USB Support
-----------
USB is not supported.
Bluetooth Support
-----------------
Bluetooth is not supported.
Compilation
-----------
The MSDOS version can be compiled thanks to a cross-compiler. Get the following
archives:
ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/gcc410s2.zip
ftp://ftp.delorie.com/pub/djgpp/current/v2/djcrx203.zip
The djcrx203.zip archive contains a file named cross/howto.32 which explains
how to build a cross-compiler for gcc 3.2. You can build one for gcc 4.1 by
applying the same instructions to the gcc410s2.zip archive (listed above)
instead of to the gcc32s2.zip archive (mentioned in the howto). You can also
use a more recent binutils package too (2.16.91 works fine).
You can use the cross-compiler with the following ./configure command:
CC_FOR_BUILD=gcc LD=i586-pc-msdosdjgpp-ld ./configure \
--prefix=/brltty-msdos \
--host=i586-pc-msdosdjgpp --target=i586-pc-msdosdjgpp \
--build=x86_64-unknown-linux-gnu \
--disable-api --disable-icu --without-speechd \
--disable-x --without-usb-package --without-bluetooth-package \
--with-braille-driver=-vr,all --without-libbraille \
--with-speech-driver=all --without-espeak --without-flite \
--with-screen-driver=pb,-all
@@ -0,0 +1,87 @@
Setting up BRLTTY on OpenBSD
----------------------------
This document describes how to get BRLTTY working on a
recent OpenBSD system. It assumes that you are working with a recent OpenBSD
installation (3.4).
1. Patching "screen"
--------------------
Since OpenBSD (and in fact all the other BSDs) do not
have a way for user-space applications to access the current text/attribute
content of the virtual consoles, we have to use "screen" to make
this information available to BRLTTY. This also means that
you can not use BRLTTY with the *BSD virtual consoles directly, you
have to start "screen" first on some virtual terminal to be able
to use BRLTTY.
You need to patch "screen" to enable the IPC_SHARED_IMAGE functionality
which BRLTTY relies on. Assuming your ports tree is in /usr/ports,
you will need to copy the appropriate patch from
brltty/Patches into /usr/ports/misc/screen/patches.
OpenBSD 3.4 comes with screen-4.0.1. You can
check the screen version by reading /usr/ports/misc/screen/Makefile.
The patch file should be named with the prefix "patch-" so that the
screen build process will find it.
Now change into /usr/ports/misc/screen and run
$ make
followed by
$ sudo make install
If you successfully managed to compile and install the
screen package, you can proceed to building BRLTTY.
There is a simple test you can use to verify if your screen
installation does support the IPC_SHARED_IMAGE feature. Start "screen" and
execute the command
# ipcs -m
Shared Memory:
T ID KEY MODE OWNER GROUP
m 65536 -1160968401 --rwa------ root root
If you see output which looks roughly like the above,
screen seems to be compiled with the IPC_SHARED_IMAGE feature.
Note that proper integration of the IPC_SHARED_IMAGE functionality
via an additional FLAVOR for the screen port has recently been submitted
to the OpenBSD ports mailing list. If you are working with the CVS ports
tree, it might be worthwhile checking if the shm flavor already has
been checked in by invoking the following command in /usr/ports/misc/screen:
$ make show=FLAVORS
If you see "shm" listed as a possible flavor to choose, simply
build screen with the FLAVOR environment variable set to shm, and do not
bother copying the patch from BRLTTY sources.
2. Compiling BRLTTY
-------------------
To compile BRLTTY, you do the following:
$ ./configure
$ gmake
$ sudo gmake install
Note that 'gmake' needs to be used to avoid a problem
related to BSD and GNU Make incompatibilities.
3. Running BRLTTY
-----------------
You need to have "screen" started before you try to run
BRLTTY. Inside screen, simply invoke BRLTTY as you would on
other systems. Note that the first serial port is /dev/cua00.
So a typical invocation could look like this:
# brltty -b ts -d /dev/cua00
-- Mario Lang <mlang@delysid.org>
@@ -0,0 +1,303 @@
System Requirements
===================
The earliest release of Windows which is supported by BRLTTY is Windows 98.
Pre-built versions of brltty are available for download on
http://mielke.cc/brltty or on http://youpibouh.thefreecat.org/brltty/
In order to build BRLTTY yourself from a supplied tarball, you
need either Cygwin (see [http://www.cygwin.com/]) or MinGW (see
[http://mingw.sourceforge.net/]). In both cases, you also need the following
additional packages:
* gcc
* make
* w32api (version 3.6 or later)
If you'd like to build BRLTTY from its source repository rather than from one
of the supplied tarballs then you'll also need these additional packages:
* autoconf
* tcltk
If you'd like to prepare the documentation (do make within the Documents/
subdirectory) you'll need these packages:
* linuxdoc-tools (not pre-packaged in cygwin unfortunately)
* doxygen
If you are using MSYS for running configure and make, you should always use
Windows paths (like c:/brltty), not MSYS paths (like /c/brltty), because brltty
does _not_ understand MSYS paths.
------------------------------------------------------------------------------
Windows 98 and Me Limitation
============================
On Windows versions 2000, XP, 2003, and later, BRLTTY automatically accesses
the Windows terminal which you're currently using as you switch between them.
This isn't possible on earlier versions. One way to still achieve this
functionality, however, is to run one BRLTTY (which directly accesses your
braille display) on the root window and another one (which indirectly accesses
your braille display via BrlAPI) on each terminal. This scheme may sound
complicated, but it can be easily set up to run automatically.
The first (or root) BRLTTY should be run as part of Windows startup. It must be
given those options which are necessary to access your braille display, e.g.
-b, -d, and all other options you'd normally specify. It must also be given the
-Xroot=yes option, which attaches it to the root window.
An additional BRLTTY should then be run for each new terminal. It should be
invoked like this:
brltty -bba -N
The -bba option tells it to access the root BRLTTY via BrlAPI, and the -N
option tells it not to start a BrlAPI server of its own.
These BRLTTYs can be started automatically by, for example, adding this line to
your .bashrc script. Each of these BRLTTYs takes care of the terminal it's
running in, and connects, via BrlAPI, to the root BRLTTY in order to access
your braille display.
If you're not concerned with security, and would rather not fiddle with the
brlapi.key file, then add the -Aauth=none option to the command line which
invokes the root BRLTTY. You don't need to worry about unauthorized access over
the network since the default is that only locally running programs can connect
to BrlAPI.
------------------------------------------------------------------------------
USB Support
===========
USB devices are supported thanks to the libusb-win32 or libusb-1.0
packages.
Pre-built versions of brltty have USB support compiled in, and the required
drivers are shipped, you just need to let the installer set them up.
In order to build BRLTTY yourself with USB support enabled, _before_ compiling
BRLTTY, you need to install at least one of libusb-win32 or libusb-1.0.
At the time of this writing, libusb-win32 binaries can be found on
[http://libusb-win32.sourceforge.net/]. The file will be called something
like "libusb-win32-bin-<version>.exe", and should be available on
[http://sourceforge.net/project/showfiles.php?group_id=78138].
Unpack it in some place.
As of the time of this writing, the libusb-1.0 binary snapshots can be found on
http://www.libusb.org/wiki/windows_backend . The file will be called something
like "libusb_<date>.7z". Unpack it in some place.
The Cygwin or mingw toolchain then needs to get aware of the presence of
libusb-win32 or libusb1.0-devel.
For Cygwin:
* Just install the libusb-win32 or libusb1.0-devel package.
For mingw:
For libusb-win32:
Symlink the header and library files into MinGW installation, run:
+ ln -s "/path/to/LibUSB-Win32/include/lusb0_usb.h" /mingw/include/
+ ln -s "/path/to/LibUSB-Win32/lib/gcc/libusb.a" /mingw/lib/
+ ln -s "/path/to/LibUSB-Win32/bin/x86/libusb0_x86.dll" /mingw/bin/libusb0.dll
Then you can configure, compile, install, and run BRLTTY as usual.
For libusb-1.0:
1) Symlink the header and library files into MinGW installation, run:
+ ln -s "/path/to/Libusb-1.0/include/libusb-1.0" /mingw/include/
+ ln -s "/path/to/Libusb-1.0/MinGW32/dll/libusb-1.0.dll.a" /mingw/lib/
+ ln -s "/path/to/Libusb-1.0/MinGW32/dll/libusb-1.0.dll" /mingw/bin/
2) Create a /mingw/lib/pkgconfig/libusb-1.0.pc file containing
prefix=/mingw
exec_prefix=${prefix}
libdir=${prefix}/lib
includedir=${prefix}/include
Name: libusb-1.0
Description: C API for USB device access from Windows userspace
Version: 1.0
Libs: -L${libdir} -lusb-1.0
Cflags: -I${includedir}/libusb-1.0
Then you can configure, compile, install, and run BRLTTY as usual.
To actually be able to use the libusb-win32 driver, you need to copy the
runtime files in the brltty source.
+ cp "/path/to/LibUSB-Win32/bin/x86/libusb0.sys" brltty/hotplug/libusb0.sys
+ cp "/path/to/LibUSB-Win32/bin/x86/libusb0_x86.dll" brltty/hotplug/libusb0.dll
+ cp "/path/to/LibUSB-Win32/bin/amd64/libusb0.sys" brltty/hotplug/libusb0_x64.sys
+ cp "/path/to/LibUSB-Win32/bin/amd64/libusb0.dll" brltty/hotplug/libusb0_x64.dll
and then right-click on brltty/hotplug/brltty.inf and select install, or on
braille device plug, point at the brltty/hotplug/brltty.inf file.
To actually be able to use the libusb-1.0 driver, right-click on
brltty/hotplug/brltty-libusb-1.0.inf and select install, or on braille
device plug, point at the brltty/hotplug/brltty-libusb-1.0.inf file.
------------------------------------------------------------------------------
Configuring BRLTTY
==================
Some of BRLTTY's configure options are of particular interest to users of the
Windows platform:
--enable-relocatable-install: The default is for BRLTTY to refer to its
components via absolute paths. On the Windows platform, however, the convention
is for a package to use relative paths so that it can be installed into an
arbitrary directory and so that it can be moved around thereafter as well. This
option builds BRLTTY such that relative paths are used.
------------------------------------------------------------------------------
Sticking to a console
=====================
It may be useful to have BRLTTY only review the console it is started in, i.e.
for it not to follow the keyboard focus. To achieve this, set the FollowFocus
parameter of the Windows screen driver to no. This can be done either on the
command line (-XFollowFocus=no) or in brltty.conf (screen-parameter
FollowFocus=no).
------------------------------------------------------------------------------
Sharing the Braille Display with Other Screen Readers
=====================================================
When you're not on a window which BRLTTY can handle its default action is to
retain control of the braille display and to present a brief message explaining
the problem. If you have another braille-capable screen reader and would like
it to take over instead then both BRLTTY and that other screen reader must be
instructed to share the braille display.
BRLTTY can be instructed to share the braille display via its --release-device
option; the short form of this option is -r. When this option is in effect
BRLTTY releases the braille display when you move onto a window which it cannot
handle and tries to regain control of the braille display when you move onto a
window which it can handle. Note that these actions take a noticeable amount of
time so you should only use this option if it's actually needed.
------------------------------------------------------------------------------
Sharing BRLTTY with JAWS
========================
A common case wherein a JAWS user might want BRLTTY to be in control of the
braille display is when using Cygwin.
There are two phases to configuring JAWS to run in the background while BRLTTY
controls the braille display. First, the window title must be established and
stable. Second, JAWS braille must be put to sleep.
What is a window title?
-----------------------
Every window in Windows has a title bar that contains the name of the
application which is running in it as well as some controls to do things like
move and resize it. BRLTTY does not show this title bar.
For a program window, JAWS uses the name of the program's executable as the
name of the configuration files to load when that program gains focus. For a
console application such as Cygwin, however, it uses the title of the window
instead. We must, therefore, tell JAWS within the window title that this is a
Cygwin window.
Setting the Window Title
------------------------
JAWS uses one of the words in the window title as the name of the configuration
files to load. This file set is what tells JAWS the specifics of how to handle
the application. It is, therefore, where JAWS must be instructed to put its
braille component to sleep.
At this writing, it appears that JAWS uses the following algorithm for choosing
which word in the title to use as the name of the file set:
1) If there are no slashes (/) or backslashes (\) in the title then JAWS uses
the first word. Thus, if the title is "Cygwin Bash Shell" then JAWS will
load the Cygwin configuration files.
2) If there is at least one slash (/) or backslash (\) in the title then JAWS
uses the last word. Thus, if the title is "$PWD - Cygwin" then JAWS will
similarly load the Cygwin configuration files.
Setting Cygwin's Window Title
-----------------------------
First, it is imperative that you replace, or at least modify, the default PS1
(primary shell prompt) setting. The default for this setting, as distributed by
Cygwin, places $PWD (the path to the current working directory) in the window
title, thus requiring you to have a separate JAWS configuration for every
directory on the system! One possible way to resolve this problem is to
uncomment the `settitle' function which can be found near the end of `.bashrc'.
This function allows you to place a string of your own choice in the title. You
can use this function, therefore, as follows:
export PROMPT_COMMAND='settitle "$PWD - Cygwin"'
export PS1='$ '
The first of these lines causes the window title to be set just before each
shell prompt. Since $PWD always contains at least one slash (/), the operative
word is `Cygwin' (the last word), and JAWS will load any Cygwin configuration
files that it finds. The second of these lines sets the primary shell prompt to
the customary dollar sign ($). More importantly, though, it replaces Cygwin's
default PS1 setting which contains escape sequences that overwrite the window
title with just $PWD thus not presenting any permanent text for JAWS to
recognize.
Putting JAWS Braille to Sleep
-----------------------------
Now that a stable window title has been established, JAWS braille can finally
be put to sleep. While in Cygwin and with BRLTTY not running, do the following:
1) Press Insert+F2 to bring up the Run JAWS Manager dialog.
2) Down-Arrow to Configuration Manager and press Enter. Verify that the title
on the top line contains "Cygwin.jcf".
3) Press Alt+S for Set Options.
4) Press B for Braille.
5) Press S for Braille Sleep Mode.
6) Verify that the box is checked (it should look like <x> instead of < >).
Press Space to toggle the setting if the x isn't there.
7) Press Enter to leave the menu.
8) Press Control+S to save the file.
9) Press Alt+F4 to exit the configuration manager.
Putting JAWS Speech to Sleep
----------------------------
If you want to use JAWS speech in Windows but not in Cygwin, you can do the
following:
1) Press Insert+F2 to bring up the Run JAWS Manager dialog.
2) Down-Arrow to Configuration Manager and press Enter. Verify that the title
on the top line contains "Cygwin.jcf".
3) Press Alt+S for Set Options.
4) Press A for Advanced.
5) You should be on an item labelled "Sleep Mode Enable" with an empty check
box (< >). Press Space to check it (<x>).
6) Press Enter to leave the menu.
7) Press Control+S to save the file.
8) Press Alt+F4 to exit the configuration manager.
Performance
-----------
You'll always be able to switch to Cygwin, and BRLTTY, if running, will take
control of the braille display automatically. Switching back to Windows and
JAWS may be a bit more problematic, though ... the degree of success seems to
depend on the type of braille display being used. Sometimes it works properly.
Sometimes, with a USB display, the cable must be unplugged/replugged to allow
JAWS to regain control. In extreme cases you may need to exit BRLTTY before
going to Windows.
------------------------------------------------------------------------------
@@ -0,0 +1,63 @@
Brltty provides some support for the X11 graphical environment.
Braille Input from braille device support
-----------------------------------------
Some braille devices have an integrated braille keyboard. The brltty daemon
alone can not properly simulate keypresses for the X11 server, because it
does not know which keyboard layout the latter uses. To get proper keyboard
simulation, xbrlapi should be started in the background during X session
startup. By default, xbrlapi also prints the current window's title on the
braille device. To avoid this (since it could interfere with the output from
screen readers like Orca), give the -q option to xbrlapi.
Braille Input from PC keyboard support
--------------------------------------
The PC keyboard itself can be used in X11 as a braille keyboard. This can be
enabled by using the "brai" layout, for instance, the following
setxkbmap -layout "us,brai" -option "grp:shift_caps_toggle,grp_led:scroll"
enables both US and braille keyboard layouts to be enabled in X11 (in two
different XKB groups), and Shift+CapsLock can be used to switch between both
(i.e. switch between the two XKB groups). The scroll LED will be lit while being
in braille mode, for sighted people to notice why they get strange output if
they switch groups by accident. Other shortcuts and LEDs can be used, see the
XKB documentation. The default keyboard mapping for braille dots is "asdfjkl,",
but other layouts are available, see the variants in XKB.
The setxkbmap command above enables it just for the current session. For
permanent configuration, the two groups have to be configured properly in the
system. On Debian for instance, this can be achieved by setting the following
in /etc/default/keyboard:
XKBLAYOUT="us,brai"
XKBOPTIONS="grp:shift_caps_toggle,grp_led:scroll"
By default, the result will be unicode braille patterns, because X11 does not
know which braille table it should use. To tell X11 the conversion that should
be performed, use the ttbtest tool to convert your brltty table into an XCompose
table, for instance:
ttbtest -i ttb -o XCompose en_US.ttb /tmp/my.XCompose
The XCompose table can then be enabled by:
cat /tmp/my.XCompose >> ~/.XCompose
Screen reading
--------------
Brltty is not meant to be able to read a whole graphical environment, as it
does not have the notion of menus, buttons, etc. The orca screen reader should
be used instead. Brltty however has a driver to at least review the textual
elements: edit boxes and terminals. This is particularly interesting for
reading terminals, since that is what brltty is good at. This can be achieved by
running a second brltty daemon during X11 session startup:
brltty -b ba -x as
This second daemon will connect to the first one throught BrlAPI (thanks to the
"ba" braille driver), and read the screen via AtSpi (thanks to the "as" screen
driver). An "a2" driver is also provided for AtSpi2 support.
@@ -0,0 +1,99 @@
Managing BRLTTY with Stow utility
-+===============================+-
Written by B. Daix (Wed Sep 10, 2003)
Purpose
=======
BRLTTY is a critical software for those who rely on it to access their
box : upgrading such a tool can't be done without paying some special
attention.
What will be explained here is how to keep /usr/local/bin/brltty up to
date without removing old versions. We decide to put BRLTTY in
/usr/local as we don't want to break filesystem root distribution
(i.e. /bin/brltty should only come from a packaged version of BRLTTY
for your distribution : if you install software in respect with this
rule, you'd install it in /usr/local). Also, we want not to have to
keep source files to be able to remove things cleanly : after
installing a software, you shouldn't have to rely on a by-software
uninstallation suite.
You should install Stow to be able to run it and to find more details
about it. It's a common utility : "apt-get install stow" for Debian, and
probably equivalents for other distributions.
Why Stow can help
=================
Stow allows to manage files like if they were packaged, by creating
symlinks from by-directory grouped sets of files instead of copying
them directly.
We recommend to attentively read Stow Info files, to realize what it
can do, how, and specially why it is so useful when you have to manage
personally compiled software you rely on.
The procedure
=============
So we want to run a BRLTTY version, taken from a set of personally
compiled ones, and safely keep all of them around. Current working
release will be run from /usr/local root, while all releases files
will be kept in the "safe place", the "Stow directory"
/usr/local/stow/. For example, releases (bins/configs/libs/mans, not
source trees) will be stored there like this :
/usr/local/stow/brltty-3.2/, /usr/local/stow/brltty-3.3-with-api/,
/usr/local/stow/brltty-3.3/, and so on.
Compiling/installing BRLTTY for Stow file management
We have to use "configure" flags to indicate we want BRLTTY to be run
From /usr/local root, and installed in /usr/local/stow/brltty-3.2/
root : Stow will do symlinks for us then. The distinction between
execution root and installation root is critical (c.f. Stow Info) :
"./configure --with-execute-root=/usr/local
--with-install-root=/usr/local/stow/brltty-3.2 [...]". You may add
whatever flags then, except those which change directories as we
already managed this.
Then, simply, "make" and "make install" : "ls
/usr/local/stow/brltty-3.2/" should show you all what would have been
put in /usr/local if we haven't managed files with Stow.
Reproduce this for each version you want to install, for example, we
built a brltty-3.3-with-api directory by applying above principles and
adding dedicated flag for enabling API to "configure" command line.
We did the same for a standard brltty-3.3 too, and so on, all stored
in /usr/local/stow/. As you see, we cleanly separate things : one
directory per version on one hand, building vs. using on the other.
Testing is now far lighter.
Managing safely kept versions with Stow
Before asking for Stow to create symlinks, we have to be sure we won't
get any conflicts, i.e., we haven't already asked for Stow to create
symlinks on the same software without removing them first, or we don't
forget we have already installed BRLTTY directly. "ls
/usr/local/{bin,sbin}" should be enough to see if we have to clean
things up before going any further. Note we'll see how to use Stow to
remove created symlinks just after explaining how to ask for it to
create them (we hope you read from up to below...).
"cd /usr/local/stow ; stow brltty-3.2" will create the symlinks, in
parent dir (i.e. "ln -s brltty-3.2/bin ../bin" if ../bin didn't exist,
"ln -s brltty-3.2/bin/brltty ../bin/brltty" otherwise, and so on :
c.f. Stow Info for more details).
Now, running /usr/local/bin/brltty will work perfectly, looking for
its config files in /usr/local/etc/brltty/" and so on, even if it's
all symlinks : as if BRLTTY-3.2 was installed there.
When you want to switch to another version, you simply have to ask for
Stow to remove symlinks it created : "cd /usr/local/stow/ ; stow -D
brltty-3.2" (if current release points to this version) and then "stow
brltty-3.3-with-api". Doesn't it taste powerful ?!
+32
View File
@@ -0,0 +1,32 @@
BRLTTY TODO - March 30, 2000
============================
(This concerns the main module of BRLTTY. Individual Braille terminal
drivers may have their own TODO lists.)
Your help is welcome.
- Defining smaller regions of the screen to be concentrated on. Cursor
movement outside the current region would be ignored. This would be
useful if the screen was split into multiple `windows' (e.g. in ytalk).
- Attribute tracking (scroll bars, etc.)
- Revision of beeps. Too many events have the same beeps, so we might want
to add new ones. See if we could optimize the use of the console resource.
Implement .au and .wav sounds (through a soundcard).
- Scroll tracking: wouldn't it be great if you could continue reading the
line you're on even when new text is printed and the screen scrolls up?
Like in IRC for instance...
- Better speech support.
- Support for more Braille displays.
- Port to other Unix platforms. Since all Linux dependent functions are now
modularized in separate source files, it would be easy to write other
modules to make BRLTTY usable with the screen package or such and then
become available for any other Unix platform. An experimental patch is
available in the Patches/ directory.
@@ -0,0 +1,776 @@
.TH "BRLTTY" "1" "Oct 2011" "brltty 4.3" "The BRLTTY Project"
.SH NAME
brltty \- refreshable braille display driver for Linux/Unix
.SH SYNOPSIS
\fBbrltty \fR[\fIoption\fR ...]
.SH DESCRIPTION
.B brltty
is a background process (daemon)
which provides access to the console screen (when in text mode)
for a blind person using a refreshable braille display.
It drives the braille display,
and provides complete screen review functionality.
Some speech capability has also been incorporated.
.SH OPTIONS
Options can be passed to
.B brltty
in a number of ways.
From most to least influential, these are:
.IP 1. 4
Command Line Options
.IP 2. 4
Boot Parameters
.IP 3. 4
Environment Variables
(if the
.B -E
.RB "(" "--environment-variables" ")"
option is in effect)
.IP 4. 4
The Configuration File
.IP 5. 4
Built-in Defaults
.SS "Command Line Options"
The options are processed sequentially from left to right.
If an option is specified more than once,
or in case of a conflict,
the rightmost specification takes precedence.
.PP
The following options are supported:
.TP
\fB-a \fItable\fR (\fB--attributes-table=\fR)
The path to the attributes table.
Relative paths are anchored at
.BR "@TABLES_DIRECTORY@" "."
The
.B ".atb"
extension is optional.
The built-in default is
.BR "attributes.atb" "."
.TP
\fB-b \fIdriver\fB,\fR...|\fBauto\fR (\fB--braille-driver=\fR)
The driver for the braille display
(see Driver Specification).
The built-in default is \fBauto\fR.
.TP
\fB-c \fItable\fR (\fB--contraction-table=\fR)
The path to the contraction table.
Relative paths are anchored at
.BR "@TABLES_DIRECTORY@" "."
The
.B ".ctb"
extension is optional.
.TP
\fB-d \fIdevice\fB,\fR... (\fB--braille-device=\fR)
The device to which the braille display is connected.
The built-in default is \fB@braille_device@\fR.
.RS
.PP
The general form of a braille device specification is
\fIqualifier\fB:\fIdata\fR.
For backward compatibility with earlier releases,
if the qualifier is omitted then
.B serial:
is assumed.
The following device types are supported:
.TP
.B Bluetooth
For a bluetooth device, specify \fBbluez:\fIaddress\fR.
The address must be six two-digit hexadecimal numbers separated by colons, e.g.
.BR "01:23:45:67:89:AB" "."
.TP
.B Serial
For a serial device, specify \fBserial:\fI/path/to/device\fR.
The
.B serial:
qualifier is optional (for backward compatibility).
If a relative path is given then it's anchored at
.B /dev/
(the usual location where devices are defined on a Unix-like system).
The following device specifications all refer
to the primary serial device:
.BR "serial:/dev/@first_serial_device@" ","
.BR "serial:@first_serial_device@" ","
.BR "/dev/@first_serial_device@" ","
.BR "@first_serial_device@" "."
.TP
.B USB
For a USB device, specify \fBusb:\fR.
.B brltty
will search for the first USB device which
matches the braille display driver being used.
If this is inadequate,
e.g. if you have more than one USB braille display which requires the same driver,
then you can refine the device specification
by appending the serial number of the display to it, e.g.
.BR "usb:12345" "."
N.B.:
The "identification by serial number" feature doesn't work for some models
because some manufacturers
either don't set the USB serial number descriptor at all
or do set it but not to a unique value.
.PP
A comma-delimited list of braille devices may be specified.
If this is done then autodetection is performed on each listed device in sequence.
This feature is particularly useful if you have
a braille display with more than one interrface,
e.g. both a serial and a USB port.
.RE
.TP
\fB-e\fR (\fB--standard-error\fR)
Write logs to standard error rather than to the system log (useful for debugging).
.TP
\fB-f \fIfile\fR (\fB--configuration-file=\fR)
The path to the configuration file.
Relative paths are anchored at the current working directory.
The built-in default is
.BR "@CONFIGURATION_DIRECTORY@/@CONFIGURATION_FILE@" "."
.TP
\fB-h\fR (\fB--help\fR)
Print a command line usage summary and then exit.
.TP
\fB-i \fIname\fR (\fB--speech-input=\fR)
The file system object
(FIFO, named pipe, named socket, etc)
which gives other applications access to
.BR brltty 's
speech driver for text-to-speech conversion.
It's created at start-up and removed at termination.
Relative paths are anchored at the current working directory.
The built-in default is
that the file system object is not created.
.TP
\fB-l \fIlevel\fR (\fB--log-level=\fR)
The minimum severity level for messages written to the log.
Any of the following numbers,
or any abbreviation of their corresponding names,
may be specified:
.RS
.TP 4
.B 0
.B emergency
.TP 4
.B 1
.B alert
.TP 4
.B 2
.B critical
.TP 4
.B 3
.B error
.TP 4
.B 4
.B warning
.TP 4
.B 5
.B notice
.TP 4
.B 6
.B information
.TP 4
.B 7
.B debug
.RE
.PP
The built-in default is
.BR "notice" "."
.TP
\fB-m \fIdevice\fR (\fB--midi-device=\fR)
The device to use for the Musical Instrument Digital Interface.
For ALSA it's \fIclient\fB:\fIport\fR,
where each may be either a number or a case-sensitive substring of its name.
For other interfaces it's the full path to an appropriate system device.
The built-in default is:
.RS
.IP Linux/ALSA 12
the first available MIDI output port
.IP Linux/OSS 12
.B /dev/sequencer
.RE
.TP
\fB-n\fR (\fB--no-daemon\fR)
Remain in the foreground (useful for debugging).
.TP
\fB-p \fIdevice\fR (\fB--pcm-device=\fR)
The device to use for digital audio.
For ALSA it's \fIname\fR[\fB:\fIargument\fB,\fR...].
For other interfaces it's the full path to an appropriate system device.
The built-in default is:
.RS
.IP FreeBSD 12
.B /dev/dsp
.IP Linux/ALSA 12
.B hw:0,0
.IP Linux/OSS 12
.B /dev/dsp
.IP NetBSD 12
.B /dev/audio
.IP OpenBSD 12
.B /dev/audio
.IP Qnx 12
the preferred PCM output device
.IP Solaris 12
.B /dev/audio
.RE
.TP
\fB-q\fR (\fB--quiet\fR)
Suppress the start-up messages.
This is done by reducing the default log level
(see the
.B -l
.RB "(" "--log-level=" ")"
option)
to
.B warning
.RB "(" "information"
if either
.B -v
.RB "(" "--verify" ")"
or
.B -V
.RB "(" "--version" ")"
is also specified).
.TP
\fB-r\fR (\fB--release-device\fR)
Release the device to which the braille display is connected
when the current screen or window can't be read.
.TP
\fB-s \fIdriver\fB,\fR...|\fBauto\fR (\fB--speech-driver=\fR)
The driver for the speech synthesizer
(see Driver Specification).
The built-in default is \fBauto\fR.
.TP
\fB-t \fItable\fR (\fB--text-table=\fR)
The path to the text table.
Relative paths are anchored at
.BR "@TABLES_DIRECTORY@" "."
The
.B ".ttb"
extension is optional.
The built-in default is
.B "nabcc.ttb"
(the North American Braille Computer Code).
.TP
\fB-v\fR (\fB--verify\fR)
Print the start-up messages and then exit.
This always includes the versions of
.B brltty
itself,
the server side of its application programming interface,
and each of the selected braille and speech drivers.
If the
.B -q
.RB "(" "--quiet" ")"
option isn't also specified
then it also includes the values of the options after all sources have been considered.
If more than one braille driver and/or more than one braille device
has been specified then braille display autodetection is performed.
If more than one speech driver
has been specified then speech synthesizer autodetection is performed.
.TP
\fB-x \fIdriver\fR (\fB--screen-driver=\fR)
The screen driver.
The built-in default is operating system appropriate.
.TP
\fB-A \fIname\fB=\fIvalue\fB,\fR... (\fB--api-parameters=\fR)
Parameters for the application programming interface.
If the same parameter is specified more than once
then the rightmost specification is used.
Parameter names may be abbreviated.
.TP
\fB-B \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR... (\fB--braille-parameters=\fR)
Parameters for the braille display driver.
If the same parameter is specified more than once
then the rightmost specification is used.
Parameter names may be abbreviated.
If a parameter assignment is qualified with a driver identification code
then it's only processed if that braille display driver is being used.
.TP
\fB-E\fR (\fB--environment-variables\fR)
Recognize environment variables.
.TP
\fB-F \fIfile\fR (\fB--preferences-file=\fR)
The path to the preferences file.
Relative paths are anchored at
.BR "@STATE_DIRECTORY@" "."
The built-in default is
.BR "@PREFERENCES_FILE@" "."
.TP
\fB-I\fR (\fB--install-service\fR)
(Windows only)
Install
.B brltty
as the
.B BrlAPI
service so that it will be automatically started when the system is booted
and so that applications can know that a
.B BrlAPI
server is running.
.TP
\fB-L \fIfile\fR (\fB--log-file=\fR)
The file to which log messages are written.
Relative paths are anchored at the current working directory.
The default is to send log messages to the system log.
.TP
\fB-M \fIcsecs\fR (\fB--message-delay=\fR)
The message hold time in hundredths of a second.
The built-in default is
.B 400
(4 seconds).
.TP
\fB-N\fR (\fB--no-api\fR)
Don't start the application programming interface.
.TP
\fB-P \fIfile\fR (\fB--pid-file=\fR)
The full path to the process identifier file.
If this option is supplied,
.B brltty
writes its process identifier (pid) into the specified file at start-up.
The file is removed when
.B brltty
terminates.
.TP
\fB-R\fR (\fB--remove-service\fR)
(Windows only)
Remove the
.B BrlAPI
service so that
.B brltty
will not be automatically started when the system is booted
and so that applications can know that no
.B BrlAPI
server is running.
.TP
\fB-S \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR... (\fB--speech-parameters=\fR)
Parameters for the speech synthesizer driver.
If the same parameter is specified more than once
then the rightmost specification is used.
Parameter names may be abbreviated.
If a parameter assignment is qualified with a driver identification code
then it's only processed if that speech synthesizer driver is being used.
.TP
\fB-U \fIcsecs\fR (\fB--update-interval=\fR)
The braille window update interval in hundredths of a second.
The built-in default is
.B 4
(25 times per second).
.TP
\fB-V\fR (\fB--version\fR)
Print the versions of
.B brltty
itself,
the server side of its application programming interface,
and those drivers which were configured in at build-time,
and then exit.
If the
.B -q
.RB "(" "--quiet" ")"
option isn't also specified
then also print copyright information.
.TP
\fB-X \fIname\fB=\fIvalue\fB,\fR... (\fB--screen-parameters=\fR)
Parameters for the screen driver.
If the same parameter is specified more than once
then the rightmost specification is used.
Parameter names may be abbreviated.
.SS "Environment Variables"
The following environment variables are recognized if the
.B -E
.RB "(" "--environment-variables" ")"
option is specified:
.TP
\fBBRLTTY_API_PARAMETERS=\fIname\fB=\fIvalue\fB,\fR...
Parameters for the application programming interface.
See the
.B -A
.RB "(" "--api-parameters=" ")"
option for details.
.TP
\fBBRLTTY_ATTRIBUTES_TABLE=\fItable\fR
The attributes table.
See the
.B -a
.RB "(" "--attributes-table=" ")"
option for details.
.TP
\fBBRLTTY_BRAILLE_DEVICE=\fIdevice\fB,\fR...
The device to which the braille display is connected.
See the
.B -d
.RB "(" "--braille-device=" ")"
option for details.
.TP
\fBBRLTTY_BRAILLE_DRIVER=\fIdriver\fB,\fR...|\fBauto\fR
The driver for the braille display.
See the
.B -b
.RB "(" "--braille-driver=" ")"
option for details.
.TP
\fBBRLTTY_BRAILLE_PARAMETERS=\fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
Parameters for the braille display driver.
See the
.B -B
.RB "(" "--braille-parameters=" ")"
option for details.
.TP
\fBBRLTTY_CONFIGURATION_FILE=\fIfile\fR
The configuration file.
See the
.B -f
.RB "(" "--configuration-file=" ")"
option for details.
.TP
\fBBRLTTY_CONTRACTION_TABLE=\fItable\fR
The contraction table.
See the
.B -c
.RB "(" "--contraction-table=" ")"
option for details.
.TP
\fBBRLTTY_MIDI_DEVICE=\fIdevice\fR
The device to use for the Musical Instrument Digital Interface.
See the
.B -m
.RB "(" "--midi-device=" ")"
option for details.
.TP
\fBBRLTTY_PCM_DEVICE=\fIdevice\fR
The device to use for digital audio.
See the
.B -p
.RB "(" "--pcm-device=" ")"
option for details.
.TP
\fBBRLTTY_PREFERENCES_FILE=\fIfile\fR
The preferences file.
See the
.B -F
.RB "(" "--preferences-file=" ")"
option for details.
.TP
\fBBRLTTY_RELEASE_DEVICE=on\fR|\fBoff\fR
Release the device to which the braille display is connected
when the current screen or window can't be read.
See the
.B -r
.RB "(" "--release-device" ")"
option for details.
.TP
\fBBRLTTY_SCREEN_DRIVER=\fIdriver\fR
The screen driver.
See the
.B -x
.RB "(" "--screen-driver=" ")"
option for details.
.TP
\fBBRLTTY_SCREEN_PARAMETERS=\fIname\fB=\fIvalue\fB,\fR...
Parameters for the screen driver.
See the
.B -X
.RB "(" "--screen-parameters=" ")"
option for details.
.TP
\fBBRLTTY_SPEECH_DRIVER=\fIdriver\fB,\fR...|\fBauto\fR
The driver for the speech synthesizer.
See the
.B -s
.RB "(" "--speech-driver=" ")"
option for details.
.TP
\fBBRLTTY_SPEECH_INPUT=\fIname\fR
The file system object which gives other applications access to
.BR brltty 's
speech driver for text-to-speech conversion.
See the
.B -i
.RB "(" "--speech-input=" ")"
option for details.
.TP
\fBBRLTTY_SPEECH_PARAMETERS=\fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
Parameters for the speech synthesizer driver.
See the
.B -S
.RB "(" "--speech-parameters=" ")"
option for details.
.TP
\fBBRLTTY_TEXT_TABLE=\fItable\fR
The text table.
See the
.B -t
.RB "(" "--text-table=" ")"
option for details.
.SS "The Configuration File"
Blank lines are ignored.
If the character
.B "#"
occurs on any line then
all characters from it to the end of that line are treated as a comment.
.PP
The following configuration directives are supported:
.TP
\fBapi-parameters \fIname\fB=\fIvalue\fB,\fR...
Parameters for the application programming interface.
See the
.B -A
.RB "(" "--api-parameters=" ")"
option for details.
.TP
\fBattributes-table \fItable\fR
The attributes table.
See the
.B -a
.RB "(" "--attributes-table=" ")"
option for details.
.TP
\fBbraille-device \fIdevice\fB,\fR...
The device to which the braille display is connected.
See the
.B -d
.RB "(" "--braille-device=" ")"
option for details.
.TP
\fBbraille-driver \fIdriver\fB,\fR...|\fBauto\fR
The driver for the braille display.
See the
.B -b
.RB "(" "--braille-driver=" ")"
option for details.
.TP
\fBbraille-parameters \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
Parameters for the braille display driver.
See the
.B -B
.RB "(" "--braille-parameters=" ")"
option for details.
.TP
\fBcontraction-table \fItable\fR
The contraction table.
See the
.B -c
.RB "(" "--contraction-table=" ")"
option for details.
.TP
\fBmidi-device \fIdevice\fR
The device to use for the Musical Instrument Digital Interface.
See the
.B -m
.RB "(" "--midi-device=" ")"
option for details.
.TP
\fBpcm-device \fIdevice\fR
The device to use for digital audio.
See the
.B -p
.RB "(" "--pcm-device=" ")"
option for details.
.TP
The preferences file.
See the
.B -F
.RB "(" "--preferences-file=" ")"
option for details.
.TP
\fBrelease-device on\fR|\fBoff\fR
Release the device to which the braille display is connected
when the current screen or window can't be read.
See the
.B -r
.RB "(" "--release-device" ")"
option for details.
.TP
\fBscreen-driver \fIdriver\fR
The screen driver.
See the
.B -x
.RB "(" "--screen-driver=" ")"
option for details.
.TP
\fBscreen-parameters \fIname\fB=\fIvalue\fB,\fR...
Parameters for the screen driver.
See the
.B -X
.RB "(" "--screen-parameters=" ")"
option for details.
.TP
\fBspeech-driver \fIdriver\fB,\fR...|\fBauto\fR
The driver for the speech synthesizer.
See the
.B -s
.RB "(" "--speech-driver=" ")"
option for details.
.TP
\fBspeech-input \name\fR
The file system object which gives other applications access to
.BR brltty 's
speech driver for text-to-speech conversion.
See the
.B -i
.RB "(" "--speech-input=" ")"
option for details.
.TP
\fBspeech-parameters \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
Parameters for the speech synthesizer driver.
See the
.B -S
.RB "(" "--speech-parameters=" ")"
option for details.
.TP
\fBtext-table \fItable\fR
The text table.
See the
.B -t
.RB "(" "--text-table=" ")"
option for details.
.SS "Driver Specification"
A braille display or speech synthesizer driver
must be specified via its identification code:
.RS
.TP 4
.B al
Alva
.TP 4
.B at
Albatross
.TP 4
.B ba
BrlAPI
.TP 4
.B bc
BrailComm
.TP 4
.B bd
Braudi
.TP 4
.B bl
BrailleLite
.TP 4
.B bm
Baum
.TP 4
.B bn
BrailleNote
.TP 4
.B cb
CombiBraille
.TP 4
.B ec
EcoBraille
.TP 4
.B es
eSpeak
.TP 4
.B eu
EuroBraille
.TP 4
.B fl
FestivalLite
.TP 4
.B fs
FreedomScientific
.TP 4
.B fv
Festival
.TP 4
.B gs
GenericSay
.TP 4
.B hm
HIMS
.TP 4
.B ht
HandyTech
.TP 4
.B hw
HumanWare
.TP 4
.B il
IrisLinux
.TP 4
.B lb
Libbraille
.TP 4
.B lt
LogText
.TP 4
.B mb
MultiBraille
.TP 4
.B md
MDV
.TP 4
.B mn
MiniBraille
.TP 4
.B mp
Mikropuhe
.TP 4
.B mt
Metec
.TP 4
.B no
no driver
.TP 4
.B pg
Pegasus
.TP 4
.B pm
Papenmeier
.TP 4
.B sd
SpeechDispatcher
.TP 4
.B sk
Seika
.TP 4
.B sw
Swift
.TP 4
.B th
Theta
.TP 4
.B tn
TechniBraille Systems Inc.
.TP 4
.B ts
Telesensory Systems Inc.
.TP 4
.B tt
TTY
.TP 4
.B vd
VideoBraille
.TP 4
.B vo
Voyager, Part232 (serial adapter), BraillePen/EasyLink
.TP 4
.B vr
Virtual
.TP 4
.B vs
VisioBraille
.TP 4
.B vv
ViaVoice
.TP 4
.B xs
ExternalSpeech
.TP 4
.B xw
XWindow
.PP
A comma-delimited list of drivers may be specified.
If this is done then autodetection is performed using each listed driver in sequence.
You may need to experiment in order to determine the most reliable order
since some drivers autodetect better than others.
.PP
If the single word
.B auto
is specified then autodetection is performed
using only those drivers which are known to be reliable for this purpose.
.RE
.SH "SEE ALSO"
For full documentation, see
.BR brltty 's
on-line manual at
.RB "[" "http://mielke.cc/brltty/doc/Manual-HTML/Manual.html" "]."
@@ -0,0 +1,521 @@
# This is a configuration file template for the BRLTTY application.
# Uncomment those entries which apply to your personal needs and system
# requirements.
# BRLTTY expects to find its configuration file in "/etc/@CONFIGURATION_FILE@"
# (can be overridden with the -f [--configuration-file=] option).
# If it doesn't exist, then BRLTTY silently continues but may require
# that certain command line options be explicitly supplied.
# Blank lines are ignored. The character '#', anywhere on a line,
# initiates a comment; all characters from it to the end of that line
# are ignored.
# Each configuration entry consists of a keyword followed by its operand.
# An arbitrary amount of white space, (blanks and/or tabs), may occur
# before the keyword, as well as before and after the operand. Keyword
# processing is not case sensitive. Examples of valid entries are:
#
# Braille-Driver pm # Papenmeier braille displays.
# braille-device serial:ttyS0 # The first serial device.
# SPEECH-DRIVER fv # The Festival Text to Speech System.
# The default settings given within the following descriptions assume no
# special build options (see "./configure --help" in the top-level
# directory of the source tree.
############################
# Generic Braille Settings #
############################
# The braille-driver directive specifies the two-letter driver
# identification code of the driver for the braille display.
# If not specified, autodetection will be performed.
# (can be overridden with the -b [--braille-driver=] option)
#braille-driver auto # autodetect
#braille-driver al # Alva
#braille-driver at # Albatross
#braille-driver ba # BrlAPI
#braille-driver bc # BrailComm
#braille-driver bd # Braudi
#braille-driver bl # BrailleLite
#braille-driver bm # Baum
#braille-driver bn # BrailleNote
#braille-driver cb # CombiBraille
#braille-driver ec # EcoBraille
#braille-driver eu # EuroBraille
#braille-driver fs # FreedomScientific
#braille-driver hm # HIMS
#braille-driver ht # HandyTech
#braille-driver hw # HumanWare
#braille-driver il # IrisLinux
#braille-driver lb # Libbraille
#braille-driver lt # LogText
#braille-driver mb # MultiBraille
#braille-driver md # MDV (protocol 5)
#braille-driver mn # MiniBraille
#braille-driver mt # Metec
#braille-driver pg # Pegasus
#braille-driver pm # Papenmeier
#braille-driver sk # Seika
#braille-driver tn # TechniBraille
#braille-driver ts # TSI
#braille-driver tt # TTY
#braille-driver vd # VideoBraille
#braille-driver vo # Voyager, Part232 (serial adapter), BraillePen/EasyLink
#braille-driver vr # Virtual
#braille-driver vs # VisioBraille
#braille-driver xw # XWindow
# The braille-device directive specifies the device to which the braille
# display is connected. The generic syntax is type:device. The device
# type is optional, and, for backward compatibility, defaults to serial.
# The following devices are supported (brackets indicate optionality):
# serial:path (relative paths are anchored at "/dev")
# usb:[serial-number]
# bluetooth:address
# If not specified, "usb:" will be used.
# (can be overridden with the -d [--braille-device=] option)
#braille-device serial:ttyS0 # First serial device.
#braille-device usb: # First USB device matching braille driver.
#braille-device usb:nnnnn # Specific USB device by serial number.
#braille-device bluetooth:xx:xx:xx:xx:xx:xx # Specific bluetooth device by address.
#
# NOTE: If the device is connected via a serial-to-USB adapter then setting
# braille-device to usb: will not work. In this case it needs to identify the
# virtual serial device which the kernel has created for the adapter, i.e. to
# something like serial:ttyUSB0 (see the kernel messages on device plug to get
# the actual device name).
# The release-device directive specifies whether or not the device to which the
# braille display is connected is to be released when the current screen or
# window can't be read by BRLTTY. If not specified, "on" will be used on Windows
# platforms and "off" will be used on all other platforms.
# (can be overridden with the -r [--release-device] option)
#release-device on # Release the device.
#release-device off # Don't release the device.
# The text-table directive specifies which text table to use. Relative paths
# are anchored at "/etc/brltty". If not specified, locale-based
# autoselection with fallback to "en-nabcc" will be performed.
# (can be overridden with the -t [--text-table=] option)
#text-table auto # locale-based autoselection (fallback to "en-nabcc")
#text-table ar # Arabic (generic)
#text-table as # Assamese
#text-table awa # Awadhi
#text-table bg # Bulgarian
#text-table bh # Bihari
#text-table bn # Bengali
#text-table bo # Tibetan
#text-table bra # Braj
#text-table cs # Czech
#text-table cy # Welsh
#text-table da # Danish
#text-table de # German
#text-table dra # Dravidian
#text-table el # Greek
#text-table en # English
#text-table en_CA # English (Canada)
#text-table en_GB # English (United Kingdom)
#text-table en_US # English (United States)
#text-table en-nabcc # English (North American Braille Computer Code)
#text-table eo # Esperanto
#text-table es # Spanish
#text-table et # Estonian
#text-table fi # Finnish
#text-table fr # French
#text-table fr_CA # French (Canada)
#text-table fr_FR # French (France)
#text-table fr-2007 # French (unified)
#text-table fr-cbifs # French (Code Braille Informatique Français Standard)
#text-table ga # Irish
#text-table gd # Gaelic
#text-table gon # Gondi
#text-table gu # Gujarati
#text-table he # Hebrew
#text-table hi # Hindi
#text-table hr # Croatian
#text-table hu # Hungarian
#text-table hy # Armenian
#text-table is # Icelandic
#text-table it # Italian
#text-table kha # Khasi
#text-table kn # Kannada
#text-table kok # Konkani
#text-table kru # Kurukh
#text-table lt # Lituanian
#text-table lv # Latvian
#text-table mg # Malagasy
#text-table mi # Maori
#text-table ml # Malayalam
#text-table mni # Manipuri
#text-table mr # Marathi
#text-table mt # Maltese
#text-table mun # Mundari
#text-table mwr # Marwari
#text-table ne # Nepali
#text-table new # Newari
#text-table nl # Dutch
#text-table nl_BE # Dutch (Belgium)
#text-table nl_NL # Dutch (Netherlands)
#text-table no # Norwegian
#text-table no-generic # Norwegian (with support for other languages)
#text-table no-oub # Norwegian (Offentlig Utvalg for Blindeskrift)
#text-table nwc # Old Newari
#text-table or # Oriya
#text-table pa # Panjabi
#text-table pi # Pali
#text-table pl # Polish
#text-table pt # Portuguese
#text-table ro # Romanian
#text-table ru # Russian
#text-table sa # Sanskrit
#text-table sat # Santali
#text-table sd # Sindhi
#text-table sk # Slovak
#text-table sv # Swedish
#text-table sw # Swahili
#text-table ta # Tamil
#text-table te # Telugu
#text-table tr # Turkish
#text-table vi # Vietnamese
# The attributes-table directive specifies which attributes table to use.
# Relative paths are anchored at "/etc/brltty". If not specified,
# "attributes" will be used.
# (can be overridden with the -a [--attributes-table=] option)
#attributes-table attributes #
#attributes-table attrib #
# The contraction-table directive specifies which contraction table to use.
# Relative paths are anchored at "/etc/brltty". If not specified, no
# contraction table will be available.
# (can be overridden with the -c [--contraction-table=] option)
#contraction-table af # Afrikaans (contracted)
#contraction-table am # Amharic (uncontracted)
#contraction-table de-basis # German (uncontracted)
#contraction-table de-kurzschrift # German (contracted - 1998 standard)
#contraction-table de-vollschrift # German (basic contractions)
#contraction-table en-ueb-g2 # Unified English Braille (grade 2)
#contraction-table en-us-g2 # American English (grade 2)
#contraction-table es # Spanish (grade 2)
#contraction-table fr-abrege # French (contracted)
#contraction-table fr-integral # French (uncontracted)
#contraction-table ha # Hausa (contracted)
#contraction-table id # Indonesian (contracted)
#contraction-table ja # Japanese (uncontracted)
#contraction-table ko-g1 # Korean (grade 1)
#contraction-table ko-g2 # Korean (grade 2)
#contraction-table ko # Korean (uncontracted)
#contraction-table mg # Malagasy (contracted)
#contraction-table mun # Munda (contracted)
#contraction-table nl # Dutch (contracted)
#contraction-table ny # Chichewa (contracted)
#contraction-table ipa # International Phonetic Alphabet
#contraction-table pt # Portuguese (grade 2)
#contraction-table si # Sinhalese (uncontracted)
#contraction-table sw # Swahili (contracted)
#contraction-table th # Thai (contracted)
#contraction-table zh-tw # Taiwanese Chinese (uncontracted)
#contraction-table zh-tw-ucb # Taiwanese Chinese (Unique Chinese Braille)
#contraction-table zu # Zulu (contracted)
#############################
# Braille Driver Parameters #
#############################
# The braille-parameters directive passes non-generic parameters through
# to the braille driver.
# (can be overridden with the -B [--braille-parameters=] option)
#braille-parameters driver:parameter=setting,...
# BrlAPI Braille Driver Parameters
#braille-parameters ba:Auth=/etc/brlapi.key
#braille-parameters ba:Host=:0
# BrailleLite Braille Driver Parameters
#braille-parameters bl:BaudRate=9600 # [300,600,1200,2400,4800,9600,19200,38400]
#braille-parameters bl:KbEmu=yes # [yes,no]
# Baum Braille Driver Parameters
#braille-parameters bm:Protocols=default # [default,all,native]
#braille-parameters bm:VarioKeys=no # [no,yes]
# EuroBraille Braille Driver Parameters
#braille-parameters eu:Protocol= # [auto,azerbraille,clio,eurobraille,notebraille,pupibraille,scriba,esys,esytime,iris]
# HandyTech Braille Driver Parameters
#braille-parameters ht:SetTime=no # [no,yes]
# Iris Braille Driver Parameters
#braille-parameters ir:Embedded= # [no,yes]
#braille-parameters ir:LatchDelay= # [0-10000]
#braille-parameters ir:Protocol= # [eurobraille,native]
# Libbraille Braille Driver Parameters
#braille-parameters lb:Device=/dev/ttyS0 #
#braille-parameters lb:Driver=auto #
#braille-parameters lb:Table=us.tbl #
# TTY Braille Driver Parameters
#braille-parameters tt:Baud=9600 #
#braille-parameters tt:CharSet=ISO8859-1 #
#braille-parameters tt:Columns=40 # [1-80]
#braille-parameters tt:Lines=1 # [1-3]
#braille-parameters tt:Locale= #
#braille-parameters tt:Term=vt100 # [terminfo]
# VisioBraille Braille Driver Parameters
#braille-parameters vs:Baud=57600 #
#braille-parameters vs:DisplaySize=40 # [20-40]
#braille-parameters vs:PromVersion=4 # [3-6]
# XWindow Braille Driver Parameters
#braille-parameters xw:Columns=40 # [1-80]
#braille-parameters xw:Font=name # []
#braille-parameters xw:Input=off # [off,on]
#braille-parameters xw:Lines=1 # [1-3]
#braille-parameters xw:Model=bare # [bare]
#braille-parameters xw:TkParms= #
###########################
# Generic Speech Settings #
###########################
# The speech-driver directive specifies the two-letter driver
# identification code of the driver for the speech synthesizer.
# If not specified, autodetection will be performed.
# (can be overridden with the -s [--speech-driver=] option)
#speech-driver auto # autodetect
#speech-driver al # Alva
#speech-driver bl # BrailleLite
#speech-driver cb # CombiBraille
#speech-driver es # eSpeak (text to speech engine)
#speech-driver fl # FestivalLite (text to speech engine)
#speech-driver fv # Festival (text to speech engine)
#speech-driver gs # GenericSay (pipes to /usr/local/bin/say)
#speech-driver mp # Mikropuhe (text to speech engine)
#speech-driver sd # SpeechDispatcher (text to speech server)
#speech-driver sw # Swift (text to speech engine)
#speech-driver th # Theta (text to speech engine)
#speech-driver vv # ViaVoice (text to speech engine)
#speech-driver xs # ExternalSpeech (executes /usr/local/bin/externalspeech)
# The speech-input directive specifies the name of the file system object
# (FIFO, named pipe, named socket, etc) which can be used by external
# applications for text-to-speech conversion via BRLTTY's speech driver.
# Relative paths are anchored at the current working directory. If not
# specified, the file system object isn't created.
# (can be overridden with the -i [--speech-input=] option)
#speech-input /path/to/file-system-object
############################
# Speech Driver Parameters #
############################
# The speech-parameters directive passes non-generic parameters through
# to the speech driver.
# (can be overridden with the -S [--speech-parameters=] option)
#speech-parameters driver:parameter=setting,...
# eSpeak Speech Driver Parameters
#speech-parameters es:Path=
#speech-parameters es:PunctList=
#speech-parameters es:Voice=
# ExternalSpeech Speech Driver Parameters
#speech-parameters xs:Program=/usr/local/bin/externalspeech
#speech-parameters xs:Uid=65534
#speech-parameters xs:Gid=65534
# Festival Speech Driver Parameters
#speech-parameters fv:Command=festival # [/path/to/command]
#speech-parameters fv:Name= # [kevin,kal]
# FestivalLite Speech Driver Parameters
#speech-parameters fl:Pitch=100 # [50-200]
# GenericSay Speech Driver Parameters
#speech-parameters gs:Command=/usr/local/bin/say
# Mikropuhe Speech Driver Parameters
#speech-parameters mp:Name= # [/path/to/mikropuhe/name.pu5]
#speech-parameters mp:Pitch=0 # [-10-10]
# SpeechDispatcher Speech Driver Parameters
#speech-parameters sd:Language= # [two-letter language code]
#speech-parameters sd:Module= # [flite,festival,epos-generic,dtk-generic,...]
#speech-parameters sd:Port=6560 # [1-65535] # [1-65535]
#speech-parameters sd:Voice= # [male1,female1,male2,female2,male3,female3,child_male,child_female]
# Swift Speech Driver Parameters
#speech-parameters sw:Name= # [voice,/path/to/voice]
# Theta Speech Driver Parameters
#speech-parameters th:Age= # [1-99,-1--99]
#speech-parameters th:Gender= # [male,female,neuter]
#speech-parameters th:Language= # [two-letter language code]
#speech-parameters th:Name= # [voice,/path/to/voice]
#speech-parameters th:Pitch=0.0 # [-2.0-2.0]
# ViaVoice Speech Driver Parameters
#speech-parameters vv:IniFile=/usr/lib/ViaVoiceTTS/eci.ini
#speech-parameters vv:SampleRate= # [8000,11025,22050]
#speech-parameters vv:AbbreviationMode= # [on,off]
#speech-parameters vv:NumberMode= # [word,year]
#speech-parameters vv:SynthMode= # [sentence,none]
#speech-parameters vv:TextMode= # [talk,spell,literal,phonetic]
#speech-parameters vv:Language= # [AmericanEnglish,BritishEnglish,CastilianSpanish,MexicanSpanish,StandardFrench,CanadianFrench,StandardGerman,StandardItalian,SimplifiedChinese,BrazilianPortuguese]
#speech-parameters vv:Voice= # [AdultMale,AdultFemale,Child,ElderlyFemale,ElderlyMale]
#speech-parameters vv:VocalTract= # [male,female]
#speech-parameters vv:Breathiness= # [0-100]
#speech-parameters vv:HeadSize= # [0-100]
#speech-parameters vv:PitchBaseline= # [0-100]
#speech-parameters vv:PitchFluctuation= # [0-100]
#speech-parameters vv:Roughness= # [0-100]
#####################
# Keyboard Settings #
#####################
# The key-table directive specifies which key table to use. Relative paths are
# anchored at "/etc/brltty". If not specified, no key table is used.
# (can be overridden with the -k [--key-table=] option)
#key-table desktop # bindings for full keyboards
#key-table keypad # bindings for keypad-based navigation
#key-table laptop # bindings for keyboards without a keypad
# The keyboard-properties directive specifies which keyboards to monitor.
# If not specified, all keyboards are monitored.
# (can be overridden with the -K [--keyboard-properties=] option)
#keyboard-properties Type=any # [any,ps2,usb,bluetooth]
#keyboard-properties Vendor=0X0000 # [0X0000-0XFFFF]
#keyboard-properties Product=0X0000 # [0X0000-0XFFFF]
##################
# Sound Settings #
##################
# The pcm-device directive specifies the device to use for soundcard
# digital audio. If not specified, a method- and system-dependent
# default will be used.
# (can be overridden with the -p [--pcm-device=] option)
#pcm-device /path/to/device # most methods
#pcm-device pcm-handle-id # ALSA (see second parameter of snd_pcm_open)
# The midi-device directive specifies the device to use for the Musical
# Instrument Digital Interface. If not specified, a method- and
# system-dependent default will be used.
# (can be overridden with the -m [--midi-device=] option)
#midi-device /path/to/device # most methods
#midi-device client:port # ALSA (may use number or case-sensitive substring of name)
##########################
# Miscellaneous Settings #
##########################
# The preferences-file directive specifies the file in which to save the user's
# preferences. Relative paths are anchored at "@STATE_DIRECTORY@". If not
# specified, "@PREFERENCES_FILE@" will be used.
# (can be overridden with the -F [--preferences-file=] option)
#preferences-file @PREFERENCES_FILE@
# The log-level directive specifies the severity threshold for diagnostics
# written to the system log. Less severe diagnostics will not be logged. If not
# specified, "notice" will be used.
# (can be overridden with the -l [--log-level=] option)
#log-level emergency
#log-level alert
#log-level critical
#log-level error
#log-level warning
#log-level notice
#log-level information
#log-level debug
# The log-file directive specifies the file to which diagnostics are written.
# Relative paths are anchored at the current working directory. If not
# specified, diagnostics are written to the system log.
# (can be overridden with the -L [--log-file=] option)
#log-file /tmp/brltty.log
# The drivers-directory directive specifies the absolute path to the
# directory which contains the dynamically loadable drivers. If not
# specified, /lib/brltty will be used.
# (can be overridden with the -D [--drivers-directory=] option)
#drivers-directory /lib/brltty
# The writable-directory directive specifies the absolute path to a directory
# which can be written to (creation of missing but needed resources, etc). If
# not specified, "/lib/brltty/rw" will be used.
# (can be overridden with the -W [--writable-directory=] option)
#writable-directory /lib/brltty/rw
# The tables-directory directive specifies the absolute path to the directory
# which contains the text, attributes, contraction, and key tables. If not
# specified, "/etc/brltty" will be used.
# (can be overridden with the -T [--tables-directory=] option)
#tables-directory /etc/brltty
################################################
# Application Programming Interface Parameters #
################################################
# The api-parameters directive passes parameters to the Application
# Programming Interface.
# (can be overridden with the -A [--api-parameters=] option)
#api-parameters parameter=setting,...
#api-parameters Auth=keyfile:/etc/brlapi.key # Require authentication key
#api-parameters Auth=user:joe # Allow some local user
#api-parameters Auth=group:brl # Allow some local group
#api-parameters Host=:0 # Accept only local Unix connections
#api-parameters Host=0.0.0.0:0 # Accept any internet connection.
#api-parameters StackSize=65536
###########################
# Generic Screen Settings #
###########################
# The screen-driver directive specifies the two-letter driver
# identification code of the driver for the console screen.
# (can be overridden with the -x [--screen-driver=] option)
#screen-driver as # AtSpi
#screen-driver pb # PCBIOS
#screen-driver hd # Hurd
#screen-driver lx # Linux
#screen-driver sc # Screen
#screen-driver wn # Windows
############################
# Screen Driver Parameters #
############################
# The screen-parameters directive passes non-generic parameters through
# to the screen driver.
# (can be overridden with the -X [--screen-parameters=] option)
#screen-parameters driver:parameter=setting,...
# AtSpi Screen Driver Parameters
#screen-parameters as:Type=text+terminal # [text,terminal,all]
# Linux Screen Driver Parameters
#screen-parameters lx:Charset=name+... # []
#screen-parameters lx:DebugSfm=no # [no,yes]
#screen-parameters lx:Hfb=auto # [auto,vga,fb,0-7]
# Windows Screen Driver Parameters
#screen-parameters wn:Root=no # [no,yes]
#screen-parameters wn:FollowFocus=yes # [yes,no]
@@ -0,0 +1,521 @@
# This is a configuration file template for the BRLTTY application.
# Uncomment those entries which apply to your personal needs and system
# requirements.
# BRLTTY expects to find its configuration file in "@CONFIGURATION_DIRECTORY@/@CONFIGURATION_FILE@"
# (can be overridden with the -f [--configuration-file=] option).
# If it doesn't exist, then BRLTTY silently continues but may require
# that certain command line options be explicitly supplied.
# Blank lines are ignored. The character '#', anywhere on a line,
# initiates a comment; all characters from it to the end of that line
# are ignored.
# Each configuration entry consists of a keyword followed by its operand.
# An arbitrary amount of white space, (blanks and/or tabs), may occur
# before the keyword, as well as before and after the operand. Keyword
# processing is not case sensitive. Examples of valid entries are:
#
# Braille-Driver pm # Papenmeier braille displays.
# braille-device serial:@first_serial_device@ # The first serial device.
# SPEECH-DRIVER fv # The Festival Text to Speech System.
# The default settings given within the following descriptions assume no
# special build options (see "./configure --help" in the top-level
# directory of the source tree.
############################
# Generic Braille Settings #
############################
# The braille-driver directive specifies the two-letter driver
# identification code of the driver for the braille display.
# If not specified, autodetection will be performed.
# (can be overridden with the -b [--braille-driver=] option)
#braille-driver auto # autodetect
#braille-driver al # Alva
#braille-driver at # Albatross
#braille-driver ba # BrlAPI
#braille-driver bc # BrailComm
#braille-driver bd # Braudi
#braille-driver bl # BrailleLite
#braille-driver bm # Baum
#braille-driver bn # BrailleNote
#braille-driver cb # CombiBraille
#braille-driver ec # EcoBraille
#braille-driver eu # EuroBraille
#braille-driver fs # FreedomScientific
#braille-driver hm # HIMS
#braille-driver ht # HandyTech
#braille-driver hw # HumanWare
#braille-driver il # IrisLinux
#braille-driver lb # Libbraille
#braille-driver lt # LogText
#braille-driver mb # MultiBraille
#braille-driver md # MDV (protocol 5)
#braille-driver mn # MiniBraille
#braille-driver mt # Metec
#braille-driver pg # Pegasus
#braille-driver pm # Papenmeier
#braille-driver sk # Seika
#braille-driver tn # TechniBraille
#braille-driver ts # TSI
#braille-driver tt # TTY
#braille-driver vd # VideoBraille
#braille-driver vo # Voyager, Part232 (serial adapter), BraillePen/EasyLink
#braille-driver vr # Virtual
#braille-driver vs # VisioBraille
#braille-driver xw # XWindow
# The braille-device directive specifies the device to which the braille
# display is connected. The generic syntax is type:device. The device
# type is optional, and, for backward compatibility, defaults to serial.
# The following devices are supported (brackets indicate optionality):
# serial:path (relative paths are anchored at "/dev")
# usb:[serial-number]
# bluetooth:address
# If not specified, "@braille_device@" will be used.
# (can be overridden with the -d [--braille-device=] option)
#braille-device serial:@first_serial_device@ # First serial device.
#braille-device usb: # First USB device matching braille driver.
#braille-device usb:nnnnn # Specific USB device by serial number.
#braille-device bluetooth:xx:xx:xx:xx:xx:xx # Specific bluetooth device by address.
#
# NOTE: If the device is connected via a serial-to-USB adapter then setting
# braille-device to usb: will not work. In this case it needs to identify the
# virtual serial device which the kernel has created for the adapter, i.e. to
# something like serial:ttyUSB0 (see the kernel messages on device plug to get
# the actual device name).
# The release-device directive specifies whether or not the device to which the
# braille display is connected is to be released when the current screen or
# window can't be read by BRLTTY. If not specified, "on" will be used on Windows
# platforms and "off" will be used on all other platforms.
# (can be overridden with the -r [--release-device] option)
#release-device on # Release the device.
#release-device off # Don't release the device.
# The text-table directive specifies which text table to use. Relative paths
# are anchored at "@TABLES_DIRECTORY@". If not specified, locale-based
# autoselection with fallback to "@text_table@" will be performed.
# (can be overridden with the -t [--text-table=] option)
#text-table auto # locale-based autoselection (fallback to "@text_table@")
#text-table ar # Arabic (generic)
#text-table as # Assamese
#text-table awa # Awadhi
#text-table bg # Bulgarian
#text-table bh # Bihari
#text-table bn # Bengali
#text-table bo # Tibetan
#text-table bra # Braj
#text-table cs # Czech
#text-table cy # Welsh
#text-table da # Danish
#text-table de # German
#text-table dra # Dravidian
#text-table el # Greek
#text-table en # English
#text-table en_CA # English (Canada)
#text-table en_GB # English (United Kingdom)
#text-table en_US # English (United States)
#text-table en-nabcc # English (North American Braille Computer Code)
#text-table eo # Esperanto
#text-table es # Spanish
#text-table et # Estonian
#text-table fi # Finnish
#text-table fr # French
#text-table fr_CA # French (Canada)
#text-table fr_FR # French (France)
#text-table fr-2007 # French (unified)
#text-table fr-cbifs # French (Code Braille Informatique Français Standard)
#text-table ga # Irish
#text-table gd # Gaelic
#text-table gon # Gondi
#text-table gu # Gujarati
#text-table he # Hebrew
#text-table hi # Hindi
#text-table hr # Croatian
#text-table hu # Hungarian
#text-table hy # Armenian
#text-table is # Icelandic
#text-table it # Italian
#text-table kha # Khasi
#text-table kn # Kannada
#text-table kok # Konkani
#text-table kru # Kurukh
#text-table lt # Lituanian
#text-table lv # Latvian
#text-table mg # Malagasy
#text-table mi # Maori
#text-table ml # Malayalam
#text-table mni # Manipuri
#text-table mr # Marathi
#text-table mt # Maltese
#text-table mun # Mundari
#text-table mwr # Marwari
#text-table ne # Nepali
#text-table new # Newari
#text-table nl # Dutch
#text-table nl_BE # Dutch (Belgium)
#text-table nl_NL # Dutch (Netherlands)
#text-table no # Norwegian
#text-table no-generic # Norwegian (with support for other languages)
#text-table no-oub # Norwegian (Offentlig Utvalg for Blindeskrift)
#text-table nwc # Old Newari
#text-table or # Oriya
#text-table pa # Panjabi
#text-table pi # Pali
#text-table pl # Polish
#text-table pt # Portuguese
#text-table ro # Romanian
#text-table ru # Russian
#text-table sa # Sanskrit
#text-table sat # Santali
#text-table sd # Sindhi
#text-table sk # Slovak
#text-table sv # Swedish
#text-table sw # Swahili
#text-table ta # Tamil
#text-table te # Telugu
#text-table tr # Turkish
#text-table vi # Vietnamese
# The attributes-table directive specifies which attributes table to use.
# Relative paths are anchored at "@TABLES_DIRECTORY@". If not specified,
# "@attributes_table@" will be used.
# (can be overridden with the -a [--attributes-table=] option)
#attributes-table attributes #
#attributes-table attrib #
# The contraction-table directive specifies which contraction table to use.
# Relative paths are anchored at "@TABLES_DIRECTORY@". If not specified, no
# contraction table will be available.
# (can be overridden with the -c [--contraction-table=] option)
#contraction-table af # Afrikaans (contracted)
#contraction-table am # Amharic (uncontracted)
#contraction-table de-basis # German (uncontracted)
#contraction-table de-kurzschrift # German (contracted - 1998 standard)
#contraction-table de-vollschrift # German (basic contractions)
#contraction-table en-ueb-g2 # Unified English Braille (grade 2)
#contraction-table en-us-g2 # American English (grade 2)
#contraction-table es # Spanish (grade 2)
#contraction-table fr-abrege # French (contracted)
#contraction-table fr-integral # French (uncontracted)
#contraction-table ha # Hausa (contracted)
#contraction-table id # Indonesian (contracted)
#contraction-table ja # Japanese (uncontracted)
#contraction-table ko-g1 # Korean (grade 1)
#contraction-table ko-g2 # Korean (grade 2)
#contraction-table ko # Korean (uncontracted)
#contraction-table mg # Malagasy (contracted)
#contraction-table mun # Munda (contracted)
#contraction-table nl # Dutch (contracted)
#contraction-table ny # Chichewa (contracted)
#contraction-table ipa # International Phonetic Alphabet
#contraction-table pt # Portuguese (grade 2)
#contraction-table si # Sinhalese (uncontracted)
#contraction-table sw # Swahili (contracted)
#contraction-table th # Thai (contracted)
#contraction-table zh-tw # Taiwanese Chinese (uncontracted)
#contraction-table zh-tw-ucb # Taiwanese Chinese (Unique Chinese Braille)
#contraction-table zu # Zulu (contracted)
#############################
# Braille Driver Parameters #
#############################
# The braille-parameters directive passes non-generic parameters through
# to the braille driver.
# (can be overridden with the -B [--braille-parameters=] option)
#braille-parameters driver:parameter=setting,...
# BrlAPI Braille Driver Parameters
#braille-parameters ba:Auth=@CONFIGURATION_DIRECTORY@/@api_authkeyfile@
#braille-parameters ba:Host=:0
# BrailleLite Braille Driver Parameters
#braille-parameters bl:BaudRate=9600 # [300,600,1200,2400,4800,9600,19200,38400]
#braille-parameters bl:KbEmu=yes # [yes,no]
# Baum Braille Driver Parameters
#braille-parameters bm:Protocols=default # [default,all,native]
#braille-parameters bm:VarioKeys=no # [no,yes]
# EuroBraille Braille Driver Parameters
#braille-parameters eu:Protocol= # [auto,azerbraille,clio,eurobraille,notebraille,pupibraille,scriba,esys,esytime,iris]
# HandyTech Braille Driver Parameters
#braille-parameters ht:SetTime=no # [no,yes]
# Iris Braille Driver Parameters
#braille-parameters ir:Embedded= # [no,yes]
#braille-parameters ir:LatchDelay= # [0-10000]
#braille-parameters ir:Protocol= # [eurobraille,native]
# Libbraille Braille Driver Parameters
#braille-parameters lb:Device=/dev/ttyS0 #
#braille-parameters lb:Driver=auto #
#braille-parameters lb:Table=us.tbl #
# TTY Braille Driver Parameters
#braille-parameters tt:Baud=9600 #
#braille-parameters tt:CharSet=ISO8859-1 #
#braille-parameters tt:Columns=40 # [1-80]
#braille-parameters tt:Lines=1 # [1-3]
#braille-parameters tt:Locale= #
#braille-parameters tt:Term=vt100 # [terminfo]
# VisioBraille Braille Driver Parameters
#braille-parameters vs:Baud=57600 #
#braille-parameters vs:DisplaySize=40 # [20-40]
#braille-parameters vs:PromVersion=4 # [3-6]
# XWindow Braille Driver Parameters
#braille-parameters xw:Columns=40 # [1-80]
#braille-parameters xw:Font=name # []
#braille-parameters xw:Input=off # [off,on]
#braille-parameters xw:Lines=1 # [1-3]
#braille-parameters xw:Model=bare # [bare]
#braille-parameters xw:TkParms= #
###########################
# Generic Speech Settings #
###########################
# The speech-driver directive specifies the two-letter driver
# identification code of the driver for the speech synthesizer.
# If not specified, autodetection will be performed.
# (can be overridden with the -s [--speech-driver=] option)
#speech-driver auto # autodetect
#speech-driver al # Alva
#speech-driver bl # BrailleLite
#speech-driver cb # CombiBraille
#speech-driver es # eSpeak (text to speech engine)
#speech-driver fl # FestivalLite (text to speech engine)
#speech-driver fv # Festival (text to speech engine)
#speech-driver gs # GenericSay (pipes to /usr/local/bin/say)
#speech-driver mp # Mikropuhe (text to speech engine)
#speech-driver sd # SpeechDispatcher (text to speech server)
#speech-driver sw # Swift (text to speech engine)
#speech-driver th # Theta (text to speech engine)
#speech-driver vv # ViaVoice (text to speech engine)
#speech-driver xs # ExternalSpeech (executes /usr/local/bin/externalspeech)
# The speech-input directive specifies the name of the file system object
# (FIFO, named pipe, named socket, etc) which can be used by external
# applications for text-to-speech conversion via BRLTTY's speech driver.
# Relative paths are anchored at the current working directory. If not
# specified, the file system object isn't created.
# (can be overridden with the -i [--speech-input=] option)
#speech-input /path/to/file-system-object
############################
# Speech Driver Parameters #
############################
# The speech-parameters directive passes non-generic parameters through
# to the speech driver.
# (can be overridden with the -S [--speech-parameters=] option)
#speech-parameters driver:parameter=setting,...
# eSpeak Speech Driver Parameters
#speech-parameters es:Path=
#speech-parameters es:PunctList=
#speech-parameters es:Voice=
# ExternalSpeech Speech Driver Parameters
#speech-parameters xs:Program=/usr/local/bin/externalspeech
#speech-parameters xs:Uid=65534
#speech-parameters xs:Gid=65534
# Festival Speech Driver Parameters
#speech-parameters fv:Command=festival # [/path/to/command]
#speech-parameters fv:Name= # [kevin,kal]
# FestivalLite Speech Driver Parameters
#speech-parameters fl:Pitch=100 # [50-200]
# GenericSay Speech Driver Parameters
#speech-parameters gs:Command=/usr/local/bin/say
# Mikropuhe Speech Driver Parameters
#speech-parameters mp:Name= # [/path/to/mikropuhe/name.pu5]
#speech-parameters mp:Pitch=0 # [-10-10]
# SpeechDispatcher Speech Driver Parameters
#speech-parameters sd:Language= # [two-letter language code]
#speech-parameters sd:Module= # [flite,festival,epos-generic,dtk-generic,...]
#speech-parameters sd:Port=6560 # [1-65535] # [1-65535]
#speech-parameters sd:Voice= # [male1,female1,male2,female2,male3,female3,child_male,child_female]
# Swift Speech Driver Parameters
#speech-parameters sw:Name= # [voice,/path/to/voice]
# Theta Speech Driver Parameters
#speech-parameters th:Age= # [1-99,-1--99]
#speech-parameters th:Gender= # [male,female,neuter]
#speech-parameters th:Language= # [two-letter language code]
#speech-parameters th:Name= # [voice,/path/to/voice]
#speech-parameters th:Pitch=0.0 # [-2.0-2.0]
# ViaVoice Speech Driver Parameters
#speech-parameters vv:IniFile=/usr/lib/ViaVoiceTTS/eci.ini
#speech-parameters vv:SampleRate= # [8000,11025,22050]
#speech-parameters vv:AbbreviationMode= # [on,off]
#speech-parameters vv:NumberMode= # [word,year]
#speech-parameters vv:SynthMode= # [sentence,none]
#speech-parameters vv:TextMode= # [talk,spell,literal,phonetic]
#speech-parameters vv:Language= # [AmericanEnglish,BritishEnglish,CastilianSpanish,MexicanSpanish,StandardFrench,CanadianFrench,StandardGerman,StandardItalian,SimplifiedChinese,BrazilianPortuguese]
#speech-parameters vv:Voice= # [AdultMale,AdultFemale,Child,ElderlyFemale,ElderlyMale]
#speech-parameters vv:VocalTract= # [male,female]
#speech-parameters vv:Breathiness= # [0-100]
#speech-parameters vv:HeadSize= # [0-100]
#speech-parameters vv:PitchBaseline= # [0-100]
#speech-parameters vv:PitchFluctuation= # [0-100]
#speech-parameters vv:Roughness= # [0-100]
#####################
# Keyboard Settings #
#####################
# The key-table directive specifies which key table to use. Relative paths are
# anchored at "@TABLES_DIRECTORY@". If not specified, no key table is used.
# (can be overridden with the -k [--key-table=] option)
#key-table desktop # bindings for full keyboards
#key-table keypad # bindings for keypad-based navigation
#key-table laptop # bindings for keyboards without a keypad
# The keyboard-properties directive specifies which keyboards to monitor.
# If not specified, all keyboards are monitored.
# (can be overridden with the -K [--keyboard-properties=] option)
#keyboard-properties Type=any # [any,ps2,usb,bluetooth]
#keyboard-properties Vendor=0X0000 # [0X0000-0XFFFF]
#keyboard-properties Product=0X0000 # [0X0000-0XFFFF]
##################
# Sound Settings #
##################
# The pcm-device directive specifies the device to use for soundcard
# digital audio. If not specified, a method- and system-dependent
# default will be used.
# (can be overridden with the -p [--pcm-device=] option)
#pcm-device /path/to/device # most methods
#pcm-device pcm-handle-id # ALSA (see second parameter of snd_pcm_open)
# The midi-device directive specifies the device to use for the Musical
# Instrument Digital Interface. If not specified, a method- and
# system-dependent default will be used.
# (can be overridden with the -m [--midi-device=] option)
#midi-device /path/to/device # most methods
#midi-device client:port # ALSA (may use number or case-sensitive substring of name)
##########################
# Miscellaneous Settings #
##########################
# The preferences-file directive specifies the file in which to save the user's
# preferences. Relative paths are anchored at "@STATE_DIRECTORY@". If not
# specified, "@PREFERENCES_FILE@" will be used.
# (can be overridden with the -F [--preferences-file=] option)
#preferences-file @PREFERENCES_FILE@
# The log-level directive specifies the severity threshold for diagnostics
# written to the system log. Less severe diagnostics will not be logged. If not
# specified, "notice" will be used.
# (can be overridden with the -l [--log-level=] option)
#log-level emergency
#log-level alert
#log-level critical
#log-level error
#log-level warning
#log-level notice
#log-level information
#log-level debug
# The log-file directive specifies the file to which diagnostics are written.
# Relative paths are anchored at the current working directory. If not
# specified, diagnostics are written to the system log.
# (can be overridden with the -L [--log-file=] option)
#log-file /tmp/brltty.log
# The drivers-directory directive specifies the absolute path to the
# directory which contains the dynamically loadable drivers. If not
# specified, @DRIVERS_DIRECTORY@ will be used.
# (can be overridden with the -D [--drivers-directory=] option)
#drivers-directory @DRIVERS_DIRECTORY@
# The writable-directory directive specifies the absolute path to a directory
# which can be written to (creation of missing but needed resources, etc). If
# not specified, "@WRITABLE_DIRECTORY@" will be used.
# (can be overridden with the -W [--writable-directory=] option)
#writable-directory @WRITABLE_DIRECTORY@
# The tables-directory directive specifies the absolute path to the directory
# which contains the text, attributes, contraction, and key tables. If not
# specified, "@TABLES_DIRECTORY@" will be used.
# (can be overridden with the -T [--tables-directory=] option)
#tables-directory @TABLES_DIRECTORY@
################################################
# Application Programming Interface Parameters #
################################################
# The api-parameters directive passes parameters to the Application
# Programming Interface.
# (can be overridden with the -A [--api-parameters=] option)
#api-parameters parameter=setting,...
#api-parameters Auth=keyfile:@CONFIGURATION_DIRECTORY@/@api_authkeyfile@ # Require authentication key
#api-parameters Auth=user:joe # Allow some local user
#api-parameters Auth=group:brl # Allow some local group
#api-parameters Host=:0 # Accept only local Unix connections
#api-parameters Host=0.0.0.0:0 # Accept any internet connection.
#api-parameters StackSize=65536
###########################
# Generic Screen Settings #
###########################
# The screen-driver directive specifies the two-letter driver
# identification code of the driver for the console screen.
# (can be overridden with the -x [--screen-driver=] option)
#screen-driver as # AtSpi
#screen-driver pb # PCBIOS
#screen-driver hd # Hurd
#screen-driver lx # Linux
#screen-driver sc # Screen
#screen-driver wn # Windows
############################
# Screen Driver Parameters #
############################
# The screen-parameters directive passes non-generic parameters through
# to the screen driver.
# (can be overridden with the -X [--screen-parameters=] option)
#screen-parameters driver:parameter=setting,...
# AtSpi Screen Driver Parameters
#screen-parameters as:Type=text+terminal # [text,terminal,all]
# Linux Screen Driver Parameters
#screen-parameters lx:Charset=name+... # []
#screen-parameters lx:DebugSfm=no # [no,yes]
#screen-parameters lx:Hfb=auto # [auto,vga,fb,0-7]
# Windows Screen Driver Parameters
#screen-parameters wn:Root=no # [no,yes]
#screen-parameters wn:FollowFocus=yes # [yes,no]
@@ -0,0 +1,88 @@
Begin4
Title: brltty
Version: 4.3
Entered-date: 2011/10/10
Description: Braille Display Driver for Linux/Unix
BRLTTY is a background process (daemon) which provides access
to the console screen (when in text mode) for a blind person
using a refreshable braille display. It drives the braille
display, and provides complete screen review functionality. Some
speech capability has also been incorporated.
Keywords: refreshable braille display console access visually impaired blind linux unix
Author: dave@mielke.cc (Dave Mielke)
nico@fluxnic.net (Nicolas Pitre)
s.doyon@videotron.ca (Stéphane Doyon)
nn201@cus.cam.ac.uk (Nikhil Nair)
Maintained-by: dave@mielke.cc (Dave Mielke)
Primary-site: ftp.ibiblio.org /pub/Linux/system/access
2400KB brltty-4.3.tar.gz
1300KB brltty-4.3-1.i686.rpm
2300KB brltty-4.3-1.src.rpm
14KB brltty-4.3.README
4KB brltty-4.3.lsm
Alternate-site: ftp://leb.net /pub/blinux/brltty
Original-site:
Platforms: Linux (kernel 1.1.92 or later)
Solaris (release 7 or later)
OpenBSD (release 3.4 or later)
FreeBSD (release 5.1 or later)
NetBSD (release 1.6 or later)
Supported Braille Displays:
- Albatross [46/80]
- Alva [ABT(3nn), Delphi(4nn), Satellite(5nn), Braille System 40,
Braille Controller 640/680]
- Baum [Inka, Vario/RBT, SuperVario/Brailliant, PocketVario,
VarioPro, EcoVario, VarioConnect/BrailleConnect,
Refreshabraille]
- BrailComm [III]
- BrailleLite [18/40/M20/M40]
- BrailleNote [18/32]
- BrlAPI
- CombiBraille [25/45/85]
- EcoBraille [20/40/80]
- EuroBraille [AzerBraille, Clio, Esys, Iris, NoteBraille,
Scriba]
- FreedomScientific [Focus 1 44/70/84, Focus 2 40/80, Focus Blue 40,
PAC Mate 20/40]
- HandyTech [Modular 20/40/80, Modular Evolution 64/88,
Active Braille, Braille Wave, Easy Braille,
Braille Star 40/80, Bookworm, Braillino]
- HIMS [Braille Sense, SyncBraille]
- HumanWare [Brailliant 32/40/80 bi]
- IrisLinux
- Libbraille
- LogText [32]
- MDV [MB208/MB408L/MB408S (protocol 5)]
- Metec [BD-40]
- MiniBraille [20]
- MultiBraille [MB125CR/MB145CR/MB185CR]
- Papenmeier [Compact 486, Compact/Tiny, IB 80 CR Soft,
2D Lite (plus), 2D Screen Soft, EL 80,
EL 2D 40/66/80, EL 40/66/70/80 S, EL 2D 80 S,
EL 40 P, EL 80 II, Elba 20/32,
Trio 40/Elba20/Elba32]
- Pegasus [20/27/40/80]
- Seika [40]
- TSI [Navigator 20/40/80, PowerBraille 40/65/80]
- TTY [terminfo]
- VideoBraille [40]
- Virtual [TCP/Unix, client/server]
- VisioBraille [20/40]
- Voyager [44/70], Part232 (serial adapter), BraillePen/EasyLink
- XWindow [X11, Windows]
Supported Speech Synthesizers:
- Alva [Delphi(4nn)]
- BrailleLite
- CombiBraille
- eSpeak [text to speech engine]
- ExternalSpeech [runs /usr/local/bin/externalspeech]
- Festival [text to speech engine]
- FestivalLite [text to speech engine]
- GenericSay [pipes to /usr/local/bin/say]
- Mikropuhe [text to speech engine]
- SpeechDispatcher [text to speech server]
- Swift [text to speech engine]
- Theta [text to speech engine]
- ViaVoice [text to speech engine]
Copying-policy: GPL
End