ector,ecore,eio,emotion: convert some docs

1 files changed, 33 insertions, 36 deletions

diff --git a/src/lib/emotion/emotion_object.eo b/src/lib/emotion/emotion_object.eo
index 0e9bff5509..3be80dd881 100644
--- a/src/lib/emotion/emotion_object.eo
+++ b/src/lib/emotion/emotion_object.eo
@@ -3,52 +3,49 @@ class Emotion.Object (Evas.Object_Smart, Efl.File, Efl.Player, Efl.Image) {
    methods {
         @property option {
              set {
-                  /*@
-                   * @brief Set the specified option for the current module.
-                   *
-                   * This function allows one to mute the video or audio of the emotion object.
-                   *
-                   * @note Please don't use this function, consider using
-                   * emotion_object_audio_mute_set() and emotion_object_video_mute_set() instead.
-                   *
-                   * @see emotion_object_audio_mute_set()
-                   * @see emotion_object_video_mute_set()
-                   *
-                   * @ingroup Emotion_Init
-                   */
+                  [[Set the specified option for the current module.
+
+                    This function allows one to mute the video or audio of the
+                    emotion object.
+
+                    Please don't use this function, consider using
+                    @emotion_object_audio_mute_set() and
+                    @emotion_object_video_mute_set instead.
+                  ]]
                   legacy: emotion_object_module_option_set;
              }
              values {
-                  opt: const(char) *; /*@ The option that is being set. Currently supported optiosn: "video" and "audio". */
-                  val: const(char) *; /*@ The value of the option. Currently only supports "off" (?!?!?!) */
+                  opt: const(char) *; [[The option that is being set. Currently
+                                        supported options: "video" and "audio".]]
+                  val: const(char) *; [[The value of the option. Currently only
+                                        supports "off" (?!?!?!)]]
              }
         }
         @property engine {
              set {
-                  /*@
-                   * @brief Initializes an emotion object with the specified module.
-                   *
-                   * This function is required after creating the emotion object, in order to
-                   * specify which module will be used with this object. Different objects can
-                   * use different modules to play a media file. The current supported modules are
-                   * @b gstreamer and @b xine.
-                   *
-                   * To use any of them, you need to make sure that support for them was compiled
-                   * correctly.
-                   *
-                   * @note It's possible to disable the build of a module with
-                   * --disable-module_name.
-                   *
-                   * @see emotion_object_add()
-                   * @see emotion_object_file_set()
-                   *
-                   * @ingroup Emotion_Init
-                   */
+                  [[Initializes an emotion object with the specified module.
+
+                    This function is required after creating the emotion object,
+                    in order to specify which module will be used with this
+                    object. Different objects can use different modules to
+                    play a media file. The current supported modules are
+                    gstreamer and xine.
+
+                    To use any of them, you need to make sure that support for
+                    them was compiled correctly.
+
+                    It's possible to disable the build of a module with
+                    --disable-module_name.
+
+                    See also @emotion_object_add and @emotion_object_file_set.
+                  ]]
                   legacy: emotion_object_init;
-                  return: bool; /*@ @c EINA_TRUE if the specified module was successfully initialized for this object, @c EINA_FALSE otherwise. */
+                  return: bool; [[true if the specified module was successfully
+                                  initialized for this object, false otherwise.]]
              }
              values {
-                  module_filename: const(char) *; /*@ The name of the module to be used (gstreamer or xine). */
+                  module_filename: const(char) *; [[The name of the module to be
+                                                    used (gstreamer or xine).]]
              }
         }
    }