db: updated the documentation.