Better document which/when cursor returning functions and iteration could throw exceptions

it’s not clear what parts of the API could throw an exception at query/execution time vs at cursor-iteration time