[libvirt PATCH 6/6] docs: glib-adoption: add string arrays and objects

Signed-off-by: Ján Tomko <jtomko(a)redhat.com&gt; --- 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