Update doc on shared ptr. Closes #14. TODO: All example code in the documentation should not be in text mode, but in .cpp/.h files so that they can be compiled in samples, and use the doxygen /// [section] syntax to refer to the snippets.