QuillRTF
========

Versin: 1.1
Autor:   Pedro Reina
Fecha:   X.4.3.1998


Objetivo del programa
---------------------

Convertir un fichero en formato Quill en un fichero Rich Text Format (RTF). Se
respeta la letra negrita, as como los subndices y superndices. La letra
subrayada se convierte en versalita. No se tienen en cuenta ni tabuladores, ni
justificacin, ni pies ni cabeceras.


Requisitos del programa
-----------------------

El programa puede funcionar en un QL o en un PC, y no exige ningn
requerimiento especial.


Arranque del programa
---------------------

Para arrancar el programa en el QL, ste debe estar en modo de alta resolucin
(MODE 4); hay que teclear

EXEC_W QuillRTF_exe

Se puede usar cualquier orden equivalente a EXEC_W, como por ejemplo EW.

En el PC se teclea

QuillRTF

Opcionalmente, se puede invocar el programa escribiendo como parmetro el
nombre del fichero de configuracin que se desea usar. Si se deseara usar el
fichero de nombre "Ejemplo", habra que teclear en el QL

EXEC_W QuillRTF_exe ; "Ejemplo"

(Para usar esta opcin es necesario que en el QL est instalado Toolkit II).

En el PC habra que teclear

QuillRTF Ejemplo


Lectura de la configuracin
---------------------------

Si se invoca QuillRTF sin especificar ninguna configuracin, se busca una por
defecto:

En el QL, se busca el fichero QuillRTF_cnf en el directorio de datos
establecido por Toolkit II.

En el PC, se busca el fichero QuillRTF.cnf en el directorio actual.


Uso del programa
----------------

El programa presenta un men principal con cuatro opciones:

La opcin Salida permite concluir el programa. Tambin se puede salir del
programa pulsando ESC en el men principal.

La opcin Explica presenta unas indicaciones sobre el uso del programa y la
forma de contactar con el autor.

La opcin Fichero es la que permite realizar la conversin de un fichero
Quill a RTF. Se encuentran 4 opciones:

    La opcin Convierte busca en el directorio seleccionado todos los ficheros
    que coincidan con la mscara que est escrita en ese momento y que tengan
    la extensin correcta. Aparece un men con todos los archivos encontrados.
    Se selecciona el que se desea convertir o se pulsa ESC para anular el
    proceso. Durante la conversin se muestra el estado del proceso y al final
    se genera un fichero con el mismo nombre que el original, pero con
    extensin rtf.

    Nota: en el QL los ficheros con nombres muy largos no se tratan
    correctamente.

    La opcin Directorio permite especificar el directorio donde se buscarn
    los ficheros. Si se deja en blanco, se toma como directorio en el PC, el
    actual y en el QL, el de datos de Toolkit II.

    La opcin Mscara permite escribir la mscara que se usar para buscar
    ficheros. Se pueden usar dos caracteres especiales: el asterisco (*), que
    significa cualquier cantidad de caracteres y la interrogacin (?), que
    significa uno o ningn carcter.

    La opcin Extensin permite especificar la extensin de los ficheros
    Quill.

La opcin Opciones se usa para especificar tres parmetros del programa:

    La opcin Sonido permite tener seales acsticas durante el programa.

    La opcin Tamao especifica el tamao que llevarn los caracteres en
    subndice y en superndice. Se especifica el porcentaje de tamao respecto
    a la letra base.

    La opcin Posicin especifica la posicin en que se colocarn los
    caracteres en subndice y en superndice. Se especifica el porcentaje
    respecto a la letra base.


El fichero de configuracin
---------------------------

Cuando se invoca QuillRTF se puede cargar un fichero de configuracin para
definir algunos parmetros del programa.

Los ficheros de configuracin son simples ficheros de texto que se pueden crear
y modificar con cualquier editor de texto. Se pueden introducir cuantos
comentarios se desee. Se considera comentario toda lnea que comience con el
carcter '*' y toda la parte de una lnea a partir de la doble barra ("//").
Las lneas en blanco se ignoran.

Para configurar un parmetro hay que introducir una lnea en el fichero que
tenga como primera palabra el indicador de lo que se quiere configurar y a
continuacin el valor o valores que se desean dar. Se pueden introducir en
cualquier orden.

Para ayudar al usuario a crear su propio fichero de configuracin se incluye
uno de ejemplo, llamado QuillRTF_cnf en el QL y QuillRTF.cnf en el PC.

A continuacin se describen las posibles entradas:

Sonido

Escribiendo "S" o "No", se especifica si el programa debe comenzar con el
sonido conectado o no. Si este parmetro no se incluye el programa toma por
defecto el valor "No".

TamaoSubSup

El tamao de los caracteres en subndice y superndice.

PosicinSubSup

La posicin de los caracteres en subndice y superndice.
