summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Silverstone <dsilvers@digital-scurf.org>2018-07-29 12:54:05 +0100
committerDaniel Silverstone <dsilvers@digital-scurf.org>2018-07-29 12:54:05 +0100
commitbf086809f141ba674ddc0cd05f4308b5e6433d12 (patch)
tree5cc918240ceece1a1a949996640d1fd6c348b833
parent200d016f47a3758e74c316941b4b5b24808a6dc3 (diff)
downloadlibdom-bf086809f141ba674ddc0cd05f4308b5e6433d12.tar.gz
libdom-bf086809f141ba674ddc0cd05f4308b5e6433d12.tar.bz2
Make API note that unreffing is up to the caller for dom_nodelist_item()
-rw-r--r--src/core/nodelist.c3
1 files changed, 3 insertions, 0 deletions
diff --git a/src/core/nodelist.c b/src/core/nodelist.c
index e2a1435..c549255 100644
--- a/src/core/nodelist.c
+++ b/src/core/nodelist.c
@@ -298,6 +298,9 @@ dom_exception dom_nodelist_get_length(dom_nodelist *list, uint32_t *length)
*
* The returned node will have had its reference count increased. The client
* should unref the node once it has finished with it.
+ *
+ * NOTE: If \ref node contains a node pointer already, it will *NOT* be
+ * unreffed. Managing the lifetime of that is up to the caller.
*/
dom_exception _dom_nodelist_item(dom_nodelist *list,
uint32_t index, dom_node **node)