changeset 36928:6738386f30da

Add doxygen comment. Additionally, rename a variable.
author ib
date Wed, 19 Mar 2014 14:16:30 +0000
parents b99b9968056b
children 582dd379524b
files gui/wm/ws.c gui/wm/ws.h
diffstat 2 files changed, 10 insertions(+), 9 deletions(-) [+]
line wrap: on
line diff
--- a/gui/wm/ws.c	Wed Mar 19 14:07:47 2014 +0000
+++ b/gui/wm/ws.c	Wed Mar 19 14:16:30 2014 +0000
@@ -1424,12 +1424,16 @@
     wsImageCreate(win, w, h);
 }
 
-// ----------------------------------------------------------------------------------------------
-//    Show / hide mouse cursor.
-// ----------------------------------------------------------------------------------------------
-void wsMouseVisibility(wsWindow *win, int vis)
+/**
+ * @brief Hide or show the mouse pointer in a window.
+ *
+ * @param win pointer to a ws window structure
+ * @param visibility either #wsHideMouseCursor to hide or #wsShowMouseCursor
+ *                   to show the mouse pointer in the window
+ */
+void wsMouseVisibility(wsWindow *win, int visibility)
 {
-    switch (vis) {
+    switch (visibility) {
     case wsShowMouseCursor:
 
         if (win->wsCursor != None) {
--- a/gui/wm/ws.h	Wed Mar 19 14:07:47 2014 +0000
+++ b/gui/wm/ws.h	Wed Mar 19 14:16:30 2014 +0000
@@ -178,10 +178,7 @@
 void wsWindowShape(wsWindow *win, char *data);
 void wsWindowIcon(Display *display, Window Win, guiIcon_t *icon);
 
-// ----------------------------------------------------------------------------------------------
-//    Show / hide mouse cursor.
-// ----------------------------------------------------------------------------------------------
-void wsMouseVisibility(wsWindow *win, int vis);
+void wsMouseVisibility(wsWindow *win, int visibility);
 
 // ----------------------------------------------------------------------------------------------
 // Image handling