known limitation to the supported types, partly for websetup's benefit
authorhttp://smcv.pseudorandom.co.uk/ <smcv@web>
Fri, 6 Dec 2013 09:38:57 +0000 (05:38 -0400)
committeradmin <admin@branchable.com>
Fri, 6 Dec 2013 09:38:57 +0000 (05:38 -0400)
doc/bugs/structured_config_data_is_mangled.mdwn

index 7d8f5defb958e35e096860825963472ee4334b5d..869d48e9676305a0892a1cccf6d9d1077e71e31a 100644 (file)
@@ -46,3 +46,16 @@ sub checkconfig {
     }
 }
 ~~~
     }
 }
 ~~~
+
+> `getsetup` defines config options to be one of: boolean, string, integer,
+> pagespec, "internal" (non-user-visible string), ref to an array of one of
+> those scalar types, or ref to a hash { string => one of those scalar types }.
+> IkiWiki::Setup also appears to support regexps (qr//), although that's
+> not documented (presumably they're treated the same as strings).
+> 
+> Supporting arbitrary arrays/hashes as values would require some way to
+> untaint the values recursively.
+>
+> Complex config data also can't be used with the [[plugins/websetup]]
+> plugin, which currently supports everything that IkiWiki::Setup does,
+> except for hashes. --[[smcv]]