updated documentation for this call