
=========================================================================
============ Instalando la documentacin espaola de Allegro ============
=========================================================================

   *** AVISO ***
   Si no consigue compilar Allegro correctamente, es probable que tampoco
   pueda crear la documentacin. Primero asegrese de que consigue compilar
   Allegro correctamente.

   - Copie el fichero spdocsxx.zip al directorio anterior de Allegro. Es
     decir, si instal Allegro en c:\djgpp\allegro, copie el fichero en
     c:\djgpp).

   - Descomprima el fichero con el parmetro -p de pkunzip para conservar la
     estructura de directorios. (ejemplo: 'pkunzip spdocs.zip -d')

   - Teclee "cd allegro", "cd spdocs" y luego "make". Si todo va bien,
     debera de obtener al final la versin espaola de la documentacin.

   - La versin MS-DOS de la documentacin est en el directorio spdocs. La
     versin HTML y RTF est en spdocs\html. La versin inf ser copiada a
     su directorio djgpp\info para que la pueda usar con info o Rhide. En el
     directorio spdocs\txt tiene los ficheros de texto extra que en la
     distribucin inglesa original vienen repartidos en varios directorios
     por separado , y los parches .cfg para hacer funcionar correctamente
     los mensajes de sistema de la biblioteca (lea ms abajo sobre esto).

   - Si desea crear la versin HTML de la documentacin como un slo fichero
     allegro.html, en vez de tener muchos sueltos, edite el fichero
     src\allegro._tx, borre el comando @multiplefiles de la lnea 8, y
     ejecuta make otra vez.


==================================================
============ Conflictos de carcteres ============
==================================================

   Aparte de la documentacin, el sistema de mensajes de error de Allegro ha
   sido traducido al espaol mediante el fichero estext.cfg incluido en el
   fichero language.dat que viene con Allegro.

   Sin embargo, los carcteres espaoles especiales han tenido que ser
   "recortados" y aparece el carcter que ms se acerca al original, como en
   la versin INFO de la documentacin. Por qu?

   Cuando Microsoft dise su sistema operativo MS-DOS, pudo haber
   implementado en el juego de carcteres espaoles los mismos que dicta el
   estndar de la ISO. Sin embargo, para hacer las cosas aun ms difciles,
   Microsoft ignor el estndar y se cre su propia tabla de configuracin.
   Bueno, en realidad dos :-)

   Los carcteres bsicos como las letras y los nmeros van del 1 al 127 del
   juego de carcteres. A partir de ah, hay diferentes versiones de la
   tabla. En concreto, para visualizar carcteres espaoles, puede usar la
   tabla 850 o 437. En ambas, los carcteres especiales como las letras
   acentuadas o la ee aparecen con el mismo cdigo. Pero como ya he dicho,
   este cdigo es diferente al de la ISO, y los mismos mensajes saldran con
   carcteres extraos en pantalla usando este "otro" estndar.

   Dado que Allegro usa el estandar ISO para visalizar texto en modos
   grficos, sera poco rentable mantener dos versiones de los mensajes de
   sistema y dejar que Allegro decidiese cual usar. Adems, sera fcil
   engaar la biblioteca, y el usuario de su programa al encontrarse con un
   error, en vez de la ee vera un carcter extrao, y lo mismo con los
   acentos.

   Esto sera poco profesional para su imagen. Por esta razn, en el
   directorio spdocs\txt vienen dos versiones del fichero estext.cfg, una
   para dos y otra para modos grficos (dos.cfg y win.cfg respectivamente).

   Dependiendo de cmo visualice los mensajes de error de Allegro, podr
   optar por una u otra version, con el fin de que los mensajes sean
   legibles. Si no le importa que no haya acentos, no tiene que hacer nada,
   puede dejar el fichero estext.cfg que viene con Allegro como est.

   En caso contrario, puede actualizar el fichero languages.dat con el
   fichero deseado antes de distribuirlo junto con su programa, o puede
   distribuir el fichero estext.cfg por separado junto con su programa.


=============================================
============ Notas del traductor ============
=============================================

   Saludos.

   Me llamo Grzegorz Adam Hankiewicz (gradha@iname.com), y soy el traductor
   de la documentacin de Allegro. Me gustara decir un par de cosas sobre
   la traduccin:

   - La traduccin est completa y equivale a la documentacin oficial
     inglesa de la versin 3.11 de Allegro. Sin embargo, el trabajo nunca
     acaba y siempre quedan cosas por actualizar, correcciones por realizar,
     etc. Si encuentra algn fallo, por favor, comunquemelo.

   - La intencin original era traducir los manuales de Allegro. Sin
     embargo, haca falta ponerlos en un zip en alguna pgina web, por lo
     que se ha decidido traducir parcialmente la pgina web de Allegro y
     modificarla un poco. Esto significa que la pgina espaola puede NO
     estar actualizada. Adems, hay cosas en la espaola que en la inglesa
     no salen y viceversa. Si estaba buscando informacin correcta o de
     ltima hora, le recomiendo que la busque en la pgina inglesa.

   - Si quiere hacer alguna pregunta de programacin con Allegro, puede
     hacermela a m, pero lo mejor sera que se la hiciese a Shawn, el
     creador de Allegro, directamente (tendr que hacerla en ingls!). Si
     no sabe ingls, puede hacerme la pregunta y si no puedo con ella, se la
     traducir a Shawn. En resumen, har de intrprete :-)

   - Si quiere desinstalar este paquete de su disco duro, primero vaya al
     directorio spdocs y ejecute "make uninstall" y "make ultraclean".
     Despus teclee "cd .." dos veces para ir dos directorios ms abajo y
     ejecute el comando "rm -f -d @allegro/spdocs.mft". Esto borrar
     finalmente todo rastro de la traduccin, snif...


