[3.6] bpo-5978: Document that profiling needs cmd/function to return (GH-8515)

<!-- issue-number: bpo-5978 -->
https://bugs.python.org/issue5978
<!-- /issue-number -->
(cherry picked from commit 937fb55d35373fd2701078251840b6be0465a6e1)

Co-authored-by: Andrés Delfino <adelfino@gmail.com>

diff --git a/Doc/library/profile.rst b/Doc/library/profile.rst
index 32d2116e4b149150cf803a59e7b1176b7c1b2816..845065e38133240111f1e9621c7aecd68c45387e 100644 (file)
--- a/Doc/library/profile.rst
+++ b/Doc/library/profile.rst
@@ -290,6 +290,11 @@ functions:
 
       Profile ``func(*args, **kwargs)``
 
+Note that profiling will only work if the called command/function actually
+returns.  If the interpreter is terminated (e.g. via a :func:`sys.exit` call
+during the called command/function execution) no profiling results will be
+printed.
+
 .. _profile-stats:
 
 The :class:`Stats` Class