Start using option objects rather than positional arguments for methods with lots of parameters

[zorkow]

          Sigh.  I wonder if we should start using option objects rather than positional arguments for methods like this with lots of parameters?

Originally posted by @dpvc in #1123 (comment)