diff options
| author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2013-10-11 12:46:37 +0100 |
|---|---|---|
| committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2013-10-14 17:03:25 +0100 |
| commit | f4b552a80d32b6fb12fc34933a21cfc085cc5e17 (patch) | |
| tree | 83c8c039ca12dd6bc1179a1eff11730319ae0481 | |
| parent | b65310ab9aa6556ccad5abe2ed5c9de1211e51f8 (diff) | |
Add FileCollection to FileTransfer interface
The implementation in Gabble hasn't changed since 2010, so it's
de facto stable. We should either spec it or delete it.
Bug: https://bugs.freedesktop.org/show_bug.cgi?id=26609
Reviewed-by: Guillaume Desmottes <guillaume.desmottes@collabora.co.uk>
| -rw-r--r-- | spec/Channel_Type_File_Transfer.xml | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/spec/Channel_Type_File_Transfer.xml b/spec/Channel_Type_File_Transfer.xml index f50b9634..420f6fa5 100644 --- a/spec/Channel_Type_File_Transfer.xml +++ b/spec/Channel_Type_File_Transfer.xml @@ -579,6 +579,35 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</ </arg> </signal> + <property name="FileCollection" tp:name-for-bindings="File_Collection" + type="s" access="read"> + <tp:added version="0.UNRELEASED"/> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>The collection of files to which this channel belongs, + or the empty string if this channel does not belong to + a collection of files.</p> + + <p>A channel's FileCollection property can never change.</p> + + <p>At least on GTalk and apparently also on iChat the user can + send a set of files to a contact and that contact can then + pick and choose which files to actually receive.</p> + + <p> The CM should emit all new FT channels belonging to one collection + at the same time. UIs supporting this feature can then + bundle all these channels together in some way, and show a + nice UI. UIs not supporting it will treat them as separate + transfers, which is not great but a reasonable fallback.</p> + + <p>No mechanism is currently defined to indicate whether the UI + should expect any more files in the same collection. UIs + SHOULD assume that more file transfers may be added to a + collection. It is possible that a "no more channels in this + collection" indication will be added in a future version of + this specification.</p> + </tp:docstring> + </property> + </interface> </node> |