clarify dox re: num_iter_default
(#365)