ecore_cocoa: mark clipboard API as BETA
authorJean Guyomarc'h <jean@guyomarch.bzh>
Sat, 25 Jun 2016 10:13:59 +0000 (12:13 +0200)
committerJean Guyomarc'h <jean@guyomarch.bzh>
Sat, 25 Jun 2016 18:45:06 +0000 (20:45 +0200)
Also, Since the API is beta, don't make is available to Doxygen.

src/lib/ecore_cocoa/Ecore_Cocoa.h

index 7f7ca6d..a9d8527 100644 (file)
@@ -465,7 +465,34 @@ EAPI Ecore_Cocoa_Object *ecore_cocoa_window_get(const Ecore_Cocoa_Window *window
    EINA_ARG_NONNULL(1)
    EINA_WARN_UNUSED_RESULT;
 
+
+/**
+ * Set the Cocoa cursor for a given Cocoa window
+ * @param win The Cocoa window on which the cursor is to be changed.
+ * @param c The cursor to be set
+ */
+EAPI void ecore_cocoa_window_cursor_set(Ecore_Cocoa_Window *win,
+                                        Ecore_Cocoa_Cursor  c)
+   EINA_ARG_NONNULL(1);
+
 /**
+ * Hide or show the Cocoa cursor for a given Cocoa window
+ * @param win The Cocoa window on which the cursor is to be hid
+ * @param show Shows the cursor if EINA_TRUE. Hides it if EINA_FALSE
+ *
+ */
+EAPI void ecore_cocoa_window_cursor_show(Ecore_Cocoa_Window *win, Eina_Bool show);
+   EINA_ARG_NONNULL(1);
+
+
+
+/*
+ * The clipboard API is still BETA
+ */
+
+#ifdef EFL_BETA_API_SUPPORT
+
+/*
  * Set the clipboard of Cocoa (NSPasteboard)
  * @param data The contents to be set in the clipboard
  * @param size The size in bytes of @c data
@@ -476,7 +503,7 @@ EAPI Eina_Bool ecore_cocoa_clipboard_set(const void *data,
                                                    int size,
                                                    Ecore_Cocoa_Cnp_Type type);
 
-/**
+/*
  * Get the contents of the Cocoa clipboard
  * @param size Pointer used to retrieve the size of the received contents
  * @param type The type of object to retrieve from the clipboard
@@ -492,28 +519,12 @@ EAPI void *ecore_cocoa_clipboard_get(int *size,
                                      Ecore_Cocoa_Cnp_Type *retrieved_types)
    EINA_WARN_UNUSED_RESULT;
 
-/**
+/*
  * Deletes the contents of the Cocoa clipboard
  */
 EAPI void ecore_cocoa_clipboard_clear(void);
 
-/**
- * Set the Cocoa cursor for a given Cocoa window
- * @param win The Cocoa window on which the cursor is to be changed.
- * @param c The cursor to be set
- */
-EAPI void ecore_cocoa_window_cursor_set(Ecore_Cocoa_Window *win,
-                                        Ecore_Cocoa_Cursor  c)
-   EINA_ARG_NONNULL(1);
-
-/**
- * Hide or show the Cocoa cursor for a given Cocoa window
- * @param win The Cocoa window on which the cursor is to be hid
- * @param show Shows the cursor if EINA_TRUE. Hides it if EINA_FALSE
- *
- */
-EAPI void ecore_cocoa_window_cursor_show(Ecore_Cocoa_Window *win, Eina_Bool show);
-   EINA_ARG_NONNULL(1);
+#endif /* EFL_BETA_API_SUPPORT */
 
 #ifdef __cplusplus
 }