q66 pushed a commit to branch master.

http://git.enlightenment.org/core/elementary.git/commit/?id=3bb97fd0e80ffa27efc5b2ec4150e9b0638f3cdb

commit 3bb97fd0e80ffa27efc5b2ec4150e9b0638f3cdb
Author: Daniel Kolesa <d.kol...@osg.samsung.com>
Date:   Mon May 11 15:11:28 2015 +0100

    elm_widget_item: fix doc comments
---
 src/lib/elm_widget_item.eo | 90 +++++++++++++++++++++++-----------------------
 1 file changed, 45 insertions(+), 45 deletions(-)

diff --git a/src/lib/elm_widget_item.eo b/src/lib/elm_widget_item.eo
index 94ba27b..c40ce28 100644
--- a/src/lib/elm_widget_item.eo
+++ b/src/lib/elm_widget_item.eo
@@ -5,7 +5,7 @@ class Elm.Widget_Item(Eo.Base, Elm_Interface_Atspi_Accessible)
       methods {
            @property tooltip_window_mode {
                 get {
-                     /**
+                     /*@
                        @brief Get size restriction state of an object's tooltip
 
                        This function returns whether a tooltip is allowed to 
expand beyond
@@ -14,7 +14,7 @@ class Elm.Widget_Item(Eo.Base, Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        @brief Disable size restrictions on an object's tooltip
 
                        This function allows a tooltip to expand beyond its 
parent window's canvas.
@@ -28,7 +28,7 @@ class Elm.Widget_Item(Eo.Base, Elm_Interface_Atspi_Accessible)
            }
            @property tooltip_style {
                 get {
-                     /**
+                     /*@
                        Get the style for this item tooltip.
 
                        @see elm_object_tooltip_style_get() for more details.
@@ -38,7 +38,7 @@ class Elm.Widget_Item(Eo.Base, Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Sets a different style for this item tooltip.
 
                        @note before you set a style you should define a 
tooltip with
@@ -56,7 +56,7 @@ class Elm.Widget_Item(Eo.Base, Elm_Interface_Atspi_Accessible)
            }
            @property cursor {
                 get {
-                     /*
+                     /*@
                         Get the type of mouse pointer/cursor decoration set to 
be shown,
                         when the mouse pointer is over the given item
 
@@ -68,7 +68,7 @@ class Elm.Widget_Item(Eo.Base, Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Set the type of mouse pointer/cursor decoration to be 
shown,
                        when the mouse pointer is over the given item
 
@@ -94,7 +94,7 @@ class Elm.Widget_Item(Eo.Base, Elm_Interface_Atspi_Accessible)
            }
            @property cursor_style {
                 get {
-                     /**
+                     /*@
                        Get the current @b style set for a given item's custom
                        cursor
 
@@ -104,7 +104,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Set a different @b style for a given custom cursor set 
for an
                        item.
 
@@ -130,7 +130,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
            }
            @property cursor_engine_only {
                 get {
-                     /**
+                     /*@
                        Get if the (custom) cursor for a given item is being
                        searched in its theme, also, or is only relying on the 
rendering
                        engine.
@@ -145,7 +145,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Set if the (custom)cursor for a given item should be
                        searched in its theme, also, or should only rely on the
                        rendering engine.
@@ -160,14 +160,14 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                       */
                 }
                 values {
-                     bool engine_only; /* Use @c EINA_TRUE to have cursors 
looked for only
+                     bool engine_only; /*@ Use @c EINA_TRUE to have cursors 
looked for only
                                           on those provided by the rendering 
engine, @c EINA_FALSE
                                           to have them searched on the 
widget's theme, as well. */
                 }
            }
            @property part_content {
                 get {
-                     /**
+                     /*@
                        Get a content of an object item
 
                        @return content of the object item or NULL for any error
@@ -178,7 +178,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Set a content of an object item
 
                        This sets a new object to an item as a content object. 
If any object was
@@ -199,7 +199,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
            }
            @property part_text {
                 get {
-                     /**
+                     /*@
                        Get a label of an object item
 
                        @note Elementary object items may have many labels
@@ -208,7 +208,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Set a label of an object item
 
                        @note Elementary object items may have many labels
@@ -241,7 +241,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
            }
            @property focus {
                 get {
-                     /**
+                     /*@
                        Get whether the @p it is focused or not.
 
                        @see elm_object_item_focus_set()
@@ -251,7 +251,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Set the object item focused
 
                        @see elm_object_item_focus_get()
@@ -266,7 +266,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
            }
            @property style {
                 get {
-                     /**
+                     /*@
                        Get the style of an object item
 
                        @since 1.9
@@ -275,7 +275,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Set a style of an object item
 
                        @since 1.9
@@ -289,7 +289,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
            }
            @property disabled {
                 get {
-                     /**
+                     /*@
                        Get the disabled state of an widget item.
 
                        This gets the state of the widget, which might be 
enabled or disabled.
@@ -298,7 +298,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                       */
                 }
                 set {
-                     /**
+                     /*@
                        Set the disabled state of an widget item.
 
                        Elementary object item can be @b disabled, in which 
state they won't
@@ -318,7 +318,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            access_order_get {
-                /**
+                /*@
                   @brief Get highlight order
                   @since 1.8
 
@@ -327,7 +327,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 return: const(list<Evas_Object *>) *;
            }
            access_order_set {
-                /**
+                /*@
                   @brief Set highlight order
                   @since 1.8
 
@@ -338,7 +338,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            widget_get @const {
-                /**
+                /*@
                   Get the widget object's handle which contains a given item
 
                   @note This returns the widget object itself that an item 
belongs to.
@@ -348,7 +348,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                   return: Evas_Object*; /*@ The widget object */
            }
            del {
-                /**
+                /*@
                   Delete the given item.
 
                   @ingroup General
@@ -359,7 +359,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 legacy: null;
            }
            tooltip_text_set {
-                /**
+                /*@
                   Set the text to be shown in a given object item's tooltips.
 
                   Setup the text as tooltip to object. The item can have only 
one tooltip,
@@ -382,7 +382,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            tooltip_unset {
-                /**
+                /*@
                   Unset tooltip from item.
 
                   Remove tooltip from item. The callback provided as del_cb to
@@ -396,7 +396,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                  */
            }
            cursor_unset {
-                /**
+                /*@
                   Unset any custom mouse pointer/cursor decoration set to be
                   shown, when the mouse pointer is over the given
                   item, thus making it show the @b default cursor again.
@@ -411,7 +411,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                  */
            }
            part_content_unset {
-                /**
+                /*@
                   Unset a content of an object item
 
                   @note Elementary object items may have many contents
@@ -428,7 +428,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 legacy: null;
            }
            signal_callback_add {
-                /**
+                /*@
                   Add a callback for a signal emitted by object item edje.
 
                   This function connects a callback function to a signal 
emitted by the
@@ -447,7 +447,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            signal_callback_del {
-                /**
+                /*@
                   Remove a signal-triggered callback from a object item edje 
object.
 
                   This function removes the @b last callback, previously 
attached to
@@ -470,7 +470,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 return: void*; /*@ The data pointer of the signal callback or 
@c NULL, on errors. */
            }
            signal_emit {
-                /**
+                /*@
                   Send a signal to the edje object of the widget item.
 
                   This function sends a signal to the edje object of the obj 
item. An
@@ -485,7 +485,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            access_info_set {
-                /**
+                /*@
                   Set the text to read out when in accessibility mode
 
                   @ingroup General
@@ -495,7 +495,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            access_object_get @const {
-                /**
+                /*@
                   @brief Get an accessible object of the object item.
                   @since 1.8
 
@@ -504,7 +504,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 return: Evas_Object*; /*@ Accessible object of the object item 
or NULL for any error */
            }
            domain_translatable_part_text_set {
-                /**
+                /*@
                   Set the text for an object item's part, marking it as 
translatable.
 
                   The string to set as @p text must be the original one. Do 
not pass the
@@ -529,7 +529,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            translatable_part_text_get @const {
-                /**
+                /*@
                   Get the original string set as translatable for an object 
item.
 
                   When setting translated strings, the function 
elm_object_item_part_text_get()
@@ -549,7 +549,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 legacy: null;
            }
            domain_part_text_translatable_set {
-                /**
+                /*@
                   Mark the part text to be translatable or not.
 
                   Once you mark the part text to be translatable, the text 
will be translated
@@ -573,7 +573,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            track {
-                /**
+                /*@
                   This returns track object of the item.
 
                   @note This gets a rectangle object that represents the 
object item's internal
@@ -604,7 +604,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 return: Evas_Object*; /*@ The track object */
            }
            untrack {
-                /**
+                /*@
                   This retrieve the track object of the item.
 
                   @note This retrieves the track object that was returned from
@@ -619,7 +619,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                  */
            }
            track_get @const {
-                /**
+                /*@
                   Get the track object reference count.
 
                   @note This gets the reference count for the track object. 
Whenever you call
@@ -644,7 +644,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 legacy: null;
            }
            del_cb_set {
-                /**
+                /*@
                   @brief Set the function to be called when an item from the 
widget is
                   freed.
 
@@ -663,7 +663,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            tooltip_content_cb_set {
-                /**
+                /*@
                   Set the content to be shown in the tooltip item.
 
                   Setup the tooltip to item. The item can have only one 
tooltip,
@@ -688,7 +688,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 }
            }
            access_register {
-                /**
+                /*@
                   @brief Register object item as an accessible object.
                   @since 1.8
 
@@ -697,7 +697,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                 return: Evas_Object*; /*@ Accessible object of the object item 
or NULL for any error */
            }
            access_unregister {
-                /**
+                /*@
                   @brief Unregister accessible object of the object item.
                   @since 1.8
 
@@ -705,7 +705,7 @@ class Elm.Widget_Item(Eo.Base, 
Elm_Interface_Atspi_Accessible)
                  */
            }
            access_order_unset {
-                /**
+                /*@
                   @brief Unset highlight order
                   @since 1.8
 

-- 


Reply via email to