updated db1.sql and documentation (again)