document the database methods
picky pragma