1IniFiles(3) User Contributed Perl Documentation IniFiles(3)
2
6 Config::IniFiles - A module for reading .ini-style configuration files.
7
9 use Config::IniFiles;
10 my $cfg = new Config::IniFiles( -file => "/path/configfile.ini" );
11 print "The value is " . $cfg->val( 'Section', 'Parameter' ) . "."
12 if $cfg->val( 'Section', 'Parameter' );
13
15 Config::IniFiles provides a way to have readable configuration files
16 outside your Perl script. Configurations can be imported (inherited,
17 stacked,...), sections can be grouped, and settings can be accessed
18 from a tied hash.
19
21 INI files consist of a number of sections, each preceded with the sec‐
22 tion name in square brackets. The first non-blank character of the
23 line indicating a section must be a left bracket and the last non-blank
24 character of a line indicating a section must be a right bracket. The
25 characters making up the section name can be any symbols at all. How‐
26 ever section names must be unique.
27 Parameters are specified in each section as Name=Value. Any spaces
29 around the equals sign will be ignored, and the value extends to the
30 end of the line. Parameter names are localized to the namespace of the
31 section, but must be unique within a section.
32 [section]
34 Parameter=Value
35 Both the hash mark (#) and the semicolon (;) are comment characters.
37 by default (this can be changed by configuration) Lines that begin with
38 either of these characters will be ignored. Any amount of whitespace
39 may precede the comment character.
40 Multi-line or multi-valued parameters may also be defined ala UNIX
42 "here document" syntax:
43 Parameter=<<EOT
45 value/line 1
46 value/line 2
47 EOT
48 You may use any string you want in place of "EOT". Note that what fol‐
50 lows the "<<" and what appears at the end of the text MUST match
51 exactly, including any trailing whitespace.
52 As a configuration option (default is off), continuation lines can be
54 allowed:
55 [Section]
57 Parameter=this parameter \
58 spreads across \
59 a few lines
60
62 Get a new Config::IniFiles object with the new method:
63 $cfg = Config::IniFiles->new( -file => "/path/configfile.ini" );
65 $cfg = new Config::IniFiles -file => "/path/configfile.ini";
66 Optional named parameters may be specified after the configuration file
68 name. See the new in the METHODS section, below.
69 Values from the config file are fetched with the val method:
71 $value = $cfg->val('Section', 'Parameter');
73 If you want a multi-line/value field returned as an array, just specify
75 an array as the receiver:
76 @values = $cfg->val('Section', 'Parameter');
78
80 new ( [-option=>value ...] )
81 Returns a new configuration object (or "undef" if the configuration
83 file has an error). One Config::IniFiles object is required per con‐
84 figuration file. The following named parameters are available:
85 -file filename
87 Specifies a file to load the parameters from. This 'file' may
88 actually be any of the following things:
89 1) a simple filehandle, such as STDIN
91 2) a filehandle glob, such as *CONFIG
92 3) a reference to a glob, such as \*CONFIG
93 4) an IO::File object
94 5) the pathname of a file
95 If this option is not specified, (i.e. you are creating a
97 config file from scratch) you must specify a target file
98 using SetFileName in order to save the parameters.
99 -default section
101 Specifies a section to be used for default values. For exam‐
102 ple, if you look up the "permissions" parameter in the
103 "users" section, but there is none, Config::IniFiles will
104 look to your default section for a "permissions" value before
105 returning undef.
106 -reloadwarn 0⎪1
108 Set -reloadwarn => 1 to enable a warning message (output to
109 STDERR) whenever the config file is reloaded. The reload
110 message is of the form:
111 PID <PID> reloading config file <file> at YYYY.MM.DD HH:MM:SS
113 Default behavior is to not warn (i.e. -reloadwarn => 0).
115 -nocase 0⎪1
117 Set -nocase => 1 to handle the config file in a case-insensi‐
118 tive manner (case in values is preserved, however). By
119 default, config files are case-sensitive (i.e., a section
120 named 'Test' is not the same as a section named 'test').
121 Note that there is an added overhead for turning off case
122 sensitivity.
123 -allowcontinue 0⎪1
125 Set -allowcontinue => 1 to enable continuation lines in the
126 config file. i.e. if a line ends with a backslash "\", then
127 the following line is appended to the parameter value, drop‐
128 ping the backslash and the newline character(s).
129 Default behavior is to keep a trailing backslash "\" as a
131 parameter value. Note that continuation cannot be mixed with
132 the "here" value syntax.
133 -import object
135 This allows you to import or inherit existing setting from
136 another Config::IniFiles object. When importing settings from
137 another object, sections with the same name will be merged
138 and parameters that are defined in both the imported object
139 and the -file will take the value of given in the -file.
140 If a -default section is also given on this call, and it does
142 not coincide with the default of the imported object, the new
143 default section will be used instead. If no -default section
144 is given, then the default of the imported object will be
145 used.
146 -commentchar 'char'
148 The default comment character is "#". You may change this by
149 specifying this option to an arbitrary character, except
150 alphanumeric characters and square brackets and the "equal"
151 sign.
152 -allowedcommentchars 'chars'
154 Allowed default comment characters are "#" and ";". By speci‐
155 fying this option you may enlarge or narrow this range to a
156 set of characters (concatenating them to a string). Note that
157 the character specified by -commentchar (see above) is always
158 part of the allowed comment characters. Note: The given
159 string is evaluated as a character class (i.e.: like
160 "/[chars]/").
161 -allowcode 0⎪1
163 Set -allowcode => 1 allows to use perl hooks within a ini
164 configuration file. Such perl hooks enable you to call a
165 perl sub or to access an environment variable from within an
166 ini file to set a parameter:
167 [EXAMPLE] logfile1=sub{ $ENV{'LOGFILE'}; } logfile2=sub{ log‐
169 file(); } heredoc=<<EOT sub{ $ENV{'LOGFILE'}; } sub{ log‐
170 file(); } <<EOT
171 Default behaviour is to allow perl code.
173 setval ($section, $parameter, $value, [ $value2, ... ])
175 Sets the value of parameter $parameter in section $section to $value
177 (or to a set of values). See below for methods to write the new con‐
178 figuration back out to a file.
179 You may not set a parameter that didn't exist in the original configu‐
181 ration file. setval will return undef if this is attempted. See newval
182 below to do this. Otherwise, it returns 1.
183 newval($section, $parameter, $value [, $value2, ...])
185 Assignes a new value, $value (or set of values) to the parameter
187 $parameter in section $section in the configuration file.
188 delval($section, $parameter)
190 Deletes the specified parameter from the configuration file
192 ReadConfig
194 Forces the configuration file to be re-read. Returns undef if the file
196 can not be opened, no filename was defined (with the "-file" option)
197 when the object was constructed, or an error occurred while reading.
198 If an error occurs while parsing the INI file the @Con‐
200 fig::IniFiles::errors array will contain messages that might help you
201 figure out where the problem is in the file.
202 Sections
204 Returns an array containing section names in the configuration file.
206 If the nocase option was turned on when the config object was created,
207 the section names will be returned in lowercase.
208 SectionExists ( $sect_name )
210 Returns 1 if the specified section exists in the INI file, 0 otherwise
212 (undefined if section_name is not defined).
213 AddSection ( $sect_name )
215 Ensures that the named section exists in the INI file. If the section
217 already exists, nothing is done. In this case, the "new" section will
218 possibly contain data already.
219 If you really need to have a new section with no parameters in it,
221 check that the name that you're adding isn't in the list of sections
222 already.
223 DeleteSection ( $sect_name )
225 Completely removes the entire section from the configuration.
227 Parameters ($sect_name)
229 Returns an array containing the parameters contained in the specified
231 section.
232 Groups
234 Returns an array containing the names of available groups.
236 Groups are specified in the config file as new sections of the form
238 [GroupName MemberName]
240 This is useful for building up lists. Note that parameters within a
242 "member" section are referenced normally (i.e., the section name is
243 still "Groupname Membername", including the space) - the concept of
244 Groups is to aid people building more complex configuration files.
245 SetGroupMember ( $sect )
247 Makes sure that the specified section is a member of the appropriate
249 group.
250 Only intended for use in newval.
252 RemoveGroupMember ( $sect )
254 Makes sure that the specified section is no longer a member of the
256 appropriate group. Only intended for use in DeleteSection.
257 GroupMembers ($group)
259 Returns an array containing the members of specified $group. Each ele‐
261 ment of the array is a section name. For example, given the sections
262 [Group Element 1]
264 ...
265 [Group Element 2]
267 ...
268 GroupMembers would return ("Group Element 1", "Group Element 2").
270 SetWriteMode ($mode)
272 Sets the mode (permissions) to use when writing the INI file.
274 $mode must be a string representation of the octal mode.
276 GetWriteMode ($mode)
278 Gets the current mode (permissions) to use when writing the INI file.
280 $mode is a string representation of the octal mode.
282 WriteConfig ($filename)
284 Writes out a new copy of the configuration file. A temporary file
286 (ending in '-new') is written out and then renamed to the specified
287 filename. Also see BUGS below.
288 Returns true on success, "undef" on failure.
290 RewriteConfig
292 Same as WriteConfig, but specifies that the original configuration file
294 should be rewritten.
295 GetFileName
297 Returns the filename associated with this INI file.
299 If no filename has been specified, returns undef.
301 SetFileName ($filename)
303 If you created the Config::IniFiles object without initialising from a
305 file, or if you just want to change the name of the file to use for
306 ReadConfig/RewriteConfig from now on, use this method.
307 Returns $filename if that was a valid name, undef otherwise.
309 SetSectionComment($section, @comment)
311 Sets the comment for section $section to the lines contained in @com‐
313 ment.
314 Each comment line will be prepended with the comment charcter (default
316 is "#") if it doesn't already have a comment character (ie: if the line
317 does not start with whitespace followed by an allowed comment charac‐
318 ter, default is "#" and ";").
319 To clear a section comment, use DeleteSectionComment ($section)
321 GetSectionComment ($section)
323 Returns a list of lines, being the comment attached to section $sec‐
325 tion. In scalar context, returns a string containing the lines of the
326 comment separated by newlines.
327 The lines are presented as-is, with whatever comment character was
329 originally used on that line.
330 DeleteSectionComment ($section)
332 Removes the comment for the specified section.
334 SetParameterComment ($section, $parameter, @comment)
336 Sets the comment attached to a particular parameter.
338 Any line of @comment that does not have a comment character will be
340 prepended with one. See "SetSectionComment($section, @comment)" above
341 GetParameterComment ($section, $parameter)
343 Gets the comment attached to a parameter.
345 DeleteParameterComment ($section, $parmeter)
347 Deletes the comment attached to a parameter.
349 GetParameterEOT ($section, $parameter)
351 Accessor method for the EOT text (in fact, style) of the specified
353 parameter. If any text is used as an EOT mark, this will be returned.
354 If the parameter was not recorded using HERE style multiple lines, Get‐
355 ParameterEOT returns undef.
356 SetParameterEOT ($section, $EOT)
358 Accessor method for the EOT text for the specified parameter. Sets the
360 HERE style marker text to the value $EOT. Once the EOT text is set,
361 that parameter will be saved in HERE style.
362 To un-set the EOT text, use DeleteParameterEOT ($section, $parameter).
364 DeleteParameterEOT ($section, $parmeter)
366 Removes the EOT marker for the given section and parameter. When writ‐
368 ing a configuration file, if no EOT marker is defined then "EOT" is
369 used.
370 Delete
372 Deletes the entire configuration file in memory.
374
376 tie %ini, 'Config::IniFiles', (-file=>$filename, [-option=>value ...] )
377 Using "tie", you can tie a hash to a Config::IniFiles object. This cre‐
379 ates a new object which you can access through your hash, so you use
380 this instead of the new method. This actually creates a hash of hashes
381 to access the values in the INI file. The options you provide through
382 "tie" are the same as given for the new method, above.
383 Here's an example:
385 use Config::IniFiles;
387 my %ini
389 tie %ini, 'Config::IniFiles', ( -file => "/path/configfile.ini" );
390 print "We have $ini{Section}{Parameter}." if $ini{Section}{Parameter};
392 Accessing and using the hash works just like accessing a regular hash
394 and many of the object methods are made available through the hash
395 interface.
396 For those methods that do not coincide with the hash paradigm, you can
398 use the Perl "tied" function to get at the underlying object tied to
399 the hash and call methods on that object. For example, to write the
400 hash out to a new ini file, you would do something like this:
401 tied( %ini )->WriteConfig( "/newpath/newconfig.ini" ) ⎪⎪
403 die "Could not write settings to new file.";
404 $val = $ini{$section}{$parameter}
406 Returns the value of $parameter in $section.
408 Because of limitations in Perl's tie implementation, multiline values
410 accessed through a hash will always be returned as a single value with
411 each line joined by the default line separator ($\). To break them
412 apart you can simple do this:
413 @lines = split( "$\", $ini{section}{multi_line_parameter} );
415 $ini{$section}{$parameter} = $value;
417 Sets the value of $parameter in $section to $value.
419 To set a multiline or multiv-alue parameter just assign an array refer‐
421 ence to the hash entry, like this:
422 $ini{$section}{$parameter} = [$value1, $value2, ...];
424 If the parameter did not exist in the original file, it will be cre‐
426 ated. However, Perl does not seem to extend autovivification to tied
427 hashes. That means that if you try to say
428 $ini{new_section}{new_paramters} = $val;
430 and the section 'new_section' does not exist, then Perl won't properly
432 create it. In order to work around this you will need to create a hash
433 reference in that section and then assign the parameter value. Some‐
434 thing like this should do nicely:
435 $ini{new_section} = {};
437 $ini{new_section}{new_paramters} = $val;
438 %hash = %{$ini{$section}}
440 Using the tie interface, you can copy whole sections of the ini file
442 into another hash. Note that this makes a copy of the entire section.
443 The new hash in no longer tied to the ini file, In particular, this
444 means -default and -nocase settings will not apply to %hash.
445 $ini{$section} = {}; %{$ini{$section}} = %parameters;
447 Through the hash interface, you have the ability to replace the entire
449 section with a new set of parameters. This call will fail, however, if
450 the argument passed in NOT a hash reference. You must use both lines,
451 as shown above so that Perl recognizes the section as a hash reference
452 context before COPYing over the values from your %parameters hash.
453 delete $ini{$section}{$parameter}
455 When tied to a hash, you can use the Perl "delete" function to com‐
457 pletely remove a parameter from a section.
458 delete $ini{$section}
460 The tied interface also allows you to delete an entire section from the
462 ini file using the Perl "delete" function.
463 %ini = ();
465 If you really want to delete all the items in the ini file, this will
467 do it. Of course, the changes won't be written to the actual file
468 unless you call RewriteConfig on the object tied to the hash.
469 Parameter names
471 my @keys = keys %{$ini{$section}}
473 while (($k, $v) = each %{$ini{$section}}) {...}
474 if( exists %{$ini{$section}}, $parameter ) {...}
475 When tied to a hash, you use the Perl "keys" and "each" functions to
477 iteratively list the parameters ("keys") or parameters and their values
478 ("each") in a given section.
479 You can also use the Perl "exists" function to see if a parameter is
481 defined in a given section.
482 Note that none of these will return parameter names that are part if
484 the default section (if set), although accessing an unknown parameter
485 in the specified section will return a value from the default section
486 if there is one.
487 Section names
489 foreach( keys %ini ) {...}
491 while (($k, $v) = each %ini) {...}
492 if( exists %ini, $section ) {...}
493 When tied to a hash, you use the Perl "keys" and "each" functions to
495 iteratively list the sections in the ini file.
496 You can also use the Perl "exists" function to see if a section is
498 defined in the file.
499
501 @Config::IniFiles::errors
502 Contains a list of errors encountered while parsing the configuration
504 file. If the new method returns undef, check the value of this to find
505 out what's wrong. This value is reset each time a config file is read.
506
508 · The output from [Re]WriteConfig/OutputConfig might not be as pretty
509 as it can be. Comments are tied to whatever was immediately below
510 them. And case is not preserved for Section and Parameter names if
511 the -nocase option was used.
512 · No locking is done by [Re]WriteConfig. When writing servers, take
514 care that only the parent ever calls this, and consider making your
515 own backup.
516
518 Note that this is only a reference for the package maintainers - one of
519 the upcoming revisions to this package will include a total clean up of
520 the data structure.
521 $iniconf->{cf} = "config_file_name"
523 ->{startup_settings} = \%orginal_object_parameters
524 ->{firstload} = 0
525 ->{nocase} = 0
526 ->{reloadwarn} = 0
527 ->{sects} = \@sections
528 ->{sCMT}{$sect} = \@comment_lines
529 ->{group}{$group} = \@group_members
530 ->{parms}{$sect} = \@section_parms
531 ->{EOT}{$sect}{$parm} = "end of text string"
532 ->{pCMT}{$sect}{$parm} = \@comment_lines
533 ->{v}{$sect}{$parm} = $value OR \@values
534
536 The original code was written by Scott Hutton. Then handled for a time
537 by Rich Bowen (thanks!), It is now managed by Jeremy Wadsack, with many
538 contributions from various other people.
539 In particular, special thanks go to (in roughly chronological order):
541 Bernie Cosell, Alan Young, Alex Satrapa, Mike Blazer, Wilbert van de
543 Pieterman, Steve Campbell, Robert Konigsberg, Scott Dellinger, R. Bern‐
544 stein, Daniel Winkelmann, Pires Claudio, Adrian Phillips, Marek
545 Rouchal, Luc St Louis, Adam Fischler, Kay Röpke, Matt Wilson, Raviraj
546 Murdeshwar and Slaven Rezic, Florian Pfaff
547 Geez, that's a lot of people. And apologies to the folks who were
549 missed.
550 If you want someone to bug about this, that would be:
552 Jeremy Wadsack <dgsupport at wadsack-allen dot com>
554 If you want more information, or want to participate, go to:
556 http://sourceforge.net/projects/config-inifiles/
558 Please send bug reports to config-inifiles-bugs@lists.sourceforge.net
560 Development discussion occurs on the mailing list con‐
562 fig-inifiles-dev@lists.sourceforge.net, which you can subscribe to by
563 going to the project web site (link above).
564 This program is free software; you can redistribute it and/or modify it
566 under the same terms as Perl itself.
567
569 $Log: IniFiles.pm,v $
570 Revision 2.38 2003/05/14 01:30:32 wadg
571 - fixed RewriteConfig and ReadConfig to work with open file handles
572 - added a test to ensure that blank files throw no warnings
573 - added a test for error messages from malformed lines
574 Revision 2.37 2003/01/31 23:00:35 wadg
576 Updated t/07misc test 4 to remove warning
577 Revision 2.36 2002/12/18 01:43:11 wadg
579 - Improved error message when an invalid line is encountered in INI file
580 - Fixed bug 649220; importing a non-file-based object into a file one
581 no longer destroys the original object
582 Revision 2.33 2002/11/12 14:48:16 grail
584 Addresses feature request - [ 403496 ] A simple change will allow support on more platforms
585 Revision 2.32 2002/11/12 14:15:44 grail
587 Addresses bug - [225971] Respect Read-Only Permissions of File System
588 Revision 2.31 2002/10/29 01:45:47 grail
590 [ 540867 ] Add GetFileName method
591 Revision 2.30 2002/10/15 18:51:07 wadg
593 Patched to stopwarnings about utf8 usage.
594 Revision 2.29 2002/08/15 21:33:58 wadg
596 - Support for UTF Byte-Order-Mark (Raviraj Murdeshwar)
597 - Made tests portable to Mac (p. kent)
598 - Made file parsing portable for s390/EBCDIC, etc. (Adam Fischler)
599 - Fixed import bug with Perl 5.8.0 (Marek Rouchal)
600 - Fixed precedence bug in WriteConfig (Luc St Louis)
601 - Fixed broken group detection in SetGroupMember and RemoveGroupMember (Kay Röpke)
602 - Added line continuation character (/) support (Marek Rouchal)
603 - Added configurable comment character support (Marek Rouchal)
604 Revision 2.28 2002/07/04 03:56:05 grail
606 Changes for resolving bug 447532 - _section::FETCH should return array ref for multiline values.
607 Revision 2.27 2001/12/20 16:03:49 wadg
609 - Fixed bug introduced in new valid file check where ';' comments in first lines were not considered valid
610 - Rearranged some tests to put them in the proper files (case and -default)
611 - Added more comment test to cover more cases
612 - Fixed first two comments tests which weren't doing anything
613 Revision 2.26 2001/12/19 22:20:50 wadg
615 #481513 Recognize badly formatted files
616 Revision 2.25 2001/12/12 20:44:48 wadg
618 Update to bring CVS version in synch
619 Revision 2.24 2001/12/07 10:03:06 wadg
621 222444 Ability to load from arbitrary source
622 Revision 2.23 2001/12/07 09:35:06 wadg
624 Forgot to include updates t/test.ini
625 Revision 2.22 2001/12/06 16:52:39 wadg
627 Fixed bugs 482353,233372. Updated doc for new mgr.
628 Revision 2.21 2001/08/14 01:49:06 wadg
630 Bug fix: multiple blank lines counted as one
631 Patched README change log to include recent updates
632 Revision 2.20 2001/06/07 02:49:52 grail
634 - Added checks for method parameters being defined
635 - fixed some regexes to make them stricter
636 - Fixed greps to make them consistent through the code (also a vain
637 attempt to help my editors do syntax colouring properly)
638 - Added AddSection method, replaced chunk of ReadConfig with AddSection
639 - Added case handling stuff to more methods
640 - Added RemoveGroupMember
641 - Made variable names more consistent through OO methods
642 - Restored Unix EOLs
643 Revision 2.19 2001/04/04 23:33:40 wadg
645 Fixed case sensitivity bug
646 Revision 2.18 2001/03/30 04:41:08 rbowen
648 Small documentation change in IniFiles.pm - pod2* was choking on misplaces
649 =item tags. And I regenerated the README
650 The main reason for this release is that the MANIFEST in the 2.17 version was
651 missing one of the new test suite files, and that is included in this
652 re-release.
653 Revision 2.17 2001/03/21 21:05:12 wadg
655 Documentation edits
656 Revision 2.16 2001/03/21 19:59:09 wadg
658 410327 -default not in original; 233255 substring parameters
659 Revision 2.15 2001/01/30 11:46:48 rbowen
661 Very minor documentation bug fixed.
662 Revision 2.14 2001/01/08 18:02:32 wadg
664 [Bug #127325] Fixed proken import; changelog; moved
665 Revision 2.13 2000/12/18 07:14:41 wadg
667 [Bugs# 122441,122437] Alien EOLs and OO delete method
668 Revision 2.12 2000/12/18 04:59:37 wadg
670 [Bug #125524] Writing multiline of 2 with tied hash
671 Revision 2.11 2000/12/16 12:53:13 grail
673 [BUG #122455] Problem with File Permissions
674 Revision 2.10 2000/12/13 17:40:18 rbowen
676 Updated version number so that CPAN will stop being angry with us.
677 Revision 1.18 2000/12/08 00:45:35 grail
679 Change as requested by Jeremy Wadsack, for Bug 123146
680 Revision 1.17 2000/12/07 15:32:36 grail
682 Further patch to duplicate sections bug, and replacement of repeated values handling code.
683 Revision 1.14 2000/11/29 11:26:03 grail
685 Updates for task 22401 (no more reloadsig) and 22402 (Group and GroupMember doco)
686 Revision 1.13 2000/11/28 12:41:42 grail
688 Added test for being able to add sections with wierd names like section⎪version2
689 Revision 1.11 2000/11/24 21:20:11 rbowen
691 Resolved SourceForge bug #122445 - a parameter should be split from its value on the first = sign encountered, not on the last one. Added test suite to test this, and put test case in test.ini
692 Revision 1.10 2000/11/24 20:40:58 rbowen
694 Updated MANIFEST to have file list of new files in t/
695 Updated IniFiles.pm to have mention of sourceforge addresses, rather than rcbowen.com addresses
696 Regenerated README from IniFiles.pm
697 Revision 1.9 2000/11/23 05:08:08 grail
699 Fixed documentation for bug 122443 - Check that INI files can be created from scratch.
700 Revision 1.1.1.1 2000/11/10 03:04:01 rbowen
702 Initial checkin of the Config::IniFiles source to SourceForge
703 Revision 1.8 2000/10/17 01:52:55 rbowen
705 Patch from Jeremy. Fixed "defined" warnings.
706 Revision 1.7 2000/09/21 11:19:17 rbowen
708 Mostly documentation changes. I moved the change log into the POD rather
709 than having it in a separate Changes file. This allows people to see the
710 changes in the Readme before they download the module. Now I just
711 need to make sure I remember to regenerate the Readme every time I do
712 a commit.
713 1.6 September 19, 2000 by JW, AS
715 * Applied several patches submitted to me by Jeremy and Alex.
716 * Changed version number to the CVS version number, so that I won't
717 have to think about changing it ever again. Big version change
718 should not be taken as a huge leap forward.
719 0.12 September 13, 2000 by JW/WADG
721 * Added documentation to clarify autovivification issues when
722 creating new sections
723 * Fixed version number (Oops!)
724 0.11 September 13, 2000 by JW/WADG
726 * Applied patch to Group and GroupMembers functions to return empty
727 list when no groups are present (submitted by John Bass, Sep 13)
728 0.10 September 13, 2000 by JW/WADG
730 * Fixed reference in POD to ReWriteFile. changes to RewriteConfig
731 * Applied patch for failed open bug submitted by Mordechai T. Abzug Aug 18
732 * Doc'd behavior of failed open
733 * Removed planned SIG testing from test.pl as SIGs have been removed
734 * Applied patch from Thibault Deflers to fix bug in parameter list
735 when a parameter value is undef
736 0.09
738 Hey! Where's the change log for 0.09?
739 0.08
741 2000-07-30 Adrian Phillips <adrianp@powertech.no>
742 * test.pl: Fixed some tests which use $\, and made those that try
744 to check a non existant val check against ! defined.
745 * IniFiles.pm: hopefully fixed use of $\ when this is unset
747 (problems found when running tests with -w). Similar problem with
748 $/ which can be undefined and trying to return a val which does
749 not exist. Modified val docs section to indicate a undef return
750 when this occurs.
751 0.07
753 Looks like we missed a change log for 0.07. Bummer.
754 0.06 Sun Jun 25, 2000 by Daniel Winkelmann
756 * Patch for uninitialized value bug in newval and setval
757 0.05 Sun Jun 18, 2000 by RBOW
759 * Added something to shut up -w on VERSIONS
760 * Removed unused variables
761 0.04 Thu Jun 15 - Fri Jun 16, 2000 by JW/WADG
763 * Added support for -import option on ->new
764 * Added support for tying a hash
765 * Edited POD for grammer, clarity and updates
766 * Updated test.pl file
767 * Fixed bug in multiline/single line output
768 * Fixed bug in default handling with tie interface
769 * Added bugs to test.pl for regression
770 * Fixed bug in {group} vs. {groups} property (first is valid)
771 * Fixed return value for empty {sects} or {parms}{$sect} in
772 Sections and Parameters methods
773 0.03 Thu Jun 15, 2000 by RBOW
775 * Modifications to permit 'use strict', and to get 'make test' working
776 again.
777 0.02 Tue Jun 13, 2000 by RBOW
779 * Fixed bug reported by Bernie Cosell - Sections, Parameters,
780 and GroupMembers return undef if there are no sections,
781 parameters, or group members. These functions now return
782 () if the particular value is undefined.
783 * Added some contributed documentation, from Alex Satrapa, explaining
784 how the internal data structure works.
785 * Set up a project on SourceForge. (Not a change, but worth
786 noting).
787 * Added Groups method to return a list of section groups.
788 0.01 Mon Jun 12, 2000 by RBOW
790 Some general code cleanup, in preparation for changes to
791 come. Put up Majordomo mailing list and sent invitation to
792 various people to join it.
793perl v5.8.8 2006-09-10 IniFiles(3)