add a little explanation about sconf, the config file syntax

This commit is contained in:
Mechiel Lukkien 2023-03-10 11:42:50 +01:00
parent f9eae88aba
commit 47b88550be
No known key found for this signature in database
2 changed files with 10 additions and 0 deletions

View file

@ -2,6 +2,11 @@
Package config holds the configuration file definitions for mox.conf (Static)
and domains.conf (Dynamic).
These config files are in "sconf" format. Summarized: Indent with tabs, "#" as
first non-whitespace character makes the line a comment (you cannot have a line
with both a value and a comment), strings are not quoted/escaped and can never
span multiple lines. See https://pkg.go.dev/github.com/mjl-/sconf for details.
Annotated empty/default configuration files you could use as a starting point
for your mox.conf and domains.conf, as generated by "mox config
describe-static" and "mox config describe-domains":

View file

@ -45,6 +45,11 @@ cat <<EOF
Package config holds the configuration file definitions for mox.conf (Static)
and domains.conf (Dynamic).
These config files are in "sconf" format. Summarized: Indent with tabs, "#" as
first non-whitespace character makes the line a comment (you cannot have a line
with both a value and a comment), strings are not quoted/escaped and can never
span multiple lines. See https://pkg.go.dev/github.com/mjl-/sconf for details.
Annotated empty/default configuration files you could use as a starting point
for your mox.conf and domains.conf, as generated by "mox config
describe-static" and "mox config describe-domains":