updated and extended documentation