input-method, text: update descriptions 74/53074/1
authorLi Zhang <li2012.zhang@samsung.com>
Tue, 1 Dec 2015 13:00:16 +0000 (21:00 +0800)
committerLi Zhang <li2012.zhang@samsung.com>
Tue, 1 Dec 2015 13:06:12 +0000 (21:06 +0800)
Change-Id: Ieae3f3819a205e616783b2c9818fd2960515c9d0

protocol/input-method.xml
protocol/text.xml

index a10d3f0..87feca8 100644 (file)
@@ -25,7 +25,6 @@
     THIS SOFTWARE.
   </copyright>
 
-
   <interface name="wl_input_method_context" version="1">
     <description summary="input method context">
       Corresponds to a text model on input method side. An input method context
     </request>
     <request name="preedit_styling">
       <description summary="pre-edit styling">
-        Sets styling information on composing text. The style is applied for
-       length in bytes from index relative to the beginning of
-       the composing text (as byte offset). Multiple styles can
-       be applied to a composing text.
+        Set styling information on composing text. The style is applied for
+        length in bytes from index relative to the beginning of the composing
+        text (as byte offset). Multiple styles can be applied to a composing
+        text.
 
         This request should be sent before sending preedit_string request.
       </description>
@@ -88,7 +87,7 @@
     </request>
     <request name="preedit_cursor">
       <description summary="pre-edit cursor">
-        Sets the cursor position inside the composing text (as byte offset)
+        Set the cursor position inside the composing text (as byte offset)
         relative to the start of the composing text.
 
         When index is negative no cursor should be displayed.
@@ -99,8 +98,6 @@
     </request>
     <request name="delete_surrounding_text">
       <description summary="delete text">
-
-
         This request will be handled on text_input side as part of a directly
         following commit_string request.
       </description>
     </request>
     <request name="cursor_position">
       <description summary="set cursor to a new position">
-        Sets the cursor and anchor to a new position. Index is the new cursor
+        Set the cursor and anchor to a new position. Index is the new cursor
         position in bytes (when >= 0 relative to the end of inserted text
         else relative to beginning of inserted text). Anchor is the new anchor
         position in bytes (when >= 0 relative to the end of inserted text, else
 
     <request name="set_toplevel">
       <description summary="set the surface type as a keyboard">
-       A keyboard surface is only shown, when a text model is active
+        A keyboard surface is only shown, when a text model is active.
       </description>
       <arg name="output" type="object" interface="wl_output"/>
       <arg name="position" type="uint"/>
index 454a531..9a4e6ad 100644 (file)
@@ -28,7 +28,7 @@
 
   <interface name="wl_text_input" version="1">
     <description summary="text input">
-      An object used for text input. Adds support for text input and input 
+      An object used for text input. Adds support for text input and input
       methods to applications. A text-input object is created from a
       wl_text_input_manager and corresponds typically to a text entry in an
       application.
@@ -50,7 +50,7 @@
     </description>
     <request name="activate">
       <description summary="request activation">
-        Requests the text-input object to be activated (typically when the 
+        Requests the text-input object to be activated (typically when the
         text entry gets focus).
         The seat argument is a wl_seat which maintains the focus for this
         activation. The surface argument is a wl_surface assigned to the
@@ -86,8 +86,8 @@
       </description>
     </request>
     <request name="set_surrounding_text">
-      <description summary="sets the surrounding text">
-        Sets the plain surrounding text around the input position. Text is
+      <description summary="set the surrounding text">
+        Set the plain surrounding text around the input position. Text is
         UTF-8 encoded. Cursor is the byte offset within the
         surrounding text. Anchor is the byte offset of the
         selection anchor within the surrounding text. If there is no selected
     </enum>
     <request name="set_content_type">
       <description summary="set content purpose and hint">
-        Sets the content purpose and content hint. While the purpose is the
+        Set the content purpose and content hint. While the purpose is the
         basic purpose of an input field, the hint flags allow to modify some
         of the behavior.
 
       <arg name="height" type="int"/>
     </request>
     <request name="set_preferred_language">
-      <description summary="sets preferred language">
-        Sets a specific language. This allows for example a virtual keyboard to
-        show a language specific layout. The "language" argument is a RFC-3066 
-       format language tag.
+      <description summary="set preferred language">
+        Set a specific language. This allows for example a virtual keyboard to
+        show a language specific layout. The "language" argument is a RFC-3066
+        format language tag.
 
-       It could be used for example in a word processor to indicate language of
-       currently edited document or in an instant message application which tracks
-       languages of contacts.
+        It could be used for example in a word processor to indicate language of
+        currently edited document or in an instant message application which tracks
+        languages of contacts.
       </description>
       <arg name="language" type="string"/>
     </request>
     </enum>
     <request name="set_return_key_type">
       <description summary="set return key type">
-        Sets the return key type.
+        Set the return key type.
       </description>
       <arg name="return_key_type" type="uint"/>
     </request>
         be removed.
 
         The commit text can be used to replace the preedit text on reset
-       (for example on unfocus).
+        (for example on unfocus).
 
-       The text input should also handle all preedit_style and preedit_cursor
-       events occurring directly before preedit_string.
+        The text input should also handle all preedit_style and preedit_cursor
+        events occurring directly before preedit_string.
       </description>
       <arg name="serial" type="uint" summary="serial of the latest known text input state"/>
       <arg name="text" type="string"/>
     </enum>
     <event name="preedit_styling">
       <description summary="pre-edit styling">
-        Sets styling information on composing text. The style is applied for
-       length bytes from index relative to the beginning of the composing 
-       text (as byte offset). Multiple styles can
-        be applied to a composing text by sending multiple preedit_styling
-        events.
+        Set styling information on composing text. The style is applied for
+        length bytes from index relative to the beginning of the composing
+        text (as byte offset). Multiple styles can be applied to a composing
+        text by sending multiple preedit_styling events.
 
         This event is handled as part of a following preedit_string event.
       </description>
     </event>
     <event name="preedit_cursor">
       <description summary="pre-edit cursor">
-        Sets the cursor position inside the composing text (as byte
+        Set the cursor position inside the composing text (as byte
         offset) relative to the start of the composing text. When index is a
         negative number no cursor is shown.
 
     </event>
     <event name="language">
       <description summary="language">
-        Sets the language of the input text. The "language" argument is a RFC-3066 
+        Set the language of the input text. The "language" argument is a RFC-3066
         format language tag.
       </description>
       <arg name="serial" type="uint" summary="serial of the latest known text input state"/>
     </enum>
     <event name="text_direction">
       <description summary="text direction">
-        Sets the text direction of input text.
+        Set the text direction of input text.
 
         It is mainly needed for showing input cursor on correct side of the
         editor when there is no input yet done and making sure neutral