document changes made for versions 1.5 and 1.6; document a few things