Scroll to navigation

ALLEGRO(1) 4.0.3 ALLEGRO(1)

NAME

allegro-config - script to get information about the installed version of Allegro

SYNOPSIS

allegro-config [--prefix[=DIR]] [--exec-prefix[=DIR]] [--version] [--libs] [--cflags] [--static] [--shared] [--env] [release|debug|profile]

DESCRIPTION

allegro-config is a tool that is used to configure to determine the compiler and linker flags that should be used to compile and link programs that use the Allegro library. It is intended to be used on Unix systems instead of the simple "-lalleg" call.

EXAMPLE

gcc -o mygame mygame.o `allegro-config --libs`

allegro-config will insert arguments needed to link into the command line.

OPTIONS

allegro-config accepts the following options:

Print the currently installed version of Allegro on the standard output.
Print the linker flags that are necessary to link an Allegro program.
Print the compiler flags that are necessary to compile an Allegro program.
If specified, use PREFIX instead of the installation prefix that Allegro was built with when computing the output for the --cflags and --libs options. This option is also used for the exec prefix if --exec-prefix was not specified. This option must be specified before any --libs or --cflags options.
If specified, use PREFIX instead of the installation exec prefix that Allegro was built with when computing the output for the --cflags and --libs options. This option must be specified before any --libs or --cflags options.
Like --libs, but always print the linker flags needed to get a statically linked executable.
Like --libs, but always print the linker flags needed to get an executable linked against shared libs.
Print some needed environment variables in the way needed in shell scripts. Output may be loaded into your environment using

BASH#> eval `allegro-config --env`

This will use the optimized Allegro library which you should use when you are compiling for a release.
This will add extra debug info into your programs, useful to find out where your program crashed or simply to debug it (names of functions are seen). You may choose this option while developing a program.
This may be used when you want to profile your program - i.e. measure the speeds of various function calls.

SEE ALSO

allegro-dev-tools(1)
The allegro info entry

COPYRIGHT

This manual page was written by Eduard Bloch <blade@debian.org>, for the Debian GNU/Linux system (but may be used by others). It is heavily based on a similar manpage for gtk-config, written by Owen Taylor. His notice:

Copyright © 1998 Owen Taylor

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

8 June 2003 Version