add more documentation; del CHANGES (misleading)