Siguiente Anterior Contenido

3. El Procedimiento de Compilación

BRLTTY puede ser descargado desde su sitio web (mira la sección Información de Contacto para su localización). Todas las revisiones son proporcionadas como ficheros tar comprimidos. Las versiones más modernas también son proporcionadas como ficheros RPM (RedHat Package Manager).

Esa poquita información probablemente ha picado tu curiosidad, y ahora no puedes aguardar a comenzar. Es una buena idea, sin embargo, familiarizarse primero con los ficheros que serán instalados finalmente.

3.1 Jerarquía de Ficheros Instalados

El procedimiento de compilación debería resultar en la instalación de los siguientes ficheros:

/bin/

brltty

El programa BRLTTY.

brltty-install

Una herramienta para el copiado de la jerarquía de instalación de ficheros de BRLTTY desde un lugar a otro.

brltty-config

Una herramienta que ajusta un número de variables de entorno a valores que reflejen la actual instalación de BRLTTY.

/etc/

brltty.conf

Opciones predeterminadas para BRLTTY.

brlapi.key

La clave de acceso para BrlAPI.

/etc/brltty/

Tu instalación de BRLTTY podrá no tener todos los siguientes tipos de ficheros. Solamente son creados según se necesite basándose en las opciones de compilación que selecciones (mira Opciones de Compilación).

*.conf

Datos de configuración de para un controlador específico. Sus nombres se parecen más o menos a brltty-driver.conf, donde driver es el código de identificación del controlador de dos letras.

*.ctb

Tablas de contracción (mira la sección Braille Contraído para detalles). Sus nombres se parecen a language-country-level.ctb.

*.cti

Ficheros Include para las tablas de contracción.

*.hlp

Páginas de ayuda para un controlador específico. Sus nombres se parecen más o menos a brltty-driver.hlp, donde driver es el código de identificación del controlador de dos letras.

*.tbl

Tablas de transcripción (mira la sección Tablas de Transcripción para detalles). Sus nombres se parecen a text.language.tbl. También hay un par de tablas especiales que mapean atributos de resaltado de caracteres a puntos braille: attrib.tbl hace el modo original, and attributes.tbl hace el modo actual.

/lib/

libbrlapi.a

Archivo estático de la Application Programming Interface.

libbrlapi.so

Objeto cargable dinámicamente para la Application Programming Interface.

/lib/brltty/

Tu instalación de BRLTTY podrá no tener todos los siguientes tipos de fichero. Solamente son creados según se necesitó basándose en las opciones de compilación seleccionadas (mira Opciones de Compilación).

brltty-brl.lst

Una lista de controladores de líneas braille que han sido compilados como objetos compartidos cargables dinámicamente, y, por lo tanto, que pueden ser seleccionados en tiempo de ejecución. Cada línea consta de el código de identificación de dos letras para un controlador, un carácter tab, y una descripción de la línea braille para la que es.

libbrlttybdriver.so.1

El controlador dinámicamente cargable para una línea braille, donde driver es el código de identificación de dos letras.

brltty-spk.lst

Una lista de controladores de sintetizadores de voz que han sido compilados como objetos compartidos cargables dinámicamente, y, por lo tanto, que pueden ser seleccionados en tiempo de ejecución. Cada línea consta del código de identificación de dos letras para un controlador, un caracter tab, y una descripción del sintetizador de voz para el que es.

libbrlttysdriver.so.1

El controlador cargable dinámicamente para un sintetizador de voz, donde driver es el código de identificación del controlador de dos letras.

/include/brltty/

Ficheros de cabecera C para la Application Programming Interface. Sus nombres se parecen a function.h o function-driver.h (donde driver es el código de identificación del controlador) de dos letras.

/man/

Páginas Man.

man1/name.1

Páginas Man para BRLTTY que relatan las órdenes de usuario.

man3/name.3

Páginas Man para las rutinas de librería de la Application Programming Interface.

Algunos ficheros opcionales de los cuales deberías ser consciente, aunque no sean parte de la jerarquía de instalación de ficheros, son:

/etc/brltty.conf

El fichero de configuración de Las opciones predeterminadas del sistemaThe. Es creado por el administrador del sistema. Mira El Fichero de Configuración para detalles.

/etc/brltty-driver.prefs

El fichero de opciones de preferencias guardadas (driver es un código de identificación del controlador) de dos letras. Es creado por la orden PREFSAVE. Mira Opciones de Preferencias para detalles.

3.2 Instalando desde un Fichero TAR

Aquí está lo qué hacer si quieres instalar BRLTTY tan rápido como sea possible, confiando en que todas nuestras opciones predeterminadas sean correctas.

  1. Descargar los fuentes. Será un fichero llamado brltty-versión.tar.gz, ej.: brltty-3.0.tar.gz.
  2. Descomprime las fuentes en su estructura jerárquica nativa.
    tar xzf brltty-versión.tar.gz
    Esto debería crear el directorio brltty-versión.
  3. Cámbiate al directorio fuente, configura, compila, e instala BRLTTY.
    cd brltty-versión
    ./configure
    make install
    Esto debería hacerse como root.

Para desinstalar BRLTTY, haz:

cd brltty-versión
make uninstall

Eso es todo lo que hay. Ahora, para aquellos quienes realmente quieran saber qué está pasando, aquí están los detalles.

Opciones de Compilación

El primer paso compilando BRLTTY es configurarlo para tu sistema y/o para tus necesidades personales. Esto se hace ejecutando el script configure en el directorio de nivel superior de BRLTTY. Hemos tratado de hacer que las opciones predeterminadas sean las adecuadas para la mayoría de casos más comunes, asçi, asumiendo que no estás intentando hacer nada fuera de lo común, podrás no necesitar hacer nada más complicado que invocar este script sin especificar ninguna opción más.

./configure
Si, no obstante, tienes algún requerimiento especial, o también si eres aventurero, deberías averiguar qué opciones son.
./configure --help
También deberías revisar el fichero README en el subdirectorio que contenga el controlador para tu línea braille para cualquier instrucción específica adicional de la línea.

Opciones Predeterminadas del Sistema

--with-braille-driver=driver

Especifica los controladores de la línea braille que van a ser enlazados en el binario de BRLTTY. Aquellos controladores que no sean listados a través de esta opción son compilados como objetos compartidos enlazados dinámicamente y pueden todavía ser seleccionados en tiempo de ejecución. Cada controlador debe ser identificado o por su código de identificación de controlador de dos letras o por su nombre propio (completo o abreviado). Los identificadores de controlador deben ser separados entre sí por una coma. Si un identificador de controlador es prefijado por un signo menos (-), entonces ese controlador es excluido de la compilación. Cualquiera de la s siguientes palabras también puede ser utilizada como el operando de esta opción:

all

Enlaza todos los controladores en el binario. No compila ninguno de ellos como objetos compartidos cargables dinámicamente. Esta palabra también podrá ser especificada como el elemento final de una lista de controladores. Esto es especificar el controlador predeterminado cuando todos los controladores van a ser enlazados.

-all

Sólo compila aquellos controladores que han sido incluidos explícitamente a través de esta opción.

no

No compila ninguno de los controladores. Esto es equivalente a especificar --without-braille-driver.

yes

Compila todos los controladores como objetos compartidos cargables dinámicamente. No enlaza ningún de ellos en el binario. Esto equivale a especificar --with-braille-driver.

Mira la instrucción del fichero de configuración braille-driver y la opción de línea de órdenes -b para selección en tiempo de ejecución.

--with-braille-parameters=[driver:]name=value,...

Especifica las opciones de parámetro predeterminado para los controladores de la línea braille. Si se especifica el mismo parámetro más de una vez, entonces el valor asignado más a la derecha es utilizado. Si un nombre de parámetro es limitado por un controlador (mira la sección Códigos de Identificación del Controlador) entonces esa opción sólo se aplica a ese controlador; si no, se aplica a todos los controladores. Para una descripción de los parámetros aceptados por un controlador en especial, por favor mira la documentación para ese controlador. Mira la instrucción del fichero de configuración braille-parameters y la opción de línea de órdenes -B para selección en tiempo de ejecución.

--with-braille-device=device,...

Especifica el dispositivo predeterminado al que está conectada la línea braille (mira la sección Especificación de Dispositivo Braille). Si esta opción no es especificada, entonces usb: es adoptado si el soporte de USB está disponible, y una ruta del sistema apropiada para el puerto serie principal (primero) (dispositivo) es adoptado si no,. Mira la instrucción del fichero de configuración braille-device y la opción de línea de órdenes -d para selección en tiempo de ejecución.

--with-libbraille=directory

Especifica la localización de instalación del paquete Libbraille, y compila el controlador de línea braille Libbraille (mira Restricciones de Compilación). Cualquiera de las siguientes palabras también pueden ser utilizadas como el operando de esta opción:

no

No compila el controlador. Esto equivale a especificar --without-libbraille.

yes

Compila el controlador si el paquete puede ser encontrado en /usr, /usr/local, /usr/local/Libbraille, /usr/local/libbraille, /opt/Libbraille, o /opt/libbraille. Esto equivale a especificar --with-libbraille.

--with-text-table=file

Especifica la tabla de transcripción de texto predeterminada (mira la sección Transcripción de Texto para detalles). La ruta absoluta de una tabla externa al árbol fuente podrá ser especificado. La .tbl extensión es opcional. Para un simple nombre de fichero, el prefijo text. es opcional. Si esta opción no se especifica, entonces nabcc, una variante comúnmente utilizada (en Norteamérica) de 8 puntos del Código Braille Computerizado Norteamericano, es adoptada. Mira la instrucción del fichero de configuración text-table y la opción de línea de órdenes -t para selección en tiempo de ejecución. Esta opción puede ser cambiada con la preferencia Text Table.

--with-attributes-table=file

Especifica la tabla de transcripción de atributos predeterminada (mira la sección Transcripción de Atributos para detalles). La ruta absoluta para una tabla externa al árbol fuente podrá ser especificada. La extensión .tbl es opcional. Si esta opción no se especificó, entonces attributes es adoptada. Cámbialo a attrib si lo quisieras hacer al viejo modo. Mira la instrucción del fichero de configuración attributes-table y la opción de línea de órdenes -a para selección en tiempo de ejecución. Esta opción puede ser cambiada con la preferencia Attributes Table.

--with-speech-driver=driver

Especifica los controladores de la síntesis de voz que van a ser enlazados en el binario de BRLTTY. Aquellos controladores que no son listados a través de esta opción son compilados como objetos compartidos cargables dinámicamente y todavía pueden ser seleccionados en tiempo de ejecución. Cada controlador debe ser identificado o por su código de identificación de controlador de dos letras o por su propio nombre (completo o abreviado). Los identificadores de controlador deben ser separados entre sí por una coma sencilla. Si un identificador de controlador es prefijado por un signo menos (-), entonces ese controlador es excluído de la compilación. Cualquiera de las siguientes palabras puede ser también utilizada como el operando de esta opción:

all

Enlaza todos los controladores en el binario. No compila ninguno de ellos como objetos compartidos cargables dinámicamente. Esta palabra también podrá ser especificada como el elemento final de una lista de controladores. Así es cómo se especifica el controlador predeterminado cuando todos los controladores van a ser enlazados.

-all

Sólo compila aquellos controladores que hayan sido incluídos explícitamente a través de esta opción.

no

No compila ningún controlador. Esto equivale a especificar --without-speech-driver.

yes

Compila todos los controladores como objetos compartidos cargables dinámicamente. No enlaza ninguno de ellos en el binario. Esto equivale a especificar --with-speech-driver.

Mira la instrucción del fichero de configuración speech-driver y la opción de línea de órdenes -s para selección en tiempo de ejecución.

--with-speech-parameters=[driver:]name=value,...

Especifica las opciones de parámetro predeterminadas para los controladores de síntesis de voz. Si el mismo parámetro es especificado más de una vez, entonces su asignación más a la derecha es utilizada. Si un nombre de parámetro es cualificado por un controlador (mira la sección Códigos de Identificación de Controlador) entonces esa opción sólo se aplica a ese controlador; si no entonces se aplica a todos los controladores. Para una descripción de los parámetros aceptados por un controlador específico, por favor mira la documentación para ese controlador. Mira la instrucción del fichero de configuración speech-parameters y la opción de línea de órdenes -S para selección en tiempo de ejecución.

--with-flite=directory

Especifica el lugar de instalación del paquete de texto a voz FestivalLite, y compila el controlador del sintetizador de voz FestivalLite (mira Restricciónes de Compilación). Cualquiera de las siguientes palabras también puede ser utilizadas como el operando de esta opción:

no

No compila el controlador. Esto equivale a especificar --without-flite.

yes

Compila el controlador si el paquete puede ser encontrado en /usr, /usr/local, /usr/local/FestivalLite, /usr/local/flite, /opt/FestivalLite, o /opt/flite. Esto equivale a especificar --with-flite.

--with-flite-language=language

Especifica el idioma que el motor de texto a voz FestivalLite va a utilizar. El idioma predeterminado es usenglish.

--with-flite-lexicon=lexicon

Especifica el lexicon que el motor de texto a voz FestivalLite va a utilizar. El lexicon predeterminado es cmulex.

--with-flite-voice=voice

Especifica la voz que el motor de texto a voz FestivalLite va a utilizar. La voz predeterminada es cmu_us_kal16.

--with-mikropuhe=directory

Especifica el lugar de instalación de del paquete texto a voz Mikropuhe, y compila el controlador del sintetizador de voz Mikropuhe (mira Restricciones de Compilación). Cualquiera de las siguientes palabras también pueden ser utilizadas como el operando de esta opción:

no

No compila el controlador. Esto equivale a especificar --without-mikropuhe.

yes

Compila el controlador si el paquete puede ser encontrado en /usr, /usr/local, /usr/local/Mikropuhe, /usr/local/mikropuhe, /opt/Mikropuhe, o /opt/mikropuhe. Esto equivale a especificar --with-mikropuhe.

--with-speechd=directory

Especifica el lugar de instalación del paquete de texto a voz speech-dispatcher, y compila el controlador del sintetizador de voz speech-dispatcher. Cualquiera de las siguientes palabras puede también ser utilizada como el operando de esta opción:

no

No compila el controlador. Esto equivale a especificar --without-speechd.

yes

Compial el controlador si el paquete puede ser encontrado en /usr, /usr/local, /usr/local/speech-dispatcher, /usr/local/speechd, /opt/speech-dispatcher, o /opt/speechd. Esto equivale a especificar --with-speechd.

--with-swift=directory

Especifica el lugar de instalación del paquete de texto a voz Swift, y compila el controlador del sintetizador de voz Swift. Cualquiera de las siguientes palabras puede ser utilizada como el operando de esta opción:

no

No compila el controlador. Esto equivale a especificar --without-swift.

yes

Compila el controlador si el paquete puede ser encontrado en /usr, /usr/local, /usr/local/Swift, /usr/local/swift, /opt/Swift, o /opt/swift. Esto equivale a especificar --with-swift.

--with-theta=directory

Especifica el lugar de instalación del paquete de texto a voz Theta, y compila el controlador del sintetizador de voz Theta (mira Restricciones de Compilación). Cualquiera de las siguientes palabras pueden también ser utilizadas como el operando de esta opción:

no

No compila el controlador. Esto equivale a especificar --without-theta.

yes

Compila el controlador si el paquete puede ser encontrado en /usr, /usr/local, /usr/local/Theta, /usr/local/theta, /opt/Theta, o /opt/theta. Esto equivale a especificar --with-theta.

--with-viavoice=directory

Especifica el lugar de instalación del paquete de texto a voz ViaVoice, y compila el controlador del sintetizador de voz ViaVoice (mira Restricciones de Compilación). Cualquiera de las siguientes también puede ser utilizada como el operando de esta opción:

no

No compila el controlador. Esto equivale a especificar --without-viavoice.

yes

Compila el controlador si el paqete puede ser encontrado en /usr, /usr/local, /usr/local/ViaVoice, /usr/local/viavoice, /opt/ViaVoice, o /opt/viavoice. Esto equivale a especificar --with-viavoice.

--with-screen-driver=driver

Especifica los controladores de pantalla que van a ser enlazados en el binario de BRLTTY. Aquellos controladores que no son listados a través de esta opción son compilados como objetos compartidos cargables dinámicamente y todavía pueden ser seleccionados en tiempo de ejecución. Cada controlador debe ser identificado o por su código de identificación de controlador de dos letras (mira la sección Controladores de Pantalla Soportados) o por su nombre propio (entero o abreviado). Los identificadores de controlador deben ser separados entre sí por una coma simple. Si un identificador de controlador es prefijado por un signo menos (-), entonces ese controlador es excluído de la compilación. Cualquiera de las siguientes palabras también pueden ser utilizadas como el operando de esta opción:

all

Enlaza todos los controladores en el binario. No compila ninguno de ellos como objeto compartido cargable dinçamicamentedinámicamente. Esta palabra también podrá ser especificada como como el elemento final de una lista de controladores. Así es como se especifica el controlador predeterminado cuando todos los controladores van a ser enlazados.

-all

Sólo compilas aquellos controladores que hayan sido incluídos explícitamente a través de esta opción.

no

No compila níngún controlador. Esto equivale a especificar --without-screen-driver.

yes

Compila todos los controladores como objetos compartidos cargables dinámicamente. No compila ninguno de ellos en el binario. Esto equivale a especificar --with-screen-driver.

El primer controlador no excluído viene a ser el predeterminado. Si esta opción no es especificada, o si el controlador no es incluído específicamente, entonces uno predeterminado para el sistema operativo es seleccionado. Si un controlador nativo para para el actual sistema operativo está disponible, entonces ese controlador es seleccionado; si no, entonces sc es seleccionado. Mira la instrucción del fichero de configuración screen-driver y la opción de línea de órdenes -x para selección en tiempo de ejecución.

--with-screen-parameters=[driver:]name=value,...

Especifica las opciones de parámetros predeterminado para los controladores de pantalla. Si el mismo parámetro es especificado más de una vez, entonces su asignación de más a la derecha es utilizada. Si un nombre de parámetro es calificado por un controlador (mira la sección Controladores de Pantalla Soportados) entonces esa opción sólo se aplica a ese controlador; Si no es así, entonces se aplica a todos los controladores. Para una descripción de los parámetros aceptados por un controlador específico, por favor mira la documentación para ese controlador. Mira la instrucción del fichero de configuración screen-parameters y la opción de línea de órdenes -X para selección en tiempo de ejecución.

Especificación de Directorios

--with-execute-root=directory

Especifica el directorio en el que jerarquía de instalación de ficheros va a ser fijada en tiempo de ejecución. La ruta absoluta debería ser suministrada. Si esta opción no es especificada, entonces la raíz del sistema es adoptada. Utiliza esta opción si necesitas instalar los ficheros en tiempo de ejecución de BRLTTY en un lugar no estándar. Necesitas utilizar esta característica, por ejemplo, si quisieras tener más de una versión de BRLTTY instalada al mismo tiempo (mira la sección Instalando Versiones Múltiples para un ejemplo de cómo hacer esto).

--with-install-root=directory

Especifica el directorio bajo el cual la jerarquía de instalación de ficheros va a ser instalada. La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces el paquete en tiempo de ejecución raíz (mira la opción de compilación --with-execute-root) es adoptado. Este directorio sólo es utilizado por make install y make uninstall. Utiliza esta opción si necesitas instalar BRLTTY en un lugar diferente que el que será ejecutado finalmente. Necesitas utilizar esta característica, por ejemplo, si estás compilando BRLTTY en un sistema para utilizarlo en otro.

--prefix=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde van a ser fijados los directorios predeterminados para los ficheros independientes de la arquitectura. Estos directorios incluyen:

La ruta absoluta debería ser facilitada. Si esta opción no es especificada, Entonces la raíz del sistema es adoptada. Este directorio es fijado en el directorio especificado por la opción de compilación --with-execute-root.

--exec-prefix=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde van a ser fijados los directorios predeterminados para los ficheros dependientes de la arquitectura. Estos directorios incluyen:

La ruta absoluta debería ser suministrada. Si esta opción no es especificada, Entonces el directorio especificado a través de la opción de compilación --prefix es adoptado. Este directorio es fijado en el directorio especificado por la opción de compilación --with-execute-root.

--libdir=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde van a ser instalados los archivos estáticos y los objetos cargables dinámicamente para la Application Programming Interface. La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces el directorio especificado a través de la opción estándar de configure --libdir (que está predeterminadamente en /lib fija en el directorio especificado por la opción de compilación --exec-prefix) es adoptado. El directorio es creado si no existe.

--sysconfdir=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde van a ser instalados los ficheros de configuración. La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces el directorio especificado a través de la opción estándar de configure --sysconfdir (que predetermina a /etc fijado en el directorio especificado por la opción de compilación --prefix) es adoptado. El directorio es creado si no existe.

--with-program-directory=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde van a ser instalados los programas ejecutables (binarios, ejecutables). La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces el directorio especificado a través de la opción estándar de configure --bindir (que predetermina a /bin fijado en el directorio especificado por la opción de compilación --exec-prefix) es adoptado. El directorio es creado si no existe.

--with-library-directory=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde van a ser instalados los controladores y otros ficheros dependientes de la arquitectura. La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces el subdirectorio brltty del directorio especificado a través de la opción estándar de configure --libdir (que predetermina a /lib fijado en el directorio specified por la opción de compilación --exec-prefix) es adoptado. El directorio es creado si no existe.

--with-data-directory=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde se van a instalar las tablas, páginas de ayuda, y otros ficheros independientes de la arquitectura. La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces el subdirectorio brltty del directorio especificado a través de la opción estándar de configure --sysconfdir (que predetermina a /etc fijado en el directorio especificado por la opción de compilación --prefix) es asumido. El directorio es creado si no existe.

--with-manpage-directory=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde van a ser instaladas las páginas man. La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces el directorio especificado a través de la opción estándar configure --mandir (que predetermina a /man fijado al directorio especificado por la opción de compilación --prefix) es adoptado. El directorio es creado si no existe.

--with-include-directory=directory

Especifica el directorio dentro de la jerarquía de instalación de ficheros donde van a ser instalados los ficheros de cabecera C para la Application Programming Interface. La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces el subdirectorio brltty del directorio especificado a través de la opción estándar de configure --includedir (que predetermina a /include fijado en el directorio especificado por la opción de compilación --prefix) es adoptado. El directorio es creado si no existe.

Características de Compilación

Estas opciones son principalmente útiles cuando se compila BRLTTY para utilizarlo en un disco de arranque.

--enable-standalone-programs

Crea programas enlazados estático, en lugar de enlazados dinámicamente. Esta opción elimina todas las dependencias en los objetos compartidos en tiempo de ejecución. Sólo los controladores predeterminados (mira las opciones de compilación --with-braille-driver, --with-speech-driver, y --with-screen-driver) son compilados.

--enable-relocatable-install

Si esta característica está habilitada entonces todas las rutas internas son recalculadas para ser relativas al directorio del programa. Si está deshabilitada entonces todas las rutas internas son absolutas. Esta característica permite a toda la jerarquía de instalación de ficheros ser copiada o movida, en realidad, de un lugar a otro, y está principalmente pensado para utilizar en plataformas Windows.

--disable-preferences-menu

Reduce el tamaño del programa excluyendo el menú preferences (mira la sección El Menú Preferences).

--disable-table-selection

Reduce el tamaño del programa excluyendo las entradas de selección de tabla desde el menú preferences (mira las preferencias Text Table, Attributes Table, y Contraction Table).

--disable-learn-mode

Reduce el tamaño del programa excluyendo el modo de aprendizaje de órdenes (mira la sección Modo de Aprendizaje de Órdenes).

--disable-contracted-braille

Reduce el tamaño del programa excluyendo el soporte para braille contraído (mira la sección Braille Contraído).

--disable-usb-support

Reduce el tamaño del programa excluyendo el soporte para dispositivos USB.

--disable-bluetooth-support

Reduce el tamaño del programa excluyendo el soporte para dispositivos bluetooth.

--disable-speech-support

Reduce el tamaño del programa excluyendo el soporte para sintetizadores de voz.

--disable-iconv

Reduce el tamaño del programa excluyendo el soporte para grupo de conversión de carácteres.

--disable-beeper-support

Reduce el tamaño del programa excluyendo el soporte para el generador de tonos de consola.

--disable-pcm-support

Reduce el tamaño del programa excluyendo el soporte para la interface de audio digital de la targeta de sonido.

--enable-pcm-support=interface

Si una plataforma proporciona más de una interface de audio digital entonces la que va a ser utilizada podrá ser especificada.

PlataformaInterfaceDescripción
LinuxossOpen Sound System
alsaAdvanced Linux Sound Architecture

--disable-midi-support

Reduce el tamaño del programa excluyendo el soporte para la Musical Instrument Digital Interface de la targeta de sonido.

--enable-midi-support=interface

Si una plataforma proporciona más de una Musical Instrument Digital Interface entonces la que va a ser utilizada podrá ser especificada.

PlataformaInterfaceDescripción
LinuxossOpen Sound System
alsaAdvanced Linux Sound Architecture

--disable-fm-support

Reduce el tamaño del programa excluyendo el soporte para el sintetizador FM en una AdLib, OPL3, Sound Blaster, o targeta de sonido equivalente.

--disable-pm-configfile

Reduce el tamaño del programa excluyendo el soporte para el fichero de configuración del controlador de la Papenmeier.

--disable-gpm

Reduce el tamaño del programa excluyendo la interface para la aplicación gpm que permite a BRLTTY interactuar con el dispositivo del puntero del ratón (mira la sección Soporte del Puntero del Ratón a través de GPM).

--disable-api

Reduce el tamaño del programa excluyendo la Application Programming Interface.

--with-api-parameters=name=value,...

Especifica las opciones de parámetro predeterminadas para la Application Programming Interface. Si el mismo parámetro es especificado más de una vez, entonces su asignación de más a la derecha es utilizada. Para una descripción de los parámetros aceptados por la interface, por favor mira el manual de referencia de BrlAPI. Mira la opción de línea de órdenes api-parameters configuration file directive y -A para selección en tiempo de ejecución.

--disable-caml-bindings

No compila las Caml bindings para la Application Programming Interface.

--disable-java-bindings

No compila las Java bindings para la Application Programming Interface.

--disable-lisp-bindings

No compila las Lisp bindings para la Application Programming Interface.

--disable-python-bindings

No compila las Python bindings para la Application Programming Interface.

--disable-tcl-bindings

No compila las Tcl bindings para la Application Programming Interface.

--with-tcl-config=path

Especifica la localización del script de configuración Tcl (tclConfig.sh). O la ruta al script mismo o al directorio que lo contiene podrán ser facilitados. Cualquiera de las siguientes palabras también puede ser utilizada como el operando de esta opción :

no

Utiliza otros medios para adivinar si Tcl está disponible, y, si es así, dónde ha sido instalado. Esto equivale a especificar --without-tcl-config.

yes

Busca el script en unos cuantos directorios comúnmente utilizados. Esto equivale a especificar --with-tcl-config.

Opciones Misceláneas

--with-compiler-prefix=prefix

Especifica el prefijo (ruta y comienzo del nombre del programa) para el juego de herramientas de compilación y enlazado que van a ser utilizadas. Podrás necesitar utilizar esta opción si, por ejemplo, estás compilando para una arquitectura diferente.

--with-init-path=path

Especifica la ruta al programa init real para el sistema. La ruta absoluta debería ser facilitada. Si esta opción es especificada, entonces:

  1. El programa init debería ser movido a una nueva localización.
  2. brltty debería ser movido a la localización original del programa init.
  3. Cuando el sistema ejecute init al iniciarse, brltty está actualmente ejecutándose. Se pone en segundo plano, y ejecuta el init real en primer plano. Esto es un modo (poco ortodoxo) para tener braille directo en el inicio. Es especialmente útil para algunos discos de instalación/rescate.
Si esta opción no es especificada, entonces esta característica activada. Esta opción está principalmente pensada para compilar una imagen de instalador braillificado.

--with-stderr-path=path

Especifica la ruta al fichero o dispositivo donde la salida estándar de errores va a ser escrita. La ruta absoluta debería ser facilitada. Si esta opción no es especificada, entonces esta característica no es activada. Esta opción está principalmente pensada para compilar una imagen de instalador braillificado.

Objetivos del Fichero Make

Una vez que BRLTTY ha sido configurado, los siguientes pasos son compilarlo e instalarlo. Estos son hechos aplicando la orden del sistema make al fichero make principal de BRLTTY (Makefile en el directorio de nivel superior). El fichero make de BRLTTY soporta la mayoría de los objetivos comunes de mantenimiento de la aplicación. Incluye:

make

Un atajo para make all.

make all

Compila y enlaza el ejecutable BRLTTY, sus controladores y sus páginas de ayuda, sus programas de test, y unas cuantas pequeñas utilidades más.

make install

Completa la fase de compilado y enlazado (mira make all), y luego instala el ejecutable BRLTTY, sus ficheros de datos, controladores, y páginas de ayuda, en los lugares adecuados y con los permisos correctos.

make uninstall

Elimina el ejecutable BRLTTY, sus ficheros de datos, controladores, y páginas de ayuda, del sistema.

make clean

Se asegura de que la siguiente compilado y enlazado (mira make all) será hecho desde cero eliminando los resultados de compilación, enlazado, y testeo de la estructura del directorio fuente. Esto incluye la eliminación de ficheros objeto, ejecutables, objetos compartidos cargables dinámicamente, listas de controladores, páginas de ayuda, ficheros cabecera temporales, y ficheros del centrales.

make distclean

Además de eliminar los resultados de compilación y enlazado (mira make clean):

3.3 Probando BRLTTY

Después de compilar, enlazar, e instalar BRLTTY, es una buena idea hacerle una rápida prueba antes de activarlo permanentemente. Para hacer eso, invócalo con la orden:

brltty -bcontrolador -ddispositivo
Para controlador, especifica las dos letras del código de identificación de controlador correspondiente a tu línea braille. Para dispositivo, especifica la ruta completa para el dispositivo al que está conectada tu línea braille.

Si no quieres identificar explícitamente el controlador y dispositivo cada vez que inicies BRLTTY, entonces puedes tomar dos aproximaciones. Puedes establecer predeterminaciones del sistema a través de las instrucciones del fichero de configuración braille-driver y braille-device, y/o compilar estrictamente lo necesario en BRLTTY a través de las opciones de compilación --with-braille-driver y --with-braille-device.

Si todo va bien, el mensaje de identificación de versión de BRLTTY debería aparecer en la línea braille por unos segundos (mira la opción de línea de órdenes -M). Después de ir fuera (lo que puedes acelerar presionando cualquier tecla en la línea), el área de la pantalla donde está el cursor debería aparecer. Esto significa que deberías esperar ver el indicativo de órdenes de tu shell. Luego, según introduces tu siguiente orden, cada caracter debería aparecer en la línea según lo tecleas en el teclado.

Si esta es tu experiencia, entonces deja correr a BRLTTY, y disfrútalo. Si no es esta tu experiencia, entonces podrá ser necesario testear cada controlador separadamente en orden a aislar la fuente del probledma. El controlador de pantalla puede ser testeado con scrtest, y el controlador de la línea braille puede ser testeado con brltest.

Si experimentas un problema que requiera mucha dificultad, entonces podrás desear utilizar la siguientes opciones de línea de órdenes de brltty:

3.4 Iniciando BRLTTY

BRLTTY, cuando se instaló apropiadamente, es invocado con la sencilla orden brltty. Un fichero de configuración (mira la sección El Fichero de Configuración para detalles) puede ser creado en orden a establecer opciones predeterminadas del sistema para cosas tales como la localización del fichero de preferencias, el controlador de la línea braille a ser utilizado, el dispositivo al que la línea braille está conectada, y la tabla de transcripción de texto a ser utilizada. Muchas opciones (mira la sección Opciones de Línea de Órdenes para detalles) permiten la especificación explícita en tiempo de ejecución de cosas tales como la localización del fichero de configuración, cualquiera de las opciones predeterminadas establecidas dentro del fichero de configuración, y algunas características que opciones predeterminadas razonables pero que aquellos quienes piensen saber qué están haciendo podrán desear tocar. La opción -h muestra un resumen de todas las opciones. La opción -V muestra la versión actual del programa, la API, y los controladores seleccionados. La opción -v muestra los valores de las opciones después que todas las fuentes hayan sido consideradas.

Probablemente es mejor tener el inicio automático del sistema BRLTTY como una parte de la secuencia de arranque tal que la línea braille esté ya activada y ejecutandose cuando el login aparezca. La mayoría (probablemente todas) las distribuciones proporcionan un script donde el usuario facilita las aplicaciones que pueden ser iniciadas de modo seguro más cerca del fin de la secuencia de arranque. El nombre de este script depende de la distribución. Aquí están algunos acerca de los que sabemos:

Red Hat

/etc/rc.d/rc.local

Iniciar BRLTTY desde este script es una buena aproximación especialmente para los nuevos usuarios). Añade sólo un conjunto de líneas como estas:

if [ -x /bin/brltty -a -f /etc/brltty.conf ]
then
   /bin/brltty
fi
Esto también puede ser abreviado normalmente a algo menos legible desde:
[ -x /bin/brltty -a -f /etc/brltty.conf ] && /bin/brltty
No añadas estas líneas antes de la primera línea (que normalmente se parece a #!/bin/sh).

Si la línea braille va a ser utilizada por un administrador del sistema, entonces probablemente debería ser iniciado tan pronto como sea posible durante la secuencia de arranque (como antes de que el sistema de ficheros sea verificado) tal que la línea es utilizable en el caso que algo vaya mal durante estas verificaciones y el sistema caiga al modo mono usuario. Nuevamente, exactamente cuando es mejor hacer esto depende de la distribución. Aquí están los lugares que sabemos acerca de ello:

Debian

/etc/init.d/boot (para versiones antiguas)
/etc/init.d/rcS (para versiones modernas)
A brltty paquete es proporcionado (mira [ http://packages.debian.org/brltty]) según la versión 3.0 (Woody). Ten cuidado desde este paquete arrancando BRLTTY, No es necesario para el usuario facilitar código para hacerlo si está instalado.

RedHat

/etc/rc.d/rc.sysinit
Cuidado que las versiones más recientes, en orden a soportar un procedimiento de inicialización orientado a más de un usuario, ha de reinvocar este script así mismo tal que esté bajo el control de initlog. Busca, probablemente arriba cerca de la parte superior, un conjunto de líneas como estas:

    # Rerun ourselves through initlog
    if [ -z "$IN_INITLOG" ]; then
      [ -f /sbin/initlog ] && exec /sbin/initlog $INITLOG_ARGS -r /etc/rc.sysinit
    fi
    
Iniciar BRLTTY antes de esta reinvocación resulta en dos procesos de BRLTTY ejecutándose a la vez, y eso te dará problemas sin final. Si tu versión de este script tiene esta característica, Entonces asegúrate de iniciar BRLTTY después de las líneas que lo implementan.

Slackware

/etc/rc.d/rc.S

SuSE

/sbin/init.d/boot

Una alternativa es iniciar BRLTTY desde /etc/inittab. Tienes dos elecciones si escoges esta ruta.

Examina ese identificador (bt en estos ejemplos) ya no está siendo utilizado por otras entradas, y, si es así, elige uno diferente que no lo sea.

Nota que una orden como kill -TERM es suficiente para detener BRLTTY en sus tracks. Si muere durante la entrada en modo mono usuario, por ejemplo, podrá ser bueno debido a un problema de esta naturaleza.

Algunos sistemas, como parte de la secuencia de arranque, pruevan los puertos serie (normalmente en orden a encontrar automáticamente el ratón y deducir su tipo). Si tu línea braille está utilizando un puerto serie, Este tipo de prueba podrá ser bastante para confundirla. Si esto te sucede a ti, entonces trata de reiniciar el controlador de la línea (mira la orden RESTARTBRL). Mejor aún, apaga el puerto serie pobado. Aquí está qué sabemos al respecto acerca de cómo hacer esto:

Red Hat

La prueba es hecha por un servicio llamado kudzu. Utiliza la orden

chkconfig --list kudzu
para ver si está siendo habilitado. Utiliza la orden
chkconfig kudzu off
para deshabilitarlo. Las versiones más modernas te permiten dejar ejecutándose a kudzu sin probar los puertos serie. Para hacer esto, edita el fichero /etc/sysconfig/kudzu, y ajusta SAFE a yes.

Si quieres iniciar BRLTTY antes de que cualquier fichero del sistema sea montado, entonces asegúrate de que todos sus componentes están instalados dentro del sistema de ficheros raíz. Mira las opciones de compilación --with-execute-root, --bindir, --with-data-directory, y --libdir.

3.5 Consideraciones de Seguridad

BRLTTY necesita ejecutarse con privilegios de root porque necesita leer y escribir accediendo al puerto al que la línea braille esté conectada, y leer accediendo a /dev/vcsa o equivalente (para averiguar las dimensiones de la pantalla y la posición del cursor, y revisar el contenido y resaltado actual de la pantalla), y leer y escribir accediendo a la consola del sistema (mediante la introducción de las teclas de cursor durante el enrutamiento del cursor, para la inserción de caracteres de entrada durante el pegado, para la simulación de teclas especiales utilizando teclas en la línea braille, para recuperar la transcripción de caracteres de salida y mapeado de tablas de fuentes de pantalla, y para la activación de del altavoz interno). Acceder a los dispositivos necesarios puede, por supuesto, ser garantizado para un usuario no root cambiando los permisos del fichero asociado con los dispositivos. Simplemente teniendo acceso a la consola, no obstante, no es bastante porque activando el altavoz interno y simulando combinaciones de teclas todavía requieren privilegios del root. Así, si estás dispuesto a renunciar al enrutamiento del cursor, cortado y pegado, pitidos, y todo eso, puedes ejecutar BRLTTY sin privilegios de root.

3.6 Restricciones de Compilación y en Tiempo de Ejecución

Tonos de Alerta

Algunas plataformas no soportan todos los dispositivos de tonos. Mira la preferencia Tune Device para detalles.

Controlador del Sintetizador de Voz FestivalLite

El controlador para el motor de texto a voz FestivalLite sólo es compilado si ese paquete ha sido instalado.

Este controlador y el controlador para el motor de texto a voz Theta (mira la opción de compilación --with-theta) no pueden ser enlazados simultáneamente en el binario de BRLTTY (mira la opción de compilación --with-speech-driver) porque sus librerías en tiempo de ejecución contienen símbolos conflictivos.

Controlador de línea braille Libbraille

El controlador para el paquete Libbraille sólo es compilado si ese paquete ha sido instalado.

Controlador del sintetizador de voz Mikropuhe

El controlador para el motor de texto a voz Mikropuhe sólo es compilado si ese paquete ha sido instalado.

Este controlador no puede ser incluído si el binario de BRLTTY es enlazado estáticamente (mira la opción de compilación --enable-standalone-programs) porque un archivo estático no es incluído con el paquete.

Controlador del Sintetizador de voz Theta

El controlador para el motor de texto a voz Theta sólo es compilado si ese paquete ha sido instalado.

Este controlador y el controlador para el motor de texto a voz FestivalLite (mira la opción de compilación --with-flite) no pueden ser enlazados simultáneamente en el binario de BRLTTY (mira la opción de compilación --with-speech-driver) porque sus librerías en tiempo de ejecución contienen símbolos conflictivos.

Si este controlador es compilado como un objeto compartido cargable dinámicamente entonces $THETA_HOME/lib debe ser añadido a la variable de entorno LD_LIBRARY_PATH antes de que BRLTTY sea invocado porque los objetos compartidos dentro del paquete no contienen búsqueda de rutas en tiempo de ejecución para sus dependencias.

Controlador para el sintetizador de voz ViaVoice

El controlador para el motor de texto a voz ViaVoice sólo es compilado si ese paquete ha sido instalado.

Este controlador no puede ser incluído si el binario de BRLTTY está enlazado estáticamente (mira la opción de compilación --enable-standalone-programs) porque un archivo estático no es incluído con el paquete.

Controlador de la Línea Braille VideoBraille

El controlador para la línea braille VideoBraille es compilado en todos los sistemas, pero solamente funciona en Linux.

3.7 Instalando desde un Fichero RPM

Para instalar BRLTTY desde un fichero RPM (RedHat Package Manager), haz lo siguiente:

  1. Descarga el paquete de binarios correspondiente a tu hardware. Será un fichero llamado brltty-release-versión.arquitectura.rpm, ej.: brltty-3.0-1.i386.rpm.
  2. Instala el paquete.
    rpm -Uvh brltty-release-versión.arquitectura.rpm
    Esto debería ser hecho como root. Estrictamente hablando, la opción -U (update) sólo es la que es necesaria. La opción -v (verbose) muestra el nombre del paquete según está siendo instalado. La opción -h (hashes) muestra una medición del progreso (utilizando grupo de signos).
Para los atrevidos, también proporcionamos el fichero RPM fuente (.src.rpm), pero eso va más allá del ámbito de este documento.

Para desinstalar BRLTTY, haz:

rpm -e brltty

3.8 Otras Utilidades

La compilación de BRLTTY también tiene como resultado la compilación de unas cuantas pequeñas herramientas de ayuda y diagnóstico.

brltty-config

Esta utilidad ajusta un número de variables de entorno a valores que reflejan la instalación actual de BRLTTY (mira Opciones de Compilación). Debería ser ejecutado dentro de un entorno de shell existente, es decir, no como una orden en interna, y sólo puede ser utilizado por scripts que soporten la sintaxis de Bourne Shell.

. brltty-config

Las siguientes variables de entorno son ajustadas:

BRLTTY_VERSION

El número de versión del paquete BRLTTY.

BRLTTY_EXECUTE_ROOT

Raíz en tiempo de ejecución para el paquete instalado. Configurado a través de la opción de compilación --with-execute-root.

BRLTTY_PROGRAM_DIRECTORY

Directorio para los programas ejecutables (binarios, ejecutables). Configurados a través de la opción de compilación --with-program-directory.

BRLTTY_LIBRARY_DIRECTORY

Directorio para controladores. Configurado a través de la opción de compilación --with-library-directory.

BRLTTY_DATA_DIRECTORY

Directorio para tablas y páginas de ayuda. Configurado a través de la opción de compilación --with-data-directory.

BRLTTY_MANPAGE_DIRECTORY

Directorio para páginas de manual. Configurado a través de la opción de compilación --with-manpage-directory.

BRLTTY_INCLUDE_DIRECTORY

Directorio para los ficheros C cabecera de la BrlAPI. Configurado a través de la opción de compilación --with-include-directory.

BRLAPI_VERSION

El número de versión de la BrlAPI (Application Programming Interface de BRLTTY).

BRLAPI_RELEASE

El número completo de versión de BrlAPI.

BRLAPI_AUTH

El nombre del fichero clave de BrlAPI.

Además, las siguientes variables de entorno estándar de autoconf también son ajustadas:

prefix

Subroot para los ficheros independientes de la arquitectura. Configurado a través de la opción de compilación --prefix.

exec_prefix

Subroot para ficheros dependientes de la arquitectura. Configurado a través de la opción de compilación --exec-prefix.

bindir

Localización predeterminada para el directorio de programa. Configurado a través de la opción de compilación --bindir.

libdir

Directorio para los archivos estáticos y los objetos cargables dinámicamente de BrlAPI. Predeterminadamente anclados en directorio de librerías. Configurado a través de la opción de compilación --libdir.

sysconfdir

Directorio para ficheros de configuración. Predeterminadamente anclados en directorio de datos. Configurado a través de la opción de compilación --sysconfdir.

mandir

Localización predeterminada para Directorio de Páginas de Manual. Configurado a través de la opción de compilación --mandir.

includedir

Anclado predeterminadamente en directorio de ficheros de cabecera. Configurado a través de la opción de compilación --includedir.

brltty-install

Esta utilidad copia la jerarquía de instalación de ficheros desde un lugar a otro.

brltty-install to [from]
to

El lugar al que jerarquía de instalación de ficheros va a ser copiada. Debe ser en un directorio existente.

from

El lugar desde el que la jerarquía de instalación de ficheros va a ser tomada. Si es especificada, entonces debe ser un directorio existente. Si no es especificado, entonces el lugar utilizado es adoptado el lugar de compilación.

Esta utilidad puede ser utilizada, por ejemplo, para copiar BRLTTY a un disco root. Si un disquete root es montado como /mnt, y BRLTTY está instalado en el sistema principal, entonces tecleando

brltty-install /mnt
copia BRLTTY, junto con todos sus datos y ficheros librerías, al disquete root.

Han sido experimentados algunos problemas cuando se copia BRLTTY entre dos sistemas con versiones diferentes de de la librería C compartida. Esto merece la pena ser investigado si tienes dificultades.

brltest

Esta utilidad testea un controlador de línea braille, y también proporciona un modo interactivo para aprender qué hacen las teclas en la línea braille. Debería ser ejecutado como root.

brltest -option ... [driver [name=value ...]]
driver

El controlador para la línea braille. Debe ser un código de identificación de controlador de dos letras. Si no es especificado, entonces el primero controlador configurado a trave´s de la opción de compilación --with-braille-driver es adoptado.

name=value

Ajusta un parámetro del controlador de la línea braille. Para una descripción de los parámetros aceptados por un controlador específico, por favor mira la documentación de ese controlador.

-ddevice --device=device

La ruta absoluta para el dispositivo al que está conectada la línea braille. Si no es especificado, entonces el dispositivo configurado a través de la opción de compilación --with-braille-device es adoptado.

-Ddirectory --data-directory=directory

La ruta absoluta para el directorio donde residen los ficheros de datos del controlador. Si no es especificado, entonces el directorio configurado a través de la opción de compilación --with-data-directory es adoptado.

-Ldirectory --library-directory=directory

La ruta absoluta para el directorio donde residan los controladores. Si no es especificado, entonces el directorio configurado a través de la opción de compilación --libdir es adoptado.

-h --help

Muestra un resumen de las opciones de línea de órdenes, and then exit.

Esta utilidad usa el Modo de Aprendizaje de Órdenes de BRLTTY. El contador de tiempo del presionado de teclas (después del que esta utilidad sale) es de 10 segundos. El tiempo de mantenimiento del mensaje (utilizado para segnmentos no finales de los mensajes largos) es de 4 segundos.

spktest

Esta utilidad testea un controlador de sintetizador de voz. Podrá necesitar ser ejecutado como root.

spktest -option ... [driver [name=value ...]]
driver

El controlador para el sintetizador de voz. Debe ser un código de identificación de controlador de dos letras. Si no es especificado, entonces el primer controlador configurado a través de la opción de compilación --with-speech-driver es adoptado.

name=value

Ajusta un parámetro del controlador de sintetizador de voz. Para una descripción de los parámetros aceptados por un controlador específico, por favor mira la documentación para ese controlador.

-tstring --text-string=string

El texto a ser verbalizado. Si no es especificado, entonces la salida estándar es leída.

-Ddirectory --data-directory=directory

La ruta absoluta para el directorio donde residen los ficheros de datos del controlador. Si no es especificado, entonces el directorio configurado a través de la opción de compilación --with-data-directory es adoptado.

-Ldirectory --library-directory=directory

La ruta absoluta para el directorio donde residen los controladores. Si no es especificado, entonces el directorio configurado a través de la opción de compilación --libdir es adoptado.

-h --help

Muestra un resumen de las opciones de línea de órdenes, y luego sale.

scrtest

Esta utilidad testea el controlador de pantalla. Debe ser ejecutado como root.

scrtest -option ... [name=value ...]
name=value

Ajusta un parámetro para el controlador de pantalla. Para una descripción de los parámetros aceptados por un controlador específico, por favor mira la documentación para ese controlador.

-lcolumn --left=column

Especifica el comienzo (izquierda) columna (origen en cero) de la región. Si este valor no es facilitado, entonces un valor predeterminado, basado en la anchura especificada, es seleccionado tal que la región es centrada horizontalmente.

-ccount --columns=count

Especifica la anchura de la región (en columnas). Si este valor no es facilitado, entonces un valor predeterminado, basado en la columna de inicio especificada, es seleccionado tal que la región es centrada horizontalmente.

-trow --top=row

Especifica la fila de comienzo (superior) (origen en cero) del la región. Si este valor no es facilitado, entonces un valor predeterminado, basado en la altura especificada, es seleccionado tal que la región es centrada verticalmente.

-rcount --rows=count

Especifica altura de la región (en filas). Si este valor no es facilitado, entonces un valor predeterminado, basado en la fila de inicio especificado, es seleccionado tal que la región es centrada verticalmente.

-h --help

Muestra un resumen de las opciones de línea de órdenes, y luego sale.

Notas:

Lo siguiente es escrito en la salida estándar:

  1. Una línea detellando las dimensiones de la pantalla.
    Screen: widthxheight
  2. Una línea detallando la posición (origen en cero) del cursor.
    Cursor: [column,row]
  3. Una línea detallando el tamaño de la región de la pantalla seleccionada, y la posición (origen en cero) de su esquina superior izquierda.
    Region: widthxheight@[column,row]
  4. Los contenidos de la región seleccionada de la pantalla. Los caracteres no imprimibles son escritos como espacios en blanco.

tbltest

Esta utilidad testea una tabla de transcripción (mira la sección Tablas de Transcripción).

tbltest -option ... input-table output-table
input-table

La ruta del fichero de sistema para la entrada de la tabla de transcripción. Si es relativa entonces es fijada en el directorio configurado a través de la opción de compilación --with-data-directory.

output-table

La ruta de fichero de sistema de salida de la tabla de transcripción. Si es relativa entonces es fijada en el directorio actual de trabajo. Si este parámetro no es facilitado entonces no es escrita la tabla de salida.

-ccharset --character-set=charset

Especifica el nombre del conjunto de caracteres de 8 bits a utilizar cuando se interprete las tablas. Si esta opción no es facilitada entonces el conjunto de caracteres del host es utilizado.

-iformat --input-format=format

Especifica el formato de la tabla de entrada. Si esta opción no es facilitada entonces el formato de la tabla de entrada es deducido desde la extensión del nombre del fichero de tabla de entrada.

-oformat --output-format=format

Especifica el formato de de la tabla de salida. Si esta opción no es facilitada entonces el formato de la tabla de salida es deducido desde la extensión del nombre de la tabla de salida.

-t --translate

-h --help

Muestra un resumen de las opciones de línea de órdenes, y luego sale.

Los siguientes formatos de tabla son soportados:

tbl

BRLTTY

sbl

SuSE Blinux

a2b

Gnopernicus

ctbtest

Esta utilidad testea una tabla de contracción (mira la sección Braille Contraído). El texto se lee desde los ficheros de entrada (o la entrada estándar) es reescrita a la salida estándar como braille contraído.

ctbtest -option ... input-file ...
input-file

La lista de ficheros a ser procesado. Cualquier número de ficheros podrá ser especificado. Son procesados de izquierda a derecha. El nombre de fichero especial - es interpretado como significando entrada estándar. Si no son especificados ficheros entonces es procesada la entrada estándar.

-cfile --contraction-table=file

La ruta del sistema del fichero a la tabla de contracción. Si es relativa entonces es fijado en el directorio configurado a través de la opción de compilación --with-data-directory. La extensión .ctb es opcional. Si esta opción no es facilitada entonces en-us-g2 es adoptada.

-tfile --text-table=file

La ruta del sistema del fichero de la tabla de transcripción de texto a utilizar. Si es relativa entonces es fijada en el directorio configurado a través de la opción de compilación --with-data-directory. La extensión .tbl y el prefijo text. son ambos opcionales. Si esta opción no es facilitada entonces la tabla definida a través de opción de compilación --with-text-table es adoptado.

-wcolumns --output-width=columns

La longitud máxima de una línea de salida. Cada línea de salida contraída es cortada en tantas líneas de salida como sea necesario. Si esta opción no es facilitada entonces no hay límites, y hay un una correspondencia uno a uno con entre las líneas de entrada y salida.

-h --help

Muestra un resumen de las opciones de línea de órdenes, y luego sale.

la tabla de transcripción de texto es utilizada:

La tabla de transcripción de texto text.brf.tbl es proporcionada para utilizar con esta utilidad. Define el formato utilizado dentro de los ficheros .brf. Este es también el formato preferido utilizado por la mayoría de las impresoras braille y dentro de los documentos braille distribuídos electrónicamente. Esta tabla permite efectivamente a esta utilidad ser utilizada como un transcriptor de texto a braille.

tunetest

Esta utilidad testea la capacidad de tonos de alerta, y también proporciona un modo fácil para componer nuevos tonos. Podrá necesitar ser ejecutado como root.

tunetest -option ... {note duration} ...
note

Un número de nota MIDI estándar. Debe ser un entero desde 1 hasta 127, con el 60 representando el Do el medio. Cada valor representa un semitono cromático estándar, con los siguientes valores más bajo y más alto representando, respectivamente, la siguiente nota más baja y más alta. El valor más bajo (1) representa el primer Do agudo por debajo Do del medio, y el valor más alto (127) representa el sexto Sol por encima del Do del medio.

duration

La duración de la nota en milésimas de segundo. Debe ser un entero desde 1 hasta 255.

-ddevice --device=device

El dispositivo el cual reproduce el tono.

beeper

El taltavoz interno (generador de tonos de la consola).

pcm

La digital audio interface en la targeta de sonido.

midi

La Musical Instrument Digital Interface en la targeta de sonido.

fm

El sintetizador FM en una targeta de sonido ADLib, OPL3, Sound Blaster, o equivalente.

El nombre del dispositivo podrá ser abreviado. Mira la preferencia Tune Device para detalles concernientes al dispositivo predeterminado y a las restricciones de la plataforma.

-vloudness --volume=loudness

Especifica el volumen de salida como un porcentaje del máximo. El volumen de salida predeterminado es 50.

-pdevice --pcm-device=device

Especifica el dispositivo a utilizar para el audio dmira la sección Especificación de Dispositivo PCM). Esta opción no está disponible si la opción de compilación --disable-pcm-support fue especificada.

-mdevice --midi-device=device

Especifica el dispositivo a utilizar por la Musical Instrument Digital Interface (mira la sección Especificación de Dispositivo MIDI). Esta opción no está disponible si la opción de compilación --disable-midi-support fue especificada.

-iinstrument --instrument=instrument

El instrumento a utilizar si el dispositivo seleccionado es midi. Para una lista completa de instrumentos, Mira la Tabla de Instrumentos MIDI. El instrumento predeterminado es un acoustic grand piano. Las palabras de las que consta un nombre de instrumento deben separarse entre sí por un signo menos en lugar de por espacios, y cualquier de las palabras podrán ser abreviadas. Un acoustic grand piano, por ejemplo, podrá ser especificado como a-gra-pi.

-h --help

Muestra una resumen de las opciones de línea de órdenes, y luego sale.


Siguiente Anterior Contenido