diff options
author | Tom Tromey <tom@tromey.com> | 2018-09-08 09:08:56 -0600 |
---|---|---|
committer | Tom Tromey <tom@tromey.com> | 2018-09-10 07:44:23 -0600 |
commit | 60c0454d3dda99635d331f6002f3f04fe34546a7 (patch) | |
tree | 07f3a83f9ac35f6e003213b29275563fbf5db1f3 | |
parent | 088a96da059ce14fe1dff369873b1dcf7151e29a (diff) | |
download | gdb-60c0454d3dda99635d331f6002f3f04fe34546a7.zip gdb-60c0454d3dda99635d331f6002f3f04fe34546a7.tar.gz gdb-60c0454d3dda99635d331f6002f3f04fe34546a7.tar.bz2 |
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.
-rw-r--r-- | gdb/doc/ChangeLog | 6 | ||||
-rw-r--r-- | gdb/doc/python.texi | 5 |
2 files changed, 10 insertions, 1 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index f266f75..22987d2 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,5 +1,11 @@ 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: * gdb.texinfo (Pretty-Printer Commands): Fix typo in example. diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi index 86a9111..e1b79cc 100644 --- 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 () |