[PATCH v3 21/21] Update gdb.execute documentation

[Tom Tromey <tom@tromey.com>]

This updates the gdb.execute documentation to describe how logging and
perhaps other settings affect what can be captured.
---
 gdb/doc/python.texi | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index 1f88ea7e9ad..74357620b7a 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -305,6 +305,13 @@ return value is @code{None}.  If @var{to_string} is @code{True}, the
 @value{GDBN} virtual terminal will be temporarily set to unlimited width
 and height, and its pagination will be disabled; @pxref{Screen Size}.
 
+Note that, even when @var{to_string} is @code{True}, other settings
+that affect output will still apply.  For example, some logging
+settings (@pxref{Logging Output}) may still cause the output to be
+redirected.  If this matters, you can temporarily disable settings by
+prefixing the given command with the appropriate @code{with}
+invocations (@pxref{Command Settings}).
+
 When @var{styling} is @code{True}, the output, whether sent to
 standard output, or to a string, will have styling applied, if
 @value{GDBN}'s standard output supports styling, and @kbd{show style

-- 
2.49.0