Update documentation for keep_alive to match new implementation#1050

dean0x7d merged 1 commit intopybind:masterpybind/pybind11:masterfrom

bmerry:keep-alive-docbmerry/pybind11:keep-alive-docCopy head branch name to clipboard