describe permitted .conf file content

Determined by inspecting the documentation for the Python `shlex`
module:

http://docs.python.org/2/library/shlex.html
Merge pull request #891 from Lx/gh-pages-conf-format

describe permitted .conf file content