fix documentation to reflect actual behavior