[gcr/wip/nielsdg/certificate-get-der-data-gtkdoc: 3/3] gcr: Add gtk-doc comment to get_der_data()-vfunc



commit 6fbbc474fc302accfd9af40792cfda627dfe3dd1
Author: Niels De Graef <nielsdegraef gmail com>
Date:   Thu Mar 5 16:01:05 2020 +0100

    gcr: Add gtk-doc comment to get_der_data()-vfunc
    
    gtk-doc can now understand Gtk-doc comments on vfuncs, so let's use
    that.
    
    See also https://gitlab.gnome.org/GNOME/gcr/merge_requests/35#note_678211

 gcr/gcr-certificate.h | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)
---
diff --git a/gcr/gcr-certificate.h b/gcr/gcr-certificate.h
index 373a3e2..ef3ea12 100644
--- a/gcr/gcr-certificate.h
+++ b/gcr/gcr-certificate.h
@@ -46,18 +46,15 @@ struct _GcrCertificateIface {
        GTypeInterface parent;
 
 
-       /*
-        * g-ir-scanner cannot comprehend this yet ...
-        * See: https://bugzilla.gnome.org/show_bug.cgi?id=725501
-        *
-        * GcrCertificate.get_der_data:
+       /**
+        * GcrCertificate::get_der_data:
         * @self: a #GcrCertificate
-        * @n_data: a pointer to a location to store the size of the resulting DER data.
+        * @n_data: (out): a location to store the size of the resulting DER data.
         *
         * Implemented to return the raw DER data for an X.509 certificate. The data
         * should be owned by the #GcrCertificate object.
         *
-        * Returns: (array length=n_data): raw DER data of the X.509 certificate
+        * Returns: (transfer none) (array length=n_data): raw DER data of the X.509 certificate
         */
        const guint8 * (* get_der_data) (GcrCertificate *self,
                                         gsize *n_data);


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]