[doc][stackobject_to_shared_ptr()] Improve documentation.

Add "@relatesalso null_deleter", this includes the documentation for the
function with null_deleter but also leaves a standalone version.  Document
what is so special about the shared_ptr the function returns.  Mention the
#include needed to get the function.