summaryrefslogtreecommitdiff
path: root/libcaja-extension/caja-extension-types.h
diff options
context:
space:
mode:
authormonsta <[email protected]>2016-08-23 16:02:36 +0300
committermonsta <[email protected]>2016-08-23 16:02:36 +0300
commitfafdebc5741aef1b6eb64db0a0447eb0210ee186 (patch)
treecc8f3ba2885fc12f4bd614865e5a68ab7c5f231b /libcaja-extension/caja-extension-types.h
parent3b62e6d5d6fe861e8be862b0a20ba32fdf05e701 (diff)
downloadcaja-fafdebc5741aef1b6eb64db0a0447eb0210ee186.tar.bz2
caja-fafdebc5741aef1b6eb64db0a0447eb0210ee186.tar.xz
libcaja-extension: fix docs generation and fix some indent
docs are still far from perfect, but most build warnings are gone
Diffstat (limited to 'libcaja-extension/caja-extension-types.h')
-rw-r--r--libcaja-extension/caja-extension-types.h75
1 files changed, 46 insertions, 29 deletions
diff --git a/libcaja-extension/caja-extension-types.h b/libcaja-extension/caja-extension-types.h
index ddfbd233..691d0f11 100644
--- a/libcaja-extension/caja-extension-types.h
+++ b/libcaja-extension/caja-extension-types.h
@@ -31,43 +31,60 @@
#include <glib-object.h>
-#ifdef __cplusplus
-extern "C" {
-#endif
+G_BEGIN_DECLS
#define CAJA_TYPE_OPERATION_RESULT (caja_operation_result_get_type ())
- /* Handle for asynchronous interfaces. These are opaque handles that must
- * be unique within an extension object. These are returned by operations
- * that return CAJA_OPERATION_IN_PROGRESS */
- typedef struct _CajaOperationHandle CajaOperationHandle;
+/**
+ * CajaOperationHandle:
+ *
+ * Handle for asynchronous interfaces. These are opaque handles that must
+ * be unique within an extension object. These are returned by operations
+ * that return CAJA_OPERATION_IN_PROGRESS.
+ */
+typedef struct _CajaOperationHandle CajaOperationHandle;
+
+/**
+ * CajaOperationResult:
+ * @CAJA_OPERATION_COMPLETE: the operation succeeded, and the extension
+ * is done with the request.
+ * @CAJA_OPERATION_FAILED: the operation failed.
+ * @CAJA_OPERATION_IN_PROGRESS: the extension has begin an async operation.
+ * When this value is returned, the extension must set the handle parameter
+ * and call the callback closure when the operation is complete.
+ */
+typedef enum {
+ /* Returned if the call succeeded, and the extension is done
+ * with the request */
+ CAJA_OPERATION_COMPLETE,
- typedef enum
- {
- /* Returned if the call succeeded, and the extension is done
- * with the request */
- CAJA_OPERATION_COMPLETE,
+ /* Returned if the call failed */
+ CAJA_OPERATION_FAILED,
- /* Returned if the call failed */
- CAJA_OPERATION_FAILED,
+ /* Returned if the extension has begun an async operation.
+ * If this is returned, the extension must set the handle
+ * parameter and call the callback closure when the
+ * operation is complete. */
+ CAJA_OPERATION_IN_PROGRESS
+} CajaOperationResult;
- /* Returned if the extension has begun an async operation.
- * If this is returned, the extension must set the handle
- * parameter and call the callback closure when the
- * operation is complete. */
- CAJA_OPERATION_IN_PROGRESS
- } CajaOperationResult;
+GType caja_operation_result_get_type (void);
- GType caja_operation_result_get_type (void);
+/**
+ * SECTION:caja-extension-types
+ * @title: CajaModule
+ * @short_description: Initialize an extension
+ * @include: libcaja-extension/caja-extension-types.h
+ *
+ * Methods that each extension implements.
+ */
- void caja_module_initialize (GTypeModule *module);
- void caja_module_shutdown (void);
- void caja_module_list_types (const GType **types,
- int *num_types);
- void caja_module_list_pyfiles (GList **pyfiles);
+void caja_module_initialize (GTypeModule *module);
+void caja_module_shutdown (void);
+void caja_module_list_types (const GType **types,
+ int *num_types);
+void caja_module_list_pyfiles (GList **pyfiles);
-#ifdef __cplusplus
-}
-#endif
+G_END_DECLS
#endif