GUAC-1389: Add missing parameter comments to static functions in common.

This commit is contained in:
Michael Jumper 2016-03-01 16:46:19 -08:00
parent bbceed5200
commit 12d5c315bb
2 changed files with 35 additions and 0 deletions

View File

@ -52,6 +52,16 @@ void guac_common_clipboard_free(guac_common_clipboard* clipboard) {
/** /**
* Callback for guac_client_foreach_user() which sends clipboard data to each * Callback for guac_client_foreach_user() which sends clipboard data to each
* connected client. * connected client.
*
* @param user
* The user to send the clipboard data to.
*
* @param
* A pointer to the guac_common_clipboard structure containing the
* clipboard data that should be sent to the given user.
*
* @return
* Always NULL.
*/ */
static void* __send_user_clipboard(guac_user* user, void* data) { static void* __send_user_clipboard(guac_user* user, void* data) {

View File

@ -148,6 +148,21 @@ void guac_common_cursor_move(guac_common_cursor* cursor, guac_user* user,
/** /**
* Ensures the cursor image buffer has enough room to fit an image with the * Ensures the cursor image buffer has enough room to fit an image with the
* given characteristics. Existing image buffer data may be destroyed. * given characteristics. Existing image buffer data may be destroyed.
*
* @param cursor
* The cursor whose buffer size should be checked. If this cursor lacks
* sufficient space to contain a cursor image of the specified width,
* height, and stride, the current contents of this cursor will be
* destroyed and replaced with an new buffer having sufficient space.
*
* @param width
* The required cursor width, in pixels.
*
* @param height
* The required cursor height, in pixels.
*
* @param stride
* The number of bytes in each row of image data.
*/ */
static void guac_common_cursor_resize(guac_common_cursor* cursor, static void guac_common_cursor_resize(guac_common_cursor* cursor,
int width, int height, int stride) { int width, int height, int stride) {
@ -171,6 +186,16 @@ static void guac_common_cursor_resize(guac_common_cursor* cursor,
/** /**
* Callback for guac_client_foreach_user() which sends the current cursor image * Callback for guac_client_foreach_user() which sends the current cursor image
* as PNG data to each connected client. * as PNG data to each connected client.
*
* @param user
* The user to send the cursor image to.
*
* @param data
* A pointer to the guac_common_cursor structure containing the cursor
* image that should be sent to the given user.
*
* @return
* Always NULL.
*/ */
static void* __send_user_cursor_image(guac_user* user, void* data) { static void* __send_user_cursor_image(guac_user* user, void* data) {