tweaked function documentation