Get the non-runnable example out of the way.
Lamely add a warning to the non-runnable example.
Turn the snippets from the usage document into a stand-alone, runnable example.  Continue to use doctest to verify the example works.