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.