Small doc update.
General reshuffling around of files for better packaging.
Further folder rearrangement.
Make header file more readable.
Move C++ extension to subpackage.

This creates room for a thin Python layer that we can use to make
calls to the distance functions more flexible.
Fix Travis configuration.