Added more documentation in the header file to explain how to use the results...

Added more documentation in the header file to explain how to use the results that are found by the function calls to find_pointer_in_heap().

llvm-svn: 154435