summaryrefslogtreecommitdiff
path: root/src/lib/ecore_wayland/xdg-shell-client-protocol.h
diff options
context:
space:
mode:
authorXavi Artigas <xavierartigas@yahoo.es>2020-03-10 09:41:14 +0100
committerXavi Artigas <xavierartigas@yahoo.es>2020-03-10 21:36:34 +0100
commit5c2dfd80a649f84f6fc282abb958f69098ad226c (patch)
treec5733a3782d6d9c44b980ce5387536a61c93eafa /src/lib/ecore_wayland/xdg-shell-client-protocol.h
parenta89a2ef1dee61da73cb8d67e8c70450674d02ed5 (diff)
doxygen docs: Adapt to Doxygen syntax
I don't know where did these comments come from, but it was not Doxygen.
Diffstat (limited to '')
-rw-r--r--src/lib/ecore_wayland/xdg-shell-client-protocol.h42
1 files changed, 11 insertions, 31 deletions
diff --git a/src/lib/ecore_wayland/xdg-shell-client-protocol.h b/src/lib/ecore_wayland/xdg-shell-client-protocol.h
index 24b92b01e1..2b20845db5 100644
--- a/src/lib/ecore_wayland/xdg-shell-client-protocol.h
+++ b/src/lib/ecore_wayland/xdg-shell-client-protocol.h
@@ -77,8 +77,7 @@ enum xdg_shell_error {
77#endif /* XDG_SHELL_ERROR_ENUM */ 77#endif /* XDG_SHELL_ERROR_ENUM */
78 78
79/** 79/**
80 * xdg_shell - create desktop-style surfaces 80 * @brief Create desktop-style surfaces
81 * @ping: check if the client is alive
82 * 81 *
83 * xdg_shell allows clients to turn a wl_surface into a "real window" 82 * xdg_shell allows clients to turn a wl_surface into a "real window"
84 * which can be dragged, resized, stacked, and moved around by the user. 83 * which can be dragged, resized, stacked, and moved around by the user.
@@ -87,8 +86,7 @@ enum xdg_shell_error {
87 */ 86 */
88struct xdg_shell_listener { 87struct xdg_shell_listener {
89 /** 88 /**
90 * ping - check if the client is alive 89 * @brief Check if the client is alive
91 * @serial: pass this to the pong request
92 * 90 *
93 * The ping event asks the client if it's still alive. Pass the 91 * The ping event asks the client if it's still alive. Pass the
94 * serial specified in the event back to the compositor by sending 92 * serial specified in the event back to the compositor by sending
@@ -101,6 +99,8 @@ struct xdg_shell_listener {
101 * 99 *
102 * A compositor is free to ping in any way it wants, but a client 100 * A compositor is free to ping in any way it wants, but a client
103 * must always respond to any xdg_shell object it created. 101 * must always respond to any xdg_shell object it created.
102 *
103 * @param serial Pass this to the pong request
104 */ 104 */
105 void (*ping)(void *data, 105 void (*ping)(void *data,
106 struct xdg_shell *xdg_shell, 106 struct xdg_shell *xdg_shell,
@@ -181,16 +181,7 @@ xdg_shell_pong(struct xdg_shell *xdg_shell, uint32_t serial)
181#ifndef XDG_SURFACE_RESIZE_EDGE_ENUM 181#ifndef XDG_SURFACE_RESIZE_EDGE_ENUM
182#define XDG_SURFACE_RESIZE_EDGE_ENUM 182#define XDG_SURFACE_RESIZE_EDGE_ENUM
183/** 183/**
184 * xdg_surface_resize_edge - edge values for resizing 184 * @brief Edge values for resizing
185 * @XDG_SURFACE_RESIZE_EDGE_NONE: (none)
186 * @XDG_SURFACE_RESIZE_EDGE_TOP: (none)
187 * @XDG_SURFACE_RESIZE_EDGE_BOTTOM: (none)
188 * @XDG_SURFACE_RESIZE_EDGE_LEFT: (none)
189 * @XDG_SURFACE_RESIZE_EDGE_TOP_LEFT: (none)
190 * @XDG_SURFACE_RESIZE_EDGE_BOTTOM_LEFT: (none)
191 * @XDG_SURFACE_RESIZE_EDGE_RIGHT: (none)
192 * @XDG_SURFACE_RESIZE_EDGE_TOP_RIGHT: (none)
193 * @XDG_SURFACE_RESIZE_EDGE_BOTTOM_RIGHT: (none)
194 * 185 *
195 * These values are used to indicate which edge of a surface is being 186 * These values are used to indicate which edge of a surface is being
196 * dragged in a resize operation. The server may use this information to 187 * dragged in a resize operation. The server may use this information to
@@ -212,11 +203,7 @@ enum xdg_surface_resize_edge {
212#ifndef XDG_SURFACE_STATE_ENUM 203#ifndef XDG_SURFACE_STATE_ENUM
213#define XDG_SURFACE_STATE_ENUM 204#define XDG_SURFACE_STATE_ENUM
214/** 205/**
215 * xdg_surface_state - types of state on the surface 206 * @brief Types of state on the surface
216 * @XDG_SURFACE_STATE_MAXIMIZED: the surface is maximized
217 * @XDG_SURFACE_STATE_FULLSCREEN: the surface is fullscreen
218 * @XDG_SURFACE_STATE_RESIZING: (none)
219 * @XDG_SURFACE_STATE_ACTIVATED: (none)
220 * 207 *
221 * The different state values used on the surface. This is designed for 208 * The different state values used on the surface. This is designed for
222 * state values like maximized, fullscreen. It is paired with the configure 209 * state values like maximized, fullscreen. It is paired with the configure
@@ -246,9 +233,7 @@ enum xdg_surface_state {
246#endif /* XDG_SURFACE_STATE_ENUM */ 233#endif /* XDG_SURFACE_STATE_ENUM */
247 234
248/** 235/**
249 * xdg_surface - A desktop window 236 * @brief A desktop window
250 * @configure: suggest a surface change
251 * @close: surface wants to be closed
252 * 237 *
253 * An interface that may be implemented by a wl_surface, for 238 * An interface that may be implemented by a wl_surface, for
254 * implementations that provide a desktop-style user interface. 239 * implementations that provide a desktop-style user interface.
@@ -272,11 +257,7 @@ enum xdg_surface_state {
272 */ 257 */
273struct xdg_surface_listener { 258struct xdg_surface_listener {
274 /** 259 /**
275 * configure - suggest a surface change 260 * @brief Suggest a surface change
276 * @width: (none)
277 * @height: (none)
278 * @states: (none)
279 * @serial: (none)
280 * 261 *
281 * The configure event asks the client to resize its surface or 262 * The configure event asks the client to resize its surface or
282 * to change its state. 263 * to change its state.
@@ -311,7 +292,7 @@ struct xdg_surface_listener {
311 struct wl_array *states, 292 struct wl_array *states,
312 uint32_t serial); 293 uint32_t serial);
313 /** 294 /**
314 * close - surface wants to be closed 295 * @brief Surface wants to be closed
315 * 296 *
316 * The close event is sent by the compositor when the user wants 297 * The close event is sent by the compositor when the user wants
317 * the surface to be closed. This should be equivalent to the user 298 * the surface to be closed. This should be equivalent to the user
@@ -462,8 +443,7 @@ xdg_surface_set_minimized(struct xdg_surface *xdg_surface)
462} 443}
463 444
464/** 445/**
465 * xdg_popup - short-lived, popup surfaces for menus 446 * @brief Short-lived popup surfaces for menus
466 * @popup_done: popup interaction is done
467 * 447 *
468 * A popup surface is a short-lived, temporary surface that can be used 448 * A popup surface is a short-lived, temporary surface that can be used
469 * to implement menus. It takes an explicit grab on the surface that will 449 * to implement menus. It takes an explicit grab on the surface that will
@@ -513,7 +493,7 @@ xdg_surface_set_minimized(struct xdg_surface *xdg_surface)
513 */ 493 */
514struct xdg_popup_listener { 494struct xdg_popup_listener {
515 /** 495 /**
516 * popup_done - popup interaction is done 496 * @brief Popup interaction is done
517 * 497 *
518 * The popup_done event is sent out when a popup is dismissed by 498 * The popup_done event is sent out when a popup is dismissed by
519 * the compositor. The client should destroy the xdg_popup object 499 * the compositor. The client should destroy the xdg_popup object