{"action":"created","comment":{"url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/comments/32296083","id":32296083,"diff_hunk":"@@ -46,122 +46,202 @@ namespace network {\n     \n \n \n-/** Singleton that handles asynchrounous http requests.\n+/** @~english Singleton that handles asynchronous http requests.\n  *\n- * Once the request completed, a callback will issued in main thread when it provided during make request.\n+ * Once the request completed, a callback will be issued in main thread when it provided during make request.\n  *\n+ * @~chinese 用于处理异步http请求的单例。\n+ *\n+ * 一旦完成一个请求,将设置一个主线程中调用的回调函数用来进行请求返回处理。\n+ * \n  * @lua NA\n  */\n class CC_DLL HttpClient\n {\n public:\n-\t/**\n+\t/**@~english\n \t* The buffer size of _responseMessage\n+    * @~chinese \n+    * _responseMessage的缓存大小\n \t*/\n \tstatic const int RESPONSE_BUFFER_SIZE = 256;\n \n-    /**\n+    /**@~english\n      * Get instance of HttpClient.\n      *\n-     * @return the instance of HttpClient.\n+     * @~chinese \n+     * HttpClient的实例。\n+     * \n+     * @return @~english the instance of HttpClient.\n+     * @~chinese HttpClient实例。\n      */\n     static HttpClient *getInstance();\n     \n-    /** \n-     * Relase the instance of HttpClient. \n+    /** @~english\n+     * Destroy the instance of HttpClient. \n+     * @~chinese \n+     * 销毁HttpClient实例。\n      */\n     static void destroyInstance();\n \n-    /** \n+    /** @~english\n      * Enable cookie support.\n      *\n-     * @param cookieFile the filepath of cookie file.\n+     * @~chinese \n+     * 启用cookie支持。\n+     * \n+     * @param cookieFile @~english the filepath of cookie file.\n+     * @~chinese cookie文件的文件名。\n      */\n     void enableCookies(const char* cookieFile);\n     \n-    /**\n+    /**@~english\n      * Get the cookie filename\n      * \n-     * @return the cookie filename\n+     * @~chinese \n+     * 获取Cookie文件名\n+     * \n+     * @return @~english the cookie filename\n+     * @~chinese Cookie文件名\n      */\n     const std::string& getCookieFilename();\n     \n-    /**\n+    /**@~english\n      * Set root certificate path for SSL verification.\n      *\n-     * @param caFile a full path of root certificate.if it is empty, SSL verification is disabled.\n+     * @~chinese \n+     * 设置SSL证书路径。\n+     * \n+     * @param caFile @~english a full path of root certificate.if it is empty, SSL verification is disabled.\n+     * @~chinese SSL证书的全路径，如果这个值为空, SSL验证将不起效。\n      */\n     void setSSLVerification(const std::string& caFile);\n     \n-    /**\n-     * Get ths ssl CA filename\n+    /**@~english\n+     * Get ths SSL CA filename\n+     * \n+     * @~chinese \n+     * 获怪SSL证书的文件名\n      * \n-     * @return the ssl CA filename\n+     * @return @~english the SSL CA filename\n+     * @~chinese SSL证书文件名\n      */\n     const std::string& getSSLVerification();\n         \n-    /**\n-     * Add a get request to task queue\n+    /**@~english\n+     * Add a request to task queue\n      *\n-     * @param request a HttpRequest object, which includes url, response callback etc.\n-                      please make sure request->_requestData is clear before calling \"send\" here.\n+     * @~chinese \n+     * 添加一个request到任务队列中\n+     * \n+     * @param request @~english a HttpRequest object, which includes url, response callback etc.\n+     * @~chinese 一个HttpRequest对象,包括url,响应回调等。\n      */\n     void send(HttpRequest* request);\n \n-    /**\n+    /**@~english\n      * Immediate send a request\n      *\n-     * @param request a HttpRequest object, which includes url, response callback etc.\n-                      please make sure request->_requestData is clear before calling \"sendImmediate\" here.\n+     * @~chinese \n+     * 立即发送一个request\n+     * \n+     * @param request @~english a HttpRequest object, which includes url, response callback etc.\n+     * @~chinese HttpRequest对象,包括url,响应回调等。\n      */\n     void sendImmediate(HttpRequest* request);\n     \n-    /**\n+    /**@~english\n      * Set the timeout value for connecting.\n      *\n-     * @param value the timeout value for connecting.\n+     * @~chinese \n+     * 设置连接超时时间。\n+     * \n+     * @param value @~english the timeout value for connecting.\n+     * @~chinese 连接超时时间。\n      */\n     void setTimeoutForConnect(int value);\n     \n-    /**\n+    /**@~english\n      * Get the timeout value for connecting.\n      *\n-     * @return int the timeout value for connecting.\n+     * @~chinese \n+     * 获取连接超时时间。\n+     * \n+     * @return @~english the timeout value for connecting.\n+     * @~chinese 连接超时时间。\n      */\n     int getTimeoutForConnect();","path":"cocos/network/HttpClient.h","position":155,"original_position":155,"commit_id":"24adad0191c1f8f498420931eba1798aa0b15afd","original_commit_id":"24adad0191c1f8f498420931eba1798aa0b15afd","user":{"login":"jianglong0156","id":3940568,"avatar_url":"https://avatars.githubusercontent.com/u/3940568?v=3","gravatar_id":"","url":"https://api.github.com/users/jianglong0156","html_url":"https://github.com/jianglong0156","followers_url":"https://api.github.com/users/jianglong0156/followers","following_url":"https://api.github.com/users/jianglong0156/following{/other_user}","gists_url":"https://api.github.com/users/jianglong0156/gists{/gist_id}","starred_url":"https://api.github.com/users/jianglong0156/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jianglong0156/subscriptions","organizations_url":"https://api.github.com/users/jianglong0156/orgs","repos_url":"https://api.github.com/users/jianglong0156/repos","events_url":"https://api.github.com/users/jianglong0156/events{/privacy}","received_events_url":"https://api.github.com/users/jianglong0156/received_events","type":"User","site_admin":false},"body":"需要标记时间单位","created_at":"2015-06-12T07:48:45Z","updated_at":"2015-06-12T07:48:45Z","html_url":"https://github.com/cocos2d/cocos2d-x/pull/12312#discussion_r32296083","pull_request_url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12312","_links":{"self":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/comments/32296083"},"html":{"href":"https://github.com/cocos2d/cocos2d-x/pull/12312#discussion_r32296083"},"pull_request":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12312"}}},"pull_request":{"url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12312","id":37537301,"html_url":"https://github.com/cocos2d/cocos2d-x/pull/12312","diff_url":"https://github.com/cocos2d/cocos2d-x/pull/12312.diff","patch_url":"https://github.com/cocos2d/cocos2d-x/pull/12312.patch","issue_url":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/12312","number":12312,"state":"open","locked":false,"title":"Add chinese comments for http","user":{"login":"samuele3hu","id":4231014,"avatar_url":"https://avatars.githubusercontent.com/u/4231014?v=3","gravatar_id":"","url":"https://api.github.com/users/samuele3hu","html_url":"https://github.com/samuele3hu","followers_url":"https://api.github.com/users/samuele3hu/followers","following_url":"https://api.github.com/users/samuele3hu/following{/other_user}","gists_url":"https://api.github.com/users/samuele3hu/gists{/gist_id}","starred_url":"https://api.github.com/users/samuele3hu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/samuele3hu/subscriptions","organizations_url":"https://api.github.com/users/samuele3hu/orgs","repos_url":"https://api.github.com/users/samuele3hu/repos","events_url":"https://api.github.com/users/samuele3hu/events{/privacy}","received_events_url":"https://api.github.com/users/samuele3hu/received_events","type":"User","site_admin":false},"body":"","created_at":"2015-06-12T07:11:48Z","updated_at":"2015-06-12T07:48:45Z","closed_at":null,"merged_at":null,"merge_commit_sha":"f745457f8877a3a7f610f7f8183cc86297b07e27","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12312/commits","review_comments_url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12312/comments","review_comment_url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/comments{/number}","comments_url":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/12312/comments","statuses_url":"https://api.github.com/repos/cocos2d/cocos2d-x/statuses/24adad0191c1f8f498420931eba1798aa0b15afd","head":{"label":"samuele3hu:v3_http_doc","ref":"v3_http_doc","sha":"24adad0191c1f8f498420931eba1798aa0b15afd","user":{"login":"samuele3hu","id":4231014,"avatar_url":"https://avatars.githubusercontent.com/u/4231014?v=3","gravatar_id":"","url":"https://api.github.com/users/samuele3hu","html_url":"https://github.com/samuele3hu","followers_url":"https://api.github.com/users/samuele3hu/followers","following_url":"https://api.github.com/users/samuele3hu/following{/other_user}","gists_url":"https://api.github.com/users/samuele3hu/gists{/gist_id}","starred_url":"https://api.github.com/users/samuele3hu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/samuele3hu/subscriptions","organizations_url":"https://api.github.com/users/samuele3hu/orgs","repos_url":"https://api.github.com/users/samuele3hu/repos","events_url":"https://api.github.com/users/samuele3hu/events{/privacy}","received_events_url":"https://api.github.com/users/samuele3hu/received_events","type":"User","site_admin":false},"repo":{"id":9614668,"name":"cocos2d-x","full_name":"samuele3hu/cocos2d-x","owner":{"login":"samuele3hu","id":4231014,"avatar_url":"https://avatars.githubusercontent.com/u/4231014?v=3","gravatar_id":"","url":"https://api.github.com/users/samuele3hu","html_url":"https://github.com/samuele3hu","followers_url":"https://api.github.com/users/samuele3hu/followers","following_url":"https://api.github.com/users/samuele3hu/following{/other_user}","gists_url":"https://api.github.com/users/samuele3hu/gists{/gist_id}","starred_url":"https://api.github.com/users/samuele3hu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/samuele3hu/subscriptions","organizations_url":"https://api.github.com/users/samuele3hu/orgs","repos_url":"https://api.github.com/users/samuele3hu/repos","events_url":"https://api.github.com/users/samuele3hu/events{/privacy}","received_events_url":"https://api.github.com/users/samuele3hu/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/samuele3hu/cocos2d-x","description":"cocos2d for iOS, Android, Win32 and OS X. Built using C++","fork":true,"url":"https://api.github.com/repos/samuele3hu/cocos2d-x","forks_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/forks","keys_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/keys{/key_id}","collaborators_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/teams","hooks_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/hooks","issue_events_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/issues/events{/number}","events_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/events","assignees_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/assignees{/user}","branches_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/branches{/branch}","tags_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/tags","blobs_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/git/refs{/sha}","trees_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/git/trees{/sha}","statuses_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/statuses/{sha}","languages_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/languages","stargazers_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/stargazers","contributors_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/contributors","subscribers_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/subscribers","subscription_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/subscription","commits_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/commits{/sha}","git_commits_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/git/commits{/sha}","comments_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/comments{/number}","issue_comment_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/issues/comments{/number}","contents_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/contents/{+path}","compare_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/compare/{base}...{head}","merges_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/merges","archive_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/downloads","issues_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/issues{/number}","pulls_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/pulls{/number}","milestones_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/milestones{/number}","notifications_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/labels{/name}","releases_url":"https://api.github.com/repos/samuele3hu/cocos2d-x/releases{/id}","created_at":"2013-04-23T03:53:06Z","updated_at":"2014-06-25T09:19:15Z","pushed_at":"2015-06-12T03:01:48Z","git_url":"git://github.com/samuele3hu/cocos2d-x.git","ssh_url":"git@github.com:samuele3hu/cocos2d-x.git","clone_url":"https://github.com/samuele3hu/cocos2d-x.git","svn_url":"https://github.com/samuele3hu/cocos2d-x","homepage":"http://www.cocos2d-x.org","size":969479,"stargazers_count":0,"watchers_count":0,"language":"C","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"cocos2d:v3-doc","ref":"v3-doc","sha":"0bb7fb9c93de91713f1f2288cfb6b9d68b6196f1","user":{"login":"cocos2d","id":234324,"avatar_url":"https://avatars.githubusercontent.com/u/234324?v=3","gravatar_id":"","url":"https://api.github.com/users/cocos2d","html_url":"https://github.com/cocos2d","followers_url":"https://api.github.com/users/cocos2d/followers","following_url":"https://api.github.com/users/cocos2d/following{/other_user}","gists_url":"https://api.github.com/users/cocos2d/gists{/gist_id}","starred_url":"https://api.github.com/users/cocos2d/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cocos2d/subscriptions","organizations_url":"https://api.github.com/users/cocos2d/orgs","repos_url":"https://api.github.com/users/cocos2d/repos","events_url":"https://api.github.com/users/cocos2d/events{/privacy}","received_events_url":"https://api.github.com/users/cocos2d/received_events","type":"Organization","site_admin":false},"repo":{"id":1093228,"name":"cocos2d-x","full_name":"cocos2d/cocos2d-x","owner":{"login":"cocos2d","id":234324,"avatar_url":"https://avatars.githubusercontent.com/u/234324?v=3","gravatar_id":"","url":"https://api.github.com/users/cocos2d","html_url":"https://github.com/cocos2d","followers_url":"https://api.github.com/users/cocos2d/followers","following_url":"https://api.github.com/users/cocos2d/following{/other_user}","gists_url":"https://api.github.com/users/cocos2d/gists{/gist_id}","starred_url":"https://api.github.com/users/cocos2d/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cocos2d/subscriptions","organizations_url":"https://api.github.com/users/cocos2d/orgs","repos_url":"https://api.github.com/users/cocos2d/repos","events_url":"https://api.github.com/users/cocos2d/events{/privacy}","received_events_url":"https://api.github.com/users/cocos2d/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/cocos2d/cocos2d-x","description":"cocos2d-x for C++","fork":false,"url":"https://api.github.com/repos/cocos2d/cocos2d-x","forks_url":"https://api.github.com/repos/cocos2d/cocos2d-x/forks","keys_url":"https://api.github.com/repos/cocos2d/cocos2d-x/keys{/key_id}","collaborators_url":"https://api.github.com/repos/cocos2d/cocos2d-x/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/cocos2d/cocos2d-x/teams","hooks_url":"https://api.github.com/repos/cocos2d/cocos2d-x/hooks","issue_events_url":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/events{/number}","events_url":"https://api.github.com/repos/cocos2d/cocos2d-x/events","assignees_url":"https://api.github.com/repos/cocos2d/cocos2d-x/assignees{/user}","branches_url":"https://api.github.com/repos/cocos2d/cocos2d-x/branches{/branch}","tags_url":"https://api.github.com/repos/cocos2d/cocos2d-x/tags","blobs_url":"https://api.github.com/repos/cocos2d/cocos2d-x/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/cocos2d/cocos2d-x/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/cocos2d/cocos2d-x/git/refs{/sha}","trees_url":"https://api.github.com/repos/cocos2d/cocos2d-x/git/trees{/sha}","statuses_url":"https://api.github.com/repos/cocos2d/cocos2d-x/statuses/{sha}","languages_url":"https://api.github.com/repos/cocos2d/cocos2d-x/languages","stargazers_url":"https://api.github.com/repos/cocos2d/cocos2d-x/stargazers","contributors_url":"https://api.github.com/repos/cocos2d/cocos2d-x/contributors","subscribers_url":"https://api.github.com/repos/cocos2d/cocos2d-x/subscribers","subscription_url":"https://api.github.com/repos/cocos2d/cocos2d-x/subscription","commits_url":"https://api.github.com/repos/cocos2d/cocos2d-x/commits{/sha}","git_commits_url":"https://api.github.com/repos/cocos2d/cocos2d-x/git/commits{/sha}","comments_url":"https://api.github.com/repos/cocos2d/cocos2d-x/comments{/number}","issue_comment_url":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/comments{/number}","contents_url":"https://api.github.com/repos/cocos2d/cocos2d-x/contents/{+path}","compare_url":"https://api.github.com/repos/cocos2d/cocos2d-x/compare/{base}...{head}","merges_url":"https://api.github.com/repos/cocos2d/cocos2d-x/merges","archive_url":"https://api.github.com/repos/cocos2d/cocos2d-x/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/cocos2d/cocos2d-x/downloads","issues_url":"https://api.github.com/repos/cocos2d/cocos2d-x/issues{/number}","pulls_url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls{/number}","milestones_url":"https://api.github.com/repos/cocos2d/cocos2d-x/milestones{/number}","notifications_url":"https://api.github.com/repos/cocos2d/cocos2d-x/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/cocos2d/cocos2d-x/labels{/name}","releases_url":"https://api.github.com/repos/cocos2d/cocos2d-x/releases{/id}","created_at":"2010-11-18T23:17:00Z","updated_at":"2015-06-12T07:28:31Z","pushed_at":"2015-06-12T07:47:01Z","git_url":"git://github.com/cocos2d/cocos2d-x.git","ssh_url":"git@github.com:cocos2d/cocos2d-x.git","clone_url":"https://github.com/cocos2d/cocos2d-x.git","svn_url":"https://github.com/cocos2d/cocos2d-x","homepage":"http://www.cocos2d-x.org","size":1489440,"stargazers_count":6031,"watchers_count":6031,"language":"C++","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":4355,"mirror_url":null,"open_issues_count":723,"forks":4355,"open_issues":723,"watchers":6031,"default_branch":"v3"}},"_links":{"self":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12312"},"html":{"href":"https://github.com/cocos2d/cocos2d-x/pull/12312"},"issue":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/12312"},"comments":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/12312/comments"},"review_comments":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12312/comments"},"review_comment":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12312/commits"},"statuses":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/statuses/24adad0191c1f8f498420931eba1798aa0b15afd"}}}}