diff --git a/unstable/wlr-output-management-unstable-v1.xml b/unstable/wlr-output-management-unstable-v1.xml index a8f4718..d314fe1 100644 --- a/unstable/wlr-output-management-unstable-v1.xml +++ b/unstable/wlr-output-management-unstable-v1.xml @@ -39,7 +39,7 @@ interface version number is reset. - + This interface is a manager that allows reading and writing the current output device configuration. @@ -125,7 +125,7 @@ - + A head is an output device. The difference between a wl_output object and a head is that heads are advertised even if they are turned off. A head @@ -370,9 +370,53 @@ + + + + + + This event describes a stable port path for the head. + + The port is an arbitrary string identifying the port of the head, ie. + the physical connector the head is connected to. The port must be + stable across reboots and software upgrades, thus must not contain + runtime-allocated numbers (such as KMS connector names). The port must + be globally unique for the Wayland connection. + + This event is optional and might not be sent, e.g. if the head is + virtual or if the compositor doesn't have enough information to provide + a stable port path for this head. + + If sent, the make event is sent after a wlr_output_head object is + created and only sent once per object. The port path does not change + over the lifetime of the wlr_output_head object. + + + + + + + This event describes a stable device tag for the head. + + The device tag is an arbitrary string identifying the device the head + represents. The device tag must be stable across reboots and software + upgrades, thus must not contain e.g. data coming from manufacturer code + databases. The device tag is not unique: two heads may share the same + device tag. Compositors should do their best to avoid collisions as + much as possible. + + This event is optional and might not be sent, e.g. if the head is + virtual or if the compositor doesn't have enough information to provide + a stable device tag for this head. + + If sent, the make event is sent after a wlr_output_head object is + created and only sent once per object. The device tag does not change + over the lifetime of the wlr_output_head object. + + - + This object describes an output mode. @@ -427,7 +471,7 @@ - + This object is used by the client to describe a full output configuration. @@ -545,7 +589,7 @@ - + This object is used by the client to update a single head's configuration.