22 lines
1.2 KiB
Text
22 lines
1.2 KiB
Text
General file format
|
|
-------------------
|
|
* Blank lines are ignored.
|
|
* Lines starting with # and ; (configurable), after leading whitespace removal, are treated as comments.
|
|
- Comments must appear on their own line.
|
|
Values can optionally be bookmarked with single or double quotes.
|
|
- If quotes are to be used, they must be the first and last characters of the value
|
|
- Occurances of the bookending quotes to be used within the value must be \ escaped. ???
|
|
- Whitespace within the quotes is retained verbatim.
|
|
- Backslash line continuation is supported within quotes (but leading whitespace on subsequent lines is removed).
|
|
Values can be continued by use of \ in the last column.
|
|
- Subsequent lines are subject to leading whitespace removal as normal.
|
|
- Comments are not recognised on subsequent lines - they are treated as part of the value.
|
|
Escaping of shell special characters is not required. ???
|
|
|
|
|
|
[section] format
|
|
----------------
|
|
* Section names must only be comprised of alphanumeric characters, plus _.-+
|
|
* The .-+ characters in section names will be converted to _
|
|
* Section names are case sensitive (unless --ignore-case? is used), so 'Foo' and 'foo' are different sections.
|
|
* Whitespace is ignored before and after the section name.
|