From: Simon Marchi <simon.marchi@ericsson.com>
To: <gdb-patches@sourceware.org>
Cc: Simon Marchi <simon.marchi@ericsson.com>
Subject: [PATCH v2 3/3] python: Fix erroneous doc about gdb.objfiles()
Date: Thu, 13 Sep 2018 02:37:00 -0000 [thread overview]
Message-ID: <20180913023627.18855-3-simon.marchi@ericsson.com> (raw)
In-Reply-To: <20180913023627.18855-1-simon.marchi@ericsson.com>
New in v2: updated the text.
The code implementing gdb.objfiles() returns a list of objfiles for the
current program space (the program space of the selected inferior). The
documentation for the gdb.objfiles() Python method, however, states:
Return a sequence of all the objfiles current known to GDB.
That sounds wrong to me. I tried to phrase to be more precise.
gdb/doc/ChangeLog:
* python.texi (Objfiles In Python): Update gdb.objfiles() doc.
---
gdb/doc/python.texi | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index 6b3b598039d..9c7d26b133b 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -4112,10 +4112,10 @@ this function returns @code{None}.
@findex gdb.objfiles
@defun gdb.objfiles ()
-Return a sequence of all the objfiles current known to @value{GDBN}.
-@xref{Objfiles In Python}. This is identical to
-@code{gdb.selected_inferior().progspace.objfiles()} (@pxref{Progspaces In
-Python}) and is included for historical compatibility.
+Return a sequence of objfiles referenced by the current program space.
+@xref{Objfiles In Python} and @ref{Progspaces In Python}. This is identical
+to @code{gdb.selected_inferior().progspace.objfiles()} and is included for
+historical compatibility.
@end defun
@findex gdb.lookup_objfile
--
2.19.0
next prev parent reply other threads:[~2018-09-13 2:37 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-09-13 2:36 [PATCH v2 1/3] python: Add Inferior.progspace property Simon Marchi
2018-09-13 2:37 ` Simon Marchi [this message]
2018-09-13 13:49 ` [PATCH v2 3/3] python: Fix erroneous doc about gdb.objfiles() Eli Zaretskii
2018-09-13 2:37 ` [PATCH v2 2/3] python: Add Progspace.objfiles method Simon Marchi
2018-09-13 13:49 ` Eli Zaretskii
2018-09-13 13:46 ` [PATCH v2 1/3] python: Add Inferior.progspace property Eli Zaretskii
2018-09-13 13:50 ` Simon Marchi
2018-09-13 14:20 ` Eli Zaretskii
2018-09-13 19:45 ` Simon Marchi
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180913023627.18855-3-simon.marchi@ericsson.com \
--to=simon.marchi@ericsson.com \
--cc=gdb-patches@sourceware.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox