PYTHON-EFL 1.7.99


EFL is a collection of libraries for handling many common tasks a
developer man have such as data structures, communication, rendering,
widgets and more. PYTHON-EFL are the python bindings for EFL and Elementary.


INSTALL
=======
For installation instruction see the INSTALL file.


BUGS
====

* Evas: smart object doesn't work
* EdjeEdit: PartState API does not work
* Docs: GenlistWidget is documented instead of Genlist
        (all the scrollable are affected)

   - One solution to this is to use inherited-members option in autodoc.
     Is there a way to have only the immediate parents this way?

   - Another is having an abstraction layer with all functions defined and
     documented in Genlist and then calling the parent class functions.
     This defeats the purpose of having it in many classes.
     Perhaps there is some clever way to use getattr and __doc__ = ...?


TODO
====

* evas.SmartObject
* edje: complete the unit tests
* elm.Web need a test
* elm.PhotoCam need a test
* include python-ethumb
* Review the internal functions and name them consistently
* Add more documentation for the use of callbacks
* Document our use of exceptions
* update links and text on:
  http://www.freedesktop.org/wiki/Software/DBusBindings
* Split base object defines from includes/efl.evas.pxd so that everything
  defined there doesn't get included to the C code that cimports it.
  This may have been fixed in latest versions of Cython.
* Add more scrollables once the documentation issue (and others) is solved.
* Review the new elm list type object item system.
* Check for documentation changes.
* Elm Drag-n-Drop
* Unit tests for elm, things like top_widget and getting child objects
  can be done easily.

* Images missing in the documentation:
   - datetime
   - video
   - web
   - window ?


CHANGES FROM 1.7 to 1.8
=======================

* added efl container package
* ecore.file.Download => efl.ecore.FileDownload
* edje.edit.EdjeEdit => efl.edje_edit.EdjeEdit
* Emotion(module_filename="xxx") => Emotion(module_name="xxx")
* elementary.need_e_dbus => elementary.need_edbus
* elm.domain_translatable_text_part_set => elm.domain_translatable_part_text_set
* elm.Scroller.custom_widget_base_theme_set =>  elm.Layout.theme_set             TODO is this right?
* elm.notify.orient_set/get/prop removed  =>  align_set (TODO)
* Many _set functions that would previously return status now instead raise
  an exception when the underlying C function returns failure:

   - efl.elementary.entry.Entry.file_set
   - efl.elementary.fileselector.Fileselector.selected_set
   - efl.elementary.genlist.GenlistItem.tooltip_window_mode_set
   - efl.elementary.icon.Icon.standard_set
   - efl.elementary.image.Image.file_set
   - efl.elementary.layout_class.LayoutClass.file_set
   - efl.elementary.layout_class.LayoutClass.theme_set
   - efl.elementary.layout_class.LayoutClass.box_append
   - efl.elementary.layout_class.LayoutClass.box_prepend
   - efl.elementary.layout_class.LayoutClass.box_insert_before
   - efl.elementary.layout_class.LayoutClass.box_insert_at
   - efl.elementary.layout_class.LayoutClass.box_remove_all
   - efl.elementary.layout_class.LayoutClass.table_pack
   - efl.elementary.layout_class.LayoutClass.table_clear
   - efl.elementary.layout_class.LayoutClass.part_cursor_set
   - efl.elementary.layout_class.LayoutClass.part_cursor_unset
   - efl.elementary.layout_class.LayoutClass.part_cursor_style_set
   - efl.elementary.layout_class.LayoutClass.part_cursor_engine_only_set
   - efl.elementary.photo.Photo.file_set
   - efl.elementary.photocam.Photocam.file_set
   - efl.elementary.video.Video.file_set

  This also applies when assigning the relevant properties.


* This list of stuff will not be ported to the 1.8 tree. Because they are old,
  not portable, or just because no one used and seem not usefull:

   - EcoreEvas
   - EcoreImf
   - EcoreX
   - EcoreWin32
   - python-evas/evas/utils.py
   - python-evas/evas/decorators.py
   - python-evas/evas/debug.py
   - python-evas old hack to rotate objects