funcs to vars for better doc generation.