Move comments around, add test example.

First off, this commit moves in-depth discussion of implementation details and
efficiency from the BTree docstring to the package docstring.  Secondly, we add
a simple test example detailing most of the functionality of the tree.