some usage tweaks

These are some tweaks based on using the gem in practice some.  The commits tell the story here.

@jcredding ready for review.