.\" Generated by the Allegro makedoc utility
.TH set_config_file 3 "version 4.2.2" "Allegro" "Allegro manual"
.SH NAME
set_config_file \- Sets the configuration file. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B void set_config_file(const char *filename);
.SH DESCRIPTION
Sets the configuration file to be used by all subsequent config 
functions. If you don't call this function, Allegro will use the default 
`allegro.cfg' file, looking first in the same directory as your program
and then in the directory pointed to by the ALLEGRO environment variable
and the usual platform-specific paths for configuration files. For example
it will look for `/etc/allegro.cfg' under Unix.

All pointers returned by previous calls to get_config_string() and
other related functions are invalidated when you call this function!
You can call this function before install_allegro() to change the
configuration file, but after set_uformat() if you want to use a text 
encoding format other than the default.

.SH SEE ALSO
.BR set_config_data (3),
.BR override_config_file (3),
.BR push_config_state (3),
.BR set_uformat (3),
.BR set_config_string (3),
.BR get_config_string (3),
.BR exconfig (3)