X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=protocol%2Fagl-shell-desktop.xml;h=e4445bd071f242b229789c68dc71d04ea2eed140;hb=HEAD;hp=e7b94935b3d6ec6f42ffbe896605615c7394af88;hpb=40d739400f4aeaaeb24440cc76fbf1d673323aa8;p=src%2Fagl-compositor.git

diff --git a/protocol/agl-shell-desktop.xml b/protocol/agl-shell-desktop.xml
index e7b9493..e4445bd 100644
--- a/protocol/agl-shell-desktop.xml
+++ b/protocol/agl-shell-desktop.xml
@@ -22,14 +22,14 @@
     FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     DEALINGS IN THE SOFTWARE.
   </copyright>
-  <interface name="agl_shell_desktop" version="1">
+  <interface name="agl_shell_desktop" version="2">
     <description summary="Private extension to allow applications activate other apps">
       This extension can be used by regular application to instruct to compositor
       to activate or switch to other running (regular) applications. The client
-      is responsbile for filtering their own app_id when receiving application id.
+      is responsible for filtering their own app_id when receiving application id.
 
-      Note that other (regular) applications can bind to this interface and there is
-      no mechanism to place to restrict or limit that.
+      The compositor will allow clients to bind to this interface only if the
+      policy engine allows it.
     </description>
 
     <enum name="app_role">
@@ -43,6 +43,7 @@
     <enum name="app_state">
       <entry name="activated" value="0"/>
       <entry name="deactivated" value="1"/>
+      <entry name="destroyed" value="2"/>
     </enum>
 
     <event name="application">
@@ -117,7 +118,7 @@
         Ask the compositor to hide the toplevel window for window
         management purposes. Depending on the window role, this request
         will either display the previously active window (or the background
-        in case there's no previously activate surface) or temporarly (or
+        in case there's no previously active surface) or temporarily (or
         until a 'activate_app' is called upon) hide the surface. All
         the surfaces are identifiable by using the app_id, and no actions are
         taken in case the app_id is not/was not present.
@@ -138,5 +139,25 @@
       <arg name="role" type="uint" enum="app_role"/>
     </event>
 
+    <!-- Version 2 addition -->
+    <request name="set_app_property_mode" since="2">
+      <description summary="Request to change the application properties lifetime">
+        Use this request to inform the compositor to maintain a pending state
+        for an app_id being set with set_app_property() request. Any
+        subsequent application matching that app_id would survive a potential
+        application destruction. Note that this request will take effect
+        globally on all applications.
+
+        To turn it on, or off, use the 'permanent' argument. Initially,
+        the compositor will have this option set to off. Note that it
+        doesn't matter the order of this request with respect to
+        set_app_property() request, as the changes will only take effect
+        when the application itself does the commit with an app_id set,
+        therefore the only requirement is to call this request before
+        the app_id client does its first commit.
+      </description>
+      <arg name="permanent" type="uint"/>
+    </request>
+
   </interface>
 </protocol>