aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authordavemds <dave@gurumeditation.it>2013-09-15 18:12:28 +0200
committerdavemds <dave@gurumeditation.it>2013-09-15 18:12:28 +0200
commit6b9058c51ae0eb1ec3adfefd86a1af28364c3aea (patch)
tree965cf9c76fa0d5e16f3e135b30f5f1d2901cfc09 /README
parentPython-EFL: warn the user when try to use the subprocess or the signal module... (diff)
downloadpython-efl-6b9058c51ae0eb1ec3adfefd86a1af28364c3aea.tar.gz
Python-EFL: renamed TODO to README, with some small additions
Diffstat (limited to 'README')
-rw-r--r--README110
1 files changed, 110 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..4275b83
--- /dev/null
+++ b/README
@@ -0,0 +1,110 @@
+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