Updated client.

Author: rauchg

support/socket.io-client/History.md

@@ -0,0 +1,21 @@
+
+0.7.0 / 2011-??-??
+==================
+
+  * Fixed JSONP interaction with jQuery. [saschagehlich]
+  * Fixed; different port now considered cross-domain.
+  * Added compatibility for inclusion in non-browser environments.
+  * Added package.json.
+  * Added noConflict support. [kreichgauer]
+  * Added reconnection support with exponential backoff. [3rd-Eden]
+
+0.6.2 / 2011-02-05 
+==================
+
+  * Fixed problem with xhr-multipart buffering
+  * Updated Flash websocket transport
+  * Fixed tryTransportsOnConnectTimeout option 
+  * Added 'connect_failed' event after the last available transport fails to connect
+  within the timeout 
+  * Add 'connecting' event emit on each connection attempt.
+

support/socket.io-client/README.md

@@ -168,9 +168,9 @@ The insecure version can be found [here](http://github.com/gimite/web-socket-js/
 
 ##### Methods:
 
-- *connect*
+- *connect(λ)*
 
-	Establishes a connection.
+	Establishes a connection. If λ is supplied as argument, it will be called once the connection is established.
 
 - *send(message)*
 
@@ -183,6 +183,10 @@ The insecure version can be found [here](http://github.com/gimite/web-socket-js/
 - *on(event, λ)*
 
 	Adds a listener for the event *event*.
+
+- *once(event, λ)*
+
+	Adds a one time listener for the event *event*. The listener is removed after the first time the event is fired.
 
 - *removeEvent(event, λ)*
 
@@ -225,10 +229,9 @@ The insecure version can be found [here](http://github.com/gimite/web-socket-js/
 
 	Fired when a reconnection is attempted, passing the next delay for the next reconnection.
 
-
 - *reconnect_failed*
 
-	Fired when all reconnection attempts have failed and we where unsucessfull in reconnecting to the server.  
+	Fired when all reconnection attempts have failed and we where unsuccessful in reconnecting to the server.  
 
 ### Contributors
 

support/socket.io-client/lib/io.js

@@ -1,25 +1,46 @@
 /**
- * Socket.IO client
- * 
- * @author Guillermo Rauch <[email protected]>
- * @license The MIT license.
- * @copyright Copyright (c) 2010 LearnBoost <[email protected]>
+ * socket.io-node-client
+ * Copyright(c) 2011 LearnBoost <[email protected]>
+ * MIT Licensed
  */
 
+/**
+ * @namespace
+ */
 var io = this.io = {
-	version: '0.6.2',
-	
-	setPath: function(path){
-		if (window.console && console.error) console.error('io.setPath will be removed. Please set the variable WEB_SOCKET_SWF_LOCATION pointing to WebSocketMain.swf');
-		this.path = /\/$/.test(path) ? path : path + '/';
+  
+  /**
+   * Library version.
+   */
+  version: '0.6.2',
+  
+  /**
+   * Updates the location of the WebSocketMain.swf file that is required for the Flashsocket transport.
+   * This should only be needed if you want to load in the WebSocketMainInsecure.swf or if you want to
+   * host the .swf file on a other server.
+   *
+   * @static
+   * @deprecated Set the variable `WEB_SOCKET_SWF_LOCATION` pointing to WebSocketMain.swf
+   * @param {String} path The path of the .swf file
+   * @api public
+   */
+  setPath: function(path){
+    if (window.console && console.error) console.error('io.setPath will be removed. Please set the variable WEB_SOCKET_SWF_LOCATION pointing to WebSocketMain.swf');
+    this.path = /\/$/.test(path) ? path : path + '/';
     WEB_SOCKET_SWF_LOCATION = path + 'lib/vendor/web-socket-js/WebSocketMain.swf';
-	}
+  }
 };
 
+/**
+ * Expose Socket.IO in jQuery
+ */
 if ('jQuery' in this) jQuery.io = this.io;
 
+/**
+ * Default path to the .swf file.
+ */
 if (typeof window != 'undefined'){
   // WEB_SOCKET_SWF_LOCATION = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//cdn.socket.io/' + this.io.version + '/WebSocketMain.swf';
   if (typeof WEB_SOCKET_SWF_LOCATION === 'undefined')
     WEB_SOCKET_SWF_LOCATION = '/socket.io/lib/vendor/web-socket-js/WebSocketMain.swf';
-}
+}