some bug fixes, mostly doc updates