[Telepathy-commits] [telepathy-spec/master] Message_Part: add array-depth

[Simon McVittie]

Unlike telepathy-glib, telepathy-qt *needs* named types for (almost)
every type used in generated code. In this case we need to have a name
for an array of arrays of mappings (aaa{sv}). array²-name was proposed,
but is not well-formed XML :-( and doesn't scale if we ever need
an array of arrays of arrays of mappings (etc.).

The semantics of array-depth are:
* if array-depth is omitted, its value defaults to 1 if there is an
  array-name, or 0 otherwise
* if array-depth >= 1, an array-name must be given
* a number of array types equal to array-depth is generated
* the first array type is named using array-name
* subsequent array types are named in an implementation-dependent way:
  currently TelepathyQt4 just appends "List" repeatedly

Signed-off-by: Simon McVittie <simon.mcvittie at collabora.co.uk>
---
 spec/Channel_Interface_Messages.xml |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)

diff --git a/spec/Channel_Interface_Messages.xml b/spec/Channel_Interface_Messages.xml
index 9409535..aa632ba 100644
--- a/spec/Channel_Interface_Messages.xml
+++ b/spec/Channel_Interface_Messages.xml
@@ -178,7 +178,8 @@ USA.</p>
       </tp:flag>
     </tp:flags>
 
-    <tp:mapping name="Message_Part" array-name="Message_Part_List">
+    <tp:mapping name="Message_Part" array-name="Message_Part_List"
+      array-depth="2">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>Part of a message's content. In practice, this mapping never
           appears in isolation - messages are represented by a list of
-- 
1.5.6.5