input/core docstrings and private fns.