document public reference cursor api, om.core/root-cursor,
om.core/ref-cursor, and om.core/observe