Mention which return values need to be freed in lang_varobj_ops

This is the result of a little bit of investigation of the C and Ada
languages, as well as some common sense.

gdb/ChangeLog:

	* varobj.h (lang_varobj_ops): Mention which return values need
	to be freed.
This commit is contained in:
Simon Marchi 2015-02-02 13:17:08 -05:00
parent 6c2573b7ab
commit aa3de2670f
2 changed files with 13 additions and 4 deletions

View File

@ -1,3 +1,8 @@
2015-02-02 Simon Marchi <simon.marchi@ericsson.com>
* varobj.h (lang_varobj_ops): Mention which return values need
to be freed.
2015-02-02 Joel Brobecker <brobecker@adacore.com> 2015-02-02 Joel Brobecker <brobecker@adacore.com>
* dwarf2loc.c (dwarf2_evaluate_property): Add i18n marker. * dwarf2loc.c (dwarf2_evaluate_property): Add i18n marker.

View File

@ -169,14 +169,17 @@ struct lang_varobj_ops
/* The number of children of PARENT. */ /* The number of children of PARENT. */
int (*number_of_children) (const struct varobj *parent); int (*number_of_children) (const struct varobj *parent);
/* The name (expression) of a root varobj. */ /* The name (expression) of a root varobj. The returned value must be freed
by the caller. */
char *(*name_of_variable) (const struct varobj *parent); char *(*name_of_variable) (const struct varobj *parent);
/* The name of the INDEX'th child of PARENT. */ /* The name of the INDEX'th child of PARENT. The returned value must be
freed by the caller. */
char *(*name_of_child) (struct varobj *parent, int index); char *(*name_of_child) (struct varobj *parent, int index);
/* Returns the rooted expression of CHILD, which is a variable /* Returns the rooted expression of CHILD, which is a variable
obtain that has some parent. */ obtain that has some parent. The returned value must be freed by the
caller. */
char *(*path_expr_of_child) (const struct varobj *child); char *(*path_expr_of_child) (const struct varobj *child);
/* The ``struct value *'' of the INDEX'th child of PARENT. */ /* The ``struct value *'' of the INDEX'th child of PARENT. */
@ -185,7 +188,8 @@ struct lang_varobj_ops
/* The type of the INDEX'th child of PARENT. */ /* The type of the INDEX'th child of PARENT. */
struct type *(*type_of_child) (struct varobj *parent, int index); struct type *(*type_of_child) (struct varobj *parent, int index);
/* The current value of VAR. */ /* The current value of VAR. The returned value must be freed by the
caller. */
char *(*value_of_variable) (const struct varobj *var, char *(*value_of_variable) (const struct varobj *var,
enum varobj_display_formats format); enum varobj_display_formats format);