Fwd: [getdns-api] Destroy names from

[Mankin, Allison]

Hi, WIllem,

Could it be that the mailing list isn’t reaching you?  I did see this mail.

Thank you for the extremely hard work you are doing!

Allison

Begin forwarded message:

From: Willem Toorop <willem at nlnetlabs.nl<mailto:willem at nlnetlabs.nl>>
Subject: [getdns-api] Destroy names from
Date: October 24, 2014 at 3:11:13 AM PDT
To: "getdns-api at vpnc.org<mailto:getdns-api at vpnc.org>" <getdns-api at vpnc.org<mailto:getdns-api at vpnc.org>>

Dear list,

In he last paragraph of section 2. "Data structures in the API", is the
following:

"The helper getter functions return references to getdns_dict,
getdns_list and getdns_bindata data structures. The user must not
directly destroy these retrieved "child" data structures; instead, they
will automatically be destroyed when the containing "parent" data
structure is destroyed. Because of this, retrieved "child" data
structures cannot be used any more after the containing "parent" data
structure has been destroyed."

This is true in our implementation except for the getdns_dict_get_names
helper function that returns a newly created list containing all the
names in the dict.

We would like to insert a paragraph before the last paragraph so that
the last two paragraphs of section two will be:

"The getdns_dict_get_names helper function creates a newly created list
containing the names in a dict.  The caller is responsible for disposing
this list.

Except for getdns_dict_get_names, all the helper getter functions
return references to getdns_dict, getdns_list and getdns_bindata data
structures. The user must not directly destroy these retrieved "child"
data structures; instead, they will automatically be destroyed when the
containing "parent" data structure is destroyed. Because of this,
retrieved "child" data structures cannot be used any more after the
containing "parent" data structure has been destroyed."

OK?  Comments/improvements welcome.

-- Willem
_______________________________________________
getdns-api mailing list
getdns-api at vpnc.org<mailto:getdns-api at vpnc.org>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://getdnsapi.net/pipermail/spec/attachments/20141028/0d6cc842/attachment.html>