docs: Improve Spotlight.Animation_Manager docs

1 files changed, 33 insertions, 22 deletions

diff --git a/src/lib/elementary/efl_ui_spotlight_animation_manager.eo b/src/lib/elementary/efl_ui_spotlight_animation_manager.eo
index c82d9666a0..da402113c6 100644
--- a/src/lib/elementary/efl_ui_spotlight_animation_manager.eo
+++ b/src/lib/elementary/efl_ui_spotlight_animation_manager.eo
@@ -1,51 +1,62 @@
 class @beta Efl.Ui.Spotlight.Animation_Manager extends Efl.Ui.Spotlight.Manager
 {
-   [[A spotlight manager that uses animation objects to react to different @Efl.Ui.Spotlight.Manager.switch_to situations.
+   [[A spotlight manager that uses animation objects to react to different @Efl.Ui.Spotlight.Manager.switch_to
+     situations.
 
-     Animations are played forward when they are on the $to argument, they are played backward when they are on the $from argument.
+     Animations are played forward when they are on the $to argument and they are played backward when they are on the
+     $from argument.
 
      Pop animations are always played backwards, Push animations are always played forward.
-     Reason for this is, the reusability. You should be able to pass in 1 animation to all sitatuations, which should cover the turn arround effect that "moving in" and "moving out" has. This means, when you have a alpha channel animation, the pop animation can be the same as the jump-in and out animation, and both will look like fading out.
-
-
+     The reason for this is reusability: you can use the same animation in all situations and this covers the
+     inverted effect that "moving in" and "moving out" has.
+     For example, when you have an alpha channel animation, the Pop animation can be the same as the Jump-In and Out
+     animation, and both will look like fading out.
    ]]
    c_prefix: efl_ui_spotlight_manager_animation;
    methods {
-      @property push_setup{
-         [[Animation that is used to animate the $to argument of a switch_to request when the passed $reason is push.
-
+      @property push_setup {
+         [[Animation that is used to animate the $to argument of a @Efl.Ui.Spotlight.Manager.switch_to request when
+           the passed $reason is @Efl.Ui.Spotlight.Manager_Switch_Reason.push.
 
-           If these animations are $null, then the $in and $out animation of @.jump_setup will be taken instead.
+           If these animations are $null, then the $in and $out animation of @.jump_setup will be used instead.
          ]]
          values {
             in : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference]]
-            out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference. Can be the same as $in.]]
+            out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference.
+                                          Can be the same as $in.]]
          }
-         set { }
+         set {}
       }
-      @property pop_setup{
-         [[Animation that is used to animate the $from argument of a switch_to request when the passed $reason is pop.
 
-           Note: this animations is always played backwards, see the class documentation for the reasoning.
+      @property pop_setup {
+         [[Animation that is used to animate the $from argument of a @Efl.Ui.Spotlight.Manager.switch_to request when
+           the passed $reason is @Efl.Ui.Spotlight.Manager_Switch_Reason.pop.
 
-           If these animations are $null, then the $in and $out animation of @.jump_setup will be taken instead.
+           Note: These animations are always played backwards, see the class documentation for the reasoning.
+
+           If these animations are $null, then the $in and $out animation of @.jump_setup will be used instead.
          ]]
          values {
             in : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference]]
-            out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference. Can be the same as $in.]]
+            out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference.
+                                          Can be the same as $in.]]
          }
-         set { }
+         set {}
       }
-      @property jump_setup{
-         [[Set the animation objects you want to play on a jump in or jump out.
 
-           When a switch to request is issued, two arguments are getting animated. The $from object, and the $to objects. The $from object will be playing the out animation. The $pop object will be playing the in animation.
+      @property jump_setup {
+         [[Sets the animation objects you want to play on a jump in or jump out.
+
+           When a @Efl.Ui.Spotlight.Manager.switch_to request is issued, two arguments are getting animated.
+           The $from object, and the $to object. The $from object will play the $out animation whereas the $to object
+           will play the $in animation.
 
-           The out animation will always be played backwards, this is to support passing the same animation object to both parameters. (A fade animation will fade in the new object, and fade out the old object).
+           The $out animation will always be played backwards. See the class documentation for the reasoning.
          ]]
          values {
             in : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference]]
-            out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference. Can be the same as $in.]]
+            out : Efl.Canvas.Animation; [[The animation to play, the implementation will take an additional reference.
+                                          Can be the same as $in.]]
          }
          set {