summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonny Lamb <jonny.lamb@collabora.co.uk>2011-11-10 17:03:38 (GMT)
committerJonny Lamb <jonny.lamb@collabora.co.uk>2011-11-10 17:03:38 (GMT)
commit190ff931a85ffc8191dfac27c922f55d8ff284d7 (patch)
tree90ae271580dfc1f47f09b2caf744861a4139af91
parentc29b1e356a47212b61aae5476f9b058379474f07 (diff)
downloadtelepathy-spec-190ff931a85ffc8191dfac27c922f55d8ff284d7.tar.gz
telepathy-spec-190ff931a85ffc8191dfac27c922f55d8ff284d7.tar.xz
Chan.I.FT.Metadata: improve tp:rationale for a{sas}
Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>
-rw-r--r--spec/Channel_Interface_File_Transfer_Metadata.xml19
1 files changed, 14 insertions, 5 deletions
diff --git a/spec/Channel_Interface_File_Transfer_Metadata.xml b/spec/Channel_Interface_File_Transfer_Metadata.xml
index cbe566b..4c0fb0c 100644
--- a/spec/Channel_Interface_File_Transfer_Metadata.xml
+++ b/spec/Channel_Interface_File_Transfer_Metadata.xml
@@ -73,11 +73,20 @@
simple string → string hash table one should have exactly one
member in the value string list.
- <tp:rationale>A string list is used instead of a single string
- because that is what <a
- href="http://xmpp.org/extensions/xep-0004.html">data
- forms</a> use by default, and so one can transfer RDF
- triples.</tp:rationale>
+ <tp:rationale>
+ This property is an a{sas} primarily because this maps
+ easily to <a
+ href="http://xmpp.org/extensions/xep-0004.html">XEP-0004
+ Data Forms</a>, and allows more structured metadata than
+ a{ss} would. (For instance, a list of RDF triples could be
+ expressed as one long array of strings, or as three-element
+ values for a series of dummy key names, rather than as one
+ big string blob.)
+
+ While it might be convenient for applications to allow keys
+ of arbitrary types, the added convenience would be
+ outweighed by having to define the XMPP representation
+ </tp:rationale>
</tp:docstring>
<tp:member name="Key" type="s"/>