diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2008-05-22 16:51:47 +0000 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2008-05-22 16:51:47 +0000 |
commit | 9aee644654d3a4f1119012fe43ab9947fced6403 (patch) | |
tree | 0830f0d7e153a5ab8ec7152b4d7c2fcb2a9e6149 /spec | |
parent | c2407b857e38edabb4ff97bd6cb457f78cad2c6f (diff) | |
download | telepathy-glib-9aee644654d3a4f1119012fe43ab9947fced6403.tar.gz |
Add HTML interface from telepathy-spec 0.17.5
20080522165147-53eee-a6b25df8d730cad0c8d787314d0a8c8620837b6c.gz
Diffstat (limited to 'spec')
-rw-r--r-- | spec/Channel_Interface_HTML.xml | 79 |
1 files changed, 79 insertions, 0 deletions
diff --git a/spec/Channel_Interface_HTML.xml b/spec/Channel_Interface_HTML.xml new file mode 100644 index 000000000..07d08b305 --- /dev/null +++ b/spec/Channel_Interface_HTML.xml @@ -0,0 +1,79 @@ +<?xml version="1.0" ?> +<node name="/Channel_Interface_HTML" + xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"> + <tp:copyright>Copyright (C) 2008 Collabora Ltd.</tp:copyright> + <tp:copyright>Copyright (C) 2008 Nokia Corporation</tp:copyright> + <tp:license xmlns="http://www.w3.org/1999/xhtml"> + <p>This library is free software; you can redistribute it and/or +modify it under the terms of the GNU Lesser General Public +License as published by the Free Software Foundation; either +version 2.1 of the License, or (at your option) any later version.</p> + +<p>This library is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +Lesser General Public License for more details.</p> + +<p>You should have received a copy of the GNU Lesser General Public +License along with this library; if not, write to the Free Software +Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p> + </tp:license> + <interface + name="org.freedesktop.Telepathy.Channel.Interface.HTML.DRAFT" + tp:causes-havoc="unfinished"> + <tp:requires interface="org.freedesktop.Telepathy.Channel.Type.Text"/> + <tp:requires + interface="org.freedesktop.Telepathy.Channel.Interface.Messages"/> + + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>This interface extends the Messages interface to support + capability discovery, so clients can decide what subset of HTML + is supported.</p> + + <p>(However, the capability discovery mechanism has not been written + yet, so this interface MUST NOT be used. It exists only to + indicate what direction we intend to go in.)</p> + + <tp:rationale> + <p>XMPP supports all of XHTML-IM, and SIP (at least theoretically) + supports all of XHTML. However, many protocols are more limited - + for instance, in MSN you can only set font properties for a + whole message at a time. We should not mislead users into thinking + they can send MSN messages where individual words are emphasized.</p> + </tp:rationale> + + <p>If this interface is present, clients MAY send XHTML formatted text + in message parts with type "text/html", and SHOULD interpret + "text/html" message parts received in reply.</p> + + <p>Client authors SHOULD pay careful attention to the security + considerations in XEP-0071, "XHTML-IM", to avoid exposing client users + to security risks. + (FIXME: or should the presence of this interface act as a guarantee + that the CM will perform filtering on "text/html" parts? In practice + that would mean all CMs had to link against a tag-soup parser like + libxml2)</p> + + <p>To avoid misleading users, clients SHOULD only present UI for the + subset of HTML that is indicated to be supported by this + interface. It follows that clients SHOULD NOT send unsupported + markup to the connection manager. However, even if the connection + manager cannot send arbitrary XHTML, it MUST cope gracefully + with being given arbitrary XHTML by a client.</p> + + <tp:rationale> + <p>Connection managers should be lenient in what they receive.</p> + </tp:rationale> + + <p>Clients MUST NOT send HTML that is not well-formed XML, but + connection managers MAY signal HTML that is malformed or invalid. + Clients SHOULD attempt to parse messages as XHTML, but fall back + to using a permissive "tag-soup" HTML parser if that fails. + (FIXME: or should the presence of this interface imply that the + CM filters and fixes up "text/html"? In practice that would result + in all the CMs having to link against libxml2 or something)</p> + </tp:docstring> + + </interface> +</node> +<!-- vim:set sw=2 sts=2 et ft=xml: --> |