From f8933334b0b2e4e825997cf3c37bc427e3685f22 Mon Sep 17 00:00:00 2001 From: Daniel Boles Date: Mon, 15 Jan 2018 15:33:40 +0000 Subject: Variant: Slightly elaborate Variant docs Point out get_n_children() for checking nullable status, and copy the doc for Variant to Variant< Variant >. https://bugzilla.gnome.org/show_bug.cgi?id=778219 --- glib/src/variant.hg | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/glib/src/variant.hg b/glib/src/variant.hg index 4dfce6ba..c41978f7 100644 --- a/glib/src/variant.hg +++ b/glib/src/variant.hg @@ -449,7 +449,9 @@ public: /** Specialization of Variant containing a VariantBase. * Perhaps the main use of this is as a maybe-typed (i.e. nullable) Variant, as - * it inherits methods create_maybe() and get_maybe() from VariantContainerBase. + * it inherits the methods create_maybe() and get_maybe() from + * VariantContainerBase, plus get_n_children() to allow checking whether there + * is a contained value, i.e. the inner Variant is not nothing. * * @newin{2,28} * @ingroup Variant @@ -500,6 +502,11 @@ public: }; /** Specialization of Variant containing a Variant. + * Perhaps the main use of this is as a maybe-typed (i.e. nullable) Variant, as + * it inherits the methods create_maybe() and get_maybe() from + * VariantContainerBase, plus get_n_children() to allow checking whether there + * is a contained value, i.e. the inner Variant is not nothing. + * * @newin{2,36} * @ingroup Variant */ -- cgit v1.2.1