Document that Frame.block can throw

PR python/16484 points out that Frame.block can throw an exception,
but this is not documented.

This patch fixes the documentation.  Changing Frame.block to return
None would be nice, but I suspect it's too late for that change.

gdb/doc/ChangeLog
2018-09-10  Tom Tromey  <tom@tromey.com>

	PR python/16484:
	* python.texi (Frames In Python): Document that Frame.block can
	throw.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index f266f75b59148ccb01774f3c310de73340dd13f9..22987d2defe1d34f2242d8e78391626bfda6115f 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+2018-09-10  Tom Tromey  <tom@tromey.com>
+
+       PR python/16484:
+       * python.texi (Frames In Python): Document that Frame.block can
+       throw.
+
 2018-09-10  Tom Tromey  <tom@tromey.com>
 
        PR python/23487:

diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index 86a91110e0e471032c1fa49f3ec92c447d543e4a..e1b79cc30b2df87921b7060533263cb8700d5498 100644 (file)
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -4321,7 +4321,10 @@ Returns the frame's resume address.
 @end defun
 
 @defun Frame.block ()
-Return the frame's code block.  @xref{Blocks In Python}.
+Return the frame's code block.  @xref{Blocks In Python}.  If the frame
+does not have a block -- for example, if there is no debugging
+information for the code in question -- then this will throw an
+exception.
 @end defun
 
 @defun Frame.function ()