From 4f0e7264e3c3089e489d05bbb4371c449b0ed78d Mon Sep 17 00:00:00 2001 From: Chris Price Date: Thu, 16 Aug 2012 19:30:58 -0700 Subject: final commit for 0.0.1 release * Updated README * Fixed a small bug that would be triggered if the file specified by `path` didn't exist. * Added a smoke test manifest --- README.markdown | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 README.markdown (limited to 'README.markdown') diff --git a/README.markdown b/README.markdown new file mode 100644 index 0000000..3e6532e --- /dev/null +++ b/README.markdown @@ -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. + -- cgit v1.2.3