+ * Panes can be displayed vertically or horizontally, and contents
+ * size proportion can be customized (homogeneous by default).
+ *
+ * Smart callbacks one can listen to:
+ * - "press" - The panes has been pressed (button wasn't released yet).
+ * - "unpressed" - The panes was released after being pressed.
+ * - "clicked" - The panes has been clicked>
+ * - "clicked,double" - The panes has been double clicked
+ *
+ * Available styles for it:
+ * - @c "default"
+ *
+ * Default contents parts of the panes widget that you can use for are:
+ * @li "elm.swallow.left" - A leftside content of the panes
+ * @li "elm.swallow.right" - A rightside content of the panes
+ *
+ * If panes is displayed vertically, left content will be displayed at
+ * top.
+ *
+ * Here is an example on its usage:
+ * @li @ref panes_example
+ */
+
+#define ELM_PANES_CONTENT_LEFT "elm.swallow.left"
+#define ELM_PANES_CONTENT_RIGHT "elm.swallow.right"
+
+ /**
+ * @addtogroup Panes
+ * @{
+ */
+
+ /**
+ * Add a new panes widget to the given parent Elementary
+ * (container) object.
+ *
+ * @param parent The parent object.
+ * @return a new panes widget handle or @c NULL, on errors.
+ *
+ * This function inserts a new panes widget on the canvas.
+ *
+ * @ingroup Panes