{"action":"created","comment":{"url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/comments/32288787","id":32288787,"diff_hunk":"@@ -40,102 +40,159 @@ NS_CC_BEGIN\n  */\n \n /**\n- *@brief A inner node type mainly used for UI module.\n+ *@brief @~english A inner node type mainly used for UI module.\n  * It is useful for composing complex node type and it's children are protected.\n+ * @~chinese 主要用于UI模块的内部节点类型。\n+ * 用于组合出复杂的节点类型。所有的子节点都为 protected 成员数据。\n  */\n class  CC_DLL ProtectedNode : public Node\n {\n public:\n-    /**\n+    /**@~english\n      * Creates a ProtectedNode with no argument.\n-     *@return A instance of ProtectedNode.\n+     * @~chinese \n+     * 不使用参数创建一个ProtectedNode。\n+     *@return @~english A instance of ProtectedNode.\n+     * @~chinese ProtectedNode的实例。\n      */\n     static ProtectedNode * create(void);\n     \n     /// @{\n     /// @name Children and Parent\n     \n-    /**\n+    /**@~english\n      * Adds a child to the container with z-order as 0.\n      *\n      * If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.\n      *\n-     * @param child A child node\n+     * @~chinese \n+     * 以z值为0添加一个子节点。\n+     * \n+     * 如果当前节点正在运行，那么 'onEnter' 和 'onEnterTransitionDidFinish' 会被立即调用。\n+     * \n+     * @param child @~english A child node\n+     * @~chinese 一个子节点\n      */\n     virtual void addProtectedChild(Node * child);\n-    /**\n+    /**@~english\n      * Adds a child to the container with a local z-order.\n      *\n      * If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.\n      *\n-     * @param child     A child node\n-     * @param localZOrder    Z order for drawing priority. Please refer to `setLocalZOrder(int)`\n+     * @~chinese \n+     * 添加了与当前节点 z 值一致的子节点。\n+     * \n+     * 如果当前节点正在运行，那么 'onEnter' 和 'onEnterTransitionDidFinish' 会被立即调用。\n+     * \n+     * @param child     @~english A child node\n+     * @~chinese 一个子节点\n+     * @param localZOrder    @~english Z order for drawing priority. Please refer to `setLocalZOrder(int)`\n+     * @~chinese 用于控制绘制顺序的 z 值。请参阅`setLocalZOrder(int)`\n      */\n     virtual void addProtectedChild(Node * child, int localZOrder);\n-    /**\n+    /**@~english\n      * Adds a child to the container with z order and tag.\n      *\n      * If the child is added to a 'running' node, then 'onEnter' and 'onEnterTransitionDidFinish' will be called immediately.\n      *\n-     * @param child     A child node\n-     * @param localZOrder    Z order for drawing priority. Please refer to `setLocalZOrder(int)`\n-     * @param tag       An integer to identify the node easily. Please refer to `setTag(int)`\n+     * @~chinese \n+     * 指定 z 值和 tag 添加子节点\n+     * \n+     * 如果当前节点正在运行，那么 'onEnter' 和 'onEnterTransitionDidFinish' 会被立即调用。\n+     * \n+     * @param child     @~english A child node\n+     * @~chinese 一个子节点\n+     * @param localZOrder    @~english Z order for drawing priority. Please refer to `setLocalZOrder(int)`\n+     * @~chinese 用于控制绘制顺序的 z 值。请参阅`setLocalZOrder(int)`\n+     * @param tag       @~english An integer to identify the node easily. Please refer to `setTag(int)`\n+     * @~chinese 一个用于标识节点的整数。请参阅`setTag(int)`\n      */\n     virtual void addProtectedChild(Node* child, int localZOrder, int tag);\n-    /**\n+    /**@~english\n      * Gets a child from the container with its tag.\n      *\n-     * @param tag   An identifier to find the child node.\n+     * @~chinese \n+     * 通过 tag 值获取一个子节点。\n+     * \n+     * @param tag   @~english An identifier to find the child node.\n      *\n-     * @return a Node object whose tag equals to the input parameter.\n+     * @~chinese 一个用于标识节点的整数。\n+     * \n+     * @return @~english a Node object whose tag equals to the input parameter.\n+     * @~chinese tag 值与参数相同的子节点实例。\n      */\n     virtual Node * getProtectedChildByTag(int tag);\n     \n     ////// REMOVES //////\n     \n-    /**\n+    /**@~english\n      * Removes a child from the container. It will also cleanup all running actions depending on the cleanup parameter.\n      *\n-     * @param child     The child node which will be removed.\n-     * @param cleanup   true if all running actions and callbacks on the child node will be cleanup, false otherwise.\n+     * @~chinese \n+     * 删除一个子节点。可以通过设置 cleanup 的参数值清理所有正在运行的 action。\n+     * \n+     * @param child     @~english The child node which will be removed.\n+     * @~chinese 将被删除的子节点。\n+     * @param cleanup   @~english true if all running actions and callbacks on the child node will be cleanup, false otherwise.\n+     * @~chinese 如果为 true，将清理子节点相关的 action 和回调。\n      */\n     virtual void removeProtectedChild(Node* child, bool cleanup = true);\n     \n-    /**\n+    /**@~english\n      * Removes a child from the container by tag value. It will also cleanup all running actions depending on the cleanup parameter.\n      *\n-     * @param tag       An interger number that identifies a child node.\n-     * @param cleanup   true if all running actions and callbacks on the child node will be cleanup, false otherwise.\n+     * @~chinese \n+     * 通过 tag 值来删除子节点。可以通过设置 cleanup 的参数值清理所有正在运行的 action。\n+     * \n+     * @param tag       @~english An interger number that identifies a child node.\n+     * @~chinese 用于标识子节点的 tag 值。\n+     * @param cleanup   @~english true if all running actions and callbacks on the child node will be cleanup, false otherwise.\n+     * @~chinese 如果为 true，将清理子节点相关的 action 和回调。\n      */\n     virtual void removeProtectedChildByTag(int tag, bool cleanup = true);\n     \n-    /**\n+    /**@~english\n      * Removes all children from the container with a cleanup.\n      *\n+     * @~chinese \n+     * 移除所有子节点。\n+     * \n      * @see `removeAllChildrenWithCleanup(bool)`.\n      */\n     virtual void removeAllProtectedChildren();\n-    /**\n+    /**@~english\n      * Removes all children from the container, and do a cleanup to all running actions depending on the cleanup parameter.\n      *\n-     * @param cleanup   true if all running actions on all children nodes should be cleanup, false oterwise.\n+     * @~chinese \n+     * 移除所有子节点，并清理所有节点相关的操作。","path":"cocos/2d/CCProtectedNode.h","position":152,"original_position":152,"commit_id":"ed64ac203d40ec6f00d057c3d9ce7ffe02504ee3","original_commit_id":"ed64ac203d40ec6f00d057c3d9ce7ffe02504ee3","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":"为true时，清理所有节点相关操作。为false时，不清理。","created_at":"2015-06-12T03:51:31Z","updated_at":"2015-06-12T03:51:31Z","html_url":"https://github.com/cocos2d/cocos2d-x/pull/12114#discussion_r32288787","pull_request_url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12114","_links":{"self":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/comments/32288787"},"html":{"href":"https://github.com/cocos2d/cocos2d-x/pull/12114#discussion_r32288787"},"pull_request":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12114"}}},"pull_request":{"url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12114","id":36595254,"html_url":"https://github.com/cocos2d/cocos2d-x/pull/12114","diff_url":"https://github.com/cocos2d/cocos2d-x/pull/12114.diff","patch_url":"https://github.com/cocos2d/cocos2d-x/pull/12114.patch","issue_url":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/12114","number":12114,"state":"open","locked":false,"title":"Update comments.","user":{"login":"natural-law","id":488169,"avatar_url":"https://avatars.githubusercontent.com/u/488169?v=3","gravatar_id":"","url":"https://api.github.com/users/natural-law","html_url":"https://github.com/natural-law","followers_url":"https://api.github.com/users/natural-law/followers","following_url":"https://api.github.com/users/natural-law/following{/other_user}","gists_url":"https://api.github.com/users/natural-law/gists{/gist_id}","starred_url":"https://api.github.com/users/natural-law/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/natural-law/subscriptions","organizations_url":"https://api.github.com/users/natural-law/orgs","repos_url":"https://api.github.com/users/natural-law/repos","events_url":"https://api.github.com/users/natural-law/events{/privacy}","received_events_url":"https://api.github.com/users/natural-law/received_events","type":"User","site_admin":false},"body":"","created_at":"2015-06-01T02:29:30Z","updated_at":"2015-06-12T03:51:31Z","closed_at":null,"merged_at":null,"merge_commit_sha":"58df309406f63bf6b1c486468fd753709f931c89","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12114/commits","review_comments_url":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12114/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/12114/comments","statuses_url":"https://api.github.com/repos/cocos2d/cocos2d-x/statuses/ed64ac203d40ec6f00d057c3d9ce7ffe02504ee3","head":{"label":"natural-law:v3-doc","ref":"v3-doc","sha":"ed64ac203d40ec6f00d057c3d9ce7ffe02504ee3","user":{"login":"natural-law","id":488169,"avatar_url":"https://avatars.githubusercontent.com/u/488169?v=3","gravatar_id":"","url":"https://api.github.com/users/natural-law","html_url":"https://github.com/natural-law","followers_url":"https://api.github.com/users/natural-law/followers","following_url":"https://api.github.com/users/natural-law/following{/other_user}","gists_url":"https://api.github.com/users/natural-law/gists{/gist_id}","starred_url":"https://api.github.com/users/natural-law/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/natural-law/subscriptions","organizations_url":"https://api.github.com/users/natural-law/orgs","repos_url":"https://api.github.com/users/natural-law/repos","events_url":"https://api.github.com/users/natural-law/events{/privacy}","received_events_url":"https://api.github.com/users/natural-law/received_events","type":"User","site_admin":false},"repo":{"id":20007261,"name":"cocos2d-x","full_name":"natural-law/cocos2d-x","owner":{"login":"natural-law","id":488169,"avatar_url":"https://avatars.githubusercontent.com/u/488169?v=3","gravatar_id":"","url":"https://api.github.com/users/natural-law","html_url":"https://github.com/natural-law","followers_url":"https://api.github.com/users/natural-law/followers","following_url":"https://api.github.com/users/natural-law/following{/other_user}","gists_url":"https://api.github.com/users/natural-law/gists{/gist_id}","starred_url":"https://api.github.com/users/natural-law/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/natural-law/subscriptions","organizations_url":"https://api.github.com/users/natural-law/orgs","repos_url":"https://api.github.com/users/natural-law/repos","events_url":"https://api.github.com/users/natural-law/events{/privacy}","received_events_url":"https://api.github.com/users/natural-law/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/natural-law/cocos2d-x","description":"cocos2d-x for C++","fork":true,"url":"https://api.github.com/repos/natural-law/cocos2d-x","forks_url":"https://api.github.com/repos/natural-law/cocos2d-x/forks","keys_url":"https://api.github.com/repos/natural-law/cocos2d-x/keys{/key_id}","collaborators_url":"https://api.github.com/repos/natural-law/cocos2d-x/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/natural-law/cocos2d-x/teams","hooks_url":"https://api.github.com/repos/natural-law/cocos2d-x/hooks","issue_events_url":"https://api.github.com/repos/natural-law/cocos2d-x/issues/events{/number}","events_url":"https://api.github.com/repos/natural-law/cocos2d-x/events","assignees_url":"https://api.github.com/repos/natural-law/cocos2d-x/assignees{/user}","branches_url":"https://api.github.com/repos/natural-law/cocos2d-x/branches{/branch}","tags_url":"https://api.github.com/repos/natural-law/cocos2d-x/tags","blobs_url":"https://api.github.com/repos/natural-law/cocos2d-x/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/natural-law/cocos2d-x/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/natural-law/cocos2d-x/git/refs{/sha}","trees_url":"https://api.github.com/repos/natural-law/cocos2d-x/git/trees{/sha}","statuses_url":"https://api.github.com/repos/natural-law/cocos2d-x/statuses/{sha}","languages_url":"https://api.github.com/repos/natural-law/cocos2d-x/languages","stargazers_url":"https://api.github.com/repos/natural-law/cocos2d-x/stargazers","contributors_url":"https://api.github.com/repos/natural-law/cocos2d-x/contributors","subscribers_url":"https://api.github.com/repos/natural-law/cocos2d-x/subscribers","subscription_url":"https://api.github.com/repos/natural-law/cocos2d-x/subscription","commits_url":"https://api.github.com/repos/natural-law/cocos2d-x/commits{/sha}","git_commits_url":"https://api.github.com/repos/natural-law/cocos2d-x/git/commits{/sha}","comments_url":"https://api.github.com/repos/natural-law/cocos2d-x/comments{/number}","issue_comment_url":"https://api.github.com/repos/natural-law/cocos2d-x/issues/comments{/number}","contents_url":"https://api.github.com/repos/natural-law/cocos2d-x/contents/{+path}","compare_url":"https://api.github.com/repos/natural-law/cocos2d-x/compare/{base}...{head}","merges_url":"https://api.github.com/repos/natural-law/cocos2d-x/merges","archive_url":"https://api.github.com/repos/natural-law/cocos2d-x/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/natural-law/cocos2d-x/downloads","issues_url":"https://api.github.com/repos/natural-law/cocos2d-x/issues{/number}","pulls_url":"https://api.github.com/repos/natural-law/cocos2d-x/pulls{/number}","milestones_url":"https://api.github.com/repos/natural-law/cocos2d-x/milestones{/number}","notifications_url":"https://api.github.com/repos/natural-law/cocos2d-x/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/natural-law/cocos2d-x/labels{/name}","releases_url":"https://api.github.com/repos/natural-law/cocos2d-x/releases{/id}","created_at":"2014-05-21T03:57:40Z","updated_at":"2015-05-05T03:53:05Z","pushed_at":"2015-06-11T09:38:15Z","git_url":"git://github.com/natural-law/cocos2d-x.git","ssh_url":"git@github.com:natural-law/cocos2d-x.git","clone_url":"https://github.com/natural-law/cocos2d-x.git","svn_url":"https://github.com/natural-law/cocos2d-x","homepage":"http://www.cocos2d-x.org","size":934413,"stargazers_count":1,"watchers_count":1,"language":"C++","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":1,"default_branch":"v3"}},"base":{"label":"cocos2d:v3-doc","ref":"v3-doc","sha":"d2972e9dbd69f5192c856e7b6ba1b30a9b3e37b4","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-12T03:02:40Z","pushed_at":"2015-06-12T03:47:30Z","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":6030,"watchers_count":6030,"language":"C++","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":4355,"mirror_url":null,"open_issues_count":720,"forks":4355,"open_issues":720,"watchers":6030,"default_branch":"v3"}},"_links":{"self":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12114"},"html":{"href":"https://github.com/cocos2d/cocos2d-x/pull/12114"},"issue":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/12114"},"comments":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/issues/12114/comments"},"review_comments":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/pulls/12114/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/12114/commits"},"statuses":{"href":"https://api.github.com/repos/cocos2d/cocos2d-x/statuses/ed64ac203d40ec6f00d057c3d9ce7ffe02504ee3"}}}}