[Telepathy-commits] [telepathy-spec/master] Add use cases for client capabilities

[Simon McVittie]

20080609163922-53eee-c1aefc1546bc7c628cb7642f6453b40b536be1a3.gz
---
 Makefile           |    8 ++++----
 doc/clientcaps.txt |   49 +++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+), 4 deletions(-)
 create mode 100644 doc/clientcaps.txt

diff --git a/Makefile b/Makefile
index 62f62da..98c3e86 100644
--- a/Makefile
+++ b/Makefile
@@ -26,13 +26,13 @@ TEST_GENERATED_FILES = \
 	test/output/spec.html \
 	$(TEST_INTROSPECT) $(TEST_ASYNC_INTROSPECT)
 
-doc/cmcaps.html doc/request.html doc/dispatch.html: %.html: %.txt
+RST = doc/cmcaps.txt doc/clientcaps.txt doc/request.txt doc/dispatch.txt
+
+$(patsubst %.txt,%.html,$(RST)): %.html: %.txt Makefile
 	$(RST2HTML) < $< > $@
 
 GENERATED_FILES = \
-	doc/cmcaps.html \
-	doc/request.html \
-	doc/dispatch.html \
+	$(patsubst %.txt,%.html,$(RST)) \
 	doc/spec.html \
 	doc/telepathy-spec.devhelp2 \
 	$(INTROSPECT) $(ASYNC_INTROSPECT) \
diff --git a/doc/clientcaps.txt b/doc/clientcaps.txt
new file mode 100644
index 0000000..48c647e
--- /dev/null
+++ b/doc/clientcaps.txt
@@ -0,0 +1,49 @@
+Use cases for client capabilities
+=================================
+
+.. contents::
+
+Issues
+------
+
+* We need a way for special-purpose apps to be a low priority handler for
+  more general channels - a Tubes-capable AbiWord probably shouldn't handle
+  Text or VoIP channels unless no general-purpose UI is available (and
+  perhaps not even then)
+
+Empathy
+-------
+
+... or other general-purpose IM client. (This is a hypothetical future
+version of Empathy - it doesn't do everything listed here yet)
+
+* ChannelType = Text, TargetHandleType = CONTACT
+* ChannelType = StreamedMedia, TargetHandleType = NONE
+* ChannelType = FileTransfer, TargetHandleType = CONTACT
+
+AbiWord
+-------
+
+... or other collaborative app. (Again, this is a hypothetical future
+version - it doesn't do everything listed here yet, and perhaps never will)
+
+* ChannelType = DBusTube, Service = com.abisource.AbiCollab (or something)
+* ChannelType = Text, TargetHandleType = CONTACT, low priority
+* ChannelType = StreamedMedia, TargetHandleType = NONE, low priority
+* ChannelType = FileTransfer, TargetHandleType = CONTACT, low priority
+* ChannelType = FileTransfer, ContentType = 'text/abiword' ?
+
+OpenArena
+---------
+
+Hypothetically...
+
+* ChannelType = PacketTube, service = _openarena._udp (or something)
+
+OLPC activity
+-------------
+
+Similar to AbiWord
+
+..
+  vim:set sw=4 sts=4 et:
-- 
1.5.6.5