Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMartin Langhoff <martin@laptop.org>2011-01-06 22:15:14 (GMT)
committer Daniel Drake <dsd@laptop.org>2011-01-06 22:17:41 (GMT)
commit5b0949640f963f2456e2f3520692237e2c526e2e (patch)
tree66d1559c102bd15730dac9114fff0ba15adadc4b /doc
parentf320782896b2fe8aa73282087e2f9b2bfe0da459 (diff)
Define oob_config_dir env var and interpolation
Path references in the config file can now refer to %(oob_config_dir)s which resolves to the directory where the config file resides. Additionally, scripts will find $oob_config_dir defined in the environment. For example this will find a custom script in the same dir as the config file: [custom_scripts] custom_script_1=%(oob_config_dir)s/myscript.sh In a custom script, this will apply a patch in the same directory as the config file: patch $INSTALL_DIR/etc/foo < $oob_config_dir/foo.patch [dsd: minor tweak, add documentation]
Diffstat (limited to 'doc')
-rw-r--r--doc/README9
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/README b/doc/README
index 4cac113..ceb7209 100644
--- a/doc/README
+++ b/doc/README
@@ -89,6 +89,15 @@ the first one are indented, e.g.:
but lines 2 through 4 must be indented
option2=foo
+Interpolation (basic assignment and use of variables) can be used, according
+to Python's ConfigParser documentation.
+
+Default variables automatically provided:
+
+oob_config_dir
+
+ The directory where the currently selected config file resides
+
In general, each section that can exist in the configuration file
corresponds to a specific module. The section name is the same as the
module name. The options that can exist in these sections are