From e4bbbd984b9aebc440d066da6258a8cfd4feb3ec Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Wed, 5 Nov 2014 12:32:20 +0000 Subject: [PATCH] Rewrite preamble to configuration section. --- doc/mkws-manual.markdown | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/doc/mkws-manual.markdown b/doc/mkws-manual.markdown index 864b56f..03e408c 100644 --- a/doc/mkws-manual.markdown +++ b/doc/mkws-manual.markdown @@ -841,16 +841,21 @@ Name Description ---- -Configuration object --------------------- +Configuration settings +---------------------- + +Configuration settings may be provided at the level of a indiviual widget, or a team, or globally. Per-widget configuration is +described above; per-team settings can be placed in a `config` widget belonging to the relevant team, and will be applied to that +team as a whole; and global settings are provided in the global variable `mkws_config`. This structure is a key-value lookup +table, and may specify the values of many settings. + +Some settings apply only to specific widgets; others to the behaviour of the tookit as a whole. When a widget does not itself have +a value specified for a particular configuration setting, its team is consulted; and if that also does not have a value, the global +settings are consulted. Only if this, too, is unspecified, is the default value used. -The configuration object `mkws_config` may be created before including -the MKWS JavaScript code to modify default behaviour. This structure -is a key-value lookup table, whose entries are described in the table -below. All entries are optional, but if specified must be given values -of the specified type. If ommitted, each setting takes the indicated -default value; long default values are in footnotes to keep the table -reasonably narrow. +The supported configuration settings are described in the table below. For those settings that apply only to particular widgets, +the relevant widgets are listed. All entries are optional, but if specified must be given values of the specified type. Long +default values are in footnotes to keep the table reasonably narrow. ---- Element Widget Type Default Description -- 1.7.10.4