288 files changed, 9295 insertions, 9588 deletions

diff --git a/doc/elementary/actionslider.rst b/doc/elementary/actionslider.rst
index df745d4..d701f8a 100644
--- a/doc/elementary/actionslider.rst
+++ b/doc/elementary/actionslider.rst
@@ -1,2 +1,85 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.actionslider
+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:: Actionslider
+    :parts: 2
+
+
+.. autoclass:: Actionslider
diff --git a/doc/elementary/background.rst b/doc/elementary/background.rst
index ddac36a..e02534a 100644
--- a/doc/elementary/background.rst
+++ b/doc/elementary/background.rst
@@ -1,2 +1,58 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.background
+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:: Background
+    :parts: 2
+
+
+.. autoclass:: Background
diff --git a/doc/elementary/box.rst b/doc/elementary/box.rst
index 0661cf1..a02358e 100644
--- a/doc/elementary/box.rst
+++ b/doc/elementary/box.rst
@@ -1,2 +1,118 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.box
+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:: Box
+    :parts: 2
+
+.. autoclass:: Box
diff --git a/doc/elementary/bubble.rst b/doc/elementary/bubble.rst
index 3f0c1a9..d66826a 100644
--- a/doc/elementary/bubble.rst
+++ b/doc/elementary/bubble.rst
@@ -1,2 +1,88 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.bubble
+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:: Bubble
+    :parts: 2
+
+.. autoclass:: Bubble
diff --git a/doc/elementary/button.rst b/doc/elementary/button.rst
index d138ba2..becdc6b 100644
--- a/doc/elementary/button.rst
+++ b/doc/elementary/button.rst
@@ -1,3 +1,65 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.button
+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:: Button
+    :parts: 2
+
+
+.. autoclass:: Button
 
diff --git a/doc/elementary/calendar.rst b/doc/elementary/calendar.rst
index c3fd57a..5278f3d 100644
--- a/doc/elementary/calendar.rst
+++ b/doc/elementary/calendar.rst
@@ -1,2 +1,165 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.calendar_elm
+Calendar
+########
+
+.. 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::
+    Calendar
+    CalendarMark
+    :parts: 2
+
+
+.. autoclass:: Calendar
+.. autoclass:: CalendarMark
diff --git a/doc/elementary/check.rst b/doc/elementary/check.rst
index 7da1ef8..62a714a 100644
--- a/doc/elementary/check.rst
+++ b/doc/elementary/check.rst
@@ -1,2 +1,49 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.check
+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:: Check
+    :parts: 2
+
+
+.. autoclass:: Check
diff --git a/doc/elementary/clock.rst b/doc/elementary/clock.rst
index 519a6e2..d0a896a 100644
--- a/doc/elementary/clock.rst
+++ b/doc/elementary/clock.rst
@@ -1,2 +1,94 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.clock
+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:: Clock
+    :parts: 2
+
+
+.. autoclass:: Clock
diff --git a/doc/elementary/colorselector.rst b/doc/elementary/colorselector.rst
index 21b8103..b79c393 100644
--- a/doc/elementary/colorselector.rst
+++ b/doc/elementary/colorselector.rst
@@ -1,2 +1,66 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.colorselector
+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::
+    Colorselector
+    ColorselectorPaletteItem
+    :parts: 2
+
+
+.. autoclass:: Colorselector
+.. autoclass:: ColorselectorPaletteItem
diff --git a/doc/elementary/configuration.rst b/doc/elementary/configuration.rst
index 3c992da..8dbd278 100644
--- a/doc/elementary/configuration.rst
+++ b/doc/elementary/configuration.rst
@@ -1,2 +1,162 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.configuration
+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:: Configuration
+    :parts: 2
+
+.. autoclass:: Configuration
diff --git a/doc/elementary/conformant.rst b/doc/elementary/conformant.rst
index b13449c..19af68c 100644
--- a/doc/elementary/conformant.rst
+++ b/doc/elementary/conformant.rst
@@ -1,2 +1,43 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.conformant
+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:: Conformant
+    :parts: 2
+
+
+.. autoclass:: Conformant
diff --git a/doc/elementary/ctxpopup.rst b/doc/elementary/ctxpopup.rst
index 95151ac..a9dc880 100644
--- a/doc/elementary/ctxpopup.rst
+++ b/doc/elementary/ctxpopup.rst
@@ -1,2 +1,86 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.ctxpopup
+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::
+    Ctxpopup
+    CtxpopupItem
+    :parts: 2
+
+
+.. autoclass:: Ctxpopup
+.. autoclass:: CtxpopupItem
diff --git a/doc/elementary/datetime.rst b/doc/elementary/datetime.rst
index cf98d10..c271396 100644
--- a/doc/elementary/datetime.rst
+++ b/doc/elementary/datetime.rst
@@ -1,2 +1,219 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.datetime_elm
+Datetime
+########
+
+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:: Datetime
+    :parts: 2
+
+.. autoclass:: Datetime
diff --git a/doc/elementary/dayselector.rst b/doc/elementary/dayselector.rst
index 4540b10..7eb0ac8 100644
--- a/doc/elementary/dayselector.rst
+++ b/doc/elementary/dayselector.rst
@@ -1,2 +1,99 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.dayselector
+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:: Dayselector
+    :parts: 2
+
+.. autoclass:: Dayselector
diff --git a/doc/elementary/diskselector.rst b/doc/elementary/diskselector.rst
index 10879bd..76ec557 100644
--- a/doc/elementary/diskselector.rst
+++ b/doc/elementary/diskselector.rst
@@ -1,2 +1,72 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.diskselector
+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::
+    Diskselector
+    DiskselectorItem
+    :parts: 2
+
+
+.. autoclass:: Diskselector
+.. autoclass:: DiskselectorItem
diff --git a/doc/elementary/elementary.rst b/doc/elementary/elementary.rst
index 657598f..197ca59 100644
--- a/doc/elementary/elementary.rst
+++ b/doc/elementary/elementary.rst
@@ -1,10 +1,7 @@
-
-Elementary
-##########
-
+.. module:: efl.elementary
 
 What is elementary?
-===================
+*******************
 
 Elementary is a  the high level toolkit based on the underlying efl
 technologies (:doc:`Evas </evas/evas>`, :doc:`Edje </edje/edje>`,
@@ -16,10 +13,10 @@ of flexibility.
 
 
 Callbacks
-=========
+*********
 
 Widget callbacks
-----------------
+================
 
 Widget callbacks are set with callback_*_add methods which take a callable,
 and optional args, kwargs as data.
@@ -34,7 +31,7 @@ or::
 
 
 Event callbacks
----------------
+===============
 
 Event callbacks have signature of::
 
@@ -42,91 +39,418 @@ Event callbacks have signature of::
 
 
 A sample Python Elementary program
-==================================
+**********************************
 
 .. literalinclude:: ../../examples/elementary/test_win_dialog.py
     :language: python
 
 
 API Reference
-=============
+*************
+
+
+Enumerations
+============
+
+.. _Elm_Object_Layer:
+
+Object layers
+-------------
+
+.. versionadded:: 1.14
+
+.. data:: ELM_OBJECT_LAYER_BACKGROUND
+
+    where to place backgrounds
+
+.. data:: ELM_OBJECT_LAYER_DEFAULT
+
+    Evas_Object default layer (and thus for Elementary)
+
+.. data:: ELM_OBJECT_LAYER_FOCUS
+
+    where focus object visualization is
+
+.. data:: ELM_OBJECT_LAYER_TOOLTIP
+
+    where to show tooltips
+
+.. data:: ELM_OBJECT_LAYER_CURSOR
+
+    where to show cursors
+
+.. data:: ELM_OBJECT_LAYER_LAST
+
+    last layer known by Elementary
+
+
+.. _Elm_Policy:
+
+Policy types
+------------
+
+.. data:: ELM_POLICY_QUIT
+
+    Under which circumstances the application should quit automatically.
+
+.. data:: ELM_POLICY_EXIT
+
+    Defines elm_exit() behaviour. (since 1.8)
+
+.. data:: ELM_POLICY_THROTTLE
+
+    Defines how throttling should work (since 1.8)
+
+
+.. _Elm_Policy_Quit:
+
+Quit policy types
+-----------------
+
+.. data:: ELM_POLICY_QUIT_NONE
+
+    Never quit the application automatically
+
+.. data:: ELM_POLICY_QUIT_LAST_WINDOW_CLOSED
+
+    Quit when the application's last window is closed
+
+
+.. _Elm_Policy_Exit:
+
+Exit policy types
+-----------------
+
+Possible values for the ELM_POLICY_EXIT policy.
+
+.. data:: ELM_POLICY_EXIT_NONE
+
+    Just quit the main loop on exit().
+
+.. data:: ELM_POLICY_EXIT_WINDOWS_DEL
+
+    Delete all the windows after quitting the main loop.
+
+
+.. _Elm_Policy_Throttle:
+
+Throttle policy types
+---------------------
+
+Possible values for the #ELM_POLICY_THROTTLE policy.
+
+.. data:: ELM_POLICY_THROTTLE_CONFIG
+
+    Do whatever elementary config is configured to do.
+
+.. data:: ELM_POLICY_THROTTLE_HIDDEN_ALWAYS
+
+    Always throttle when all windows are no longer visible.
+
+.. data:: ELM_POLICY_THROTTLE_NEVER
+
+    Never throttle when windows are all hidden, regardless of config settings.
+
+
+.. _Elm_Process_State:
+
+Elm_Process_State
+-----------------
+
+.. data:: ELM_PROCESS_STATE_FOREGROUND
+
+    The process is in a foreground/active/running state - work as normal.
+
+    .. versionadded:: 1.12
+
+.. data:: ELM_PROCESS_STATE_BACKGROUND
+
+    The process is in the bacgkround, so you may want to stop animating,
+    fetching data as often etc.
+
+    .. versionadded:: 1.12
+
+
+.. _Elm_Sys_Notify_Closed_Reason:
+
+Notify close reasons
+--------------------
+
+The reason the notification was closed
+
+.. data:: ELM_SYS_NOTIFY_CLOSED_EXPIRED
+
+    The notification expired.
+
+    .. versionadded:: 1.10
+
+.. data:: ELM_SYS_NOTIFY_CLOSED_DISMISSED
+
+    The notification was dismissed by the user.
+
+    .. versionadded:: 1.10
+
+.. data:: ELM_SYS_NOTIFY_CLOSED_REQUESTED
+
+    The notification was closed by a call to CloseNotification method.
+
+    .. versionadded:: 1.10
+
+.. data:: ELM_SYS_NOTIFY_CLOSED_UNDEFINED
+
+    Undefined/reserved reasons.
+
+    .. versionadded:: 1.10
+
+
+.. _Elm_Sys_Notify_Urgency:
+
+Notify urgency levels
+---------------------
+
+Urgency levels of a notification
+
+:see: :py:func:`sys_notify_send`
+
+.. data:: ELM_SYS_NOTIFY_URGENCY_LOW
+
+    Low
+
+    .. versionadded:: 1.10
+
+.. data:: ELM_SYS_NOTIFY_URGENCY_NORMAL
+
+    Normal
+
+    .. versionadded:: 1.10
+
+.. data:: ELM_SYS_NOTIFY_URGENCY_CRITICAL
+
+    Critical
+
+    .. versionadded:: 1.10
+
+
+.. _Elm_Glob_Match_Flags:
+
+Glob matching
+-------------
+
+Glob matching bitfiled flags
+
+.. data:: ELM_GLOB_MATCH_NO_ESCAPE
+
+    Treat backslash as an ordinary character instead of escape.
+
+    .. versionadded:: 1.11
+
+.. data:: ELM_GLOB_MATCH_PATH
+
+    Match a slash in string only with a slash in pattern and not by an
+    asterisk (*) or a question mark (?) metacharacter, nor by a bracket
+    expression ([]) containing a slash.
+
+    .. versionadded:: 1.11
+
+.. data:: ELM_GLOB_MATCH_PERIOD
+
+    Leading period in string has to be matched exactly by a period in
+    pattern. A period is considered to be leading if it is the first
+    character in string, or if both ELM_GLOB_MATCH_PATH is set and the
+    period immediately follows a slash.
+
+    .. versionadded:: 1.11
+
+.. data:: ELM_GLOB_MATCH_NOCASE
+
+    The pattern is matched case-insensitively.
+
+    .. versionadded:: 1.11
+
+
+.. _General:
+
+General
+=======
+
+General Elementary API. Functions that don't relate to
+Elementary objects specifically.
+
+Here are documented functions which init/shutdown the library,
+that apply to generic Elementary objects, that deal with
+configuration, et cetera.
+
+.. autoclass:: EthumbConnect
+.. autoclass:: ConfigAllChanged
+.. autoclass:: PolicyChanged
+.. autoclass:: ProcessBackground
+.. autoclass:: ProcessForeground
+
+.. autofunction:: on_ethumb_connect
+.. autofunction:: on_config_all_changed
+.. autofunction:: on_policy_changed
+.. autofunction:: on_process_background
+.. autofunction:: on_process_foreground
+
+.. autofunction:: init
+.. autofunction:: shutdown
+.. autofunction:: run
+.. autofunction:: exit
+
+.. autofunction:: policy_set
+.. autofunction:: policy_get
+.. autofunction:: language_set
+.. autofunction:: process_state_get
+
+
+.. _Fingers:
+
+Fingers
+=======
+
+Elementary is designed to be finger-friendly for touchscreens,
+and so in addition to scaling for display resolution, it can
+also scale based on finger "resolution" (or size). You can then
+customize the granularity of the areas meant to receive clicks
+on touchscreens.
+
+Different profiles may have pre-set values for finger sizes.
+
+.. autofunction:: coords_finger_size_adjust
+
+
+.. _Caches:
+
+Caches
+======
+
+These are functions which let one fine-tune some cache values for
+Elementary applications, thus allowing for performance adjustments.
+
+.. autofunction:: cache_all_flush
+
+
+.. _Fonts:
+
+Fonts
+=====
+
+These are functions dealing with font rendering, selection and the
+like for Elementary applications. One might fetch which system
+fonts are there to use and set custom fonts for individual classes
+of UI items containing text (text classes).
+
+.. autofunction:: font_properties_get
+.. autofunction:: font_properties_free
+
+.. autofunction:: font_fontconfig_name_get
+
+.. autoclass:: FontProperties
+
+
+.. _Debug:
+
+Debug
+=====
+
+Don't use them unless you are sure.
+
+.. autofunction:: object_tree_dump
+.. autofunction:: object_tree_dot_dump
+
+
+.. _Sys_Notify:
+
+Sys Notify
+==========
+
+.. autofunction:: sys_notify_close
+.. autofunction:: sys_notify_send
+
+.. autofunction:: on_sys_notify_notification_closed
+.. autofunction:: on_sys_notify_action_invoked
+
+.. autoclass:: SysNotifyNotificationClosed
+.. autoclass:: SysNotifyActionInvoked
+
+
+Widgets
+=======
 
 .. toctree:: *
    :glob:
    :maxdepth: 1
 
 
+
 Inheritance diagram
 ===================
 
 .. inheritance-diagram::
-    efl.elementary.actionslider
-    efl.elementary.background
-    efl.elementary.box
-    efl.elementary.bubble
-    efl.elementary.button
-    efl.elementary.calendar_elm
-    efl.elementary.check
-    efl.elementary.clock
-    efl.elementary.colorselector
-    efl.elementary.configuration
-    efl.elementary.conformant
-    efl.elementary.ctxpopup
-    efl.elementary.datetime_elm
-    efl.elementary.dayselector
-    efl.elementary.diskselector
-    efl.elementary.entry
-    efl.elementary.fileselector
-    efl.elementary.fileselector_button
-    efl.elementary.fileselector_entry
-    efl.elementary.flip
-    efl.elementary.flipselector
-    efl.elementary.frame
-    efl.elementary.general
-    efl.elementary.gengrid
-    efl.elementary.genlist
-    efl.elementary.gesture_layer
-    efl.elementary.grid
-    efl.elementary.hover
-    efl.elementary.hoversel
-    efl.elementary.icon
-    efl.elementary.image
-    efl.elementary.index
-    efl.elementary.innerwindow
-    efl.elementary.label
-    efl.elementary.layout
-    efl.elementary.layout_class
-    efl.elementary.list
-    efl.elementary.map
-    efl.elementary.mapbuf
-    efl.elementary.menu
-    efl.elementary.multibuttonentry
-    efl.elementary.naviframe
-    efl.elementary.need
-    efl.elementary.notify
-    efl.elementary.object
-    efl.elementary.object_item
-    efl.elementary.panel
-    efl.elementary.panes
-    efl.elementary.photo
-    efl.elementary.photocam
-    efl.elementary.plug
-    efl.elementary.popup
-    efl.elementary.progressbar
-    efl.elementary.radio
-    efl.elementary.scroller
-    efl.elementary.segment_control
-    efl.elementary.separator
-    efl.elementary.slider
-    efl.elementary.slideshow
-    efl.elementary.spinner
-    efl.elementary.systray
-    efl.elementary.table
-    efl.elementary.theme
-    efl.elementary.thumb
-    efl.elementary.toolbar
-    efl.elementary.transit
-    efl.elementary.video
-    efl.elementary.web
-    efl.elementary.window
-    :parts: 2
+    efl.elementary.Actionslider
+    efl.elementary.Background
+    efl.elementary.Box
+    efl.elementary.Bubble
+    efl.elementary.Button
+    efl.elementary.Calendar
+    efl.elementary.Check
+    efl.elementary.Clock
+    efl.elementary.Colorselector
+    efl.elementary.Configuration
+    efl.elementary.Conformant
+    efl.elementary.Ctxpopup
+    efl.elementary.Datetime
+    efl.elementary.Dayselector
+    efl.elementary.Diskselector
+    efl.elementary.Entry
+    efl.elementary.Fileselector
+    efl.elementary.FileselectorButton
+    efl.elementary.FileselectorEntry
+    efl.elementary.Flip
+    efl.elementary.FlipSelector
+    efl.elementary.Frame
+    efl.elementary.Gengrid
+    efl.elementary.Genlist
+    efl.elementary.GestureLayer
+    efl.elementary.Grid
+    efl.elementary.Hover
+    efl.elementary.Hoversel
+    efl.elementary.Icon
+    efl.elementary.Image
+    efl.elementary.Index
+    efl.elementary.InnerWindow
+    efl.elementary.Label
+    efl.elementary.Layout
+    efl.elementary.List
+    efl.elementary.Map
+    efl.elementary.Mapbuf
+    efl.elementary.Menu
+    efl.elementary.MultiButtonEntry
+    efl.elementary.Naviframe
+    efl.elementary.Notify
+    efl.elementary.Object
+    efl.elementary.ObjectItem
+    efl.elementary.Panel
+    efl.elementary.Panes
+    efl.elementary.Photo
+    efl.elementary.Photocam
+    efl.elementary.Plug
+    efl.elementary.Popup
+    efl.elementary.Progressbar
+    efl.elementary.Radio
+    efl.elementary.Scroller
+    efl.elementary.SegmentControl
+    efl.elementary.Separator
+    efl.elementary.Slider
+    efl.elementary.Slideshow
+    efl.elementary.Spinner
+    efl.elementary.Systray
+    efl.elementary.Table
+    efl.elementary.Theme
+    efl.elementary.Thumb
+    efl.elementary.Toolbar
+    efl.elementary.Transit
+    efl.elementary.Video
+    efl.elementary.Web
+    efl.elementary.Window
+    :parts: 1
diff --git a/doc/elementary/entry.rst b/doc/elementary/entry.rst
index bd5ba13..f25708f 100644
--- a/doc/elementary/entry.rst
+++ b/doc/elementary/entry.rst
@@ -1,2 +1,581 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.entry
+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_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_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
+
+
+Inheritance diagram
+===================
+
+.. inheritance-diagram:: Entry
+    :parts: 2
+
+.. autofunction:: markup_to_utf8
+.. autofunction:: utf8_to_markup
+
+.. autoclass:: Entry
+.. autoclass:: EntryContextMenuItem
+.. autoclass:: FilterLimitSize
+.. autoclass:: FilterAcceptSet
+.. autoclass:: EntryAnchorInfo
+.. autoclass:: EntryAnchorHoverInfo
diff --git a/doc/elementary/fileselector.rst b/doc/elementary/fileselector.rst
index 00ddcf4..96da8c2 100644
--- a/doc/elementary/fileselector.rst
+++ b/doc/elementary/fileselector.rst
@@ -1,2 +1,137 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.fileselector
+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:: Fileselector
+    :parts: 2
+
+
+.. autoclass:: Fileselector
diff --git a/doc/elementary/fileselector_button.rst b/doc/elementary/fileselector_button.rst
index b2566b7..fd06331 100644
--- a/doc/elementary/fileselector_button.rst
+++ b/doc/elementary/fileselector_button.rst
@@ -1,2 +1,75 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.fileselector_button
+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:: FileselectorButton
+    :parts: 2
+
+
+.. autoclass:: FileselectorButton
diff --git a/doc/elementary/fileselector_entry.rst b/doc/elementary/fileselector_entry.rst
index 8479474..b916ab4 100644
--- a/doc/elementary/fileselector_entry.rst
+++ b/doc/elementary/fileselector_entry.rst
@@ -1,2 +1,90 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.fileselector_entry
+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:: FileselectorEntry
+    :parts: 2
+
+
+.. autoclass:: FileselectorEntry
diff --git a/doc/elementary/flip.rst b/doc/elementary/flip.rst
index 0644602..0e3ae83 100644
--- a/doc/elementary/flip.rst
+++ b/doc/elementary/flip.rst
@@ -1,2 +1,164 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.flip
+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:: Flip
+    :parts: 2
+
+
+.. autoclass:: Flip
diff --git a/doc/elementary/flipselector.rst b/doc/elementary/flipselector.rst
index 0bf5cf1..aa4e4af 100644
--- a/doc/elementary/flipselector.rst
+++ b/doc/elementary/flipselector.rst
@@ -1,2 +1,52 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.flipselector
+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::
+    FlipSelector
+    FlipSelectorItem
+    :parts: 2
+
+
+.. autoclass:: FlipSelector
+.. autoclass:: FlipSelectorItem
diff --git a/doc/elementary/frame.rst b/doc/elementary/frame.rst
index c87a2d2..ce18e88 100644
--- a/doc/elementary/frame.rst
+++ b/doc/elementary/frame.rst
@@ -1,2 +1,54 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.frame
+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:: Frame
+    :parts: 2
+
+
+.. autoclass:: 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..294fb9b 100644
--- a/doc/elementary/gengrid.rst
+++ b/doc/elementary/gengrid.rst
@@ -1,2 +1,329 @@
+.. currentmodule:: efl.elementary
 
-.. automodule:: efl.elementary.gengrid
+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.
+
+