Gitweb links:
...log
http://git.netsurf-browser.org/libdom.git/shortlog/78cd9ec509366e8a1fd61f077aba3a6537255ad1
...commit
http://git.netsurf-browser.org/libdom.git/commit/78cd9ec509366e8a1fd61f077aba3a6537255ad1
...tree
http://git.netsurf-browser.org/libdom.git/tree/78cd9ec509366e8a1fd61f077aba3a6537255ad1
The branch, master has been updated
via 78cd9ec509366e8a1fd61f077aba3a6537255ad1 (commit)
from 99e5503a28fbb754422086d140cdf030a66497c7 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commitdiff
http://git.netsurf-browser.org/libdom.git/commit/?id=78cd9ec509366e8a1fd61f077aba3a6537255ad1
commit 78cd9ec509366e8a1fd61f077aba3a6537255ad1
Author: Michael Drake <[email protected]>
Commit: Michael Drake <[email protected]>
Element: API docs: Reword based on review.
diff --git a/src/core/element.c b/src/core/element.c
index a3d9ee7..66d0390 100644
--- a/src/core/element.c
+++ b/src/core/element.c
@@ -1232,9 +1232,12 @@ dom_exception _dom_element_has_class(struct dom_element
*element,
/**
* Get a named ancestor node
*
+ * If the caller wants to keep the returned node around, it must take its
+ * own ref. This call returns a borrow.
+ *
* \param element Element to consider
* \param name Node name to look for
- * \param ancestor Pointer to location to receive unreffed node pointer
+ * \param parent Pointer to location to receive borrowed node pointer
* \return DOM_NO_ERR.
*/
dom_exception dom_element_named_ancestor_node(dom_element *element,
@@ -1262,9 +1265,12 @@ dom_exception
dom_element_named_ancestor_node(dom_element *element,
/**
* Get a named parent node
*
+ * If the caller wants to keep the returned node around, it must take its
+ * own ref. This call returns a borrow.
+ *
* \param element Element to consider
* \param name Node name to look for
- * \param parent Pointer to location to receive unreffed node pointer
+ * \param parent Pointer to location to receive borrowed node pointer
* \return DOM_NO_ERR.
*/
dom_exception dom_element_named_parent_node(dom_element *element,
@@ -1292,9 +1298,12 @@ dom_exception dom_element_named_parent_node(dom_element
*element,
/**
* Get a named parent node
*
+ * If the caller wants to keep the returned node around, it must take its
+ * own ref. This call returns a borrow.
+ *
* \param element Element to consider
* \param name Node name to look for
- * \param parent Pointer to location to receive unreffed node pointer
+ * \param parent Pointer to location to receive borrowed node pointer
* \return DOM_NO_ERR.
*/
dom_exception dom_element_parent_node(dom_element *element,
-----------------------------------------------------------------------
Summary of changes:
src/core/element.c | 15 ++++++++++++---
1 file changed, 12 insertions(+), 3 deletions(-)
diff --git a/src/core/element.c b/src/core/element.c
index a3d9ee7..66d0390 100644
--- a/src/core/element.c
+++ b/src/core/element.c
@@ -1232,9 +1232,12 @@ dom_exception _dom_element_has_class(struct dom_element
*element,
/**
* Get a named ancestor node
*
+ * If the caller wants to keep the returned node around, it must take its
+ * own ref. This call returns a borrow.
+ *
* \param element Element to consider
* \param name Node name to look for
- * \param ancestor Pointer to location to receive unreffed node pointer
+ * \param parent Pointer to location to receive borrowed node pointer
* \return DOM_NO_ERR.
*/
dom_exception dom_element_named_ancestor_node(dom_element *element,
@@ -1262,9 +1265,12 @@ dom_exception
dom_element_named_ancestor_node(dom_element *element,
/**
* Get a named parent node
*
+ * If the caller wants to keep the returned node around, it must take its
+ * own ref. This call returns a borrow.
+ *
* \param element Element to consider
* \param name Node name to look for
- * \param parent Pointer to location to receive unreffed node pointer
+ * \param parent Pointer to location to receive borrowed node pointer
* \return DOM_NO_ERR.
*/
dom_exception dom_element_named_parent_node(dom_element *element,
@@ -1292,9 +1298,12 @@ dom_exception dom_element_named_parent_node(dom_element
*element,
/**
* Get a named parent node
*
+ * If the caller wants to keep the returned node around, it must take its
+ * own ref. This call returns a borrow.
+ *
* \param element Element to consider
* \param name Node name to look for
- * \param parent Pointer to location to receive unreffed node pointer
+ * \param parent Pointer to location to receive borrowed node pointer
* \return DOM_NO_ERR.
*/
dom_exception dom_element_parent_node(dom_element *element,
--
Document Object Model library
_______________________________________________
netsurf-commits mailing list -- [email protected]
To unsubscribe send an email to [email protected]
