[PATCH wayland-protocols 1/1] (multiple): Remove inconsistent line breaks

Yong Bakos junk at humanoriented.com
Mon Oct 31 13:43:52 UTC 2016


From: Yong Bakos <ybakos at humanoriented.com>

Enum entries and message arguments are sometimes preceded by a blank line, but
often aren't.

Standardize the format of the protocol specification by removing blank lines
preceding a list of message arguments and enum entries.

Signed-off-by: Yong Bakos <ybakos at humanoriented.com>
---
 stable/presentation-time/presentation-time.xml                   | 5 -----
 stable/viewporter/viewporter.xml                                 | 3 ---
 unstable/linux-dmabuf/linux-dmabuf-unstable-v1.xml               | 7 -------
 unstable/pointer-constraints/pointer-constraints-unstable-v1.xml | 5 -----
 unstable/relative-pointer/relative-pointer-unstable-v1.xml       | 2 --
 unstable/tablet/tablet-unstable-v1.xml                           | 1 -
 unstable/tablet/tablet-unstable-v2.xml                           | 1 -
 unstable/xdg-foreign/xdg-foreign-unstable-v1.xml                 | 4 ----
 unstable/xdg-shell/xdg-shell-unstable-v5.xml                     | 2 --
 unstable/xdg-shell/xdg-shell-unstable-v6.xml                     | 4 ----
 10 files changed, 34 deletions(-)

diff --git a/stable/presentation-time/presentation-time.xml b/stable/presentation-time/presentation-time.xml
index e449b37..a46994c 100644
--- a/stable/presentation-time/presentation-time.xml
+++ b/stable/presentation-time/presentation-time.xml
@@ -81,7 +81,6 @@
         For details on what information is returned, see the
         presentation_feedback interface.
       </description>
-
       <arg name="surface" type="object" interface="wl_surface"
            summary="target surface"/>
       <arg name="callback" type="new_id" interface="wp_presentation_feedback"
@@ -120,7 +119,6 @@
         recommended. Clients must be able to query the current clock
         value directly, not by asking the compositor.
       </description>
-
       <arg name="clk_id" type="uint" summary="platform clock identifier"/>
     </event>

@@ -152,7 +150,6 @@
         the synchronized output. If a client has not bound to the
         right wl_output global at all, this event is not sent.
       </description>
-
       <arg name="output" type="object" interface="wl_output"
            summary="presentation output"/>
     </event>
@@ -192,7 +189,6 @@
         Possible zero-copy cases include direct scanout of a
         fullscreen surface and a surface on a hardware overlay.
       </description>
-
       <entry name="vsync" value="0x1" summary="presentation was vsync'd"/>
       <entry name="hw_clock" value="0x2"
              summary="hardware provided the presentation timestamp"/>
@@ -246,7 +242,6 @@
         a way to query the refresh count, then the arguments seq_hi
         and seq_lo must be zero.
       </description>
-
       <arg name="tv_sec_hi" type="uint"
            summary="high 32 bits of the seconds part of the presentation timestamp"/>
       <arg name="tv_sec_lo" type="uint"
diff --git a/stable/viewporter/viewporter.xml b/stable/viewporter/viewporter.xml
index 5d006c0..c732d8c 100644
--- a/stable/viewporter/viewporter.xml
+++ b/stable/viewporter/viewporter.xml
@@ -54,7 +54,6 @@
 	a wp_viewport object associated, the viewport_exists
 	protocol error is raised.
       </description>
-
       <arg name="id" type="new_id" interface="wp_viewport"
            summary="the new viewport interface id"/>
       <arg name="surface" type="object" interface="wl_surface"
@@ -159,7 +158,6 @@
 	The crop and scale state is double-buffered state, and will be
 	applied on the next wl_surface.commit.
       </description>
-
       <arg name="x" type="fixed" summary="source rectangle x"/>
       <arg name="y" type="fixed" summary="source rectangle y"/>
       <arg name="width" type="fixed" summary="source rectangle width"/>
@@ -180,7 +178,6 @@
 	The crop and scale state is double-buffered state, and will be
 	applied on the next wl_surface.commit.
       </description>
-
       <arg name="width" type="int" summary="surface width"/>
       <arg name="height" type="int" summary="surface height"/>
     </request>
diff --git a/unstable/linux-dmabuf/linux-dmabuf-unstable-v1.xml b/unstable/linux-dmabuf/linux-dmabuf-unstable-v1.xml
index 3b4861f..a07540e 100644
--- a/unstable/linux-dmabuf/linux-dmabuf-unstable-v1.xml
+++ b/unstable/linux-dmabuf/linux-dmabuf-unstable-v1.xml
@@ -127,22 +127,16 @@
     <enum name="error">
       <entry name="already_used" value="0"
              summary="the dmabuf_batch object has already been used to create a wl_buffer"/>
-
       <entry name="plane_idx" value="1"
              summary="plane index out of bounds"/>
-
       <entry name="plane_set" value="2"
              summary="the plane index was already set"/>
-
       <entry name="incomplete" value="3"
              summary="missing or too many planes to create a buffer"/>
-
       <entry name="invalid_format" value="4"
              summary="format not supported"/>
-
       <entry name="invalid_dimensions" value="5"
              summary="invalid width or height"/>
-
       <entry name="out_of_bounds" value="6"
              summary="offset + stride * height goes out of dmabuf bounds"/>
     </enum>
@@ -170,7 +164,6 @@
         The error PLANE_SET is raised if attempting to set a plane that
         was already set.
       </description>
-
       <arg name="fd" type="fd" summary="dmabuf fd"/>
       <arg name="plane_idx" type="uint" summary="plane index"/>
       <arg name="offset" type="uint" summary="offset in bytes"/>
diff --git a/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml b/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml
index 4b95a5c..4e67a13 100644
--- a/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml
+++ b/unstable/pointer-constraints/pointer-constraints-unstable-v1.xml
@@ -140,7 +140,6 @@
 	objects of the same seat. wl_pointer.axis and wl_pointer.button events
 	are unaffected.
       </description>
-
       <arg name="id" type="new_id" interface="zwp_locked_pointer_v1"/>
       <arg name="surface" type="object" interface="wl_surface"
 	   summary="surface to lock pointer to"/>
@@ -171,7 +170,6 @@
 	state. See the the description of wp_confined_pointer for further
 	information.
       </description>
-
       <arg name="id" type="new_id" interface="zwp_confined_pointer_v1"/>
       <arg name="surface" type="object" interface="wl_surface"
 	   summary="surface to lock pointer to"/>
@@ -231,7 +229,6 @@
 	effect when the associated surface gets it pending state applied. See
 	wl_surface.commit for details.
       </description>
-
       <arg name="surface_x" type="fixed"
 	   summary="surface-local x coordinate"/>
       <arg name="surface_y" type="fixed"
@@ -248,7 +245,6 @@

 	For details about the lock region, see wp_locked_pointer.
       </description>
-
       <arg name="region" type="object" interface="wl_region" allow-null="true"
 	   summary="region of surface"/>
     </request>
@@ -317,7 +313,6 @@

 	For details about the confine region, see wp_confined_pointer.
       </description>
-
       <arg name="region" type="object" interface="wl_region" allow-null="true"
 	   summary="region of surface"/>
     </request>
diff --git a/unstable/relative-pointer/relative-pointer-unstable-v1.xml b/unstable/relative-pointer/relative-pointer-unstable-v1.xml
index 24935a3..ca6f81d 100644
--- a/unstable/relative-pointer/relative-pointer-unstable-v1.xml
+++ b/unstable/relative-pointer/relative-pointer-unstable-v1.xml
@@ -68,7 +68,6 @@
 	Create a relative pointer interface given a wl_pointer object. See the
 	wp_relative_pointer interface for more details.
       </description>
-
       <arg name="id" type="new_id" interface="zwp_relative_pointer_v1"/>
       <arg name="pointer" type="object" interface="wl_pointer"/>
     </request>
@@ -119,7 +118,6 @@
 	from a wl_pointer object of the same seat that the wp_relative_pointer
 	object is associated with.
       </description>
-
       <arg name="utime_hi" type="uint"
 	   summary="high 32 bits of a 64 bit timestamp with microsecond granularity"/>
       <arg name="utime_lo" type="uint"
diff --git a/unstable/tablet/tablet-unstable-v1.xml b/unstable/tablet/tablet-unstable-v1.xml
index c5f58e9..6db9c05 100644
--- a/unstable/tablet/tablet-unstable-v1.xml
+++ b/unstable/tablet/tablet-unstable-v1.xml
@@ -542,7 +542,6 @@
 	wp_tablet_tool.proximity_in and wp_tablet_tool.proximity_out for
 	details.
       </description>
-
       <arg name="serial" type="uint"/>
       <arg name="button" type="uint" summary="The button whose state has changed"/>
       <arg name="state" type="uint" enum="button_state" summary="Whether the button was pressed or released"/>
diff --git a/unstable/tablet/tablet-unstable-v2.xml b/unstable/tablet/tablet-unstable-v2.xml
index 728a3df..b286d96 100644
--- a/unstable/tablet/tablet-unstable-v2.xml
+++ b/unstable/tablet/tablet-unstable-v2.xml
@@ -556,7 +556,6 @@
 	wp_tablet_tool.proximity_in and wp_tablet_tool.proximity_out for
 	details.
       </description>
-
       <arg name="serial" type="uint"/>
       <arg name="button" type="uint" summary="The button whose state has changed"/>
       <arg name="state" type="uint" enum="button_state" summary="Whether the button was pressed or released"/>
diff --git a/unstable/xdg-foreign/xdg-foreign-unstable-v1.xml b/unstable/xdg-foreign/xdg-foreign-unstable-v1.xml
index c6f5775..062b090 100644
--- a/unstable/xdg-foreign/xdg-foreign-unstable-v1.xml
+++ b/unstable/xdg-foreign/xdg-foreign-unstable-v1.xml
@@ -80,7 +80,6 @@
 	be used to create a xdg_imported multiple times. Only xdg_surface
 	surfaces may be exported.
       </description>
-
       <arg name="id" type="new_id" interface="zxdg_exported_v1"
 	   summary="the new xdg_exported object"/>
       <arg name="surface" type="object" interface="wl_surface"
@@ -110,7 +109,6 @@
 	represents the imported surface, and the importing client can
 	manipulate its relationship using it. See xdg_imported for details.
       </description>
-
       <arg name="id" type="new_id" interface="zxdg_imported_v1"
 	   summary="the new xdg_imported object"/>
       <arg name="handle" type="string"
@@ -141,7 +139,6 @@
 	import the surface by calling xdg_importer.import. A handle may be
 	used to import the surface multiple times.
       </description>
-
       <arg name="handle" type="string" summary="the exported surface handle"/>
     </event>
   </interface>
@@ -168,7 +165,6 @@
 	sets up a surface to surface relation with the same stacking and positioning
 	semantics as xdg_surface.set_parent.
       </description>
-
       <arg name="surface" type="object" interface="wl_surface"
 	   summary="the child surface"/>
     </request>
diff --git a/unstable/xdg-shell/xdg-shell-unstable-v5.xml b/unstable/xdg-shell/xdg-shell-unstable-v5.xml
index 542491f..ef0180d 100644
--- a/unstable/xdg-shell/xdg-shell-unstable-v5.xml
+++ b/unstable/xdg-shell/xdg-shell-unstable-v5.xml
@@ -234,7 +234,6 @@
         This request must be used in response to some sort of user action
         like a button press, key press, or touch down event.
       </description>
-
       <arg name="seat" type="object" interface="wl_seat" summary="the wl_seat of the user event"/>
       <arg name="serial" type="uint" summary="the serial of the user event"/>
       <arg name="x" type="int" summary="the x position to pop up the window menu at"/>
@@ -396,7 +395,6 @@
         can respond to one, it is free to discard all but the last
         event it received.
       </description>
-
       <arg name="width" type="int"/>
       <arg name="height" type="int"/>
       <arg name="states" type="array"/>
diff --git a/unstable/xdg-shell/xdg-shell-unstable-v6.xml b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
index 6053e3c..e49d74f 100644
--- a/unstable/xdg-shell/xdg-shell-unstable-v6.xml
+++ b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
@@ -247,7 +247,6 @@
 	The adjustments can be combined, according to a defined precedence: 1)
 	Flip, 2) Slide, 3) Resize.
       </description>
-
       <entry name="none" value="0">
 	<description summary="don't move the child surface when constrained">
 	  Don't alter the surface position even if it is constrained on some
@@ -595,7 +594,6 @@
 	This request must be used in response to some sort of user action
 	like a button press, key press, or touch down event.
       </description>
-
       <arg name="seat" type="object" interface="wl_seat" summary="the wl_seat of the user event"/>
       <arg name="serial" type="uint" summary="the serial of the user event"/>
       <arg name="x" type="int" summary="the x position to pop up the window menu at"/>
@@ -894,7 +892,6 @@
 	Clients must send an ack_configure in response to this event. See
 	xdg_surface.configure and xdg_surface.ack_configure for details.
       </description>
-
       <arg name="width" type="int"/>
       <arg name="height" type="int"/>
       <arg name="states" type="array"/>
@@ -1009,7 +1006,6 @@
 	"owner-events" grab in X11 parlance), while the top most grabbing popup
 	will always have keyboard focus.
       </description>
-
       <arg name="seat" type="object" interface="wl_seat"
 	   summary="the wl_seat of the user event"/>
       <arg name="serial" type="uint" summary="the serial of the user event"/>
--
2.7.2



More information about the wayland-devel mailing list