This is the mail archive of the
gdb-cvs@sourceware.org
mailing list for the GDB project.
[binutils-gdb] Improve docs of objfile filename method.
- From: Doug Evans <devans at sourceware dot org>
- To: gdb-cvs at sourceware dot org
- Date: 27 Jan 2015 18:04:58 -0000
- Subject: [binutils-gdb] Improve docs of objfile filename method.
https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=1b5493961ab1f65a3336b2178ba3d035a130f9f6
commit 1b5493961ab1f65a3336b2178ba3d035a130f9f6
Author: Doug Evans <dje@google.com>
Date: Tue Jan 27 10:03:15 2015 -0800
Improve docs of objfile filename method.
gdb/doc/ChangeLog:
* python.texi (Objfiles In Python) <Objfile.filename>: Improve docs.
* guile.texi (Objfiles In Guile) <objfile-filename>: Improve docs.
Diff:
---
gdb/doc/ChangeLog | 5 +++++
gdb/doc/guile.texi | 3 ++-
gdb/doc/python.texi | 5 ++++-
3 files changed, 11 insertions(+), 2 deletions(-)
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index a5d8329..c5340a8 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2015-01-27 Doug Evans <dje@google.com>
+
+ * python.texi (Objfiles In Python) <Objfile.filename>: Improve docs.
+ * guile.texi (Objfiles In Guile) <objfile-filename>: Improve docs.
+
2015-01-22 Jan Kratochvil <jan.kratochvil@redhat.com>
* gdb.texinfo (Threads): Describe -ascending for thread apply all.
diff --git a/gdb/doc/guile.texi b/gdb/doc/guile.texi
index 8355d9f..53e69f2 100644
--- a/gdb/doc/guile.texi
+++ b/gdb/doc/guile.texi
@@ -2246,7 +2246,8 @@ if it is invalid at the time the procedure is called.
@end deffn
@deffn {Scheme Procedure} objfile-filename objfile
-Return the file name of @var{objfile} as a string.
+Return the file name of @var{objfile} as a string,
+with symbolic links resolved.
@end deffn
@deffn {Scheme Procedure} objfile-pretty-printers objfile
diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index b9a50d0..ba03841 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -3513,7 +3513,10 @@ Each objfile is represented by an instance of the @code{gdb.Objfile}
class.
@defvar Objfile.filename
-The file name of the objfile as a string.
+The file name of the objfile as a string, with symbolic links resolved.
+
+The value is @code{None} if the objfile is no longer valid.
+See the @code{gdb.Objfile.is_valid} method, described below.
@end defvar
@defvar Objfile.owner