| PackageDescription | This module provides an API for loading and saving of simple configuration
file records. Entries in the configuration file are essentially key,value
pairs, with the key and values separated by a single equals symbol. The
'key' consists only of alphanumeric characters. There are three types of
values, scalar values can contain anything except newlines. Trailing
whitespace will be trimmed unless the value is surrounded in double quotes.
eg
foo = Wizz
foo = "Wizz.... "
Long lines can be split with a backslash character, without introducing
newlines. Without double quotes, whitespace at beginning and end of lines
will be trimmed eg
foo = This is a long \
line of text
foo = "This is a long " \
"line of text"
Multi-line strings can be provided as 'HERE' documents, eg
foo = <<EOF
This is a multiple paragraph
block of text with newlines
preserved
EOF
Array values consist of a single right round bracket, following by one
'value' per line, terminated by a single left round bracket. eg
foo = (
Wizz
"Wizz... "
)
Hash values consist of a single right curly bracket, followed by one
key,value pair per line, terminated by a single left curly bracket. eg
foo = {
one = Wizz
two = "Wizz.... "
}
Arrays and hashes can be nested to arbitrary depth. |