updated 19 all dbs method with dbname field and documentation

- added dbname field to docs stored and returned in _all_dbs
the value of this field can be used to directly open the db.

- added documentation for `_all_dbs` to `api.md`