Index: libxfce4panel/xfce-panel-plugin-iface.c
===================================================================
--- libxfce4panel/xfce-panel-plugin-iface.c	(revision 24080)
+++ libxfce4panel/xfce-panel-plugin-iface.c	(working copy)
@@ -107,7 +107,9 @@
          * @plugin      : a #XfcePanelPlugin widget
          * @size        : new panel size
          *
-         * Emitted when the panel size changes.
+         * Emitted when the panel size changes. This must be handled
+         * in the plugin if a size other than "panel-height * panel-height"
+         * is desired, even the actual callback is a no-op.
          *
          * Returns: %TRUE when handled, %FALSE otherwise.
          **/