From fafdebc5741aef1b6eb64db0a0447eb0210ee186 Mon Sep 17 00:00:00 2001
From: monsta <monsta@inbox.ru>
Date: Tue, 23 Aug 2016 16:02:36 +0300
Subject: libcaja-extension: fix docs generation and fix some indent

docs are still far from perfect, but most build warnings are gone
---
 libcaja-extension/caja-info-provider.c | 35 +++++++++++++++++++++-------------
 1 file changed, 22 insertions(+), 13 deletions(-)

(limited to 'libcaja-extension/caja-info-provider.c')

diff --git a/libcaja-extension/caja-info-provider.c b/libcaja-extension/caja-info-provider.c
index 76c67157..0451de23 100644
--- a/libcaja-extension/caja-info-provider.c
+++ b/libcaja-extension/caja-info-provider.c
@@ -27,6 +27,18 @@
 
 #include <glib-object.h>
 
+/**
+ * SECTION:caja-info-provider
+ * @title: CajaInfoProvider
+ * @short_description: Interface to provide additional information about files
+ * @include: libcaja-extension/caja-column-provider.h
+ *
+ * #CajaInfoProvider allows extension to provide additional information about
+ * files. When caja_info_provider_update_file_info() is called by the application,
+ * extensions will know that it's time to add extra information to the provided
+ * #CajaFileInfo.
+ */
+
 static void
 caja_info_provider_base_init (gpointer g_class)
 {
@@ -37,10 +49,8 @@ caja_info_provider_get_type (void)
 {
     static GType type = 0;
 
-    if (!type)
-    {
-        const GTypeInfo info =
-        {
+    if (!type) {
+        const GTypeInfo info = {
             sizeof (CajaInfoProviderIface),
             caja_info_provider_base_init,
             NULL,
@@ -62,9 +72,9 @@ caja_info_provider_get_type (void)
 }
 
 CajaOperationResult
-caja_info_provider_update_file_info (CajaInfoProvider *provider,
-                                     CajaFileInfo *file,
-                                     GClosure *update_complete,
+caja_info_provider_update_file_info (CajaInfoProvider     *provider,
+                                     CajaFileInfo         *file,
+                                     GClosure             *update_complete,
                                      CajaOperationHandle **handle)
 {
     g_return_val_if_fail (CAJA_IS_INFO_PROVIDER (provider),
@@ -80,7 +90,7 @@ caja_info_provider_update_file_info (CajaInfoProvider *provider,
 }
 
 void
-caja_info_provider_cancel_update (CajaInfoProvider *provider,
+caja_info_provider_cancel_update (CajaInfoProvider    *provider,
                                   CajaOperationHandle *handle)
 {
     g_return_if_fail (CAJA_IS_INFO_PROVIDER (provider));
@@ -93,10 +103,10 @@ caja_info_provider_cancel_update (CajaInfoProvider *provider,
 }
 
 void
-caja_info_provider_update_complete_invoke (GClosure *update_complete,
-        CajaInfoProvider *provider,
-        CajaOperationHandle *handle,
-        CajaOperationResult result)
+caja_info_provider_update_complete_invoke (GClosure            *update_complete,
+                                           CajaInfoProvider    *provider,
+                                           CajaOperationHandle *handle,
+                                           CajaOperationResult  result)
 {
     GValue args[3] = { { 0, } };
     GValue return_val = { 0, };
@@ -119,4 +129,3 @@ caja_info_provider_update_complete_invoke (GClosure *update_complete,
     g_value_unset (&args[2]);
 }
 
-
-- 
cgit v1.2.1