make doc-strings say what the fns actually do