A little documentation update.
authorAndriy Grytsenko <andrej@rep.kiev.ua>
Sat, 19 Nov 2016 13:04:50 +0000 (15:04 +0200)
committerAndriy Grytsenko <andrej@rep.kiev.ua>
Sat, 19 Nov 2016 13:04:50 +0000 (15:04 +0200)
src/icon-grid.c
src/icon-grid.h
src/misc.c
src/plugin.h

index be191f2..a69fcba 100644 (file)
@@ -475,7 +475,8 @@ gint panel_icon_grid_get_child_position(PanelIconGrid * ig, GtkWidget * child)
     return g_list_index(ig->children, child);
 }
 
-/* Reorder an icon grid element. */
+/* Reorder an icon grid element.
+   Equivalent to gtk_container_child_set(ig, child, "position", pos, NULL) */
 void panel_icon_grid_reorder_child(PanelIconGrid * ig, GtkWidget * child, gint position)
 {
     GList *old_link;
index 465e723..c136303 100644 (file)
@@ -43,8 +43,20 @@ typedef struct _PanelIconGridClass      PanelIconGridClass;
 extern GtkWidget * panel_icon_grid_new(
     GtkOrientation orientation, gint child_width, gint child_height, gint spacing, gint border, gint target_dimension);
                                                /* Create an icon grid */
+
+/**
+ * panel_icon_grid_set_constrain_width
+ * @ig: a widget
+ * @constrain_width: value to set
+ *
+ * Changes #PanelIconGrid::constrain-width property on the @ig. This
+ * property defines whether children of @ig may be constrained in case if
+ * the size allocated to @ig isn't sufficient to give assigned size for
+ * all existing children of @ig. All children will receive the same size
+ * deficit in described case.
+ */
 extern void panel_icon_grid_set_constrain_width(PanelIconGrid * ig, gboolean constrain_width);
-                                               /* Set the constrain-width property */
+
 /**
  * panel_icon_grid_set_aspect_width
  * @ig: a widget
@@ -58,7 +70,7 @@ extern void panel_icon_grid_set_constrain_width(PanelIconGrid * ig, gboolean con
  * allocated.
  * Note that if #PanelIconGrid::constrain-width is set to %TRUE then the
  * #PanelIconGrid::aspect-width is ignored and behavior of widget is that
- * if #PanelIconGrid::aspect-width is set to %FALSE.
+ * as if #PanelIconGrid::aspect-width is set to %FALSE.
  *
  * Since: 0.8.0
  */
index 7743c5c..b5d1f0a 100644 (file)
@@ -728,6 +728,7 @@ get_net_wm_state(Window win, NetWMState *nws)
     } else if (state[num3] == a_NET_WM_STATE_SHADED) {
             DBG( "NET_WM_STATE_SHADED ");
             nws->shaded = 1;
+    //FIXME: modal maximized_vert maximized_horz fullscreen above below demands_attention
     } else {
         DBG( "... ");
     }
index 35315b7..e9120d6 100644 (file)
@@ -75,7 +75,9 @@ G_BEGIN_DECLS
  * Callback @button_press_event is a handler for "button-press-event"
  * signal on the plugin instance. This callback would never receive any
  * right-clicks without modifier keys because panel itself will handle it
- * showing context menu.
+ * showing context menu. This callback should never return %TRUE for the
+ * button 2 (middle-click) because that will disrupt the plugins movement
+ * feature of panel (drag & drop) for that plugin.
  *
  * Callback @show_system_menu is called when lxpanel received a message
  * by 'lxpanelctl menu' command. It will be sent to each instance if more