Fix API reference documentation
authorSeoyeon Kim <seoyeon2.kim@samsung.com>
Mon, 29 May 2017 09:40:41 +0000 (18:40 +0900)
committerdongsug.song <dongsug.song@samsung.com>
Wed, 31 May 2017 03:25:53 +0000 (12:25 +0900)
- Match the documentation with the parameter name
- Remove the mention of internal API : View.GetTargetSize
- Add documentation
- merge from tizen branch

Conflicts:
Tizen.NUI/src/internal/DaliEnumConstants.cs

Change-Id: I268d3a04021a5b4777de52042cf793639b458402
Signed-off-by: Seoyeon Kim <seoyeon2.kim@samsung.com>
src/Tizen.NUI/src/internal/DaliEnumConstants.cs
src/Tizen.NUI/src/internal/dotnetcore/AddedException.cs
src/Tizen.NUI/src/public/BaseComponents/CustomView.cs
src/Tizen.NUI/src/public/Timer.cs
src/Tizen.NUI/src/public/UIComponents/Popup.cs

index 8c154b4..a64c3a1 100755 (executable)
@@ -17,22 +17,27 @@ using System;
 
 namespace Tizen.NUI
 {
-
-    namespace Constants
+  namespace Constants
+  {
+    /// <summary>
+    /// Enumeration for texture types.
+    /// </summary>
+    public enum TextureType
     {
-        public enum TextureType
-        {
-            Texture2D = Tizen.NUI.TextureType.TEXTURE_2D,   ///< One 2D image                            @SINCE_1_1.43
-            TextureCube = Tizen.NUI.TextureType.TEXTURE_CUBE  ///< Six 2D images arranged in a cube-shape  @SINCE_1_1.43
-        }
+      Texture2D     = Tizen.NUI.TextureType.TEXTURE_2D,   ///< One 2D image
+      TextureCube   = Tizen.NUI.TextureType.TEXTURE_CUBE  ///< Six 2D images arranged in a cube-shape
+    }
 
-        public enum ViewMode
-        {
-            Mono = Tizen.NUI.ViewMode.MONO,                          ///< Monoscopic (single camera). This is the default @SINCE_1_0.0
-            StereoHorizontal = Tizen.NUI.ViewMode.STEREO_HORIZONTAL, ///< Stereoscopic. Frame buffer is split horizontally with the left and right camera views in their respective sides. @SINCE_1_0.0
-            StereoVertical = Tizen.NUI.ViewMode.STEREO_VERTICAL,     ///< Stereoscopic. Frame buffer is split vertically with the left camera view at the top and the right camera view at the bottom. @SINCE_1_0.0
-            StereoInterlaced = Tizen.NUI.ViewMode.STEREO_INTERLACED  ///< @DEPRECATED_1_1.19 @brief Stereoscopic. Left/Right camera views are rendered into the framebuffer on alternate frames. @SINCE_1_0.0
-        }
+    /// <summary>
+    /// Enumeration for stereoscopic view modes.
+    /// </summary>
+    public enum ViewMode
+    {
+      Mono              = Tizen.NUI.ViewMode.MONO,                          ///< Monoscopic (single camera). This is the default.
+      StereoHorizontal  = Tizen.NUI.ViewMode.STEREO_HORIZONTAL, ///< Stereoscopic. Frame buffer is split horizontally with the left and right camera views in their respective sides.
+      StereoVertical    = Tizen.NUI.ViewMode.STEREO_VERTICAL,     ///< Stereoscopic. Frame buffer is split vertically with the left camera view at the top and the right camera view at the bottom.
+      StereoInterlaced  = Tizen.NUI.ViewMode.STEREO_INTERLACED  ///< Stereoscopic. Left/Right camera views are rendered into the framebuffer on alternate frames.
+    }
 
         public struct Direction
         {
index 5e05865..ddde060 100755 (executable)
@@ -1,18 +1,18 @@
-/** Copyright (c) 2017 Samsung Electronics Co., Ltd.\r
-*\r
-* Licensed under the Apache License, Version 2.0 (the "License");\r
-* you may not use this file except in compliance with the License.\r
-* You may obtain a copy of the License at\r
-*\r
-* http://www.apache.org/licenses/LICENSE-2.0\r
-*\r
-* Unless required by applicable law or agreed to in writing, software\r
-* distributed under the License is distributed on an "AS IS" BASIS,\r
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
-* See the License for the specific language governing permissions and\r
-* limitations under the License.\r
-*\r
-*/\r
+// Copyright (c) 2017 Samsung Electronics Co., Ltd.\r
+//\r
+// Licensed under the Apache License, Version 2.0 (the "License");\r
+// you may not use this file except in compliance with the License.\r
+// You may obtain a copy of the License at\r
+//\r
+// http://www.apache.org/licenses/LICENSE-2.0\r
+//\r
+// Unless required by applicable law or agreed to in writing, software\r
+// distributed under the License is distributed on an "AS IS" BASIS,\r
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+// See the License for the specific language governing permissions and\r
+// limitations under the License.\r
+//\r
+//\r
 \r
 namespace System\r
 {\r
index 69585f5..89f77c2 100644 (file)
@@ -402,7 +402,7 @@ namespace Tizen.NUI.BaseComponents
         /// <summary>
         /// Called when the owning view's size is set e.g. using View.SetSize().
         /// </summary>
-        /// <param name="targetSize">The target size. Note that this target size may not match the size returned via View.GetTargetSize</param>
+        /// <param name="targetSize">The target size</param>
         public virtual void OnSizeSet(Vector3 targetSize)
         {
         }
@@ -411,7 +411,7 @@ namespace Tizen.NUI.BaseComponents
         /// Called when the owning view's size is animated e.g. using Animation::AnimateTo( Property( view, View::Property::SIZE ), ... ).
         /// </summary>
         /// <param name="animation">The object which is animating the owning view</param>
-        /// <param name="targetSize">The target size. Note that this target size may not match the size returned via @ref View.GetTargetSize</param>
+        /// <param name="targetSize">The target size</param>
         public virtual void OnSizeAnimation(Animation animation, Vector3 targetSize)
         {
         }
index 04525be..90a6b24 100755 (executable)
@@ -139,7 +139,7 @@ namespace Tizen.NUI
         /// <summary>
         /// Creates a tick Timer that emits periodic signal.
         /// </summary>
-        /// <param name="millSec">Interval in milliseconds</param>
+        /// <param name="milliSec">Interval in milliseconds</param>
         /// <returns>A new timer</returns>
         public Timer(uint milliSec) : this(NDalicPINVOKE.Timer_New(milliSec), true)
         {
index 0e89e6b..d451c38 100755 (executable)
@@ -478,7 +478,7 @@ namespace Tizen.NUI.UIComponents
         /// <summary>
         /// Sets a title for this Popup.
         /// </summary>
-        /// <param name="titleActor">The actor to set a title</param>
+        /// <param name="titleView">The actor to set a title</param>
         public void SetTitle(View titleView)
         {
             NDalicPINVOKE.Popup_SetTitle(swigCPtr, View.getCPtr(titleView));