<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">
Hi, WIllem,
<div><br>
</div>
<div>Could it be that the mailing list isn’t reaching you? I did see this mail.</div>
<div><br>
</div>
<div>Thank you for the extremely hard work you are doing! </div>
<div><br>
</div>
<div>Allison<br>
<div><br>
<div>Begin forwarded message:</div>
<br class="Apple-interchange-newline">
<blockquote type="cite">
<div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px;">
<span style="font-family:'Helvetica'; color:rgba(0, 0, 0, 1.0);"><b>From: </b></span><span style="font-family:'Helvetica';">Willem Toorop <<a href="mailto:willem@nlnetlabs.nl">willem@nlnetlabs.nl</a>><br>
</span></div>
<div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px;">
<span style="font-family:'Helvetica'; color:rgba(0, 0, 0, 1.0);"><b>Subject: </b>
</span><span style="font-family:'Helvetica';"><b>[getdns-api] Destroy names from</b><br>
</span></div>
<div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px;">
<span style="font-family:'Helvetica'; color:rgba(0, 0, 0, 1.0);"><b>Date: </b></span><span style="font-family:'Helvetica';">October 24, 2014 at 3:11:13 AM PDT<br>
</span></div>
<div style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px;">
<span style="font-family:'Helvetica'; color:rgba(0, 0, 0, 1.0);"><b>To: </b></span><span style="font-family:'Helvetica';">"<a href="mailto:getdns-api@vpnc.org">getdns-api@vpnc.org</a>" <<a href="mailto:getdns-api@vpnc.org">getdns-api@vpnc.org</a>><br>
</span></div>
<br>
<div>Dear list,<br>
<br>
In he last paragraph of section 2. "Data structures in the API", is the<br>
following:<br>
<br>
<span class="Apple-tab-span" style="white-space:pre"></span>"The helper getter functions return references to getdns_dict,<br>
getdns_list and getdns_bindata data structures. The user must not<br>
directly destroy these retrieved "child" data structures; instead, they<br>
will automatically be destroyed when the containing "parent" data<br>
structure is destroyed. Because of this, retrieved "child" data<br>
structures cannot be used any more after the containing "parent" data<br>
structure has been destroyed."<br>
<br>
This is true in our implementation except for the getdns_dict_get_names<br>
helper function that returns a newly created list containing all the<br>
names in the dict.<br>
<br>
We would like to insert a paragraph before the last paragraph so that<br>
the last two paragraphs of section two will be:<br>
<br>
<span class="Apple-tab-span" style="white-space:pre"></span>"The getdns_dict_get_names helper function creates a newly created list<br>
containing the names in a dict. The caller is responsible for disposing<br>
this list.<br>
<br>
<span class="Apple-tab-span" style="white-space:pre"></span>Except for getdns_dict_get_names, all the helper getter functions<br>
return references to getdns_dict, getdns_list and getdns_bindata data<br>
structures. The user must not directly destroy these retrieved "child"<br>
data structures; instead, they will automatically be destroyed when the<br>
containing "parent" data structure is destroyed. Because of this,<br>
retrieved "child" data structures cannot be used any more after the<br>
containing "parent" data structure has been destroyed."<br>
<br>
OK? Comments/improvements welcome.<br>
<br>
-- Willem<br>
_______________________________________________<br>
getdns-api mailing list<br>
<a href="mailto:getdns-api@vpnc.org">getdns-api@vpnc.org</a><br>
</div>
</blockquote>
</div>
<br>
</div>
</body>
</html>