add references; tweak docs