gvariant: Briefly mention limits

diff --git a/glib/gvariant.c b/glib/gvariant.c
index 2661e0d..85c1dad 100644 (file)
--- a/glib/gvariant.c
+++ b/glib/gvariant.c
@@ -80,6 +80,11 @@
  * indicator could be placed at the beginning of a file, network message
  * or network stream).
  *
+ * A #GVariant's size is limited mainly by any lowever level operating
+ * system constraints, such as the number of bits in #gsize.  For
+ * example, it is reasonable to have a 2GB file mapped into memory
+ * with #GMappedFile, and call g_variant_new_from_data() on it.
+ *
  * For convenience to C programmers, #GVariant features powerful
  * varargs-based value construction and destruction.  This feature is
  * designed to be embedded in other libraries.