More clear, descriptive, and safe nomenclature

[rouson]

1. Replace reference_counter with smart_pointers throughout the source and documentation.
2. Use more descriptive names in the example.
3. To minimize the potential for name collisions with user code, add prefix sp_ to all types, submodules, and all but the top-level module.