docs: Improve wl_keyboard protocol docs

Some descriptions were missing here.
This commit is contained in:
Matthias Clasen 2013-03-30 01:11:42 -04:00 committed by Kristian Høgsberg
parent 3f4008acb3
commit 608d81bfd5

View file

@ -1313,19 +1313,21 @@
<interface name="wl_keyboard" version="1"> <interface name="wl_keyboard" version="1">
<description summary="keyboard input device"> <description summary="keyboard input device">
The wl_keyboard interface represents one or more keyboards
associated with a seat.
</description> </description>
<enum name="keymap_format"> <enum name="keymap_format">
<description summary="keyboard mapping format"> <description summary="keyboard mapping format">
This enum specifies the format of the keymap provided to the client This specifies the format of the keymap provided to the
with the wl_keyboard::keymap event. client with the wl_keyboard.keymap event.
</description> </description>
<entry name="xkb_v1" value="1" description="libxkbcommon compatible"/> <entry name="xkb_v1" value="1" description="libxkbcommon compatible"/>
</enum> </enum>
<event name="keymap"> <event name="keymap">
<description summary="keyboard mapping"> <description summary="keyboard mapping">
This event provides a file descriptor to the client which can be This event provides a file descriptor to the client which can be
memory-mapped to provide a keyboard mapping description. memory-mapped to provide a keyboard mapping description.
</description> </description>
<arg name="format" type="uint"/> <arg name="format" type="uint"/>
@ -1334,19 +1336,30 @@
</event> </event>
<event name="enter"> <event name="enter">
<description summary="enter event">
Notification that this seat's keyboard focus is on a certain
surface.
</description>
<arg name="serial" type="uint"/> <arg name="serial" type="uint"/>
<arg name="surface" type="object" interface="wl_surface"/> <arg name="surface" type="object" interface="wl_surface"/>
<arg name="keys" type="array"/> <arg name="keys" type="array" summary="the currently pressed keys"/>
</event> </event>
<event name="leave"> <event name="leave">
<description summary="leave event">
Notification that this seat's keyboard focus is no longer on
a certain surface.
The leave notification is sent before the enter notification
for the new focus.
</description>
<arg name="serial" type="uint"/> <arg name="serial" type="uint"/>
<arg name="surface" type="object" interface="wl_surface"/> <arg name="surface" type="object" interface="wl_surface"/>
</event> </event>
<enum name="key_state"> <enum name="key_state">
<description summary="physical key state"> <description summary="physical key state">
Describes the physical state of a key which provoked the key event. Describes the physical state of a key which provoked the key event.
</description> </description>
<entry name="released" value="0" summary="key is not pressed"/> <entry name="released" value="0" summary="key is not pressed"/>
<entry name="pressed" value="1" summary="key is pressed"/> <entry name="pressed" value="1" summary="key is pressed"/>
@ -1365,7 +1378,7 @@
<event name="modifiers"> <event name="modifiers">
<description summary="modifier and group state"> <description summary="modifier and group state">
Notifies clients that the modifier and/or group state has Notifies clients that the modifier and/or group state has
changed, and it should update its local state. changed, and it should update its local state.
</description> </description>