Just saw the docs here have been updated - <a href="http://api.drupal.org/api/group/database/7">http://api.drupal.org/api/group/database/7</a> - this could do with a link to the handbook section too though probably.<br><br>
Nat<br><br><div class="gmail_quote">On Thu, Dec 18, 2008 at 4:28 AM, Larry Garfield <span dir="ltr"><<a href="mailto:larry@garfieldtech.com">larry@garfieldtech.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div class="Ih2E3d">On Wednesday 17 December 2008 11:02:29 am you wrote:<br>
> Hi Larry,<br>
><br>
> Nicely done on the documentation. Everything is easy to read, and well<br>
> organized. Great job!<br>
><br>
> One thing to note is that hook.api.php files made it into core<br>
> (<a href="http://drupal.org/node/314870" target="_blank">http://drupal.org/node/314870</a>), so are there any places with the new<br>
> database layer that would benefit from having any extra database.api.php<br>
> documentation files around?<br>
><br>
> Thanks a lot,<br>
<br>
</div>Hey neat, that made it in.<br>
<br>
I think DBTNG introduces only one hook, hook_query_alter, so I've opened an<br>
issue for that:<br>
<br>
<a href="http://drupal.org/node/348519" target="_blank">http://drupal.org/node/348519</a><br>
<br>
I'm not sure that in-code is the best place to document the rest of DBTNG,<br>
beyond the docblocks already in database.inc. The handbooks are probably<br>
better as it's less API samples and more prose explanations. That said, I'm<br>
fine if someone wants to copy portions of the handbooks into a docblock.<br>
(Technically the licenses are incompatible, but as the original author of 98%<br>
of the DBTNG documentation I hereby dual-license it as needed yadda yadda.)<br>
<div class="Ih2E3d"><br>
--<br>
Larry Garfield<br>
<a href="mailto:larry@garfieldtech.com">larry@garfieldtech.com</a><br>
--<br>
</div><div><div></div><div class="Wj3C7c">Pending work: <a href="http://drupal.org/project/issues/documentation/" target="_blank">http://drupal.org/project/issues/documentation/</a><br>
List archives: <a href="http://lists.drupal.org/pipermail/documentation/" target="_blank">http://lists.drupal.org/pipermail/documentation/</a><br>
</div></div></blockquote></div><br>