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


              Informacin especfica para BeOS

    Vase readme.txt para un punto de vista ms general.



====================================
============ Notas BeOS ============
====================================

   Estado: compila para Intel R4 & R5. El port est completo.



============================================
============ Software requerido ============
============================================

   Las ediciones Pro de BeOS Intel R4 y R5 vienen con todo lo que necesita.
   Si tiene la edicin personal BeOS Intel R4, necesita las herramientas de
   desarrollo; stas pueden ser encontradas en la pgina web de Be en
   http://www.be.com. Tambin necesita binutils acualtizado, puede
   encontrarlo en bebits.com. Tampoco sera mala idea actualizar gcc, pero
   no es necesario.



============================================
============ Instalando Allegro ============
============================================

   Allegro es distribudo como cdigo fuente: lo tendr que compilar para
   poder usarlo. Descomprima el archivo en el sitio que considere oportuno,
   entre en ese directorio con una terminal. Debido a la naturaleza multi
   plataforma de Allegro, necesita ejecutar:

      fix.sh beos

   Esto preparar la librera para que pueda ser compilada en la plataforma
   Be. Ahora puede crearla con:

      make

   Y luego instalarla con:

      make install

   Con el ltimo comando la librera Allegro ser instalada en
   /boot/home/config/lib (el lugar por defecto de las libreras compartidas
   en BeOS), mientras que los ficheros de cabecer irn a parar a
   /boot/develop/headers (el lugar por defecto donde Be los buscar).

   Ya ha instalado Allegro! Lea el resto de la documentacin y los ejemplos
   para aprender ms. Un simple ejemplo de cmo compilar un programa que use
   Allegro desde la lnea de comando es:

   gcc foo.c -O2 -Wall -o foo `allegro-config --shared`

   El `allegro-config --shared` es explicado en la siguiente seccin.

   Por defecto se crear la versin de Allegro que se enlaza dinmicamente,
   pero si desea crear la versin enlazada estticamente escriba lo siguiente
   en la lnea de comando:

   export STATICLINK=1

   Del mismo modo puede usar una de las siguientes lneas para construir las
   versiones de depuracin o para medir rendimientos de la librera:

   export DEBUGMODE=1
   export PROFILEMODE=1

   Tras eso puede empezar realmente a compilar e instalar la librera.
   
   make
   
   make install

   Si ha compilado la versin esttica de la librera, esta ser copiada a
   /boot/develop/lib/x86.


   
========================================
============ Usando Allegro ============
========================================

   Al enlazar su programa con Allegro tambin necesita enlazar con otras
   libreras de BeOS y ajustar correctamente los directorios de bsqueda.
   Para simplificar el proceso, la instalacin crea un fichero de script,
   allegro-config, que imprimir la lnea de comando necesaria. Puede usar
   esto dentro de una sustitucin por comillas, como por ejemplo:

      gcc mifichero.c -o miprograma `allegro-config --static`

   Esto le permitir enlazar con la librera esttica.

   La opcin `allegro-config --shared` mencionada arriba imprimir todas las
   opciones y libreras para enlazar dinmicamente con Allegro. Si usa --libs
   en lugar de --shared o --static, el script generar los parmetros de
   enlazado acordes con el ltimo tipo de versin de Allegro instalada.
   Tambin puede ejecutar estos comandos allegro-config en la lnea de
   comandos para ver exctamente qu hacen.

   Si desea crear la versin de depuracin de su programa, asumiendo que haya
   instalado la versin de depuracin de Allegro, use:

      gcc mifichero.c -o miprograma `allegro-config --libs debug`

   Novatos del terminal, tomad nota de que eso son las comas `, no las
   habituales '!

   Tambin hay otros parmetros para imprimir el nmero de versin de Allegro
   o para especificar los directorios de instalacin. Ejecute allegro-config
   sin argumentos para ver la lista completa de opciones.

   No olvide que necesita usar la macro END_OF_MAIN() justo tras su funcin
   main()!
