Update doxygen comments
[platform/core/uifw/dali-toolkit.git] / dali-toolkit / public-api / controls / scrollable / scroll-view / scroll-view-page-path-effect.h
index 951298d..dc23694 100644 (file)
@@ -44,7 +44,7 @@ class ScrollViewPagePathEffect;
  *
  * This effect causes Actors to follow a given path. The opacity of the actor will be 0.0 at
  * the beginning of the path and will go to 1.0 as it is approximating to half of the path to return
- * to 0.0 at the end of the path
+ * to 0.0 at the end of the path.
  *
  *
  * ScrollView
@@ -68,40 +68,40 @@ class DALI_IMPORT_API ScrollViewPagePathEffect : public ScrollViewEffect
 public:
 
   /**
-   * @brief Create an initialized ScrollViewPagePathEffect.
+   * @brief Creates an initialized ScrollViewPagePathEffect.
    * @SINCE_1_0.0
    * @param[in] path The path that will be used by the scroll effect
    * @param[in] forward Vector in page object space which will be aligned with the tangent of the path
-   * @param[in] inputPropertyIndex Index of a property of the scroll-view which will be used as the input for the path.
+   * @param[in] inputPropertyIndex Index of a property of the scroll-view which will be used as the input for the path
    * @param[in] pageSize Size of a page in the scrollview
    * @param[in] pageCount Total number of pages in the scrollview
-   * @return A handle to a newly allocated Dali resource.
+   * @return A handle to a newly allocated Dali resource
    */
   static ScrollViewPagePathEffect New(Path path, const Vector3& forward, Dali::Property::Index inputPropertyIndex, const Vector3& pageSize, unsigned int pageCount);
 
   /**
-   * @brief Create an uninitialized ScrollViewPagePathEffect; this can be initialized with ScrollViewPagePathEffect::New()
+   * @brief Creates an uninitialized ScrollViewPagePathEffect; this can be initialized with ScrollViewPagePathEffect::New().
    * Calling member functions with an uninitialized Toolkit::ScrollViewPagePathEffect is not allowed.
    * @SINCE_1_0.0
    */
   ScrollViewPagePathEffect();
 
   /**
-   * @brief Downcast a handle to ScrollViewPagePathEffect handle.
+   * @brief Downcasts a handle to ScrollViewPagePathEffect handle.
    *
-   * If handle points to a ScrollViewPagePathEffect the
-   * downcast produces valid handle. If not the returned handle is left uninitialized.
+   * If handle points to a ScrollViewPagePathEffect, the downcast produces valid handle.
+   * If not, the returned handle is left uninitialized.
    * @SINCE_1_0.0
    * @param[in] handle Handle to an object
-   * @return handle to a ScrollViewPagePathEffect or an uninitialized handle
+   * @return Handle to a ScrollViewPagePathEffect or an uninitialized handle
    */
   static ScrollViewPagePathEffect DownCast( BaseHandle handle );
 
   /**
    * @brief Manually apply effect to a page in the scroll-view.
    * @SINCE_1_0.0
-   * @param[in] page The page to be affected by this effect.
-   * @param[in] pageOrder The order of the page in the scroll-view
+   * @param[in] page The page to be affected by this effect
+   * @param[in] pageOrder The order of the page in the scroll view
    */
   void ApplyToPage( Actor page, unsigned int pageOrder );
 
@@ -111,7 +111,7 @@ protected:
   /**
    * @brief This constructor is used by Dali New() methods.
    * @SINCE_1_0.0
-   * @param [in] impl A pointer to a newly allocated Dali resource
+   * @param[in] impl A pointer to a newly allocated Dali resource
    */
   explicit DALI_INTERNAL ScrollViewPagePathEffect( Internal::ScrollViewPagePathEffect *impl );
   /// @endcond