Clean-up of documentation

Tweak introductory paragraph.

Add documentation of database objects (the two functions).