some phpdocs; remove a bug from dyaclpdo; add some functions to be written;