|
@@ -0,0 +1,22 @@
|
|
|
+# INI-file module #
|
|
|
+
|
|
|
+This module provides resource types for use in managing INI-style configuration
|
|
|
+files. The main resource type is `ini_setting`, which is used to manage an
|
|
|
+individual setting in an INI file. Here's an example usage:
|
|
|
+
|
|
|
+ ini_setting { "sample setting":
|
|
|
+ path => '/tmp/foo.ini',
|
|
|
+ section => 'foo',
|
|
|
+ setting => 'foosetting',
|
|
|
+ value => 'FOO!',
|
|
|
+ ensure => present,
|
|
|
+ }
|
|
|
+
|
|
|
+A few noteworthy features:
|
|
|
+
|
|
|
+ * The module tries *hard* not to manipulate your file any more than it needs to.
|
|
|
+ In most cases, it should leave the original whitespace, comments, ordering,
|
|
|
+ etc. perfectly intact.
|
|
|
+ * Supports comments starting with either '#' or ';'.
|
|
|
+ * Will add missing sections if they don't exist.
|
|
|
+
|