update of funcs to try to fix documentation issues