name=<<END
the
many lines
long value
END
othername=value
0 : heredocs are ignored, $data->{section}{name} will be '<<END'
1 : heredocs are supported, $data->{section}{name} will be "the\nmany lines\nlong value"
The Perl-lie extensions of name=<<"END" and <<'END' are not supported!
'Perl' : heredocs are supported, $data->{section}{name} will be "the\nmany lines\nlong value"
The Perl-lie extensions of name=<<"END" and <<'END' are supported.
The <<'END' never interpolates %variables%, the "END" always interpolates variables,
unlike in other values, the %variables% that are not defined do not stay in the string!

- controls whether the created hash is case insensitive. The possible values are

sensitive - the hash will be case sensitive
tolower - the hash will be case sensitive, all keys are made lowercase
toupper - the hash will be case sensitive, all keys are made uppercase
preserve - the hash will be case insensitive, the case is preserved (tied)
lower - the hash will be case insensitive, all keys are made lowercase (tied)
upper - the hash will be case insensitive, all keys are made uppercase (tied)

- if set to an array ref, then the list will be stored in that array, and no $config->{'__SECTIONS__'} is created. The case of the section names stored in this array is controled by the "case" option even in case you specify the "class".

- if set to a true scalar value then multiple items with the same names in a section do not overwrite each other, but result in an array of the values.

- if set to a hash of hashes (or hash of arrays or hash of comma separated item names) specifies what items in what sections will end up as hashes containing the list of values. All the specified items will be arrays, even if there is just a single value. To affect the items in all sections use section name '*'.

- regular expression used to identify comments or a string containing the list of characters starting a comment. Each line is tested against the regexp is ignored if matches. If you specify a string a regexp like this will be created:

If the file is in UTF8 and starts with a BOM it will be automaticaly opened in UTF8 mode and the BOM will be stripped. If it doesn't start with the BOM you have to specify the utf8 layer!

You may also set the defaults for the options by modifying the $Config::IniHash::optionname variables. These default settings will be used if you do not specify the option in the ReadINI() or ReadSection() call.