agreed. i was not advocating we change the api - that's a much bigger task, but more to the point of illustrating that the current api is very non-intuitive.