diff options
| author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2007-09-28 12:25:32 +0000 |
|---|---|---|
| committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2007-09-28 12:25:32 +0000 |
| commit | a0d171f815cb1500779873ff6fc29338fb06fdbb (patch) | |
| tree | ca3f008034929b02efe2b5b655b994d11da4d31e /docs | |
| parent | 1184a7f4e85d1cd27c9815e9410c33f6d12e6097 (diff) | |
tubes.xml: when defining <parameters>, explain in terms of XML Schema
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/tubes.xml | 25 |
1 files changed, 16 insertions, 9 deletions
diff --git a/docs/tubes.xml b/docs/tubes.xml index b2f6420fe..9e70219a5 100644 --- a/docs/tubes.xml +++ b/docs/tubes.xml @@ -497,20 +497,27 @@ <li>"str": A Unicode string containing no zero bytes '\0'. In this implementation it cannot contain any other character forbidden by XML either. The <parameter> character content is the - string itself. The corresponding D-Bus signature is 's'.</li> + string itself. The corresponding D-Bus signature is 's'. + This corresponds to xs:string in XML Schema Part 2.</li> <li>"bytes": An array of bytes, represented in Base64. The corresponding - D-Bus signature is 'ay'.</li> + D-Bus signature is 'ay'. This corresponds to xs:base64Binary in + XML Schema Part 2.</li> <li>"uint": An unsigned integer representable in 32 bits. The - corresponding D-Bus signature is 'u' or 'q' on input, 'u' on output, - and the element's character content is an ASCII unsigned - decimal integer.</li> + corresponding D-Bus signature is 'u' or 'q' on input, 'u' on output. + The element's character content is an ASCII unsigned + decimal integer. This corresponds to xs:unsignedInt in XML + Schema Part 2.</li> <li>"int": A signed integer representable in 32 bits using two's complement. The corresponding D-Bus signature is 'i' or 'h' on input, 'i' on output, and the element's character content is an ASCII - decimal integer, possibly starting with '-'.</li> - <li>"bool": A boolean value represented as one of the strings "0" or "1", - representing False and True respectively. - The corresponding D-Bus signature is 'b'.</li> + decimal integer, possibly starting with '-' or '+'. This corresponds + to xs:int in XML Schema Part 2.</li> + <li>"bool": A boolean value represented as one of the strings "false", + "true", "0" or "1", as per xs:boolean in XML Schema Part 2. + The corresponding D-Bus signature is 'b'. (Implementation note: + early versions of Tubes in Gabble only accepted "0" or "1", so + implementations that care about backwards compatibility SHOULD emit + those representations).</li> </ul> </section2> <section2 topic='TODO'> |