Index: trunk/doc/developer/dad/widgets.html
===================================================================
--- trunk/doc/developer/dad/widgets.html	(revision 21006)
+++ trunk/doc/developer/dad/widgets.html	(revision 21007)
@@ -47,9 +47,9 @@
 <tr><th>creation call         <th> screenshot (gtk2)         <th> description
 <tr><td>PCB_DAD_BEGIN_HBOX    <td> <img src="whbox.png">     <td> arrange children widgets in a horizontal list
 <tr><td>PCB_DAD_BEGIN_VBOX    <td> <img src="wvbox.png">     <td> arrange children widgets in a vertical list
-<tr><td>PCB_DAD_BEGIN_HPANE   <td> <img src="whpane.png">    <td> split the parent box horizontally into two sections; the split ratio is adjustable
-<tr><td>PCB_DAD_BEGIN_VPANE   <td> <img src="wvpane.png">    <td> split the parent box vertically into two sections; the split ratio is adjustable
-<tr><td>PCB_DAD_BEGIN_TABLE   <td> <img src="wtable.png">    <td> arrange children widgets into a n*m matrix, allocate each cell the same size
+<tr><td>PCB_DAD_BEGIN_HPANE   <td> <img src="whpane.png">    <td> split the parent box horizontally into two sections; the split ratio is adjustable <br> Note: "left" and "right" are the first and second children (left and right sibling) of the widget tree
+<tr><td>PCB_DAD_BEGIN_VPANE   <td> <img src="wvpane.png">    <td> split the parent box vertically into two sections; the split ratio is adjustable <br> Note: on the screenshot "left" and "right" are the first and second children (left and right sibling) of the widget tree
+<tr><td>PCB_DAD_BEGIN_TABLE   <td> <img src="wtable.png">    <td> arrange children widgets into a n*m matrix, allocate each cell the same size <br> Note: on the screenshot the table is set up to have 3 columns
 <tr><td>PCB_DAD_BEGIN_TABBED  <td> <img src="wtabbed.png">   <td> create a "tabbed notebook" view, each children is a new tab
 </table>