From: Kevin Buettner <kevinb@redhat.com>
Date: Sun, 17 Feb 2019 01:31:51 +0000 (-0700)
Subject: Document two argument form of gdb.Value constructor
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=af54ade989cbbb1a43f4bc9d4d2e8e60814306f1;p=binutils-gdb.git

Document two argument form of gdb.Value constructor

gdb/ChangeLog:

	* NEWS: Mention two argument form of gdb.Value constructor.

gdb/doc/ChangeLog:

	* python.texi (Values From Inferior): Document second form
	of Value.__init__.
---

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 5d845e9a214..df94e7514b9 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,5 +1,6 @@
 2019-02-26  Kevin Buettner  <kevinb@redhat.com>
 
+	* NEWS: Mention two argument form of gdb.Value constructor.
 	* python/py-value.c (convert_buffer_and_type_to_value): New
 	function.
 	(valpy_new): Parse arguments via gdb_PyArg_ParseTupleAndKeywords.
diff --git a/gdb/NEWS b/gdb/NEWS
index 8fe961b3f37..bfb023e7bb5 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -202,6 +202,9 @@ FreeBSD/riscv			riscv*-*-freebsd*
      gdb.SYMBOL_TYPES_DOMAIN are now deprecated.  These were never
      correct and did not work properly.
 
+  ** The gdb.Value type has a new constructor, which is used to construct a
+     gdb.Value from a Python buffer object and a gdb.Type.
+
 * Configure changes
 
 --enable-ubsan
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index fb970e98d19..7a1add5f19c 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2019-02-26  Kevin Buettner  <kevinb@redhat.com>
+
+	* python.texi (Values From Inferior): Document second form
+	of Value.__init__.
+
 2019-02-23  Joel Brobecker  <brobecker@adacore.com>
 
 	* gdb.texinfo: Update copyright year ranges.
diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index 2860361c333..7f6f52c4df6 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -735,6 +735,14 @@ its result is used.
 @end table
 @end defun
 
+@defun Value.__init__ (@var{val}, @r{[}, type @r{]})
+This second form of the @code{gdb.Value} constructor returns a
+@code{gdb.Value} of type @var{type} where the value contents are taken
+from the Python buffer object specified by @var{val}.  The number of
+bytes in the Python buffer object must be greater than or equal to the
+size of @var{type}.
+@end defun
+
 @defun Value.cast (type)
 Return a new instance of @code{gdb.Value} that is the result of
 casting this instance to the type described by @var{type}, which must