(multiple): Remove inconsistent line breaks
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@humanoriented.com>
Reviewed-by: Daniel Stone <daniels@collabora.com>
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"/>
