From: Pekka Paalanen <ppaalanen@gmail.com>
Date: Mon, 28 Nov 2011 10:23:32 +0000 (+0200)
Subject: server: document wl_resource_post_event() arguments
X-Git-Tag: 0.85.0~38
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=e04c137e86f3672f5274a3168a3e88483a191693;p=platform%2Fupstream%2Fwayland.git

server: document wl_resource_post_event() arguments

Signed-off-by: Pekka Paalanen <ppaalanen@gmail.com>
---

diff --git a/src/wayland-server.h b/src/wayland-server.h
index 4de2e83..8019c56 100644
--- a/src/wayland-server.h
+++ b/src/wayland-server.h
@@ -180,10 +180,27 @@ struct wl_input_device {
 	struct wl_listener grab_listener;
 };
 
+/*
+ * Post an event to the client's object referred to by 'resource'.
+ * 'opcode' is the event number generated from the protocol XML
+ * description (the event name). The variable arguments are the event
+ * parameters, in the order they appear in the protocol XML specification.
+ *
+ * The variable arguments' types are:
+ * - type=uint: 	uint32_t
+ * - type=int:		int32_t
+ * - type=string:	(const char *) to a nil-terminated string
+ * - type=array:	(struct wl_array *)
+ * - type=fd:		int, that is an open file descriptor
+ * - type=new_id:	(struct wl_object *) or (struct wl_resource *)
+ * - type=object:	(struct wl_object *) or (struct wl_resource *)
+ */
 void wl_resource_post_event(struct wl_resource *resource,
 			    uint32_t opcode, ...);
 void wl_resource_queue_event(struct wl_resource *resource,
 			     uint32_t opcode, ...);
+
+/* msg is a printf format string, variable args are its args. */
 void wl_resource_post_error(struct wl_resource *resource,
 			    uint32_t code, const char *msg, ...);
 void wl_resource_post_no_memory(struct wl_resource *resource);