From bf086809f141ba674ddc0cd05f4308b5e6433d12 Mon Sep 17 00:00:00 2001 From: Daniel Silverstone Date: Sun, 29 Jul 2018 12:54:05 +0100 Subject: Make API note that unreffing is up to the caller for dom_nodelist_item() --- src/core/nodelist.c | 3 +++ 1 file changed, 3 insertions(+) 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) -- cgit v1.2.3