|Reported by:||James Bennett||Owned by:||nobody|
|Cc:||Triage Stage:||Ready for checkin|
|Has patch:||yes||Needs documentation:||yes|
|Needs tests:||no||Patch needs improvement:||no|
Summary says it all; I could have sworn this was documented in db-api.txt, but now I can't find it anywhere. And this is a pretty useful method, so it's important to let people know it's there and how it works.