From 7ae7a6719e5e0fab608d661096c0934402e1f7cd Mon Sep 17 00:00:00 2001
From: badcel <33569-badcel@users.noreply.gitlab.gnome.org>
Date: Sun, 15 Jan 2023 16:18:05 +0100
Subject: Reword closure annotation documentation

---
 docs/website/annotations/giannotations.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/docs/website/annotations/giannotations.rst b/docs/website/annotations/giannotations.rst
index 8769132a..4691152a 100644
--- a/docs/website/annotations/giannotations.rst
+++ b/docs/website/annotations/giannotations.rst
@@ -148,24 +148,22 @@ Support for GObject closures
     - Since
   * - ``(destroy)``
     - parameters
-    - The parameter is a "``destroy_data``" for callbacks.
+    - The parameter is part of a callback type and containing the ``destroy_data``.
     - :commit:`v0.6.3 <cf7621f3>`
       :bzbug:`574284`
   * - ``(destroy DESTROY)``
     - parameters
-    - The parameter is a "``destroy_data``" for callbacks, the
-      ``DESTROY`` option points to a paramter name other than
-      ``destroy_data``.
+    - The parameter defines the ``destroy_data`` for a given callback. The
+      ``DESTROY`` option points to the parameter that is the actual callback.
     -
   * - ``(closure)``
     - parameters
-    - The parameter is a "``user_data``" for callbacks.
-      Many bindings can pass ``NULL`` here.
+    - The parameter is part of a callback type and containing the ``user_data``.
     -
   * - ``(closure CLOSURE)``
     - parameters
-    - The parameter is a "``user_data``" for callbacks, the ``CLOSURE`` option
-      points to a different parameter that is the actual callback.
+    - The parameter defines the ``user_data`` for a given callback. The ``CLOSURE`` option
+      points to the parameter that is the actual callback. Many bindings can pass ``NULL`` here.
     -
 
 
-- 
cgit v1.2.1