     ______   ___    ___
    /\  _  \ /\_ \  /\_ \
    \ \ \L\ \\//\ \ \//\ \      __     __   _ __   ___ 
     \ \  __ \ \ \ \  \ \ \   /'__`\ /'_ `\/\`'__\/ __`\
      \ \ \/\ \ \_\ \_ \_\ \_/\  __//\ \L\ \ \ \//\ \L\ \
       \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/
        \/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/
                                       /\____/
                                       \_/__/


           Informacin sobre compatibilidad binaria.

           Lea en readme.txt una visin ms general.



======================================
============ Introduccin ============
======================================

   Una vez Allegro 4.0 sea lanzado, planeamos mantener compatibilidad a
   nivel binario de la interfaz (ABI, Application Binary Interface) para el
   resto de las series 4.0.x. Por ejemplo, eso significa que seguir pudiendo
   usar un binario compilado con la versin 4.0.10 con una librera dinmica
   de la versin 4.0.42, o incluso 4.0.0.

   "Uff," pensar, "nunca ms tendr que poner allxxxx.dll en mis zips."

   Tcnicamente, no. Sin embargo, hay unas guas (reglas) que debera
   (deber) seguir, o de lo contrario las cosas no funcionarn bien, y
   obtendr emails de irritacin de sus usuarios y de nosotros (la Mafia "sea
   bueno" de Allegro).

   Nota: La compatibilidad binaria slamente ser mantenida _activamente_
   para Windows, Linux y BeOS en las arquitecturas x86.



============================================
============ Notas para Windows ============
============================================

   Si no necesita una versin modificada de Allegro entonces simplemente
   enlace su programa contra una versin que no sea WIP, CVS o de prueba, y
   caern del cielo galletas de chocolate. No desactive ninguna
   caracterstica (ej: profundidades de color, drivers) en la DLL.

   Si requiere una versin modificada de Allegro, entonces por favor enlace
   con ella estticamente, o escoja un nombre no estndar para la DLL
   modificada de Allegro. Por ejemplo, tendra muy mala leche si distribuyese
   la versin modificada de Allegro con un nombre como all40.dll o
   alleg40.dll. En su lugar, llmela algo como alcambios.dll. Mejor an,
   enlace estticamente con ella.

   Para las personas que usen el Allegro estndar, proveeremos un conjunto de
   DLLs de "referencia". Si su binario funciona con eso, entonces todo est
   en su lugar. Si quiere distribur las DLLs de Allegro con su programa
   (normalmente es buena idea), recomendamos que distribuya nuestras DLLs en
   lugar de las que haya compilado usted. Confiamos en que fastidiara algo.



==========================================
============ Notas para Linux ============
==========================================

   Para asegurarse de que el binario que use Allegro compilado en su mquina
   funcione en otra, no desactive ninguna caracterstica del `configure'. Su
   copia de Allegro debe tener rutinas en ensamblador, threads, mdulos,
   todas las profundidades de color y soporte X11 activados, entre otras
   cosas. Si duda, deje todo con su valor por defecto.

   Cuando est listo para distribur su binario, ejecute "ldd <;mibinario>;".
   Debera decir algo como:

      liballeg.so.4.0 =>; /usr/local/lib/liballeg.so.4.0 (0xdeadbeaf)

   NO debera decir algo como:

      liballeg.so.4.0.0 =>; /usr/local/lib/liballeg.so.4.0.0 (0xdeadbeaf)

   Si ve lo segundo, eso significa que usuarios con versiones posteriores de
   Allegro no podrn ejecutar su binario.

   Lea tambin la seccin Windows si necesita usar una versin modificada de
   Allegro.



=========================================
============ Notas para BeOS ============
=========================================

   La mayora de las cosas mencionadas en la seccin Windows son aplicables
   aqu. En particular, se le recomienda usar una versin que no sea WIP,
   CVS o modificada de cualquier otra forma, en cuyo caso su programa
   debera funcionar sin problemas en mquinas externas.



=======================================
============ Notas finales ============
=======================================

   Proporcionar el cdigo fuente sigue siendo mejor que no proporcionarlo.
   Los binarios son buenos, no obstante, si su cdigo es malsimo y slo
   usted (con la ayuda de brujera) es capaz de compilarlo.

   Si ha proporcionado binarios en el pasado usando versiones WIP de Allegro,
   le pedimos amablemente que recompile su programa usando una versin
   estable de Allegro. (A no ser, claro, que prefiera dormir con los peces).

   Y oh, no haga que su compilador genere cdigo especfico de i686 o algo
   estpido como eso.

