update docstring and simulate spec circumstances