improved documentation...