(doc) Fix YARD docs for iterative functions

This patch adds some fixups to tag syntax and indention so that iterative
function docs are properly formatted by YARD.

No changes were made to the actual content of the docstrings.