PR #89 added behavior that partially addresses issue #55. Examples should be added to the docs for this common use case