diff --git a/protocol/wlr-export-dmabuf-unstable-v1.xml b/protocol/wlr-export-dmabuf-unstable-v1.xml
index 751f7efbf..80ea012f5 100644
--- a/protocol/wlr-export-dmabuf-unstable-v1.xml
+++ b/protocol/wlr-export-dmabuf-unstable-v1.xml
@@ -43,7 +43,7 @@
- Capture the next frame of a an entire output.
+ Capture the next frame of an entire output.
+ summary="index of the plane the data in the object applies to"/>
diff --git a/protocol/wlr-foreign-toplevel-management-unstable-v1.xml b/protocol/wlr-foreign-toplevel-management-unstable-v1.xml
index 108133715..44505bbb6 100644
--- a/protocol/wlr-foreign-toplevel-management-unstable-v1.xml
+++ b/protocol/wlr-foreign-toplevel-management-unstable-v1.xml
@@ -58,7 +58,7 @@
-
+
This event indicates that the compositor is done sending events to the
zwlr_foreign_toplevel_manager_v1. The server will destroy the object
diff --git a/protocol/wlr-gamma-control-unstable-v1.xml b/protocol/wlr-gamma-control-unstable-v1.xml
index a9db76240..16e0be8b1 100644
--- a/protocol/wlr-gamma-control-unstable-v1.xml
+++ b/protocol/wlr-gamma-control-unstable-v1.xml
@@ -72,7 +72,7 @@
tables. At any time the compositor can send a failed event indicating that
this object is no longer valid.
- There must always be at most one gamma control object per output, which
+ There can only be at most one gamma control object per output, which
has exclusive access to this particular output. When the gamma control
object is destroyed, the gamma table is restored to its original value.
diff --git a/protocol/wlr-output-management-unstable-v1.xml b/protocol/wlr-output-management-unstable-v1.xml
index 411e2f049..541284a8c 100644
--- a/protocol/wlr-output-management-unstable-v1.xml
+++ b/protocol/wlr-output-management-unstable-v1.xml
@@ -156,8 +156,8 @@
not assume that the name is a reflection of an underlying DRM
connector, X11 connection, etc.
- If the compositor implements the xdg-output protocol and this head is
- enabled, the xdg_output.name event must report the same name.
+ If this head matches a wl_output, the wl_output.name event must report
+ the same name.
The name event is sent after a wlr_output_head object is created. This
event is only sent once per object, and the name does not change over
@@ -176,8 +176,8 @@
the make, model, serial of the underlying DRM connector or the display
name of the underlying X11 connection, etc.
- If the compositor implements xdg-output and this head is enabled,
- the xdg_output.description must report the same description.
+ If this head matches a wl_output, the wl_output.description event must
+ report the same name.
The description event is sent after a wlr_output_head object is created.
This event is only sent once per object, and the description does not
@@ -191,6 +191,10 @@
This event describes the physical size of the head. This event is only
sent if the head has a physical size (e.g. is not a projector or a
virtual device).
+
+ The physical size event is sent after a wlr_output_head object is created. This
+ event is only sent once per object, and the physical size does not change over
+ the lifetime of the wlr_output_head object.
@@ -264,9 +268,6 @@
This event describes the manufacturer of the head.
- This must report the same make as the wl_output interface does in its
- geometry event.
-
Together with the model and serial_number events the purpose is to
allow clients to recognize heads from previous sessions and for example
load head-specific configurations back.
@@ -278,6 +279,10 @@
identify the head by available information from other events but should
be aware that there is an increased risk of false positives.
+ If sent, the make event is sent after a wlr_output_head object is
+ created and only sent once per object. The make does not change over
+ the lifetime of the wlr_output_head object.
+
It is not recommended to display the make string in UI to users. For
that the string provided by the description event should be preferred.
@@ -288,9 +293,6 @@
This event describes the model of the head.
- This must report the same model as the wl_output interface does in its
- geometry event.
-
Together with the make and serial_number events the purpose is to
allow clients to recognize heads from previous sessions and for example
load head-specific configurations back.
@@ -302,6 +304,10 @@
identify the head by available information from other events but should
be aware that there is an increased risk of false positives.
+ If sent, the model event is sent after a wlr_output_head object is
+ created and only sent once per object. The model does not change over
+ the lifetime of the wlr_output_head object.
+
It is not recommended to display the model string in UI to users. For
that the string provided by the description event should be preferred.
@@ -323,6 +329,10 @@
available information from other events but should be aware that there
is an increased risk of false positives.
+ If sent, the serial number event is sent after a wlr_output_head object
+ is created and only sent once per object. The serial number does not
+ change over the lifetime of the wlr_output_head object.
+
It is not recommended to display the serial_number string in UI to
users. For that the string provided by the description event should be
preferred.
diff --git a/protocol/wlr-output-power-management-unstable-v1.xml b/protocol/wlr-output-power-management-unstable-v1.xml
index a97783991..20dbb7760 100644
--- a/protocol/wlr-output-power-management-unstable-v1.xml
+++ b/protocol/wlr-output-power-management-unstable-v1.xml
@@ -50,7 +50,7 @@
- Create a output power management mode control that can be used to
+ Create an output power management mode control that can be used to
adjust the power management mode for a given output.
@@ -79,7 +79,7 @@
-
+
diff --git a/protocol/wlr-screencopy-unstable-v1.xml b/protocol/wlr-screencopy-unstable-v1.xml
index 50b1b7d2a..85b57d7ea 100644
--- a/protocol/wlr-screencopy-unstable-v1.xml
+++ b/protocol/wlr-screencopy-unstable-v1.xml
@@ -88,7 +88,7 @@
supported buffer type. The "buffer_done" event is sent afterwards to
indicate that all supported buffer types have been enumerated. The client
will then be able to send a "copy" request. If the capture is successful,
- the compositor will send a "flags" followed by a "ready" event.
+ the compositor will send a "flags" event followed by a "ready" event.
For objects version 2 or lower, wl_shm buffers are always supported, ie.
the "buffer" event is guaranteed to be sent.
@@ -114,12 +114,12 @@
- Copy the frame to the supplied buffer. The buffer must have a the
+ Copy the frame to the supplied buffer. The buffer must have the
correct size, see zwlr_screencopy_frame_v1.buffer and
zwlr_screencopy_frame_v1.linux_dmabuf. The buffer needs to have a
supported format.
- If the frame is successfully copied, a "flags" and a "ready" events are
+ If the frame is successfully copied, "flags" and "ready" events are
sent. Otherwise, a "failed" event is sent.
@@ -147,8 +147,7 @@
Called as soon as the frame is copied, indicating it is available
- for reading. This event includes the time at which presentation happened
- at.
+ for reading. This event includes the time at which the presentation took place.
The timestamp is expressed as tv_sec_hi, tv_sec_lo, tv_nsec triples,
each component being an unsigned 32-bit value. Whole seconds are in