Add and clean doc, update version number

Makefile

@@ -24,7 +24,7 @@ SHELL = /bin/sh
 .PHONY: clean, mkdir, install, uninstall, html
 
 ifndef release.version
-  release.version = 1.0.3
+  release.version = 1.1.0
 endif
 
 # determine current platform

build.xml

@@ -24,7 +24,7 @@
   </taskdef>
 
   <property name="output.folder" value="build/output" /> 
-  <property name="release.version" value="1.0.3" />
+  <property name="release.version" value="1.1.0" />
 
   <property name="libname" value="mqttv3c" />
   <property name="libname.ssl" value="mqttv3cs" />
@@ -93,11 +93,10 @@
     <if>
       <os family="windows"/>
     <then>
-		<!-- TODO: build test2 for windows -->
-    	<foreach target="runAtest" param="aTest" list="test1,test2,test4,test9"/>
-	  </then>
+      <foreach target="runAtest" param="aTest" list="test1,test2,test4,test9"/>
+    </then>
     <else>
-	    <foreach target="runAtest" param="aTest" list="test9,test1,test2,test4"/>
+      <foreach target="runAtest" param="aTest" list="test1,test2,test4,test9"/>
     </else>
     </if>
     <foreach target="runSSLtest" param="aTest" list="test3,test5"/>

issue2_notes

-
-
-Issue 2 - offline buffering and automatic reconnect
-
-if we don't have automatic reconnect and we don't successfully connect, then ...
-
-offline buffering implies automatic reconnect?
-
-is it worth having automatic reconnect without offline buffering?
-
-should automatic reconnect even be offered separately? 
\ No newline at end of file

src/MQTTAsync.h

@@ -151,13 +151,13 @@
  * Return code: All 65535 MQTT msgids are being used
  */
 #define MQTTASYNC_NO_MORE_MSGIDS -10
- /**
-  * Return code: the request is being discarded when not complete
-  */
+/**
+ * Return code: the request is being discarded when not complete
+ */
 #define MQTTASYNC_OPERATION_INCOMPLETE -11
- /**
-  * Return code: the request is being discarded when not complete
-  */
+/**
+ * Return code: no more messages can be buffered
+ */
 #define MQTTASYNC_MAX_BUFFERED_MESSAGES -12
 
 /**
@@ -464,11 +464,29 @@ DLLExport int MQTTAsync_setCallbacks(MQTTAsync handle, void* context, MQTTAsync_
 									MQTTAsync_messageArrived* ma, MQTTAsync_deliveryComplete* dc);
 
 
-
-
+/**
+ * Sets the MQTTAsync_connected() callback function for a client.
+ * @param handle A valid client handle from a successful call to
+ * MQTTAsync_create(). 
+ * @param context A pointer to any application-specific context. The
+ * the <i>context</i> pointer is passed to each of the callback functions to
+ * provide access to the context information in the callback.
+ * @param co A pointer to an MQTTAsync_connected() callback
+ * function.  NULL removes the callback setting.
+ * @return ::MQTTASYNC_SUCCESS if the callbacks were correctly set,
+ * ::MQTTASYNC_FAILURE if an error occurred.
+ */
 DLLExport int MQTTAsync_setConnected(MQTTAsync handle, void* context, MQTTAsync_connected* co);
 
 
+/**
+ * Reconnects a client with the previously used connect options.  Connect
+ * must have previously been called for this to work.
+ * @param handle A valid client handle from a successful call to
+ * MQTTAsync_create(). 
+ * @return ::MQTTASYNC_SUCCESS if the callbacks were correctly set,
+ * ::MQTTASYNC_FAILURE if an error occurred.
+ */
 DLLExport int MQTTAsync_reconnect(MQTTAsync handle);