From 813510f95c8c4790e33f3f6cd919187268660987 Mon Sep 17 00:00:00 2001
From: =?utf8?q?J=C3=A1n=20Tomko?= <jtomko@redhat.com>
Date: Wed, 16 Oct 2019 16:11:30 +0200
Subject: [PATCH] docs: hacking: add a conversion table for removed libvirt
 macros
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

Signed-off-by: Ján Tomko <jtomko@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
---
 docs/hacking.html.in | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/hacking.html.in b/docs/hacking.html.in
index 6bae7f5f64..981b782d31 100644
--- a/docs/hacking.html.in
+++ b/docs/hacking.html.in
@@ -1066,6 +1066,19 @@ BAD:
         should be used to manage autoclean of virObject classes.
         This matches usage with GObject classes.</dd>
     </dl>
+    <table class="top_table">
+        <tr><th>deleted version</th><th>GLib version</th><th>Notes</th></tr>
+        <tr><td><code>VIR_AUTOPTR</code></td><td><code>g_autoptr</code></td><td></td></tr>
+        <tr><td><code>VIR_AUTOCLEAN</code></td><td><code>g_auto</code></td><td></td></tr>
+        <tr><td><code>VIR_AUTOFREE</code></td><td><code>g_autofree</code></td><td>The GLib version does not use parentheses</td></tr>
+        <tr><td><code>VIR_AUTOUNREF</code></td><td><code>g_autoptr</code></td><td>The cleanup function needs to be defined</td></tr>
+        <tr><td><code>VIR_DEFINE_AUTOPTR_FUNC</code></td><td><code>G_DEFINE_AUTOPTR_CLEANUP_FUNC</code></td><td></td></tr>
+        <tr><td><code>VIR_DEFINE_AUTOCLEAN_FUNC</code></td><td><code>G_DEFINE_AUTO_CLEANUP_CLEAR_FUNC</code></td><td></td></tr>
+        <tr><td><code>VIR_STEAL_PTR</code></td><td><code>g_steal_pointer</code></td>
+            <td><code>a = f(&amp;b)</code> instead of <code>f(a, b)</code></td></tr>
+        <tr><td><code>VIR_RETURN_PTR</code></td><td><code>return g_steal_pointer</code></td><td></td></tr>
+    </table>
+
 
     <h2><a id="file_handling">File handling</a></h2>
 
-- 
2.39.5