aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2021-05-28 15:44:13 +0000
committerDaniel Eklöf <daniel@ekloef.se>2021-05-28 15:44:13 +0000
commit9055d3d9219de819770f43fd8c297114aaf938d5 (patch)
tree702ee1227635f2cd73aa5b5f412066afa017a26c /doc
parentMerge branch 'add-window-title-template-parameter' (diff)
config: add ‘include’ directive
This allows you to include sub-configurations. For example, theme files. The ‘include’ directive is a top-level keyword. I.e. it cannot be used inside sections. * The included file must be specified with an absolute path * The included file is parsed in its own scope * Nested includes are allowed * Multiple include directives are allowed Closes #555
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 33e794aa..d9b61c39 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -64,6 +64,22 @@ in this order:
Default: _monospace:size=8_ (*font*), _not set_ (*font-bold*,
*font-italic*, *font-bold-italic*).
+*include*
+ Absolute path to configuration file to import.
+
+ The import file has its own section scope. I.e. the including
+ configuration is still in the default section after the include,
+ regardless of which section the included file ends in.
+
+ The path must be an absolute path.
+
+ Multiple include directives are allowed, but only one path per
+ directive.
+
+ Nested imports are allowed.
+
+ Default: _not set_.
+
*line-height*
An absolute value, in _points_, that override line height from the
font metrics.