the docstr has been enhanced.