[glibmm/glibmm-2-54] Variant: Slightly elaborate Variant<Variant> docs



commit 693fe7234b74fa1f80de1d61fb01e3ac70d35edc
Author: Daniel Boles <dboles src gnome org>
Date:   Mon Jan 15 15:33:40 2018 +0000

    Variant: Slightly elaborate Variant<Variant> docs
    
    Point out get_n_children() for checking nullable status, and copy the
    doc for Variant<VariantBase> to Variant< Variant<T> >.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=778219

 glib/src/variant.hg |    9 ++++++++-
 1 files changed, 8 insertions(+), 1 deletions(-)
---
diff --git a/glib/src/variant.hg b/glib/src/variant.hg
index 5a7db66..62f1bda 100644
--- a/glib/src/variant.hg
+++ b/glib/src/variant.hg
@@ -450,7 +450,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 <tt>nothing</tt>.
  *
  * @newin{2,28}
  * @ingroup Variant
@@ -501,6 +503,11 @@ public:
 };
 
 /** Specialization of Variant containing a Variant<T>.
+ * 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 <tt>nothing</tt>.
+ *
  * @newin{2,36}
  * @ingroup Variant
  */


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]