From 999afee5f20774d1c2ee5bbd9e9221c21597757b Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Thu, 22 Sep 2022 17:26:52 +0900
Subject: [PATCH 01/16] tizen_policy: add information about type parameter of
 snap_window

Change-Id: I9bcd036c02a13b55f0323c2ffca3725cd2bfb61c
---
 protocol/tizen/tizen-extension.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index ebacb2f..1fba8b1 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -415,7 +415,7 @@
          Snap the window to the location (such as the side of the screen) where you want it to be.
       </description>
       <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
-      <arg name="type" type="uint"/>
+      <arg name="type" type="uint" enum="snap_type" summary="snap type"/>
     </request>
   </interface>
 
-- 
2.7.4


From f554c779523d6bfd79442aec83f6c9c25fd78e50 Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Fri, 23 Sep 2022 11:10:56 +0900
Subject: [PATCH 02/16] tizen_policy: add angle info for
 interactive_move/resize_done event

Change-Id: I3df3fee27eb7b876e1a84d187a53e775e4fa013f
---
 protocol/tizen/tizen-extension.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index 1fba8b1..79e0727 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -388,6 +388,7 @@
       <arg name="y" type="int" summary="y-position after move"/>
       <arg name="w" type="uint" summary="width after move"/>
       <arg name="h" type="uint" summary="height after move"/>
+      <arg name="angle" type="int" summary="current angle of surface"/>
     </event>
 
     <event name="interactive_resize_done" since="10">
@@ -400,6 +401,7 @@
       <arg name="y" type="int" summary="y-position after resize"/>
       <arg name="w" type="uint" summary="width after resize"/>
       <arg name="h" type="uint" summary="height after resize"/>
+      <arg name="angle" type="int" summary="current angle of surface"/>
     </event>
 
     <!-- for snap type -->
-- 
2.7.4


From 9c8a677dff23c22cce784e627ce694e01f143bc6 Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Fri, 23 Sep 2022 11:12:34 +0900
Subject: [PATCH 03/16] Package version up to 1.3.32

Change-Id: I195ac4e189495044f54cdadeea2c7a93da226dfc
---
 packaging/wayland-extension.spec | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packaging/wayland-extension.spec b/packaging/wayland-extension.spec
index 2b10601..71f40f4 100644
--- a/packaging/wayland-extension.spec
+++ b/packaging/wayland-extension.spec
@@ -2,7 +2,7 @@
 %define enable_examples 0
 
 Name:		wayland-extension
-Version:	1.3.31
+Version:	1.3.32
 Release:	0
 Summary:	Wayland extenstion protocols that add functionality not available in the Wayland core protocol
 License:	MIT
-- 
2.7.4


From 1f3e2692e9adf97e2ff059b9b55a8f2435e497bf Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Thu, 29 Sep 2022 19:02:23 +0900
Subject: [PATCH 04/16] tizen_policy: add a new nap_type - none

Change-Id: I671b81775fd2106bf19993a8399094f7d1d8d670
---
 protocol/tizen/tizen-extension.xml | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index 79e0727..1fe908f 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -406,10 +406,11 @@
 
     <!-- for snap type -->
     <enum name="snap_type">
-      <entry name="left" value="0" summary="the left side of the screen"/>
-      <entry name="right" value="1" summary="the right side of the screen"/>
-      <entry name="top" value="2" summary="the top of the screen"/>
-      <entry name="bottom" value="3" summary="the bottom of the screen"/>
+      <entry name="none" value="0" summary="no snap"/>
+      <entry name="left" value="1" summary="the left side of the screen"/>
+      <entry name="right" value="2" summary="the right side of the screen"/>
+      <entry name="top" value="3" summary="the top of the screen"/>
+      <entry name="bottom" value="4" summary="the bottom of the screen"/>
     </enum>
 
     <request name="snap_window" since="12">
-- 
2.7.4


From 720d8bf0f5fc2ddb2c67140c5c5b158499e6b5da Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Thu, 29 Sep 2022 19:04:09 +0900
Subject: [PATCH 05/16] Package version up to 1.3.33

Change-Id: I09e0dc2372ca282ce2ba530fb8bf1f3746773a6d
---
 packaging/wayland-extension.spec | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packaging/wayland-extension.spec b/packaging/wayland-extension.spec
index 71f40f4..6743b30 100644
--- a/packaging/wayland-extension.spec
+++ b/packaging/wayland-extension.spec
@@ -2,7 +2,7 @@
 %define enable_examples 0
 
 Name:		wayland-extension
-Version:	1.3.32
+Version:	1.3.33
 Release:	0
 Summary:	Wayland extenstion protocols that add functionality not available in the Wayland core protocol
 License:	MIT
-- 
2.7.4


From fad92cb2acc66adf872e8e674bdb00fe9cdb8db2 Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Fri, 21 Oct 2022 10:28:08 +0900
Subject: [PATCH 06/16] tizen_policy: support set_maximize_direction

Change-Id: I21f652665bf2e33bdb256116ab0d15af2805717a
---
 protocol/tizen/tizen-extension.xml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index 1fe908f..94fd5d2 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -420,6 +420,25 @@
       <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
       <arg name="type" type="uint" enum="snap_type" summary="snap type"/>
     </request>
+
+    <!-- for maximize direction -->
+    <enum name="maximize_direction">
+      <entry name="none" value="0" summary="none. same to unmaximize"/>
+      <entry name="all" value="1" summary="the full size of the screen"/>
+      <entry name="left" value="2" summary="the left side of the screen"/>
+      <entry name="right" value="3" summary="the right side of the screen"/>
+      <entry name="top" value="4" summary="the top of the screen"/>
+      <entry name="bottom" value="5" summary="the bottom of the screen"/>
+    </enum>
+
+    <request name="set_maximize_direction" since="12">
+      <description summary="set maximize direction">
+         Set the maximize direction of the surface.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="direction" type="uint" enum="maximize_direction" summary="maximize direction"/>
+    </request>
+
   </interface>
 
   <interface name="tizen_visibility" version="5">
-- 
2.7.4


From 08f0e7f088ce9a7be66712e8df6825334329391d Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Thu, 27 Oct 2022 08:39:59 +0900
Subject: [PATCH 07/16] tizen_policy: remove snap_window feature

This is replaced to maximize_direction

Change-Id: I949806178d8c744c1667be8cb035c5c9200d580e
---
 protocol/tizen/tizen-extension.xml | 17 -----------------
 1 file changed, 17 deletions(-)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index 94fd5d2..7943165 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -404,23 +404,6 @@
       <arg name="angle" type="int" summary="current angle of surface"/>
     </event>
 
-    <!-- for snap type -->
-    <enum name="snap_type">
-      <entry name="none" value="0" summary="no snap"/>
-      <entry name="left" value="1" summary="the left side of the screen"/>
-      <entry name="right" value="2" summary="the right side of the screen"/>
-      <entry name="top" value="3" summary="the top of the screen"/>
-      <entry name="bottom" value="4" summary="the bottom of the screen"/>
-    </enum>
-
-    <request name="snap_window" since="12">
-      <description summary="snap window">
-         Snap the window to the location (such as the side of the screen) where you want it to be.
-      </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
-      <arg name="type" type="uint" enum="snap_type" summary="snap type"/>
-    </request>
-
     <!-- for maximize direction -->
     <enum name="maximize_direction">
       <entry name="none" value="0" summary="none. same to unmaximize"/>
-- 
2.7.4


From cdaaa052cb4df116eaf6a392bcb5bc20e4b5b45d Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Thu, 27 Oct 2022 08:41:00 +0900
Subject: [PATCH 08/16] Package version up to 1.3.34

Change-Id: I2e0723cc8df39b43e2a8a12451e16aa7564f7e98
---
 packaging/wayland-extension.spec | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packaging/wayland-extension.spec b/packaging/wayland-extension.spec
index 6743b30..8cc29b1 100644
--- a/packaging/wayland-extension.spec
+++ b/packaging/wayland-extension.spec
@@ -2,7 +2,7 @@
 %define enable_examples 0
 
 Name:		wayland-extension
-Version:	1.3.33
+Version:	1.3.34
 Release:	0
 Summary:	Wayland extenstion protocols that add functionality not available in the Wayland core protocol
 License:	MIT
-- 
2.7.4


From 73a75afe24d19b67395852e227c2a22e19a17301 Mon Sep 17 00:00:00 2001
From: SooChan Lim <sc1.lim@samsung.com>
Date: Fri, 23 Dec 2022 16:27:29 +0900
Subject: [PATCH 09/16] tizen_surface: specify the descrption of the
 tizen_surface interface

Change-Id: Ie7df6f8d6768e387c19a45dc567b3bc493493976
---
 protocol/tizen/tizen-extension.xml | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index 7943165..326a7c8 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -1,14 +1,24 @@
 <protocol name="tizen_extension">
   <interface name="tizen_surface" version="1">
+    <description summary="tizen-specific surface">
+      The tizen_surface provides tizen-specific functionalities for the given
+      surface.
+    </description>
+
     <request name="get_tizen_resource">
-      <arg name="id" type="new_id" interface="tizen_resource" />
-      <arg name="surface" type="object" interface="wl_surface" />
+      <description summary="get a tizen_resource object">
+        Create a tizen_resource interface for the given surface.
+      </description>
+      <arg name="id" type="new_id" interface="tizen_resource" summary="the new tizen_resource object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the the surface object"/>
     </request>
+
     <request name="destroy" type="destructor">
-      <description summary="destroy the tizen_surface">
-	Destroy the tizen_surface.
+      <description summary="destroy tizen_surface">
+        Destroy this tizen_surface object.
       </description>
     </request>
+
   </interface>
 
   <interface name="tizen_resource" version="1">
-- 
2.7.4


From 816a0be0f20a31e9c5dbe5f83f349f9f69b20256 Mon Sep 17 00:00:00 2001
From: SooChan Lim <sc1.lim@samsung.com>
Date: Fri, 23 Dec 2022 16:28:56 +0900
Subject: [PATCH 10/16] tizen_resource: specify the descrption of the
 tizen_resource interface

Change-Id: Ieb5e91dd05669d0e118bd20d9f15d69ffb623706
---
 protocol/tizen/tizen-extension.xml | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index 326a7c8..e46b083 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -22,11 +22,26 @@
   </interface>
 
   <interface name="tizen_resource" version="1">
-    <request name="destroy" type="destructor" />
+    <description summary="global resource id">
+      This tizen_resource provides a global resource id. It is a unique id
+      which is provided by the display server.
+    </description>
+
+    <request name="destroy" type="destructor">
+      <description summary="destroy tizen_resource">
+        Destroy this tizen_resource object.
+      </description>
+    </request>
 
     <event name="resource_id">
-      <arg name="id" type="uint" />
+      <description summary="a global resource id">
+        The resource_id event is sent immediately upon the tizen_resource object
+        creation by the display server. The id is a unique id which is generated
+        by the display server.
+      </description>
+      <arg name="id" type="uint" summary="the global resource id"/>
     </event>
+
   </interface>
 
   <interface name="tizen_policy" version="12">
-- 
2.7.4


From 02e94a77084a29cd907e0a0a09db0366897c76d5 Mon Sep 17 00:00:00 2001
From: SooChan Lim <sc1.lim@samsung.com>
Date: Fri, 23 Dec 2022 16:35:41 +0900
Subject: [PATCH 11/16] add the summary of wl_surface

Change-Id: Idc9ae852480d8ec7c86f5df8a760e06fd2ec5369
---
 protocol/tizen/tizen-extension.xml | 42 +++++++++++++++++++-------------------
 1 file changed, 21 insertions(+), 21 deletions(-)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index e46b083..4b0680d 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -490,7 +490,7 @@
     <request name="destroy" type="destructor"/>
 
     <request name="set_geometry">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="serial" type="uint" />
       <arg name="x" type="int"/>
       <arg name="y" type="int"/>
@@ -507,7 +507,7 @@
     <event name="geometry_done">
       <description summary="Notify of set_geometry request result">
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="serial" type="uint" />
       <arg name="x" type="int"/>
       <arg name="y" type="int"/>
@@ -652,11 +652,11 @@
     </request>
 
     <request name="select_palm_cover" since="2">
-      <arg name="surface" type="object" interface="wl_surface"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="deselect_palm_cover" since="2">
-      <arg name="surface" type="object" interface="wl_surface"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <event name="palm_cover_notify" since="2">
@@ -836,7 +836,7 @@
       </description>
     </request>
     <event name="event_surface" since="2">
-      <arg name="surface" type="object" interface="wl_surface"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="key" type="uint"/>
       <arg name="mode" type="uint"/>
     </event>
@@ -984,12 +984,12 @@
 
     <request name="get_object">
       <arg name="id" type="new_id" interface="tizen_video_object" />
-      <arg name="surface" type="object" interface="wl_surface" />
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="get_viewport">
       <arg name="id" type="new_id" interface="tizen_viewport" />
-      <arg name="surface" type="object" interface="wl_surface" />
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="destroy" type="destructor">
@@ -1457,7 +1457,7 @@
     <request name="pointer_warp">
       <description summary="warp pointer to the relative position to the given surface">
       </description>
-      <arg name="surface" type="object" interface="wl_surface"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="x" type="fixed"/>
       <arg name="y" type="fixed"/>
     </request>
@@ -1664,11 +1664,11 @@
      </enum>
      <request name="destroy" type="destructor" />
      <event name="start">
-       <arg name="surface" type="object" interface="wl_surface"/>
+       <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
        <arg name="type" type="uint" />
      </event>
      <event name="end">
-       <arg name="surface" type="object" interface="wl_surface"/>
+       <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
        <arg name="type" type="uint" />
      </event>
   </interface>
@@ -1680,12 +1680,12 @@
     </enum>
     <!-- for window brightness -->
     <request name="set_window_brightness">
-      <arg name="surface" type="object" interface="wl_surface"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="brightness" type="int"/>
     </request>
 
     <event name="window_brightness_done">
-      <arg name="surface" type="object" interface="wl_surface"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="brightness" type="int"/>
       <arg name="error_state" type="uint"/>
     </event>
@@ -1718,15 +1718,15 @@
 
     <request name="destroy" type="destructor"/>
     <request name="set_state">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="state" type="int" />
     </request>
     <request name="set_opacity_mode">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="mode" type="int" />
     </request>
     <request name="set_visible_type">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="type" type="int" />
     </request>
 
@@ -1744,17 +1744,17 @@
      <request name="show">
       <description summary="request for show clipboard">
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
      </request>
      <request name="hide">
       <description summary="request for hide clipboard">
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
      </request>
      <event name="data_selected">
       <description summary="announce data are selected by clipboard">
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
      </event>
 
      <!-- version 2 additions -->
@@ -1776,11 +1776,11 @@
 
   <interface name="tizen_screen_rotation" version="1">
     <request name="get_ignore_output_transform">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <event name="ignore_output_transform">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="ignore" type="uint"/>
     </event>
 
@@ -1795,7 +1795,7 @@
   <interface name="tizen_renderer" version="1">
     <request name="get_renderer_surface">
       <arg name="id" type="new_id" interface="tizen_renderer_surface" />
-      <arg name="surface" type="object" interface="wl_surface" />
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="destroy" type="destructor">
-- 
2.7.4


From dad9baf7f56686541dc4d5ac18737e43d7d1ca53 Mon Sep 17 00:00:00 2001
From: SooChan Lim <sc1.lim@samsung.com>
Date: Fri, 23 Dec 2022 16:33:14 +0900
Subject: [PATCH 12/16] tizen_policy: specify the descrption of the
 tizen_policy interface

Change-Id: Ifc13a0a7e8a2931a60cf6e9cd1a389d510c05557
---
 protocol/tizen/tizen-extension.xml | 627 +++++++++++++++++++++++++++----------
 1 file changed, 464 insertions(+), 163 deletions(-)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index 4b0680d..5db511e 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -10,7 +10,7 @@
         Create a tizen_resource interface for the given surface.
       </description>
       <arg name="id" type="new_id" interface="tizen_resource" summary="the new tizen_resource object"/>
-      <arg name="surface" type="object" interface="wl_surface" summary="the the surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="destroy" type="destructor">
@@ -45,293 +45,538 @@
   </interface>
 
   <interface name="tizen_policy" version="12">
+    <description summary="tizen-specific policy for window management">
+      The tizen_policy provides tizen-specific requests and events for window
+      management at Tizen Platform.
+
+      [TODO] Explain the window layer at the display server. Need to explain the
+      window layer to understand the requests and the events at tizen_policy
+      interface.
+    </description>
+
     <request name="get_visibility">
-      <arg name="id" type="new_id" interface="tizen_visibility" summary="new visibility object"/>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="get a visibility object">
+        Create a visibility interface for the given surface.
+      </description>
+      <arg name="id" type="new_id" interface="tizen_visibility" summary="the new visibility object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="get_position">
-      <arg name="id" type="new_id" interface="tizen_position" summary="new position object"/>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="get a position object">
+        Create a position interface for the given surface.
+        [TODO]: need to explain the relationship with zxdg_positioner_v6
+      </description>
+      <arg name="id" type="new_id" interface="tizen_position" summary="the new position object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="activate">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="activate the surface">
+        Activate the given surface. A client requests this when a client wants
+        to raise at the top of the windows stack in the window's layer at the
+        display server and also wants to get a keyboard focus from the display
+        server. However the display server does not always set the focus on the
+        reqested surface. It depends on the focus policy of the display server.
+        A client just demands a keyboard focus via this request.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="activate_below_by_res_id">
-      <arg name="res_id" type="uint" />
-      <arg name="below_res_id" type="uint" />
+      <description summary="activate the res_id and position below res_id">
+        Activate the surface associated with the given res_id and position it
+        below the surface associated with the below_res_id. A client uses this
+        reuquest when it want to change the order of the window stack with the
+        gloal resource ids which are the surfaces belonging to different
+        processes. However, this requestit does not work when the surface
+        associated with the below_res_id is a parent of the surface assicated
+        with the res_id.
+      </description>
+      <arg name="res_id" type="uint" summary="the global resource id"/>
+      <arg name="below_res_id" type="uint" summary="the global resource id"/>
     </request>
 
     <request name="raise">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="raise the surface">
+         This request raises the given surface to the top of the window stack
+         in a window layer. A client can decide the window layer with the
+         window_type for the given surface through the set_type request of
+         tizen_policy interface. The surface positions at the top in the window
+         layer.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="lower">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="lower the surface">
+        This request lowers the given surface to the bottom of the window stack
+        in a window layer. The surface positions at the bottom in the window
+        layer.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="lower_by_res_id">
-      <arg name="res_id" type="uint" />
+      <description summary="lower the res_id">
+        This request lowers the surface associated with the given res_id to the
+        bottom of the window stack in a window layer. The surface positions at
+        the bottom in the window layer.
+      </description>
+      <arg name="res_id" type="uint" summary="the global resource id"/>
     </request>
 
     <request name="set_focus_skip">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="be unable to be the focused surface">
+        This request makes the given surface unable to be the focused surface.
+        The display server must not give the focus to the surface.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="unset_focus_skip">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="enable to be the focused surface">
+        This request makes the given surface enable to be the focused surface.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="set_role">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
-      <arg name="role" type="string"/>
+      <description summary="set the role of the surface">
+        Give the role to the given surface. A client set the tizen-specific role
+        of the surface except for the role of xdg_surface interface,
+        xdg_top_level, xdg_popup and so on.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="role" type="string" summary="the name of the role"/>
     </request>
 
     <enum name="win_type">
-      <entry name="none" value="0"/>
-      <entry name="toplevel" value="1"/>
-      <entry name="fullscreen" value="2"/>
-      <entry name="maximized" value="3"/>
-      <entry name="transient" value="4"/>
-      <entry name="menu" value="5"/>
-      <entry name="dnd" value="6"/>
-      <entry name="custom" value="7"/>
-      <entry name="notification" value="8"/>
-      <entry name="utility" value="9"/>
-      <entry name="dialog" value="10"/>
-      <entry name="dock" value="11"/>
-      <entry name="splash" value="12"/>
-      <entry name="desktop" value="13" since="11"/>
+      <description summary="window type of the surface">
+        A client can set the window type through the set_type request with
+        win_type values. The value gives the surface the window_state, the
+        z-order at the window stack in the window layer and other types in the
+        display server.
+
+        The following values are window types with z-order values in descending
+        order. Those are notification, dnd, dock, splash, fullscreen,
+        toplevel or maximized and desktop.
+        The menu, dnd, notification, utility, dialog, dock, splash and desktop
+        are the window type which is defined in netwm spefification.
+        https://specifications.freedesktop.org/wm-spec/wm-spec-1.4.html#idm46148902270160
+      </description>
+      <entry name="none" value="0" summary="none"/>
+      <entry name="toplevel" value="1" summary="the toplevel"/>
+      <entry name="fullscreen" value="2" summary="the fullscreen state"/>
+      <entry name="maximized" value="3" summary="the maximize state"/>
+      <entry name="transient" value="4" summary="the transient relation state"/>
+      <entry name="menu" value="5" summary="the menu"/>
+      <entry name="dnd" value="6" summary="the dnd"/>
+      <entry name="custom" value="7" summary="the custom"/>
+      <entry name="notification" value="8" summary="the notification"/>
+      <entry name="utility" value="9" summary="the utility"/>
+      <entry name="dialog" value="10" summary="the dialog"/>
+      <entry name="dock" value="11" summary="the dock"/>
+      <entry name="splash" value="12" summary="the splash"/>
+      <entry name="desktop" value="13" since="11" summary="the desktop"/>
     </enum>
 
     <request name="set_type">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="win_type" type="uint" />
+      <description summary="set the type of the surface">
+        Set the type of the given surface. The display server use the window
+        type for the policy of the window management which are focus management,
+        visibility management, stack management and so on.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="win_type" type="uint" summary="the window type"/>
     </request>
 
     <!-- for conformant -->
     <request name="set_conformant">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="set the conformant(adaptational) surface">
+        Set the conformant surface. The conformant surface can get the event
+        through which the display server notifies the area covered by the
+        compormant_part that is the surface in another client.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="unset_conformant">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="unset the conformant(adaptational) surface">
+        Unset the conformant surface.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="get_conformant">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="check the conformant surface">
+        Ask if the given surface is the conformant surface or not. The display
+        server sents the result via the confirmant event.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <event name="conformant">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
-      <arg name="is_conformant" type="uint"/>
+      <description summary="conformant event">
+        Notify the client when a client sends the get_conformant request.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="is_conformant" type="uint" summary="if the surface is conformant or not, 0 or 1"/>
     </event>
 
     <enum name="conformant_part">
-      <entry name="indicator" value="0"/>
-      <entry name="keyboard" value="1"/>
-      <entry name="clipboard" value="2"/>
+      <description summary="the name of conformant part">
+        This value indicates the surface name at Tizen Platform.
+      </description>
+      <entry name="indicator" value="0" summary="the indicator surface"/>
+      <entry name="keyboard" value="1" summary="the keyboard surface"/>
+      <entry name="clipboard" value="2" summary="the clipboard surface"/>
     </enum>
 
     <event name="conformant_area">
-       <description summary="Notify of conformant area">
-          Notify of conformant area to client. Sending this event does NOT guarantee
-          perfect compositing of conformant owner client surface and
-          conformant part client surface.
-      </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
-      <arg name="conformant_part" type="uint"/>
-      <arg name="state" type="uint"/>
-      <arg name="x" type="int"/>
-      <arg name="y" type="int"/>
-      <arg name="w" type="int"/>
-      <arg name="h" type="int"/>
+      <description summary="conformant area event">
+        Notify a client when the conformant area is caclulated by the another
+        surface as the conformnat_part. This event does NOT guarantee the
+        perfect composition of the conformant surface and the surface of the
+        conformant part.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="conformant_part" type="uint" summary="the name of the conformant part"/>
+      <arg name="state" type="uint" summary="visible(1) or not(0)"/>
+      <arg name="x" type="int" summary="x position of the hiding area by conformant part"/>
+      <arg name="y" type="int" summary="y position of the hiding area by conformant part"/>
+      <arg name="w" type="int" summary="width of the hiding area by conformant part"/>
+      <arg name="h" type="int" summary="height of the hiding area by conformant part"/>
     </event>
 
     <enum name="error_state">
-      <entry name="none" value="0"/>
-      <entry name="permission_denied" value="1"/>
+      <description summary="error state">
+        This describes the state of error.
+      </description>
+      <entry name="none" value="0" summary="success"/>
+      <entry name="permission_denied" value="1" summary="the permission denied"/>
     </enum>
 
     <!-- for notification -->
     <enum name="level">
-      <entry name="1" value="0"/>
-      <entry name="2" value="1"/>
-      <entry name="3" value="2"/>
-      <entry name="none" value="-1"/>
-      <entry name="default" value="10"/>
-      <entry name="medium" value="20"/>
-      <entry name="high" value="30"/>
-      <entry name="top" value="40"/>
+      <description summary="notification level">
+        This is the level of the notification type. This level stands for the
+        z-order in the notification layer at the display server. The none, 1, 2,
+        3, default, medium, high and top is z-order in ascending order. The
+        lower number value means the lower z-order.
+      </description>
+      <entry name="1" value="0" summary="the bottom default z-order"/>
+      <entry name="2" value="1" summary="the bottom midium z-order"/>
+      <entry name="3" value="2" summary="the bottom high z-order"/>
+      <entry name="none" value="-1" summary="the bottom lowest z-order"/>
+      <entry name="default" value="10" summary="the default z-order"/>
+      <entry name="medium" value="20" summary="the medium z-order"/>
+      <entry name="high" value="30" summary="the high z-order"/>
+      <entry name="top" value="40" summary="the top z-order"/>
     </enum>
 
     <request name="set_notification_level">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="level" type="int"/>
+      <description summary="set the level in the notification">
+        This request sets the level in the notification layer. The display
+        server decides the z-order with the given level in the notification
+        layer.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="level" type="int" summary="the z-order value"/>
     </request>
 
     <event name="notification_done">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="level" type="int"/>
-      <arg name="error_state" type="uint"/>
+      <description summary="done event of set_notification request">
+        Notify a client when the surface is located in the z-order which has
+        been reuqested via the set_notification_level request.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="level" type="int" summary="the z-order value"/>
+      <arg name="error_state" type="uint" summary="the error type"/>
     </event>
 
     <!-- for transient_for -->
     <request name="set_transient_for">
-      <arg name="child_id" type="uint" />
-      <arg name="parent_id" type="uint" />
+      <description summary="set the transient parent for parent_id">
+        This request sets the transient parent for the surface associated with
+        the parent_id. The surface associated with the given child_id becomes
+        a transient children for the surface associated with the parent_id.
+      </description>
+      <arg name="child_id" type="uint" summary="the global resource id for the child surface"/>
+      <arg name="parent_id" type="uint" summary="the globacl resource is for the parent surface"/>
     </request>
 
     <request name="unset_transient_for">
-      <arg name="child_id" type="uint" />
+      <description summary="unset the transient parent/child relationship">
+        This reuqest unsets the transient parent on the surface associated with
+        the child_id.
+      </description>
+      <arg name="child_id" type="uint" summary="the global resource id for the child surface"/>
     </request>
 
     <event name="transient_for_done">
-      <arg name="child_id" type="uint"/>
+      <description summary="done event of set/unset transient_for">
+        Notify a client when the surface associated with the child_id is to set
+        the transient parent or when it is to unset the transient parent.
+      </description>
+      <arg name="child_id" type="uint" summary="the global resource id for the child surface"/>
     </event>
 
     <!-- for window_screen_mode -->
     <enum name="mode">
-      <entry name="default" value="0"/>
-      <entry name="always_on" value="1"/>
+      <description summary="screen mode">
+        This value means how the screen is to operate.
+      </description>
+      <entry name="default" value="0" summary="the default screen mode"/>
+      <entry name="always_on" value="1" summary="keep the screen turn on"/>
     </enum>
 
     <request name="set_window_screen_mode">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="mode" type="uint"/>
+      <description summary="set the screen mode to the surface">
+        A client sets the screen mode which it wants the screen to be as long as
+        the given surface is shown on the screen.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="mode" type="uint" summary="the screen mode"/>
     </request>
 
     <event name="window_screen_mode_done">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="mode" type="uint"/>
-      <arg name="error_state" type="uint"/>
+      <description summary="done event for set_window_screen_mode request">
+        Notify a client when the screen_mode from the client's request activates
+        in the display server.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="mode" type="uint" summary="the screen mode"/>
+      <arg name="error_state" type="uint" summary="the error type"/>
     </event>
 
     <!-- for subsurface -->
     <request name="place_subsurface_below_parent">
-      <arg name="subsurface" type="object" interface="wl_subsurface"/>
+      <description summary="place the subsurace below the parent surface">
+        This request places the surface of the subsurface below its' parent
+        surface.
+      </description>
+      <arg name="subsurface" type="object" interface="wl_subsurface" summary="the subsurface object"/>
     </request>
 
     <request name="set_subsurface_stand_alone">
-      <arg name="subsurface" type="object" interface="wl_subsurface"/>
+      <description summary="make the subsurface be a stand_alone mode">
+        This request makes the surface associated with the given subsurface not
+        follow the policy of the window managment triggered by the parent
+        surface. The window policy of the surface associated with the given
+        subsurface is not affected by its parent surface.
+      </description>
+      <arg name="subsurface" type="object" interface="wl_subsurface" summary="the subsurface object"/>
     </request>
 
     <request name="get_subsurface">
-      <arg name="id" type="new_id" interface="wl_subsurface" />
-      <arg name="surface" type="object" interface="wl_surface" />
-      <arg name="parent_id" type="uint" />
+      <description summary="get the subsurface of the surface with the parent_id">
+          Get the subsurface of the given surface with the global resource parent_id.
+      </description>
+      <arg name="id" type="new_id" interface="wl_subsurface" summary="the new subsurface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="parent_id" type="uint" summary="the global reosurce id"/>
     </request>
 
     <!-- for opaque_state -->
     <request name="set_opaque_state">
-      <arg name="surface" type="object" interface="wl_surface" />
+      <description summary="set the opaque state to the surface">
+      Set the opaque state to the given surface. The display server makes this
+      surface be opaque even if the color depth of the buffer attached to the
+      surface is 32 depth.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="state" type="int"/>
     </request>
 
     <!-- for iconify -->
     <request name="iconify">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="set the iconified state to the surface">
+        Set the iconified state to the given surface. The iconfied state is the
+        window state in which the surface is not showing on the screen.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
+
     <request name="uniconify">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="set the uniconified state to the surface">
+        Set the uniconified state to the given surface. The uniconfied state is
+        the window state in which the iconified surface is showing on the screen.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <event name="iconify_state_changed">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="iconified" type="uint"/>
-      <arg name="force" type="uint"/>
+      <description summary="change event of the iconfied state">
+        Notify a client when the iconfied state of the surface is changed. The
+        iconfied state is not only changed when the client requets the iconify
+        and uniconify but also changed when the iconfied state is decided by
+        the display server.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="iconified" type="uint" summary="the iconfied or uniconified state, 1 or 0"/>
+      <arg name="force" type="uint" summary="the iconfied is forced or not, 1 or 0"/>
     </event>
 
     <!-- for aux_hint -->
     <request name="add_aux_hint">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="id" type="int" />
-      <arg name="name" type="string" />
-      <arg name="value" type="string" />
+      <description summary="add the information of the auxiliary hint to the surface">
+        Add the information of the auxiliary hint to the given surface. The name
+        and the value are changed when the display server already has the same
+        id with which the client sends this request.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="id" type="int" summary="the id of the auxiliary hint"/>
+      <arg name="name" type="string" summary="the name of the auxiliary hint"/>
+      <arg name="value" type="string" summary="the vaule of the auxiliary hint"/>
     </request>
 
     <request name="change_aux_hint">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="id" type="int" />
-      <arg name="value" type="string" />
+      <description summary="change the value of the auxiliary hint to the surface">
+        Change the value of the auxiliary hint id which the surface has.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="id" type="int" summary="the id of the auxiliary hint"/>
+      <arg name="value" type="string" summary="the vaule of the auxiliary hint"/>
     </request>
 
     <request name="del_aux_hint">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="id" type="int" />
+      <description summary="delete the information of the auxiliry hint">
+        Delete the information of the auxiliary hint associated the hint id
+        which the given surface has.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="id" type="int" summary="the id of the auxiliary hint"/>
     </request>
 
     <request name="get_supported_aux_hints">
-      <arg name="surface" type="object" interface="wl_surface"/>
+      <description summary="get the aux hints">
+        Get the ids of the aux hints which the given surface supports. The
+        display server send the supported_aux_hints events as the reply of this
+        requrest.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <event name="supported_aux_hints">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="hints" type="array" />
-      <arg name="num_hints" type="uint"/>
+      <description summary="reply event for the get_supported_aux_hints request">
+        Notify a client when the display server get the get_supported_aux_hints
+        request. The display server send the id array of the suxiliary hints
+        which the surface supports.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="hints" type="array" summary="the id array of the auxiliary hints"/>
+      <arg name="num_hints" type="uint" summary="the number of hints"/>
     </event>
 
     <event name="allowed_aux_hint">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="id" type="int" />
+      <description summary="event of the allowed auxiliary hint">
+        Notify a client when the auxiliary hint which the given surface has is
+        added and changed.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="id" type="int" summary="the id of the auxiliary hint"/>
     </event>
 
     <!-- for aux_message -->
     <event name="aux_message">
-      <arg name="surface" type="object" interface="wl_surface" />
-      <arg name="key" type="string" />
-      <arg name="value" type="string" />
-      <arg name="options" type="array" />
+      <description summary="the auxiliary message event">
+        Notify a client when the display server sends the auxiliary message.
+        The display server can use this event when it notifies an additional
+        information to the client.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="key" type="string" summary="the key string"/>
+      <arg name="value" type="string" summary="the vaule of the key"/>
+      <arg name="options" type="array" summary="the array of option information"/>
     </event>
 
     <!-- for background state -->
     <request name="set_background_state">
-       <arg name="pid" type="uint" />
+      <description summary="set the background state">
+        Set the all surfaces associated with the given pid to be the background
+        state. The surfaces set to be the hide state and cannot show on a screen
+        even if the client send the show request and the activate request.
+      </description>
+       <arg name="pid" type="uint" summary="the process id"/>
     </request>
 
     <request name="unset_background_state">
-       <arg name="pid" type="uint" />
+      <description summary="unset the background state">
+        Set the all surfaces associated with the given pid not to be the
+        background state. The sufaces can allow to be showed and to be activated
+        by the client's request.
+      </description>
+       <arg name="pid" type="uint" summary="the process id"/>
     </request>
 
     <!-- for floating mode -->
     <request name="set_floating_mode">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="set the floating mode">
+        Set the floating mode to the given surface. The surface which sets to be
+        floating mode can be a partial window and can position over other
+        top-level windows.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="unset_floating_mode">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="unset the floating mode">
+        Unset the floating mode to the given surface. The geometry of the
+        surface does not change and the z-order of it can be the same as the
+        top-level windows.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <!-- for stack mode -->
     <enum name="stack_mode">
+      <description summary="mode for the relative stack order">
+        The set_stack_mode request uses this mode values.
+      </description>
       <entry name="none" value="0"/>
       <entry name="above" value="1"/>
       <entry name="below" value="2"/>
     </enum>
 
     <request name="set_stack_mode">
-      <arg name="surface" type="object" interface="wl_surface"/>
-      <arg name="mode" type="uint" />
+      <description summary="set the stack mode">
+        Set the stack mode to the given surface. The surface can changes the
+        z-order in the same layer by the stack mode.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="mode" type="uint" summary="the stack mode"/>
     </request>
 
     <request name="activate_above_by_res_id">
-      <arg name="res_id" type="uint" />
-      <arg name="above_res_id" type="uint" />
+      <description summary="activate and position over the above resource id">
+        Activate the surface associated with the given res_id which is the
+        global resource id and set to position over the surface assoicated with
+        the above_res_id.
+      </description>
+      <arg name="res_id" type="uint" summary="the global resource id"/>
+      <arg name="above_res_id" type="uint" summary="the globacl resource id"/>
     </request>
 
     <!-- version 2 additions -->
     <!-- for subsurface watcher -->
     <request name="get_subsurface_watcher" since="2">
-      <arg name="id" type="new_id" interface="tizen_subsurface_watcher" />
-      <arg name="surface" type="object" interface="wl_surface" />
+      <description summary="get the subsurface watcher">
+        Get the subsurface watcher associated with the given surface. A client
+        can get the information about the subsurface associated with the surface.
+      </description>
+      <arg name="id" type="new_id" interface="tizen_subsurface_watcher" summary="new tizen_subsurface_watcher object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <!-- version 3 additions -->
     <request name="set_parent" since="3">
-      <arg name="child" type="object" interface="wl_surface" />
-      <arg name="parent" type="object" interface="wl_surface" />
+      <description summary="set the parent">
+        Set the parent/client relationship. The child surface position over the
+        parent surface.
+      </description>
+      <arg name="child" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="parent" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <!-- version 4 additions -->
@@ -342,53 +587,71 @@
          If client is received this event, client should ack for it using
          tizen_policy@ack_conformant_region request.
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
-      <arg name="conformant_part" type="uint"/>
-      <arg name="state" type="uint"/>
-      <arg name="x" type="int"/>
-      <arg name="y" type="int"/>
-      <arg name="w" type="int"/>
-      <arg name="h" type="int"/>
-      <arg name="serial" type="uint"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="conformant_part" type="uint" summary="the name of the conformant part"/>
+      <arg name="state" type="uint" summary="visible(1) or not(0)"/>
+      <arg name="x" type="int" summary="x position of the hiding area by conformant part"/>
+      <arg name="y" type="int" summary="y position of the hiding area by conformant part"/>
+      <arg name="w" type="int" summary="width of the hiding area by conformant part"/>
+      <arg name="h" type="int" summary="height of the hiding area by conformant part"/>
+      <arg name="serial" type="uint" summary="serail number"/>
     </event>
 
     <request name="ack_conformant_region" since="4">
       <description summary="ack for tizen_policy@conformant_region">
-         A client can refresh its surface for applying new conformant region which
-         is from tizen_policy@conformant_region event. The client has to ack
-         after complete of its updates by this request.
+         A client can refresh its surface for applying new conformant region
+         which is from tizen_policy@conformant_region event. The client has to
+         ack after complete of its updates by this request.
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
-      <arg name="serial" type="uint"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="serial" type="uint" summary="serial number"/>
     </request>
 
     <request name="destroy" type="destructor" since="6">
       <description summary="destroy the tizen_policy">
-        Destroy the tizen_policy.
+        Destroy this tizen_policy object.
       </description>
     </request>
 
     <request name="has_video" since="7">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
-      <arg name="has" type="uint"/>
+      <description summary="check the tizen_video_object">
+        A cleint sends the information that it has the tizen_video_object to the
+        display server.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+      <arg name="has" type="uint" summary="1 is the tizen_video_object, or 0"/>
     </request>
 
     <request name="set_appid" since="7">
-       <arg name="pid" type="int" />
-       <arg name="appid" type="string" />
+      <description summary="set the application id">
+        Set the application id associated with the given pid.
+      </description>
+       <arg name="pid" type="int" summary="process id"/>
+       <arg name="appid" type="string" summary="application id"/>
     </request>
 
     <request name="show" since="8">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="notify showing the surface">
+        Notify showing the given surface. This request means that a client is
+        going to attach the buffer to the given surface. There is nothing to do
+        at the display server when a client sends this request.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="hide" since="8">
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <description summary="notify hiding the surface">
+        Notify hiding the given surface. This request means that a client is
+        going to attach the null buffer to the given surface. There is nothing
+        to do at the display server when a client sends this request.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
     </request>
 
     <request name="set_transient_for_below" since="9">
       <description summary="set transient_for and place under the transient_for parent">
-         This makes a relationship between parent and child. A child is always placed under a parent.
+         This makes a relationship between parent and child. A child is always
+         placed under a parent.
       </description>
       <arg name="child_id" type="uint" />
       <arg name="parent_id" type="uint" />
@@ -396,19 +659,20 @@
 
     <request name="set_parent_with_below" since="9">
       <description summary="set parent and place under the parent">
-         This makes a relationship between parent and child. A child is always placed under a parent.
-         Setting a null parent for a child window removes any parent-child relationship for the child.
+         This makes a relationship between parent and child. A child is always
+         placed under a parent. Setting a null parent for a child window removes
+         any parent-child relationship for the child.
       </description>
-      <arg name="child" type="object" interface="wl_surface" />
+      <arg name="child" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="parent" type="object" interface="wl_surface" allow-null="true"/>
     </request>
 
     <event name="interactive_move_done" since="10">
       <description summary="interactive move is done">
-         This event is sent when the display server finishes interactive moving the window.
-         The changed geometry of the window is sent together.
+         This event is sent when the display server finishes interactive moving
+         the window. The changed geometry of the window is sent together.
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="x" type="int" summary="x-position after move"/>
       <arg name="y" type="int" summary="y-position after move"/>
       <arg name="w" type="uint" summary="width after move"/>
@@ -418,10 +682,11 @@
 
     <event name="interactive_resize_done" since="10">
       <description summary="interactive resize is done">
-         This event is sent when the display server finishes interactive resizing the window.
-         The changed geometry of the window is sent together.
+         This event is sent when the display server finishes interactive
+         resizing the window. The changed geometry of the window is sent
+         together.
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="x" type="int" summary="x-position after resize"/>
       <arg name="y" type="int" summary="y-position after resize"/>
       <arg name="w" type="uint" summary="width after resize"/>
@@ -431,6 +696,9 @@
 
     <!-- for maximize direction -->
     <enum name="maximize_direction">
+      <description summary="direction values">
+        These values are used by the set_maximize_direction as the paremater.
+      </description>
       <entry name="none" value="0" summary="none. same to unmaximize"/>
       <entry name="all" value="1" summary="the full size of the screen"/>
       <entry name="left" value="2" summary="the left side of the screen"/>
@@ -443,29 +711,48 @@
       <description summary="set maximize direction">
          Set the maximize direction of the surface.
       </description>
-      <arg name="surface" type="object" interface="wl_surface" summary="surface object"/>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
       <arg name="direction" type="uint" enum="maximize_direction" summary="maximize direction"/>
     </request>
 
   </interface>
 
   <interface name="tizen_visibility" version="5">
-    <request name="destroy" type="destructor"/>
+    <description summary="tizen-specific visibility">
+      A client wants to know the visiblity information of the surface.
+    </description>
 
-    <enum name="visibility">
-      <entry name="unobscured" value="0"/>
-      <entry name="partially_obscured" value="1"/>
-      <entry name="fully_obscured" value="2"/>
-      <entry name="pre_unobscured" value="3" since="5"/>
-    </enum>
+    <request name="destroy" type="destructor">
+      <description summary="destroy the tizen_visibility">
+        Destroy this tizen_visiblity object.
+      </description>
+    </request>
+
+      <enum name="visibility">
+        <description summary="visibility type">
+          These are the visibilty types which tells how the surface assoicated
+          with the tizen_visibility resource is showing on a screen or not.
+        </description>
+        <entry name="unobscured" value="0" summary="fully showing on a screen"/>
+        <entry name="partially_obscured" value="1" summary="partially showing on a screen"/>
+        <entry name="fully_obscured" value="2" summary="not showing on a screen"/>
+        <entry name="pre_unobscured" value="3" since="5" summary="ready to be unobscured"/>
+      </enum>
 
     <event name="notify">
-      <arg name="visibility" type="uint"/>
+      <description summary="notify the visiblity state">
+        Notify a client when the visibility of the surface is changed.
+      </description>
+      <arg name="visibility" type="uint" summary="visiblity type"/>
     </event>
 
     <!-- Version 6 additions -->
 
     <event name="changed" since="5">
+      <description summary="notify the changed visiblity type">
+        Notify a client when the visibility of the surface is changed with the
+        extra vaule.
+      </description>
       <arg name="type" type="uint" enum="visibility" summary="changed visibility type"/>
       <arg name="option" type="uint" summary="extra value"/>
     </event>
@@ -473,16 +760,30 @@
   </interface>
 
   <interface name="tizen_position" version="1">
-    <request name="destroy" type="destructor"/>
+    <description summary="tizen-specific position">
+      A client can set the position information of the surface.
+    </description>
+
+    <request name="destroy" type="destructor">
+      <description summary="destroy the tizen_position">
+        Destroy this tizen_position object.
+      </description>
+    </request>
 
     <request name="set">
-      <arg name="x" type="int"/>
-      <arg name="y" type="int"/>
+      <description summary="set the position">
+        Set the position.
+      </description>
+      <arg name="x" type="int" summary="x position"/>
+      <arg name="y" type="int" summary="y position"/>
     </request>
 
     <event name="changed">
-      <arg name="x" type="int"/>
-      <arg name="y" type="int"/>
+      <description summary="event of position changed">
+        Notify a client when the posion is changed.
+      </description>
+      <arg name="x" type="int" summary="x position"/>
+      <arg name="y" type="int" summary="y position"/>
     </event>
   </interface>
 
-- 
2.7.4


From 026e0f87521b168b2e13de7398a6616764c07957 Mon Sep 17 00:00:00 2001
From: "duna.oh" <duna.oh@samsung.com>
Date: Fri, 9 Dec 2022 13:19:45 +0900
Subject: [PATCH 13/16] tizen_input_device_manager: add a request of
 init_generator_with_sync

Change-Id: Id4bfab87726622e10ae0fcee76d2030fe34a2ae3
---
 protocol/tizen/tizen-extension.xml | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index 5db511e..bb418dc 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -1620,7 +1620,7 @@
     <request name="destroy" type="destructor"/>
   </interface>
 
-  <interface name="tizen_input_device_manager" version="4">
+  <interface name="tizen_input_device_manager" version="5">
     <description summary="global input device manager object">
       Tizen input device manager is a global interface. This object has device add/remove events
       to provide tizen input device object to a client. This allows for a client to get the con
@@ -1829,6 +1829,14 @@
       </description>
       <arg name="max_count" type="int"/>
     </request>
+
+    <!-- version 5 additions -->
+    <request name="init_generator_with_sync" since="5">
+      <description summary="initialize input generator system with name synchronously">
+      </description>
+      <arg name="clas" type="uint" enum="clas"/>
+      <arg name="name" type="string" />
+    </request>
   </interface>
 
   <interface name="tizen_input_device" version="1">
-- 
2.7.4


From f7c6a0d704dd29c80f4d000e2995b1fe7d9278bf Mon Sep 17 00:00:00 2001
From: "duna.oh" <duna.oh@samsung.com>
Date: Fri, 9 Dec 2022 13:22:21 +0900
Subject: [PATCH 14/16] Package version up to 1.3.35

Change-Id: I3abb5273623014d309bf53b77ef8f23a14ea529c
---
 packaging/wayland-extension.spec | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packaging/wayland-extension.spec b/packaging/wayland-extension.spec
index 8cc29b1..7cc993d 100644
--- a/packaging/wayland-extension.spec
+++ b/packaging/wayland-extension.spec
@@ -2,7 +2,7 @@
 %define enable_examples 0
 
 Name:		wayland-extension
-Version:	1.3.34
+Version:	1.3.35
 Release:	0
 Summary:	Wayland extenstion protocols that add functionality not available in the Wayland core protocol
 License:	MIT
-- 
2.7.4


From 81c3045f4945127a50b03c7694d7a73ab56b28da Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Thu, 2 Mar 2023 16:02:30 +0900
Subject: [PATCH 15/16] tizen_policy: support pin_mode feature

Change-Id: Iacf7cdc7371888558ee3ba36d5f791618097b1e3
---
 protocol/tizen/tizen-extension.xml | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/protocol/tizen/tizen-extension.xml b/protocol/tizen/tizen-extension.xml
index bb418dc..8ac1db3 100644
--- a/protocol/tizen/tizen-extension.xml
+++ b/protocol/tizen/tizen-extension.xml
@@ -715,6 +715,19 @@
       <arg name="direction" type="uint" enum="maximize_direction" summary="maximize direction"/>
     </request>
 
+    <request name="set_pin_mode" since="12">
+      <description summary="set pin mode">
+         Set the pin mode of the surface.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+    </request>
+
+    <request name="unset_pin_mode" since="12">
+      <description summary="unset pin mode">
+         Unset the pin mode of the surface.
+      </description>
+      <arg name="surface" type="object" interface="wl_surface" summary="the surface object"/>
+    </request>
   </interface>
 
   <interface name="tizen_visibility" version="5">
-- 
2.7.4


From b941d63f1869017bed21884d9bb61951d61d2466 Mon Sep 17 00:00:00 2001
From: Doyoun Kang <doyoun.kang@samsung.com>
Date: Thu, 2 Mar 2023 16:18:28 +0900
Subject: [PATCH 16/16] Package version up to 1.3.36

Change-Id: I4f10238653e69059e4255de7e86ec1ca7bdaa067
---
 packaging/wayland-extension.spec | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packaging/wayland-extension.spec b/packaging/wayland-extension.spec
index 7cc993d..492631b 100644
--- a/packaging/wayland-extension.spec
+++ b/packaging/wayland-extension.spec
@@ -2,7 +2,7 @@
 %define enable_examples 0
 
 Name:		wayland-extension
-Version:	1.3.35
+Version:	1.3.36
 Release:	0
 Summary:	Wayland extenstion protocols that add functionality not available in the Wayland core protocol
 License:	MIT
-- 
2.7.4