[Telepathy-commits] [telepathy-spec/master] Client: activatable clients SHOULD install a .client file; non-activatable clients MAY, but there's not much point

[Simon McVittie]

20080630124521-53eee-a04e0ea5401902fc7a6cbdf2c087a4bf75b89cea.gz
---
 spec/Client.xml |   11 +++++++++--
 1 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/spec/Client.xml b/spec/Client.xml
index 94a959e..f85d5f4 100644
--- a/spec/Client.xml
+++ b/spec/Client.xml
@@ -69,8 +69,12 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
         client; the channel dispatcher will call its methods and read
         its properties when appropriate.</p>
 
-      <p>As an optimization, clients MAY install a file
-        <a href="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">$XDG_DATA_DIRS</a>/telepathy/clients/<em>clientname</em>.client
+      <!-- FIXME: Should the Approver, Observer, Channel Handler all
+      be interfaces on the same object, or should they be separate objects?
+      -->
+
+      <p>As an optimization, activatable clients SHOULD install a file
+        <code><a href="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html">$XDG_DATA_DIRS</a>/telepathy/clients/<em>clientname</em>.client</code>
         containing a cached version of its immutable properties,
         so that for most clients, the channel dispatcher can
         just read a file to discover capabilities, instead of
@@ -78,6 +82,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
         its read-only properties. However, the D-Bus API is canonical, and
         the channel dispatcher MUST support clients without such a file.</p>
 
+      <p>Non-activatable clients MAY install a <code>.client</code> file,
+        but there's not much point in them doing so.</p>
+
       <p>The .client files MUST contain UTF-8 text with the same syntax
         as
         <a href="http://standards.freedesktop.org/desktop-entry-spec/latest/">Desktop
-- 
1.5.6.5