diff options
| author | Joey Hess <joey@kodama.kitenet.net> | 2008-03-21 15:12:15 -0400 |
|---|---|---|
| committer | Joey Hess <joey@kodama.kitenet.net> | 2008-03-21 15:12:15 -0400 |
| commit | ca8852b434dae02b271ba2a1dddadfdf56ea3320 (patch) | |
| tree | bee601e18e83d396c1fd705cb62b856d29c0dce9 /doc/plugins | |
| parent | 17dc5df1f5d1068ea0d18bc0bd1c75dc9ebeb65a (diff) | |
external: Work around XML RPC's lack of support for null by passing a special sentinal value.
Diffstat (limited to 'doc/plugins')
| -rw-r--r-- | doc/plugins/write/external.mdwn | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/plugins/write/external.mdwn b/doc/plugins/write/external.mdwn index 4492cd0da..bda34b771 100644 --- a/doc/plugins/write/external.mdwn +++ b/doc/plugins/write/external.mdwn @@ -79,6 +79,19 @@ Other languages might not find it so easy. If not, it might be a good idea to convert these named parameters into something more natural for the language as part of their XML RPC interface. +## undef + +XML RPC has a limitation that it does not have a way to pass +undef/NULL/None. There is an extension to the protocol that supports this, +but it is not yet available in the [[cpan XML::RPC]] library used by +ikiwiki. + +Until the extension is available, ikiwiki allows undef to be communicated +over XML RPC by passing a sentinal value, a hash with a single key "null" +with a value of an empty string. External plugins that need to communicate +null values to or from ikiwiki will have to translate between undef and +the sentinal. + ## Function injection Some parts of ikiwiki are extensible by adding functions. For example, the |