- * Gets the closes ancestor node of a specified node name.\r
- * @param {String} name Node name of ancestor node.\r
- * @param {Boolean} includeSelf (Optional) Whether to include the current\r
- * node in the calculation or not.\r
- * @returns {CKEDITOR.dom.node} Ancestor node.\r
+ * Gets the closest ancestor node of this node, specified by its node name.\r
+ * @param {String} name The node name of the ancestor node to search.\r
+ * @param {Boolean} [includeSelf] Whether to include the current\r
+ * node in the search.\r
+ * @returns {CKEDITOR.dom.node} The located ancestor node or null if not found.\r
+ * @example\r
+ * // Suppose we have the following HTML:\r
+ * // <div id="outer"><div id="inner"><p><b>Some text</b></p></div></div>\r
+ * // If node == <b>\r
+ * ascendant = node.getAscendant( 'div' ); // ascendant == <div id="inner">\r
+ * ascendant = node.getAscendant( 'b' ); // ascendant == null\r
+ * ascendant = node.getAscendant( 'b', true ); // ascendant == <b>\r