41 Comandos makefile

Hay un n�mero de opciones que puede usar para controlar exactamente c�mo compilar Allegro. En plataformas Unix esto se hace pasando argumentos al script de configuraci�n (ejecute "configure --help" para obtener una lista), en otras plataformas puede ajustar las siguientes variables de entorno:

• DEBUGMODE=1
  Genera una versi�n para depurar, en vez de la versi�n normal optimizada.
• PROFILEMODE=1
  Genera una versi�n para medir rendimientos, en vez de la versi�n normal optimizada.
• WARNMODE=1
  Selecciona avisos de compilador m�s estrictos. Si est� planeando trabajar en Allegro, en vez de simplemente usarlo, deber�a asegurarse de tener este modo activado.
• STATICLINK=1 (s�lo MSVC y Mingw32)
  Enlazar de forma est�tica, en vez de usar la DLL por defecto.
• TARGET_ARCH_COMPAT=[cpu] (implementado en la mayor�a de plataformas GNU)
  Esta opci�n optimizar� el c�digo para el procesador indicado manteniendo a la vez compatibilidad con procesadores anteriores. Ejemplo: set TARGET_ARCH_COMPAT=u586
• TARGET_ARCH_EXCL=[cpu] (implementado en la mayor�a de plataformas GNU)
  Esta opci�n optimizar� el c�digo para el procesador indicado. Tome nota de que el c�digo generado *NO* funcionar� en procesadores anteriores. Ejemplo: set TARGET_ARCH_EXCL=i586
• TARGET_OPTS=[opts] (implementado en la mayor�a de plataformas GNU)
  Esta opci�n le permite personalizar optimizaciones generales del compilador.
• CROSSCOMPILE=1 (s�lo djgpp)
  Le permite compilar la versi�n djgpp de la biblioteca bajo Linux, usando djgpp como compilador cruzado.
• ALLEGRO_USE_C=1 (s�lo djgpp)
  Permite generar la biblioteca con djgpp usando el c�digo C de dibujado en vez de las rutinas en ensamblador. Esto s�lo es �til para hacer pruebas, ya que la versi�n con ensamblador es m�s r�pida.

• 'default'
  El proceso normal. Compila la versi�n actual de la biblioteca (ya sea optimizada, para depurar o medir el rendimiento, seleccionada por las variables de entorno anteriores), genera el programa test y los ejemplos, y convierte los ficheros de documentaci�n.
• 'all'
  Compila las tres versiones de la biblioteca (optimizada, para depurar y para medir rendimiento), genera el programa test y los ejemplos, y convierte los ficheros de documentaci�n.
• 'lib'
  Compila la versi�n actual de la biblioteca (ya sea optimizada, para depurar o medir el rendimiento, seleccionada por las variables de entorno anteriores).
• 'install'
  Copia la versi�n actual de la biblioteca (ya sea optimizada, para depurar o medir el rendimiento, seleccionada por las variables de entorno anteriores) en su directorio de bibliotecas, recompilando si es necesario, e instala los ficheros de cabecera de Allegro.
• 'installall'
  Copia las tres versiones de la biblioteca (ya sea optimizada, para depurar o medir el rendimiento, seleccionada por las variables de entorno anteriores) en su directorio de bibliotecas, recompilando si es necesario, e instala los ficheros de cabecera de Allegro.
• 'uninstall'
  Desinstala la biblioteca Allegro y borra los ficheros de cabecera de los directorios de su compilador. Esto requiere una utilidad 'rm' de estilo Unix, ej: del paquete GNU fileutils.
• 'docs'
  Convierte los ficheros de documentaci�n de las fuentes ._tx.
• 'docs-dvi' (s�lo Unix)
  Crea el fichero de independiente del dispositivo allegro.dvi. Este no es un comando por defecto, ya que necesita la herramienta texi2dvi para generarlo. El fichero generado est� especialmente preparado para ser impreso en papel.
• 'docs-ps' o 'docs-gzipped-ps' (s�lo Unix)
  Crea un fichero Postscript a partir del fichero dvi generado previemante. Este no es un comando por defecto, ya que necesita las herramientas texi2dvi y dvips para generarlo. El segundo comando comprime el fichero Postscript generado. El fichero generado est� especialmente preparado para ser impreso en papel.
• 'install-man' o 'install-gzipped-man' (s�lo Unix)
  Esto genera p�ginas de manual de Unix para cada funci�n o variable de Allegro, y las instala. El segundo comando comprime las p�ginas antes de instalarlas.
• 'install-info' o 'install-gzipped-info' (s�lo Unix)
  Convierte la documentaci�n en formato info y la instala. El segundo comando comprime el fichero info antes de instalarlo.
• 'clean'
  Elimina todos los ficheros generados del directorio de Allegro, forzando una recompilaci�n total la pr�xima vez que ejecute make. Este comando est� dise�ado de tal forma que si ejecuta "make install" y luego "make clean", todav�a tendr� una versi�n funcional de Allegro . Esto requiere la utilidad rm de estilo Unix instalada, por ejemplo del paquete GNU fileutils.
• 'distclean'
  Como 'make clean', pero m�s todav�a. Elimina todos los archivos ejecutables y la documentaci�n en formato HTML, dej�ndole con exactamente los mismos archivos que hay cuando descomprime una distribuci�n nueva de Allegro.
• 'veryclean'
  �Use esto con extrema precauci�n! Esta orden borra absolutamente todo archivo generado, incluyendo algunos que puede ser dif�cil recrear. Despu�s de ejecutar este comando, una simple recompilaci�n no funcionar�: al menos tendr� que ejecutar "make depend", y tal vez tambi�n fixdll.bat si est� usando la biblioteca de Windows. Este objetivo hace uso de herramientas no est�ndar como SED, as� que a no ser que sepa usted lo que est� haciendo y tenga estas herramientas instaladas, no deber�a usarlo.
• 'depend'
  Regenera los archivos de dependencias (obj/*/makefile.dep). Es necesario ejecutar esto tras "make veryclean", o cuando se le a�adan nuevas cabeceras a los fuentes de Allegro.
• 'compress' (s�lo djgpp, Mingw32 y MSVC)
  Usa el compresor de ejecutables DJP o UPX (el que tenga instalado) para comprimir los programas de ejemplo y las utilidades, lo cual puede recuperar una parte significativa de espacio libre en disco.