functions: updated documentation