fix the documentation to match implementation