From 9055d3d9219de819770f43fd8c297114aaf938d5 Mon Sep 17 00:00:00 2001 From: Daniel Eklöf Date: Fri, 28 May 2021 17:44:13 +0200 Subject: config: add ‘include’ directive MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- doc/foot.ini.5.scd | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) (limited to 'doc') 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. -- cgit v1.3