popup: convert docs

1 files changed, 56 insertions, 99 deletions

diff --git a/src/lib/elm_popup.eo b/src/lib/elm_popup.eo
index df866e124..9ce41e5a0 100644
--- a/src/lib/elm_popup.eo
+++ b/src/lib/elm_popup.eo
@@ -29,153 +29,110 @@ class Elm.Popup (Elm.Layout, Elm_Interface_Atspi_Widget_Action)
    methods {
       @property align {
          set {
-            /*@
-            @brief Set the alignment of the popup object
-            Sets the alignment in which the popup will appear in its parent.
+            [[Set the alignment of the popup object.
 
-            @see elm_popup_align_get()
+              Sets the alignment in which the popup will appear in its parent.
 
-            @since 1.9
-            @ingroup Popup */
+              @since 1.9
+            ]]
          }
          get {
-            /*@
-            @brief Get the alignment of the popup object
-            @see elm_popup_align_set()
+            [[Get the alignment of the popup object.
 
-            @since 1.9
-            @ingroup Popup */
+              @since 1.9
+            ]]
          }
          values {
-            horizontal: double; /*@ The horizontal alignment of the popup */
-            vertical: double; /*@ The vertical alignment of the popup */
+            horizontal: double; [[The horizontal alignment of the popup.]]
+            vertical: double; [[The vertical alignment of the popup.]]
          }
       }
       @property allow_events {
          set {
-            /*@
-            @brief Sets whether events should be passed to by a click outside.
+            [[Sets whether events should be passed to by a click outside.
 
-            Enabling allow event will remove the Blocked event area and events will
-            pass to the lower layer objects otherwise they are blocked.
+              Enabling allow event will remove the Blocked event area and
+              events will pass to the lower layer objects otherwise they
+              are blocked.
 
-            @ingroup Popup
-            @see elm_popup_allow_events_get()
-            @note The default value is false. */
+              Note: The default value is $false.
+            ]]
          }
          get {
-            /*@
-            @brief Returns value indicating whether allow event is enabled or not
-
-            @return $false if Blocked event area is present else $true
-
-            @ingroup Popup
-            @see elm_popup_allow_events_set()
-            @note By default the Blocked event area is present */
+            [[Returns value indicating whether allow event is enabled or not.]]
          }
          values {
-            allow: bool; /*@ $true Events are passed to lower objects, else not */
+            allow: bool; [[If $true, events are passed to lower objects.]]
          }
       }
       @property content_text_wrap_type {
-         set {
-            /*@
-            @brief Sets the wrapping type of content text packed in content
+         [[Control the wrapping type of content text packed in content
             area of popup object.
-
-            @ingroup Popup
-            @see elm_popup_content_text_wrap_type_get() */
-         }
-         get {
-            /*@
-            @brief Returns the wrapping type of content text packed in content area of
-            popup object.
-
-            @return wrap type of the content text
-
-            @ingroup Popup
-            @see elm_popup_content_text_wrap_type_set */
-         }
+         ]]
+         set {}
+         get {}
          values {
-            wrap: Elm.Wrap.Type; /*@ wrapping type of type Elm_Wrap_Type */
+            wrap: Elm.Wrap.Type; [[Wrapping type of type Elm_Wrap_Type.]]
          }
       }
       @property orient {
          set {
-            /*@
-            @brief Sets the orientation of the popup in the parent region
-
-            Sets the position in which popup will appear in its parent. By default,
-            #ELM_POPUP_ORIENT_CENTER is set.
+            [[Sets the orientation of the popup in the parent region.
 
-            @ingroup Popup
-            @see @ref Elm_Popup_Orient for possible values. */
+              Sets the position in which popup will appear in its parent.
+              By default, #ELM_POPUP_ORIENT_CENTER is set.
+            ]]
          }
          get {
-            /*@
-            @brief Returns the orientation of Popup
-
-            @return the orientation of the popup
-
-            @ingroup Popup
-            @see elm_popup_orient_set()
-            @see Elm_Popup_Orient */
+            [[Returns the orientation of the popup.]]
          }
          values {
-            orient: Elm.Popup.Orient; /*@ the orientation of the popup */
+            orient: Elm.Popup.Orient; [[The orientation of the popup.]]
          }
       }
       @property timeout {
          set {
-            /*@
-            @brief Sets a timeout to hide popup automatically
+            [[Sets a timeout to hide popup automatically
 
-            This function sets a timeout and starts the timer controlling when the
-            popup is hidden. Since calling evas_object_show() on a popup restarts
-            the timer controlling when it is hidden, setting this before the
-            popup is shown will in effect mean starting the timer when the popup is
-            shown. Smart signal "timeout" is called afterwards which can be handled
-            if needed.
+              This function sets a timeout and starts the timer controlling
+              when the popup is hidden. Since calling \@ref evas_object_show
+              on a popup restarts the timer controlling when it is hidden,
+              setting this before the  popup is shown will in effect mean
+              starting the timer when the popup is shown. Smart signal
+              "timeout" is called afterwards which can be handled
+              if needed.
 
-            @note Set a value <= 0.0 to disable a running timer.
+              Note: Set a value <= 0.0 to disable a running timer.
 
-            @note If the value > 0.0 and the popup is previously visible, the
-            timer will be started with this value, canceling any running timer.
-            @ingroup Popup */
+              Note: If the value > 0.0 and the popup is previously visible,
+              the timer will be started with this value, canceling any
+              running timer.
+            ]]
          }
          get {
-            /*@
-            @brief Returns the timeout value set to the popup (in seconds)
-
-            @return the timeout value
-
-            @ingroup Popup
-            @see elm_popup_timeout_set() */
+            [[Returns the timeout value set to the popup (in seconds).]]
          }
          values {
-            timeout: double; /*@ The timeout in seconds */
+            timeout: double; [[The timeout in seconds.]]
          }
       }
       item_append {
-         /*@
-         @brief Add a new item to a Popup object
-
-         Both an item list and a content could not be set at the same time!
-         once you add an item, the previous content will be removed.
-
-         @return A handle to the item added or $NULL, on errors
+         [[Add a new item to a Popup object
 
-         @ingroup Popup
-         @warning When the first item is appended to popup object, any previous content
-         of the content area is deleted. At a time, only one of content, content-text
-         and item(s) can be there in a popup content area. */
+           Both an item list and a content could not be set at the same time!
+           once you add an item, the previous content will be removed.
 
-         return: Elm.Widget_Item *;
+           Warning: When the first item is appended to popup object, any
+           previous content of the content area is deleted. At a time,
+           only one of content, content-text and item(s) can be there
+           in a popup content area.
+         ]]
+         return: Elm.Widget_Item *; [[A handle to the item added or $null on errors.]]
          params {
-            @in label: const(char)*; /*@ The Label of the new item */
-            @in icon: Evas.Object * @optional; /*@ Icon to be set on new item */
-            @in func: Evas_Smart_Cb @optional; /*@ Convenience function called when item selected */
-            @in data: const(void)* @optional; /*@ Data passed to $func above */
+            @in label: const(char)*; [[The Label of the new item.]]
+            @in icon: Evas.Object * @optional; [[Icon to be set on new item.]]
+            @in func: Evas_Smart_Cb @optional; [[Convenience function called when item selected.]]
+            @in data: const(void)* @optional; [[Data passed to $func above.]]
          }
       }
    }