1- /* Generated by wayland-scanner 1.22 .0 */
1+ /* Generated by wayland-scanner 1.24 .0 */
22
33#ifndef WLR_OUTPUT_MANAGEMENT_UNSTABLE_V1_CLIENT_PROTOCOL_H
44#define WLR_OUTPUT_MANAGEMENT_UNSTABLE_V1_CLIENT_PROTOCOL_H
@@ -445,9 +445,8 @@ struct zwlr_output_head_v1_listener {
445445 * However, do not assume that the name is a reflection of an
446446 * underlying DRM connector, X11 connection, etc.
447447 *
448- * If the compositor implements the xdg-output protocol and this
449- * head is enabled, the xdg_output.name event must report the same
450- * name.
448+ * If this head matches a wl_output, the wl_output.name event must
449+ * report the same name.
451450 *
452451 * The name event is sent after a wlr_output_head object is
453452 * created. This event is only sent once per object, and the name
@@ -468,9 +467,8 @@ struct zwlr_output_head_v1_listener {
468467 * underlying DRM connector or the display name of the underlying
469468 * X11 connection, etc.
470469 *
471- * If the compositor implements xdg-output and this head is
472- * enabled, the xdg_output.description must report the same
473- * description.
470+ * If this head matches a wl_output, the wl_output.description
471+ * event must report the same name.
474472 *
475473 * The description event is sent after a wlr_output_head object is
476474 * created. This event is only sent once per object, and the
@@ -486,6 +484,11 @@ struct zwlr_output_head_v1_listener {
486484 * This event describes the physical size of the head. This event
487485 * is only sent if the head has a physical size (e.g. is not a
488486 * projector or a virtual device).
487+ *
488+ * The physical size event is sent after a wlr_output_head object
489+ * is created. This event is only sent once per object, and the
490+ * physical size does not change over the lifetime of the
491+ * wlr_output_head object.
489492 * @param width width in millimeters of the output
490493 * @param height height in millimeters of the output
491494 */
@@ -568,9 +571,6 @@ struct zwlr_output_head_v1_listener {
568571 *
569572 * This event describes the manufacturer of the head.
570573 *
571- * This must report the same make as the wl_output interface does
572- * in its geometry event.
573- *
574574 * Together with the model and serial_number events the purpose is
575575 * to allow clients to recognize heads from previous sessions and
576576 * for example load head-specific configurations back.
@@ -583,6 +583,10 @@ struct zwlr_output_head_v1_listener {
583583 * other events but should be aware that there is an increased risk
584584 * of false positives.
585585 *
586+ * If sent, the make event is sent after a wlr_output_head object
587+ * is created and only sent once per object. The make does not
588+ * change over the lifetime of the wlr_output_head object.
589+ *
586590 * It is not recommended to display the make string in UI to users.
587591 * For that the string provided by the description event should be
588592 * preferred.
@@ -596,9 +600,6 @@ struct zwlr_output_head_v1_listener {
596600 *
597601 * This event describes the model of the head.
598602 *
599- * This must report the same model as the wl_output interface does
600- * in its geometry event.
601- *
602603 * Together with the make and serial_number events the purpose is
603604 * to allow clients to recognize heads from previous sessions and
604605 * for example load head-specific configurations back.
@@ -611,6 +612,10 @@ struct zwlr_output_head_v1_listener {
611612 * information from other events but should be aware that there is
612613 * an increased risk of false positives.
613614 *
615+ * If sent, the model event is sent after a wlr_output_head object
616+ * is created and only sent once per object. The model does not
617+ * change over the lifetime of the wlr_output_head object.
618+ *
614619 * It is not recommended to display the model string in UI to
615620 * users. For that the string provided by the description event
616621 * should be preferred.
@@ -636,6 +641,11 @@ struct zwlr_output_head_v1_listener {
636641 * events but should be aware that there is an increased risk of
637642 * false positives.
638643 *
644+ * If sent, the serial number event is sent after a wlr_output_head
645+ * object is created and only sent once per object. The serial
646+ * number does not change over the lifetime of the wlr_output_head
647+ * object.
648+ *
639649 * It is not recommended to display the serial_number string in UI
640650 * to users. For that the string provided by the description event
641651 * should be preferred.
0 commit comments