Commit 011d4dc60ef53f4aa3151daa296b4e3385626705 - telepathy-spec

Imported Upstream version 0.17.18 Simon McVittie 15 years ago

35 changed file(s) with 2360 addition(s) and 229 deletion(s). Raw diff Collapse all Expand all

+1208

-0

ChangeLog less more

	0	commit c6ea4fe81342eee731df3f215b6ff884deccfddf
	1	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	2	Date: 2009-01-20 11:38:15 +0000
	3
	4	Prepare release
	5
	6	NEWS \| 16 ++++++++++++++--
	7	spec/all.xml \| 2 +-
	8	2 files changed, 15 insertions(+), 3 deletions(-)
	9
	10	commit e496dda638e5fda4672c2579377e26cf33ff1fbb
	11	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	12	Date: 2009-01-20 11:37:11 +0000
	13
	14	All spec files: delete trailing whitespace
	15
	16	spec/Account.xml \| 2 +-
	17	spec/Channel_Interface_Tube.xml \| 4 ++--
	18	spec/Channel_Type_Contact_Search.xml \| 4 ++--
	19	spec/Channel_Type_DBus_Tube.xml \| 2 +-
	20	spec/Channel_Type_Stream_Tube.xml \| 4 ++--
	21	spec/Connection.xml \| 2 +-
	22	spec/Connection_Interface_Contact_Capabilities.xml \| 2 +-
	23	spec/Connection_Interface_Contact_Info.xml \| 2 +-
	24	spec/Connection_Interface_Presence.xml \| 2 +-
	25	9 files changed, 12 insertions(+), 12 deletions(-)
	26
	27	commit bc370c6bcdb254eb23b7767486513068f1da2bc4
	28	Merge: b3226d1... 9038104...
	29	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	30	Date: 2009-01-20 11:21:30 +0000
	31
	32	Merge branch 'codecs'
	33
	34	Signed-off-by: Robert McQueen <robert.mcqueen@collabora.co.uk>
	35
	36	commit b3226d13c6b65cffd7553f9d4f596551b3a3df9d
	37	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	38	Date: 2009-01-19 17:19:51 +0000
	39
	40	Location: fix typo in documentation
	41
	42	spec/Connection_Interface_Location.xml \| 4 ++--
	43	1 files changed, 2 insertions(+), 2 deletions(-)
	44
	45	commit 420617d5fea43c39fa074e239510919b9b212065
	46	Merge: b6c71e7... 9a9ef62...
	47	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	48	Date: 2009-01-19 14:09:13 +0000
	49
	50	Merge branch 'geoloc'
	51
	52	Signed-off-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	53
	54	commit b6c71e731b39a8b7b7202791d77c82bf1a3b1fff
	55	Merge: a51d113... 585352b...
	56	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	57	Date: 2009-01-19 14:01:53 +0000
	58
	59	Merge branch 'requesthandles'
	60
	61	Signed-off-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	62
	63	commit a51d11320f662d12f5a2cd16b01d6046b9d2055c
	64	Merge: 6c49724... 3ec1763...
	65	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	66	Date: 2009-01-19 14:01:21 +0000
	67
	68	Merge branch 'misc'
	69
	70	Signed-off-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	71
	72	commit 6c49724433c2e7431badf3801824eba7676015a8
	73	Merge: 578b281... dc05847...
	74	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	75	Date: 2009-01-19 12:12:41 +0000
	76
	77	Merge branch 'trivia'
	78
	79	Signed-off-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
	80
	81	commit 3ec1763779486d4407ae49bc5e49b74e85eb3539
	82	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	83	Date: 2009-01-19 12:10:48 +0000
	84
	85	NEWS: Mention DBusTube changes
	86
	87	NEWS \| 7 +++++++
	88	1 files changed, 7 insertions(+), 0 deletions(-)
	89
	90	commit 48ed238f33b1aab0473896b52d4e96d9aa68843e
	91	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	92	Date: 2009-01-16 16:28:22 +0000
	93
	94	ContactInfo: indicate when this version was added
	95
	96	spec/Connection_Interface_Contact_Info.xml \| 1 +
	97	1 files changed, 1 insertions(+), 0 deletions(-)
	98
	99	commit 11069cd0e741a91ff308fb548ffecd4c8d7c6cd7
	100	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	101	Date: 2009-01-16 16:27:46 +0000
	102
	103	Update NEWS
	104
	105	NEWS \| 38 ++++++++++++++++++++++++++++++++++++++
	106	1 files changed, 38 insertions(+), 0 deletions(-)
	107
	108	commit 00371adabfd2d524a591c63b73915383821f715f
	109	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	110	Date: 2009-01-16 16:27:19 +0000
	111
	112	Indicate when Location was added as a draft
	113
	114	spec/Connection_Interface_Location.xml \| 1 +
	115	1 files changed, 1 insertions(+), 0 deletions(-)
	116
	117	commit b3a034541f8b30222a2ad97ff7a51f7f502d323e
	118	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	119	Date: 2009-01-16 16:27:04 +0000
	120
	121	Declare FileTransfer to be stable
	122
	123	spec/Channel_Type_File_Transfer.xml \| 4 ++--
	124	1 files changed, 2 insertions(+), 2 deletions(-)
	125
	126	commit 578b281bf6f416f380989859a8e281a2f5c8a79c
	127	Merge: f3c783e... 5b09a38...
	128	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	129	Date: 2009-01-19 12:11:18 +0000
	130
	131	Merge branch 'nameforbindings'
	132
	133	Signed-off-by: Dafydd Harries <dafydd.harries@collabora.co.uk>
	134
	135	commit dc05847728c9bcca823d2f3c0c2ce6023b03c8f7
	136	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	137	Date: 2009-01-19 12:05:03 +0000
	138
	139	doc-generator.xsl: warn when 'out' arguments have no name
	140
	141	tools/doc-generator.xsl \| 8 ++------
	142	1 files changed, 2 insertions(+), 6 deletions(-)
	143
	144	commit c8c17a14f1e2bb67414212351744b4a3d8e4b815
	145	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	146	Date: 2009-01-19 12:04:49 +0000
	147
	148	ContactCapabilities: name the 'out' argument of GetContactCapabilities
	149
	150	spec/Connection_Interface_Contact_Capabilities.xml \| 2 +-
	151	1 files changed, 1 insertions(+), 1 deletions(-)
	152
	153	commit efba2b0f636fb618617b8814b14299e2b539daf3
	154	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	155	Date: 2009-01-19 12:04:29 +0000
	156
	157	CM, Properties: name all remaining unnamed 'out' arguments
	158
	159	spec/Connection_Manager.xml \| 9 +++++----
	160	spec/Properties_Interface.xml \| 6 ++++--
	161	2 files changed, 9 insertions(+), 6 deletions(-)
	162
	163	commit f3d59b86a05b65eabc3a1ea1c7efee44d15358ea
	164	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	165	Date: 2009-01-19 12:03:58 +0000
	166
	167	Connection stable API: name all remaining 'out' arguments
	168
	169	spec/Connection.xml \| 21 +++++++++++++--------
	170	spec/Connection_Interface_Aliasing.xml \| 7 ++++---
	171	spec/Connection_Interface_Avatars.xml \| 16 ++++++++--------
	172	spec/Connection_Interface_Capabilities.xml \| 6 ++++--
	173	spec/Connection_Interface_Presence.xml \| 3 ++-
	174	5 files changed, 31 insertions(+), 22 deletions(-)
	175
	176	commit d3efbc2f846cdc67b0e6d1b8d4ee65a8e735ce2e
	177	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	178	Date: 2009-01-19 12:02:47 +0000
	179
	180	Channel stable API: name all remaining 'out' arguments
	181
	182	spec/Channel.xml \| 11 ++++++---
	183	spec/Channel_Interface_Group.xml \| 29 +++++++++++++++++---------
	184	spec/Channel_Interface_Media_Signalling.xml \| 3 +-
	185	spec/Channel_Interface_Messages.xml \| 3 +-
	186	spec/Channel_Interface_Password.xml \| 5 ++-
	187	spec/Channel_Type_Room_List.xml \| 2 +-
	188	spec/Channel_Type_Streamed_Media.xml \| 6 +++-
	189	spec/Channel_Type_Text.xml \| 6 +++-
	190	spec/Channel_Type_Tubes.xml \| 18 ++++++++++------
	191	9 files changed, 53 insertions(+), 30 deletions(-)
	192
	193	commit 5b09a38b70856328349c866b406ad1e436510fcd
	194	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	195	Date: 2009-01-19 10:55:30 +0000
	196
	197	Set tp:name-for-bindings on C.T.Tubes methods to include "D_Bus"
	198
	199	This is ugly, but compatible with the camel-case-to-lower-case algorithm
	200	currently used in telepathy-glib. When we upgrade the telepathy-glib
	201	code generation to use tp:name-for-bindings, we don't want to cause an
	202	ABI break.
	203
	204	spec/Channel_Type_Tubes.xml \| 25 ++++++++++++++++++++-----
	205	1 files changed, 20 insertions(+), 5 deletions(-)
	206
	207	commit f3c783e47c685295e86ccb67cc7111cf096890de
	208	Merge: 996aaf0... f3f697b...
	209	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	210	Date: 2009-01-19 10:41:02 +0000
	211
	212	Merge commit 'wjt/dbus-tube'
	213
	214	Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
	215
	216	commit 996aaf0a366a8a0f40c5d60386402077d62d8267
	217	Merge: f723a8e... 755c10a...
	218	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	219	Date: 2009-01-19 10:36:45 +0000
	220
	221	Merge commit 'wjt/trivia'
	222
	223	Signed-off-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
	224
	225	commit f723a8e785e0840e22d9d7f881a73b90967e6879
	226	Merge: 915e923... 621ee45...
	227	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	228	Date: 2009-01-19 10:35:42 +0000
	229
	230	Merge branch 'contactinfo'
	231
	232	Signed-off-by: Will Thompson <will.thompson@collabora.co.uk>
	233
	234	commit f3f697bab50f5c4da73fb01e0f8c62b49a23e00f
	235	Author: Will Thompson <will.thompson@collabora.co.uk>
	236	Date: 2009-01-19 15:51:32 +1100
	237
	238	Make DBusNamesChanged.added a{us} not a(us)
	239
	240	spec/Channel_Type_DBus_Tube.xml \| 2 +-
	241	1 files changed, 1 insertions(+), 1 deletions(-)
	242
	243	commit e66ac5ec5bffb316d5da74bc7643eb91d1b2448d
	244	Author: Will Thompson <will.thompson@collabora.co.uk>
	245	Date: 2009-01-19 15:51:00 +1100
	246
	247	Make DBusNames property a{us} not a(us)
	248
	249	spec/Channel_Type_DBus_Tube.xml \| 2 +-
	250	1 files changed, 1 insertions(+), 1 deletions(-)
	251
	252	commit 688c5be767a39ee601f424bfe7cb96a79aca809d
	253	Author: Will Thompson <will.thompson@collabora.co.uk>
	254	Date: 2009-01-19 17:24:01 +1100
	255
	256	Add a DBus_Tube_Participants mapping type
	257
	258	spec/Channel_Type_DBus_Tube.xml \| 16 ++++++++++++++++
	259	1 files changed, 16 insertions(+), 0 deletions(-)
	260
	261	commit 755c10a11d37d6ddde28fff50c418c7710e9ca0c
	262	Author: Will Thompson <will.thompson@collabora.co.uk>
	263	Date: 2009-01-16 12:38:00 +0000
	264
	265	Mark ContactCapabilities with causes-havoc
	266
	267	spec/Connection_Interface_Contact_Capabilities.xml \| 3 ++-
	268	1 files changed, 2 insertions(+), 1 deletions(-)
	269
	270	commit 677139cf12822406b6dde710ef424701226021cc
	271	Author: Will Thompson <will.thompson@collabora.co.uk>
	272	Date: 2009-01-11 01:13:03 +0000
	273
	274	Allow Create/EnsureChannel to raise InvalidArgument
	275
	276	spec/Connection_Interface_Requests.xml \| 24 ++++++++++++++++++++++++
	277	1 files changed, 24 insertions(+), 0 deletions(-)
	278
	279	commit c00c16f5a9ad8cea89375b50c35f0cf27c5b694d
	280	Author: Will Thompson <will.thompson@collabora.co.uk>
	281	Date: 2009-01-10 23:18:02 +0000
	282
	283	DBusNamesChanged is change notification for DBusNames
	284
	285	spec/Channel_Type_DBus_Tube.xml \| 6 ++++--
	286	1 files changed, 4 insertions(+), 2 deletions(-)
	287
	288	commit 7fa08c3b63af0b01c4959d63d868af034a44907b
	289	Author: Will Thompson <will.thompson@collabora.co.uk>
	290	Date: 2009-01-10 19:36:24 +0000
	291
	292	Remove NotImplemented from OfferDBusTube errors.
	293
	294	If the CM doesn't implement DTubes, it shouldn't have given you a
	295	channel in the first place, should it? :)
	296
	297	spec/Channel_Type_DBus_Tube.xml \| 5 -----
	298	1 files changed, 0 insertions(+), 5 deletions(-)
	299
	300	commit 10b99a7039b7985d5225e62d6332afa41c539312
	301	Author: Will Thompson <will.thompson@collabora.co.uk>
	302	Date: 2009-01-10 19:01:00 +0000
	303
	304	Delete Channel.Type.DBusTube.GetDBusTubeAddress()
	305
	306	It is redundant with the return values of OfferDBusTube() and
	307	AcceptDBusTube()
	308
	309	spec/Channel_Type_DBus_Tube.xml \| 24 ------------------------
	310	1 files changed, 0 insertions(+), 24 deletions(-)
	311
	312	commit 1ac161888baa774300006aacfa0dad3f025c8002
	313	Author: Will Thompson <will.thompson@collabora.co.uk>
	314	Date: 2009-01-10 19:35:37 +0000
	315
	316	Make OfferDBusTube() return the bus address
	317
	318	spec/Channel_Type_DBus_Tube.xml \| 6 ++++++
	319	1 files changed, 6 insertions(+), 0 deletions(-)
	320
	321	commit c31b7fbcceb6d395f8308f4aed4a5d52841102cd
	322	Author: Will Thompson <will.thompson@collabora.co.uk>
	323	Date: 2009-01-10 19:00:48 +0000
	324
	325	Turn DBusTube.GetDBusNames into a property
	326
	327	spec/Channel_Type_DBus_Tube.xml \| 35 ++++++++++-------------------------
	328	1 files changed, 10 insertions(+), 25 deletions(-)
	329
	330	commit 3b180d335669316fd9580354f4cedb748659be10
	331	Author: Will Thompson <will.thompson@collabora.co.uk>
	332	Date: 2009-01-10 18:28:06 +0000
	333
	334	Clean up and linkify DBus_Tube_Member docs
	335
	336	spec/Channel_Type_Tubes.xml \| 18 +++++++++++++-----
	337	1 files changed, 13 insertions(+), 5 deletions(-)
	338
	339	commit 7060b6f97f95c7e55b41e094323bc0367a3453d6
	340	Author: Will Thompson <will.thompson@collabora.co.uk>
	341	Date: 2009-01-10 18:19:57 +0000
	342
	343	Remove mention of "tube id" from C.T.DBusTube
	344
	345	spec/Channel_Type_DBus_Tube.xml \| 8 --------
	346	1 files changed, 0 insertions(+), 8 deletions(-)
	347
	348	commit 621ee45e33bb332070d54d6dee9587a96e65eb99
	349	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	350	Date: 2009-01-16 17:28:05 +0000
	351
	352	ContactInfo: clarify precise semantics of Parameters_Mandatory
	353
	354	spec/Connection_Interface_Contact_Info.xml \| 12 ++++++++++--
	355	1 files changed, 10 insertions(+), 2 deletions(-)
	356
	357	commit 3c56bf0a773657d1fa4205f2c23922314232f58d
	358	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	359	Date: 2009-01-16 17:27:52 +0000
	360
	361	ContactInfo: more RFC terminology
	362
	363	spec/Connection_Interface_Contact_Info.xml \| 12 ++++++------
	364	1 files changed, 6 insertions(+), 6 deletions(-)
	365
	366	commit 3376bd1cd8ad168502d33ab42c7c983917d43cbe
	367	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	368	Date: 2009-01-16 17:22:27 +0000
	369
	370	ContactInfo: rename Flags to Parameters as per RFC 2426, and replace Mandatory with a set of flags
	371
	372	This allows for 31 bits of future expansion, and hopefully reduces
	373	confusion.
	374
	375	spec/Connection_Interface_Contact_Info.xml \| 42 ++++++++++++++++++---------
	376	1 files changed, 28 insertions(+), 14 deletions(-)
	377
	378	commit 585352b23f2e5702f9c4fd5c1fd383360e244096
	379	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	380	Date: 2009-01-16 16:09:49 +0000
	381
	382	Nail down what the intended errors from RequestHandles are, and give examples
	383
	384	Historically, basically all implementors of RequestHandles have had
	385	different interpretations of the error conditions, which was a mess.
	386
	387	spec/Connection.xml \| 26 ++++++++++++++++----------
	388	1 files changed, 16 insertions(+), 10 deletions(-)
	389
	390	commit 915e92351cd6d2b807e5c73ec88e232eff595bb2
	391	Merge: 61ed2fc... fd17b23...
	392	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	393	Date: 2009-01-16 16:02:57 +0000
	394
	395	Merge commit 'wjt/contact-info'
	396
	397	Conflicts:
	398
	399	spec/all.xml
	400
	401	commit fd17b2341ac6fbd4973be9355578f02ae4e8d2f6
	402	Author: Will Thompson <will.thompson@collabora.co.uk>
	403	Date: 2009-01-15 18:42:39 +0000
	404
	405	Add examples of possible values of SupportedFields
	406
	407	spec/Connection_Interface_Contact_Info.xml \| 42 +++++++++++++++++++++++----
	408	1 files changed, 35 insertions(+), 7 deletions(-)
	409
	410	commit fb9ea4b28cf22d0a9a2db0c95f1aa8722a6f819c
	411	Author: Will Thompson <will.thompson@collabora.co.uk>
	412	Date: 2009-01-15 18:42:10 +0000
	413
	414	Specify a representation for "any vCard flag".
	415
	416	spec/Connection_Interface_Contact_Info.xml \| 3 ++-
	417	1 files changed, 2 insertions(+), 1 deletions(-)
	418
	419	commit 74ed197c32cc8dd1b461ec2c978b2e78a90552b1
	420	Author: Will Thompson <will.thompson@collabora.co.uk>
	421	Date: 2009-01-15 18:41:49 +0000
	422
	423	Mark new ContactInfo interface as unstable
	424
	425	spec/Connection_Interface_Contact_Info.xml \| 3 ++-
	426	1 files changed, 2 insertions(+), 1 deletions(-)
	427
	428	commit 08828912f1065216b2f239b7f2d08ee1f5f523a1
	429	Author: Will Thompson <will.thompson@collabora.co.uk>
	430	Date: 2009-01-15 17:48:50 +0000
	431
	432	Rename ContactInfo2 to ContactInfo
	433
	434	spec/Connection_Interface_Contact_Info.xml \| 323 +++++++++++++++++++++++++++
	435	spec/Connection_Interface_Contact_Info2.xml \| 323 ---------------------------
	436	spec/all.xml \| 2 +-
	437	3 files changed, 324 insertions(+), 324 deletions(-)
	438
	439	commit 8e3d6b6336c9e638dc930cef71a8f7bc9189e46d
	440	Author: Will Thompson <will.thompson@collabora.co.uk>
	441	Date: 2009-01-15 17:45:57 +0000
	442
	443	Delete old ContactInfo interface.
	444
	445	spec/Connection_Interface_Contact_Info.xml \| 84 ----------------------------
	446	spec/all.xml \| 2 -
	447	2 files changed, 0 insertions(+), 86 deletions(-)
	448
	449	commit 9d88d2d2715f367725f317dd28fa01419453fe5b
	450	Author: Will Thompson <will.thompson@collabora.co.uk>
	451	Date: 2008-12-15 12:19:31 +0000
	452
	453	ContactInfo: define FieldSpec to represent settable fields
	454
	455	spec/Connection_Interface_Contact_Info2.xml \| 51 ++++++++++++++++++++++-----
	456	1 files changed, 42 insertions(+), 9 deletions(-)
	457
	458	commit e7d019095ddd4aafad190c1adc1a0a93f3a143b3
	459	Author: Will Thompson <will.thompson@collabora.co.uk>
	460	Date: 2008-12-04 15:25:00 +0000
	461
	462	ContactInfo: Remove redundant ChangeNotification flag.
	463
	464	spec/Connection_Interface_Contact_Info2.xml \| 15 ++++-----------
	465	1 files changed, 4 insertions(+), 11 deletions(-)
	466
	467	commit 55cee3262767d7c02b2474f5cde46b18af3c315a
	468	Author: Will Thompson <will.thompson@collabora.co.uk>
	469	Date: 2008-12-04 15:21:36 +0000
	470
	471	ContactInfo: add a SupportedFields property
	472
	473	spec/Connection_Interface_Contact_Info2.xml \| 12 ++++++++++++
	474	1 files changed, 12 insertions(+), 0 deletions(-)
	475
	476	commit 7f837da3b1fab6cf2dd182836ac3c855faea7c53
	477	Author: Will Thompson <will.thompson@collabora.co.uk>
	478	Date: 2008-12-04 15:00:16 +0000
	479
	480	ContactInfo: make RequestCI return a single contact's information directly
	481
	482	spec/Connection_Interface_Contact_Info2.xml \| 27 +++++++++++++++------------
	483	1 files changed, 15 insertions(+), 12 deletions(-)
	484
	485	commit e4e415b7a085d5b62c22a4e81d06bf92f041736d
	486	Author: Will Thompson <will.thompson@collabora.co.uk>
	487	Date: 2008-12-04 14:49:31 +0000
	488
	489	ContactInfo: add GetContactInfo to look up cached information
	490
	491	spec/Connection_Interface_Contact_Info2.xml \| 32 +++++++++++++++++++++++++++
	492	1 files changed, 32 insertions(+), 0 deletions(-)
	493
	494	commit e2e88ca91bdee09e342d0b722d274ffe1c2a1e89
	495	Author: Will Thompson <will.thompson@collabora.co.uk>
	496	Date: 2008-12-04 14:30:13 +0000
	497
	498	ContactInfo: rename GotContactInfo to ContactInfoChanged
	499
	500	spec/Connection_Interface_Contact_Info2.xml \| 8 ++++----
	501	1 files changed, 4 insertions(+), 4 deletions(-)
	502
	503	commit 8bc2a4a949687de5f790ee1ad6d2d4cd2fe80328
	504	Author: Will Thompson <will.thompson@collabora.co.uk>
	505	Date: 2008-12-04 12:38:17 +0000
	506
	507	ContactInfo: link to Contact_Info_Field in preamble
	508
	509	spec/Connection_Interface_Contact_Info2.xml \| 3 ++-
	510	1 files changed, 2 insertions(+), 1 deletions(-)
	511
	512	commit aa79704fdf8078f0dddec42dad16b849efa6a193
	513	Author: Will Thompson <will.thompson@collabora.co.uk>
	514	Date: 2008-12-04 12:36:29 +0000
	515
	516	ContactInfo: give an example of unescaping vCard values
	517
	518	spec/Connection_Interface_Contact_Info2.xml \| 8 +++++---
	519	1 files changed, 5 insertions(+), 3 deletions(-)
	520
	521	commit ee9f407e2c7185df61c3db9dd39232a87c1efb87
	522	Author: Will Thompson <will.thompson@collabora.co.uk>
	523	Date: 2008-12-04 12:17:08 +0000
	524
	525	ContactInfo: make one example field have two comma-separated values
	526
	527	spec/Connection_Interface_Contact_Info2.xml \| 3 ++-
	528	1 files changed, 2 insertions(+), 1 deletions(-)
	529
	530	commit 8ae75e360939ba0f0da7f85865a5b7e5fb0b69f7
	531	Author: Will Thompson <will.thompson@collabora.co.uk>
	532	Date: 2008-11-24 15:28:08 +0000
	533
	534	ContactInfo2: remove trailing newlines from examples
	535
	536	spec/Connection_Interface_Contact_Info2.xml \| 6 ++----
	537	1 files changed, 2 insertions(+), 4 deletions(-)
	538
	539	commit e024bbbd979aa3effdf1cde28b3c56914a0caa5a
	540	Author: Will Thompson <will.thompson@collabora.co.uk>
	541	Date: 2008-11-24 15:25:16 +0000
	542
	543	ContactInfo2: add a flag for SetContactInfo support
	544
	545	spec/Connection_Interface_Contact_Info2.xml \| 20 +++++++++++++++++---
	546	1 files changed, 17 insertions(+), 3 deletions(-)
	547
	548	commit bfa009ca425680f34531d68515f201b63e009724
	549	Author: Will Thompson <will.thompson@collabora.co.uk>
	550	Date: 2008-11-24 14:35:43 +0000
	551
	552	ContactInfo2: add blank lines between member definitions
	553
	554	spec/Connection_Interface_Contact_Info2.xml \| 2 ++
	555	1 files changed, 2 insertions(+), 0 deletions(-)
	556
	557	commit b0d4bfe797bf81d3ba3d740bec2bb4b592722e56
	558	Author: Will Thompson <will.thompson@collabora.co.uk>
	559	Date: 2008-11-20 11:46:48 +0000
	560
	561	ContactInfo2: Change_Notification doesn't mean GotContactInfo will fire
	562
	563	spec/Connection_Interface_Contact_Info2.xml \| 11 +++++------
	564	1 files changed, 5 insertions(+), 6 deletions(-)
	565
	566	commit 2073abc5c456116328904538275bbbfea0d611ed
	567	Author: Will Thompson <will.thompson@collabora.co.uk>
	568	Date: 2008-11-19 14:16:51 +0000
	569
	570	ContactInfo2: Use member-ref rather than dbus-ref interface=''
	571
	572	spec/Connection_Interface_Contact_Info2.xml \| 8 ++++----
	573	1 files changed, 4 insertions(+), 4 deletions(-)
	574
	575	commit 14f646ba50f627c2566115233e769117183404de
	576	Author: Will Thompson <will.thompson@collabora.co.uk>
	577	Date: 2008-11-19 14:11:54 +0000
	578
	579	ContactInfo2: Correct copyright dates and owners
	580
	581	spec/Connection_Interface_Contact_Info2.xml \| 7 +++----
	582	1 files changed, 3 insertions(+), 4 deletions(-)
	583
	584	commit 6cc48fde7e218c24aef70ab6062190242c5ec5a8
	585	Author: Will Thompson <will.thompson@collabora.co.uk>
	586	Date: 2008-11-19 14:11:28 +0000
	587
	588	ContactInfo2: Pluralize RequestContactInfo
	589
	590	spec/Connection_Interface_Contact_Info2.xml \| 12 +++++++-----
	591	1 files changed, 7 insertions(+), 5 deletions(-)
	592
	593	commit 154d0989a2846271b50e672d58c176a92cd39949
	594	Author: Will Thompson <will.thompson@collabora.co.uk>
	595	Date: 2008-11-19 14:06:54 +0000
	596
	597	ContactInfo2: Rename RequestAll to Request; drop partial info request method
	598
	599	spec/Connection_Interface_Contact_Info2.xml \| 28 +-------------------------
	600	1 files changed, 2 insertions(+), 26 deletions(-)
	601
	602	commit 250949da605bee14a9a310b4fe7c0f4cee65f260
	603	Author: Will Thompson <will.thompson@collabora.co.uk>
	604	Date: 2008-11-19 12:47:24 +0000
	605
	606	ContactInfo2: add flags describing change notification
	607
	608	spec/Connection_Interface_Contact_Info2.xml \| 37 +++++++++++++++++++++++++++
	609	1 files changed, 37 insertions(+), 0 deletions(-)
	610
	611	commit bb3009876fbc47f62a093730ebc079262c1ecc16
	612	Author: Will Thompson <will.thompson@collabora.co.uk>
	613	Date: 2008-11-19 11:26:15 +0000
	614
	615	ContactInfo2: rationale for flags not being an enum
	616
	617	spec/Connection_Interface_Contact_Info2.xml \| 5 +++++
	618	1 files changed, 5 insertions(+), 0 deletions(-)
	619
	620	commit a62baa522f21d721ce8b973a0c16a287a3df1001
	621	Author: Will Thompson <will.thompson@collabora.co.uk>
	622	Date: 2008-11-19 11:22:49 +0000
	623
	624	ContactInfo2: document vCard -> a(sasas) mapping in more detail
	625
	626	spec/Connection_Interface_Contact_Info2.xml \| 128 ++++++++++++++++++---------
	627	1 files changed, 87 insertions(+), 41 deletions(-)
	628
	629	commit 5a3da9ab96c016d6dd79dee50b127794675c1887
	630	Author: Will Thompson <will.thompson@collabora.co.uk>
	631	Date: 2008-11-18 23:47:56 +0000
	632
	633	ContactInfo2: SetContactInfo can't raise InvalidHandle
	634
	635	spec/Connection_Interface_Contact_Info2.xml \| 1 -
	636	1 files changed, 0 insertions(+), 1 deletions(-)
	637
	638	commit fa093a03e58b774147321c9e6cb4552dcb604d55
	639	Author: Will Thompson <will.thompson@collabora.co.uk>
	640	Date: 2008-11-18 23:44:30 +0000
	641
	642	ContactInfo2: SetContactInfo better describes its semantics
	643
	644	spec/Connection_Interface_Contact_Info2.xml \| 2 +-
	645	1 files changed, 1 insertions(+), 1 deletions(-)
	646
	647	commit 6d415333fced0ddecd898cb21b01a5f7249c38d7
	648	Author: Will Thompson <will.thompson@collabora.co.uk>
	649	Date: 2008-11-18 23:44:08 +0000
	650
	651	ContactInfo2: UpdateContactInfo can only change your own information
	652
	653	spec/Connection_Interface_Contact_Info2.xml \| 21 ++++++++-------------
	654	1 files changed, 8 insertions(+), 13 deletions(-)
	655
	656	commit 99697f68babe7a5c2ee99f5be68dc86989c93412
	657	Author: Will Thompson <will.thompson@collabora.co.uk>
	658	Date: 2008-11-18 23:35:39 +0000
	659
	660	ContactInfo2: Remove unused enumification of vCard field types
	661
	662	spec/Connection_Interface_Contact_Info2.xml \| 35 ---------------------------
	663	1 files changed, 0 insertions(+), 35 deletions(-)
	664
	665	commit 98e681cf5436d6df67a02f30a19e898eac724315
	666	Author: Will Thompson <will.thompson@collabora.co.uk>
	667	Date: 2008-11-18 23:32:00 +0000
	668
	669	ContactInfo2: represent vCard fields as sasas
	670
	671	spec/Connection_Interface_Contact_Info2.xml \| 34 +++++++++++++++------------
	672	1 files changed, 19 insertions(+), 15 deletions(-)
	673
	674	commit 4881012518abaf1bca1a2309c41d11bcbebedc11
	675	Author: Will Thompson <will.thompson@collabora.co.uk>
	676	Date: 2008-11-17 17:28:38 +0000
	677
	678	ContactInfo2: preamble tweaks
	679
	680	spec/Connection_Interface_Contact_Info2.xml \| 10 +++++-----
	681	1 files changed, 5 insertions(+), 5 deletions(-)
	682
	683	commit d30a29a6e112113d539250591b388003b6505e63
	684	Author: Will Thompson <will.thompson@collabora.co.uk>
	685	Date: 2008-11-17 17:06:28 +0000
	686
	687	ContactInfo2: move Contact_Info struct documentation to its definition
	688
	689	spec/Connection_Interface_Contact_Info2.xml \| 35 +++++++++++++++++++-------
	690	1 files changed, 25 insertions(+), 10 deletions(-)
	691
	692	commit 49d2d27859353b4c113f2934a916c0b6f458f0f0
	693	Author: Will Thompson <will.thompson@collabora.co.uk>
	694	Date: 2008-11-17 16:47:20 +0000
	695
	696	ContactInfo2: add some missing xmlns=xhtml attributes on docstrings
	697
	698	spec/Connection_Interface_Contact_Info2.xml \| 4 ++--
	699	1 files changed, 2 insertions(+), 2 deletions(-)
	700
	701	commit 69d7233f5ddfc574bc5c11afa979b4e112a1eb18
	702	Author: Will Thompson <will.thompson@collabora.co.uk>
	703	Date: 2008-11-12 17:31:44 +0000
	704
	705	ContactInfo2: Correct UpdateContactInfo's name for bindings
	706
	707	spec/Connection_Interface_Contact_Info2.xml \| 2 +-
	708	1 files changed, 1 insertions(+), 1 deletions(-)
	709
	710	commit 6b3a64f9a959da8cae808556c3e01b6a9e05f547
	711	Author: Will Thompson <will.thompson@collabora.co.uk>
	712	Date: 2008-11-12 13:10:02 +0000
	713
	714	Add new Contact_Info draft
	715
	716	spec/Connection_Interface_Contact_Info2.xml \| 190 +++++++++++++++++++++++++++
	717	spec/all.xml \| 1 +
	718	2 files changed, 191 insertions(+), 0 deletions(-)
	719
	720	commit 90381043abc303382b71056ff73fa5bc1b654702
	721	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	722	Date: 2009-01-15 17:16:04 +0000
	723
	724	MediaStreamHandler: add CodecsUpdated
	725
	726	spec/Media_Stream_Handler.xml \| 20 ++++++++++++++++++++
	727	1 files changed, 20 insertions(+), 0 deletions(-)
	728
	729	commit 61ed2fc0210ee684399c58ca32fbcea0f8f0b498
	730	Merge: 8729dec... 1b91a95...
	731	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	732	Date: 2009-01-15 16:25:49 +0000
	733
	734	Merge branch 'timestamp64'
	735
	736	commit 9a9ef620b4335167ba915da39d5bb670525e5906
	737	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	738	Date: 2009-01-15 16:10:53 +0000
	739
	740	Location: add trivial docs for Contact_Locations
	741
	742	spec/Connection_Interface_Location.xml \| 6 ++++++
	743	1 files changed, 6 insertions(+), 0 deletions(-)
	744
	745	commit 00d42f29b9c769ea494e35602e0ee10b12faf6b8
	746	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	747	Date: 2009-01-15 16:06:15 +0000
	748
	749	Location: add RequestLocation
	750
	751	spec/Connection_Interface_Location.xml \| 40 ++++++++++++++++++++++++++++++++
	752	1 files changed, 40 insertions(+), 0 deletions(-)
	753
	754	commit 89904c334478d25f38811c8d1cbed1412e68893b
	755	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	756	Date: 2009-01-15 16:05:32 +0000
	757
	758	Location: document possible errors
	759
	760	spec/Connection_Interface_Location.xml \| 11 +++++++++++
	761	1 files changed, 11 insertions(+), 0 deletions(-)
	762
	763	commit dff568c3d047af9fa96a241fbf604accfccef086
	764	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	765	Date: 2009-01-15 16:05:00 +0000
	766
	767	Mention the rationale for Get_Locations working the way it does
	768
	769	spec/Connection_Interface_Location.xml \| 6 ++++++
	770	1 files changed, 6 insertions(+), 0 deletions(-)
	771
	772	commit 381150db2415354413f698a7f22f506250042401
	773	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	774	Date: 2009-01-15 15:57:31 +0000
	775
	776	SetLocation: fix name-for-bindings
	777
	778	spec/Connection_Interface_Location.xml \| 2 +-
	779	1 files changed, 1 insertions(+), 1 deletions(-)
	780
	781	commit 3571b8a4f08d2f4753656d892126c600b837f199
	782	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	783	Date: 2009-01-15 15:57:24 +0000
	784
	785	GetLocations: don't guarantee a LocationUpdated signal later
	786
	787	spec/Connection_Interface_Location.xml \| 8 ++++----
	788	1 files changed, 4 insertions(+), 4 deletions(-)
	789
	790	commit e915bd212dfff03c22bf53efb7f4a74e818d0d8c
	791	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	792	Date: 2009-01-15 16:07:24 +0000
	793
	794	Location: use signed 64-bit timestamp
	795
	796	spec/Connection_Interface_Location.xml \| 2 +-
	797	1 files changed, 1 insertions(+), 1 deletions(-)
	798
	799	commit 8729decb0d95fcc59704ef83d58749b8c8d952d1
	800	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	801	Date: 2009-01-15 15:45:53 +0000
	802
	803	Sort interfaces in all.xml
	804
	805	spec/all.xml \| 4 ++--
	806	1 files changed, 2 insertions(+), 2 deletions(-)
	807
	808	commit 10d47c35b5ead7f894fdb22b3d37d666824877f1
	809	Merge: 8af4577... 397006b...
	810	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	811	Date: 2009-01-15 15:43:21 +0000
	812
	813	Merge commit 'alban/geoloc'
	814
	815	Conflicts:
	816
	817	spec/Connection_Interface_Contacts.xml
	818	spec/all.xml
	819
	820	commit 1b91a951cd72ba9cb7a447bf52b8322e02c658d9
	821	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	822	Date: 2009-01-15 15:40:18 +0000
	823
	824	Make Unix_Timestamp64 signed
	825
	826	This is technically an ABI break, but so far the only stable interfaces
	827	that use it do so in an a{sv}, where implementations should be permissive
	828	about types (telepathy-glib is, via the tp_asv_get_* functions).
	829
	830	spec/Channel_Dispatcher.xml \| 4 ++--
	831	spec/Channel_Interface_Messages.xml \| 4 ++--
	832	spec/Channel_Request.xml \| 2 +-
	833	spec/Channel_Type_File_Transfer.xml \| 2 +-
	834	spec/generic-types.xml \| 6 +++---
	835	5 files changed, 9 insertions(+), 9 deletions(-)
	836
	837	commit 8af4577bfd4331ddfb92d67ad927f258449c0ad6
	838	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	839	Date: 2009-01-13 19:17:07 +0000
	840
	841	Account: explicitly say how to get the well-known name of the Connection
	842
	843	spec/Account.xml \| 8 ++++++--
	844	1 files changed, 6 insertions(+), 2 deletions(-)
	845
	846	commit 1695a864c95e90864b4d3df74d16d8ba9f9dafd1
	847	Merge: 993a811... 98628a5...
	848	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	849	Date: 2009-01-13 19:14:40 +0000
	850
	851	Merge branch 'media-clarifications'
	852
	853	commit 98628a570cad2a579e5be436aa310c10a3a2efad
	854	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	855	Date: 2009-01-13 19:13:15 +0000
	856
	857	Re-clarify clarifications as discussed with Rob, Sjoerd, Will and Guillaume
	858
	859	spec/Media_Stream_Handler.xml \| 50 +++++++++++++++++++++++++++-------------
	860	1 files changed, 34 insertions(+), 16 deletions(-)
	861
	862	commit ce488dfc7a0dcd7ce0d40c4dd3c568d3833a8aff
	863	Author: Olivier Crête <olivier.crete@collabora.co.uk>
	864	Date: 2009-01-12 20:42:11 -0500
	865
	866	Explain what SetLocalCodecs is for
	867
	868	spec/Media_Stream_Handler.xml \| 9 +++++----
	869	1 files changed, 5 insertions(+), 4 deletions(-)
	870
	871	commit 113516caa2f263c1c6136c9760f71d1e546c46b7
	872	Author: Olivier Crête <olivier.crete@collabora.co.uk>
	873	Date: 2009-01-12 18:14:45 -0500
	874
	875	Deprecated SetLocalCodecs and RemoteRemoteCandidate methods that are not implemented
	876
	877	spec/Media_Stream_Handler.xml \| 7 +++++++
	878	1 files changed, 7 insertions(+), 0 deletions(-)
	879
	880	commit c40460550b6c269fc4903589d5970e56987be3b2
	881	Author: Olivier Crête <olivier.crete@collabora.co.uk>
	882	Date: 2009-01-12 18:14:20 -0500
	883
	884	Clarify documentation of some StreamHandler functions
	885
	886	spec/Media_Stream_Handler.xml \| 7 +++++--
	887	1 files changed, 5 insertions(+), 2 deletions(-)
	888
0	889	commit 993a81189d0b790458a8798493d6cca630721a46
1	890	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
2	891	Date: 2009-01-06 19:50:39 +0000

577	1466	spec/Account.xml \| 8 +++++---
578	1467	1 files changed, 5 insertions(+), 3 deletions(-)
579	1468
	1469	commit 397006b666ffa8562e3f1ffc276bbc4273ded3f8
	1470	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1471	Date: 2008-11-21 20:42:32 +0000
	1472
	1473	Location: fix enum Rich_Presence_Access_Control_Type
	1474
	1475	spec/Connection_Interface_Presence.xml \| 8 ++++----
	1476	1 files changed, 4 insertions(+), 4 deletions(-)
	1477
580	1478	commit 0aebdc82b065fce085658a6e824a860dce7fae05
581	1479	Author: Will Thompson <will.thompson@collabora.co.uk>
582	1480	Date: 2008-11-21 20:03:56 +0000

724	1622
725	1623	spec/Channel_Type_Room_List.xml \| 57 +++++++++++++++++++++++++++-----------
726	1624	1 files changed, 40 insertions(+), 17 deletions(-)
	1625
	1626	commit f43305937f6bb237edea057cfe81e60452564011
	1627	Merge: 8968632... a16faf6...
	1628	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1629	Date: 2008-11-21 18:12:37 +0000
	1630
	1631	Merge branch 'master' into geoloc
727	1632
728	1633	commit a16faf68cfc26f2b53dcef86c6447854bddd8545
729	1634	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>

925	1830	spec/Channel_Interface_Tube.xml \| 2 +-
926	1831	1 files changed, 1 insertions(+), 1 deletions(-)
927	1832
	1833	commit 8968632208a1d57337ff97528c23132dab4ad106
	1834	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1835	Date: 2008-11-19 01:26:21 +0000
	1836
	1837	Location: use 64 bits for unix timestamps
	1838
	1839	spec/Connection_Interface_Location.xml \| 2 +-
	1840	1 files changed, 1 insertions(+), 1 deletions(-)
	1841
	1842	commit 1da38084237bc2c4f61baf2d4516ea05bf36ae30
	1843	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1844	Date: 2008-11-19 01:24:34 +0000
	1845
	1846	Location: horizontal-error-m: s/vertical/horizontal/
	1847
	1848	spec/Connection_Interface_Location.xml \| 2 +-
	1849	1 files changed, 1 insertions(+), 1 deletions(-)
	1850
	1851	commit 2074ae2ef468e0141075a9f7277a23daeb3e5638
	1852	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1853	Date: 2008-11-19 01:23:36 +0000
	1854
	1855	Location: Accuracy_Level_PostalCode: should be Postal_Code
	1856
	1857	spec/Connection_Interface_Location.xml \| 2 +-
	1858	1 files changed, 1 insertions(+), 1 deletions(-)
	1859
	1860	commit eb04b6552768fe1f21774ba3c429a0a5bb0d2010
	1861	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1862	Date: 2008-11-19 01:23:00 +0000
	1863
	1864	Location: accuracy-class: rename to accuracy-level
	1865
	1866	spec/Connection_Interface_Location.xml \| 2 +-
	1867	1 files changed, 1 insertions(+), 1 deletions(-)
	1868
	1869	commit cca9cbab203f1a411236520bdf487e64ba9b23a3
	1870	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1871	Date: 2008-11-19 01:16:16 +0000
	1872
	1873	Location: use <tp:member-ref> for links
	1874
	1875	spec/Connection_Interface_Location.xml \| 7 ++++---
	1876	1 files changed, 4 insertions(+), 3 deletions(-)
	1877
	1878	commit ffb37488137010bf9a059e0df41cb04f9a8fe3c6
	1879	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1880	Date: 2008-11-19 01:10:49 +0000
	1881
	1882	Location: Rename signal to LocationUpdated
	1883
	1884	spec/Connection_Interface_Location.xml \| 6 +++---
	1885	1 files changed, 3 insertions(+), 3 deletions(-)
	1886
	1887	commit ef6d75db2bedbf117860e927e99a9f926aca39ce
	1888	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1889	Date: 2008-11-19 01:10:04 +0000
	1890
	1891	Location: Remove GetLocations and rename RequestLocations to GetLocations
	1892
	1893	spec/Connection_Interface_Location.xml \| 23 -----------------------
	1894	1 files changed, 0 insertions(+), 23 deletions(-)
	1895
	1896	commit 3d2ddaef98d3cc58727a5de28f4d07e989dc62ff
	1897	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1898	Date: 2008-11-19 01:07:57 +0000
	1899
	1900	Add support for C.I.Location.DRAFT in the C.I.Contacts interface
	1901
	1902	spec/Connection_Interface_Contacts.xml \| 6 ++++++
	1903	1 files changed, 6 insertions(+), 0 deletions(-)
	1904
	1905	commit 7e4e91f3e1e09c171da62ffcc3f7714fc8d98eb2
	1906	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1907	Date: 2008-11-19 00:56:24 +0000
	1908
	1909	fix typo: "propogation"
	1910
	1911	spec/Connection_Interface_Location.xml \| 2 +-
	1912	1 files changed, 1 insertions(+), 1 deletions(-)
	1913
	1914	commit ebb8ded17ffc940e2977b0e9ecc7aec99e984c1b
	1915	Merge: 47a8565... 1d41503...
	1916	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	1917	Date: 2008-11-19 00:55:37 +0000
	1918
	1919	Merge branch 'master' into geoloc
	1920
928	1921	commit ae1948e61c5585c4d2c78ffdef4f2eebf2885c0a
929	1922	Author: Alban Crequy <alban.crequy@collabora.co.uk>
930	1923	Date: 2008-11-18 20:05:54 +0000

1604	2597
1605	2598	spec/Channel_Interface_Messages.xml \| 10 +++++++---
1606	2599	1 files changed, 7 insertions(+), 3 deletions(-)
	2600
	2601	commit 47a8565af5dc7e7bb8dc634b30891fb6b92b72ed
	2602	Merge: f49fe2e... 3adc1ca...
	2603	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	2604	Date: 2008-10-31 00:43:46 +0000
	2605
	2606	Merge branch 'master' into geoloc
1607	2607
1608	2608	commit 3adc1caaee6fc0fad7a5b5cc3de9345aecf3353c
1609	2609	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>

2206	3206
2207	3207	NEWS \| 14 +++++---------
2208	3208	1 files changed, 5 insertions(+), 9 deletions(-)
	3209
	3210	commit f49fe2e0b9c7cf6137b1040bb130554669e92632
	3211	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	3212	Date: 2008-10-12 12:45:07 -0400
	3213
	3214	Add tp:name-for-bindings for geoloc
	3215
	3216	spec/Connection_Interface_Location.xml \| 12 ++++++------
	3217	spec/all.xml \| 1 +
	3218	2 files changed, 7 insertions(+), 6 deletions(-)
	3219
	3220	commit 3a27d76f2ee07794c9b92d13b56099d0214e35ab
	3221	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	3222	Date: 2008-10-12 12:44:51 -0400
	3223
	3224	Fix tp:type
	3225
	3226	spec/Connection_Interface_Presence.xml \| 2 +-
	3227	1 files changed, 1 insertions(+), 1 deletions(-)
	3228
	3229	commit b086197302f6bb237d8605dbbe8ada1b069c366b
	3230	Merge: af23185... cb14f04...
	3231	Author: Alban Crequy <alban.crequy@collabora.co.uk>
	3232	Date: 2008-10-12 12:24:15 -0400
	3233
	3234	Merge commit 'origin/master' into geoloc
	3235
	3236	Conflicts:
	3237
	3238	spec/all.xml
2209	3239
2210	3240	commit cb14f04f94ba39dc38d9646f7ef08512e53ad3ae
2211	3241	Author: Will Thompson <will.thompson@collabora.co.uk>

8612	9642	spec/Connection.xml \| 6 ++----
8613	9643	1 files changed, 2 insertions(+), 4 deletions(-)
8614	9644
	9645	commit af23185d89f496a28edc76998dbd56fef7440427
	9646	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9647	Date: 2008-05-22 14:32:00 +0000
	9648
	9649	Location: cross-reference types
	9650
	9651
	9652	20080522143200-53eee-5d5bc6e4126c5aa0fdcd79e6f764c08cb59dcc74.gz
	9653
	9654	spec/Connection_Interface_Location.xml \| 10 +++++-----
	9655	1 files changed, 5 insertions(+), 5 deletions(-)
	9656
8615	9657	commit 3c8ef602bac4230a34510f42821749336bc0dcc3
8616	9658	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
8617	9659	Date: 2008-05-22 10:32:15 +0000

8623	9665
8624	9666	spec/Connection.xml \| 13 +++++++++++--
8625	9667	1 files changed, 11 insertions(+), 2 deletions(-)
	9668
	9669	commit a9d3febd4d639472b59f16ba2c5c1e6a61fc69ea
	9670	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9671	Date: 2008-05-21 14:30:50 +0000
	9672
	9673	Improve descriptions of location parameters
	9674
	9675
	9676	20080521143050-53eee-b7bc34ef84b072e1f85d3f993cf8cfea72df0ff5.gz
	9677
	9678	spec/Connection_Interface_Location.xml \| 90 +++++++++++++++++++++++++++-----
	9679	1 files changed, 76 insertions(+), 14 deletions(-)
	9680
	9681	commit 964701df7ee3f4cfe30e6f5c8df8c6545a772a17
	9682	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9683	Date: 2008-05-21 14:30:40 +0000
	9684
	9685	Document the Location_Accuracy_Level enum
	9686
	9687
	9688	20080521143040-53eee-a45d9029a23d674788222e7a492b627a58a2644e.gz
	9689
	9690	spec/Connection_Interface_Location.xml \| 44 ++++++++++++++++++++++++++-----
	9691	1 files changed, 37 insertions(+), 7 deletions(-)
	9692
	9693	commit 972b7d853bcbda532fb08bc9948f302a2720c785
	9694	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9695	Date: 2008-05-21 14:30:33 +0000
	9696
	9697	Reference XEP-0080 and Geoclue
	9698
	9699
	9700	20080521143033-53eee-323fbab3aad174be35660dd8735948a78ae8cef1.gz
	9701
	9702	spec/Connection_Interface_Location.xml \| 6 ++++++
	9703	1 files changed, 6 insertions(+), 0 deletions(-)
	9704
	9705	commit e5cce4f255694d46709c5afa49fff8b53a720f50
	9706	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9707	Date: 2008-05-21 14:30:27 +0000
	9708
	9709	Mark Location as DRAFT
	9710
	9711
	9712	20080521143027-53eee-3bce1a9deda91f3e3fa83d8345af0c1254856ea9.gz
	9713
	9714	spec/Connection_Interface_Location.xml \| 2 +-
	9715	1 files changed, 1 insertions(+), 1 deletions(-)
	9716
	9717	commit 79a351dded2cf8a54254497093d0afc9ac8abf14
	9718	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9719	Date: 2008-05-20 17:49:24 +0000
	9720
	9721	Presence: stop talking about "location" in Rich_Presence_Access_Control_Type
	9722
	9723
	9724	20080520174924-53eee-74536264e47d6704eba20ed8348baf9fd89c9134.gz
	9725
	9726	spec/Connection_Interface_Presence.xml \| 14 ++++++++++----
	9727	1 files changed, 10 insertions(+), 4 deletions(-)
	9728
	9729	commit 1c7bb8e0b7e2e8d6f5839847062ca758373e83f9
	9730	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9731	Date: 2008-05-20 17:26:06 +0000
	9732
	9733	Location: use Rich_Presence_Access_Control
	9734
	9735
	9736	20080520172606-53eee-d1fc59020c70f0a69e6aa6352eb96bdc78fe2d4d.gz
	9737
	9738	spec/Connection_Interface_Location.xml \| 53 +------------------------------
	9739	1 files changed, 2 insertions(+), 51 deletions(-)
	9740
	9741	commit 64c2a6f7b916347e0217b6f9057b06598242673a
	9742	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9743	Date: 2008-05-20 17:25:36 +0000
	9744
	9745	Add Rich_Presence_Access_Control to Presence interface
	9746
	9747
	9748	20080520172536-53eee-4be22192d35d1d42a3f245757e611de8b65f9596.gz
	9749
	9750	spec/Connection_Interface_Presence.xml \| 55 ++++++++++++++++++++++++++++++++
	9751	1 files changed, 55 insertions(+), 0 deletions(-)
	9752
	9753	commit 1574509904ee87f7e69bd8f7e2f5847a826b3a8f
	9754	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9755	Date: 2008-05-20 17:24:49 +0000
	9756
	9757	Location: add more docs and RequestLocations
	9758
	9759
	9760	20080520172449-53eee-67d3af2a4ea6f03bb0931ecc92a9bfe55644408d.gz
	9761
	9762	spec/Connection_Interface_Location.xml \| 47 ++++++++++++++++++++++++++++++++
	9763	1 files changed, 47 insertions(+), 0 deletions(-)
	9764
	9765	commit b40c68ab8556269c7f0067e4ae83b622eaaef903
	9766	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	9767	Date: 2008-05-20 17:24:34 +0000
	9768
	9769	Location: re-indent intro
	9770
	9771
	9772	20080520172434-53eee-05322dad124ceb34870dbbc7b708ebed0543d3d8.gz
	9773
	9774	spec/Connection_Interface_Location.xml \| 35 ++++++++++++++++---------------
	9775	1 files changed, 18 insertions(+), 17 deletions(-)
8626	9776
8627	9777	commit 3a0c85404bcaa0b4720ac7af1f4b77070f86091e
8628	9778	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>

9960	11110
9961	11111	spec/Connection.xml \| 29 +++++++++++++++++++++++++++--
9962	11112	1 files changed, 27 insertions(+), 2 deletions(-)
	11113
	11114	commit d21865921260d50c752e871aab875b25c507a02c
	11115	Author: Robert McQueen <robert.mcqueen@collabora.co.uk>
	11116	Date: 2008-05-14 18:56:46 +0000
	11117
	11118	add description of the Location interface (from the depths of the past)
	11119
	11120
	11121	20080514185646-418b8-ef83edbf6391910bc170ae55244ead3133f34eaa.gz
	11122
	11123	spec/Connection_Interface_Location.xml \| 17 +++++++++++++++++
	11124	1 files changed, 17 insertions(+), 0 deletions(-)
	11125
	11126	commit 3c4e24c06d107af7e5e711b0cbef0c85d7d84b92
	11127	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	11128	Date: 2008-04-18 10:42:29 +0000
	11129
	11130	Merge with 0.17.3
	11131
	11132
	11133	20080418104229-53eee-67c1ff03c1466be05855c9df38baeab088e41bde.gz
	11134
	11135	commit 4a8bb2031cf8e2272cd598bc5d54021047e017b3
	11136	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	11137	Date: 2008-02-28 11:48:21 +0000
	11138
	11139	Fix typo
	11140
	11141
	11142	20080228114821-53eee-e608b36c20ed9aca0d2025f55c2057ee1f0af219.gz
	11143
	11144	spec/Connection_Interface_Location.xml \| 2 +-
	11145	1 files changed, 1 insertions(+), 1 deletions(-)
	11146
	11147	commit ee49c9af5f3fe25b8c71709154b613e55705fbfd
	11148	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	11149	Date: 2008-02-28 11:42:55 +0000
	11150
	11151	Location: support setting and getting access control (a thinly disguised version of XMPP pubsub access-control models)
	11152
	11153
	11154	20080228114255-53eee-500ed518565c6f6613d028c42594894c826795a4.gz
	11155
	11156	spec/Connection_Interface_Location.xml \| 64 ++++++++++++++++++++++++++++++++
	11157	1 files changed, 64 insertions(+), 0 deletions(-)
	11158
	11159	commit 24c2309076f8301e905da2de69de7dd07e19018b
	11160	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>
	11161	Date: 2008-02-28 10:54:22 +0000
	11162
	11163	Add a first draft of the Location interface, based on XEP-0080 and Geoclue
	11164
	11165
	11166	20080228105422-53eee-6d27c25181c281423eae3fa457b917658724ea2d.gz
	11167
	11168	spec/Connection_Interface_Location.xml \| 174 ++++++++++++++++++++++++++++++++
	11169	spec/all.xml \| 8 +-
	11170	2 files changed, 176 insertions(+), 6 deletions(-)
9963	11171
9964	11172	commit c07345bfe91675fb1507002528959195f303e817
9965	11173	Author: Simon McVittie <simon.mcvittie@collabora.co.uk>

+57

-0

NEWS less more

0	0	This file contains the same edited highlights as the announcement emails.
1	1	For full details, see the ChangeLog in tarballs, or "git log" in Git
2	2	checkouts.
	3
	4	telepathy-spec 0.17.18 (2009-01-20)
	5	===================================
	6
	7	The "telekinesis" release.
	8
	9	API changes:
	10
	11	* Unix_Timestamp64 is now a signed 64-bit integer, not unsigned as it was
	12	previously. In practice this shouldn't cause problems, as it only appeared
	13	in variants, where implementations should be lenient about types in any case.
	14
	15	* Changed the tp:name-for-bindings annotation on the Tubes channel type to
	16	match what telepathy-glib historically generated, meaning that when
	17	telepathy-glib code generation changes to use this annotation in 0.7.23,
	18	it will not break ABI. (The only binding using tp:name-for-bindings so far
	19	is telepathy-qt4, which is not ABI-stable yet anyway, so this change seems
	20	unlikely to break things.)
	21
	22	Changes to experimental API:
	23
	24	* Improve the DBusTube interface: use maps (handle → D-Bus name) rather than
	25	lists of structs for D-Bus names, make OfferDBusTube return the address that
	26	will be used, remove GetDBusTubeAddress as a result, and turn GetDBusNames
	27	into a property
	28
	29	New API:
	30
	31	* The FileTransfer channel type is now considered stable (much rejoicing)
	32
	33	* A new type has been added, Rich_Presence_Access_Control, for use by
	34	rich presence interfaces like Location
	35
	36	New experimental API:
	37
	38	* Replaced the old ContactInfo interface with a much-improved draft
	39
	40	* Added the Location interface, hopefully the first of several "rich presence"
	41	interfaces
	42
	43	Deprecations:
	44
	45	* MediaStreamHandler.RemoveRemoteCandidate is deprecated: it seemed like a
	46	good idea at the time, but turned out not to be useful
	47
	48	* SetStreamPlaying with argument FALSE is basically meaningless, and is now
	49	deprecated
	50
	51	Miscellaneous:
	52
	53	* Sorted out the possible errors for RequestHandles, hopefully for the last
	54	time
	55
	56	* Some clarifications to MediaStreamHandler
	57
	58	* Added names for all 'out' parameters and made doc-generator.xsl warn
	59	whenever this has not been done
3	60
4	61	telepathy-spec 0.17.17 (2009-01-06)
5	62	===================================

-3

spec/Account.xml less more

368	368	<property name="Connection" tp:name-for-bindings="Connection"
369	369	type="o" access="read">
370	370	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
371		Either the object path of the <tp:dbus-ref
	371	<p>Either the object path of the <tp:dbus-ref
372	372	namespace="org.freedesktop.Telepathy">Connection</tp:dbus-ref> to
373	373	this account, or the special value <code>'/'</code> if there is no
374		connection.
	374	connection.</p>
	375
	376	<p>If this object path is not '/', the Connection's well-known bus
	377	name can be derived from this object path by removing the first '/'
	378	and replacing subsequent '/' characters with '.'.</p>
375	379
376	380	<tp:rationale>
377	381	Object paths aren't nullable, so we can't use an empty string.

464	468	result of <tp:dbus-ref
465	469	namespace="org.freedesktop.Telepathy.Connection">GetSelfHandle</tp:dbus-ref>
466	470	for an active connection).</p>
467
	471
468	472	<p>It is unspecified whether this user ID is globally unique.</p>
469	473
470	474	<tp:rationale>

-4

spec/Channel.xml less more

219	219	<method name="GetChannelType" tp:name-for-bindings="Get_Channel_Type">
220	220	<tp:deprecated version="0.17.7">Use the ChannelType
221	221	property if possible.</tp:deprecated>
222		<arg direction="out" type="s" tp:type="DBus_Interface">
	222	<arg direction="out" type="s" tp:type="DBus_Interface"
	223	name="Channel_Type">
223	224	<tp:docstring>The interface name</tp:docstring>
224	225	</arg>
225	226	<tp:docstring>

237	238	<method name="GetHandle" tp:name-for-bindings="Get_Handle">
238	239	<tp:deprecated version="0.17.7">Use the TargetHandleType
239	240	and TargetHandle properties if possible.</tp:deprecated>
240		<arg direction="out" type="u" tp:type="Handle_Type">
	241	<arg direction="out" type="u" tp:type="Handle_Type"
	242	name="Target_Handle_Type">
241	243	<tp:docstring>
242	244	The same as TargetHandleType.
243	245	</tp:docstring>
244	246	</arg>
245		<arg direction="out" type="u" tp:type="Handle">
	247	<arg direction="out" type="u" tp:type="Handle" name="Target_Handle">
246	248	<tp:docstring>
247	249	The same as TargetHandle.
248	250	</tp:docstring>

265	267	<method name="GetInterfaces" tp:name-for-bindings="Get_Interfaces">
266	268	<tp:deprecated version="0.17.7">Use the Interfaces
267	269	property if possible.</tp:deprecated>
268		<arg direction="out" type="as" tp:type="DBus_Interface[]">
	270	<arg direction="out" type="as" tp:type="DBus_Interface[]"
	271	name="Interfaces">
269	272	<tp:docstring>
270	273	An array of the D-Bus interface names
271	274	</tp:docstring>

-2

spec/Channel_Dispatcher.xml less more

159	159	</tp:docstring>
160	160	</arg>
161	161
162		<arg direction="in" name="User_Action_Time" type="t"
	162	<arg direction="in" name="User_Action_Time" type="x"
163	163	tp:type="Unix_Timestamp64">
164	164	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
165	165	<p>The time at which user action occurred, or 0 if this channel

279	279	</tp:docstring>
280	280	</arg>
281	281
282		<arg direction="in" name="User_Action_Time" type="t"
	282	<arg direction="in" name="User_Action_Time" type="x"
283	283	tp:type="Unix_Timestamp64">
284	284	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
285	285	<p>The time at which user action occurred, or 0 if this channel

+19

-10

spec/Channel_Interface_Group.xml less more

90	90	this method and GetLocalPendingMembersWithInfo if necessary.
91	91	</tp:deprecated>
92	92
93		<arg direction="out" type="au" tp:type="Contact_Handle[]">
	93	<arg direction="out" type="au" tp:type="Contact_Handle[]"
	94	name="Members">
94	95	<tp:docstring>
95	96	array of handles of current members
96	97	</tp:docstring>
97	98	</arg>
98		<arg direction="out" type="au" tp:type="Contact_Handle[]">
	99	<arg direction="out" type="au" tp:type="Contact_Handle[]"
	100	name="Local_Pending">
99	101	<tp:docstring>
100	102	array of handles of local pending members
101	103	</tp:docstring>
102	104	</arg>
103		<arg direction="out" type="au" tp:type="Contact_Handle[]">
	105	<arg direction="out" type="au" tp:type="Contact_Handle[]"
	106	name="Remote_Pending">
104	107	<tp:docstring>
105	108	array of handles of remote pending members
106	109	</tp:docstring>

253	256	</property>
254	257
255	258	<method name="GetGroupFlags" tp:name-for-bindings="Get_Group_Flags">
256		<arg direction="out" type="u" tp:type="Channel_Group_Flags">
	259	<arg direction="out" type="u" tp:type="Channel_Group_Flags"
	260	name="Group_Flags">
257	261	<tp:docstring>
258	262	The value of the GroupFlags property
259	263	</tp:docstring>

339	343	A list of integer handles representing members of the channel
340	344	</tp:docstring>
341	345	</arg>
342		<arg direction="out" type="au" tp:type="Contact_Handle[]">
	346	<arg direction="out" type="au" tp:type="Contact_Handle[]" name="Owners">
343	347	<tp:docstring>
344	348	An array of integer handles representing the owner handles of
345	349	the given room members, in the same order, or 0 if the

378	382
379	383	<method name="GetLocalPendingMembers"
380	384	tp:name-for-bindings="Get_Local_Pending_Members">
381		<arg direction="out" type="au" tp:type="Contact_Handle[]"/>
	385	<arg direction="out" type="au" tp:type="Contact_Handle[]"
	386	name="Handles"/>
382	387	<tp:docstring>
383	388	Returns the To_Be_Added handle (only) for each structure in the
384	389	<tp:member-ref>LocalPendingMembers</tp:member-ref> property.

399	404	</tp:docstring>
400	405	<tp:deprecated version="0.17.6">Use the LocalPendingMembers
401	406	property, if Channel_Group_Flag_Properties is present.</tp:deprecated>
402		<arg direction="out" type="a(uuus)" tp:type="Local_Pending_Info[]">
	407	<arg direction="out" type="a(uuus)" tp:type="Local_Pending_Info[]"
	408	name="Info">
403	409	<tp:docstring>
404	410	An array of structs containing:
405	411	<ul>

451	457	</property>
452	458
453	459	<method name="GetMembers" tp:name-for-bindings="Get_Members">
454		<arg direction="out" type="au" tp:type="Contact_Handle[]"/>
	460	<arg direction="out" type="au" tp:type="Contact_Handle[]"
	461	name="Handles"/>
455	462	<tp:docstring>
456	463	Returns the <tp:member-ref>Members</tp:member-ref> property.
457	464	</tp:docstring>

475	482
476	483	<method name="GetRemotePendingMembers"
477	484	tp:name-for-bindings="Get_Remote_Pending_Members">
478		<arg direction="out" type="au" tp:type="Contact_Handle[]"/>
	485	<arg direction="out" type="au" tp:type="Contact_Handle[]"
	486	name="Handles"/>
479	487	<tp:docstring>
480	488	Returns an array of handles representing contacts who have been
481	489	invited to the channel and are awaiting remote approval.

523	531	</property>
524	532
525	533	<method name="GetSelfHandle" tp:name-for-bindings="Get_Self_Handle">
526		<arg direction="out" type="u" tp:type="Contact_Handle"/>
	534	<arg direction="out" type="u" tp:type="Contact_Handle"
	535	name="Self_Handle"/>
527	536	<tp:docstring>
528	537	Returns the value of the <tp:member-ref>SelfHandle</tp:member-ref>
529	538	property.

-1

spec/Channel_Interface_Media_Signalling.xml less more

40	40
41	41	<method name="GetSessionHandlers"
42	42	tp:name-for-bindings="Get_Session_Handlers">
43		<arg direction="out" type="a(os)" tp:type="Media_Session_Handler_Info[]"/>
	43	<arg direction="out" type="a(os)" tp:type="Media_Session_Handler_Info[]"
	44	name="Session_Handlers"/>
44	45	<tp:docstring>
45	46	Returns all currently active session handlers on this channel
46	47	as a list of (session_handler_path, type).

-3

spec/Channel_Interface_Messages.xml less more

251	251	the mid: and cid: URI schemes. If omitted, there is no suitable
252	252	token.</dd>
253	253
254		<dt>message-sent (t - <tp:type>Unix_Timestamp64</tp:type>)</dt>
	254	<dt>message-sent (x - <tp:type>Unix_Timestamp64</tp:type>)</dt>
255	255	<dd>The time the message was sent (if unavailable, the time
256	256	it arrived at a central server MAY be used). Omitted if no
257	257	reasonable approximation is available; SHOULD always be present
258	258	on outgoing messages.</dd>
259	259
260		<dt>message-received (t - <tp:type>Unix_Timestamp64</tp:type>)</dt>
	260	<dt>message-received (x - <tp:type>Unix_Timestamp64</tp:type>)</dt>
261	261	<dd>The time the message was received locally. SHOULD always
262	262	be present.</dd>
263	263

796	796	</tp:docstring>
797	797	</arg>
798	798
799		<arg direction="out" type="s" tp:type="Sent_Message_Token">
	799	<arg direction="out" type="s" tp:type="Sent_Message_Token"
	800	name="Token">
800	801	<tp:docstring>
801	802	An opaque token used to match any incoming delivery or failure
802	803	reports against this message, or an empty string if the message

-2

spec/Channel_Interface_Password.xml less more

30	30	</tp:flag>
31	31	</tp:flags>
32	32	<method name="GetPasswordFlags" tp:name-for-bindings="Get_Password_Flags">
33		<arg direction="out" type="u" tp:type="Channel_Password_Flags">
	33	<arg direction="out" type="u" tp:type="Channel_Password_Flags"
	34	name="Password_Flags">
34	35	<tp:docstring>
35	36	An integer with the logical OR of all the flags set
36	37	(values of ChannelPasswordFlags)

70	71	The password
71	72	</tp:docstring>
72	73	</arg>
73		<arg direction="out" type="b">
	74	<arg direction="out" type="b" name="Correct">
74	75	A boolean indicating whether or not the password was correct
75	76	</arg>
76	77	<tp:docstring>

-2

spec/Channel_Interface_Tube.xml less more

57	57	SRV (RFC 2782) Service Types
58	58	http://www.dns-sd.org/ServiceTypes.html</a>):
59	59	<code>{'u': 'username', 'p': 'password', 'path': 'path'}</code></p>
60		<p>When requesting a channel with
	60	<p>When requesting a channel with
61	61	<tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.Interface.Requests.CreateChannel</tp:dbus-ref>,
62	62	this property MAY be included in the request. If it is not included in
63	63	the request, the connection manager MUST consider the property to be

71	71	tp:name-for-bindings="Status">
72	72	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
73	73	<p>Status of the tube in this channel.</p>
74		<p>When requesting a channel with
	74	<p>When requesting a channel with
75	75	<tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.Interface.Requests.CreateChannel</tp:dbus-ref>,
76	76	this property MUST NOT be included in the request.</p>
77	77	</tp:docstring>

-1

spec/Channel_Request.xml less more

48	48	</property>
49	49
50	50	<property name="UserActionTime" tp:name-for-bindings="User_Action_Time"
51		type="t" tp:type="Unix_Timestamp64" access="read">
	51	type="x" tp:type="Unix_Timestamp64" access="read">
52	52	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
53	53	<p>The time at which user action occurred, or 0 if this channel
54	54	request is for some reason not involving user action.</p>

-2

spec/Channel_Type_Contact_Search.xml less more

20	20	<interface name="org.freedesktop.Telepathy.Channel.Type.ContactSearch"
21	21	tp:causes-havoc='not well-tested'>
22	22	<tp:requires interface="org.freedesktop.Telepathy.Channel"/>
23
	23
24	24	<tp:struct name="Search_Key_Info">
25	25	<tp:docstring>A struct representing details on search strings.</tp:docstring>
26	26	<tp:member type="b" name="Is_Mandatory">

48	48	</arg>
49	49	<arg direction="out" type="a{s(bg)}" tp:type="Search_Key_Info_Map">
50	50	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
51		A dictionary mapping string search key names to its search details.
	51	A dictionary mapping string search key names to its search details.
52	52	</tp:docstring>
53	53	</arg>
54	54	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">

+37

-65

spec/Channel_Type_DBus_Tube.xml less more

57	57	<tp:docstring>
58	58	Offers a D-Bus tube providing the service specified.
59	59	</tp:docstring>
	60	<arg direction="out" name="address" type="s">
	61	<tp:docstring>
	62	The string describing the address of the private bus. The client
	63	SHOULD not attempt to connect to the address until the tube is open.
	64	</tp:docstring>
	65	</arg>
60	66	<tp:possible-errors>
61	67	<tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>
62	68	<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
63	69	<tp:docstring>
64	70	The contact associated with this channel doesn't have tubes
65	71	capabilities.
66		</tp:docstring>
67		</tp:error>
68		<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
69		<tp:docstring>
70		The connection manager doesn't support D-Bus tubes.
71	72	</tp:docstring>
72	73	</tp:error>
73	74	</tp:possible-errors>

86	87	SHOULD not attempt to connect to the address until the tube is open.
87	88	</tp:docstring>
88	89	</arg>
89		<tp:possible-errors>
90		<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
91		<tp:docstring>
92		The given tube ID is invalid or does not refer to a D-Bus
93		tube.
94		</tp:docstring>
95		</tp:error>
96		</tp:possible-errors>
97		</method>
98
99		<method name="GetDBusTubeAddress"
100		tp:name-for-bindings="Get_DBus_Tube_Address">
101		<tp:docstring>
102		Return a string describing the address of the private bus.
103		</tp:docstring>
104		<arg direction="out" type="s">
105		<tp:docstring>
106		The bus address.
107		</tp:docstring>
108		</arg>
109		<tp:possible-errors>
110		<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
111		<tp:docstring>
112		The tube is not a D-Bus tube.
113		</tp:docstring>
114		</tp:error>
115		<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
116		<tp:docstring>
117		This tube is not in the "open" state.
118		</tp:docstring>
119		</tp:error>
120		</tp:possible-errors>
121		</method>
122
123		<method name="GetDBusNames" tp:name-for-bindings="Get_DBus_Names">
124		<tp:docstring>
125		For a multi-user (i.e. Handle_Type_Room) D-Bus tube, obtain a mapping
126		between contact handles and their unique bus names on this tube.
127		</tp:docstring>
128		<arg direction="out" type="a(us)" tp:type="DBus_Tube_Member[]">
129		<tp:docstring>
130		An array of structures, each containing a contact handle and a D-Bus
131		bus name.
132		</tp:docstring>
133		</arg>
134		<tp:possible-errors>
135		<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
136		<tp:docstring>
137		The tube is not a multi-user D-Bus tube.
138		</tp:docstring>
139		</tp:error>
140		<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
141		<tp:docstring>
142		This tube is not in the "open" state.
143		</tp:docstring>
144		</tp:error>
145		</tp:possible-errors>
146	90	</method>
147	91
148	92	<signal name="DBusNamesChanged" tp:name-for-bindings="DBus_Names_Changed">
149	93	<tp:docstring>
150	94	Emitted on a multi-user (i.e. Handle_Type_Room) D-Bus tube when a
151		participant opens or closes the tube.
	95	participant opens or closes the tube. This provides change
	96	notification for the <tp:member-ref>DBusNames</tp:member-ref> property.
152	97	</tp:docstring>
153		<arg name="added" type="a(us)" tp:type="DBus_Tube_Member[]">
	98	<arg name="added" type="a{us}" tp:type="DBus_Tube_Participants">
154	99	<tp:docstring>
155	100	Array of handles and D-Bus names of new participants.
156	101	</tp:docstring>

170	115	com.example.ServiceName.</p>
171	116	<p>When the tube is offered, the service name is transmitted to the
172	117	other end.</p>
173		<p>When requesting a channel with
	118	<p>When requesting a channel with
174	119	<tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.Interface.Requests.CreateChannel</tp:dbus-ref>,
175	120	this property MUST be included in the request.</p>
176	121	</tp:docstring>
177	122	</property>
178	123
	124	<property name="DBusNames" tp:name-for-bindings="DBus_Names"
	125	access="read" type="a{us}" tp:type="DBus_Tube_Participants">
	126	<tp:docstring>
	127	For a multi-user (i.e. Handle_Type_Room) D-Bus tube, a mapping
	128	between contact handles and their unique bus names on this tube.
	129	For a peer-to-peer (i.e. Handle_Type_Contact) D-Bus tube, the empty
	130	list. Change notification is via
	131	<tp:member-ref>DBusNamesChanged</tp:member-ref>.
	132	</tp:docstring>
	133	</property>
	134
	135	<tp:mapping name="DBus_Tube_Participants">
	136	<tp:docstring>Represents the participants in a multi-user D-Bus tube, as
	137	used by the <tp:member-ref>DBusNames</tp:member-ref> property and the
	138	<tp:member-ref>DBusNamesChanged</tp:member-ref> signal.</tp:docstring>
	139	<tp:member type="u" tp:type="Contact_Handle" name="Handle">
	140	<tp:docstring>
	141	The handle of a participant in this D-Bus tube.
	142	</tp:docstring>
	143	</tp:member>
	144	<tp:member type="s" tp:type="DBus_Unique_Name" name="Unique_Name">
	145	<tp:docstring>
	146	That participant's unique name.
	147	</tp:docstring>
	148	</tp:member>
	149	</tp:mapping>
	150
179	151	</interface>
180	152
181	153	</node>

-3

spec/Channel_Type_File_Transfer.xml less more

17	17	License along with this library; if not, write to the Free Software
18	18	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
19	19	</tp:license>
20		<interface name="org.freedesktop.Telepathy.Channel.Type.FileTransfer.DRAFT"
21		tp:causes-havoc="experimental">
	20	<interface name="org.freedesktop.Telepathy.Channel.Type.FileTransfer">
22	21	<tp:requires interface="org.freedesktop.Telepathy.Channel"/>
	22	<tp:added version="0.17.UNRELEASED">(as stable API)</tp:added>
23	23	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
24	24	<p>A channel type for transferring files. The
25	25	transmission of data between contacts is achieved by reading from

177	177	</tp:docstring>
178	178	</property>
179	179
180		<property name="Date" type="t" access="read"
	180	<property name="Date" type="x" access="read"
181	181	tp:type="Unix_Timestamp64" tp:name-for-bindings="Date">
182	182	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
183	183	<p>The last modification time of the file being transferred. This

-1

spec/Channel_Type_Room_List.xml less more

39	39	</property>
40	40
41	41	<method name="GetListingRooms" tp:name-for-bindings="Get_Listing_Rooms">
42		<arg direction="out" type="b">
	42	<arg direction="out" type="b" name="In_Progress">
43	43	<tp:docstring>
44	44	A boolean indicating if room listing is in progress
45	45	</tp:docstring>

-2

spec/Channel_Type_Stream_Tube.xml less more

153	153	"rsync" or "daap".</p>
154	154	<p>When the tube is offered, the service name is transmitted to the
155	155	other end.</p>
156		<p>When requesting a channel with
	156	<p>When requesting a channel with
157	157	<tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.Interface.Requests.CreateChannel</tp:dbus-ref>,
158	158	this property MUST be included in the request.</p>
159	159	</tp:docstring>

184	184	<p>Connection Managers MUST support at least IPv4 with the localhost
185	185	access control.</p>
186	186
187		<p>When requesting a channel with
	187	<p>When requesting a channel with
188	188	<tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.Interface.Requests.CreateChannel</tp:dbus-ref>,
189	189	this property MUST NOT be included in the request.</p>
190	190

-2

spec/Channel_Type_Streamed_Media.xml less more

88	88	<tp:simple-type name="Stream_ID" type="u"/>
89	89
90	90	<method name="ListStreams" tp:name-for-bindings="List_Streams">
91		<arg direction="out" type="a(uuuuuu)" tp:type="Media_Stream_Info[]">
	91	<arg direction="out" type="a(uuuuuu)" tp:type="Media_Stream_Info[]"
	92	name="Streams">
92	93	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
93	94	An array of structs containing:
94	95	<ul>

179	180	An array of stream types (values of MediaStreamType)
180	181	</tp:docstring>
181	182	</arg>
182		<arg direction="out" type="a(uuuuuu)" tp:type="Media_Stream_Info[]">
	183	<arg direction="out" type="a(uuuuuu)" tp:type="Media_Stream_Info[]"
	184	name="Streams">
183	185	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
184	186	An array of structs (in the same order as the given stream types)
185	187	containing:

-2

spec/Channel_Type_Text.xml less more

66	66	</method>
67	67
68	68	<method name="GetMessageTypes" tp:name-for-bindings="Get_Message_Types">
69		<arg direction="out" type="au" tp:type="Channel_Text_Message_Type[]">
	69	<arg direction="out" type="au" tp:type="Channel_Text_Message_Type[]"
	70	name="Available_Types">
70	71	<tp:docstring>
71	72	An array of integer message types (ChannelTextMessageType)
72	73	</tp:docstring>

91	92	acknowledge messages after they have actually stored them, which is
92	93	impossible if this flag is true.</tp:deprecated>
93	94	</arg>
94		<arg direction="out" type="a(uuuuus)" tp:type="Pending_Text_Message[]">
	95	<arg direction="out" type="a(uuuuus)" tp:type="Pending_Text_Message[]"
	96	name="Pending_Messages">
95	97	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
96	98	An array of structs representing the pending queue. Each contains:
97	99	<ul>

+44

-17

spec/Channel_Type_Tubes.xml less more

55	55	</tp:struct>
56	56
57	57	<tp:struct name="DBus_Tube_Member" array-name="DBus_Tube_Member_List">
58		<tp:docstring>A struct (handle, unique name) representing a participant
59		in a D-Bus tube, as returned by GetDBusNames on the Tubes channel
60		type, and as seen in the DBusNamesChanged signal.</tp:docstring>
61		<tp:member type="u" tp:type="Contact_Handle" name="Handle"/>
62		<tp:member type="s" tp:type="DBus_Unique_Name" name="Unique_Name"/>
	58	<tp:docstring>Represents a participant in a multi-user D-Bus tube, as
	59	returned by <tp:member-ref>GetDBusNames</tp:member-ref> and seen in the
	60	<tp:member-ref>DBusNamesChanged</tp:member-ref> signal.</tp:docstring>
	61	<tp:member type="u" tp:type="Contact_Handle" name="Handle">
	62	<tp:docstring>
	63	The handle of a participant in this D-Bus tube.
	64	</tp:docstring>
	65	</tp:member>
	66	<tp:member type="s" tp:type="DBus_Unique_Name" name="Unique_Name">
	67	<tp:docstring>
	68	That participant's unique name.
	69	</tp:docstring>
	70	</tp:member>
63	71	</tp:struct>
64	72
65	73	<tp:struct name="Socket_Address_IPv4">

243	251	tp:name-for-bindings="Get_Available_Stream_Tube_Types">
244	252	<tp:docstring>List the available address types and access-control types
245	253	for stream tubes.</tp:docstring>
246		<arg direction="out" type="a{uau}" tp:type="Supported_Socket_Map">
	254	<arg direction="out" type="a{uau}" tp:type="Supported_Socket_Map"
	255	name="Available_Stream_Tube_Types">
247	256	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
248	257	<p>A mapping from address types (members of Socket_Address_Type) to
249	258	arrays of access-control type (members of Socket_Access_Control)

271	280
272	281	<method name="GetAvailableTubeTypes"
273	282	tp:name-for-bindings="Get_Available_Tube_Types">
274		<arg direction="out" type="au" tp:type="Tube_Type[]">
	283	<arg direction="out" type="au" tp:type="Tube_Type[]"
	284	name="Available_Tube_Types">
275	285	<tp:docstring>
276	286	An array of the available tube types, as defined by the Tube_Type
277	287	enum.

280	290	</method>
281	291
282	292	<method name="ListTubes" tp:name-for-bindings="List_Tubes">
283		<arg direction="out" type="a(uuusa{sv}u)" tp:type="Tube_Info[]">
	293	<arg direction="out" type="a(uuusa{sv}u)" tp:type="Tube_Info[]"
	294	name="Tubes">
284	295	<tp:docstring>
285	296	Return an array of tuples, each representing a tube, with the
286	297	following members:

297	308	</arg>
298	309	</method>
299	310
300		<method name="OfferDBusTube" tp:name-for-bindings="Offer_DBus_Tube">
	311	<!-- this tp:name-for-bindings is ugly, but compatible with
	312	the code generation in telepathy-glib versions that did not use
	313	tp:name-for-bindings -->
	314	<method name="OfferDBusTube" tp:name-for-bindings="Offer_D_Bus_Tube">
301	315	<tp:docstring>
302	316	Offers a D-Bus tube providing the service specified.
303	317	</tp:docstring>

318	332	D-Bus type, or a byte array 'ay'.
319	333	</tp:docstring>
320	334	</arg>
321		<arg direction="out" type="u" tp:type="Tube_ID">
	335	<arg direction="out" type="u" tp:type="Tube_ID" name="Tube_ID">
322	336	<tp:docstring>
323	337	The ID of the new tube.
324	338	</tp:docstring>

391	405	specified in the documentation for the Socket_Access_Control enum.
392	406	</tp:docstring>
393	407	</arg>
394		<arg direction="out" type="u" tp:type="Tube_ID">
	408	<arg direction="out" type="u" tp:type="Tube_ID" name="Tube_ID">
395	409	<tp:docstring>
396	410	The ID of the new tube.
397	411	</tp:docstring>

449	463	</arg>
450	464	</signal>
451	465
452		<method name="AcceptDBusTube" tp:name-for-bindings="Accept_DBus_Tube">
	466	<!-- this tp:name-for-bindings is ugly, but compatible with
	467	the code generation in telepathy-glib versions that did not use
	468	tp:name-for-bindings -->
	469	<method name="AcceptDBusTube" tp:name-for-bindings="Accept_D_Bus_Tube">
453	470	<tp:docstring>
454	471	Accept a D-Bus tube that's in the "local pending" state. The
455	472	connection manager will attempt to open the tube. The tube remains in

571	588	</arg>
572	589	</signal>
573	590
	591	<!-- this tp:name-for-bindings is ugly, but compatible with
	592	the code generation in telepathy-glib versions that did not use
	593	tp:name-for-bindings -->
574	594	<method name="GetDBusTubeAddress"
575		tp:name-for-bindings="Get_DBus_Tube_Address">
	595	tp:name-for-bindings="Get_D_Bus_Tube_Address">
576	596	<tp:docstring>
577	597	For a D-Bus tube, return a string describing the address of the
578	598	private bus.

582	602	The ID of the tube to get an address for.
583	603	</tp:docstring>
584	604	</arg>
585		<arg direction="out" type="s">
	605	<arg direction="out" type="s" name="Address">
586	606	<tp:docstring>
587	607	The bus address.
588	608	</tp:docstring>

601	621	</tp:possible-errors>
602	622	</method>
603	623
604		<method name="GetDBusNames" tp:name-for-bindings="Get_DBus_Names">
	624	<!-- this tp:name-for-bindings is ugly, but compatible with
	625	the code generation in telepathy-glib versions that did not use
	626	tp:name-for-bindings -->
	627	<method name="GetDBusNames" tp:name-for-bindings="Get_D_Bus_Names">
605	628	<tp:docstring>
606	629	For a multi-user (i.e. Handle_Type_Room) D-Bus tube, obtain a mapping
607	630	between contact handles and their unique bus names on this tube.

611	634	The ID of the tube to get names for.
612	635	</tp:docstring>
613	636	</arg>
614		<arg direction="out" type="a(us)" tp:type="DBus_Tube_Member[]">
	637	<arg direction="out" type="a(us)" tp:type="DBus_Tube_Member[]"
	638	name="DBus_Names">
615	639	<tp:docstring>
616	640	An array of structures, each containing a contact handle and a D-Bus
617	641	bus name.

631	655	</tp:possible-errors>
632	656	</method>
633	657
634		<signal name="DBusNamesChanged" tp:name-for-bindings="DBus_Names_Changed">
	658	<!-- this tp:name-for-bindings is ugly, but compatible with
	659	the code generation in telepathy-glib versions that did not use
	660	tp:name-for-bindings -->
	661	<signal name="DBusNamesChanged" tp:name-for-bindings="D_Bus_Names_Changed">
635	662	<tp:docstring>
636	663	Emitted on a multi-user (i.e. Handle_Type_Room) D-Bus tube when a
637	664	participant opens or closes the tube.

+29

-18

spec/Connection.xml less more

66	66	</method>
67	67
68	68	<method name="GetInterfaces" tp:name-for-bindings="Get_Interfaces">
69		<arg direction="out" type="as" tp:type="DBus_Interface[]">
	69	<arg direction="out" type="as" tp:type="DBus_Interface[]"
	70	name="Interfaces">
70	71	<tp:docstring>
71	72	An array of D-Bus interface names
72	73	</tp:docstring>

109	110	</method>
110	111
111	112	<method name="GetProtocol" tp:name-for-bindings="Get_Protocol">
112		<arg direction="out" type="s" tp:type="Protocol">
	113	<arg direction="out" type="s" tp:type="Protocol" name="Protocol">
113	114	<tp:docstring>
114	115	A string identifier for the protocol
115	116	</tp:docstring>

156	157	</property>
157	158
158	159	<method name="GetSelfHandle" tp:name-for-bindings="Get_Self_Handle">
159		<arg direction="out" type="u" tp:type="Contact_Handle">
	160	<arg direction="out" type="u" tp:type="Contact_Handle"
	161	name="Self_Handle">
160	162	<tp:docstring>
161	163	The value of the <tp:member-ref>SelfHandle</tp:member-ref> property
162	164	</tp:docstring>

176	178	</method>
177	179
178	180	<method name="GetStatus" tp:name-for-bindings="Get_Status">
179		<arg direction="out" type="u" tp:type="Connection_Status">
	181	<arg direction="out" type="u" tp:type="Connection_Status"
	182	name="Status">
180	183	<tp:docstring>
181	184	An integer representing the current status
182	185	</tp:docstring>

245	248	</tp:docstring>
246	249	</arg>
247	250
248		<arg direction="out" type="as">
	251	<arg direction="out" type="as" name="Identifiers">
249	252	<tp:docstring>
250	253	An array of handle names in the same order as the given numbers
251	254	</tp:docstring>

268	271	</method>
269	272
270	273	<method name="ListChannels" tp:name-for-bindings="List_Channels">
271		<arg direction="out" type="a(osuu)" tp:type="Channel_Info[]">
	274	<arg direction="out" type="a(osuu)" tp:type="Channel_Info[]"
	275	name="Channel_Info">
272	276	<tp:docstring>
273	277	An array of structs representing channels.
274	278	</tp:docstring>

428	432	</tp:docstring>
429	433	</arg>
430	434
431		<arg direction="out" type="o">
	435	<arg direction="out" type="o" name="Object_Path">
432	436	<tp:docstring>
433	437	The D-Bus object path for the channel created or retrieved
434	438	</tp:docstring>

561	565	</tp:docstring>
562	566	</arg>
563	567
564		<arg direction="out" type="au" tp:type="Handle[]">
	568	<arg direction="out" type="au" tp:type="Handle[]"
	569	name="Handles">
565	570	<tp:docstring>
566	571	An array of integer handle numbers in the same order as the given strings
567	572	</tp:docstring>

581	586
582	587	<tp:possible-errors>
583	588	<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
584		<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
	589	<tp:error name="org.freedesktop.Telepathy.Error.InvalidHandle">
585	590	<tp:docstring>
586		The handle type is invalid
587		</tp:docstring>
588		</tp:error>
589		<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
590		<tp:docstring>
591		The given name is not a valid entity of the given type
	591	The given name does not identify a valid entity of the given type.
	592
	593	<tp:rationale>
	594	For instance, an XMPP connection would raise this error for
	595	identifiers with type Handle_Type_Room that do not contain
	596	exactly one '@' character, that contain spaces, and so on.
	597	</tp:rationale>
592	598	</tp:docstring>
593	599	</tp:error>
594	600	<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
595	601	<tp:docstring>
596		The given handle type is valid, but not implemented on this
597		connection. For instance, a CM for a protocol that doesn't have
598		chat rooms would not implement room handles.
	602	The given handle type is not valid, or is not implemented on this
	603	connection.
	604
	605	<tp:rationale>
	606	For instance, a connection to a protocol that doesn't have
	607	chat rooms would raise this error for room handles, and all CMs
	608	would raise this error for Handle_Type_None.
	609	</tp:rationale>
599	610	</tp:docstring>
600	611	</tp:error>
601	612	</tp:possible-errors>

-3

spec/Connection_Interface_Aliasing.xml less more

70	70	</tp:flag>
71	71	</tp:flags>
72	72	<method name="GetAliasFlags" tp:name-for-bindings="Get_Alias_Flags">
73		<arg direction="out" type="u" tp:type="Connection_Alias_Flags">
	73	<arg direction="out" type="u" tp:type="Connection_Alias_Flags"
	74	name="Alias_Flags">
74	75	<tp:docstring>
75	76	An integer with a bitwise OR of flags from ConnectionAliasFlags
76	77	</tp:docstring>

89	90	An array of handles representing contacts
90	91	</tp:docstring>
91	92	</arg>
92		<arg direction="out" type="as">
	93	<arg direction="out" type="as" name="Aliases">
93	94	<tp:docstring>
94	95	A list of aliases in the same order as the contact handles
95	96	</tp:docstring>

110	111	An array of handles representing contacts
111	112	</tp:docstring>
112	113	</arg>
113		<arg direction="out" type="a{us}" tp:type="Alias_Map">
	114	<arg direction="out" type="a{us}" tp:type="Alias_Map" name="Aliases">
114	115	<tp:docstring>
115	116	A dictionary mapping contact handles to aliases
116	117	</tp:docstring>

-8

spec/Connection_Interface_Avatars.xml less more

125	125
126	126	<method name="GetAvatarRequirements"
127	127	tp:name-for-bindings="Get_Avatar_Requirements">
128		<arg direction="out" type="as">
	128	<arg direction="out" type="as" name="MIME_Types">
129	129	<tp:docstring>
130	130	An array of supported MIME types (eg image/jpeg)
131	131	</tp:docstring>
132	132	</arg>
133		<arg direction="out" type="q">
	133	<arg direction="out" type="q" name="Min_Width">
134	134	<tp:docstring>
135	135	The minimum image width in pixels
136	136	</tp:docstring>
137	137	</arg>
138		<arg direction="out" type="q">
	138	<arg direction="out" type="q" name="Min_Height">
139	139	<tp:docstring>
140	140	The minimum image height in pixels
141	141	</tp:docstring>
142	142	</arg>
143		<arg direction="out" type="q">
	143	<arg direction="out" type="q" name="Max_Width">
144	144	<tp:docstring>
145	145	The maximum image width in pixels, or 0 if there is no limit
146	146	</tp:docstring>
147	147	</arg>
148		<arg direction="out" type="q">
	148	<arg direction="out" type="q" name="Max_Height">
149	149	<tp:docstring>
150	150	The maximum image height in pixels, or 0 if there is no limit
151	151	</tp:docstring>
152	152	</arg>
153		<arg direction="out" type="u">
	153	<arg direction="out" type="u" name="Max_Bytes">
154	154	<tp:docstring>
155	155	The maximum image size in bytes, or 0 if there is no limit
156	156	</tp:docstring>

232	232	An integer handle for the contact to request the avatar for
233	233	</tp:docstring>
234	234	</arg>
235		<arg direction="out" type="ay">
	235	<arg direction="out" type="ay" name="Data">
236	236	<tp:docstring>
237	237	An array of bytes containing the image data
238	238	</tp:docstring>
239	239	</arg>
240		<arg direction="out" type="s">
	240	<arg direction="out" type="s" name="MIME_Type">
241	241	<tp:docstring>
242	242	A string containing the image MIME type (eg image/jpeg), or empty if
243	243	unknown

-2

spec/Connection_Interface_Capabilities.xml less more

129	129	An array of D-Bus interface names of channel types to remove
130	130	</tp:docstring>
131	131	</arg>
132		<arg direction="out" type="a(su)" tp:type="Capability_Pair[]">
	132	<arg direction="out" type="a(su)" tp:type="Capability_Pair[]"
	133	name="Self_Capabilities">
133	134	<tp:docstring>
134	135	An array of structures describing the current capabilities containing:
135	136	<ul>

202	203	list.</p>
203	204	</tp:docstring>
204	205	</arg>
205		<arg direction="out" type="a(usuu)" tp:type="Contact_Capability[]">
	206	<arg direction="out" type="a(usuu)" tp:type="Contact_Capability[]"
	207	name="Contact_Capabilities">
206	208	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
207	209	An array of structures containing:
208	210	<ul>

-3

spec/Connection_Interface_Contact_Capabilities.xml less more

17	17	License along with this library; if not, write to the Free Software
18	18	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
19	19	</tp:license>
20		<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.DRAFT">
	20	<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.DRAFT"
	21	tp:causes-havoc="experimental">
21	22	<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
22	23	<tp:added version="0.17.16">(as a draft)</tp:added>
23	24

99	100	Now there is a fix, so we don't use the workaround anymore.
100	101	-->
101	102	<arg direction="out" type="a{ua(a{sv}as)}"
102		tp:type="Contact_Capabilities_Map">
	103	tp:type="Contact_Capabilities_Map" name="Contact_Capabilities">
103	104	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
104	105	An array of structures containing:
105	106	<ul>

138	139	<p>The underlying protocol can get several contacts' capabilities at
139	140	the same time.</p>
140	141	</tp:rationale>
141
	142
142	143	</tp:docstring>
143	144	</signal>
144	145

+337

-45

spec/Connection_Interface_Contact_Info.xml less more

0	0	<?xml version="1.0" ?>
1	1	<node name="/Connection_Interface_Contact_Info" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
2		<tp:copyright> Copyright (C) 2005, 2006 Collabora Limited </tp:copyright>
3		<tp:copyright> Copyright (C) 2005, 2006 Nokia Corporation </tp:copyright>
4		<tp:copyright> Copyright (C) 2006 INdT </tp:copyright>
	2	<tp:copyright> Copyright (C) 2008 Collabora Limited </tp:copyright>
	3	<tp:copyright> Copyright (C) 2008 Nokia Corporation </tp:copyright>
5	4	<tp:license xmlns="http://www.w3.org/1999/xhtml">
6	5	<p>This library is free software; you can redistribute it and/or
7	6	modify it under the terms of the GNU Lesser General Public

17	16	License along with this library; if not, write to the Free Software
18	17	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
19	18	</tp:license>
20		<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactInfo"
21		tp:causes-havoc='obsolete'>
	19	<interface name="org.freedesktop.Telepathy.Connection.Interface.ContactInfo.DRAFT"
	20	tp:causes-havoc="experimental">
	21	<tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
22	22	<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
23		<signal name="GotContactInfo" tp:name-for-bindings="Got_Contact_Info">
	23
	24	<tp:struct name="Contact_Info_Field" array-name="Contact_Info_Field_List">
	25	<tp:member type="s" name="Field_Name">
	26	<tp:docstring>
	27	The name of the field; this is the lowercased name of a vCard field.
	28	For example, a field representing a contact's address would be named
	29	"adr".
	30	</tp:docstring>
	31	</tp:member>
	32	<tp:member type="as" name="Parameters">
	33	<tp:docstring>
	34	A list of (lowercased) vCard type parameters applicable to this field.
	35	For example, a contact's preferred home address would have parameters
	36	'home' and 'pref'.
	37
	38	<tp:rationale>
	39	This is a list of strings rather than a bitwise OR of enum members
	40	because vCard type parameters are essentially arbitrary strings.
	41	</tp:rationale>
	42	</tp:docstring>
	43	</tp:member>
	44	<tp:member type="as" name="Field_Value">
	45	<tp:docstring>
	46	For unstructured vCard fields (such as 'fn', a formatted name
	47	field), a single-element array containing the field's value; for
	48	structured fields (such as 'adr', an address field), an array
	49	corresponding to the semicolon-separated elements of the field (with
	50	empty strings for empty elements). A vCard field with multiple
	51	comma-separated values should be represented by several
	52	<tp:type>Contact_Info_Field</tp:type>s. Characters which are
	53	required to be escaped in vCard values, such as semi-colons, should
	54	not be escaped in this list.
	55
	56	<tp:rationale>
	57	An earlier draft of this interface split structured vCard fields
	58	into multiple Telepathy-level fields; for example, 'n' became
	59	'family-name', 'given-name', etc. But under this representation,
	60	omitting empty components leads to difficulty identifying where one
	61	name ends and another begins. Consider the fields ['given-name',
	62	'honorific-suffixes', 'family-name', 'honorific-prefixes']: does
	63	this represent two 'n' fields, or one with incorrect component
	64	ordering?
	65	</tp:rationale>
	66	</tp:docstring>
	67	</tp:member>
	68	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	69	<p>Represents one piece of information about a contact, as modelled by
	70	a single vCard field. Of the fields defined in RFC 2426, common
	71	examples include:</p>
	72
	73	<dl>
	74	<dt>fn</dt>
	75	<dd>The contact's full name, formatted to their liking</dd>
	76
	77	<dt>n</dt>
	78	<dd>The contact's full name, divided into five parts: family name,
	79	given name, additional names, honorific prefixes, and honorific
	80	suffixes</dd>
	81
	82	<dt>org</dt>
	83	<dd>The contact's organisation, divided into the organization's name
	84	possibly followed by one or more organizational unit names.</dd>
	85
	86	<dt>adr</dt>
	87	<dd>A street address for the contact, divided into seven components:
	88	post office box, extended address, street address, locality (e.g.,
	89	city), region (e.g., state or province), the postal code, and the
	90	country name.</dd>
	91
	92	<dt>tel</dt>
	93	<dd>A telephone number for the contact.</dd>
	94
	95	<dt>email</dt>
	96	<dd>An email address for the contact.</dd>
	97	</dl>
	98
	99	<p>For example, the following vCard:</p>
	100
	101	<pre>
	102	BEGIN:vCard
	103	VERSION:3.0
	104	FN:Wee Ninja
	105	N:Ninja;Wee;;;-san
	106	ORG:Collabora, Ltd.;Human Resources\; Company Policy Enforcement
	107	ADR;TYPE=WORK,POSTAL,PARCEL:;;11 Kings Parade;Cambridge;Cambridgeshire
	108	;CB2 1SJ;UK
	109	TEL;TYPE=VOICE,WORK:+44 1223 362967, +44 7700 900753
	110	EMAIL;TYPE=INTERNET,PREF:wee.ninja@collabora.co.uk
	111	EMAIL;TYPE=INTERNET:wee.ninja@example.com
	112	URL:http://www.thinkgeek.com/geektoys/plush/8823/
	113	END:vCard</pre>
	114
	115	<p>would be represented by (in Python-like syntax):</p>
	116
	117	<pre>
	118	[
	119	('fn', [], ['Wee Ninja']),
	120	('n', [], ['Ninja', 'Wee', '', '', '-san']),
	121	('org', [], ['Collabora, Ltd.', 'Human Resources; Company Policy Enforcement']),
	122	('adr', ['work','postal','parcel'], ['','','11 Kings Parade','Cambridge',
	123	'Cambridgeshire','CB2 1SJ','UK']),
	124	('tel', ['voice','work'], ['+44 1223 362967']),
	125	('tel', ['voice','work'], ['+44 7700 900753']),
	126	('email', ['internet','pref'], ['wee.ninja@collabora.co.uk']),
	127	('email', ['internet'], ['wee.ninja@example.com']),
	128	('url', [], ['http://www.thinkgeek.com/geektoys/plush/8823/']),
	129	]</pre>
	130	</tp:docstring>
	131	</tp:struct>
	132
	133	<tp:mapping name="Contact_Info_Map" array-name="">
	134	<tp:docstring>A dictionary whose keys are contact handles and whose
	135	values are contact information..</tp:docstring>
	136	<tp:member type="u" tp:type="Contact_Handle" name="Handle"/>
	137	<tp:member type="a(sasas)" tp:type="Contact_Info_Field[]"
	138	name="Contact_Info"/>
	139	</tp:mapping>
	140
	141	<signal name="ContactInfoChanged" tp:name-for-bindings="ContactInfoChanged">
24	142	<arg name="Contact" type="u" tp:type="Contact_Handle">
25	143	<tp:docstring>
26		An integer handle of the contact ID on the server
27		</tp:docstring>
28		</arg>
29		<arg name="VCard" type="s">
30		<tp:docstring>
31		The XML string containing their vcard information
32		</tp:docstring>
33		</arg>
34		<tp:docstring>
35		Emitted when information has been received from the server with
36		the details of a particular contact.
	144	An integer handle for the contact whose info has changed.
	145	</tp:docstring>
	146	</arg>
	147	<arg name="ContactInfo" type="a(sasas)" tp:type="Contact_Info_Field[]">
	148	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	149	An array of fields representing information about this contact.
	150	</tp:docstring>
	151	</arg>
	152	<tp:docstring>
	153	Emitted when a contact's information has changed or been received for
	154	the first time on this connection.
37	155	</tp:docstring>
38	156	</signal>
	157
	158	<method name="GetContactInfo"
	159	tp:name-for-bindings="Get_Contact_Info">
	160	<arg direction="in" name="Contacts" type="au" tp:type="Contact_Handle[]">
	161	<tp:docstring>
	162	An array of handles representing contacts.
	163	</tp:docstring>
	164	</arg>
	165	<arg direction="out" name="ContactInfo" type="a{ua(sasas)}"
	166	tp:type="Contact_Info_Map">
	167	<tp:docstring>
	168	A dictionary mapping contact handles to information, whose keys are
	169	the subset of the requested list of handles for which information was
	170	cached.
	171	</tp:docstring>
	172	</arg>
	173	<tp:docstring>
	174	Request information on several contacts at once. This SHOULD only
	175	return cached information, omitting handles for which no information is
	176	cached from the returned map. For contacts without cached information,
	177	the information SHOULD be requested from the network, with the result
	178	signalled later by <tp:member-ref>ContactInfoChanged</tp:member-ref>.
	179	</tp:docstring>
	180	</method>
	181
39	182	<method name="RequestContactInfo"
40	183	tp:name-for-bindings="Request_Contact_Info">
41	184	<arg direction="in" name="Contact" type="u" tp:type="Contact_Handle">
42	185	<tp:docstring>
43		An integer handle for the contact to request info for
44		</tp:docstring>
45		</arg>
46		<tp:docstring>
47		Request information for a given contact. The function will return
48		after a GotContactInfo signal has been emitted for the contact, or
49		an error returned.
50		</tp:docstring>
	186	An integer handle for a contact.
	187	</tp:docstring>
	188	</arg>
	189	<arg direction="out" name="Contact_Info" type="a(sasas)"
	190	tp:type="Contact_Info_Field[]">
	191	<tp:docstring>
	192	Information about that contact.
	193	</tp:docstring>
	194	</arg>
	195	<tp:docstring>
	196	Retrieve information for a contact, requesting it from the network if
	197	it is not cached locally.
	198	</tp:docstring>
	199	<tp:possible-errors>
	200	<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
	201	<tp:docstring>
	202	The contact's information could not be retrieved.
	203	</tp:docstring>
	204	</tp:error>
	205	</tp:possible-errors>
	206	</method>
	207
	208	<method name="SetContactInfo" tp:name-for-bindings="Set_Contact_Info">
	209	<tp:docstring>
	210	Set new contact information for this connection, replacing existing
	211	information. This method is only suppported if
	212	<tp:member-ref>ContactInfoFlags</tp:member-ref> contains
	213	<code>Can_Set</code>, and may only be passed fields conforming to
	214	<tp:member-ref>SupportedFields</tp:member-ref>.
	215	</tp:docstring>
	216	<arg direction="in" name="ContactInfo" type="a(sasas)"
	217	tp:type="Contact_Info_Field[]">
	218	<tp:docstring>
	219	The new information to be set.
	220	</tp:docstring>
	221	</arg>
51	222	<tp:possible-errors>
52	223	<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
53	224	<tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>
54		<tp:error name="org.freedesktop.Telepathy.Error.InvalidHandle"/>
55	225	<tp:error name="org.freedesktop.Telepathy.Error.PermissionDenied"/>
56	226	<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable"/>
	227	<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented">
	228	<tp:docstring>
	229	Setting your own information is not supported on this protocol.
	230	</tp:docstring>
	231	</tp:error>
	232	<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
	233	<tp:docstring>
	234	The supplied fields do not match the restrictions specified by
	235	<tp:member-ref>SupportedFields</tp:member-ref>.
	236	</tp:docstring>
	237	</tp:error>
57	238	</tp:possible-errors>
58	239	</method>
	240
	241	<tp:enum name="Contact_Info_Flag" value-prefix="Contact_Info_Flag"
	242	type="u">
	243	<tp:docstring>
	244	Flags defining the behaviour of contact information on this protocol.
	245	Some protocols provide no information on contacts without an explicit
	246	request; others always push information to the connection manager as
	247	and when it changes.
	248	</tp:docstring>
	249
	250	<tp:enumvalue suffix="Can_Set" value="1">
	251	<tp:docstring>
	252	Indicates that <tp:member-ref>SetContactInfo</tp:member-ref> is
	253	supported on this connection.
	254	</tp:docstring>
	255	</tp:enumvalue>
	256
	257	<tp:enumvalue suffix="Push" value="2">
	258	<tp:docstring>
	259	Indicates that the protocol pushes all contacts' information to the
	260	connection manager without prompting. If set,
	261	<tp:member-ref>RequestContactInfo</tp:member-ref> will not cause a
	262	network roundtrip and
	263	<tp:member-ref>ContactInfoChanged</tp:member-ref> will be emitted
	264	whenever contacts' information changes.
	265	</tp:docstring>
	266	</tp:enumvalue>
	267	</tp:enum>
	268
	269	<property name="ContactInfoFlags" type="u" access="read"
	270	tp:type="Contact_Info_Flag" tp:name-for-bindings="Contact_Info_Flags">
	271	<tp:docstring>
	272	An integer representing the bitwise-OR of flags on this channel. This
	273	property should be constant over the lifetime of a connection.
	274	</tp:docstring>
	275	</property>
	276
	277	<tp:struct name="Field_Spec" array-name="Field_Specs">
	278	<tp:docstring>A struct describing a vCard field, with parameters, that
	279	may be passed to <tp:member-ref>SetContactInfo</tp:member-ref> on this
	280	Connection.</tp:docstring>
	281
	282	<tp:member type="s" name="Name">
	283	<tp:docstring>A vCard field name, such as 'tel'.</tp:docstring>
	284	</tp:member>
	285
	286	<tp:member type="as" name="Parameters">
	287	<tp:docstring>The set of vCard type parameters which may be set on this
	288	field. If this list is empty and the
	289	Contact_Info_Field_Flag_Parameters_Mandatory
	290	flag is unset, any vCard type parameters may be used.</tp:docstring>
	291	</tp:member>
	292
	293	<tp:member type="u" name="Flags" tp:type="Contact_Info_Field_Flags">
	294	<tp:docstring>Flags describing the behaviour of this
	295	field.</tp:docstring>
	296	</tp:member>
	297
	298	<tp:member type="u" name="Max">
	299	<tp:docstring>Maximum number of instances of this field which may be
	300	set. MAXUINT32 is used to indicate that there is no
	301	limit.</tp:docstring>
	302	</tp:member>
	303	</tp:struct>
	304
	305	<property name="SupportedFields" type="a(sasuu)" tp:type="Field_Spec[]"
	306	access="read" tp:name-for-bindings="Supported_Fields">
	307	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	308	<p>A list of field specifications describing the kinds of fields which may
	309	be passed to <tp:member-ref>SetContactInfo</tp:member-ref>. The empty
	310	list indicates that arbitrary vCard fields are permitted. This
	311	property SHOULD be the empty list, and be ignored by clients, if
	312	<tp:member-ref>ContactInfoFlags</tp:member-ref> does not contain the
	313	Can_Set <tp:type>Contact_Info_Flag</tp:type>.</p>
	314
	315	<p>For example, an implementation of XEP-0054, which defines a mapping
	316	of vCards to XML for use over XMPP, would set this property to the
	317	empty list. A protocol whose notion of contact information is one
	318	each of personal phone number, mobile phone number, location, email
	319	address and date of birth, with no attributes allowed on each piece
	320	of information, would set this property to (in Python-like
	321	syntax):</p>
	322
	323	<pre>
	324	[
	325	('tel', ['home'], Parameters_Mandatory, 1),
	326	('tel', ['cell'], Parameters_Mandatory, 1),
	327	('adr', [], Parameters_Mandatory, 1),
	328	('bday', [], Parameters_Mandatory, 1),
	329	('email', ['internet'], Parameters_Mandatory, 1),
	330	]</pre>
	331
	332	<p>A protocol which allows users to specify up to four phone numbers,
	333	which may be labelled as personal and/or mobile, would set this
	334	property to <code>[ ('tel', ['home', 'cell'], 0, 4), ]</code>.</p>
	335
	336	<tp:rationale>
	337	<p>Studying existing IM protocols shows that in practice protocols
	338	allow either a very restricted set of fields (such as MSN, which
	339	seems to correspond roughly to the largest example above) or
	340	something mapping 1-1 to vCard (such as XMPP).</p>
	341	</tp:rationale>
	342	</tp:docstring>
	343	</property>
	344
	345	<tp:flags name="Contact_Info_Field_Flags"
	346	value-prefix="Contact_Info_Field_Flag" type="u">
	347	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	348	Flags describing the behaviour of a vCard field.
	349	</tp:docstring>
	350	<tp:flag suffix="Parameters_Mandatory" value="1">
	351	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	352	<p>If present, exactly the parameters indicated must be set on this
	353	field; in the case of an empty list of parameters, this implies that
	354	parameters may not be used.</p>
	355
	356	<p>If absent, and the list of allowed parameters is non-empty,
	357	any (possibly empty) subset of that list may be
	358	used.</p>
	359
	360	<p>If absent, and the list of allowed parameters is empty,
	361	any parameters may be used.</p>
	362	</tp:docstring>
	363	</tp:flag>
	364	</tp:flags>
	365
59	366	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
60		<p>THIS INTERFACE IS DEPRECATED AND SHOULD NOT BE USED. A new version
61		will be proposed in the 0.13 specification branch.</p>
62
63	367	<p>An interface for requesting information about a contact on a given
64		connection. Information is returned as a vCard represented as an XML
65		string, in the format defined by JEP-0054: vcard-temp specifiation
66		from the Jabber Software Foundation (this is derived from the
67		aborted IETF draft draft-dawson-vcard-xml-dtd-01).</p>
68
69		<p>Implementations using PHOTO or SOUND elements should use the URI encoding
70		where possible, and not provide base64 encoded data to avoid unnecessary
71		bus traffic. Clients should not implement support for these encoded forms.
72		A separate interface will be provided for transferring user avatars.</p>
73
74		<p>The following extended element names are also added to represent
75		information from other systems which are not based around vCards:</p>
76		<dl>
77		<dt>USERNAME</dt><dd>the username of the contact on their local system (used on IRC for example)</dd>
78		<dt>HOSTNAME</dt><dd>the fully qualified hostname, or IPv4 or IPv6 address of the contact in dotted quad or colon-separated form</dd>
79		</dl>
	368	connection. Information is represented as a list of
	369	<tp:type>Contact_Info_Field</tp:type>s forming a
	370	structured representation of a vCard (as defined by RFC 2426), using
	371	field names and semantics defined therein.</p>
80	372	</tp:docstring>
81	373	</interface>
82	374	</node>

-0

spec/Connection_Interface_Contacts.xml less more

74	74	first member). Omitted from the result if the contact's capabilities
75	75	are not known; present in the result as an empty array if the
76	76	contact is known to have no capabilities at all.</dd>
	77
77	78	<dt>org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities.DRAFT/caps
78	79	(type a{ua(a{sv}as)},
79	80	<tp:type>Contact_Capabilities_Map</tp:type>)</dt>

82	83	Omitted from the result if the contact's capabilities
83	84	are not known; present in the result as an empty array if the
84	85	contact is known to have no capabilities at all.</dd>
	86
	87	<dt>org.freedesktop.Telepathy.Connection.Interface.Location.DRAFT/location
	88	(type a{sv}, <tp:type>Location</tp:type>)</dt>
	89	<dd>The same struct used by
	90	<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Location.DRAFT">GetLocations</tp:dbus-ref>
	91	Omitted from the result if the contact's location
	92	is not known.</dd>
	93
85	94	</dl>
86	95	</tp:docstring>
87	96

+394

-0

spec/Connection_Interface_Location.xml less more

	0	<?xml version="1.0" ?>
	1	<node name="/Connection_Interface_Location"
	2	xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
	3	<tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright>
	4	<tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright>
	5	<tp:license xmlns="http://www.w3.org/1999/xhtml">
	6	<p>This library is free software; you can redistribute it and/or
	7	modify it under the terms of the GNU Lesser General Public
	8	License as published by the Free Software Foundation; either
	9	version 2.1 of the License, or (at your option) any later version.</p>
	10
	11	<p>This library is distributed in the hope that it will be useful,
	12	but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	14	Lesser General Public License for more details.</p>
	15
	16	<p>You should have received a copy of the GNU Lesser General Public
	17	License along with this library; if not, write to the Free Software
	18	Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
	19	</tp:license>
	20	<interface name="org.freedesktop.Telepathy.Connection.Interface.Location.DRAFT"
	21	tp:causes-havoc='experimental'>
	22	<tp:added version="0.17.UNRELEASED">(as a draft)</tp:added>
	23	<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
	24
	25	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	26	<p>An interface on connections to support protocols which allow users to
	27	publish their current geographical location, and subscribe to the
	28	current location of their contacts.</p>
	29
	30	<p>This interface is geared strongly towards automatic propagation and
	31	use of this information, so focuses on latitude, longitude and
	32	altitude which can be determined by GPS, although provision is also
	33	included for an optional human-readable description of locations. All
	34	co-ordinate information is required to be relative to the WGS84
	35	datum.</p>
	36
	37	<p>The information published through this interface is intended to have
	38	the same scope as presence information, so will normally be made
	39	available to those individuals on the user's "publish" contact list.
	40	Even so, user interfaces should not automatically publish location
	41	information without the consent of the user, and it is recommended
	42	that an option is made available to reduce the accuracy of the
	43	reported information to allow the user to maintain their privacy.</p>
	44
	45	<p>Location information is represented using the terminology of XMPP's
	46	<a href="http://www.xmpp.org/extensions/xep-0080.html">XEP-0080</a>
	47	or the XEP-0080-derived
	48	<a href="http://geoclue.freedesktop.org/">Geoclue</a> API where
	49	possible.</p>
	50	</tp:docstring>
	51
	52	<tp:enum name="Location_Accuracy_Level" type="i">
	53	<tp:docstring>
	54	A location accuracy level. This should be kept in sync with
	55	GeoclueAccuracyLevel in the Geoclue project.
	56	</tp:docstring>
	57
	58	<tp:enumvalue suffix="None" value="0">
	59	<tp:docstring>
	60	The accuracy is unspecified.
	61	</tp:docstring>
	62	</tp:enumvalue>
	63	<tp:enumvalue suffix="Country" value="1">
	64	<tp:docstring>
	65	The location indicates the contact's country.
	66	</tp:docstring>
	67	</tp:enumvalue>
	68	<tp:enumvalue suffix="Region" value="2">
	69	<tp:docstring>
	70	The location indicates the contact's region within a country.
	71	</tp:docstring>
	72	</tp:enumvalue>
	73	<tp:enumvalue suffix="Locality" value="3">
	74	<tp:docstring>
	75	The location indicates the contact's locality within a region
	76	(e.g. the correct city).
	77	</tp:docstring>
	78	</tp:enumvalue>
	79	<tp:enumvalue suffix="Postal_Code" value="4">
	80	<tp:docstring>
	81	The location indicates the correct postal code.
	82	</tp:docstring>
	83	</tp:enumvalue>
	84	<tp:enumvalue suffix="Street" value="5">
	85	<tp:docstring>
	86	The location indicates the correct street.
	87	</tp:docstring>
	88	</tp:enumvalue>
	89	<tp:enumvalue suffix="Detailed" value="6">
	90	<tp:docstring>
	91	The location's accuracy is given by the error, horizontal-error-m
	92	and/or vertical-error-m keys.
	93	</tp:docstring>
	94	</tp:enumvalue>
	95	</tp:enum>
	96
	97	<tp:mapping name="Location">
	98	<tp:docstring>
	99	A user's location, represented as an extensible mapping.
	100	</tp:docstring>
	101
	102	<tp:member name="Key" type="s">
	103	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	104
	105	<p>Civic addresses are represented by the following well-known
	106	keys (all of which have string values), which should be kept in
	107	sync with those used in XEP-0080 and in the Geoclue project:</p>
	108
	109	<ul>
	110	<li>countrycode - s: an ISO-3166-1 alpha-2 (two-letter) country
	111	code, e.g. "us", "gb", "fr"</li>
	112	<li>country - s: a country name in unspecified locale, e.g.
	113	"USA"</li>
	114	<li>region - s: an administrative region of the nation, such as a
	115	state or province</li>
	116	<li>locality - s: a locality within the administrative region, such
	117	as a town or city</li>
	118	<li>area - s: a named area such as a campus or neighborhood</li>
	119	<li>postalcode - s: a code used for postal delivery</li>
	120	<li>street - s: a thoroughfare within the locality, or a crossing of
	121	two thoroughfares</li>
	122	</ul>
	123
	124	<p>The following address keys are defined in XEP-0080 but not by
	125	Geoclue, and are also allowed:</p>
	126
	127	<ul>
	128	<li>building - s: a specific building on a street or in an area</li>
	129	<li>floor - s: a particular floor in a building</li>
	130	<li>room - s: a particular room in a building</li>
	131	<li>text - s: any more specific information, e.g.
	132	"Northwest corner of the lobby"</li>
	133	<li>description - s: A natural-language name for or description of
	134	the location, e.g. "Bill's house"</li>
	135	<li>uri - s: a URI representing the location or pointing to more
	136	information about it</li>
	137	</ul>
	138
	139	<p>Positions are represented by the following well-known keys:</p>
	140
	141	<ul>
	142	<li>lat - d: latitude in decimal degrees north, -90 to +90,
	143	relative to the WGS-84 datum
	144	<tp:rationale>
	145	This is from XEP-0080; the XEP allows use of a different
	146	datum, but recommends this one. We enforce sanity by requiring
	147	a consistent datum: a minimal compliant implementation of this
	148	specification in terms of XEP-0080 would simply ignore the
	149	<lat> and <lon> elements if <datum> exists
	150	and has a value other than WGS-84, while an advanced
	151	implementation might correct for the different datum.
	152	</tp:rationale>
	153	</li>
	154	<li>lon - d: Longitude in decimal degrees east, -180 to +180,
	155	relative to the WGS-84 datum
	156	<tp:rationale>
	157	Same rationale as 'lat'
	158	</tp:rationale>
	159	</li>
	160	<li>alt - d: altitude in metres above sea level (negative
	161	if below sea level)
	162	<tp:rationale>
	163	This is from XEP-0080
	164	</tp:rationale>
	165	</li>
	166	<li>accuracy-level - i (<tp:type>Location_Accuracy_Level</tp:type>):
	167	an indication of accuracy, which SHOULD be omitted if it would be
	168	Location_Accuracy_Level_None or
	169	Location_Accuracy_Level_Detailed
	170	<tp:rationale>
	171	This is a struct field in GeoClue; the name is new in this
	172	specification, and was chosen in an attempt to avoid clashing
	173	with any future XEP-0080 terminology.
	174	</tp:rationale>
	175	</li>
	176	<li>error - d: horizontal position error in arc-minutes (1/60
	177	degree) if known
	178	<tp:rationale>
	179	This is from XEP-0080
	180	</tp:rationale>
	181	</li>
	182	<li>vertical-error-m - d: vertical position error in metres if
	183	known
	184	<tp:rationale>
	185	This exists as a struct field in GeoClue; the name is new
	186	in this specification.
	187	</tp:rationale>
	188	</li>
	189	<li>horizontal-error-m - d: horizontal position error in metres if
	190	known
	191	<tp:rationale>
	192	This exists as a struct field in GeoClue; the name is new
	193	in this specification.
	194	</tp:rationale>
	195	</li>
	196	</ul>
	197
	198	<p>Velocities are represented by the following well-known keys:</p>
	199
	200	<ul>
	201	<li>speed - d: speed in metres per second
	202	<tp:rationale>
	203	This is from XEP-0080
	204	</tp:rationale>
	205	</li>
	206	<li>bearing - d: direction of movement in decimal degrees,
	207	where North is 0 and East is 90
	208	<tp:rationale>
	209	This is from XEP-0080, and is equivalent to the struct field
	210	called "direction" in GeoClue
	211	</tp:rationale>
	212	</li>
	213	<li>climb - d: rate of change of 'alt' in metres per second
	214	<tp:rationale>
	215	This is a struct field in GeoClue; the name is new to this
	216	specification, but seems uncontroversial
	217	</tp:rationale>
	218	</li>
	219	</ul>
	220
	221	<p>Other well-known keys:</p>
	222
	223	<ul>
	224	<li>timestamp - x (<tp:type>Unix_Timestamp64</tp:type>): the time
	225	that the contact was at this location, in seconds since
	226	1970-01-01T00:00:00Z (i.e. the beginning of 1970 in UTC)
	227	<tp:rationale>
	228	XEP-0080 uses an ISO 8601 string for this, but a number of
	229	seconds since the epoch is probably easier to work with.
	230	</tp:rationale>
	231	</li>
	232	</ul>
	233	</tp:docstring>
	234	</tp:member>
	235
	236	<tp:member name="Value" type="v">
	237	<tp:docstring>
	238	The value corresponding to the well-known key.
	239	</tp:docstring>
	240	</tp:member>
	241	</tp:mapping>
	242
	243	<tp:mapping name="Contact_Locations" type="a{ua{sv}}">
	244	<tp:docstring>
	245	A map from contacts to their locations.
	246	</tp:docstring>
	247	<tp:member name="Contact" type="u" tp:type="Contact_Handle">
	248	<tp:docstring>A contact</tp:docstring>
	249	</tp:member>
	250	<tp:member name="Location" type="a{sv}" tp:type="Location">
	251	<tp:docstring>The contact's location, which MAY be empty to indicate
	252	that the contact's location is unknown</tp:docstring>
	253	</tp:member>
	254	</tp:mapping>
	255
	256	<method name="GetLocations" tp:name-for-bindings="Get_Locations">
	257	<tp:docstring>
	258	Return the current locations of the given contacts, if they are
	259	already known. If any of the given contacts' locations are not known,
	260	request their current locations, but return immediately without waiting
	261	for a reply; if a reply with a non-empty location is later received
	262	for those contacts, the <tp:member-ref>LocationUpdated</tp:member-ref>
	263	signal will be emitted for them.
	264
	265	<tp:rationale>
	266	This method is appropriate for "lazy" location finding, for instance
	267	displaying the location (if available) of everyone in your contact
	268	list.
	269	</tp:rationale>
	270	</tp:docstring>
	271
	272	<arg direction="in" name="Contacts" type="au" tp:type="Contact_Handle[]">
	273	<tp:docstring>
	274	The contacts whose locations should be returned or signalled.
	275	</tp:docstring>
	276	</arg>
	277
	278	<arg direction="out" name="Locations" type="a{ua{sv}}"
	279	tp:type="Contact_Locations">
	280	<tp:docstring>
	281	The contacts' locations, if already known. Contacts whose locations
	282	are not already known are omitted from the mapping; contacts known
	283	to have no location information appear in the mapping with an empty
	284	Location dictionary.
	285	</tp:docstring>
	286	</arg>
	287
	288	<tp:possible-errors>
	289	<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
	290	<tp:error name="org.freedesktop.Telepathy.Error.InvalidHandle"/>
	291	</tp:possible-errors>
	292	</method>
	293
	294	<method name="RequestLocation" tp:name-for-bindings="Request_Location">
	295	<tp:docstring>
	296	Return the current location of the given contact. If necessary, make
	297	a request to the server for up-to-date information, and wait for a
	298	reply.
	299
	300	<tp:rationale>
	301	This method is appropriate for use in a "Contact Information..."
	302	dialog; it can be used to show progress information (while waiting
	303	for the method to return), and can distinguish between various error
	304	conditions.
	305	</tp:rationale>
	306	</tp:docstring>
	307
	308	<arg direction="in" name="Contact" type="u" tp:type="Contact_Handle">
	309	<tp:docstring>
	310	The contact whose location should be returned.
	311	</tp:docstring>
	312	</arg>
	313
	314	<arg direction="out" name="Location" type="a{sv}" tp:type="Location">
	315	<tp:docstring>
	316	The contact's location. It MAY be empty, indicating that no location
	317	information was found.
	318	</tp:docstring>
	319	</arg>
	320
	321	<tp:possible-errors>
	322	<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
	323	<tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>
	324	<tp:error name="org.freedesktop.Telepathy.Error.InvalidHandle"/>
	325	<tp:error name="org.freedesktop.Telepathy.Error.PermissionDenied">
	326	<tp:docstring>
	327	The requested contact does not allow the local user to see their
	328	location information.
	329	</tp:docstring>
	330	</tp:error>
	331	</tp:possible-errors>
	332	</method>
	333
	334	<signal name="LocationUpdated" tp:name-for-bindings="Location_Updated">
	335	<tp:docstring>
	336	Emitted when a contact's location changes or becomes known.
	337	</tp:docstring>
	338
	339	<arg name="Contact" type="u" tp:type="Contact_Handle">
	340	<tp:docstring>
	341	The contact
	342	</tp:docstring>
	343	</arg>
	344	<arg name="Location" type="a{sv}" tp:type="Location">
	345	<tp:docstring>
	346	The contact's location, or empty to indicate that nothing is known
	347	about the contact's location.
	348	</tp:docstring>
	349	</arg>
	350	</signal>
	351
	352	<method name="SetLocation" tp:name-for-bindings="Set_Location">
	353	<tp:docstring>
	354	Set the local user's own location.
	355	</tp:docstring>
	356
	357	<arg direction="in" name="Location" type="a{sv}">
	358	<tp:docstring>
	359	The location to advertise. If the user wants to obscure their
	360	exact location by reducing the precision or accuracy, clients
	361	MUST do this themselves, rather than relying on the connection
	362	manager to do so. Clients that interact with more than one
	363	connection SHOULD advertise the same reduced-accuracy location
	364	to all of them, so that contacts cannot obtain an undesirably
	365	accurate location by assuming that random errors have been added
	366	and averaging the locations advertised on multiple connections.
	367	</tp:docstring>
	368	</arg>
	369
	370	<tp:possible-errors>
	371	<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
	372	<tp:error name="org.freedesktop.Telepathy.Error.NotImplemented"/>
	373	<tp:error name="org.freedesktop.Telepathy.Error.PermissionDenied"/>
	374	</tp:possible-errors>
	375	</method>
	376
	377	<property name="LocationAccessControlTypes" type="au" access="read"
	378	tp:type="Rich_Presence_Access_Control_Type[]" tp:name-for-bindings="Location_Access_Control_Types">
	379	<tp:docstring>The types of access control that are supported by this
	380	connection.</tp:docstring>
	381	</property>
	382
	383	<property name="LocationAccessControl" type="(uv)" access="readwrite"
	384	tp:type="Rich_Presence_Access_Control" tp:name-for-bindings="Location_Access_Control">
	385	<tp:docstring>The current access control mechanism and settings
	386	for this connection. Before publishing location for the first time,
	387	if this has not been set by a client, implementations SHOULD
	388	set it to be as restrictive as possible (an empty whitelist, if
	389	supported).</tp:docstring>
	390	</property>
	391	</interface>
	392	</node>
	393	<!-- vim:set sw=2 sts=2 et ft=xml: -->

+64

-2

spec/Connection_Interface_Presence.xml less more

130	130	</tp:possible-errors>
131	131	</method>
132	132	<method name="GetStatuses" tp:name-for-bindings="Get_Statuses">
133		<arg direction="out" type="a{s(ubba{ss})}" tp:type="Status_Spec_Map">
	133	<arg direction="out" type="a{s(ubba{ss})}" tp:type="Status_Spec_Map"
	134	name="Available_Statuses">
134	135	<tp:docstring>
135	136	A dictionary of string identifiers mapped to a struct for each status, containing:
136	137	<ul>

159	160	A dictionary of contact handles mapped to a struct containing
160	161	a UNIX timestamp of the last activity time (in UTC), and
161	162	a dictionary mapping the contact's current status identifiers to
162		a dictionary of optional parameter names mapped to their
	163	a dictionary of optional parameter names mapped to their
163	164	variant-boxed values
164	165	</tp:docstring>
165	166	</arg>

395	396	</tp:docstring>
396	397	</tp:enumvalue>
397	398	</tp:enum>
	399
	400	<tp:enum name="Rich_Presence_Access_Control_Type" type="u">
	401	<tp:docstring>
	402	A type of access control for Rich_Presence_Access_Control.
	403	For most types, the exact access control is given by an associated
	404	variant.
	405
	406	<tp:rationale>
	407	These are the access control types from XMPP publish/subscribe
	408	(XEP-0060).
	409	</tp:rationale>
	410	</tp:docstring>
	411
	412	<tp:enumvalue suffix="Whitelist" value="0">
	413	<tp:docstring>
	414	The associated variant is a list of contacts (signature 'au',
	415	Contact_Handle[]) who can see the extended presence information.
	416	</tp:docstring>
	417	</tp:enumvalue>
	418	<tp:enumvalue suffix="Publish_List" value="1">
	419	<tp:docstring>
	420	All contacts in the user's 'publish' contact list can see the
	421	extended presence information. The associated variant is ignored.
	422	</tp:docstring>
	423	</tp:enumvalue>
	424	<tp:enumvalue suffix="Group" value="2">
	425	<tp:docstring>
	426	The associated variant is a handle of type Group (signature 'u',
	427	Group_Handle) representing a group of contacts who can see the
	428	extended presence information.
	429	</tp:docstring>
	430	</tp:enumvalue>
	431	<tp:enumvalue suffix="Open" value="3">
	432	<tp:docstring>
	433	Anyone with access to the service can see the extended presence
	434	information.
	435	</tp:docstring>
	436	</tp:enumvalue>
	437	</tp:enum>
	438
	439	<tp:struct name="Rich_Presence_Access_Control">
	440	<tp:docstring>
	441	An access control mode for extended presence items like geolocation.
	442	This type isn't actually used by the core Presence interface, but
	443	it's included here so it can be referenced by other specifications.
	444	</tp:docstring>
	445
	446	<tp:member name="Type" type="u" tp:type="Rich_Presence_Access_Control_Type">
	447	<tp:docstring>
	448	The type of access control to apply.
	449	</tp:docstring>
	450	</tp:member>
	451	<tp:member name="Detail" type="v">
	452	<tp:docstring>
	453	Any additional information required by the Type. The required
	454	type and semantics are defined for each
	455	Rich_Presence_Access_Control_Type.
	456	</tp:docstring>
	457	</tp:member>
	458	</tp:struct>
	459
398	460	</interface>
399	461	</node>
400	462	<!-- vim:set sw=2 sts=2 et ft=xml: -->

+24

-0

spec/Connection_Interface_Requests.xml less more

196	196	of a property whose value is the string corresponding to a handle
197	197	(like <tp:dbus-ref
198	198	namespace="org.freedesktop.Telepathy">Channel.TargetID</tp:dbus-ref>).
	199	</tp:docstring>
	200	</tp:error>
	201	<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
	202	<tp:docstring>
	203	The request matched the fixed properties of a
	204	<tp:type>Requestable_Channel_Class</tp:type> in
	205	<tp:member-ref>RequestableChannelClasses</tp:member-ref>, but the
	206	allowed arguments did not make sense; for example, a <tp:dbus-ref
	207	namespace="org.freedesktop.Telepathy.Channel.Type">RoomList</tp:dbus-ref>
	208	was requested, but the <tp:dbus-ref
	209	namespace="org.freedesktop.Telepathy.Channel.Type.RoomList">Server</tp:dbus-ref>
	210	property provided was not a valid DNS name.
199	211	</tp:docstring>
200	212	</tp:error>
201	213	<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">

321	333	namespace="org.freedesktop.Telepathy">Channel.TargetID</tp:dbus-ref>).
322	334	</tp:docstring>
323	335	</tp:error>
	336	<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
	337	<tp:docstring>
	338	The request matched the fixed properties of a
	339	<tp:type>Requestable_Channel_Class</tp:type> in
	340	<tp:member-ref>RequestableChannelClasses</tp:member-ref>, but the
	341	allowed arguments did not make sense; for example, a <tp:dbus-ref
	342	namespace="org.freedesktop.Telepathy.Channel.Type">RoomList</tp:dbus-ref>
	343	was requested, but the <tp:dbus-ref
	344	namespace="org.freedesktop.Telepathy.Channel.Type.RoomList">Server</tp:dbus-ref>
	345	property provided was not a valid DNS name.
	346	</tp:docstring>
	347	</tp:error>
324	348	<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable">
325	349	<tp:docstring>
326	350	The requested channel cannot be created, but in

-4

spec/Connection_Manager.xml less more

157	157	The required protocol name
158	158	</tp:docstring>
159	159	</arg>
160		<arg direction="out" type="a(susv)" tp:type="Param_Spec[]">
	160	<arg direction="out" type="a(susv)" tp:type="Param_Spec[]"
	161	name="Parameters">
161	162	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
162	163	An array of structs representing possible parameters.
163	164	</tp:docstring>

177	178	</method>
178	179
179	180	<method name="ListProtocols" tp:name-for-bindings="List_Protocols">
180		<arg direction="out" type="as" tp:type="Protocol[]">
	181	<arg direction="out" type="as" tp:type="Protocol[]" name="Protocols">
181	182	<tp:docstring>
182	183	A array of string protocol identifiers supported by this manager
183	184	</tp:docstring>

225	226	and the above well-known list.
226	227	</tp:docstring>
227	228	</arg>
228		<arg direction="out" type="s" tp:type="DBus_Bus_Name">
	229	<arg direction="out" type="s" tp:type="DBus_Bus_Name" name="Bus_Name">
229	230	<tp:docstring>
230	231	A D-Bus service name where the new Connection object can be found
231	232	</tp:docstring>
232	233	</arg>
233		<arg direction="out" type="o">
	234	<arg direction="out" type="o" name="Object_Path">
234	235	<tp:docstring>
235	236	The D-Bus object path to the Connection on this service
236	237	</tp:docstring>

+56

-7

spec/Media_Stream_Handler.xml less more

97	97	<method name="CodecChoice" tp:name-for-bindings="Codec_Choice">
98	98	<arg direction="in" name="Codec_ID" type="u"/>
99	99	<tp:docstring>
100		Inform the connection manager of the current codec choice.
	100	Inform the connection manager of codec used to receive data.
101	101	</tp:docstring>
102	102	</method>
103	103	<method name="Error" tp:name-for-bindings="Error">

221	221	Locally-supported codecs
222	222	</tp:docstring>
223	223	</arg>
224		<tp:docstring>
225		Used to provide codecs after Ready(), so the media client can go
226		ready for an incoming call and exchange candidates/codecs before
227		knowing what local codecs are available.
	224	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
	225	<p>Used to provide codecs after Ready(), so the media client can go
	226	ready for an incoming call and exchange candidates/codecs before
	227	knowing what local codecs are available.</p>
	228
	229	<p>This is useful for gatewaying calls between two connection managers.
	230	Given an incoming call, you need to call
	231	<tp:member-ref>Ready</tp:member-ref> to get the remote codecs before
	232	you can use them as the "local" codecs to place the outgoing call,
	233	and hence receive the outgoing call's remote codecs to use as the
	234	incoming call's "local" codecs.</p>
	235
	236	<p>In this situation, you would pass an empty list of codecs to the
	237	incoming call's Ready method, then later call SetLocalCodecs on the
	238	incoming call in order to respond to the offer.</p>
228	239	</tp:docstring>
229	240	</method>
230	241	<signal name="RemoveRemoteCandidate"

234	245	String identifier for remote candidate to drop
235	246	</tp:docstring>
236	247	</arg>
	248	<tp:deprecated>
	249	There is no case where you want to release candidates (except
	250	for an ICE reset, and there you'd want to replace then all,
	251	using <tp:member-ref>SetRemoteCandidateList</tp:member-ref>).
	252	</tp:deprecated>
237	253	<tp:docstring>
238	254	Signal emitted when the connection manager wishes to inform the
239	255	client that the remote end has removed a previously usable
240	256	candidate.
	257
	258	<tp:rationale>
	259	It seemed like a good idea at the time, but wasn't.
	260	</tp:rationale>
241	261	</tp:docstring>
242	262	</signal>
243	263	<signal name="SetActiveCandidatePair"

274	294	<tp:docstring>
275	295	Signal emitted when the connection manager wishes to inform the
276	296	client of the codecs supported by the remote end.
	297	If these codecs are compatible with the remote codecs, then the client
	298	must call <tp:member-ref>SupportedCodecs</tp:member-ref>,
	299	otherwise call <tp:member-ref>Error</tp:member-ref>.
277	300	</tp:docstring>
278	301	</signal>
279	302	<signal name="SetStreamPlaying" tp:name-for-bindings="Set_Stream_Playing">
280	303	<arg name="Playing" type="b"/>
281	304	<tp:docstring>
282		Signal emitted when the connection manager wishes to set the
283		stream playing or stopped.
	305	If emitted with argument TRUE, this means that the connection manager
	306	wishes to set the stream playing; this means that the streaming
	307	implementation should expect to receive data. If emitted with argument
	308	FALSE this signal is basically meaningless and should be ignored.
	309
	310	<tp:rationale>
	311	We're very sorry.
	312	</tp:rationale>
284	313	</tp:docstring>
285	314	</signal>
286	315	<signal name="SetStreamSending" tp:name-for-bindings="Set_Stream_Sending">

316	345	as specified in Channel.Type.StreamedMedia::ListStreams.
317	346	</tp:docstring>
318	347	</method>
	348
319	349	<method name="SupportedCodecs" tp:name-for-bindings="Supported_Codecs">
320	350	<arg direction="in" name="Codecs" type="a(usuuua{ss})"
321	351	tp:type="Media_Stream_Handler_Codec[]">

329	359	to notify what codecs are supported by the peer, and will thus be an
330	360	intersection of all locally supported codecs (passed to Ready)
331	361	and those supported by the peer.
	362	</tp:docstring>
	363	</method>
	364
	365	<method name="CodecsUpdated" tp:name-for-bindings="Codecs_Updated">
	366	<arg direction="in" name="Codecs" type="a(usuuua{ss})"
	367	tp:type="Media_Stream_Handler_Codec[]">
	368	<tp:docstring>
	369	Locally supported codecs, which SHOULD be the same as were previously
	370	in effect, but possibly with different parameters.
	371	</tp:docstring>
	372	</arg>
	373	<tp:docstring>
	374	Inform the connection manager that the parameters of the supported
	375	codecs for this session have changed. The connection manager should
	376	send the new parameters to the remote contact.
	377
	378	<tp:rationale>
	379	This is required for H.264 and Theora, for example.
	380	</tp:rationale>
332	381	</tp:docstring>
333	382	</method>
334	383

-2

spec/Properties_Interface.xml less more

61	61	<arg direction="in" name="Properties" type="au" tp:type="Property_ID[]">
62	62	<tp:docstring>An array of property identifiers</tp:docstring>
63	63	</arg>
64		<arg direction="out" type="a(uv)" tp:type="Property_Value[]">
	64	<arg direction="out" type="a(uv)" tp:type="Property_Value[]"
	65	name="Values">
65	66	<!-- XXX: if we're ever breaking API compatibility, make this a{uv} -->
66	67	<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
67	68	<p>An array of structs containing:</p>

89	90	<tp:docstring>
90	91	Returns a dictionary of the properties available on this channel.
91	92	</tp:docstring>
92		<arg direction="out" type="a(ussu)" tp:type="Property_Spec[]">
	93	<arg direction="out" type="a(ussu)" tp:type="Property_Spec[]"
	94	name="Available_Properties">
93	95	<!-- XXX: if we're ever breaking API compatibility, make this
94	96	a{u(ssu)} ? -->
95	97	<tp:docstring>

-4

spec/all.xml less more

2	2	xmlns:xi="http://www.w3.org/2001/XInclude">
3	3
4	4	<tp:title>Telepathy D-Bus Interface Specification</tp:title>
5		<tp:version>0.17.17</tp:version>
	5	<tp:version>0.17.18</tp:version>
6	6
7	7	<tp:copyright>Copyright (C) 2005-2008 Collabora Limited</tp:copyright>
8	8	<tp:copyright>Copyright (C) 2005-2008 Nokia Corporation</tp:copyright>

30	30	<xi:include href="Connection_Interface_Avatars.xml"/>
31	31	<xi:include href="Connection_Interface_Capabilities.xml"/>
32	32	<xi:include href="Connection_Interface_Contact_Capabilities.xml"/>
	33	<xi:include href="Connection_Interface_Contact_Info.xml"/>
33	34	<xi:include href="Connection_Interface_Contacts.xml"/>
34		<xi:include href="Connection_Interface_Simple_Presence.xml"/>
	35	<xi:include href="Connection_Interface_Location.xml"/>
35	36	<xi:include href="Connection_Interface_Presence.xml"/>
36	37	<xi:include href="Connection_Interface_Renaming.xml"/>
37	38	<xi:include href="Connection_Interface_Requests.xml"/>
	39	<xi:include href="Connection_Interface_Simple_Presence.xml"/>
38	40
39	41	<xi:include href="Channel_Bundle.xml"/>
40	42

86	88	<xi:include href="errors.xml"/>
87	89	<xi:include href="generic-types.xml"/>
88	90
89		<!-- Never implemented, is a terrible API
90		<xi:include href="Connection_Interface_Contact_Info.xml"/> -->
91	91	<!-- Never implemented, insufficient (needs conditions)
92	92	<xi:include href="Connection_Interface_Forwarding.xml"/> -->
93	93	<!-- Never implemented, vague

-3

spec/generic-types.xml less more

6	6	(1970-01-01T00:00:00Z)</tp:docstring>
7	7	</tp:simple-type>
8	8
9		<tp:simple-type name="Unix_Timestamp64" type="t">
10		<tp:docstring>An unsigned 64-bit integer representing time as the number
	9	<tp:simple-type name="Unix_Timestamp64" type="x">
	10	<tp:docstring>An signed 64-bit integer representing time as the number
11	11	of seconds elapsed since the Unix epoch
12		(1970-01-01T00:00:00Z)</tp:docstring>
	12	(1970-01-01T00:00:00Z); negative for times before the epoch</tp:docstring>
13	13
14	14	<tp:rationale>The Text interface is the only user of Unix_Timestamp so
15	15	far, and we'd like to be Y2038 compatible in future

-6

tools/doc-generator.xsl less more

709	709	</xsl:if>
710	710	</xsl:when>
711	711	<xsl:when test="@direction='out'">
712		<!-- FIXME: This is commented out until someone with a lot of time
713		on their hands goes through the spec adding names to all the "out"
714		arguments
715
716	712	<xsl:if test="not(@name) or @name = ''">
717	713	<xsl:message terminate="no">
718		<xsl:text>INFO: an 'out' arg of method </xsl:text>
	714	<xsl:text>WARNING: an 'out' arg of method </xsl:text>
719	715	<xsl:value-of select="concat(../../@name, '.', ../@name)"/>
720	716	<xsl:text> has no name</xsl:text>
721	717	</xsl:message>
722		</xsl:if>-->
	718	</xsl:if>
723	719	</xsl:when>
724	720	<xsl:otherwise>
725	721	<xsl:message terminate="yes">