[Telepathy-commits] [telepathy-spec/master] add tp:rational about the Local_File socket type

Guillaume Desmottes guillaume.desmottes at collabora.co.uk
Tue Nov 4 11:45:22 PST 2008


---
 spec/Channel_Type_Tubes.xml |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)

diff --git a/spec/Channel_Type_Tubes.xml b/spec/Channel_Type_Tubes.xml
index 48adcde..08a9f48 100644
--- a/spec/Channel_Type_Tubes.xml
+++ b/spec/Channel_Type_Tubes.xml
@@ -222,6 +222,11 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
           either using a string if the path is known to be Unicode, either
           a byte-array, signature 'ay'.
           This fake socket address type shouldn't be used with tubes.
+          <tp:rationale>This false socket type is only included to allow file
+          transfers in connection managers where the only available protocol implementation
+          operates directly on local files. It SHOULD NOT be relied
+          on by client authors, who MUST implement streaming over a socket and use it preferentially
+          when available.</tp:rationale>
         </tp:docstring>
       </tp:enumvalue>
 
-- 
1.5.6.5




More information about the Telepathy-commits mailing list