Mark the ComboBox widget as broken/deprecated.

This is really sad, but the combobox is broken by design and should have been never used in legacy code.

Really, really, sorry about the inconvenience!!

doc/elementary/combobox.rst

@@ -3,8 +3,18 @@
 Combobox
 ########
 
-.. image:: /images/combobox-preview.png
+.. warning::
+    **THE COMBOBOX IS BROKEN AND DEPRECATED, DO NOT USE IN ANY CASE !!**
 
+    The behaviour and the API of the Combobox will change in future release.
+
+    If you are already using this we really encourage you to switch
+    to other widgets.
+
+    We are really sorry about this breakage, but there is nothing we can do
+    to avoid this :(
+
+.. image:: /images/combobox-preview.png
 
 Widget description
 ==================

efl/elementary/combobox.pxi

@@ -97,8 +97,22 @@ class Combobox(_Combobox, Button, Entry, Genlist, Hover):
 
     This is the class that actually implements the widget.
 
+    .. warning::
+        **THE COMBOBOX WIDGET IS BROKEN AND DEPRECATED, DO NOT USE IN ANY CASE !!**
+
+        The behaviour and the API of the Combobox will change in future release.
+
+        If you are already using this we really encourage you to switch
+        to other widgets.
+
+        We are really sorry about this breakage, but there is nothing we can do
+        to avoid this :(
+
     .. versionadded:: 1.17
 
+    .. versionchanged:: 1.18
+        The combobox widget has been deprecated. Don't use it in ANY case.
+
     """
     def __init__(self, evasObject parent, *args, **kwargs):
         """Combobox(...)
@@ -109,6 +123,17 @@ class Combobox(_Combobox, Button, Entry, Genlist, Hover):
                           as properties of the instance
 
         """
+        print("""
+        **THE COMBOBOX IS BROKEN AND DEPRECATED, DO NOT USE IN ANY CASE !!**
+
+        The behaviour and the API of the Combobox will change in future release.
+
+        If you are already using this we really encourage you to switch
+        to other widgets.
+
+        We are really sorry about this breakage, but there is nothing we can do
+        to avoid this :(
+        """)
         _Combobox.__init__(self, parent, *args, **kwargs)
 
 

examples/elementary/test_combobox.py

@@ -5,7 +5,7 @@ from efl.evas import EVAS_HINT_EXPAND, EXPAND_BOTH, EXPAND_HORIZ, FILL_HORIZ, \
     EVAS_ASPECT_CONTROL_VERTICAL
 from efl import elementary as elm
 from efl.elementary import StandardWindow, Box, Button, Icon, Separator, \
-    Combobox, GenlistItemClass
+    Combobox, GenlistItemClass, Label
 
 
 class ComboboxItemClass(GenlistItemClass):
@@ -98,6 +98,16 @@ def combobox_clicked(obj):
     bx.pack_start(bt)
     bt.show()
 
+    lb = Label(win, text="""<failure>
+<big><b>THE COMBOBOX WIDGET IS BROKEN AND DEPRECATED.<br>
+DO NOT USE IN ANY CASE.<b></big><br><br>
+The behaviour and the API of the Combobox will change in future release.<br> <br>
+If you are already using this we really encourage you to switch to other widgets.<br><br>
+We are really sorry about this breakage, but there is nothing we can do to avoid this :( <br><br></failure>
+""")
+    bx.pack_start(lb)
+    lb.show()
+
     #
     win.show()