add comment for longlink_packer function

fix xlogSample build error

Author: shockcao

mars/stn/proto/longlink_packer.h

@@ -12,7 +12,7 @@
 
 
 /*
- * longlink_packer.cpp
+ * longlink_packer.h
  *
  *  Created on: 2012-7-18
  *      Author: yerungui
@@ -34,7 +34,24 @@
 
 class AutoBuffer;
 
+/**
+ * package the request data
+ * _cmdid: business identifier
+ * _seq: task id
+ * _raw: business send buffer
+ * _packed: business send buffer + request header
+ */
 void longlink_pack(uint32_t _cmdid, uint32_t _seq, const void* _raw, size_t _raw_len, AutoBuffer& _packed);
+
+/**
+ * unpackage the response data
+ * _packed: data received from server
+ * _cmdid: business identifier
+ * _seq: task id
+ * _package_len:
+ * _body: business receive buffer
+ * return: 0 if unpackage succ
+ */
 int  longlink_unpack(const AutoBuffer& _packed, uint32_t& _cmdid, uint32_t& _seq, size_t& _package_len, AutoBuffer& _body);
 
 //heartbeat signal to keep longlink network alive
@@ -47,6 +64,10 @@ void longlink_noop_resp_body(AutoBuffer& _body);
 uint32_t longlink_noop_interval();
 
 bool longlink_complexconnect_need_verify();
+
+/**
+ * return: whether the received data is pushing from server or not
+ */
 bool is_push_data(uint32_t _cmdid, uint32_t _taskid);
 
 #endif // STN_SRC_LONGLINKPACKER_H_

samples/android/xlogSample/build.gradle

@@ -26,7 +26,7 @@ task clean(type: Delete) {
 
 ext {
     GROUP = 'com.tencent.mars'
-    VERSION_NAME = '1.0.1'
+    VERSION_NAME = '1.0.2'
     VERSION_NAME_SUFFIX = ''
 }