This module is a extending Config::AutoConf, using a INI-like config
file.
SYNOPSIS
use Config::AutoConf::INI;
#
# Config::AutoConf::INI->new() is an instance of Config::AutoConf
#
Config::AutoConf::INI->new()->check('config.ini');
Config::AutoConf::INI->new()->check();
#
# Shortest form
#
Config::AutoConf::INI->check;
SUBROUTINES/METHODS
check($config_ini)
Performs all checks that are in the INI file $config_ini and that are
responsible for configuring Config::AutoConf or defining autoconf
variables. The following sections are supported, and executed in the
order listed below. Within every section, entries are executed in the
same order as the INI file.
This method can be used using an Config::AutoConf::INI instance, or the
class itself:
my $self = Config::AutoConf::INI->new();
$self->check('config.ini');
$self->write_config_h('somewhere_else.h');
Config::AutoConf::INI->check();
The default value for $config_ini is 'config_autoconf.ini'.
The result value is always an instance of Config::AutoConf::INI
Configuration sections
Includes
This is an interface to Config::AutoConf's push_includes.
[includes]
; Anything on the the left-hand side is used if the right-hand side is a true value.
; Example:
. = 1
/this/path = 0
C:\Windows\Temp = 1
Preprocessor flags
This is an interface to Config::AutoConf's push_preprocess_flags.
[preprocess_flags]
; Anything on the the left-hand side is used if the right-hand side is a true value.
; Example:
-DCPPFLAG0N = 1
-DCPPFLAG0FF = 0
Compiler flags
This is an interface to Config::AutoConf's push_compiler_flags.
[compiler_flags]
; Anything on the the left-hand side is used if the right-hand side is a true value.
; Example:
-DCCFLAG0N = 1
-DCCFLAG0FF = 0
Linker flags
This is an interface to Config::AutoConf's push_link_flags.
[link_flags]
; Anything on the the left-hand side is used if the right-hand side is a true value.
; Example:
--very = 1
--special = 0
Check sections
In the following sections, if the right-hand side is a true value the
check is executed.
If the right-hand side does not look like a number then a variable is
explicitly created with that name (e.g. I_HAVE_STDIO_H), with the
exception of the [bundle] section where right-hand side is always
used as a boolean. This does not prevent a Config::AutoConf default
variable, if any, to be created (i.e.g HAVE_STDIO_H), though the
wanted variable name can very well be equal to the default.
Files
This is an interface to Config::AutoConf's check_file.
This is an interface to Config::AutoConf's check_prog.
[progs]
cc = CC_NAME
Headers
This is an interface to Config::AutoConf's check_header.
[headers]
stddef.h = 0
time.h = 1
Please note that all found headers are systematically reinjected in
any further test, in the same order as their configuration
appearance in the INI file, in contrary to Config::AutoConf default
behaviour, that is to reuse only STDC headers.
Bundled headers
[bundle]
; The bundle check on the left-hand side is done when the right-hand side is a true value.
; The only supported bundles are stdc_headers, default_headers and dirent_headers.
; Example:
stdc_headers = 1
default_headers = 1
dirent_headers = Treated_Like_A_Boolean
Note that the right-hand side is always considered as a boolean.
Config::AutoConf::INI will keep new found headers in order, though
the order depend on how Config::AutoConf is implemented.
Declarations
This is an interface to Config::AutoConf's check_decl.
[decls]
read = 1
Functions
This is an interface to Config::AutoConf's check_func.
[funcs]
read = 1
Types
This is an interface to Config::AutoConf's check_type.
[types]
size_t = 1
Types sizeof
This is an interface to Config::AutoConf's check_sizeof_types.
[sizeof_types]
size_t = 1
Types offset
This is an interface to Config::AutoConf's check_alignof_types.
[alignof_types]
struct tm.tm_year = 1
Aggregate members
This is an interface to Config::AutoConf's check_member.
[members]
struct tm.tm_year = 1
Result sections
Outputs
This is an interface to Config::AutoConf's write_config_h.
[outputs]
; Anything on the the left-hand side is produced if the right-hand side is a true value.
; Example:
config_autoconf.h = 1
config.h = 0
NOTES
Non-existing INI file
Trying to read a non-existing INI file is a no-op.
