[libvirt PATCH 6/6] docs: glib-adoption: add string arrays and objects
Ján Tomko
jtomko at redhat.com
Thu Sep 24 12:28:40 UTC 2020
Signed-off-by: Ján Tomko <jtomko at redhat.com>
---
docs/glib-adoption.rst | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/docs/glib-adoption.rst b/docs/glib-adoption.rst
index 6dcd4bc14e..96bea98e87 100644
--- a/docs/glib-adoption.rst
+++ b/docs/glib-adoption.rst
@@ -36,3 +36,19 @@ Array operations
the GLib types, ``GArray``, ``GPtrArray`` or ``GByteArray``.
These all use a struct to track the array memory and size
together and efficiently resize.
+
+String arrays
+ ``virStringList*``, ``virStringListCount*``
+
+ https://developer.gnome.org/glib/stable/glib-String-Utility-Functions.html
+
+ Prefer the NULL-terminated variant instead of storing the count
+ separately. Prefer ``g_str*v`` functions instead of their ``vir*``
+ counterparts. For use with ``g_auto`` GLib provides the ``GStrv`` type.
+
+Objects
+ ``virObject``
+
+ https://developer.gnome.org/gobject/stable/gobject-The-Base-Object-Type.html
+
+ Prefer ``GObject`` instead.
--
2.26.2
More information about the libvir-list
mailing list