Elm: Unify modules into a monolithic module

283 files changed, 8835 insertions, 9237 deletions

diff --git a/doc/elementary/actionslider.rst b/doc/elementary/actionslider.rst
index df745d4..4619a9e 100644
--- a/doc/elementary/actionslider.rst
+++ b/doc/elementary/actionslider.rst
@@ -1,2 +1,83 @@
+Actionslider
+############
 
-.. automodule:: efl.elementary.actionslider
+.. image:: /images/actionslider-preview.png
+
+
+Widget description
+==================
+
+An actionslider is a switcher for two or three labels with
+customizable magnet properties.
+
+The user drags and releases the indicator, to choose a label.
+
+Labels can occupy the following positions.
+
+- Left
+- Right
+- Center
+
+Positions can be enabled or disabled.
+
+Magnets can be set on the above positions.
+
+When the indicator is released, it will move to its nearest "enabled and
+magnetized" position.
+
+
+Emitted signals
+===============
+
+- ``selected`` - when user selects an enabled position (the label is
+  passed as event info)".
+- ``pos_changed`` - when the indicator reaches any of the
+  positions("left", "right" or "center").
+
+
+Layout text parts
+=================
+
+- ``indicator`` - An indicator label of the actionslider
+- ``left`` - A left label of the actionslider
+- ``right`` - A right label of the actionslider
+- ``center`` - A center label of the actionslider
+
+
+Enumerations
+============
+
+.. _Elm_Actionslider_Pos:
+
+Actionslider positions
+----------------------
+
+.. data:: ELM_ACTIONSLIDER_NONE
+
+    No position
+
+.. data:: ELM_ACTIONSLIDER_LEFT
+
+    Left position
+
+.. data:: ELM_ACTIONSLIDER_CENTER
+
+    Center position
+
+.. data:: ELM_ACTIONSLIDER_RIGHT
+
+    Right position
+
+.. data:: ELM_ACTIONSLIDER_ALL
+
+    All positions
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Actionslider
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Actionslider
diff --git a/doc/elementary/background.rst b/doc/elementary/background.rst
index ddac36a..a6b1803 100644
--- a/doc/elementary/background.rst
+++ b/doc/elementary/background.rst
@@ -1,2 +1,56 @@
+Background
+##########
 
-.. automodule:: efl.elementary.background
+.. image:: /images/background-preview.png
+
+
+Widget description
+==================
+
+The background widget is used for setting a solid color, image or Edje group
+as a background to a window (unless it has transparency enabled) or any
+container object.
+
+It works just like an image, but has some properties useful to a
+background, like setting it to tiled, centered, scaled or stretched.
+
+
+Layout content parts
+====================
+
+- ``overlay`` - overlay of the bg
+
+
+Enumerations
+============
+
+.. _Elm_Bg_Option:
+
+Background display modes
+------------------------
+
+.. data:: ELM_BG_OPTION_CENTER
+
+    Center
+
+.. data:: ELM_BG_OPTION_SCALE
+
+    Scale
+
+.. data:: ELM_BG_OPTION_STRETCH
+
+    Stretch
+
+.. data:: ELM_BG_OPTION_TILE
+
+    Tile
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Background
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Background
diff --git a/doc/elementary/box.rst b/doc/elementary/box.rst
index 0661cf1..dd58ad3 100644
--- a/doc/elementary/box.rst
+++ b/doc/elementary/box.rst
@@ -1,2 +1,116 @@
+Box
+###
 
-.. automodule:: efl.elementary.box
+.. image:: /images/box-preview.png
+
+
+Widget description
+==================
+
+A box arranges objects in a linear fashion, governed by a layout function
+that defines the details of this arrangement.
+
+By default, the box will use an internal function to set the layout to
+a single row, either vertical or horizontal. This layout is affected
+by a number of parameters, such as the homogeneous flag set by
+:py:attr:`~Box.homogeneous`, the values given by :py:attr:`~Box.padding` and
+:py:attr:`~Box.align` and the hints set to each object in the box.
+
+For this default layout, it's possible to change the orientation with
+:py:attr:`~Box.horizontal`. The box will start in the vertical orientation,
+placing its elements ordered from top to bottom. When horizontal is set,
+the order will go from left to right. If the box is set to be
+homogeneous, every object in it will be assigned the same space, that
+of the largest object. Padding can be used to set some spacing between
+the cell given to each object. The alignment of the box, set with
+:py:attr:`~Box.align`, determines how the bounding box of all the elements
+will be placed within the space given to the box widget itself.
+
+The size hints of each object also affect how they are placed and sized
+within the box. :py:attr:`~efl.evas.Object.size_hint_min` will give the minimum
+size the object can have, and the box will use it as the basis for all
+latter calculations. Elementary widgets set their own minimum size as
+needed, so there's rarely any need to use it manually.
+
+:py:attr:`~efl.evas.Object.size_hint_weight`, when not in homogeneous mode, is
+used to tell whether the object will be allocated the minimum size it
+needs or if the space given to it should be expanded. It's important
+to realize that expanding the size given to the object is not the same
+thing as resizing the object. It could very well end being a small
+widget floating in a much larger empty space. If not set, the weight
+for objects will normally be 0.0 for both axis, meaning the widget will
+not be expanded. To take as much space possible, set the weight to
+``EVAS_HINT_EXPAND`` (defined to 1.0) for the desired axis to expand.
+
+Besides how much space each object is allocated, it's possible to control
+how the widget will be placed within that space using
+:py:attr:`~efl.evas.Object.size_hint_align`. By default, this value will be 0.5
+for both axis, meaning the object will be centered, but any value from
+0.0 (left or top, for the ``x`` and ``y`` axis, respectively) to 1.0
+(right or bottom) can be used. The special value *EVAS_HINT_FILL*, which
+is -1.0, means the object will be resized to fill the entire space it
+was allocated.
+
+In addition, customized functions to define the layout can be set, which
+allow the application developer to organize the objects within the box
+in any number of ways.
+
+The special :py:meth:`Box.layout_transition` function can be used
+to switch from one layout to another, animating the motion of the
+children of the box.
+
+.. note:: Objects should not be added to box objects using _add() calls.
+
+
+Enumerations
+============
+
+.. _Evas_Object_Box_Layout:
+
+Box layout modes
+----------------
+
+.. data:: ELM_BOX_LAYOUT_HORIZONTAL
+
+    Horizontal layout
+
+.. data:: ELM_BOX_LAYOUT_VERTICAL
+
+    Vertical layout
+
+.. data:: ELM_BOX_LAYOUT_HOMOGENEOUS_VERTICAL
+
+    Homogeneous vertical layout
+
+.. data:: ELM_BOX_LAYOUT_HOMOGENEOUS_HORIZONTAL
+
+    Homogeneous horizontal layout
+
+.. data:: ELM_BOX_LAYOUT_HOMOGENEOUS_MAX_SIZE_HORIZONTAL
+
+    Homogeneous layout, maximum size on the horizontal axis
+
+.. data:: ELM_BOX_LAYOUT_HOMOGENEOUS_MAX_SIZE_VERTICAL
+
+    Homogeneous layout, maximum size on the horizontal axis
+
+.. data:: ELM_BOX_LAYOUT_FLOW_HORIZONTAL
+
+    Horizontally flowing layout
+
+.. data:: ELM_BOX_LAYOUT_FLOW_VERTICAL
+
+    Vertically flowing layout
+
+.. data:: ELM_BOX_LAYOUT_STACK
+
+    Stacking layout
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Box
+    :parts: 2
+
+.. autoclass:: efl.elementary.Box
diff --git a/doc/elementary/bubble.rst b/doc/elementary/bubble.rst
index 3f0c1a9..62c4cc0 100644
--- a/doc/elementary/bubble.rst
+++ b/doc/elementary/bubble.rst
@@ -1,2 +1,86 @@
+Bubble
+######
+
+.. image:: /images/bubble-preview.png
+
+
+Widget description
+==================
+
+The Bubble is a widget to show text similar to how speech is
+represented in comics.
+
+The bubble widget contains 5 important visual elements:
+
+- The frame is a rectangle with rounded edjes and an "arrow".
+- The ``icon`` is an image to which the frame's arrow points to.
+- The ``label`` is a text which appears to the right of the icon if the
+    corner is **top_left** or **bottom_left** and is right aligned to
+    the frame otherwise.
+- The ``info`` is a text which appears to the right of the label. Info's
+    font is of a lighter color than label.
+- The ``content`` is an evas object that is shown inside the frame.
+
+The position of the arrow, icon, label and info depends on which corner is
+selected. The four available corners are:
+
+- ``top_left`` - Default
+- ``top_right``
+- ``bottom_left``
+- ``bottom_right``
+
+
+Layout content parts
+====================
+
+- ``default`` - A content of the bubble
+- ``icon`` - An icon of the bubble
+
+
+Layout text parts
+=================
+
+- ``default`` - Label of the bubble
+- ``info`` - info of the bubble
+
+
+Emitted signals
+===============
+
+- ``clicked`` - This is called when a user has clicked the bubble.
+- ``focused`` - When the bubble has received focus. (since 1.8)
+- ``unfocused`` - When the bubble has lost focus. (since 1.8)
+
+
+Enumerations
+============
+
+.. _Elm_Bubble_Pos:
+
+Bubble arrow positions
+----------------------
+
+.. data:: ELM_BUBBLE_POS_TOP_LEFT
+
+    Top left position
+
+.. data:: ELM_BUBBLE_POS_TOP_RIGHT
+
+    Top right position
+
+.. data:: ELM_BUBBLE_POS_BOTTOM_LEFT
+
+    Bottom left position
+
+.. data:: ELM_BUBBLE_POS_BOTTOM_RIGHT
+
+    Bottom right position
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.bubble
+    :parts: 2
 
 .. automodule:: efl.elementary.bubble
diff --git a/doc/elementary/button.rst b/doc/elementary/button.rst
index d138ba2..680266f 100644
--- a/doc/elementary/button.rst
+++ b/doc/elementary/button.rst
@@ -1,3 +1,63 @@
+Button
+######
 
-.. automodule:: efl.elementary.button
+.. image:: /images/button-preview.png
+
+
+Widget description
+==================
+
+This is a push-button. Press it and run some function. It can contain
+a simple label and icon object and it also has an autorepeat feature.
+
+
+Available styles
+================
+
+- ``default`` a normal button.
+- ``anchor`` Like default, but the button fades away when the mouse is not
+  over it, leaving only the text or icon.
+- ``hoversel_vertical`` Internally used by
+  :py:class:`~efl.elementary.hoversel.Hoversel` to give a continuous look
+  across its options.
+- ``hoversel_vertical_entry`` Another internal for
+  :py:class:`~efl.elementary.hoversel.Hoversel`.
+- ``naviframe`` Internally used by
+  :py:class:`~efl.elementary.naviframe.Naviframe` for its back button.
+- ``colorselector`` Internally used by
+  :py:class:`~efl.elementary.colorselector.Colorselector` for its left and
+  right buttons.
+
+
+Layout content parts
+====================
+
+- ``icon`` - An icon of the button
+
+
+Layout text parts
+=================
+
+- ``default`` - Label of the button
+
+
+Emitted signals
+===============
+
+- ``clicked``: the user clicked the button (press/release).
+- ``repeated``: the user pressed the button without releasing it.
+- ``pressed``: button was pressed.
+- ``unpressed``: button was released after being pressed.
+- ``focused`` : When the button has received focus. (since 1.8)
+- ``unfocused`` : When the button has lost focus. (since 1.8)
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Button
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Button
 
diff --git a/doc/elementary/calendar.rst b/doc/elementary/calendar.rst
index c3fd57a..10026b7 100644
--- a/doc/elementary/calendar.rst
+++ b/doc/elementary/calendar.rst
@@ -1,2 +1,160 @@
+Calendar
+########
 
-.. automodule:: efl.elementary.calendar_elm
+.. image:: /images/calendar-preview.png
+
+
+Widget description
+==================
+
+This is a calendar widget.
+
+It helps applications to flexibly display a calender with day of the week,
+date, year and month. Applications are able to set specific dates to be
+reported back, when selected, in the smart callbacks of the calendar widget.
+The API of this widget lets the applications perform other functions, like:
+
+- placing marks on specific dates
+- setting the bounds for the calendar (minimum and maximum years)
+- setting the day names of the week (e.g. "Thu" or "Thursday")
+- setting the year and month format.
+
+
+Emitted signals
+===============
+
+- ``changed`` - emitted when the date in the calendar is changed.
+- ``display,changed`` - emitted when the current month displayed in the
+  calendar is changed.
+- ``focused`` - When the calendar has received focus. (since 1.8)
+- ``unfocused`` - When the calendar has lost focus. (since 1.8)
+
+
+Enumerations
+============
+
+.. _Elm_Calendar_Mark_Repeat_Type:
+
+Calendar mark repeat types
+--------------------------
+
+.. data:: ELM_CALENDAR_UNIQUE
+
+    Default value.
+
+    Marks will be displayed only on event day.
+
+.. data:: ELM_CALENDAR_DAILY
+
+    Marks will be displayed every day after event day (inclusive).
+
+.. data:: ELM_CALENDAR_WEEKLY
+
+    Marks will be displayed every week after event day (inclusive) - i.e.
+    each seven days.
+
+.. data:: ELM_CALENDAR_MONTHLY
+
+    Marks will be displayed every month day that coincides to event day.
+
+    E.g.: if an event is set to 30th Jan, no marks will be displayed on Feb,
+    but will be displayed on 30th Mar
+
+.. data:: ELM_CALENDAR_ANNUALLY
+
+    Marks will be displayed every year that coincides to event day (and month).
+
+    E.g. an event added to 30th Jan 2012 will be repeated on 30th Jan 2013.
+
+.. data:: ELM_CALENDAR_LAST_DAY_OF_MONTH
+
+    Marks will be displayed every last day of month after event day
+    (inclusive).
+
+
+.. _Elm_Calendar_Select_Mode:
+
+Calendar selection modes
+------------------------
+
+.. data:: ELM_CALENDAR_SELECT_MODE_DEFAULT
+
+    Default mode
+
+.. data:: ELM_CALENDAR_SELECT_MODE_ALWAYS
+
+    Select always
+
+.. data:: ELM_CALENDAR_SELECT_MODE_NONE
+
+    Don't select
+
+.. data:: ELM_CALENDAR_SELECT_MODE_ONDEMAND
+
+    Select on demand
+
+
+.. _Elm_Calendar_Selectable:
+
+Selectable
+----------
+
+.. data:: ELM_CALENDAR_SELECTABLE_NONE
+
+    None selectable
+
+.. data:: ELM_CALENDAR_SELECTABLE_YEAR
+
+    Year is selectable
+
+.. data:: ELM_CALENDAR_SELECTABLE_MONTH
+
+    Month is selectable
+
+.. data:: ELM_CALENDAR_SELECTABLE_DAY
+
+    Day is selectable
+
+
+.. _Elm_Calendar_Weekday:
+
+Days
+----
+
+.. data:: ELM_DAY_SUNDAY
+
+    Sunday
+
+.. data:: ELM_DAY_MONDAY
+
+    Monday
+
+.. data:: ELM_DAY_TUESDAY
+
+    Tuesday
+
+.. data:: ELM_DAY_WEDNESDAY
+
+    Wednesday
+
+.. data:: ELM_DAY_THURSDAY
+
+    Thursday
+
+.. data:: ELM_DAY_FRIDAY
+
+    Friday
+
+.. data:: ELM_DAY_SATURDAY
+
+    Saturday
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Calendar
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Calendar
diff --git a/doc/elementary/check.rst b/doc/elementary/check.rst
index 7da1ef8..5b37007 100644
--- a/doc/elementary/check.rst
+++ b/doc/elementary/check.rst
@@ -1,2 +1,47 @@
+Check
+#####
 
-.. automodule:: efl.elementary.check
+.. image:: /images/check-preview.png
+
+
+Widget description
+==================
+
+The check widget allows for toggling a value between true and false.
+
+Check objects are a lot like radio objects in layout and functionality,
+except they do not work as a group, but independently, and only toggle
+the value of a boolean :py:attr:`~Check.state` between false and true.
+
+
+Emitted signals
+===============
+
+- ``changed`` - This is called whenever the user changes the state of
+  the check objects.
+- ``focused`` - When the check has received focus. (since 1.8)
+- ``unfocused`` - When the check has lost focus. (since 1.8)
+
+
+Layout content parts
+====================
+
+- ``icon`` - An icon of the check
+
+
+Layout text parts
+=================
+
+- ``default`` - A label of the check
+- ``on`` - On state label of the check
+- ``off`` - Off state label of the check
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Check
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Check
diff --git a/doc/elementary/clock.rst b/doc/elementary/clock.rst
index 519a6e2..010fa61 100644
--- a/doc/elementary/clock.rst
+++ b/doc/elementary/clock.rst
@@ -1,2 +1,92 @@
+Clock
+#####
 
-.. automodule:: efl.elementary.clock
+.. image:: /images/clock-preview.png
+
+
+Widget description
+==================
+
+This is a digital clock widget.
+
+In its default theme, it has a vintage "flipping numbers clock" appearance,
+which will animate sheets of individual algarisms individually as time goes
+by.
+
+A newly created clock will fetch system's time (already considering
+local time adjustments) to start with, and will tick accordingly. It may
+or may not show seconds.
+
+Clocks have an **edition** mode. When in it, the sheets will display
+extra arrow indications on the top and bottom and the user may click on
+them to raise or lower the time values. After it's told to exit edition
+mode, it will keep ticking with that new time set (it keeps the
+difference from local time).
+
+Also, when under edition mode, user clicks on the cited arrows which are
+**held** for some time will make the clock to flip the sheet, thus
+editing the time, continuously and automatically for the user. The
+interval between sheet flips will keep growing in time, so that it helps
+the user to reach a time which is distant from the one set.
+
+The time display is, by default, in military mode (24h), but an am/pm
+indicator may be optionally shown, too, when it will switch to 12h.
+
+
+Emitted signals
+===============
+
+- ``changed`` - the clock's user changed the time
+- ``focused`` - When the clock has received focus. (since 1.8)
+- ``unfocused`` - When the clock has lost focus. (since 1.8)
+
+
+Enumerations
+============
+
+.. _Elm_Clock_Edit_Mode:
+
+Clock edit modes
+----------------
+
+.. data:: ELM_CLOCK_EDIT_DEFAULT
+
+    Default edit
+
+.. data:: ELM_CLOCK_EDIT_HOUR_DECIMAL
+
+    Edit hours' decimal
+
+.. data:: ELM_CLOCK_EDIT_HOUR_UNIT
+
+    Edit hours' unit
+
+.. data:: ELM_CLOCK_EDIT_MIN_DECIMAL
+
+    Edit minutes' decimal
+
+.. data:: ELM_CLOCK_EDIT_MIN_UNIT
+
+    Edit minutes' unit
+
+.. data:: ELM_CLOCK_EDIT_SEC_DECIMAL
+
+    Edit seconds' decimal
+
+.. data:: ELM_CLOCK_EDIT_SEC_UNIT
+
+    Edit seconds' unit
+
+.. data:: ELM_CLOCK_EDIT_ALL
+
+    Edit all
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Clock
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Clock
diff --git a/doc/elementary/colorselector.rst b/doc/elementary/colorselector.rst
index 21b8103..ab27f70 100644
--- a/doc/elementary/colorselector.rst
+++ b/doc/elementary/colorselector.rst
@@ -1,2 +1,62 @@
+Colorselector
+#############
 
-.. automodule:: efl.elementary.colorselector
+.. image:: /images/colorselector-preview.png
+
+
+Widget description
+==================
+
+A Colorselector is a color selection widget.
+
+It allows application to set a series of colors. It also allows to
+load/save colors from/to config with a unique identifier, by default,
+the colors are loaded/saved from/to config using "default" identifier.
+The colors can be picked by user from the color set by clicking on
+individual color item on the palette or by selecting it from selector.
+
+
+Emitted signals
+===============
+
+- ``"changed"`` - When the color value changes on selector
+- ``"color,item,selected"`` - When user clicks on color item.
+    The event_info parameter of the callback will be the selected
+    color item.
+- ``"color,item,longpressed"`` - When user long presses on color item.
+    The event_info parameter of the callback will be the selected
+    color item.
+- ``focused`` - When the colorselector has received focus. (since 1.8)
+- ``unfocused`` - When the colorselector has lost focus. (since 1.8)
+
+
+Enumerations
+============
+
+.. _Elm_Colorselector_Mode:
+
+Colorselector modes
+-------------------
+
+.. data:: ELM_COLORSELECTOR_PALETTE
+
+    Show palette
+
+.. data:: ELM_COLORSELECTOR_COMPONENTS
+
+    Show components
+
+.. data:: ELM_COLORSELECTOR_BOTH
+
+    Show palette and components
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.colorselector
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Colorselector
+.. autoclass:: efl.elementary.ColorselectorPaletteItem
diff --git a/doc/elementary/configuration.rst b/doc/elementary/configuration.rst
index 3c992da..d5fa4b7 100644
--- a/doc/elementary/configuration.rst
+++ b/doc/elementary/configuration.rst
@@ -1,2 +1,161 @@
+Configuration
+#############
 
-.. automodule:: efl.elementary.configuration
+Description
+===========
+
+Elementary configuration is formed by a set options bounded to a
+given profile, like theme, "finger size", etc.
+
+These are functions with which one synchronizes changes made to those
+values to the configuration storing files, de facto. You most probably
+don't want to use the functions in this group unless you're writing an
+elementary configuration manager.
+
+Profiles
+========
+
+Profiles are pre-set options that affect the whole look-and-feel of
+Elementary-based applications. There are, for example, profiles
+aimed at desktop computer applications and others aimed at mobile,
+touchscreen-based ones. You most probably don't want to use the
+functions in this group unless you're writing an elementary
+configuration manager.
+
+Elementary Scrolling
+====================
+
+These set how scrollable views in Elementary widgets should behave on
+user interaction.
+
+Password show last
+==================
+
+Show last feature of password mode enables user to view the last input
+entered for few seconds before masking it. These functions allow to set
+this feature in password mode of entry widget and also allow to
+manipulate the duration for which the input has to be visible.
+
+Elementary Engine
+=================
+
+These are functions setting and querying which rendering engine
+Elementary will use for drawing its windows' pixels.
+
+The following are the available engines:
+
+- "software_x11"
+- "fb"
+- "directfb"
+- "software_16_x11"
+- "software_8_x11"
+- "xrender_x11"
+- "opengl_x11"
+- "software_gdi"
+- "software_16_wince_gdi"
+- "sdl"
+- "software_16_sdl"
+- "opengl_sdl"
+- "buffer"
+- "ews"
+- "opengl_cocoa"
+- "psl1ght"
+
+
+ATSPI AT-SPI2 Accessibility
+===========================
+
+Elementary widgets support Linux Accessibility standard. For more
+information please visit:
+http://www.linuxfoundation.org/collaborate/workgroups/accessibility/atk/at-spi/at-spi_on_d-bus
+
+
+Enumerations
+============
+
+.. _Elm_Softcursor_Mode:
+
+Elm_Softcursor_Mode
+-------------------
+
+.. data:: ELM_SOFTCURSOR_MODE_AUTO
+
+    Auto-detect if a software cursor should be used (default)
+
+.. data:: ELM_SOFTCURSOR_MODE_ON
+
+    Always use a softcursor
+
+.. data:: ELM_SOFTCURSOR_MODE_OFF
+
+    Never use a softcursor
+
+
+.. _Elm_Slider_Indicator_Visible_Mode:
+
+Elm_Slider_Indicator_Visible_Mode
+---------------------------------
+
+.. data:: ELM_SLIDER_INDICATOR_VISIBLE_MODE_DEFAULT
+
+    show indicator on mouse down or change in slider value
+
+.. data:: ELM_SLIDER_INDICATOR_VISIBLE_MODE_ALWAYS
+
+    Always show the indicator
+
+.. data:: ELM_SLIDER_INDICATOR_VISIBLE_MODE_ON_FOCUS
+
+    Show the indicator on focus
+
+.. data:: ELM_SLIDER_INDICATOR_VISIBLE_MODE_NONE
+
+    Never show the indicator
+
+
+.. _Edje_Channel:
+
+Audio Channels
+--------------
+
+.. data:: EDJE_CHANNEL_EFFECT
+
+    Standard audio effects
+
+.. data:: EDJE_CHANNEL_BACKGROUND
+
+    Background audio sounds
+
+.. data:: EDJE_CHANNEL_MUSIC
+
+    Music audio
+
+.. data:: EDJE_CHANNEL_FOREGROUND
+
+    Foreground audio sounds
+
+.. data:: EDJE_CHANNEL_INTERFACE
+
+    Sounds related to the interface
+
+.. data:: EDJE_CHANNEL_INPUT
+
+    Sounds related to regular input
+
+.. data:: EDJE_CHANNEL_ALERT
+
+    Sounds for major alerts
+
+.. data:: EDJE_CHANNEL_ALL
+
+    All audio channels (convenience)
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Configuration
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Configuration
diff --git a/doc/elementary/conformant.rst b/doc/elementary/conformant.rst
index b13449c..a428e8c 100644
--- a/doc/elementary/conformant.rst
+++ b/doc/elementary/conformant.rst
@@ -1,2 +1,41 @@
+Conformant
+##########
 
-.. automodule:: efl.elementary.conformant
+.. image:: /images/conformant-preview.png
+
+
+Widget description
+==================
+
+The aim is to provide a widget that can be used in elementary apps to
+account for space taken up by the indicator, virtual keypad & softkey
+windows when running the illume2 module of E17.
+
+So conformant content will be sized and positioned considering the
+space required for such stuff, and when they popup, as a keyboard
+shows when an entry is selected, conformant content won't change.
+
+
+Emitted signals
+===============
+
+- ``virtualkeypad,state,on``: if virtualkeypad state is switched to ``on``.
+- ``virtualkeypad,state,off``: if virtualkeypad state is switched to ``off``.
+- ``clipboard,state,on``: if clipboard state is switched to ``on``.
+- ``clipboard,state,off``: if clipboard state is switched to ``off``.
+
+
+Layout content parts
+====================
+
+- ``default`` - A content of the conformant
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Conformant
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Conformant
diff --git a/doc/elementary/ctxpopup.rst b/doc/elementary/ctxpopup.rst
index 95151ac..bfad5bc 100644
--- a/doc/elementary/ctxpopup.rst
+++ b/doc/elementary/ctxpopup.rst
@@ -1,2 +1,82 @@
+Ctxpopup
+########
 
-.. automodule:: efl.elementary.ctxpopup
+.. image:: /images/ctxpopup-preview.png
+
+
+Widget description
+==================
+
+A ctxpopup is a widget that, when shown, pops up a list of items. It
+automatically chooses an area inside its parent object's view to
+optimally fit into it. In the default theme, it will also point an arrow
+to it's top left position at the time one shows it. Ctxpopup items have
+a label and/or an icon. It is intended for a small number of items
+(hence the use of list, not genlist).
+
+.. note::
+
+    Ctxpopup is a specialization of :py:class:`~efl.elementary.hover.Hover`.
+
+Emitted signals
+===============
+
+- ``dismissed`` - This is called when 1. the outside of ctxpopup was clicked
+  or 2. its parent area is changed or 3. the language is changed and also when
+  4. the parent object is resized due to the window rotation. Then ctxpopup is
+  dismissed.
+- ``language,changed`` - This is called when the program's language is
+  changed.
+- ``focused`` - When the ctxpopup has received focus. (since 1.8)
+- ``unfocused`` - When the ctxpopup has lost focus. (since 1.8)
+
+Layout content parts
+====================
+
+- ``default`` - A content of the ctxpopup
+- ``icon`` - An icon in the title area
+
+Layout text parts
+=================
+
+- ``default`` - Title label in the title area
+
+
+Enumerations
+============
+
+.. _Elm_Ctxpopup_Direction:
+
+Ctxpopup arrow directions
+-------------------------
+
+.. data:: ELM_CTXPOPUP_DIRECTION_DOWN
+
+    Arrow is pointing down
+
+.. data:: ELM_CTXPOPUP_DIRECTION_RIGHT
+
+    Arrow is pointing right
+
+.. data:: ELM_CTXPOPUP_DIRECTION_LEFT
+
+    Arrow is pointing left
+
+.. data:: ELM_CTXPOPUP_DIRECTION_UP
+
+    Arrow is pointing up
+
+.. data:: ELM_CTXPOPUP_DIRECTION_UNKNOWN
+
+    Arrow direction is unknown
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Ctxpopup
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Ctxpopup
+.. autoclass:: efl.elementary.CtxpopupItem
diff --git a/doc/elementary/datetime.rst b/doc/elementary/datetime.rst
index cf98d10..145d704 100644
--- a/doc/elementary/datetime.rst
+++ b/doc/elementary/datetime.rst
@@ -1,2 +1,218 @@
+Datetime
+########
 
-.. automodule:: efl.elementary.datetime_elm
+Widget description
+==================
+
+Datetime widget is used to display and input date & time values.
+
+This widget displays date and time as per the **system's locale** settings
+(Date includes Day, Month & Year along with the defined separators and Time
+includes Hour, Minute & AM/PM fields). Separator for AM/PM field is ignored.
+
+The corresponding Month, AM/PM strings are displayed according to the
+system’s language settings.
+
+Datetime format is a combination of LIBC standard characters like "%%d %%b
+%%Y %%I : %%M  %%p" which, as a whole represents both Date as well as Time
+format.
+
+Elm_datetime supports only the following sub set of libc date format specifiers:
+
+**%%Y** The year as a decimal number including the century (example: 2011).
+
+**%%y** The year as a decimal number without a century (range 00 to 99)
+
+**%%m** The month as a decimal number (range 01 to 12).
+
+**%%b** The abbreviated month name according to the current locale.
+
+**%%B** The full month name according to the current locale.
+
+**%%h** The abbreviated month name according to the current locale(same as %%b).
+
+**%%d** The day of the month as a decimal number (range 01 to 31).
+
+**%%e** The day of the month as a decimal number (range 1 to 31). single
+        digits are preceded by a blank.
+
+**%%I** The hour as a decimal number using a 12-hour clock (range 01 to 12).
+
+**%%H** The hour as a decimal number using a 24-hour clock (range 00 to 23).
+
+**%%k** The hour (24-hour clock) as a decimal number (range 0 to 23). single
+        digits are preceded by a blank.
+
+**%%l** The hour (12-hour clock) as a decimal number (range 1 to 12); single
+        digits are preceded by a blank.
+
+**%%M** The minute as a decimal number (range 00 to 59).
+
+**%%p** Either 'AM' or 'PM' according to the given time value, or the
+        corresponding strings for the current locale. Noon is treated as 'PM'
+        and midnight as 'AM'
+
+**%%P** Like %p but in lower case: 'am' or 'pm' or a corresponding string for
+        the current locale.
+
+**%%c** The preferred date and time representation for the current locale.
+
+**%%x** The preferred date representation for the current locale without the time.
+
+**%%X** The preferred time representation for the current locale without the date.
+
+**%%r** The complete calendar time using the AM/PM format of the current locale.
+
+**%%R** The hour and minute in decimal numbers using the format %H:%M.
+
+**%%T** The time of day in decimal numbers using the format %H:%M:%S.
+
+**%%D** The date using the format %%m/%%d/%%y.
+
+**%%F** The date using the format %%Y-%%m-%%d.
+
+
+(For more reference on the available **LIBC date format specifiers**,
+please visit the link:
+http://www.gnu.org/s/hello/manual/libc.html#Formatting-Calendar-Time )
+
+Datetime widget can provide Unicode **separators** in between its fields
+except for AM/PM field. A separator can be any **Unicode character**
+other than the LIBC standard date format specifiers.
+
+Example: In the format::
+
+    %%b %%d **,** %%y %%H **:** %%M
+
+comma(,) is separator for date field %%d and colon(:) is separator for
+hour field %%H.
+
+The default format is a predefined one, based on the system Locale.
+
+Hour format 12hr(1-12) or 24hr(0-23) display can be selected by setting
+the corresponding user format.
+
+Datetime supports six fields: Year, Month, Date, Hour, Minute, AM/PM.
+Depending on the Datetime module that is loaded, the user can see
+different UI to select the individual field values.
+
+The individual fields of Datetime can be arranged in any order according
+to the format set by application.
+
+There is a provision to set the visibility of a particular field as TRUE/
+FALSE so that **only time/ only date / only required fields** will be
+displayed.
+
+Each field is having a default minimum and maximum values just like the
+daily calendar information. These min/max values can be modified as per
+the application usage.
+
+User can enter the values only in between the range of maximum and
+minimum. Apart from these APIs, there is a provision to display only a
+limited set of values out of the possible values. APIs to select the
+individual field limits are intended for this purpose.
+
+The whole widget is left aligned and its size grows horizontally
+depending on the current format and each field's visible/disabled state.
+
+Datetime individual field selection is implemented in a modular style.
+Module can be implemented as a Ctxpopup based selection or an ISE based
+selection or even a spinner like selection etc.
+
+Datetime Module design
+======================
+
+The following functions are expected to be implemented in a Datetime module:
+
+**Field creation**::
+
+     __________                                            __________
+    |          |----- obj_hook() ---------------------->>>|          |
+    |          |<<<----------------returns Mod_data ------|          |
+    | Datetime |_______                                   |          |
+    |  widget  |       |Assign module call backs          |  Module  |
+    |   base   |<<<____|                                  |          |
+    |          |                                          |          |
+    |          |----- field_create() ------------------>>>|          |
+    |__________|<<<----------------returns field_obj -----|__________|
+
+**Field value setting**::
+
+     __________                                          __________
+    |          |                                        |          |
+    | Datetime |<<<----------elm_datetime_value_set()---|          |
+    |  widget  |                                        |  Module  |
+    |   base   |----display_field_value()------------>>>|          |
+    |__________|                                        |__________|
+
+**del_hook**::
+
+     __________                                          __________
+    |          |                                        |          |
+    | Datetime |----obj_unhook()-------------------->>>>|          |
+    |  widget  |                                        |  Module  |
+    |   base   |         <<<-----frees mod_data---------|          |
+    |__________|                                        |__________|
+
+Any module can use the following shared functions that are implemented in
+elm_datetime.c:
+
+**field_format_get()** - gives the field format.
+
+**field_limit_get()**  - gives the field minimum, maximum limits.
+
+To enable a module, set the ELM_MODULES environment variable as shown:
+
+**export ELM_MODULES="datetime_input_ctxpopup>datetime/api"**
+
+
+Emitted signals
+===============
+
+- ``changed`` - whenever Datetime field value is changed, this signal is sent.
+- ``language,changed`` - whenever system locale changes, this signal is sent.
+- ``focused`` - When the datetime has received focus. (since 1.8)
+- ``unfocused`` - When the datetime has lost focus. (since 1.8)
+
+
+Enumerations
+============
+
+.. _Elm_Datetime_Field_Type:
+
+Datetime fields
+---------------
+
+.. data:: ELM_DATETIME_YEAR
+
+    Year
+
+.. data:: ELM_DATETIME_MONTH
+
+    Month
+
+.. data:: ELM_DATETIME_DATE
+
+    Date
+
+.. data:: ELM_DATETIME_HOUR
+
+    Hour
+
+.. data:: ELM_DATETIME_MINUTE
+
+    Minute
+
+.. data:: ELM_DATETIME_AMPM
+
+    Am/Pm
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Datetime
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Datetime
diff --git a/doc/elementary/dayselector.rst b/doc/elementary/dayselector.rst
index 4540b10..4a2d523 100644
--- a/doc/elementary/dayselector.rst
+++ b/doc/elementary/dayselector.rst
@@ -1,2 +1,97 @@
+Dayselector
+###########
 
-.. automodule:: efl.elementary.dayselector
+.. image:: /images/dayselector-preview.png
+
+
+Widget description
+==================
+
+Dayselector displays all seven days of the week and allows the user to
+select multiple days.
+
+The selection can be toggle by just clicking on the day.
+
+Dayselector also provides the functionality to check whether a day is
+selected or not.
+
+First day of the week is taken from config settings by default. It can be
+altered by using the API :py:attr:`~Dayselector.week_start` API.
+
+APIs are provided for setting the duration of weekend
+:py:attr:`~Dayselector.weekend_start` and :py:attr:`~Dayselector.weekend_length`
+does this job.
+
+Two styles of weekdays and weekends are supported in Dayselector.
+Application can emit signals on individual check objects for setting the
+weekday, weekend styles.
+
+Once the weekend start day or weekend length changes, all the weekday &
+weekend styles will be reset to default style. It's the application's
+responsibility to set the styles again by sending corresponding signals.
+
+"day0" indicates Sunday, "day1" indicates Monday etc. continues and so,
+"day6" indicates the Saturday part name.
+
+Application can change individual day display string by using the API
+:py:meth:`~efl.elementary.object.Object.part_text_set`.
+
+:py:meth:`~efl.elementary.object.Object.part_content_set` API sets the
+individual day object only if the passed one is a Check widget.
+
+Check object representing a day can be set/get by the application by using
+the elm_object_part_content_set/get APIs thus providing a way to handle
+the different check styles for individual days.
+
+
+Emitted signals
+===============
+
+- ``dayselector,changed`` - when the user changes the state of a day.
+- ``language,changed`` - the program's language changed
+
+
+Enumerations
+============
+
+.. _Elm_Dayselector_Day:
+
+Dayselector days
+----------------
+
+.. data:: ELM_DAYSELECTOR_SUN
+
+    Sunday
+
+.. data:: ELM_DAYSELECTOR_MON
+
+    Monday
+
+.. data:: ELM_DAYSELECTOR_TUE
+
+    Tuesday
+
+.. data:: ELM_DAYSELECTOR_WED
+
+    Wednesday
+
+.. data:: ELM_DAYSELECTOR_THU
+
+    Thursday
+
+.. data:: ELM_DAYSELECTOR_FRI
+
+    Friday
+
+.. data:: ELM_DAYSELECTOR_SAT
+
+    Saturday
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Dayselector
+    :parts: 2
+
+.. autoclass:: efl.elementary.Dayselector
diff --git a/doc/elementary/diskselector.rst b/doc/elementary/diskselector.rst
index 10879bd..2b4581d 100644
--- a/doc/elementary/diskselector.rst
+++ b/doc/elementary/diskselector.rst
@@ -1,2 +1,68 @@
+Diskselector
+############
 
-.. automodule:: efl.elementary.diskselector
+.. image:: /images/diskselector-preview.png
+
+
+Widget description
+==================
+
+A diskselector is a kind of list widget. It scrolls horizontally,
+and can contain label and icon objects. Three items are displayed
+with the selected one in the middle.
+
+It can act like a circular list with round mode and labels can be
+reduced for a defined length for side items.
+
+
+Emitted signals
+===============
+
+- ``selected`` - when item is selected, i.e. scroller stops.
+- ``clicked`` - This is called when a user clicks an item
+- ``scroll,anim,start`` - scrolling animation has started
+- ``scroll,anim,stop`` - scrolling animation has stopped
+- ``scroll,drag,start`` - dragging the diskselector has started
+- ``scroll,drag,stop`` - dragging the diskselector has stopped
+- ``focused`` - When the diskselector has received focus. (since 1.8)
+- ``unfocused`` - When the diskselector has lost focus. (since 1.8)
+
+.. note:: The ``scroll,anim,*`` and ``scroll,drag,*`` signals are only emitted
+          by user intervention.
+
+Layout content parts
+====================
+
+- ``icon`` - An icon in the diskselector item
+
+
+Layout text parts
+=================
+
+- ``default`` - Label of the diskselector item
+
+
+Scrollable Interface
+====================
+
+This widget supports the scrollable interface.
+
+If you wish to control the scrolling behaviour using these functions,
+inherit both the widget class and the
+:py:class:`~efl.elementary.scroller.Scrollable` class
+using multiple inheritance, for example::
+
+    class ScrollableGenlist(Genlist, Scrollable):
+        def __init__(self, canvas, *args, **kwargs):
+            Genlist.__init__(self, canvas)
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Diskselector
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Diskselector
+.. autoclass:: efl.elementary.DiskselectorItem
diff --git a/doc/elementary/elementary.rst b/doc/elementary/elementary.rst
index 657598f..c4030ac 100644
--- a/doc/elementary/elementary.rst
+++ b/doc/elementary/elementary.rst
@@ -1,3 +1,4 @@
+.. module:: efl.elementary
 
 Elementary
 ##########
@@ -51,11 +52,44 @@ A sample Python Elementary program
 API Reference
 =============
 
+.. autofunction:: init
+.. autofunction:: shutdown
+.. autofunction:: run
+.. autofunction:: exit
+
+.. autofunction:: on_ethumb_connect
+.. autofunction:: on_config_all_changed
+.. autofunction:: on_policy_changed
+
+.. autofunction:: on_process_background
+.. autofunction:: on_process_background
+
+.. autofunction:: on_sys_notify_notification_closed
+.. autofunction:: on_sys_notify_action_invoked
+
+.. autofunction:: policy_set
+.. autofunction:: policy_get
+.. autofunction:: process_state_get
+.. autofunction:: coords_finger_size_adjust
+
+.. autofunction:: language_set
+.. autofunction:: cache_all_flush
+.. autofunction:: font_properties_get
+.. autofunction:: font_properties_free
+
+.. autofunction:: font_fontconfig_name_get
+.. autofunction:: object_tree_dump
+.. autofunction:: object_tree_dot_dump
+
+.. autofunction:: sys_notify_close
+.. autofunction:: sys_notify_send
+
 .. toctree:: *
    :glob:
    :maxdepth: 1
 
 
+
 Inheritance diagram
 ===================
 
diff --git a/doc/elementary/entry.rst b/doc/elementary/entry.rst
index bd5ba13..b279d00 100644
--- a/doc/elementary/entry.rst
+++ b/doc/elementary/entry.rst
@@ -1,2 +1,590 @@
+Entry
+#####
 
-.. automodule:: efl.elementary.entry
+.. image:: /images/entry-preview.png
+
+
+Widget description
+==================
+
+An entry is a convenience widget which shows a box that the user can
+enter text into.
+
+Entries by default don't scroll, so they grow to accommodate the entire text,
+resizing the parent window as needed. This can be changed with the property
+:py:attr:`~efl.elementary.entry.Entry.scrollable`.
+
+They can also be single line or multi line (the default) and when set
+to multi line mode they support text wrapping in any of the modes
+indicated by :ref:`Elm_Entry_Wrap_Type`.
+
+Other features include password mode, filtering of inserted text with
+:py:meth:`~efl.elementary.entry.Entry.markup_filter_append` and related
+functions, inline "items" and formatted markup text.
+
+
+Scrollable Interface
+====================
+
+This widget supports the scrollable interface.
+
+If you wish to control the scolling behaviour using these functions,
+inherit both the widget class and the
+:py:class:`~efl.elementary.scroller.Scrollable` class
+using multiple inheritance, for example::
+
+    class ScrollableGenlist(Genlist, Scrollable):
+        def __init__(self, canvas, *args, **kwargs):
+            Genlist.__init__(self, canvas)
+
+
+Formatted text
+==============
+
+The markup tags supported by the Entry are defined by the theme, but
+even when writing new themes or extensions it's a good idea to stick to
+a sane default, to maintain coherency and avoid application breakages.
+Currently defined by the default theme are the following tags:
+
+``<br>``
+    Inserts a line break.
+``<ps>``
+    Inserts a paragraph separator. This is preferred over line
+    breaks.
+``<tab>``
+    Inserts a tab.
+``<em>...</em>``
+    Emphasis. Sets the *oblique* style for the
+    enclosed text.
+``<b>...</b>``
+    Sets the **bold** style for the enclosed text.
+``<link>...</link>``
+    Underlines the enclosed text.
+``<hilight>...</hilight>``
+    Highlights the enclosed text.
+
+
+Special markups
+===============
+
+Besides those used to format text, entries support two special markup
+tags used to insert click-able portions of text or items inlined within
+the text.
+
+
+Anchors
+-------
+
+Anchors are similar to HTML anchors. Text can be surrounded by <a> and
+</a> tags and an event will be generated when this text is clicked,
+like this::
+
+    This text is outside <a href=anc-01>but this one is an anchor</a>
+
+The ``href`` attribute in the opening tag gives the name that will be
+used to identify the anchor and it can be any valid utf8 string.
+
+When an anchor is clicked, an ``"anchor,clicked"`` signal is emitted with
+an :py:class:`EntryAnchorInfo` in the ``event_info`` parameter for the
+callback function. The same applies for ``anchor,in`` (mouse in),
+``anchor,out`` (mouse out), ``anchor,down`` (mouse down), and ``anchor,up``
+(mouse up) events on an anchor.
+
+
+Items
+-----
+
+Inlined in the text, any other :py:class:`~efl.elementary.object.Object` can
+be inserted by using ``<item>`` tags this way::
+
+    <item size=16x16 vsize=full href=emoticon/haha></item>
+
+Just like with anchors, the ``href`` identifies each item, but these need,
+in addition, to indicate their size, which is done using any one of
+``size``, ``absize`` or ``relsize`` attributes. These attributes take their
+value in the WxH format, where W is the width and H the height of the
+item.
+
+- absize: Absolute pixel size for the item. Whatever value is set will
+  be the item's size regardless of any scale value the object may have
+  been set to. The final line height will be adjusted to fit larger items.
+- size: Similar to *absize*, but it's adjusted to the scale value set
+  for the object.
+- relsize: Size is adjusted for the item to fit within the current
+  line height.
+
+Besides their size, items are specified a ``vsize`` value that affects
+how their final size and position are calculated. The possible values
+are:
+
+- ``ascent``: Item will be placed within the line's baseline and its
+  ascent. That is, the height between the line where all characters are
+  positioned and the highest point in the line. For ``size`` and
+  ``absize`` items, the descent value will be added to the total line
+  height to make them fit. ``relsize`` items will be adjusted to fit
+  within this space.
+- ``full``: Items will be placed between the descent and ascent, or the
+  lowest point in the line and its highest.
+
+After the size for an item is calculated, the entry will request an object to
+place in its space. For this, the functions set with
+:py:meth:`~efl.elementary.entry.Entry.item_provider_append` and related
+functions will be called in order until one of them returns a non-*None* value.
+If no providers are available, or all of them return *None*, then the entry
+falls back to one of the internal defaults, provided the name matches with one
+of them.
+
+All of the following are currently supported:
+
+- emoticon/angry
+- emoticon/angry-shout
+- emoticon/crazy-laugh
+- emoticon/evil-laugh
+- emoticon/evil
+- emoticon/goggle-smile
+- emoticon/grumpy
+- emoticon/grumpy-smile
+- emoticon/guilty
+- emoticon/guilty-smile
+- emoticon/haha
+- emoticon/half-smile
+- emoticon/happy-panting
+- emoticon/happy
+- emoticon/indifferent
+- emoticon/kiss
+- emoticon/knowing-grin
+- emoticon/laugh
+- emoticon/little-bit-sorry
+- emoticon/love-lots
+- emoticon/love
+- emoticon/minimal-smile
+- emoticon/not-happy
+- emoticon/not-impressed
+- emoticon/omg
+- emoticon/opensmile
+- emoticon/smile
+- emoticon/sorry
+- emoticon/squint-laugh
+- emoticon/surprised
+- emoticon/suspicious
+- emoticon/tongue-dangling
+- emoticon/tongue-poke
+- emoticon/uh
+- emoticon/unhappy
+- emoticon/very-sorry
+- emoticon/what
+- emoticon/wink
+- emoticon/worried
+- emoticon/wtf
+
+Alternatively, an item may reference an image by its path, using
+the URI form ``file:///path/to/an/image.png`` and the entry will then
+use that image for the item.
+
+
+Setting entry's style
+=====================
+
+There are 2 major ways to change the entry's style:
+
+- Theme - set the "base" field to the desired style.
+- User style - Pushing overrides to the theme style to the textblock object
+  by using :py:meth:`~efl.elementary.entry.Entry.text_style_user_push`.
+
+You should modify the theme when you would like to change the style for
+aesthetic reasons. While the user style should be changed when you would
+like to change the style to something specific defined at run-time, e.g,
+setting font or font size in a text editor.
+
+
+Loading and saving files
+========================
+
+Entries have convenience functions to load text from a file and save changes
+back to it after a short delay. The automatic saving is enabled by default, but
+can be disabled with :py:attr:`~efl.elementary.entry.Entry.autosave` and files
+can be loaded directly as plain text or have any markup in them recognized. See
+:py:attr:`~efl.elementary.entry.Entry.file` for more details.
+
+
+Emitted signals
+===============
+
+- ``changed``: The text within the entry was changed.
+- ``changed,user``: The text within the entry was changed because of user
+  interaction.
+- ``activated``: The enter key was pressed on a single line entry.
+- ``aborted``: The escape key was pressed on a single line entry. (since 1.7)
+- ``press``: A mouse button has been pressed on the entry.
+- ``longpressed``: A mouse button has been pressed and held for a couple
+  seconds.
+- ``clicked``: The entry has been clicked (mouse press and release).
+- ``clicked,double``: The entry has been double clicked.
+- ``clicked,triple``: The entry has been triple clicked.
+- ``focused``: The entry has received focus.
+- ``unfocused``: The entry has lost focus.
+- ``selection,paste``: A paste of the clipboard contents was requested.
+- ``selection,copy``: A copy of the selected text into the clipboard was
+  requested.
+- ``selection,cut``: A cut of the selected text into the clipboard was
+  requested.
+- ``selection,start``: A selection has begun and no previous selection
+  existed.
+- ``selection,changed``: The current selection has changed.
+- ``selection,cleared``: The current selection has been cleared.
+- ``cursor,changed``: The cursor has changed position.
+- ``anchor,clicked``: An anchor has been clicked. The event_info
+  parameter for the callback will be an :py:class:`EntryAnchorInfo`.
+- ``anchor,in``: Mouse cursor has moved into an anchor. The event_info
+  parameter for the callback will be an :py:class:`EntryAnchorInfo`.
+- ``anchor,out``: Mouse cursor has moved out of an anchor. The event_info
+  parameter for the callback will be an :py:class:`EntryAnchorInfo`.
+- ``anchor,up``: Mouse button has been unpressed on an anchor. The event_info
+  parameter for the callback will be an :py:class:`EntryAnchorInfo`.
+- ``anchor,down``: Mouse button has been pressed on an anchor. The event_info
+  parameter for the callback will be an :py:class:`EntryAnchorInfo`.
+- ``preedit,changed``: The preedit string has changed.
+- ``language,changed``: Program language changed.
+- ``text,set,done``: Whole text has been set to the entry.
+- ``rejected``: .Called when some of inputs are rejected by the filter. (since 1.9)
+
+
+Layout content parts
+====================
+
+- ``icon`` - An icon in the entry
+- ``end`` - A content in the end of the entry
+
+
+Layout text parts
+=================
+
+- ``default`` - text of the entry
+- ``guide`` - placeholder of the entry
+
+
+Enumerations
+============
+
+.. _Elm_Entry_Autocapital_Type:
+
+Autocapitalization types
+------------------------
+
+.. data:: ELM_AUTOCAPITAL_TYPE_NONE
+
+    No auto-capitalization when typing
+
+.. data:: ELM_AUTOCAPITAL_TYPE_WORD
+
+    Autocapitalize each word typed
+
+.. data:: ELM_AUTOCAPITAL_TYPE_SENTENCE
+
+    Autocapitalize the start of each sentence
+
+.. data:: ELM_AUTOCAPITAL_TYPE_ALLCHARACTER
+
+    Autocapitalize all letters
+
+
+.. _Elm_Entry_Cnp_Mode:
+
+Copy & paste modes
+------------------
+
+.. data:: ELM_CNP_MODE_MARKUP
+
+    Copy & paste text with markup tags
+
+.. data:: ELM_CNP_MODE_NO_IMAGE
+
+    Copy & paste text without item (image) tags
+
+.. data:: ELM_CNP_MODE_PLAINTEXT
+
+    Copy & paste text without markup tags
+
+
+.. _Elm_Input_Hints:
+
+Input Hints
+-----------
+
+.. data:: ELM_INPUT_HINT_NONE
+
+    No active hints
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_INPUT_HINT_AUTO_COMPLETE
+
+    Suggest word auto completion
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_INPUT_HINT_SENSITIVE_DATA
+
+    typed text should not be stored
+
+    .. versionadded:: 1.12
+
+
+.. _Elm_Entry_Input_Panel_Lang:
+
+Input panel language sort order
+-------------------------------
+
+.. data:: ELM_INPUT_PANEL_LANG_AUTOMATIC
+
+    Automatic
+
+.. data:: ELM_INPUT_PANEL_LANG_ALPHABET
+
+    Alphabetic
+
+
+.. _Elm_Entry_Input_Panel_Layout:
+
+Input panel layouts
+-------------------
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NORMAL
+
+    Default layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NUMBER
+
+    Number layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_EMAIL
+
+    Email layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_URL
+
+    URL layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_PHONENUMBER
+
+    Phone number layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_IP
+
+    IP layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_MONTH
+
+    Month layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NUMBERONLY
+
+    Number only layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_INVALID
+
+    Never use this
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_HEX
+
+    Hexadecimal layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_TERMINAL
+
+    Command-line terminal layout
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_PASSWORD
+
+    Like normal, but no auto-correct, no auto-capitalization etc.
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_DATETIME
+
+    Date and time layout
+
+    .. versionadded:: 1.10
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_EMOTICON
+
+    Emoticon layout
+
+    .. versionadded:: 1.10
+
+
+.. _Elm_Input_Panel_Layout_Normal_Variation:
+
+Input panel normal layout variation
+-----------------------------------
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_NORMAL
+
+    The plain normal layout
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_FILENAME
+
+    Filename layout. Symbols such as '/' should be disabled
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_PERSON_NAME
+
+    The name of a person
+
+    .. versionadded:: 1.12
+
+
+.. _Elm_Input_Panel_Layout_Numberonly_Variation:
+
+Input panel numberonly layout variation
+---------------------------------------
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_NORMAL
+
+    The numberonly normal layout
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_SIGNED
+
+    The signed number layout
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_DECIMAL
+
+    The decimal number layout
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_SIGNED_AND_DECIMAL
+
+    The signed and decimal number layout
+
+    .. versionadded:: 1.12
+
+
+.. _Elm_Input_Panel_Layout_Password_Variation:
+
+Input panel password layout variation
+-------------------------------------
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_PASSWORD_VARIATION_NORMAL
+
+    The normal password layout
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_INPUT_PANEL_LAYOUT_PASSWORD_VARIATION_NUMBERONLY
+
+    The password layout to allow only number
+
+    .. versionadded:: 1.12
+
+
+.. _Elm_Entry_Input_Panel_Return_Key_Type:
+
+Input panel return key modes
+----------------------------
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_DEFAULT
+
+    Default
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_DONE
+
+    Done
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_GO
+
+    Go
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_JOIN
+
+    Join
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_LOGIN
+
+    Login
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_NEXT
+
+    Next
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_SEARCH
+
+    Search
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_SEND
+
+    Send
+
+.. data:: ELM_INPUT_PANEL_RETURN_KEY_TYPE_SIGNIN
+
+    Sign-in
+
+    .. versionadded:: 1.10
+
+
+.. _Elm_Entry_Text_Format:
+
+Text format
+-----------
+
+.. data:: ELM_TEXT_FORMAT_PLAIN_UTF8
+
+    Plain UTF-8 type
+
+.. data:: ELM_TEXT_FORMAT_MARKUP_UTF8
+
+    UTF-8 with markup
+
+
+.. _Elm_Entry_Wrap_Type:
+
+Wrap mode
+---------
+
+.. data:: ELM_WRAP_NONE
+
+    No wrap
+
+.. data:: ELM_WRAP_CHAR
+
+    Wrap between characters
+
+.. data:: ELM_WRAP_WORD
+
+    Wrap in allowed wrapping points (as defined in the unicode standard)
+
+.. data:: ELM_WRAP_MIXED
+
+    Word wrap, and if that fails, char wrap
+
+
+.. _Elm_Entry_Icon_Type:
+
+Icon types
+----------
+
+.. data:: ELM_ICON_NONE
+
+    No icon
+
+.. data:: ELM_ICON_FILE
+
+    Icon is a file
+
+.. data:: ELM_ICON_STANDARD
+
+    Icon is set with standards names
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Entry
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Entry
diff --git a/doc/elementary/fileselector.rst b/doc/elementary/fileselector.rst
index 00ddcf4..bf3d2e9 100644
--- a/doc/elementary/fileselector.rst
+++ b/doc/elementary/fileselector.rst
@@ -1,2 +1,135 @@
+Fileselector
+############
 
-.. automodule:: efl.elementary.fileselector
+.. image:: /images/fileselector-preview.png
+
+
+Widget description
+==================
+
+A file selector is a widget that allows a user to navigate through a
+file system, reporting file selections back via its API.
+
+It contains shortcut buttons for home directory (*~*) and to jump one
+directory upwards (..), as well as cancel/ok buttons to confirm/cancel a
+given selection. After either one of those two former actions, the file
+selector will issue its ``"done"`` smart callback.
+
+There's a text entry on it, too, showing the name of the current
+selection. There's the possibility of making it editable, so it is
+useful on file saving dialogs on applications, where one gives a file
+name to save contents to, in a given directory in the system. This
+custom file name will be reported on the ``"done"`` smart callback
+(explained in sequence).
+
+Finally, it has a view to display file system items into in two possible
+forms:
+
+- list
+- grid
+
+If Elementary is built with support of the Ethumb thumbnailing library,
+the second form of view will display preview thumbnails of files which
+it supports.
+
+
+Emitted signals
+===============
+
+- ``activated`` - the user activated a file. This can happen by
+  double-clicking or pressing Enter key. (**event_info** is a string with the
+  activated file path)
+- ``selected`` - the user has clicked on a file (when not in folders-only
+  mode) or directory (when in folders-only mode)
+- ``directory,open`` - the list has been populated with new content
+  (*event_info* is the directory's path)
+- ``done`` - the user has clicked on the "ok" or "cancel"
+  buttons (*event_info* is the selection's path)
+
+
+Layout text parts
+=================
+
+- ``ok`` - OK button label if the ok button is set. (since 1.8)
+- ``cancel`` - Cancel button label if the cancel button is set. (since 1.8)
+
+
+Enumerations
+============
+
+.. _Elm_Fileselector_Mode:
+
+Fileselector modes
+------------------
+
+.. data:: ELM_FILESELECTOR_LIST
+
+    Layout as a list
+
+.. data:: ELM_FILESELECTOR_GRID
+
+    Layout as a grid
+
+
+.. _Elm_Fileselector_Sort:
+
+Fileselector sort method
+------------------------
+
+.. data:: ELM_FILESELECTOR_SORT_BY_FILENAME_ASC
+
+    Sort by filename in ascending order
+
+    .. versionadded:: 1.9
+
+.. data:: ELM_FILESELECTOR_SORT_BY_FILENAME_DESC
+
+    Sort by filename in descending order
+
+    .. versionadded:: 1.9
+
+.. data:: ELM_FILESELECTOR_SORT_BY_TYPE_ASC
+
+    Sort by file type in ascending order
+
+    .. versionadded:: 1.9
+
+.. data:: ELM_FILESELECTOR_SORT_BY_TYPE_DESC
+
+    Sort by file type in descending order
+
+    .. versionadded:: 1.9
+
+.. data:: ELM_FILESELECTOR_SORT_BY_SIZE_ASC
+
+    Sort by file size in ascending order
+
+    .. versionadded:: 1.9
+
+.. data:: ELM_FILESELECTOR_SORT_BY_SIZE_DESC
+
+    Sort by file size in descending order
+
+    .. versionadded:: 1.9
+
+.. data:: ELM_FILESELECTOR_SORT_BY_MODIFIED_ASC
+
+    Sort by file modification date in ascending order
+
+    .. versionadded:: 1.9
+
+.. data:: ELM_FILESELECTOR_SORT_BY_MODIFIED_DESC
+
+    Sort by file modification date in descending order
+
+    .. versionadded:: 1.9
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Fileselector
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Fileselector
diff --git a/doc/elementary/fileselector_button.rst b/doc/elementary/fileselector_button.rst
index b2566b7..179ee66 100644
--- a/doc/elementary/fileselector_button.rst
+++ b/doc/elementary/fileselector_button.rst
@@ -1,2 +1,73 @@
+Fileselector Button
+###################
 
-.. automodule:: efl.elementary.fileselector_button
+.. image:: /images/fileselector-button-preview.png
+
+
+Widget description
+==================
+
+This is a button that, when clicked, creates an Elementary window (or
+inner window) with a :py:class:`~efl.elementary.fileselector.Fileselector`
+within.
+
+When a file is chosen, the (inner) window is closed and the button emits
+a signal having the selected file as it's ``event_info``.
+
+This widget encapsulates operations on its internal file selector on its
+own API. There is less control over its file selector than that one
+would have instantiating one directly.
+
+
+Available styles
+================
+
+- ``default``
+- ``anchor``
+- ``hoversel_vertical``
+- ``hoversel_vertical_entry``
+
+
+Emitted signals
+===============
+
+- ``file,chosen`` - the user has selected a path which comes as the
+  ``event_info`` data
+- ``language,changed`` - the program's language changed
+
+
+Layout text parts
+=================
+
+- ``default`` - Label of the fileselector_button
+
+
+Layout content parts
+====================
+
+- ``icon`` - Icon of the fileselector_button
+
+
+Fileselector Interface
+======================
+
+This widget supports the fileselector interface.
+
+If you wish to control the fileselector part using these functions,
+inherit both the widget class and the
+:py:class:`~efl.elementary.fileselector.Fileselector` class
+using multiple inheritance, for example::
+
+    class CustomFileselectorButton(Fileselector, FileselectorButton):
+        def __init__(self, canvas, *args, **kwargs):
+            FileselectorButton.__init__(self, canvas)
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.FileselectorButton
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.FileselectorButton
diff --git a/doc/elementary/fileselector_entry.rst b/doc/elementary/fileselector_entry.rst
index 8479474..14344b1 100644
--- a/doc/elementary/fileselector_entry.rst
+++ b/doc/elementary/fileselector_entry.rst
@@ -1,2 +1,88 @@
+Fileselector Entry
+##################
 
-.. automodule:: efl.elementary.fileselector_entry
+.. image:: /images/fileselector-entry-preview.png
+
+
+Widget description
+==================
+
+This is an entry made to be filled with or display a file
+system path string.
+
+Besides the entry itself, the widget has a
+:py:class:`~efl.elementary.fileselector_button.FileselectorButton` on its side,
+which will raise an internal
+:py:class:`~efl.elementary.fileselector.Fileselector`, when clicked, for path
+selection aided by file system navigation.
+
+This file selector may appear in an Elementary window or in an
+inner window. When a file is chosen from it, the (inner) window
+is closed and the selected file's path string is exposed both as
+a smart event and as the new text on the entry.
+
+This widget encapsulates operations on its internal file
+selector on its own API. There is less control over its file
+selector than that one would have instantiating one directly.
+
+
+Emitted signals
+===============
+
+- ``changed`` - The text within the entry was changed
+- ``activated`` - The entry has had editing finished and
+  changes are to be "committed"
+- ``press`` - The entry has been clicked
+- ``longpressed`` - The entry has been clicked (and held) for a
+  couple seconds
+- ``clicked`` - The entry has been clicked
+- ``clicked,double`` - The entry has been double clicked
+- ``focused`` - The entry has received focus
+- ``unfocused`` - The entry has lost focus
+- ``selection,paste`` - A paste action has occurred on the
+  entry
+- ``selection,copy`` - A copy action has occurred on the entry
+- ``selection,cut`` - A cut action has occurred on the entry
+- ``unpressed`` - The file selector entry's button was released
+  after being pressed.
+- ``file,chosen`` - The user has selected a path via the file
+  selector entry's internal file selector, whose string
+  comes as the ``event_info`` data.
+- ``language,changed`` - the program's language changed
+
+
+Layout text parts
+=================
+
+- ``default`` - Label of the fileselector_button
+
+
+Layout content parts
+====================
+
+- ``button icon`` - Button icon of the fileselector_entry
+
+
+Fileselector Interface
+======================
+
+This widget supports the fileselector interface.
+
+If you wish to control the fileselector part using these functions,
+inherit both the widget class and the
+:py:class:`~efl.elementary.fileselector.Fileselector` class
+using multiple inheritance, for example::
+
+    class CustomFileselectorButton(Fileselector, FileselectorButton):
+        def __init__(self, canvas, *args, **kwargs):
+            FileselectorButton.__init__(self, canvas)
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.FileselectorEntry
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.FileselectorEntry
diff --git a/doc/elementary/flip.rst b/doc/elementary/flip.rst
index 0644602..08c87a4 100644
--- a/doc/elementary/flip.rst
+++ b/doc/elementary/flip.rst
@@ -1,2 +1,162 @@
+Flip
+####
 
-.. automodule:: efl.elementary.flip
+.. image:: /images/flip-preview.png
+
+
+Widget description
+==================
+
+This widget holds two content :py:class:`efl.evas.Object`: one on
+the front and one on the back. It allows you to flip from front to back
+and vice-versa using various animations.
+
+If either the front or back contents are not set the flip will treat that
+as transparent. So if you were to set the front content but not the back,
+and then call :py:meth:`Flip.go` you would see whatever is below the flip.
+
+For a list of supported animations see :py:meth:`Flip.go`.
+
+
+Emitted signals
+===============
+
+- ``animate,begin`` - when a flip animation was started
+- ``animate,done`` - when a flip animation is finished
+
+
+Layout content parts
+====================
+
+- ``front`` - A front content of the flip
+- ``back`` - A back content of the flip
+
+
+Enumerations
+============
+
+.. _Elm_Flip_Direction:
+
+Flip directions
+---------------
+
+.. data:: ELM_FLIP_DIRECTION_UP
+
+    Allows interaction with the top of the widget.
+
+.. data:: ELM_FLIP_DIRECTION_DOWN
+
+    Allows interaction with the bottom of the widget.
+
+.. data:: ELM_FLIP_DIRECTION_LEFT
+
+    Allows interaction with the left portion of
+
+    the widget.
+.. data:: ELM_FLIP_DIRECTION_RIGHT
+
+    Allows interaction with the right portion of
+
+    the widget.
+
+
+.. _Elm_Flip_Interaction:
+
+Flip interaction modes
+----------------------
+
+.. data:: ELM_FLIP_INTERACTION_NONE
+
+    No interaction is allowed
+
+.. data:: ELM_FLIP_INTERACTION_ROTATE
+
+    Interaction will cause rotate animation
+
+.. data:: ELM_FLIP_INTERACTION_CUBE
+
+    Interaction will cause cube animation
+
+.. data:: ELM_FLIP_INTERACTION_PAGE
+
+    Interaction will cause page animation
+
+
+.. _Elm_Flip_Mode:
+
+Flip types
+----------
+
+.. data:: ELM_FLIP_ROTATE_Y_CENTER_AXIS
+
+    Rotate the currently visible content around a vertical axis in the
+    middle of its width, the other content is shown as the other side of the
+    flip.
+
+.. data:: ELM_FLIP_ROTATE_X_CENTER_AXIS
+
+    Rotate the currently visible content around a horizontal axis in the
+    middle of its height, the other content is shown as the other side of
+    the flip.
+
+.. data:: ELM_FLIP_ROTATE_XZ_CENTER_AXIS
+
+    Rotate the currently visible content around a diagonal axis in the
+    middle of its width, the other content is shown as the other side of the
+    flip.
+
+.. data:: ELM_FLIP_ROTATE_YZ_CENTER_AXIS
+
+    Rotate the currently visible content around a diagonal axis in the
+    middle of its height, the other content is shown as the other side of
+    the flip.
+
+.. data:: ELM_FLIP_CUBE_LEFT
+
+    Rotate the currently visible content to the left as if the flip was a
+    cube, the other content is show as the right face of the cube.
+
+.. data:: ELM_FLIP_CUBE_RIGHT
+
+    Rotate the currently visible content to the right as if the flip was a
+    cube, the other content is show as the left face of the cube.
+
+.. data:: ELM_FLIP_CUBE_UP
+
+    Rotate the currently visible content up as if the flip was a cube, the
+    other content is show as the bottom face of the cube.
+
+.. data:: ELM_FLIP_CUBE_DOWN
+
+    Rotate the currently visible content down as if the flip was a cube, the
+    other content is show as the upper face of the cube.
+
+.. data:: ELM_FLIP_PAGE_LEFT
+
+    Move the currently visible content to the left as if the flip was a
+    book, the other content is shown as the page below that.
+
+.. data:: ELM_FLIP_PAGE_RIGHT
+
+    Move the currently visible content to the right as if the flip was a
+    book, the other content is shown as the page below that.
+
+.. data:: ELM_FLIP_PAGE_UP
+
+    Move the currently visible content up as if the flip was a book, the
+    other content is shown as the page below that.
+
+.. data:: ELM_FLIP_PAGE_DOWN
+
+    Move the currently visible content down as if the flip was a book, the
+    other content is shown as the page below that.
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Flip
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Flip
diff --git a/doc/elementary/flipselector.rst b/doc/elementary/flipselector.rst
index 0bf5cf1..1288595 100644
--- a/doc/elementary/flipselector.rst
+++ b/doc/elementary/flipselector.rst
@@ -1,2 +1,48 @@
+Flipselector
+############
 
-.. automodule:: efl.elementary.flipselector
+.. image:: /images/flipselector-preview.png
+
+
+Widget description
+==================
+
+A flip selector is a widget to show a set of *text* items, one at a time, with
+the same sheet switching style as the :py:class:`~efl.elementary.clock.Clock`
+widget, when one changes the current displaying sheet (thus, the "flip" in the
+name).
+
+User clicks to flip sheets which are *held* for some time will
+make the flip selector to flip continuously and automatically for
+the user. The interval between flips will keep growing in time,
+so that it helps the user to reach an item which is distant from
+the current selection.
+
+
+Emitted signals
+===============
+
+- ``selected`` - when the widget's selected text item is changed
+- ``overflowed`` - when the widget's current selection is changed
+  from the first item in its list to the last
+- ``underflowed`` - when the widget's current selection is changed
+  from the last item in its list to the first
+- ``focused`` - When the flipselector has received focus. (since 1.8)
+- ``unfocused`` - When the flipselector has lost focus. (since 1.8)
+
+
+Layout text parts
+=================
+
+- ``default`` - label of the flipselector item
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Flipselector
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.FlipSelector
+.. autoclass:: efl.elementary.FlipSelectorItem
diff --git a/doc/elementary/frame.rst b/doc/elementary/frame.rst
index c87a2d2..72ae8e2 100644
--- a/doc/elementary/frame.rst
+++ b/doc/elementary/frame.rst
@@ -1,2 +1,52 @@
+Frame
+#####
 
-.. automodule:: efl.elementary.frame
+.. image:: /images/frame-preview.png
+
+
+Widget description
+==================
+
+Frame is a widget that holds some content and has a title.
+
+
+Available styles
+================
+
+- default
+- pad_small
+- pad_medium
+- pad_large
+- pad_huge
+- outdent_top
+- outdent_bottom
+
+Out of all these styles only default shows the title.
+
+
+Emitted signals
+===============
+
+- ``clicked`` - The user has clicked the frame's label
+
+
+Layout content parts
+====================
+
+- ``default`` - A content of the frame
+
+
+Layout text parts
+=================
+
+- ``default`` - Label of the frame
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Frame
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Frame
diff --git a/doc/elementary/general.rst b/doc/elementary/general.rst
deleted file mode 100644
index 949970f..0000000
--- a/doc/elementary/general.rst
+++ /dev/null
@@ -1,2 +0,0 @@
-
-.. automodule:: efl.elementary.general
diff --git a/doc/elementary/gengrid.rst b/doc/elementary/gengrid.rst
index d2e5c2e..b14bdce 100644
--- a/doc/elementary/gengrid.rst
+++ b/doc/elementary/gengrid.rst
@@ -1,2 +1,324 @@
+Gengrid
+#######
 
-.. automodule:: efl.elementary.gengrid
+.. image:: /images/gengrid-preview.png
+
+
+Widget description
+==================
+
+This widget aims to position objects in a grid layout while actually
+creating and rendering only the visible ones, using the same idea as the
+:py:class:`~efl.elementary.genlist.Genlist`: the user defines a **class** for
+each item, specifying functions that will be called at object creation,
+deletion, etc. When those items are selected by the user, a callback
+function is issued. Users may interact with a gengrid via the mouse (by
+clicking on items to select them and clicking on the grid's viewport and
+swiping to pan the whole view) or via the keyboard, navigating through
+item with the arrow keys.
+
+
+Scrollable Interface
+====================
+
+This widget supports the scrollable interface.
+
+If you wish to control the scolling behaviour using these functions,
+inherit both the widget class and the
+:py:class:`~efl.elementary.scroller.Scrollable` class
+using multiple inheritance, for example::
+
+    class ScrollableGenlist(Genlist, Scrollable):
+        def __init__(self, canvas, *args, **kwargs):
+            Genlist.__init__(self, canvas)
+
+
+Gengrid layouts
+===============
+
+Gengrid may layout its items in one of two possible layouts:
+
+- horizontal or
+- vertical.
+
+When in "horizontal mode", items will be placed in **columns**, from top
+to bottom and, when the space for a column is filled, another one is
+started on the right, thus expanding the grid horizontally, making for
+horizontal scrolling. When in "vertical mode" , though, items will be
+placed in **rows**, from left to right and, when the space for a row is
+filled, another one is started below, thus expanding the grid vertically
+(and making for vertical scrolling).
+
+
+Gengrid items
+=============
+
+An item in a gengrid can have 0 or more texts (they can be regular text
+or textblock Evas objects - that's up to the style to determine), 0 or
+more contents (which are simply objects swallowed into the gengrid
+item's theming Edje object) and 0 or more **boolean states**, which
+have the behavior left to the user to define. The Edje part names for
+each of these properties will be looked up, in the theme file for the
+gengrid, under the Edje (string) data items named ``"texts"``,
+``"contents"`` and ``"states"``, respectively. For each of those
+properties, if more than one part is provided, they must have names
+listed separated by spaces in the data fields. For the default gengrid
+item theme, we have **one** text part (``"elm.text"``), **two** content
+parts (``"elm.swalllow.icon"`` and ``"elm.swallow.end"``) and **no**
+state parts.
+
+A gengrid item may be at one of several styles. Elementary provides one
+by default - "default", but this can be extended by system or
+application custom themes/overlays/extensions (see
+:py:class:`~efl.elementary.theme.Theme` for more details).
+
+
+Gengrid item classes
+====================
+
+In order to have the ability to add and delete items on the fly, gengrid
+implements a class (callback) system where the application provides a
+structure with information about that type of item (gengrid may contain
+multiple different items with different classes, states and styles).
+Gengrid will call the functions in this struct (methods) when an item is
+"realized" (i.e., created dynamically, while the user is scrolling the
+grid). All objects will simply be deleted when no longer needed with
+:meth:`~efl.eo.Eo.delete`. The :class:`GengridItemClass` class contains the
+following attributes and methods:
+
+- ``item_style`` - This is a constant string and simply defines the name
+  of the item style. It **must** be specified and the default should be
+  ``default``.
+- ``func.text_get`` - This function is called when an item object is
+  actually created. The ``data`` parameter will point to the same data
+  passed to :meth:`~Gengrid.item_append` and related item creation
+  functions. The ``obj`` parameter is the gengrid object itself, while
+  the ``part`` one is the name string of one of the existing text parts
+  in the Edje group implementing the item's theme.
+  See :py:meth:`GengridItemClass.text_get`.
+- ``func.content_get`` - This function is called when an item object is
+  actually created. The ``data`` parameter will point to the same data
+  passed to :py:meth:`GengridItem.append_to` and related item creation
+  functions. The ``obj`` parameter is the gengrid object itself, while
+  the ``part`` one is the name string of one of the existing (content)
+  swallow parts in the Edje group implementing the item's theme. It must
+  return ``None,`` when no content is desired, or a valid object handle,
+  otherwise. The object will be deleted by the gengrid on its deletion
+  or when the item is "unrealized". See :py:meth:`GengridItemClass.content_get`.
+- ``func.state_get`` - This function is called when an item object is
+  actually created. The ``data`` parameter will point to the same data
+  passed to :py:meth:`GengridItem.append_to` and related item creation
+  functions. The ``obj`` parameter is the gengrid object itself, while
+  the ``part`` one is the name string of one of the state parts in the
+  Edje group implementing the item's theme. Return ``False`` for
+  false/off or ``True`` for true/on. Gengrids will emit a signal to
+  its theming Edje object with ``"elm,state,xxx,active"`` and ``"elm"``
+  as "emission" and "source" arguments, respectively, when the state is
+  true (the default is false), where ``xxx`` is the name of the (state)
+  part. See :py:meth:`GengridItemClass.state_get`.
+- ``func.del`` - This is called when
+  :meth:`efl.elementary.object_item.ObjectItem.delete` is called on
+  an item or :meth:`~Gengrid.clear` is called on the gengrid. This is
+  intended for use when gengrid items are deleted, so any data attached
+  to the item (e.g. its data parameter on creation) can be deleted. See
+  :py:meth:`GengridItemClass.delete`.
+
+
+Usage hints
+===========
+
+If the user wants to have multiple items selected at the same time,
+:attr:`~Gengrid.multi_select` will permit it. If the gengrid is
+single-selection only (the default), then :attr:`~Gengrid.selected_item`
+will return the selected item or ``None``, if none is selected. If the
+gengrid is under multi-selection, then :attr:`~Gengrid.selected_items`
+will return a list (that is only valid as long as no items are modified
+(added, deleted, selected or unselected) of child items on a gengrid.
+
+If an item changes (internal (boolean) state, text or content changes),
+then use :meth:`~GengridItem.update` to have gengrid update the item with
+the new state. A gengrid will re-"realize" the item, thus calling the
+functions in the :class:`GengridItemClass` set for that item.
+
+To programmatically (un)select an item or get the selected state, use
+:attr:`GengridItem.selected`. To make an item disabled (unable to be
+selected and appear differently) or get the disabled state
+use :attr:`GengridItem.disabled`.
+
+Grid cells will only have their selection smart callbacks called when
+firstly getting selected. Any further clicks will do nothing, unless you
+enable the "always select mode", with :attr:`~Gengrid.select_mode` as
+:attr:`ELM_OBJECT_SELECT_MODE_ALWAYS`, thus making every click to issue
+selection callbacks. :attr:`~Gengrid.select_mode` as
+:attr:`ELM_OBJECT_SELECT_MODE_NONE` will turn off the ability to select items
+entirely in the widget and they will neither appear selected nor call
+the selection smart callbacks.
+
+Remember that you can create new styles and add your own theme
+augmentation per application with
+:meth:`Theme.extension_add<efl.elementary.theme.Theme.extension_add>`. If you
+absolutely must have a specific style that overrides any theme the user
+or system sets up you can use
+:meth:`Theme.extension_add<efl.elementary.theme.Theme.overlay_add>` to add such
+a file.
+
+
+Emitted signals
+===============
+
+- ``activated`` - The user has double-clicked or pressed
+  (enter|return|spacebar) on an item. The ``event_info`` parameter
+  is the gengrid item that was activated.
+- ``clicked,double`` - The user has double-clicked an item.
+  The ``event_info`` parameter is the gengrid item that was double-clicked.
+- ``clicked,right`` - The user has right-clicked an item.  The
+  ``event_info`` parameter is the item that was right-clicked. (since: 1.13)
+- ``longpressed`` - This is called when the item is pressed for a certain
+  amount of time. By default it's 1 second.
+- ``selected`` - The user has made an item selected. The
+  ``event_info`` parameter is the gengrid item that was selected.
+- ``unselected`` - The user has made an item unselected. The
+  ``event_info`` parameter is the gengrid item that was unselected.
+- ``realized`` - This is called when the item in the gengrid
+  has its implementing Evas object instantiated, de facto.
+  ``event_info`` is the gengrid item that was created.
+- ``unrealized`` - This is called when the implementing Evas
+  object for this item is deleted. ``event_info`` is the gengrid
+  item that was deleted.
+- ``changed`` - Called when an item is added, removed, resized
+  or moved and when the gengrid is resized or gets "horizontal"
+  property changes.
+- ``scroll,anim,start`` - This is called when scrolling animation has
+  started.
+- ``scroll,anim,stop`` - This is called when scrolling animation has
+  stopped.
+- ``drag,start,up`` - Called when the item in the gengrid has
+  been dragged (not scrolled) up.
+- ``drag,start,down`` - Called when the item in the gengrid has
+  been dragged (not scrolled) down.
+- ``drag,start,left`` - Called when the item in the gengrid has
+  been dragged (not scrolled) left.
+- ``drag,start,right`` - Called when the item in the gengrid has
+  been dragged (not scrolled) right.
+- ``drag,stop`` - Called when the item in the gengrid has
+  stopped being dragged.
+- ``drag`` - Called when the item in the gengrid is being
+  dragged.
+- ``scroll`` - called when the content has been scrolled
+  (moved).
+- ``scroll,drag,start`` - called when dragging the content has
+  started.
+- ``scroll,drag,stop`` - called when dragging the content has
+  stopped.
+- ``edge,top`` - This is called when the gengrid is scrolled until
+  the top edge.
+- ``edge,bottom`` - This is called when the gengrid is scrolled
+  until the bottom edge.
+- ``edge,left`` - This is called when the gengrid is scrolled
+  until the left edge.
+- ``edge,right`` - This is called when the gengrid is scrolled
+  until the right edge.
+- ``moved`` - This is called when a gengrid item is moved by a user
+  interaction in a reorder mode. The ``event_info`` parameter is the item that
+  was moved.
+- ``index,update`` - This is called when a gengrid item index is changed.
+  Note that this callback is called while each item is being realized.
+- ``highlighted`` - an item in the list is highlighted. This is called when
+  the user presses an item or keyboard selection is done so the item is
+  physically highlighted. The ``event_info`` parameter is the item that was
+  highlighted.
+- ``unhighlighted`` - an item in the list is unhighlighted. This is called
+  when the user releases an item or keyboard selection is moved so the item
+  is physically unhighlighted. The ``event_info`` parameter is the item that
+  was unhighlighted.
+- ``language,changed`` - This is called when the program's language is
+  changed. Call :meth:`~Gengrid.realized_items_update` if items text should
+  be translated.
+- ``focused`` - When the gengrid has received focus. (since 1.8)
+- ``unfocused`` - When the gengrid has lost focus. (since 1.8)
+- ``item,focused`` - When the gengrid item has received focus. (since 1.10)
+- ``item,unfocused`` - When the gengrid item has lost focus. (since 1.10)
+- ``item,reorder,anim,start`` - This is called when a gengrid item movement
+  has just started by keys in reorder mode. The parameter is the item that
+  is going to move. (since 1.10)
+- ``item,reorder,anim,stop`` - This is called when a gengrid item movement just
+  stopped in reorder mode. The parameter is the item that was moved. (since 1.10)
+
+
+Enumerations
+============
+
+.. _Elm_Gengrid_Item_Scrollto_Type:
+
+Items' scroll to types
+----------------------
+
+.. data:: ELM_GENLIST_ITEM_SCROLLTO_NONE
+
+    No scroll to
+
+.. data:: ELM_GENLIST_ITEM_SCROLLTO_IN
+
+    Scroll to the nearest viewport
+
+.. data:: ELM_GENLIST_ITEM_SCROLLTO_TOP
+
+    Scroll to the top of viewport
+
+.. data:: ELM_GENLIST_ITEM_SCROLLTO_MIDDLE
+
+    Scroll to the middle of viewport
+
+
+.. _Elm_Gengrid_Object_Multi_Select_Mode:
+
+Multi-select mode
+-----------------
+
+.. data:: ELM_OBJECT_MULTI_SELECT_MODE_DEFAULT
+
+    Default multiple select mode
+
+    .. versionadded:: 1.10
+
+.. data:: ELM_OBJECT_MULTI_SELECT_MODE_WITH_CONTROL
+
+    Disallow mutiple selection when clicked without control key pressed
+
+    .. versionadded:: 1.10
+
+.. data:: ELM_OBJECT_MULTI_SELECT_MODE_MAX
+
+    Value unknown
+
+    .. versionadded:: 1.10
+
+
+.. _Elm_Gengrid_Reorder_Type:
+
+Reorder type
+------------
+
+.. data:: ELM_GENGRID_REORDER_TYPE_NORMAL
+
+    Normal reorder mode
+
+    .. versionadded:: 1.11
+
+.. data:: ELM_GENGRID_REORDER_TYPE_SWAP
+
+    Swap reorder mode
+
+    .. versionadded:: 1.11
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: efl.elementary.Gengrid
+    :parts: 2
+
+
+.. autoclass:: efl.elementary.Gengrid
+.. autoclass:: efl.elementary.GengridItem
+.. autoclass:: efl.elementary.GengridItemClass
diff --git a/doc/elementary/genlist.rst b/doc/elementary/genlist.rst
index a2a583c..1034009 100644
--- a/doc/elementary/genlist.rst
+++ b/doc/elementary/genlist.rst
@@ -1,2 +1,512 @@
+Genlist
+#######
 
-.. automodule:: efl.elementary.genlist
+.. image:: /images/genlist-preview.png
+
+
+Widget description
+==================
+
+This widget aims to have more expansive list than the simple list in
+Elementary that could have more flexible items and allow many more
+entries while still being fast and low on memory usage. At the same time
+it was also made to be able to do tree structures. But the price to pay
+is more complexity when it comes to usage. If all you want is a simple
+list with icons and a single text, use the normal
+:py:class:`~efl.elementary.list.List` object.
+
+Genlist has a fairly large API, mostly because it's relatively complex,
+trying to be both expansive, powerful and efficient. First we will begin
+an overview on the theory behind genlist.
+
+
+Genlist item classes - creating items
+=====================================
+
+In order to have the ability to add and delete items on the fly, genlist
+implements a class (callback) system where the application provides a
+structure with information about that type of item (genlist may contain
+multiple different items with different classes, states and styles).
+Genlist will call the functions in this struct (methods) when an item is
+"realized" (i.e., created dynamically, while the user is scrolling the
+grid). All objects will simply be deleted when no longer needed with
+:py:meth:`~efl.evas.Object.delete`. :py:class:`GenlistItemClass` contains the
+following members:
+
+- ``item_style`` - This is a constant string and simply defines the name
+  of the item style. It **must** be specified and the default should be
+  ``"default".``
+- ``decorate_item_style`` - This is a constant string and simply defines
+  the name of the decorate mode item style. It is used to specify
+  decorate mode item style. It can be used when you call
+  :py:attr:`GenlistItem.decorate_mode`.
+- ``decorate_all_item_style`` - This is a constant string and simply
+  defines the name of the decorate all item style. It is used to specify
+  decorate all item style. It can be used to set selection, checking and
+  deletion mode. This is used when you call
+  :py:attr:`Genlist.decorate_mode`.
+- ``func`` - A struct with pointers to functions that will be called when
+  an item is going to be actually created. All of them receive a ``data``
+  parameter that will point to the same data passed to
+  :py:meth:`GenlistItem.append_to` and related item creation functions, and an
+  ``obj`` parameter that points to the genlist object itself.
+
+The function pointers inside ``func`` are ``text_get``, ``content_get``,
+``state_get`` and ``del``. The 3 first functions also receive a ``part``
+parameter described below. A brief description of these functions follows:
+
+- ``text_get`` - The ``part`` parameter is the name string of one of the
+  existing text parts in the Edje group implementing the item's theme.
+  See :py:meth:`GenlistItemClass.text_get`.
+- ``content_get`` - The ``part`` parameter is the name string of one of the
+  existing (content) swallow parts in the Edje group implementing the
+  item's theme. It must return ``None``, when no content is desired, or
+  a valid object handle, otherwise.  The object will be deleted by the
+  genlist on its deletion or when the item is "unrealized". See
+  :py:meth:`GenlistItemClass.content_get`.
+- ``func.state_get`` - The ``part`` parameter is the name string of one of
+  the state parts in the Edje group implementing the item's theme. Return
+  ``False`` for false/off or ``True`` for true/on. Genlists will
+  emit a signal to its theming Edje object with ``"elm,state,xxx,active"``
+  and ``"elm"`` as "emission" and "source" arguments, respectively, when
+  the state is true (the default is false), where ``xxx`` is the name of
+  the (state) part.  See :py:meth:`GenlistItemClass.state_get`.
+- ``func.del`` - This is intended for use when genlist items are deleted,
+  so any data attached to the item (e.g. its data parameter on creation)
+  can be deleted. See :py:meth:`GenlistItemClass.delete`.
+
+
+Available item styles
+=====================
+
+- ``default``
+- ``default_style`` The text part is a textblock
+- ``double_label`` Two different text parts
+- ``icon_top_text_bottom``
+- ``group_index``
+- ``one_icon`` Only 1 icon (left) (since: 1.1)
+- ``end_icon`` Only 1 icon (at end/right) (since: 1.1)
+- ``no_icon`` No icon (since: 1.1)
+- ``full`` Only one object, elm.swallow.content, which consumes whole area of
+  the genlist item (since: 1.7)
+
+
+Structure of items
+==================
+
+An item in a genlist can have 0 or more texts (they can be regular text
+or textblock Evas objects - that's up to the style to determine), 0 or
+more contents (which are simply objects swallowed into the genlist item's
+theming Edje object) and 0 or more **boolean states**, which have the
+behavior left to the user to define. The Edje part names for each of
+these properties will be looked up, in the theme file for the genlist,
+under the Edje (string) data items named ``labels``, ``contents``
+and ``states``, respectively. For each of those properties, if more
+than one part is provided, they must have names listed separated by
+spaces in the data fields. For the default genlist item theme, we have
+**one** text part (``elm.text``), **two** content parts
+(``elm.swallow.icon`` and ``elm.swallow.end``) and **no** state parts.
+
+A genlist item may be at one of several styles. Elementary provides one
+by default - "default", but this can be extended by system or application
+custom themes/overlays/extensions (see :py:mod:`themes<efl.elementary.theme>`)
+for more details).
+
+
+Editing and Navigating
+======================
+
+Items can be added by several calls. All of them return a
+:py:class:`GenlistItem` handle that is an internal member inside the genlist.
+They all take a data parameter that is meant to be used for a handle to the
+applications internal data (eg. the struct with the original item data). The
+parent parameter is the parent genlist item this belongs to if it is a tree or
+an indexed group, and None if there is no parent. The flags can be a bitmask of
+:attr:`ELM_GENLIST_ITEM_NONE`, :attr:`ELM_GENLIST_ITEM_TREE` and
+:attr:`ELM_GENLIST_ITEM_GROUP`. If :attr:`ELM_GENLIST_ITEM_TREE` is set then
+this item is displayed as an item that is able to expand and have child items.
+If :attr:`ELM_GENLIST_ITEM_GROUP` is set then this item is group index item
+that is displayed at the top until the next group comes. The func parameter is
+a convenience callback that is called when the item is selected and the data
+parameter will be the func_data parameter, ``obj`` be the genlist object and
+event_info will be the genlist item.
+
+:py:meth:`GenlistItem.append_to` adds an item to the end of the list, or if
+there is a parent, to the end of all the child items of the parent.
+:py:meth:`GenlistItem.prepend_to` is the same but adds to the beginning of
+the list or children list. :py:meth:`GenlistItem.insert_before` inserts at
+item before another item and :py:meth:`GenlistItem.insert_after` inserts after
+the indicated item.
+
+The application can clear the list with :py:meth:`Genlist.clear` which deletes
+all the items in the list and
+:py:meth:`~efl.elementary.object_item.ObjectItem.delete` will delete a specific
+item. :py:meth:`GenlistItem.subitems_clear` will clear all items that are
+children of the indicated parent item.
+
+To help inspect list items you can jump to the item at the top of the list
+with :py:attr:`Genlist.first_item` which will return the item pointer, and
+similarly :py:attr:`Genlist.last_item` gets the item at the end of the list.
+:py:attr:`GenlistItem.next` and :py:attr:`GenlistItem.prev` get the next
+and previous items respectively relative to the indicated item. Using
+these calls you can walk the entire item list/tree. Note that as a tree
+the items are flattened in the list, so :py:attr:`GenlistItem.parent` will
+let you know which item is the parent (and thus know how to skip them if
+wanted).
+
+
+Multi-selection
+===============
+
+If the application wants multiple items to be able to be selected,
+:py:attr:`Genlist.multi_select` can enable this. If the list is
+single-selection only (the default), then :py:attr:`Genlist.selected_item`
+will return the selected item, if any, or None if none is selected. If the
+list is multi-select then :py:attr:`Genlist.selected_items` will return a
+list (that is only valid as long as no items are modified (added, deleted,
+selected or unselected)).
+
+
+Usage hints
+===========
+
+There are also convenience functions.
+:py:attr:`efl.elementary.object_item.ObjectItem.widget` will return the genlist
+object the item belongs to. :py:meth:`GenlistItem.show` will make the scroller
+scroll to show that specific item so its visible.
+:py:attr:`efl.elementary.object_item.ObjectItem.data` returns the data pointer
+set by the item creation functions.
+
+If an item changes (state of boolean changes, text or contents change),
+then use :py:meth:`GenlistItem.update` to have genlist update the item with