summaryrefslogtreecommitdiff
path: root/efl
diff options
context:
space:
mode:
authorDave Andreoli <dave@gurumeditation.it>2015-01-03 20:17:24 +0100
committerDave Andreoli <dave@gurumeditation.it>2015-01-03 20:17:24 +0100
commit6ff99982587c8e44b84bd384eb06ab28e6b558cf (patch)
tree26d2297aa3371e46bff846d5b3bde67ee0c7ca00 /efl
parent64c1d33c9f69ec43e342337cb06920b83781cb86 (diff)
Lots of documentation fixes for ALL the classes
Mainly with regard of class __init__ params and the **keyword param
Diffstat (limited to 'efl')
-rw-r--r--efl/ecore/efl.ecore_animator.pxi46
-rw-r--r--efl/ecore/efl.ecore_exe.pxi4
-rw-r--r--efl/ecore/efl.ecore_fd_handler.pxi23
-rw-r--r--efl/ecore/efl.ecore_file_download.pxi17
-rw-r--r--efl/ecore/efl.ecore_file_monitor.pxi18
-rw-r--r--efl/ecore/efl.ecore_idler.pxi80
-rw-r--r--efl/ecore/efl.ecore_poller.pxi25
-rw-r--r--efl/ecore/efl.ecore_timer.pxi30
-rw-r--r--efl/edje/efl.edje_object.pxi55
-rw-r--r--efl/elementary/access.pyx13
-rw-r--r--efl/elementary/actionslider.pyx13
-rw-r--r--efl/elementary/background.pyx20
-rw-r--r--efl/elementary/box.pyx15
-rw-r--r--efl/elementary/bubble.pyx13
-rw-r--r--efl/elementary/button.pyx13
-rw-r--r--efl/elementary/calendar_elm.pyx20
-rw-r--r--efl/elementary/check.pyx13
-rw-r--r--efl/elementary/clock.pyx13
-rw-r--r--efl/elementary/colorselector.pyx32
-rw-r--r--efl/elementary/conformant.pyx13
-rw-r--r--efl/elementary/ctxpopup.pyx49
-rw-r--r--efl/elementary/datetime_elm.pyx184
-rw-r--r--efl/elementary/dayselector.pyx13
-rw-r--r--efl/elementary/diskselector.pyx26
-rw-r--r--efl/elementary/entry.pyx51
-rw-r--r--efl/elementary/fileselector.pyx13
-rw-r--r--efl/elementary/fileselector_button.pyx13
-rw-r--r--efl/elementary/fileselector_entry.pyx11
-rw-r--r--efl/elementary/flip.pyx9
-rw-r--r--efl/elementary/flipselector.pyx36
-rw-r--r--efl/elementary/frame.pyx13
-rw-r--r--efl/elementary/gengrid_item.pxi5
-rw-r--r--efl/elementary/gengrid_widget.pxi13
-rw-r--r--efl/elementary/genlist_item.pxi16
-rw-r--r--efl/elementary/genlist_widget.pxi13
-rw-r--r--efl/elementary/gesture_layer.pyx39
-rw-r--r--efl/elementary/glview.pyx13
-rw-r--r--efl/elementary/grid.pyx9
-rw-r--r--efl/elementary/hover.pyx9
-rw-r--r--efl/elementary/hoversel.pyx23
-rw-r--r--efl/elementary/icon.pyx13
-rw-r--r--efl/elementary/image.pyx25
-rw-r--r--efl/elementary/index.pyx23
-rw-r--r--efl/elementary/innerwindow.pyx13
-rw-r--r--efl/elementary/label.pyx13
-rw-r--r--efl/elementary/layout.pyx13
-rw-r--r--efl/elementary/layout_class.pyx1
-rw-r--r--efl/elementary/list.pyx25
-rw-r--r--efl/elementary/map.pyx8
-rw-r--r--efl/elementary/mapbuf.pyx13
-rw-r--r--efl/elementary/menu.pyx23
-rw-r--r--efl/elementary/multibuttonentry.pyx18
-rw-r--r--efl/elementary/naviframe.pyx18
-rw-r--r--efl/elementary/notify.pyx9
-rw-r--r--efl/elementary/object.pyx1
-rw-r--r--efl/elementary/object_item.pyx1
-rw-r--r--efl/elementary/panel.pyx11
-rw-r--r--efl/elementary/panes.pyx13
-rw-r--r--efl/elementary/photo.pyx13
-rw-r--r--efl/elementary/photocam.pyx21
-rw-r--r--efl/elementary/plug.pyx9
-rw-r--r--efl/elementary/popup.pyx18
-rw-r--r--efl/elementary/progressbar.pyx13
-rw-r--r--efl/elementary/radio.pyx13
-rw-r--r--efl/elementary/scroller.pyx1
-rw-r--r--efl/elementary/segment_control.pyx18
-rw-r--r--efl/elementary/separator.pyx13
-rw-r--r--efl/elementary/slider.pyx13
-rw-r--r--efl/elementary/slideshow.pyx18
-rw-r--r--efl/elementary/spinner.pyx13
-rw-r--r--efl/elementary/store.pyx5
-rw-r--r--efl/elementary/table.pyx9
-rw-r--r--efl/elementary/theme.pyx1
-rw-r--r--efl/elementary/thumb.pyx13
-rw-r--r--efl/elementary/toolbar.pyx19
-rw-r--r--efl/elementary/transit.pyx22
-rw-r--r--efl/elementary/video.pyx22
-rw-r--r--efl/elementary/web.pyx14
-rw-r--r--efl/elementary/window.pyx47
-rw-r--r--efl/emotion/efl.emotion.pyx25
-rw-r--r--efl/ethumb/efl.ethumb_client.pyx21
-rw-r--r--efl/evas/efl.evas_canvas.pxi4
-rw-r--r--efl/evas/efl.evas_object.pxi6
-rw-r--r--efl/evas/efl.evas_object_box.pxi21
-rw-r--r--efl/evas/efl.evas_object_grid.pxi13
-rw-r--r--efl/evas/efl.evas_object_image.pxi54
-rw-r--r--efl/evas/efl.evas_object_line.pxi40
-rw-r--r--efl/evas/efl.evas_object_polygon.pxi35
-rw-r--r--efl/evas/efl.evas_object_rectangle.pxi26
-rw-r--r--efl/evas/efl.evas_object_table.pxi12
-rw-r--r--efl/evas/efl.evas_object_text.pxi53
-rw-r--r--efl/evas/efl.evas_object_textblock.pxi29
-rw-r--r--efl/evas/efl.evas_object_textgrid.pxi11
-rw-r--r--efl/evas/efl.evas_rect.pxi6
94 files changed, 1344 insertions, 602 deletions
diff --git a/efl/ecore/efl.ecore_animator.pxi b/efl/ecore/efl.ecore_animator.pxi
index ebcc9fb..d80f767 100644
--- a/efl/ecore/efl.ecore_animator.pxi
+++ b/efl/ecore/efl.ecore_animator.pxi
@@ -17,7 +17,9 @@
17 17
18 18
19cdef class Animator(Eo): 19cdef class Animator(Eo):
20 """Creates an animator to tick off at every animaton tick during main loop 20 """
21
22 Creates an animator to tick off at every animaton tick during main loop
21 execution. 23 execution.
22 24
23 This class represents an animator that will call the given ``func`` 25 This class represents an animator that will call the given ``func``
@@ -36,13 +38,23 @@ cdef class Animator(Eo):
36 returning *False* from ``func``, otherwise they'll continue alive, even 38 returning *False* from ``func``, otherwise they'll continue alive, even
37 if the current python context delete it's reference to it. 39 if the current python context delete it's reference to it.
38 40
39 :param func: 41 """
40 function to call every frame. Expected signature:: 42 def __init__(self, func, *args, **kargs):
43 """Animator(...)
44
45 :param func: function to call at every frame.
46 :type func: callable
47 :param \*args: All the remaining arguments will be passed
48 back in the callback function.
49 :param \**kwargs: All the remaining keyword arguments will be passed
50 back in the callback function.
51
52 Expected **func** signature::
41 53
42 func(*args, **kargs) -> bool 54 func(*args, **kargs) -> bool
43 55
44 """ 56 """
45 def __init__(self, func, *args, **kargs): 57
46 if not callable(func): 58 if not callable(func):
47 raise TypeError("Parameter 'func' must be callable") 59 raise TypeError("Parameter 'func' must be callable")
48 self.func = func 60 self.func = func
@@ -85,11 +97,12 @@ cdef Eina_Bool _ecore_timeline_cb(void *data, double pos) with gil:
85 97
86 return ret 98 return ret
87 99
100
88cdef class AnimatorTimeline(Animator): 101cdef class AnimatorTimeline(Animator):
89 """Add an animator that runs for a limited time 102 """
103
104 Create an animator that runs for a limited time
90 105
91 :param runtime: The time to run in seconds
92 :param func: The function to call when it ticks off
93 106
94 This is just like a normal :py:class:`Animator` except the animator only 107 This is just like a normal :py:class:`Animator` except the animator only
95 runs for a limited time specified in seconds by ``runtime``. Once the 108 runs for a limited time specified in seconds by ``runtime``. Once the
@@ -111,6 +124,23 @@ cdef class AnimatorTimeline(Animator):
111 """ 124 """
112 125
113 def __init__(self, func, double runtime, *args, **kargs): 126 def __init__(self, func, double runtime, *args, **kargs):
127 """AnimatorTimeline(...)
128
129 :param func: The function to call when it ticks off
130 :type func: callable
131 :param runtime: The time to run in seconds
132 :type runtime: double
133 :param \*args: All the remaining arguments will be passed
134 back in the callback function.
135 :param \**kwargs: All the remaining keyword arguments will be passed
136 back in the callback function.
137
138 Expected **func** signature::
139
140 func(pos, *args, **kargs) -> bool
141
142 """
143
114 if not callable(func): 144 if not callable(func):
115 raise TypeError("Parameter 'func' must be callable") 145 raise TypeError("Parameter 'func' must be callable")
116 self.func = func 146 self.func = func
diff --git a/efl/ecore/efl.ecore_exe.pxi b/efl/ecore/efl.ecore_exe.pxi
index ef62ec2..c5979ad 100644
--- a/efl/ecore/efl.ecore_exe.pxi
+++ b/efl/ecore/efl.ecore_exe.pxi
@@ -166,7 +166,9 @@ cdef void _ecore_exe_pre_free_cb(void *data, const Ecore_Exe *exe) with gil:
166 166
167 167
168cdef class Exe(object): 168cdef class Exe(object):
169 """Spawns a child process with its stdin/out available for communication. 169 """
170
171 Spawns a child process with its stdin/out available for communication.
170 172
171 This function forks and runs the given command using ``/bin/sh``. 173 This function forks and runs the given command using ``/bin/sh``.
172 174
diff --git a/efl/ecore/efl.ecore_fd_handler.pxi b/efl/ecore/efl.ecore_fd_handler.pxi
index 3de448c..db4dfec 100644
--- a/efl/ecore/efl.ecore_fd_handler.pxi
+++ b/efl/ecore/efl.ecore_fd_handler.pxi
@@ -56,7 +56,9 @@ cdef Eina_Bool fd_handler_cb(void *data, Ecore_Fd_Handler *fdh) with gil:
56 56
57 57
58cdef class FdHandler(object): 58cdef class FdHandler(object):
59 """Adds a callback for activity on the given file descriptor. 59 """
60
61 Adds a callback for activity on the given file descriptor.
60 62
61 ``func`` will be called during the execution of ``main_loop_begin()`` 63 ``func`` will be called during the execution of ``main_loop_begin()``
62 when the file descriptor is available for reading, or writing, or both. 64 when the file descriptor is available for reading, or writing, or both.
@@ -74,16 +76,19 @@ cdef class FdHandler(object):
74 - thread wake-up and synchronization; 76 - thread wake-up and synchronization;
75 - non-blocking file description operations. 77 - non-blocking file description operations.
76 78
77 :param fd: file descriptor or object with fileno() method.
78 :param flags: bitwise OR of ECORE_FD_READ, ECORE_FD_WRITE...
79 :param func:
80 function to call when file descriptor state changes.
81 Expected signature::
82
83 func(fd_handler, *args, **kargs): bool
84
85 """ 79 """
86 def __init__(self, fd, int flags, func, *args, **kargs): 80 def __init__(self, fd, int flags, func, *args, **kargs):
81 """FdHandler(...)
82
83 :param fd: file descriptor or object with fileno() method.
84 :param flags: bitwise OR of ECORE_FD_READ, ECORE_FD_WRITE...
85 :param func: function to call when file descriptor state changes.
86
87 Expected **func** signature::
88
89 func(fd_handler, *args, **kargs): bool
90
91 """
87 if not callable(func): 92 if not callable(func):
88 raise TypeError("Parameter 'func' must be callable") 93 raise TypeError("Parameter 'func' must be callable")
89 self.func = func 94 self.func = func
diff --git a/efl/ecore/efl.ecore_file_download.pxi b/efl/ecore/efl.ecore_file_download.pxi
index f82ef62..5c7e61c 100644
--- a/efl/ecore/efl.ecore_file_download.pxi
+++ b/efl/ecore/efl.ecore_file_download.pxi
@@ -34,7 +34,9 @@ cdef int _progress_cb(void *data, const char *file, long int dltotal,
34 34
35 35
36cdef class FileDownload(object): 36cdef class FileDownload(object):
37 """ Download the given url to destination. 37 """
38
39 Download the given url to destination.
38 40
39 You must provide the full url, including 'http://', 'ftp://' or 'file://'. 41 You must provide the full url, including 'http://', 'ftp://' or 'file://'.
40 If ``dst`` already exist it will not be overwritten and the function will fail. 42 If ``dst`` already exist it will not be overwritten and the function will fail.
@@ -69,13 +71,16 @@ cdef class FileDownload(object):
69 "/path/to/destination", None, None) 71 "/path/to/destination", None, None)
70 ecore.file_download_abort(dl) 72 ecore.file_download_abort(dl)
71 73
72 :param url: The complete url to download
73 :param dst: Where to download the file
74 :param completion_cb: A callback called on download complete
75 :param progress_cb: A callback called during the download operation
76
77 """ 74 """
78 def __init__(self, url, dst, completion_cb, progress_cb, *args, **kargs): 75 def __init__(self, url, dst, completion_cb, progress_cb, *args, **kargs):
76 """FileDownload(...)
77
78 :param url: The complete url to download
79 :param dst: Where to download the file
80 :param completion_cb: A callback called on download complete
81 :param progress_cb: A callback called during the download operation
82
83 """
79 cdef Ecore_File_Download_Job *job 84 cdef Ecore_File_Download_Job *job
80 85
81 if completion_cb is not None and not callable(completion_cb): 86 if completion_cb is not None and not callable(completion_cb):
diff --git a/efl/ecore/efl.ecore_file_monitor.pxi b/efl/ecore/efl.ecore_file_monitor.pxi
index 8b1c558..17fc0de 100644
--- a/efl/ecore/efl.ecore_file_monitor.pxi
+++ b/efl/ecore/efl.ecore_file_monitor.pxi
@@ -27,7 +27,9 @@ cdef void _file_monitor_cb(void *data, Ecore_File_Monitor *em, Ecore_File_Event
27 27
28 28
29cdef class FileMonitor(object): 29cdef class FileMonitor(object):
30 """ Monitor the given path for changes. 30 """
31
32 Monitor the given path for changes.
31 33
32 The callback signatures is:: 34 The callback signatures is::
33 35
@@ -54,16 +56,18 @@ cdef class FileMonitor(object):
54 ecore.FileMonitor("/tmp", monitor_cb) 56 ecore.FileMonitor("/tmp", monitor_cb)
55 ecore.main_loop_begin() 57 ecore.main_loop_begin()
56 58
57
58 :param path: The complete path of the folder you want to monitor.
59 :type path: str
60 :param monitor_cb: A callback called when something change in `path`
61 :type monitor_cb: callable
62
63 .. versionadded:: 1.8 59 .. versionadded:: 1.8
64 60
65 """ 61 """
66 def __init__(self, path, monitor_cb, *args, **kargs): 62 def __init__(self, path, monitor_cb, *args, **kargs):
63 """FileMonitor(...)
64
65 :param path: The complete path of the folder you want to monitor.
66 :type path: str
67 :param monitor_cb: A callback called when something change in `path`
68 :type monitor_cb: callable
69
70 """
67 71
68 if not callable(monitor_cb): 72 if not callable(monitor_cb):
69 raise TypeError("Parameter 'monitor_cb' must be callable") 73 raise TypeError("Parameter 'monitor_cb' must be callable")
diff --git a/efl/ecore/efl.ecore_idler.pxi b/efl/ecore/efl.ecore_idler.pxi
index 456c1b1..bb3bed6 100644
--- a/efl/ecore/efl.ecore_idler.pxi
+++ b/efl/ecore/efl.ecore_idler.pxi
@@ -17,15 +17,17 @@
17 17
18 18
19cdef class Idler(Eo): 19cdef class Idler(Eo):
20 """Add an idler handler. 20 """
21
22 Add an idler handler.
21 23
22 This class represents an idler on the event loop that will 24 This class represents an idler on the event loop that will
23 call ``func`` when there is nothing more to do. The function will 25 call ``func`` when there is nothing more to do. The function will
24 be passed any extra parameters given to constructor. 26 be passed any extra parameters given to constructor.
25 27
26 When the idler ``func`` is called, it must return a value of either 28 When the idler ``func`` is called, it must return a value of either
27 True or False (remember that Python returns None if no value is 29 **True** or **False** (remember that Python returns **None** if no value
28 explicitly returned and None evaluates to False). If it returns 30 is explicitly returned and **None** evaluates to False). If it returns
29 **True**, it will be called again when system become idle, or if it 31 **True**, it will be called again when system become idle, or if it
30 returns **False** it will be deleted automatically making any 32 returns **False** it will be deleted automatically making any
31 references/handles for it invalid. 33 references/handles for it invalid.
@@ -36,14 +38,22 @@ cdef class Idler(Eo):
36 38
37 Idlers are useful for progressively prossessing data without blocking. 39 Idlers are useful for progressively prossessing data without blocking.
38 40
39 :param func: 41 """
40 Function to call when system is idle. 42 def __init__(self, func, *args, **kargs):
41 Expected signature:: 43 """Idler(...)
44
45 :param func: Function to call when system is idle.
46 :type func: callable
47 :param \*args: All the remaining arguments will be passed
48 back in the callback function.
49 :param \**kwargs: All the remaining keyword arguments will be passed
50 back in the callback function.
51
52 Expected **func** signature::
42 53
43 func(*args, **kargs): bool 54 func(*args, **kargs): bool
44 55
45 """ 56 """
46 def __init__(self, func, *args, **kargs):
47 if not callable(func): 57 if not callable(func):
48 raise TypeError("Parameter 'func' must be callable") 58 raise TypeError("Parameter 'func' must be callable")
49 self.func = func 59 self.func = func
@@ -72,33 +82,45 @@ cdef class Idler(Eo):
72 82
73 83
74cdef class IdleEnterer(Idler): 84cdef class IdleEnterer(Idler):
75 """Add an idle enterer handler. 85 """
86
87 Add an idle enterer handler.
76 88
77 This class represents a function that will be called before systems 89 This class represents a function that will be called before systems
78 enter idle. The function will be passed any extra parameters given 90 enter idle. The function will be passed any extra parameters given
79 to constructor. 91 to constructor.
80 92
81 When the idle enterer ``func`` is called, it must return a value of 93 When the idle enterer ``func`` is called, it must return a value of
82 either *True* or *False* (remember that Python returns *None* if no value 94 either **True** or **False** (remember that Python returns **None** if
83 is explicitly returned and *None* evaluates to *False*). If it returns 95 no value is explicitly returned and **None** evaluates to **False**). If
84 *True*, it will be called again when system become idle, or if it 96 it returns **True**, it will be called again when system become idle, or
85 returns *False* it will be deleted automatically making any 97 if it returns **False** it will be deleted automatically making any
86 references/handles for it invalid. 98 references/handles for it invalid.
87 99
88 Idle enterers should be stopped/deleted by means of delete() or 100 Idle enterers should be stopped/deleted by means of delete() or
89 returning *False* from ``func``, otherwise they'll continue alive, even 101 returning **False** from ``func``, otherwise they'll continue alive, even
90 if the current python context delete it's reference to it. 102 if the current python context delete it's reference to it.
91 103
92 Idle enterer are useful for post-work jobs, like garbage collection. 104 Idle enterer are useful for post-work jobs, like garbage collection.
93 105
94 :param func:
95 Function to call when system enters idle.
96 Expected signature::
97 106
98 func(*args, **kargs): bool
99 107
100 """ 108 """
101 def __init__(self, func, *args, **kargs): 109 def __init__(self, func, *args, **kargs):
110 """IdleEnterer(...)
111
112 :param func: Function to call when system enters idle.
113 :type func: callable
114 :param \*args: All the remaining arguments will be passed
115 back in the callback function.
116 :param \**kwargs: All the remaining keyword arguments will be passed
117 back in the callback function.
118
119 Expected **func** signature::
120
121 func(*args, **kargs): bool
122
123 """
102 if not callable(func): 124 if not callable(func):
103 raise TypeError("Parameter 'func' must be callable") 125 raise TypeError("Parameter 'func' must be callable")
104 self.func = func 126 self.func = func
@@ -112,7 +134,9 @@ cdef class IdleEnterer(Idler):
112 134
113 135
114cdef class IdleExiter(Idler): 136cdef class IdleExiter(Idler):
115 """Add an idle exiter handler. 137 """
138
139 Add an idle exiter handler.
116 140
117 This class represents a function that will be called before systems 141 This class represents a function that will be called before systems
118 exits idle. The function will be passed any extra parameters given 142 exits idle. The function will be passed any extra parameters given
@@ -129,14 +153,21 @@ cdef class IdleExiter(Idler):
129 returning *False* from ``func``, otherwise they'll continue alive, even 153 returning *False* from ``func``, otherwise they'll continue alive, even
130 if the current python context delete it's reference to it. 154 if the current python context delete it's reference to it.
131 155
132 :param func: 156 """
133 Function to call when system exits idle. 157 def __init__(self, func, *args, **kargs):
134 Expected signature:: 158 """ IdleExiter(...)
159
160 :param func: Function to call when system exits idle.
161 :param \*args: All the remaining arguments will be passed
162 back in the callback function.
163 :param \**kwargs: All the remaining keyword arguments will be passed
164 back in the callback function.
165
166 Expected **func** signature::
135 167
136 func(*args, **kargs): bool 168 func(*args, **kargs): bool
137 169
138 """ 170 """
139 def __init__(self, func, *args, **kargs):
140 if not callable(func): 171 if not callable(func):
141 raise TypeError("Parameter 'func' must be callable") 172 raise TypeError("Parameter 'func' must be callable")
142 self.func = func 173 self.func = func
@@ -145,6 +176,7 @@ cdef class IdleExiter(Idler):
145 self._set_obj(ecore_idle_exiter_add(_ecore_task_cb, <void *>self)) 176 self._set_obj(ecore_idle_exiter_add(_ecore_task_cb, <void *>self))
146 177
147 def delete(self): 178 def delete(self):
179 """Stop callback emission and free internal resources."""
148 ecore_idle_exiter_del(self.obj) 180 ecore_idle_exiter_del(self.obj)
149 181
150 182
diff --git a/efl/ecore/efl.ecore_poller.pxi b/efl/ecore/efl.ecore_poller.pxi
index 9879cdd..33e25bf 100644
--- a/efl/ecore/efl.ecore_poller.pxi
+++ b/efl/ecore/efl.ecore_poller.pxi
@@ -56,17 +56,28 @@ cdef class Poller(Eo):
56 56
57 ecore.Poller(4, poller_cb) 57 ecore.Poller(4, poller_cb)
58 58
59 :param interval: The poll interval
60 :type interval: int
61 :param func: The function to call at every interval
62 :type func: callable
63 :param poll_type: The ticker type to attach the poller to. Must be ECORE_POLLER_CORE
64 :type poll_type: Ecore_Poll_Type
65
66 .. versionadded:: 1.8 59 .. versionadded:: 1.8
67 60
68 """ 61 """
69 def __init__(self, int interval, func, pol_type=0, *args, **kargs): 62 def __init__(self, int interval, func, pol_type=0, *args, **kargs):
63 """Poller(...)
64
65 :param interval: The poll interval
66 :type interval: int
67 :param func: The function to call at every interval
68 :type func: callable
69 :param pol_type: The ticker type to attach the poller to. Must be ECORE_POLLER_CORE
70 :type pol_type: Ecore_Poll_Type
71 :param \*args: All the remaining arguments will be passed
72 back in the callback function.
73 :param \**kwargs: All the remaining keyword arguments will be passed
74 back in the callback function.
75
76 Expected **func** signature::
77
78 func(*args, **kargs): bool
79
80 """
70 if not callable(func): 81 if not callable(func):
71 raise TypeError("Parameter 'func' must be callable") 82 raise TypeError("Parameter 'func' must be callable")
72 self.func = func 83 self.func = func
diff --git a/efl/ecore/efl.ecore_timer.pxi b/efl/ecore/efl.ecore_timer.pxi
index a42546a..4eb224e 100644
--- a/efl/ecore/efl.ecore_timer.pxi
+++ b/efl/ecore/efl.ecore_timer.pxi
@@ -26,26 +26,34 @@ cdef class Timer(Eo):
26 parameters given to constructor. 26 parameters given to constructor.
27 27
28 When the timer ``func`` is called, it must return a value of either 28 When the timer ``func`` is called, it must return a value of either
29 *True* or *False* (remember that Python returns *None* if no value is 29 **True** or **False** (remember that Python returns **None** if no value is
30 explicitly returned and *None* evaluates to *False*). If it returns 30 explicitly returned and **None** evaluates to **False**). If it returns
31 *True*, it will be called again at the next interval, or if it returns 31 **True**, it will be called again at the next interval, or if it returns
32 *False* it will be deleted automatically making any references/handles 32 **False** it will be deleted automatically making any references/handles
33 for it invalid. 33 for it invalid.
34 34
35 Timers should be stopped/deleted by means of ``delete()`` or 35 Timers should be stopped/deleted by means of ``delete()`` or
36 returning *False* from ``func``, otherwise they'll continue alive, even 36 returning *False* from ``func``, otherwise they'll continue alive, even
37 if the current python context delete it's reference to it. 37 if the current python context delete it's reference to it.
38 38
39 :param interval: interval in seconds. 39 """
40 :type interval: float 40 def __init__(self, double interval, func, *args, **kargs):
41 :param func: 41 """Timer(...)
42 function to callback when timer expires. 42
43 The function signature is:: 43 :param interval: interval in seconds.
44 :type interval: float
45 :param func: function to callback when timer expires.
46 :type func: callable
47 :param \*args: All the remaining arguments will be passed
48 back in the callback function.
49 :param \**kwargs: All the remaining keyword arguments will be passed
50 back in the callback function.
51
52 Expected **func** signature::
44 53
45 func(*args, **kargs): bool 54 func(*args, **kargs): bool
46 55
47 """ 56 """
48 def __init__(self, double interval, func, *args, **kargs):
49 if not callable(func): 57 if not callable(func):
50 raise TypeError("Parameter 'func' must be callable") 58 raise TypeError("Parameter 'func' must be callable")
51 self.func = func 59 self.func = func
diff --git a/efl/edje/efl.edje_object.pxi b/efl/edje/efl.edje_object.pxi
index b02414b..1f8fdb7 100644
--- a/efl/edje/efl.edje_object.pxi
+++ b/efl/edje/efl.edje_object.pxi
@@ -86,11 +86,13 @@ class EdjeLoadError(Exception):
86 86
87 87
88cdef class Edje(Object): 88cdef class Edje(Object):
89 """Edje evas object. 89 """
90
91 Edje evas object.
90 92
91 This is a high level `efl.evas.SmartObject` that is defined as a group of 93 This is a high level :class:`efl.evas.SmartObject` that is defined as a
92 parts (`efl.evas.Object`, usually written in text files (.edc) and 94 group of parts, usually written in text files (.edc) and compiled as a
93 compiled as a package using EET to store resources (.edj). 95 package using EET to store resources (.edj).
94 96
95 Edje is an important EFL component because it makes easy to split logic 97 Edje is an important EFL component because it makes easy to split logic
96 and UI, usually used as theme engine but can be much more powerful than 98 and UI, usually used as theme engine but can be much more powerful than
@@ -128,7 +130,24 @@ cdef class Edje(Object):
128 self._signal_callbacks = {} 130 self._signal_callbacks = {}
129 131
130 def __init__(self, Canvas canvas not None, file=None, group=None, size=None, 132 def __init__(self, Canvas canvas not None, file=None, group=None, size=None,
131 geometry=None, **kwargs): 133 geometry=None, **kwargs):
134 """Edje(...)
135
136 :param canvas: Evas canvas for this object
137 :type canvas: :py:class:`~efl.evas.Canvas`
138 :keyword file: File name
139 :type file: string
140 :keyword group: Group name
141 :type group: string
142 :keyword size: Min size for the object
143 :type size: tuple of ints
144 :keyword geometry: Geometry for the object
145 :type geometry: tuple of ints
146 :keyword \**kwargs: All the remaining keyword arguments are interpreted
147 as properties of the instance
148
149 """
150
132 151
133 self._set_obj(edje_object_add(canvas.obj)) 152 self._set_obj(edje_object_add(canvas.obj))
134 _register_decorated_callbacks(self) 153 _register_decorated_callbacks(self)
@@ -295,19 +314,19 @@ cdef class Edje(Object):
295 int r3, int g3, int b3, int a3): 314 int r3, int g3, int b3, int a3):
296 """Set color class. 315 """Set color class.
297 316
298 :parm color_class: color class name 317 :param color_class: color class name
299 :parm r: 318 :param r:
300 :parm g: 319 :param g:
301 :parm b: 320 :param b:
302 :parm a: 321 :param a:
303 :parm r2: 322 :param r2:
304 :parm g2: 323 :param g2:
305 :parm b2: 324 :param b2:
306 :parm a2: 325 :param a2:
307 :parm r3: 326 :param r3:
308 :parm g3: 327 :param g3:
309 :parm b3: 328 :param b3:
310 :parm a3: 329 :param a3:
311 330
312 """ 331 """
313 if isinstance(color_class, unicode): 332 if isinstance(color_class, unicode):
diff --git a/efl/elementary/access.pyx b/efl/elementary/access.pyx
index 323e3c5..6a663da 100644
--- a/efl/elementary/access.pyx
+++ b/efl/elementary/access.pyx
@@ -36,15 +36,18 @@ cdef void access_activate_cb(void *data, Evas_Object *part_obj, Elm_Object_Item
36 pass 36 pass
37 37
38cdef class Accessible(Object): 38cdef class Accessible(Object):
39 """
39 40
40 """An accessible object.""" 41 An accessible object.
41 42
42 def __init__(self, target, parent = None): 43 Register evas object as an accessible object.
43 """__init__(target, parent = None)
44 44
45 Register evas object as an accessible object. 45 :since: 1.8
46
47 """
46 48
47 :since: 1.8 49 def __init__(self, target, parent = None):
50 """Accessible(...)
48 51
49 :param target: The evas object to register as an accessible object. 52 :param target: The evas object to register as an accessible object.
50 :param parent: The elementary object which is used for creating 53 :param parent: The elementary object which is used for creating
diff --git a/efl/elementary/actionslider.pyx b/efl/elementary/actionslider.pyx
index 385253e..737478c 100644
--- a/efl/elementary/actionslider.pyx
+++ b/efl/elementary/actionslider.pyx
@@ -106,10 +106,21 @@ def _cb_string_conv(uintptr_t addr):
106 return _ctouni(s) if s is not NULL else None 106 return _ctouni(s) if s is not NULL else None
107 107
108cdef class Actionslider(LayoutClass): 108cdef class Actionslider(LayoutClass):
109 """
109 110
110 """This is the class that actually implements the widget.""" 111 This is the class that actually implements the widget.
112
113 """
111 114
112 def __init__(self, evasObject parent, *args, **kwargs): 115 def __init__(self, evasObject parent, *args, **kwargs):
116 """Actionslider(..)
117
118 :param parent: Parent object
119 :type parent: :py:class:`efl.evas.Object`
120 :param \**kwargs: All the remaining keyword arguments are interpreted
121 as properties of the instance
122
123 """
113 self._set_obj(elm_actionslider_add(parent.obj)) 124 self._set_obj(elm_actionslider_add(parent.obj))
114 self._set_properties_from_keyword_args(kwargs) 125 self._set_properties_from_keyword_args(kwargs)
115 126
diff --git a/efl/elementary/background.pyx b/efl/elementary/background.pyx
index 84054ee..2dcfce1 100644
--- a/efl/elementary/background.pyx
+++ b/efl/elementary/background.pyx
@@ -24,11 +24,10 @@ Widget description
24------------------ 24------------------
25 25
26The background widget is used for setting a solid color, image or Edje group 26The background widget is used for setting a solid color, image or Edje group
27as a background to a window or any container object. 27as a background to a window (unless it has transparency enabled) or any
28container object.
28 29
29The background widget is used for setting (solid) background decorations 30It works just like an image, but has some properties useful to a
30to a window (unless it has transparency enabled) or to any container
31object. It works just like an image, but has some properties useful to a
32background, like setting it to tiled, centered, scaled or stretched. 31background, like setting it to tiled, centered, scaled or stretched.
33 32
34 33
@@ -79,10 +78,21 @@ ELM_BG_OPTION_TILE = enums.ELM_BG_OPTION_TILE
79ELM_BG_OPTION_LAST = enums.ELM_BG_OPTION_LAST 78ELM_BG_OPTION_LAST = enums.ELM_BG_OPTION_LAST
80 79
81cdef class Background(LayoutClass): 80cdef class Background(LayoutClass):
81 """
82 82
83 """This is the class that actually implements the widget.""" 83 This is the class that actually implements the widget.
84
85 """
84 86
85 def __init__(self, evasObject parent, *args, **kwargs): 87 def __init__(self, evasObject parent, *args, **kwargs):
88 """Background(...)
89
90 :param parent: The parent object
91 :type parent: :py:class:`efl.evas.Object`
92 :param \**kwargs: All the remaining keyword arguments are interpreted
93 as properties of the instance
94
95 """
86 self._set_obj(elm_bg_add(parent.obj)) 96 self._set_obj(elm_bg_add(parent.obj))
87 self._set_properties_from_keyword_args(kwargs) 97 self._set_properties_from_keyword_args(kwargs)
88 98
diff --git a/efl/elementary/box.pyx b/efl/elementary/box.pyx
index ff809cb..92c2e92 100644
--- a/efl/elementary/box.pyx
+++ b/efl/elementary/box.pyx
@@ -174,16 +174,21 @@ cdef Evas_Object_Box_Layout _py_elm_box_layout_resolv(int layout) with gil:
174 return evas_object_box_layout_vertical 174 return evas_object_box_layout_vertical
175 175
176cdef class Box(Object): 176cdef class Box(Object):
177 """
177 178
178 """This is the class that actually implements the widget.""" 179 This is the class that actually implements the widget.
180
181 By default, the box will be in vertical mode and non-homogeneous.
182
183 """
179 184
180 def __init__(self, evasObject parent, *args, **kwargs): 185 def __init__(self, evasObject parent, *args, **kwargs):
181 """By default, the box will be in vertical mode and non-homogeneous. 186 """Box(...)
182 187
183 :param parent: The parent object 188 :param parent: The parent object
184 :type parent: :py:class:`~efl.elementary.object.Object` 189 :type parent: :py:class:`efl.evas.Object`
185 :return: The new object or None if it cannot be created 190 :param \**kwargs: All the remaining keyword arguments are interpreted
186 :rtype: :py:class:`Box` 191 as properties of the instance
187 192
188 """ 193 """
189 self._set_obj(elm_box_add(parent.obj)) 194 self._set_obj(elm_box_add(parent.obj))
diff --git a/efl/elementary/bubble.pyx b/efl/elementary/bubble.pyx
index 3fe7930..d0d3acd 100644
--- a/efl/elementary/bubble.pyx
+++ b/efl/elementary/bubble.pyx
@@ -101,10 +101,21 @@ ELM_BUBBLE_POS_BOTTOM_LEFT = enums.ELM_BUBBLE_POS_BOTTOM_LEFT
101ELM_BUBBLE_POS_BOTTOM_RIGHT = enums.ELM_BUBBLE_POS_BOTTOM_RIGHT 101ELM_BUBBLE_POS_BOTTOM_RIGHT = enums.ELM_BUBBLE_POS_BOTTOM_RIGHT
102 102
103cdef class Bubble(LayoutClass): 103cdef class Bubble(LayoutClass):
104 """
104 105
105 """This is the class that actually implements the widget.""" 106 This is the class that actually implements the widget.
107
108 """
106 109
107 def __init__(self, evasObject parent, *args, **kwargs): 110 def __init__(self, evasObject parent, *args, **kwargs):
111 """Bubble(...)
112
113 :param parent: The parent object
114 :type parent: :py:class:`efl.evas.Object`
115 :param \**kwargs: All the remaining keyword arguments are interpreted
116 as properties of the instance
117
118 """
108 self._set_obj(elm_bubble_add(parent.obj)) 119 self._set_obj(elm_bubble_add(parent.obj))
109 self._set_properties_from_keyword_args(kwargs) 120 self._set_properties_from_keyword_args(kwargs)
110 121
diff --git a/efl/elementary/button.pyx b/efl/elementary/button.pyx
index 16d3716..a0194df 100644
--- a/efl/elementary/button.pyx
+++ b/efl/elementary/button.pyx
@@ -68,10 +68,21 @@ from efl.evas cimport Object as evasObject
68from layout_class cimport LayoutClass 68from layout_class cimport LayoutClass
69 69
70cdef class Button(LayoutClass): 70cdef class Button(LayoutClass):
71 """
71 72
72 """This is the class that actually implements the widget.""" 73 This is the class that actually implements the widget.
74
75 """
73 76
74 def __init__(self, evasObject parent, *args, **kwargs): 77 def __init__(self, evasObject parent, *args, **kwargs):
78 """Button(...)
79
80 :param parent: The parent object
81 :type parent: :py:class:`efl.evas.Object`
82 :param \**kwargs: All the remaining keyword arguments are interpreted
83 as properties of the instance
84
85 """
75 self._set_obj(elm_button_add(parent.obj)) 86 self._set_obj(elm_button_add(parent.obj))
76 self._set_properties_from_keyword_args(kwargs) 87 self._set_properties_from_keyword_args(kwargs)
77 88
diff --git a/efl/elementary/calendar_elm.pyx b/efl/elementary/calendar_elm.pyx
index 1368615..efcc493 100644
--- a/efl/elementary/calendar_elm.pyx
+++ b/efl/elementary/calendar_elm.pyx
@@ -202,7 +202,6 @@ ELM_DAY_LAST = enums.ELM_DAY_LAST
202 202
203 203
204cdef class CalendarMark(object): 204cdef class CalendarMark(object):
205
206 """ 205 """
207 206
208 An item for the Calendar widget. 207 An item for the Calendar widget.
@@ -236,9 +235,11 @@ cdef class CalendarMark(object):
236 cdef Elm_Calendar_Mark *obj 235 cdef Elm_Calendar_Mark *obj
237 236
238 def __init__(self, evasObject cal, mark_type, mark_time, 237 def __init__(self, evasObject cal, mark_type, mark_time,
239 Elm_Calendar_Mark_Repeat_Type repeat): 238 Elm_Calendar_Mark_Repeat_Type repeat):
240 """Create a new Calendar mark 239 """CalendarMark(...)
241 240
241 :param parent: The parent object
242 :type parent: :py:class:`efl.evas.Object`
242 :param mark_type: A string used to define the type of mark. It will be 243 :param mark_type: A string used to define the type of mark. It will be
243 emitted to the theme, that should display a related modification on these 244 emitted to the theme, that should display a related modification on these
244 days representation. 245 days representation.
@@ -284,10 +285,21 @@ cdef class CalendarMark(object):
284 elm_calendar_mark_del(self.obj) 285 elm_calendar_mark_del(self.obj)
285 286
286cdef class Calendar(LayoutClass): 287cdef class Calendar(LayoutClass):
288 """
287 289
288 """This is the class that actually implements the widget.""" 290 This is the class that actually implements the widget.
291
292 """
289 293
290 def __init__(self, evasObject parent, *args, **kwargs): 294 def __init__(self, evasObject parent, *args, **kwargs):
295 """Calendar(..)
296
297 :param parent: The parent object
298 :type parent: :py:class:`efl.evas.Object`
299 :param \**kwargs: All the remaining keyword arguments are interpreted
300 as properties of the instance
301
302 """
291 self._set_obj(elm_calendar_add(parent.obj)) 303 self._set_obj(elm_calendar_add(parent.obj))
292 self._set_properties_from_keyword_args(kwargs) 304 self._set_properties_from_keyword_args(kwargs)
293 305
diff --git a/efl/elementary/check.pyx b/efl/elementary/check.pyx
index 8464ab1..b475319 100644
--- a/efl/elementary/check.pyx
+++ b/efl/elementary/check.pyx
@@ -55,10 +55,21 @@ from efl.evas cimport Object as evasObject
55from layout_class cimport LayoutClass 55from layout_class cimport LayoutClass
56 56
57cdef class Check(LayoutClass): 57cdef class Check(LayoutClass):
58 """
58 59
59 """This is the class that actually implements the widget.""" 60 This is the class that actually implements the widget.
61
62 """
60 63
61 def __init__(self, evasObject parent, *args, **kwargs): 64 def __init__(self, evasObject parent, *args, **kwargs):
65 """Check(...)
66
67 :param parent: The parent object
68 :type parent: :py:class:`efl.evas.Object`
69 :param \**kwargs: All the remaining keyword arguments are interpreted
70 as properties of the instance
71
72 """
62 self._set_obj(elm_check_add(parent.obj)) 73 self._set_obj(elm_check_add(parent.obj))
63 self._set_properties_from_keyword_args(kwargs) 74 self._set_properties_from_keyword_args(kwargs)
64 75
diff --git a/efl/elementary/clock.pyx b/efl/elementary/clock.pyx
index d2b0260..16506bf 100644
--- a/efl/elementary/clock.pyx
+++ b/efl/elementary/clock.pyx
@@ -115,10 +115,21 @@ ELM_CLOCK_EDIT_SEC_UNIT = enums.ELM_CLOCK_EDIT_SEC_UNIT
115ELM_CLOCK_EDIT_ALL = enums.ELM_CLOCK_EDIT_ALL 115ELM_CLOCK_EDIT_ALL = enums.ELM_CLOCK_EDIT_ALL
116 116
117cdef class Clock(LayoutClass): 117cdef class Clock(LayoutClass):
118 """
118 119
119 """This is the class that actually implements the widget.""" 120 This is the class that actually implements the widget.
121
122 """
120 123
121 def __init__(self, evasObject parent, *args, **kwargs): 124 def __init__(self, evasObject parent, *args, **kwargs):
125 """Clock(...)
126
127 :param parent: The parent object
128 :type parent: :py:class:`efl.evas.Object`
129 :param \**kwargs: All the remaining keyword arguments are interpreted
130 as properties of the instance
131
132 """
122 self._set_obj(elm_clock_add(parent.obj)) 133 self._set_obj(elm_clock_add(parent.obj))
123 self._set_properties_from_keyword_args(kwargs) 134 self._set_properties_from_keyword_args(kwargs)
124 135
diff --git a/efl/elementary/colorselector.pyx b/efl/elementary/colorselector.pyx
index ba9118b..6522b4b 100644
--- a/efl/elementary/colorselector.pyx
+++ b/efl/elementary/colorselector.pyx
@@ -88,12 +88,29 @@ def _cb_object_item_conv(uintptr_t addr):
88 return _object_item_to_python(it) 88 return _object_item_to_python(it)
89 89
90cdef class ColorselectorPaletteItem(ObjectItem): 90cdef class ColorselectorPaletteItem(ObjectItem):
91 """
91 92
92 """An item for the :py:class:`Colorselector` widget.""" 93 An item for the :py:class:`Colorselector` widget.
94
95 """
93 96
94 cdef int r, g, b, a 97 cdef int r, g, b, a
95 98
96 def __init__(self, int r, int g, int b, int a, *args, **kwargs): 99 def __init__(self, int r, int g, int b, int a, *args, **kwargs):
100 """ColorselectorPaletteItem(...)
101
102 :param r: Red value of color
103 :type r: int
104 :param g: Green value of color
105 :type g: int
106 :param b: Blue value of color
107 :type b: int
108 :param a: Alpha value of color
109 :type a: int
110 :param \**kwargs: All the remaining keyword arguments are interpreted
111 as properties of the instance
112
113 """
97 self.r, self.g, self.b, self.a = r, g, b, a 114 self.r, self.g, self.b, self.a = r, g, b, a
98 self.args, self.kwargs = args, kwargs 115 self.args, self.kwargs = args, kwargs
99 116
@@ -152,10 +169,21 @@ cdef class ColorselectorPaletteItem(ObjectItem):
152 169
153 170
154cdef class Colorselector(LayoutClass): 171cdef class Colorselector(LayoutClass):
172 """
173
174 This is the class that actually implements the widget.
155 175
156 """This is the class that actually implements the widget.""" 176 """
157 177
158 def __init__(self, evasObject parent, *args, **kwargs): 178 def __init__(self, evasObject parent, *args, **kwargs):
179 """Colorselector(...)
180
181 :param parent: The parent object
182 :type parent: :py:class:`efl.evas.Object`
183 :param \**kwargs: All the remaining keyword arguments are interpreted
184 as properties of the instance
185
186 """
159 self._set_obj(elm_colorselector_add(parent.obj)) 187 self._set_obj(elm_colorselector_add(parent.obj))
160 self._set_properties_from_keyword_args(kwargs) 188 self._set_properties_from_keyword_args(kwargs)
161 189
diff --git a/efl/elementary/conformant.pyx b/efl/elementary/conformant.pyx
index 1e55e75..ab0af44 100644
--- a/efl/elementary/conformant.pyx
+++ b/efl/elementary/conformant.pyx
@@ -53,10 +53,21 @@ from efl.evas cimport Object as evasObject
53from layout_class cimport LayoutClass 53from layout_class cimport LayoutClass
54 54
55cdef class Conformant(LayoutClass): 55cdef class Conformant(LayoutClass):
56 """
56 57
57 """This is the class that actually implements the widget.""" 58 This is the class that actually implements the widget.
59
60 """
58 61
59 def __init__(self, evasObject parent, *args, **kwargs): 62 def __init__(self, evasObject parent, *args, **kwargs):
63 """Conformant(...)
64
65 :param parent: The parent object
66 :type parent: :py:class:`efl.evas.Object`
67 :param \**kwargs: All the remaining keyword arguments are interpreted
68 as properties of the instance
69
70 """
60 self._set_obj(elm_conformant_add(parent.obj)) 71 self._set_obj(elm_conformant_add(parent.obj))
61 self._set_properties_from_keyword_args(kwargs) 72 self._set_properties_from_keyword_args(kwargs)
62 73
diff --git a/efl/elementary/ctxpopup.pyx b/efl/elementary/ctxpopup.pyx
index dec3584..02f75d4 100644
--- a/efl/elementary/ctxpopup.pyx
+++ b/efl/elementary/ctxpopup.pyx
@@ -106,8 +106,15 @@ ELM_CTXPOPUP_DIRECTION_UP = enums.ELM_CTXPOPUP_DIRECTION_UP
106ELM_CTXPOPUP_DIRECTION_UNKNOWN = enums.ELM_CTXPOPUP_DIRECTION_UNKNOWN 106ELM_CTXPOPUP_DIRECTION_UNKNOWN = enums.ELM_CTXPOPUP_DIRECTION_UNKNOWN
107 107
108cdef class CtxpopupItem(ObjectItem): 108cdef class CtxpopupItem(ObjectItem):
109 """
110
111 An item for Ctxpopup widget.
109 112
110 """An item for Ctxpopup widget.""" 113 .. warning:: Ctxpopup can't hold both an item list and a content at the
114 same time. When an item is added, any previous content will be
115 removed.
116
117 """
111 118
112 cdef: 119 cdef:
113 bytes label 120 bytes label
@@ -115,19 +122,17 @@ cdef class CtxpopupItem(ObjectItem):
115 122
116 def __init__(self, label = None, evasObject icon = None, 123 def __init__(self, label = None, evasObject icon = None,
117 callback = None, cb_data = None, *args, **kargs): 124 callback = None, cb_data = None, *args, **kargs):
118 """ 125 """CtxpopupItem(...)
119 .. warning:: Ctxpopup can't hold both an item list and a content at the
120 same time. When an item is added, any previous content will be
121 removed.
122 126
123 :param icon: Icon to be set on new item
124 :type icon: :py:class:`~efl.evas.Object`
125 :param label: The Label of the new item 127 :param label: The Label of the new item
126 :type label: string 128 :type label: string
127 :param func: Convenience function called when item selected 129 :param icon: Icon to be set on new item
128 :type func: function 130 :type icon: :py:class:`efl.evas.Object`
129 :return: The item added or ``None``, on errors 131 :param callback: Convenience function called when item selected
130 :rtype: :py:class:`CtxpopupItem` 132 :type callback: callable
133 :param cb_data: User data for the callback function
134 :param \**kwargs: All the remaining keyword arguments are interpreted
135 as properties of the instance
131 136
132 """ 137 """
133 if callback is not None: 138 if callback is not None:
@@ -145,10 +150,6 @@ cdef class CtxpopupItem(ObjectItem):
145 def append_to(self, evasObject ctxpopup): 150 def append_to(self, evasObject ctxpopup):
146 """Add a new item to a ctxpopup object. 151 """Add a new item to a ctxpopup object.
147 152
148 .. warning:: Ctxpopup can't hold both an item list and a content at the
149 same time. When an item is added, any previous content will be
150 removed.
151
152 .. seealso:: :py:attr:`~efl.elementary.object.Object.content` 153 .. seealso:: :py:attr:`~efl.elementary.object.Object.content`
153 154
154 :param ctxpopup: The Ctxpopup widget this item is to be appended on 155 :param ctxpopup: The Ctxpopup widget this item is to be appended on
@@ -178,10 +179,6 @@ cdef class CtxpopupItem(ObjectItem):
178 def prepend_to(self, evasObject ctxpopup): 179 def prepend_to(self, evasObject ctxpopup):
179 """Prepend a new item to a ctxpopup object. 180 """Prepend a new item to a ctxpopup object.
180 181
181 .. warning:: Ctxpopup can't hold both an item list and a content at the
182 same time. When an item is added, any previous content will be
183 removed.
184
185 .. seealso:: :py:attr:`~efl.elementary.object.Object.content` 182 .. seealso:: :py:attr:`~efl.elementary.object.Object.content`
186 183
187 :param ctxpopup: The Ctxpopup widget this item is to be prepended on 184 :param ctxpopup: The Ctxpopup widget this item is to be prepended on
@@ -234,14 +231,24 @@ cdef class CtxpopupItem(ObjectItem):
234 231
235cdef class Ctxpopup(LayoutClass): 232cdef class Ctxpopup(LayoutClass):
236 233
237 """This is the class that actually implements the widget. 234 """
235
236 This is the class that actually implements the widget.
238 237
239 .. versionchanged:: 1.8 238 .. versionchanged:: 1.8
240 Inherits from LayoutClass 239 Inherits from :py:class:`~efl.elementary.layout_class.LayoutClass`
241 240
242 """ 241 """
243 242
244 def __init__(self, evasObject parent, *args, **kwargs): 243 def __init__(self, evasObject parent, *args, **kwargs):
244 """Ctxpopup(...)
245
246 :param parent: The parent object
247 :type parent: :py:class:`efl.evas.Object`
248 :param \**kwargs: All the remaining keyword arguments are interpreted
249 as properties of the instance
250
251 """
245 self._set_obj(elm_ctxpopup_add(parent.obj)) 252 self._set_obj(elm_ctxpopup_add(parent.obj))
246 self._set_properties_from_keyword_args(kwargs) 253 self._set_properties_from_keyword_args(kwargs)
247 254
diff --git a/efl/elementary/datetime_elm.pyx b/efl/elementary/datetime_elm.pyx
index 6163026..0dee36d 100644
--- a/efl/elementary/datetime_elm.pyx
+++ b/efl/elementary/datetime_elm.pyx
@@ -36,80 +36,58 @@ format.
36 36
37Elm_datetime supports only the following sub set of libc date format specifiers: 37Elm_datetime supports only the following sub set of libc date format specifiers:
38 38
39**%%Y** 39**%%Y** The year as a decimal number including the century (example: 2011).
40 The year as a decimal number including the century (example: 2011).
41 40
42**%%y** 41**%%y** The year as a decimal number without a century (range 00 to 99)
43 The year as a decimal number without a century (range 00 to 99)
44 42
45**%%m** 43**%%m** The month as a decimal number (range 01 to 12).
46 The month as a decimal number (range 01 to 12).
47 44
48**%%b** 45**%%b** The abbreviated month name according to the current locale.
49 The abbreviated month name according to the current locale.
50 46
51**%%B** 47**%%B** The full month name according to the current locale.
52 The full month name according to the current locale.
53 48
54**%%h** 49**%%h** The abbreviated month name according to the current locale(same as %%b).
55 The abbreviated month name according to the current locale(same as %%b).
56 50
57**%%d** 51**%%d** The day of the month as a decimal number (range 01 to 31).
58 The day of the month as a decimal number (range 01 to 31).
59 52
60**%%e** 53**%%e** The day of the month as a decimal number (range 1 to 31). single
61 The day of the month as a decimal number (range 1 to 31). single 54 digits are preceded by a blank.
62 digits are preceded by a blank.
63 55
64**%%I** 56**%%I** The hour as a decimal number using a 12-hour clock (range 01 to 12).
65 The hour as a decimal number using a 12-hour clock (range 01 to 12).
66 57
67**%%H** 58**%%H** The hour as a decimal number using a 24-hour clock (range 00 to 23).
68 The hour as a decimal number using a 24-hour clock (range 00 to 23).
69 59
70**%%k** 60**%%k** The hour (24-hour clock) as a decimal number (range 0 to 23). single
71 The hour (24-hour clock) as a decimal number (range 0 to 23). single 61 digits are preceded by a blank.
72 digits are preceded by a blank.
73 62
74**%%l** 63**%%l** The hour (12-hour clock) as a decimal number (range 1 to 12); single
75 The hour (12-hour clock) as a decimal number (range 1 to 12); single 64 digits are preceded by a blank.
76 digits are preceded by a blank.
77 65
78**%%M** 66**%%M** The minute as a decimal number (range 00 to 59).
79 The minute as a decimal number (range 00 to 59).
80 67
81**%%p** 68**%%p** Either 'AM' or 'PM' according to the given time value, or the
82 Either 'AM' or 'PM' according to the given time value, or the 69 corresponding strings for the current locale. Noon is treated as 'PM'
83 corresponding strings for the current locale. Noon is treated as 'PM' 70 and midnight as 'AM'
84 and midnight as 'AM'
85 71
86**%%P** 72**%%P** Like %p but in lower case: 'am' or 'pm' or a corresponding string for
87 Like %p but in lower case: 'am' or 'pm' or a corresponding string for 73 the current locale.
88 the current locale.
89 74
90**%%c** 75**%%c** The preferred date and time representation for the current locale.
91 The preferred date and time representation for the current locale.
92 76
93**%%x** 77**%%x** The preferred date representation for the current locale without the time.
94 The preferred date representation for the current locale without the time.
95 78
96**%%X** 79**%%X** The preferred time representation for the current locale without the date.
97 The preferred time representation for the current locale without the date.
98 80
99**%%r** 81**%%r** The complete calendar time using the AM/PM format of the current locale.
100 The complete calendar time using the AM/PM format of the current locale.
101 82
102**%%R** 83**%%R** The hour and minute in decimal numbers using the format %H:%M.
103 The hour and minute in decimal numbers using the format %H:%M.
104 84
105**%%T** 85**%%T** The time of day in decimal numbers using the format %H:%M:%S.
106 The time of day in decimal numbers using the format %H:%M:%S.
107 86
108**%%D** 87**%%D** The date using the format %%m/%%d/%%y.
109 The date using the format %%m/%%d/%%y. 88
89**%%F** The date using the format %%Y-%%m-%%d.
110 90
111**%%F**
112 The date using the format %%Y-%%m-%%d.
113 91
114(For more reference on the available **LIBC date format specifiers**, 92(For more reference on the available **LIBC date format specifiers**,
115please visit the link: 93please visit the link:
@@ -194,7 +172,7 @@ The following functions are expected to be implemented in a Datetime module:
194 |__________| |__________| 172 |__________| |__________|
195 173
196Any module can use the following shared functions that are implemented in 174Any module can use the following shared functions that are implemented in
197elm_datetime.c : 175elm_datetime.c:
198 176
199**field_format_get()** - gives the field format. 177**field_format_get()** - gives the field format.
200 178
@@ -207,10 +185,8 @@ To enable a module, set the ELM_MODULES environment variable as shown:
207This widget emits the following signals, besides the ones sent from 185This widget emits the following signals, besides the ones sent from
208:py:class:`~efl.elementary.layout_class.LayoutClass`: 186:py:class:`~efl.elementary.layout_class.LayoutClass`:
209 187
210- ``changed`` - whenever Datetime field value is changed, this 188- ``changed`` - whenever Datetime field value is changed, this signal is sent.
211 signal is sent. 189- ``language,changed`` - whenever system locale changes, this signal is sent.
212- ``language,changed`` - whenever system locale changes, this
213 signal is sent.
214- ``focused`` - When the datetime has received focus. (since 1.8) 190- ``focused`` - When the datetime has received focus. (since 1.8)
215- ``unfocused`` - When the datetime has lost focus. (since 1.8) 191- ``unfocused`` - When the datetime has lost focus. (since 1.8)
216 192
@@ -269,10 +245,21 @@ ELM_DATETIME_MINUTE = enums.ELM_DATETIME_MINUTE
269ELM_DATETIME_AMPM = enums.ELM_DATETIME_AMPM 245ELM_DATETIME_AMPM = enums.ELM_DATETIME_AMPM
270 246
271cdef class Datetime(Object): 247cdef class Datetime(Object):
248 """
249
250 This is the class that actually implements the widget.
272 251
273 """This is the class that actually implements the widget.""" 252 """
274 253
275 def __init__(self, evasObject parent, *args, **kwargs): 254 def __init__(self, evasObject parent, *args, **kwargs):
255 """Datetime(...)
256
257 :param parent: The parent object
258 :type parent: :py:class:`efl.evas.Object`
259 :param \**kwargs: All the remaining keyword arguments are interpreted
260 as properties of the instance
261
262 """
276 self._set_obj(elm_datetime_add(parent.obj)) 263 self._set_obj(elm_datetime_add(parent.obj))
277 self._set_properties_from_keyword_args(kwargs) 264 self._set_properties_from_keyword_args(kwargs)
278 265
@@ -290,80 +277,57 @@ cdef class Datetime(Object):
290 277
291 Following are the allowed set of format specifiers for each datetime field. 278 Following are the allowed set of format specifiers for each datetime field.
292 279
293 **%%Y** 280 **%%Y** The year as a decimal number including the century.
294 The year as a decimal number including the century.
295 281
296 **%%y** 282 **%%y** The year as a decimal number without a century (range 00 to 99).
297 The year as a decimal number without a century (range 00 to 99).
298 283
299 **%%m** 284 **%%m** The month as a decimal number (range 01 to 12).
300 The month as a decimal number (range 01 to 12).
301 285
302 **%%b** 286 **%%b** The abbreviated month name according to the current locale.
303 The abbreviated month name according to the current locale.
304 287
305 **%%B** 288 **%%B** The full month name according to the current locale.
306 The full month name according to the current locale.
307 289
308 **%%h** 290 **%%h** The abbreviated month name according to the current locale(same as %%b).
309 The abbreviated month name according to the current locale(same as %%b).
310 291
311 **%%d** 292 **%%d** The day of the month as a decimal number (range 01 to 31).
312 The day of the month as a decimal number (range 01 to 31).
313 293
314 **%%e** 294 **%%e** The day of the month as a decimal number (range 1 to 31). single
315 The day of the month as a decimal number (range 1 to 31). single 295 digits are preceded by a blank.
316 digits are preceded by a blank.
317 296
318 **%%I** 297 **%%I** The hour as a decimal number using a 12-hour clock (range 01 to 12).
319 The hour as a decimal number using a 12-hour clock (range 01 to 12).
320 298
321 **%%H** 299 **%%H** The hour as a decimal number using a 24-hour clock (range 00 to 23).
322 The hour as a decimal number using a 24-hour clock (range 00 to 23).
323 300
324 **%%k** 301 **%%k** The hour (24-hour clock) as a decimal number (range 0 to 23). single
325 The hour (24-hour clock) as a decimal number (range 0 to 23). single 302 digits are preceded by a blank.
326 digits are preceded by a blank.
327 303
328 **%%l** 304 **%%l** The hour (12-hour clock) as a decimal number (range 1 to 12); single
329 The hour (12-hour clock) as a decimal number (range 1 to 12); single 305 digits are preceded by a blank.
330 digits are preceded by a blank.
331 306
332 **%%M** 307 **%%M** The minute as a decimal number (range 00 to 59).
333 The minute as a decimal number (range 00 to 59).
334 308
335 **%%p** 309 **%%p** Either 'AM' or 'PM' according to the given time value, or the
336 Either 'AM' or 'PM' according to the given time value, or the 310 corresponding strings for the current locale. Noon is treated as 'PM'
337 corresponding strings for the current locale. Noon is treated as 'PM' 311 and midnight as 'AM'.
338 and midnight as 'AM'.
339 312
340 **%%P** 313 **%%P** Like %p but in lower case: 'am' or 'pm' or a corresponding string for
341 Like %p but in lower case: 'am' or 'pm' or a corresponding string for 314 the current locale.
342 the current locale.
343 315
344 **%%c** 316 **%%c** The preferred date and time representation for the current locale.
345 The preferred date and time representation for the current locale.
346 317
347 **%%x** 318 **%%x** The preferred date representation for the current locale without the time.
348 The preferred date representation for the current locale without the time.
349 319
350 **%%X** 320 **%%X** The preferred time representation for the current locale without the date.
351 The preferred time representation for the current locale without the date.
352 321
353 **%%r** 322 **%%r** The complete calendar time using the AM/PM format of the current locale.
354 The complete calendar time using the AM/PM format of the current locale.
355 323
356 **%%R** 324 **%%R** The hour and minute in decimal numbers using the format %H:%M.
357 The hour and minute in decimal numbers using the format %H:%M.
358 325
359 **%%T** 326 **%%T** The time of day in decimal numbers using the format %H:%M:%S.
360 The time of day in decimal numbers using the format %H:%M:%S.
361 327
362 **%%D** 328 **%%D** The date using the format %%m/%%d/%%y.
363 The date using the format %%m/%%d/%%y.
364 329
365 **%%F** 330 **%%F** The date using the format %%Y-%%m-%%d.
366 The date using the format %%Y-%%m-%%d.
367 331
368 These specifiers can be arranged in any order and the widget will display the 332 These specifiers can be arranged in any order and the widget will display the
369 fields accordingly. 333 fields accordingly.
diff --git a/efl/elementary/dayselector.pyx b/efl/elementary/dayselector.pyx
index 18cfd77..40372a5 100644
--- a/efl/elementary/dayselector.pyx
+++ b/efl/elementary/dayselector.pyx
@@ -126,10 +126,21 @@ ELM_DAYSELECTOR_SAT = enums.ELM_DAYSELECTOR_SAT
126ELM_DAYSELECTOR_MAX = enums.ELM_DAYSELECTOR_MAX 126ELM_DAYSELECTOR_MAX = enums.ELM_DAYSELECTOR_MAX
127 127
128cdef class Dayselector(LayoutClass): 128cdef class Dayselector(LayoutClass):
129 """
129 130
130 """This is the class that actually implements the widget.""" 131 This is the class that actually implements the widget.
132
133 """
131 134
132 def __init__(self, evasObject parent, *args, **kwargs): 135 def __init__(self, evasObject parent, *args, **kwargs):
136 """Dayselector(...)
137
138 :param parent: The parent object
139 :type parent: :py:class:`efl.evas.Object`
140 :param \**kwargs: All the remaining keyword arguments are interpreted
141 as properties of the instance
142
143 """
133 self._set_obj(elm_dayselector_add(parent.obj)) 144 self._set_obj(elm_dayselector_add(parent.obj))
134 self._set_properties_from_keyword_args(kwargs) 145 self._set_properties_from_keyword_args(kwargs)
135 146
diff --git a/efl/elementary/diskselector.pyx b/efl/elementary/diskselector.pyx
index e55ec4a..dafd6b1 100644
--- a/efl/elementary/diskselector.pyx
+++ b/efl/elementary/diskselector.pyx
@@ -88,9 +88,11 @@ def _cb_object_item_conv(uintptr_t addr):
88 cdef Elm_Object_Item *it = <Elm_Object_Item *>addr 88 cdef Elm_Object_Item *it = <Elm_Object_Item *>addr
89 return _object_item_to_python(it) 89 return _object_item_to_python(it)
90 90
91
91cdef class DiskselectorItem(ObjectItem): 92cdef class DiskselectorItem(ObjectItem):
93 """
92 94
93 """An item for the Diskselector widget. 95 An item for the :py:class:`Diskselector` widget.
94 96
95 A new item will be created and appended to the diskselector, i.e., 97 A new item will be created and appended to the diskselector, i.e.,
96 will be set as last item. Also, if there is no selected item, it will 98 will be set as last item. Also, if there is no selected item, it will
@@ -126,7 +128,7 @@ cdef class DiskselectorItem(ObjectItem):
126 128
127 def __init__(self, label=None, evasObject icon=None, callback=None, 129 def __init__(self, label=None, evasObject icon=None, callback=None,
128 cb_data=None, *args, **kargs): 130 cb_data=None, *args, **kargs):
129 """ 131 """DiskselectorItem(...)
130 132
131 :param label: The label of the diskselector item. 133 :param label: The label of the diskselector item.
132 :type label: string 134 :type label: string
@@ -134,8 +136,11 @@ cdef class DiskselectorItem(ObjectItem):
134 icon can be any Evas object, but usually it is an 136 icon can be any Evas object, but usually it is an
135 :py:class:`~efl.elementary.icon.Icon`. 137 :py:class:`~efl.elementary.icon.Icon`.
136 :type icon: :py:class:`~efl.evas.Object` 138 :type icon: :py:class:`~efl.evas.Object`
137 :param func: The function to call when the item is selected. 139 :param callback: The function to call when the item is selected.
138 :type func: function 140 :type callback: callable
141 :param cb_data: User data for the callback function
142 :param \**kwargs: All the remaining keyword arguments are interpreted
143 as properties of the instance
139 144
140 """ 145 """
141 if callback is not None: 146 if callback is not None:
@@ -243,10 +248,21 @@ cdef class DiskselectorItem(ObjectItem):
243 return _object_item_to_python(it) 248 return _object_item_to_python(it)
244 249
245cdef class Diskselector(Object): 250cdef class Diskselector(Object):
251 """
246 252
247 """This is the class that actually implements the widget.""" 253 This is the class that actually implements the widget.
254
255 """
248 256
249 def __init__(self, evasObject parent, *args, **kwargs): 257 def __init__(self, evasObject parent, *args, **kwargs):
258 """Diskselector(...)
259
260 :param parent: The parent object
261 :type parent: :py:class:`efl.evas.Object`
262 :param \**kwargs: All the remaining keyword arguments are interpreted
263 as properties of the instance
264
265 """
250 self._set_obj(elm_diskselector_add(parent.obj)) 266 self._set_obj(elm_diskselector_add(parent.obj))
251 self._set_properties_from_keyword_args(kwargs) 267 self._set_properties_from_keyword_args(kwargs)
252 268
diff --git a/efl/elementary/entry.pyx b/efl/elementary/entry.pyx
index 385b1a3..5ea2a56 100644
--- a/efl/elementary/entry.pyx
+++ b/efl/elementary/entry.pyx
@@ -680,14 +680,12 @@ cdef void _entry_context_menu_callback(void *data, Evas_Object *obj, void *event
680 680
681@DEPRECATED("1.8", "Use markup_to_utf8() instead.") 681@DEPRECATED("1.8", "Use markup_to_utf8() instead.")
682def Entry_markup_to_utf8(string): 682def Entry_markup_to_utf8(string):
683 """Entry_markup_to_utf8(string)"""
684 if isinstance(string, unicode): string = PyUnicode_AsUTF8String(string) 683 if isinstance(string, unicode): string = PyUnicode_AsUTF8String(string)
685 return _touni(elm_entry_markup_to_utf8( 684 return _touni(elm_entry_markup_to_utf8(
686 <const char *>string if string is not None else NULL)) 685 <const char *>string if string is not None else NULL))
687 686
688@DEPRECATED("1.8", "Use utf8_to_markup() instead.") 687@DEPRECATED("1.8", "Use utf8_to_markup() instead.")
689def Entry_utf8_to_markup(string): 688def Entry_utf8_to_markup(string):
690 """Entry_utf8_to_markup(string)"""
691 if isinstance(string, unicode): string = PyUnicode_AsUTF8String(string) 689 if isinstance(string, unicode): string = PyUnicode_AsUTF8String(string)
692 return _touni(elm_entry_utf8_to_markup( 690 return _touni(elm_entry_utf8_to_markup(
693 <const char *>string if string is not None else NULL)) 691 <const char *>string if string is not None else NULL))
@@ -703,7 +701,7 @@ def utf8_to_markup(string):
703 <const char *>string if string is not None else NULL)) 701 <const char *>string if string is not None else NULL))
704 702
705cdef class EntryContextMenuItem(object): 703cdef class EntryContextMenuItem(object):
706 """ 704 """EntryContextMenuItem(...)
707 705
708 Type of contextual item that can be added in to long press menu. 706 Type of contextual item that can be added in to long press menu.
709 707
@@ -715,8 +713,6 @@ cdef class EntryContextMenuItem(object):
715 property label: 713 property label:
716 """Get the text of the contextual menu item. 714 """Get the text of the contextual menu item.
717 715
718 Gets the text of the contextual menu item of entry.
719
720 :type: unicode 716 :type: unicode
721 717
722 .. versionadded:: 1.8 718 .. versionadded:: 1.8
@@ -728,8 +724,6 @@ cdef class EntryContextMenuItem(object):
728 property icon: 724 property icon:
729 """Get the icon object of the contextual menu item. 725 """Get the icon object of the contextual menu item.
730 726
731 Gets the icon object packed in the contextual menu item of entry.
732
733 :type: (unicode **icon_file**, unicode **icon_group**, :ref:`Icon type <Elm_Icon_Type>` **icon_type**) 727 :type: (unicode **icon_file**, unicode **icon_group**, :ref:`Icon type <Elm_Icon_Type>` **icon_type**)
734 728
735 .. versionadded:: 1.8 729 .. versionadded:: 1.8
@@ -849,9 +843,10 @@ cdef void py_elm_entry_filter_cb(void *data, Evas_Object *entry, char **text) wi
849 text[0] = strdup(<char *>ret) 843 text[0] = strdup(<char *>ret)
850 844
851class EntryAnchorInfo(object): 845class EntryAnchorInfo(object):
852 """ 846 """EntryAnchorInfo(...)
853 847
854 The info sent in the callback for the "anchor,clicked" signals emitted by entries. 848 The info sent in the callback for the ``anchor,clicked`` signals emitted
849 by entries.
855 850
856 :var name: The name of the anchor, as stated in its href. 851 :var name: The name of the anchor, as stated in its href.
857 :var button: The mouse button used to click on it. 852 :var button: The mouse button used to click on it.
@@ -870,9 +865,10 @@ class EntryAnchorInfo(object):
870 self.h = 0 865 self.h = 0
871 866
872class EntryAnchorHoverInfo(object): 867class EntryAnchorHoverInfo(object):
873 """ 868 """EntryAnchorHoverInfo(...)
874 869
875 The info sent in the callback for "anchor,clicked" signals emitted by the Anchor_Hover widget. 870 The info sent in the callback for ``anchor,clicked`` signals emitted by
871 the entries.
876 872
877 :var anchor_info: The actual anchor info. 873 :var anchor_info: The actual anchor info.
878 :var hover: The hover object to use for the popup. 874 :var hover: The hover object to use for the popup.
@@ -917,11 +913,19 @@ def _entryanchorhover_conv(uintptr_t addr):
917 return eahi 913 return eahi
918 914
919cdef class Entry(LayoutClass): 915cdef class Entry(LayoutClass):
916 """
917
918 This is the class that actually implements the widget.
919
920 By default, entries are:
920 921
921 """This is the class that actually implements the widget. 922 - not scrolled
923 - multi-line
924 - word wrapped
925 - autosave is enabled
922 926
923 .. versionchanged:: 1.8 927 .. versionchanged:: 1.8
924 Inherits from LayoutClass. 928 Inherits from :py:class:`~efl.elementary.layout_class.LayoutClass`.
925 929
926 """ 930 """
927 931
@@ -931,25 +935,24 @@ cdef class Entry(LayoutClass):
931 self.markup_filters = [] 935 self.markup_filters = []
932 936
933 def __init__(self, evasObject parent, *args, **kwargs): 937 def __init__(self, evasObject parent, *args, **kwargs):
934 """By default, entries are: 938 """Entry(...)
935
936 - not scrolled
937 - multi-line
938 - word wrapped
939 - autosave is enabled
940 939
941 :param parent: The parent object 940 :param parent: The parent object
942 :type parent: :py:class:`~efl.elementary.object.Object` 941 :type parent: :py:class:`efl.evas.Object`
942 :param \**kwargs: All the remaining keyword arguments are interpreted
943 as properties of the instance
943 944
944 """ 945 """
945 self._set_obj(elm_entry_add(parent.obj)) 946 self._set_obj(elm_entry_add(parent.obj))
946 self._set_properties_from_keyword_args(kwargs) 947 self._set_properties_from_keyword_args(kwargs)
947 948
948 def text_style_user_push(self, style): 949 def text_style_user_push(self, style):
949 """Push the style to the top of user style stack. If there is styles in the 950 """Push the style to the top of user style stack.
950 user style stack, the properties in the top style of user style stack 951
951 will replace the properties in current theme. The input style is 952 If there is styles in the user style stack, the properties in the
952 specified in format ``tag='property=value'`` (i.e. ``DEFAULT='font=Sans 953 top style of user style stack will replace the properties in current
954 theme. The input style is specified in format
955 ``tag='property=value'`` (i.e. ``DEFAULT='font=Sans
953 font_size=60'hilight=' + font_weight=Bold'``). 956 font_size=60'hilight=' + font_weight=Bold'``).
954 957
955 :param string style: The style user to push 958 :param string style: The style user to push
diff --git a/efl/elementary/fileselector.pyx b/efl/elementary/fileselector.pyx
index c21d7e5..cf44cc0 100644
--- a/efl/elementary/fileselector.pyx
+++ b/efl/elementary/fileselector.pyx
@@ -177,10 +177,21 @@ cdef Eina_Bool py_elm_fileselector_custom_filter_cb(const char *path, Eina_Bool
177 177
178 178
179cdef class Fileselector(LayoutClass): 179cdef class Fileselector(LayoutClass):
180 """
180 181
181 """This is the class that actually implements the widget.""" 182 This is the class that actually implements the widget.
183
184 """
182 185
183 def __init__(self, evasObject parent, *args, **kwargs): 186 def __init__(self, evasObject parent, *args, **kwargs):
187 """Fileselector(...)
188
189 :param parent: The parent object
190 :type parent: :py:class:`efl.evas.Object`
191 :param \**kwargs: All the remaining keyword arguments are interpreted
192 as properties of the instance
193
194 """
184 self._set_obj(elm_fileselector_add(parent.obj)) 195 self._set_obj(elm_fileselector_add(parent.obj))
185 self._set_properties_from_keyword_args(kwargs) 196 self._set_properties_from_keyword_args(kwargs)
186 197
diff --git a/efl/elementary/fileselector_button.pyx b/efl/elementary/fileselector_button.pyx
index fe55917..a566b98 100644
--- a/efl/elementary/fileselector_button.pyx
+++ b/efl/elementary/fileselector_button.pyx
@@ -95,10 +95,21 @@ def _cb_string_conv(uintptr_t addr):
95 return _ctouni(s) if s is not NULL else None 95 return _ctouni(s) if s is not NULL else None
96 96
97cdef class FileselectorButton(Button): 97cdef class FileselectorButton(Button):
98 """
98 99
99 """This is the class that actually implements the widget.""" 100 This is the class that actually implements the widget.
101
102 """
100 103
101 def __init__(self, evasObject parent, *args, **kwargs): 104 def __init__(self, evasObject parent, *args, **kwargs):
105 """FileselectorButton(...)
106
107 :param parent: The parent object
108 :type parent: :py:class:`efl.evas.Object`
109 :param \**kwargs: All the remaining keyword arguments are interpreted
110 as properties of the instance
111
112 """
102 self._set_obj(elm_fileselector_button_add(parent.obj)) 113 self._set_obj(elm_fileselector_button_add(parent.obj))
103 self._set_properties_from_keyword_args(kwargs) 114 self._set_properties_from_keyword_args(kwargs)
104 115
diff --git a/efl/elementary/fileselector_entry.pyx b/efl/elementary/fileselector_entry.pyx
index 4faf6a5..e9678b3 100644
--- a/efl/elementary/fileselector_entry.pyx
+++ b/efl/elementary/fileselector_entry.pyx
@@ -111,8 +111,9 @@ def _cb_string_conv(uintptr_t addr):
111 return _ctouni(s) if s is not NULL else None 111 return _ctouni(s) if s is not NULL else None
112 112
113cdef class FileselectorEntry(LayoutClass): 113cdef class FileselectorEntry(LayoutClass):
114 """
114 115
115 """This is the class that actually implements the widget. 116 This is the class that actually implements the widget.
116 117
117 .. versionchanged:: 1.8 118 .. versionchanged:: 1.8
118 Inherits from LayoutClass. 119 Inherits from LayoutClass.
@@ -120,6 +121,14 @@ cdef class FileselectorEntry(LayoutClass):
120 """ 121 """
121 122
122 def __init__(self, evasObject parent, *args, **kwargs): 123 def __init__(self, evasObject parent, *args, **kwargs):
124 """FileselectorEntry(...)
125
126 :param parent: The parent object
127 :type parent: :py:class:`efl.evas.Object`
128 :param \**kwargs: All the remaining keyword arguments are interpreted
129 as properties of the instance
130
131 """
123 self._set_obj(elm_fileselector_entry_add(parent.obj)) 132 self._set_obj(elm_fileselector_entry_add(parent.obj))
124 self._set_properties_from_keyword_args(kwargs) 133 self._set_properties_from_keyword_args(kwargs)
125 134
diff --git a/efl/elementary/flip.pyx b/efl/elementary/flip.pyx
index 2839001..91ed6f4 100644
--- a/efl/elementary/flip.pyx
+++ b/efl/elementary/flip.pyx
@@ -203,7 +203,6 @@ ELM_FLIP_PAGE_UP = enums.ELM_FLIP_PAGE_UP
203ELM_FLIP_PAGE_DOWN = enums.ELM_FLIP_PAGE_DOWN 203ELM_FLIP_PAGE_DOWN = enums.ELM_FLIP_PAGE_DOWN
204 204
205cdef class Flip(Object): 205cdef class Flip(Object):
206
207 """ 206 """
208 207
209 This is the class that actually implement the widget. 208 This is the class that actually implement the widget.
@@ -211,6 +210,14 @@ cdef class Flip(Object):
211 """ 210 """
212 211
213 def __init__(self, evasObject parent, *args, **kwargs): 212 def __init__(self, evasObject parent, *args, **kwargs):
213 """Flip(...)
214
215 :param parent: The parent object
216 :type parent: :py:class:`efl.evas.Object`
217 :param \**kwargs: All the remaining keyword arguments are interpreted
218 as properties of the instance
219
220 """
214 self._set_obj(elm_flip_add(parent.obj)) 221 self._set_obj(elm_flip_add(parent.obj))
215 self._set_properties_from_keyword_args(kwargs) 222 self._set_properties_from_keyword_args(kwargs)
216 223
diff --git a/efl/elementary/flipselector.pyx b/efl/elementary/flipselector.pyx
index d2b782f..a87329b 100644
--- a/efl/elementary/flipselector.pyx
+++ b/efl/elementary/flipselector.pyx
@@ -70,11 +70,15 @@ def _cb_object_item_conv(uintptr_t addr):
70 return _object_item_to_python(it) 70 return _object_item_to_python(it)
71 71
72cdef class FlipSelectorItem(ObjectItem): 72cdef class FlipSelectorItem(ObjectItem):
73
74 """ 73 """
75 74
76 An item for the :py:class:`FlipSelector` widget. 75 An item for the :py:class:`FlipSelector` widget.
77 76
77 The widget's list of labels to show will be appended with the
78 given value. If the user wishes so, a callback function
79 can be passed, which will get called when this same item is
80 selected.
81
78 .. note:: The current selection *won't* be modified by appending an 82 .. note:: The current selection *won't* be modified by appending an
79 element to the list. 83 element to the list.
80 84
@@ -89,21 +93,16 @@ cdef class FlipSelectorItem(ObjectItem):
89 93
90 def __init__(self, label = None, callback = None, cb_data = None, 94 def __init__(self, label = None, callback = None, cb_data = None,
91 *args, **kwargs): 95 *args, **kwargs):
92 """ 96 """FlipSelectorItem(...)
93
94 The widget's list of labels to show will be appended with the
95 given value. If the user wishes so, a callback function
96 can be passed, which will get called when this same item is
97 selected.
98 97
99 :param label: The (text) label of the new item 98 :param label: The (text) label of the new item
100 :type label: string 99 :type label: string
101 :param func: Convenience callback function to take place when item 100 :param callback: Convenience callback function to take place when item
102 is selected 101 is selected
103 :type func: function 102 :type callback: callable
104 103 :param cb_data: User data for the callback function
105 :return: A handle to the item added or ``None``, on errors 104 :param \**kwargs: All the remaining keyword arguments are interpreted
106 :rtype: :py:class:`FlipSelectorItem` 105 as properties of the instance
107 106
108 """ 107 """
109 108
@@ -226,10 +225,21 @@ cdef class FlipSelectorItem(ObjectItem):
226 elm_flipselector_item_next_get(self.item)) 225 elm_flipselector_item_next_get(self.item))
227 226
228cdef class FlipSelector(Object): 227cdef class FlipSelector(Object):
228 """
229
230 This is the class that actually implements the widget.
229 231
230 """This is the class that actually implements the widget.""" 232 """
231 233
232 def __init__(self, evasObject parent, *args, **kwargs): 234 def __init__(self, evasObject parent, *args, **kwargs):
235 """FlipSelector(...)
236
237 :param parent: The parent object
238 :type parent: :py:class:`efl.evas.Object`
239 :param \**kwargs: All the remaining keyword arguments are interpreted
240 as properties of the instance
241
242 """
233 self._set_obj(elm_flipselector_add(parent.obj)) 243 self._set_obj(elm_flipselector_add(parent.obj))
234 self._set_properties_from_keyword_args(kwargs) 244 self._set_properties_from_keyword_args(kwargs)
235 245
diff --git a/efl/elementary/frame.pyx b/efl/elementary/frame.pyx
index 149a988..7e5c6f7 100644
--- a/efl/elementary/frame.pyx
+++ b/efl/elementary/frame.pyx
@@ -58,10 +58,21 @@ from efl.evas cimport Object as evasObject
58from layout_class cimport LayoutClass 58from layout_class cimport LayoutClass
59 59
60cdef class Frame(LayoutClass): 60cdef class Frame(LayoutClass):
61 """
61 62
62 """This is the class that actually implements the widget.""" 63 This is the class that actually implements the widget.
64
65 """
63 66
64 def __init__(self, evasObject parent, *args, **kwargs): 67 def __init__(self, evasObject parent, *args, **kwargs):
68 """Frame(...)
69
70 :param parent: The parent object
71 :type parent: :py:class:`efl.evas.Object`
72 :param \**kwargs: All the remaining keyword arguments are interpreted
73 as properties of the instance
74
75 """
65 self._set_obj(elm_frame_add(parent.obj)) 76 self._set_obj(elm_frame_add(parent.obj))
66 self._set_properties_from_keyword_args(kwargs) 77 self._set_properties_from_keyword_args(kwargs)
67 78
diff --git a/efl/elementary/gengrid_item.pxi b/efl/elementary/gengrid_item.pxi
index a535bf5..df5db48 100644
--- a/efl/elementary/gengrid_item.pxi
+++ b/efl/elementary/gengrid_item.pxi
@@ -1,6 +1,9 @@
1cdef class GengridItem(ObjectItem): 1cdef class GengridItem(ObjectItem):
2 """
2 3
3 """An item for the :py:class:`Gengrid` widget.""" 4 An item for the :py:class:`Gengrid` widget.
5
6 """
4 7
5 cdef: 8 cdef:
6 readonly GengridItemClass item_class 9 readonly GengridItemClass item_class
diff --git a/efl/elementary/gengrid_widget.pxi b/efl/elementary/gengrid_widget.pxi
index d9cab8a..86f615a 100644
--- a/efl/elementary/gengrid_widget.pxi
+++ b/efl/elementary/gengrid_widget.pxi
@@ -1,10 +1,21 @@
1#include "cnp_callbacks.pxi" 1#include "cnp_callbacks.pxi"
2 2
3cdef class Gengrid(Object): 3cdef class Gengrid(Object):
4 """
4 5
5 """This is the class that actually implements the widget.""" 6 This is the class that actually implements the widget.
7
8 """
6 9
7 def __init__(self, evasObject parent, *args, **kwargs): 10 def __init__(self, evasObject parent, *args, **kwargs):
11 """Gengrid(...)
12
13 :param parent: The parent object
14 :type parent: :py:class:`efl.evas.Object`
15 :param \**kwargs: All the remaining keyword arguments are interpreted
16 as properties of the instance
17
18 """
8 self._set_obj(elm_gengrid_add(parent.obj)) 19 self._set_obj(elm_gengrid_add(parent.obj))
9 self._set_properties_from_keyword_args(kwargs) 20 self._set_properties_from_keyword_args(kwargs)
10 21
diff --git a/efl/elementary/genlist_item.pxi b/efl/elementary/genlist_item.pxi
index a5f84cc..32e0335 100644
--- a/efl/elementary/genlist_item.pxi
+++ b/efl/elementary/genlist_item.pxi
@@ -1,6 +1,9 @@
1cdef class GenlistItem(ObjectItem): 1cdef class GenlistItem(ObjectItem):
2 """
2 3
3 """An item for the :py:class:`Genlist` widget.""" 4 An item for the :py:class:`Genlist` widget.
5
6 """
4 7
5 cdef: 8 cdef:
6 readonly GenlistItemClass item_class 9 readonly GenlistItemClass item_class
@@ -8,12 +11,11 @@ cdef class GenlistItem(ObjectItem):
8 int flags 11 int flags
9 object comparison_func, item_data, func_data 12 object comparison_func, item_data, func_data
10 13
11 def __init__(self, 14 def __init__(self, GenlistItemClass item_class not None, item_data=None,
12 GenlistItemClass item_class not None, item_data=None, 15 GenlistItem parent_item=None,
13 GenlistItem parent_item=None, 16 Elm_Genlist_Item_Type flags=enums.ELM_GENLIST_ITEM_NONE,
14 Elm_Genlist_Item_Type flags=enums.ELM_GENLIST_ITEM_NONE, 17 func=None, func_data=None, *args, **kwargs):
15 func=None, func_data=None, *args, **kwargs): 18 """GenlistItem(...)
16 """Create a new GenlistItem.
17 19
18 :param item_data: Data that defines the model of this row. 20 :param item_data: Data that defines the model of this row.
19 This value will be given to methods of ``item_class`` such as 21 This value will be given to methods of ``item_class`` such as
diff --git a/efl/elementary/genlist_widget.pxi b/efl/elementary/genlist_widget.pxi
index dc6aa00..c23c95e 100644
--- a/efl/elementary/genlist_widget.pxi
+++ b/efl/elementary/genlist_widget.pxi
@@ -3,10 +3,21 @@ from efl.eo cimport _object_mapping_register, PY_REFCOUNT
3#include "cnp_callbacks.pxi" 3#include "cnp_callbacks.pxi"
4 4
5cdef class Genlist(Object): 5cdef class Genlist(Object):
6 """
6 7
7 """This is the class that actually implements the widget.""" 8 This is the class that actually implements the widget.
9
10 """
8 11
9 def __init__(self, evasObject parent not None, *args, **kwargs): 12 def __init__(self, evasObject parent not None, *args, **kwargs):
13 """Genlist(...)
14
15 :param parent: The parent object
16 :type parent: :py:class:`efl.evas.Object`
17 :param \**kwargs: All the remaining keyword arguments are interpreted
18 as properties of the instance
19
20 """
10 self._set_obj(elm_genlist_add(parent.obj)) 21 self._set_obj(elm_genlist_add(parent.obj))
11 self._set_properties_from_keyword_args(kwargs) 22 self._set_properties_from_keyword_args(kwargs)
12 23
diff --git a/efl/elementary/gesture_layer.pyx b/efl/elementary/gesture_layer.pyx
index 62653e9..ca2c010 100644
--- a/efl/elementary/gesture_layer.pyx
+++ b/efl/elementary/gesture_layer.pyx
@@ -189,8 +189,11 @@ ELM_GESTURE_LAST = enums.ELM_GESTURE_LAST
189 189
190 190
191cdef class GestureTapsInfo(object): 191cdef class GestureTapsInfo(object):
192 """GestureTapsInfo(...)
192 193
193 """Holds taps info for user""" 194 Holds taps info for user
195
196 """
194 197
195 cdef Elm_Gesture_Taps_Info *info 198 cdef Elm_Gesture_Taps_Info *info
196 199
@@ -231,8 +234,7 @@ cdef class GestureTapsInfo(object):
231 return self.info.timestamp 234 return self.info.timestamp
232 235
233cdef class GestureMomentumInfo(object): 236cdef class GestureMomentumInfo(object):
234 237 """GestureMomentumInfo(...)
235 """
236 238
237 Holds momentum info for user 239 Holds momentum info for user
238 x1 and y1 are not necessarily in sync 240 x1 and y1 are not necessarily in sync
@@ -326,15 +328,18 @@ cdef class GestureMomentumInfo(object):
326 return self.info.n 328 return self.info.n
327 329
328cdef class GestureLineInfo(object): 330cdef class GestureLineInfo(object):
331 """GestureLineInfo(...)
329 332
330 """Holds line info for user""" 333 Holds line info for user
334
335 """
331 336
332 cdef Elm_Gesture_Line_Info *info 337 cdef Elm_Gesture_Line_Info *info
333 338
334 property momentum: 339 property momentum:
335 """Line momentum info 340 """Line momentum info
336 341
337 :type: GestureMomentumInfo 342 :type: :py:class:`GestureMomentumInfo`
338 343
339 """ 344 """
340 def __get__(self): 345 def __get__(self):
@@ -352,8 +357,11 @@ cdef class GestureLineInfo(object):
352 return self.info.angle 357 return self.info.angle
353 358
354cdef class GestureZoomInfo(object): 359cdef class GestureZoomInfo(object):
360 """GestureZoomInfo(...)
361
362 Holds zoom info for user
355 363
356 """Holds zoom info for user""" 364 """
357 365
358 cdef Elm_Gesture_Zoom_Info *info 366 cdef Elm_Gesture_Zoom_Info *info
359 367
@@ -403,8 +411,11 @@ cdef class GestureZoomInfo(object):
403 return self.info.momentum 411 return self.info.momentum
404 412
405cdef class GestureRotateInfo(object): 413cdef class GestureRotateInfo(object):
414 """GestureRotateInfo(...)
415
416 Holds rotation info for user
406 417
407 """Holds rotation info for user""" 418 """
408 419
409 cdef Elm_Gesture_Rotate_Info *info 420 cdef Elm_Gesture_Rotate_Info *info
410 421
@@ -513,24 +524,22 @@ cdef Evas_Event_Flags _gesture_layer_rotate_event_cb(void *data, void *event_inf
513 traceback.print_exc() 524 traceback.print_exc()
514 525
515cdef class GestureLayer(Object): 526cdef class GestureLayer(Object):
516
517 """ 527 """
518 528
519 This is the class that actually implement the widget. 529 This is the class that actually implement the widget.
520 530
531 .. note:: You have to call :py:func:`attach()` in order to 'activate'
532 gesture-layer.
533
521 """ 534 """
522 535
523 def __init__(self, evasObject parent, *args, **kwargs): 536 def __init__(self, evasObject parent, *args, **kwargs):
524 """Call this function to construct a new gesture-layer object. 537 """GestureLayer(...)
525
526 This does not activate the gesture layer. You have to call
527 :py:func:`attach()` in order to 'activate' gesture-layer.
528 538
529 :param parent: The gesture layer's parent widget. 539 :param parent: The gesture layer's parent widget.
530 :type parent: :py:class:`~efl.evas.Object` 540 :type parent: :py:class:`~efl.evas.Object`
531 541 :param \**kwargs: All the remaining keyword arguments are interpreted
532 :return: A new gesture layer object. 542 as properties of the instance
533 :rtype: :py:class:`GestureLayer`
534 543
535 """ 544 """
536 self._set_obj(elm_gesture_layer_add(parent.obj)) 545 self._set_obj(elm_gesture_layer_add(parent.obj))
diff --git a/efl/elementary/glview.pyx b/efl/elementary/glview.pyx
index 384442a..cab7190 100644
--- a/efl/elementary/glview.pyx
+++ b/efl/elementary/glview.pyx
@@ -165,12 +165,23 @@ cdef void py_elm_glview_render_func_cb(Evas_Object *obj):
165 traceback.print_exc() 165 traceback.print_exc()
166 166
167cdef class GLView(LayoutClass): 167cdef class GLView(LayoutClass):
168 """
168 169
169 """This is the class that actually implements the widget.""" 170 This is the class that actually implements the widget.
171
172 """
170 173
171 cdef object init_func_cb, del_func_cb, resize_func_cb, render_func_cb 174 cdef object init_func_cb, del_func_cb, resize_func_cb, render_func_cb
172 175
173 def __init__(self, evasObject parent, *args, **kwargs): 176 def __init__(self, evasObject parent, *args, **kwargs):
177 """GLView(...)
178
179 :param parent: The parent object
180 :type parent: :py:class:`efl.evas.Object`
181 :param \**kwargs: All the remaining keyword arguments are interpreted
182 as properties of the instance
183
184 """
174 self._set_obj(elm_glview_add(parent.obj)) 185 self._set_obj(elm_glview_add(parent.obj))
175 self._set_properties_from_keyword_args(kwargs) 186 self._set_properties_from_keyword_args(kwargs)
176 187
diff --git a/efl/elementary/grid.pyx b/efl/elementary/grid.pyx
index ea0d356..0950114 100644
--- a/efl/elementary/grid.pyx
+++ b/efl/elementary/grid.pyx
@@ -42,7 +42,6 @@ from object cimport Object
42from efl.utils.conversions cimport eina_list_objects_to_python_list 42from efl.utils.conversions cimport eina_list_objects_to_python_list
43 43
44cdef class Grid(Object): 44cdef class Grid(Object):
45
46 """ 45 """
47 46
48 This is the class that actually implement the widget. 47 This is the class that actually implement the widget.
@@ -50,6 +49,14 @@ cdef class Grid(Object):
50 """ 49 """
51 50
52 def __init__(self, evasObject parent, *args, **kwargs): 51 def __init__(self, evasObject parent, *args, **kwargs):
52 """Grid(...)
53
54 :param parent: The parent object
55 :type parent: :py:class:`efl.evas.Object`
56 :param \**kwargs: All the remaining keyword arguments are interpreted
57 as properties of the instance
58
59 """
53 self._set_obj(elm_grid_add(parent.obj)) 60 self._set_obj(elm_grid_add(parent.obj))
54 self._set_properties_from_keyword_args(kwargs) 61 self._set_properties_from_keyword_args(kwargs)
55 62
diff --git a/efl/elementary/hover.pyx b/efl/elementary/hover.pyx
index 32eb691..7579f79 100644
--- a/efl/elementary/hover.pyx
+++ b/efl/elementary/hover.pyx
@@ -124,7 +124,6 @@ ELM_HOVER_AXIS_VERTICAL = enums.ELM_HOVER_AXIS_VERTICAL
124ELM_HOVER_AXIS_BOTH = enums.ELM_HOVER_AXIS_BOTH 124ELM_HOVER_AXIS_BOTH = enums.ELM_HOVER_AXIS_BOTH
125 125
126cdef class Hover(LayoutClass): 126cdef class Hover(LayoutClass):
127
128 """ 127 """
129 128
130 This is the class that actually implement the widget. 129 This is the class that actually implement the widget.
@@ -132,6 +131,14 @@ cdef class Hover(LayoutClass):
132 """ 131 """
133 132
134 def __init__(self, evasObject parent, *args, **kwargs): 133 def __init__(self, evasObject parent, *args, **kwargs):
134 """Hover(...)
135
136 :param parent: The parent object
137 :type parent: :py:class:`efl.evas.Object`
138 :param \**kwargs: All the remaining keyword arguments are interpreted
139 as properties of the instance
140
141 """
135 self._set_obj(elm_hover_add(parent.obj)) 142 self._set_obj(elm_hover_add(parent.obj))
136 self._set_properties_from_keyword_args(kwargs) 143 self._set_properties_from_keyword_args(kwargs)
137 144
diff --git a/efl/elementary/hoversel.pyx b/efl/elementary/hoversel.pyx
index d91a341..c9e9dbb 100644
--- a/efl/elementary/hoversel.pyx
+++ b/efl/elementary/hoversel.pyx
@@ -96,11 +96,13 @@ def _cb_object_item_conv(uintptr_t addr):
96 return _object_item_to_python(it) 96 return _object_item_to_python(it)
97 97
98cdef class HoverselItem(ObjectItem): 98cdef class HoverselItem(ObjectItem):
99
100 """ 99 """
101 100
102 An item for the :py:class:`Hoversel` widget. 101 An item for the :py:class:`Hoversel` widget.
103 102
103 For more information on what ``icon_file`` and ``icon_type`` are,
104 see :py:class:`~efl.elementary.icon.Icon`.
105
104 """ 106 """
105 cdef: 107 cdef:
106 object label, icon_file, icon_group 108 object label, icon_file, icon_group
@@ -109,8 +111,7 @@ cdef class HoverselItem(ObjectItem):
109 def __init__(self, label = None, icon_file = None, 111 def __init__(self, label = None, icon_file = None,
110 icon_type = ELM_ICON_NONE, callback = None, cb_data = None, 112 icon_type = ELM_ICON_NONE, callback = None, cb_data = None,
111 *args, **kwargs): 113 *args, **kwargs):
112 """For more information on what ``icon_file`` and ``icon_type`` are, 114 """HoverselItem(...)
113 see :py:class:`~efl.elementary.icon.Icon`.
114 115
115 :param label: The text label to use for the item (None if not desired) 116 :param label: The text label to use for the item (None if not desired)
116 :type label: string 117 :type label: string
@@ -122,6 +123,9 @@ cdef class HoverselItem(ObjectItem):
122 :param callback: Convenience function to call when this item is 123 :param callback: Convenience function to call when this item is
123 selected 124 selected
124 :type callback: function 125 :type callback: function
126 :param cb_data: User data for the callback function
127 :param \**kwargs: All the remaining keyword arguments are interpreted
128 as properties of the instance
125 129
126 """ 130 """
127 if isinstance(label, unicode): label = PyUnicode_AsUTF8String(label) 131 if isinstance(label, unicode): label = PyUnicode_AsUTF8String(label)
@@ -237,10 +241,21 @@ cdef class HoverselItem(ObjectItem):
237 return (_ctouni(icon_file), _ctouni(icon_group), icon_type) 241 return (_ctouni(icon_file), _ctouni(icon_group), icon_type)
238 242
239cdef class Hoversel(Button): 243cdef class Hoversel(Button):
244 """
245
246 This is the class that actually implements the widget.
240 247
241 """This is the class that actually implements the widget.""" 248 """
242 249
243 def __init__(self, evasObject parent, *args, **kwargs): 250 def __init__(self, evasObject parent, *args, **kwargs):
251 """Hoversel(...)
252
253 :param parent: The parent object
254 :type parent: :py:class:`efl.evas.Object`
255 :param \**kwargs: All the remaining keyword arguments are interpreted
256 as properties of the instance
257
258 """
244 self._set_obj(elm_hoversel_add(parent.obj)) 259 self._set_obj(elm_hoversel_add(parent.obj))
245 self._set_properties_from_keyword_args(kwargs) 260 self._set_properties_from_keyword_args(kwargs)
246 261
diff --git a/efl/elementary/icon.pyx b/efl/elementary/icon.pyx
index 664570f..7360d1c 100644
--- a/efl/elementary/icon.pyx
+++ b/efl/elementary/icon.pyx
@@ -206,10 +206,21 @@ ELM_ICON_FILE = enums.ELM_ICON_FILE
206ELM_ICON_STANDARD = enums.ELM_ICON_STANDARD 206ELM_ICON_STANDARD = enums.ELM_ICON_STANDARD
207 207
208cdef class Icon(Image): 208cdef class Icon(Image):
209 """
209 210
210 """This is the class that actually implements the widget.""" 211 This is the class that actually implements the widget.
212
213 """
211 214
212 def __init__(self, evasObject parent, *args, **kwargs): 215 def __init__(self, evasObject parent, *args, **kwargs):
216 """Icon(...)
217
218 :param parent: The parent object
219 :type parent: :py:class:`efl.evas.Object`
220 :param \**kwargs: All the remaining keyword arguments are interpreted
221 as properties of the instance
222
223 """
213 self._set_obj(elm_icon_add(parent.obj)) 224 self._set_obj(elm_icon_add(parent.obj))
214 self._set_properties_from_keyword_args(kwargs) 225 self._set_properties_from_keyword_args(kwargs)
215 226
diff --git a/efl/elementary/image.pyx b/efl/elementary/image.pyx
index 1b57e1a..f0adc2e 100644
--- a/efl/elementary/image.pyx
+++ b/efl/elementary/image.pyx
@@ -117,10 +117,10 @@ def _cb_string_conv(uintptr_t addr):
117 return _ctouni(s) if s is not NULL else None 117 return _ctouni(s) if s is not NULL else None
118 118
119class ImageProgressInfo(object): 119class ImageProgressInfo(object):
120 """ 120 """ImageProgressInfo(...)
121 121
122 The info sent in the callback for the "download,progress" signals emitted 122 The info sent in the callback for the ``download,progress`` signals emitted
123 by Image while downloading remote urls. 123 by :class:`Image` while downloading remote urls.
124 124
125 :var now: The amount of data received so far. 125 :var now: The amount of data received so far.
126 :var total: The total amount of data to download. 126 :var total: The total amount of data to download.
@@ -140,10 +140,10 @@ def _image_download_progress_conv(uintptr_t addr):
140 return ipi 140 return ipi
141 141
142class ImageErrorInfo(object): 142class ImageErrorInfo(object):
143 """ 143 """ImageErrorInfo(...)
144 144
145 The info sent in the callback for the "download,error" signals emitted 145 The info sent in the callback for the ``download,error`` signals emitted
146 by Image when fail to download remote urls. 146 by :class:`Image` when fail to download remote urls.
147 147
148 :var status: The http error code (such as 401) 148 :var status: The http error code (such as 401)
149 :var open_error: TODO 149 :var open_error: TODO
@@ -165,10 +165,21 @@ def _image_download_error_conv(uintptr_t addr):
165 165
166 166
167cdef class Image(Object): 167cdef class Image(Object):
168 """
169
170 This is the class that actually implements the widget.
168 171
169 """This is the class that actually implements the widget.""" 172 """
170 173
171 def __init__(self, evasObject parent, *args, **kwargs): 174 def __init__(self, evasObject parent, *args, **kwargs):
175 """Image(...)
176
177 :param parent: The parent object
178 :type parent: :py:class:`efl.evas.Object`
179 :param \**kwargs: All the remaining keyword arguments are interpreted
180 as properties of the instance
181
182 """
172 self._set_obj(elm_image_add(parent.obj)) 183 self._set_obj(elm_image_add(parent.obj))
173 self._set_properties_from_keyword_args(kwargs) 184 self._set_properties_from_keyword_args(kwargs)
174 185
diff --git a/efl/elementary/index.pyx b/efl/elementary/index.pyx
index c563030..fc43d21 100644
--- a/efl/elementary/index.pyx
+++ b/efl/elementary/index.pyx
@@ -133,7 +133,6 @@ cdef int _index_data_compare_func(const void *data1, const void *data2) with gil
133 return 0 133 return 0
134 134
135cdef class IndexItem(ObjectItem): 135cdef class IndexItem(ObjectItem):
136
137 """ 136 """
138 137
139 An item on an :py:class:`Index` widget. 138 An item on an :py:class:`Index` widget.
@@ -148,15 +147,16 @@ cdef class IndexItem(ObjectItem):
148 :param letter: Letter under which the item should be indexed 147 :param letter: Letter under which the item should be indexed
149 :type letter: string 148 :type letter: string
150 :param callback: The function to call when the item is selected. 149 :param callback: The function to call when the item is selected.
151 :type callback: function 150 :type callback: callable
152 151 :param cb_data: User data for the callback function
152 :param \**kwargs: All the remaining keyword arguments are interpreted
153 as properties of the instance
153 """ 154 """
154 cdef: 155 cdef:
155 bytes letter 156 bytes letter
156 object compare_func, data_compare_func 157 object compare_func, data_compare_func
157 158
158 def __init__(self, letter, callback = None, cb_data = None, 159 def __init__(self, letter, callback = None, cb_data = None, *args, **kwargs):
159 *args, **kwargs):
160 if callback is not None: 160 if callback is not None:
161 if not callable(callback): 161 if not callable(callback):
162 raise TypeError("callback is not callable") 162 raise TypeError("callback is not callable")
@@ -348,10 +348,21 @@ cdef class IndexItem(ObjectItem):
348 348
349 349
350cdef class Index(LayoutClass): 350cdef class Index(LayoutClass):
351 """
352
353 This is the class that actually implements the widget.
351 354
352 """This is the class that actually implements the widget.""" 355 """
353 356
354 def __init__(self, evasObject parent, *args, **kwargs): 357 def __init__(self, evasObject parent, *args, **kwargs):
358 """Index(...)
359
360 :param parent: The parent object
361 :type parent: :py:class:`efl.evas.Object`
362 :param \**kwargs: All the remaining keyword arguments are interpreted
363 as properties of the instance
364
365 """
355 self._set_obj(elm_index_add(parent.obj)) 366 self._set_obj(elm_index_add(parent.obj))
356 self._set_properties_from_keyword_args(kwargs) 367 self._set_properties_from_keyword_args(kwargs)
357 368
diff --git a/efl/elementary/innerwindow.pyx b/efl/elementary/innerwindow.pyx
index d288043..6d80c28 100644
--- a/efl/elementary/innerwindow.pyx
+++ b/efl/elementary/innerwindow.pyx
@@ -51,10 +51,21 @@ from efl.evas cimport Object as evasObject
51from layout_class cimport LayoutClass 51from layout_class cimport LayoutClass
52 52
53cdef class InnerWindow(LayoutClass): 53cdef class InnerWindow(LayoutClass):
54 """
54 55
55 """This is the class that actually implements the widget.""" 56 This is the class that actually implements the widget.
57
58 """
56 59
57 def __init__(self, evasObject parent, *args, **kwargs): 60 def __init__(self, evasObject parent, *args, **kwargs):
61 """InnerWindow(...)
62
63 :param parent: The parent object
64 :type parent: :py:class:`efl.evas.Object`
65 :param \**kwargs: All the remaining keyword arguments are interpreted
66 as properties of the instance
67
68 """
58 self._set_obj(elm_win_inwin_add(parent.obj)) 69 self._set_obj(elm_win_inwin_add(parent.obj))
59 self._set_properties_from_keyword_args(kwargs) 70 self._set_properties_from_keyword_args(kwargs)
60 71
diff --git a/efl/elementary/label.pyx b/efl/elementary/label.pyx
index 1caadac..4d77a55 100644
--- a/efl/elementary/label.pyx
+++ b/efl/elementary/label.pyx
@@ -113,10 +113,21 @@ ELM_LABEL_SLIDE_MODE_ALWAYS = enums.ELM_LABEL_SLIDE_MODE_ALWAYS
113 113
114 114
115cdef class Label(LayoutClass): 115cdef class Label(LayoutClass):
116 """
116 117
117 """This is the class that actually implements the widget.""" 118 This is the class that actually implements the widget.
119
120 """
118 121
119 def __init__(self, evasObject parent, *args, **kwargs): 122 def __init__(self, evasObject parent, *args, **kwargs):
123 """Label(...)
124
125 :param parent: The parent object
126 :type parent: :py:class:`efl.evas.Object`
127 :param \**kwargs: All the remaining keyword arguments are interpreted
128 as properties of the instance
129
130 """
120 self._set_obj(elm_label_add(parent.obj)) 131 self._set_obj(elm_label_add(parent.obj))
121 self._set_properties_from_keyword_args(kwargs) 132 self._set_properties_from_keyword_args(kwargs)
122 133
diff --git a/efl/elementary/layout.pyx b/efl/elementary/layout.pyx
index d745c1f..dbdab28 100644
--- a/efl/elementary/layout.pyx
+++ b/efl/elementary/layout.pyx
@@ -142,10 +142,21 @@ from efl.evas cimport Object as evasObject
142from layout_class cimport LayoutClass 142from layout_class cimport LayoutClass
143 143
144cdef class Layout(LayoutClass): 144cdef class Layout(LayoutClass):
145 """
145 146
146 """This is the class that actually implements the widget.""" 147 This is the class that actually implements the widget.
148
149 """
147 150
148 def __init__(self, evasObject parent, *args, **kwargs): 151 def __init__(self, evasObject parent, *args, **kwargs):
152 """Layout(...)
153
154 :param parent: The parent object
155 :type parent: :py:class:`efl.evas.Object`
156 :param \**kwargs: All the remaining keyword arguments are interpreted
157 as properties of the instance
158
159 """
149 self._set_obj(elm_layout_add(parent.obj)) 160 self._set_obj(elm_layout_add(parent.obj))
150 self._set_properties_from_keyword_args(kwargs) 161 self._set_properties_from_keyword_args(kwargs)
151 162
diff --git a/efl/elementary/layout_class.pyx b/efl/elementary/layout_class.pyx
index adffa87..edbd313 100644
--- a/efl/elementary/layout_class.pyx
+++ b/efl/elementary/layout_class.pyx
@@ -36,7 +36,6 @@ cdef void layout_signal_callback(void *data, Evas_Object *obj,
36 traceback.print_exc() 36 traceback.print_exc()
37 37
38cdef class LayoutClass(Object): 38cdef class LayoutClass(Object):
39
40 """ 39 """
41 40
42 Elementary, besides having the :py:class:`~efl.elementary.layout.Layout` 41 Elementary, besides having the :py:class:`~efl.elementary.layout.Layout`
diff --git a/efl/elementary/list.pyx b/efl/elementary/list.pyx
index a084c3c..6057972 100644
--- a/efl/elementary/list.pyx
+++ b/efl/elementary/list.pyx
@@ -195,16 +195,20 @@ def _cb_object_item_conv(uintptr_t addr):
195 return _object_item_to_python(it) 195 return _object_item_to_python(it)
196 196
197cdef class ListItem(ObjectItem): 197cdef class ListItem(ObjectItem):
198 """
199
200 An item for the list widget.
201
202 """
198 203
199 """An item for the list widget."""
200 cdef: 204 cdef:
201 object label 205 object label
202 Evas_Object *icon_obj 206 Evas_Object *icon_obj
203 Evas_Object *end_obj 207 Evas_Object *end_obj
204 208
205 def __init__(self, label = None, evasObject icon = None, 209 def __init__(self, label=None, evasObject icon=None, evasObject end=None,
206 evasObject end = None, callback = None, cb_data = None, *args, **kargs): 210 callback=None, cb_data=None, *args, **kargs):
207 """Create a new ListItem 211 """ListItem(...)
208 212
209 :param string label: The label of the list item. 213 :param string label: The label of the list item.
210 :param icon: The icon object to use for the left side of the item. An 214 :param icon: The icon object to use for the left side of the item. An
@@ -215,7 +219,9 @@ cdef class ListItem(ObjectItem):
215 icon can be any Evas object. 219 icon can be any Evas object.
216 :type end: :py:class:`~efl.evas.Object` 220 :type end: :py:class:`~efl.evas.Object`
217 :param callable callback: The function to call when the item is clicked. 221 :param callable callback: The function to call when the item is clicked.
218 :param cb_data: An object associated with the callback. 222 :param cb_data: User data for the callback function
223 :param \**kwargs: All the remaining keyword arguments are interpreted
224 as properties of the instance
219 225
220 """ 226 """
221 if isinstance(label, unicode): label = PyUnicode_AsUTF8String(label) 227 if isinstance(label, unicode): label = PyUnicode_AsUTF8String(label)
@@ -579,7 +585,6 @@ cdef class ListItem(ObjectItem):
579 585
580 586
581cdef class List(Object): 587cdef class List(Object):
582
583 """ 588 """
584 589
585 This is the class that actually implement the widget. 590 This is the class that actually implement the widget.
@@ -587,6 +592,14 @@ cdef class List(Object):
587 """ 592 """
588 593
589 def __init__(self, evasObject parent, *args, **kwargs): 594 def __init__(self, evasObject parent, *args, **kwargs):
595 """List(...)
596
597 :param parent: The parent object
598 :type parent: :py:class:`efl.evas.Object`
599 :param \**kwargs: All the remaining keyword arguments are interpreted
600 as properties of the instance
601
602 """
590 self._set_obj(elm_list_add(parent.obj)) 603 self._set_obj(elm_list_add(parent.obj))
591 self._set_properties_from_keyword_args(kwargs) 604 self._set_properties_from_keyword_args(kwargs)
592 605
diff --git a/efl/elementary/map.pyx b/efl/elementary/map.pyx
index ceab8d2..33101be 100644
--- a/efl/elementary/map.pyx
+++ b/efl/elementary/map.pyx
@@ -949,6 +949,14 @@ cdef class Map(Object):
949 949
950 """ 950 """
951 def __init__(self, evasObject parent, *args, **kwargs): 951 def __init__(self, evasObject parent, *args, **kwargs):
952 """Map(...)
953
954 :param parent: The parent object
955 :type parent: :py:class:`efl.evas.Object`
956 :param \**kwargs: All the remaining keyword arguments are interpreted
957 as properties of the instance
958
959 """
952 self._set_obj(elm_map_add(parent.obj)) 960 self._set_obj(elm_map_add(parent.obj))
953 self._set_properties_from_keyword_args(kwargs) 961 self._set_properties_from_keyword_args(kwargs)
954 962
diff --git a/efl/elementary/mapbuf.pyx b/efl/elementary/mapbuf.pyx
index 1b64061..941c04f 100644
--- a/efl/elementary/mapbuf.pyx
+++ b/efl/elementary/mapbuf.pyx
@@ -41,10 +41,21 @@ from efl.evas cimport Object as evasObject
41from object cimport Object 41from object cimport Object
42 42
43cdef class Mapbuf(Object): 43cdef class Mapbuf(Object):
44 """
44 45
45 """This is the class that actually implements the widget.""" 46 This is the class that actually implements the widget.
47
48 """
46 49
47 def __init__(self, evasObject parent, *args, **kwargs): 50 def __init__(self, evasObject parent, *args, **kwargs):
51 """Mapbuf(...)
52
53 :param parent: The parent object
54 :type parent: :py:class:`efl.evas.Object`
55 :param \**kwargs: All the remaining keyword arguments are interpreted
56 as properties of the instance
57
58 """
48 self._set_obj(elm_mapbuf_add(parent.obj)) 59 self._set_obj(elm_mapbuf_add(parent.obj))
49 self._set_properties_from_keyword_args(kwargs) 60 self._set_properties_from_keyword_args(kwargs)
50 61
diff --git a/efl/elementary/menu.pyx b/efl/elementary/menu.pyx
index 9e176bc..a3dc528 100644
--- a/efl/elementary/menu.pyx
+++ b/efl/elementary/menu.pyx
@@ -53,8 +53,11 @@ from object_item cimport _object_item_callback, _object_item_list_to_python, \
53 _object_item_to_python, _object_item_callback2, ObjectItem 53 _object_item_to_python, _object_item_callback2, ObjectItem
54 54
55cdef class MenuItem(ObjectItem): 55cdef class MenuItem(ObjectItem):
56 """
56 57
57 """An item for the :py:class:`Menu` widget.""" 58 An item for the :class:`Menu` widget.
59
60 """
58 61
59 cdef: 62 cdef:
60 MenuItem parent 63 MenuItem parent
@@ -229,8 +232,11 @@ cdef class MenuItem(ObjectItem):
229 return _object_item_to_python(elm_menu_item_prev_get(self.item)) 232 return _object_item_to_python(elm_menu_item_prev_get(self.item))
230 233
231cdef class MenuSeparatorItem(ObjectItem): 234cdef class MenuSeparatorItem(ObjectItem):
235 """
236
237 A separator type menu item.
232 238
233 """A separator type menu item.""" 239 """
234 240
235 cdef MenuItem parent 241 cdef MenuItem parent
236 242
@@ -299,10 +305,21 @@ cdef class MenuSeparatorItem(ObjectItem):
299 return _object_item_to_python(elm_menu_item_prev_get(self.item)) 305 return _object_item_to_python(elm_menu_item_prev_get(self.item))
300 306
301cdef class Menu(Object): 307cdef class Menu(Object):
308 """
309
310 This is the class that actually implements the widget.
302 311
303 """This is the class that actually implements the widget.""" 312 """
304 313
305 def __init__(self, evasObject parent, *args, **kwargs): 314 def __init__(self, evasObject parent, *args, **kwargs):
315 """Menu(...)
316
317 :param parent: The parent object
318 :type parent: :py:class:`efl.evas.Object`
319 :param \**kwargs: All the remaining keyword arguments are interpreted
320 as properties of the instance
321
322 """
306 self._set_obj(elm_menu_add(parent.obj)) 323 self._set_obj(elm_menu_add(parent.obj))
307 self._set_properties_from_keyword_args(kwargs) 324 self._set_properties_from_keyword_args(kwargs)
308 325
diff --git a/efl/elementary/multibuttonentry.pyx b/efl/elementary/multibuttonentry.pyx
index 65c5f23..195de8b 100644
--- a/efl/elementary/multibuttonentry.pyx
+++ b/efl/elementary/multibuttonentry.pyx
@@ -114,8 +114,11 @@ cdef char * _multibuttonentry_format_cb(int count, void *data) with gil:
114 114
115 115
116cdef class MultiButtonEntryItem(ObjectItem): 116cdef class MultiButtonEntryItem(ObjectItem):
117 """
117 118
118 """An item for the MultiButtonEntry widget.""" 119 An item for the MultiButtonEntry widget.
120
121 """
119 122
120 cdef: 123 cdef:
121 bytes label 124 bytes label
@@ -254,10 +257,21 @@ cdef void _py_elm_mbe_item_added_cb(
254 it._set_obj(item) 257 it._set_obj(item)
255 258
256cdef class MultiButtonEntry(Object): 259cdef class MultiButtonEntry(Object):
260 """
261
262 This is the class that actually implements the widget.
257 263
258 """This is the class that actually implements the widget.""" 264 """
259 265
260 def __init__(self, evasObject parent, *args, **kwargs): 266 def __init__(self, evasObject parent, *args, **kwargs):
267 """MultiButtonEntry(...)
268
269 :param parent: The parent object
270 :type parent: :py:class:`efl.evas.Object`
271 :param \**kwargs: All the remaining keyword arguments are interpreted
272 as properties of the instance
273
274 """
261 self._set_obj(elm_multibuttonentry_add(parent.obj)) 275 self._set_obj(elm_multibuttonentry_add(parent.obj))
262 evas_object_smart_callback_add( 276 evas_object_smart_callback_add(
263 self.obj, "item,added", 277 self.obj, "item,added",
diff --git a/efl/elementary/naviframe.pyx b/efl/elementary/naviframe.pyx
index e66d3f0..ce7260b 100644
--- a/efl/elementary/naviframe.pyx
+++ b/efl/elementary/naviframe.pyx
@@ -106,8 +106,11 @@ from object_item cimport _object_item_to_python, _object_item_list_to_python, \
106from efl.utils.deprecated cimport DEPRECATED 106from efl.utils.deprecated cimport DEPRECATED
107 107
108cdef class NaviframeItem(ObjectItem): 108cdef class NaviframeItem(ObjectItem):
109 """
109 110
110 """An item for the Naviframe widget.""" 111 An item for the Naviframe widget.
112
113 """
111 114
112 cdef: 115 cdef:
113 object label, item_style 116 object label, item_style
@@ -389,10 +392,21 @@ cdef class NaviframeItem(ObjectItem):
389 392
390 393
391cdef class Naviframe(LayoutClass): 394cdef class Naviframe(LayoutClass):
395 """
396
397 This is the class that actually implements the widget.
392 398
393 """This is the class that actually implements the widget.""" 399 """
394 400
395 def __init__(self, evasObject parent, *args, **kwargs): 401 def __init__(self, evasObject parent, *args, **kwargs):
402 """Naviframe(...)
403
404 :param parent: The parent object
405 :type parent: :py:class:`efl.evas.Object`
406 :param \**kwargs: All the remaining keyword arguments are interpreted
407 as properties of the instance
408
409 """
396 self._set_obj(elm_naviframe_add(parent.obj)) 410 self._set_obj(elm_naviframe_add(parent.obj))
397 self._set_properties_from_keyword_args(kwargs) 411 self._set_properties_from_keyword_args(kwargs)
398 412
diff --git a/efl/elementary/notify.pyx b/efl/elementary/notify.pyx
index 0cebea0..ec4defc 100644
--- a/efl/elementary/notify.pyx
+++ b/efl/elementary/notify.pyx
@@ -75,7 +75,6 @@ ELM_NOTIFY_ORIENT_LAST = enums.ELM_NOTIFY_ORIENT_LAST
75ELM_NOTIFY_ALIGN_FILL = -1.0 75ELM_NOTIFY_ALIGN_FILL = -1.0
76 76
77cdef class Notify(Object): 77cdef class Notify(Object):
78
79 """ 78 """
80 79
81 This is the class that actually implement the widget. 80 This is the class that actually implement the widget.
@@ -83,6 +82,14 @@ cdef class Notify(Object):
83 """ 82 """
84 83
85 def __init__(self, evasObject parent, *args, **kwargs): 84 def __init__(self, evasObject parent, *args, **kwargs):
85 """Notify(...)
86
87 :param parent: The parent object
88 :type parent: :py:class:`efl.evas.Object`
89 :param \**kwargs: All the remaining keyword arguments are interpreted
90 as properties of the instance
91
92 """
86 self._set_obj(elm_notify_add(parent.obj)) 93 self._set_obj(elm_notify_add(parent.obj))
87 self._set_properties_from_keyword_args(kwargs) 94 self._set_properties_from_keyword_args(kwargs)
88 95
diff --git a/efl/elementary/object.pyx b/efl/elementary/object.pyx
index 28be57a..3c45ba4 100644
--- a/efl/elementary/object.pyx
+++ b/efl/elementary/object.pyx
@@ -410,7 +410,6 @@ cdef class Canvas(evasCanvas):
410 pass 410 pass
411 411
412cdef class Object(evasObject): 412cdef class Object(evasObject):
413
414 """ 413 """
415 414
416 An abstract class to manage object and callback handling. 415 An abstract class to manage object and callback handling.
diff --git a/efl/elementary/object_item.pyx b/efl/elementary/object_item.pyx
index 73a0c1a..924b220 100644
--- a/efl/elementary/object_item.pyx
+++ b/efl/elementary/object_item.pyx
@@ -98,7 +98,6 @@ cdef void _object_item_callback2(void *data, Evas_Object *obj, void *event_info)
98 traceback.print_exc() 98 traceback.print_exc()
99 99
100cdef class ObjectItem(object): 100cdef class ObjectItem(object):
101
102 """ 101 """
103 102
104 A generic item for the widgets. 103 A generic item for the widgets.
diff --git a/efl/elementary/panel.pyx b/efl/elementary/panel.pyx
index 0df85b3..388f5e2 100644
--- a/efl/elementary/panel.pyx
+++ b/efl/elementary/panel.pyx
@@ -83,8 +83,9 @@ ELM_PANEL_ORIENT_LEFT = enums.ELM_PANEL_ORIENT_LEFT
83ELM_PANEL_ORIENT_RIGHT = enums.ELM_PANEL_ORIENT_RIGHT 83ELM_PANEL_ORIENT_RIGHT = enums.ELM_PANEL_ORIENT_RIGHT
84 84
85cdef class Panel(LayoutClass): 85cdef class Panel(LayoutClass):
86 """
86 87
87 """This is the class that actually implements the widget. 88 This is the class that actually implements the widget.
88 89
89 .. versionchanged:: 1.8 90 .. versionchanged:: 1.8
90 Inherits from LayoutClass. 91 Inherits from LayoutClass.
@@ -92,6 +93,14 @@ cdef class Panel(LayoutClass):
92 """ 93 """
93 94
94 def __init__(self, evasObject parent, *args, **kwargs): 95 def __init__(self, evasObject parent, *args, **kwargs):
96 """Panel(...)
97
98 :param parent: The parent object
99 :type parent: :py:class:`efl.evas.Object`
100 :param \**kwargs: All the remaining keyword arguments are interpreted
101 as properties of the instance
102
103 """
95 self._set_obj(elm_panel_add(parent.obj)) 104 self._set_obj(elm_panel_add(parent.obj))
96 self._set_properties_from_keyword_args(kwargs) 105 self._set_properties_from_keyword_args(kwargs)
97 106
diff --git a/efl/elementary/panes.pyx b/efl/elementary/panes.pyx
index 630f2c1..13d7a8d 100644
--- a/efl/elementary/panes.pyx
+++ b/efl/elementary/panes.pyx
@@ -57,10 +57,21 @@ from efl.evas cimport Object as evasObject
57from layout_class cimport LayoutClass 57from layout_class cimport LayoutClass
58 58
59cdef class Panes(LayoutClass): 59cdef class Panes(LayoutClass):
60 """
60 61
61 """This is the class that actually implements the widget.""" 62 This is the class that actually implements the widget.
63
64 """
62 65
63 def __init__(self, evasObject parent, *args, **kwargs): 66 def __init__(self, evasObject parent, *args, **kwargs):
67 """Panes(...)
68
69 :param parent: The parent object
70 :type parent: :py:class:`efl.evas.Object`
71 :param \**kwargs: All the remaining keyword arguments are interpreted
72 as properties of the instance
73
74 """
64 self._set_obj(elm_panes_add(parent.obj)) 75 self._set_obj(elm_panes_add(parent.obj))
65 self._set_properties_from_keyword_args(kwargs) 76 self._set_properties_from_keyword_args(kwargs)
66 77
diff --git a/efl/elementary/photo.pyx b/efl/elementary/photo.pyx
index a054a1c..458a548 100644
--- a/efl/elementary/photo.pyx
+++ b/efl/elementary/photo.pyx
@@ -48,10 +48,21 @@ from efl.evas cimport Object as evasObject
48from object cimport Object 48from object cimport Object
49 49
50cdef class Photo(Object): 50cdef class Photo(Object):
51 """
51 52
52 """This is the class that actually implements the widget.""" 53 This is the class that actually implements the widget.
54
55 """
53 56
54 def __init__(self, evasObject parent, *args, **kwargs): 57 def __init__(self, evasObject parent, *args, **kwargs):
58 """Photo(...)
59
60 :param parent: The parent object
61 :type parent: :py:class:`efl.evas.Object`
62 :param \**kwargs: All the remaining keyword arguments are interpreted
63 as properties of the instance
64
65 """
55 self._set_obj(elm_photo_add(parent.obj)) 66 self._set_obj(elm_photo_add(parent.obj))
56 self._set_properties_from_keyword_args(kwargs) 67 self._set_properties_from_keyword_args(kwargs)
57 68
diff --git a/efl/elementary/photocam.pyx b/efl/elementary/photocam.pyx
index e978487..ae6233c 100644
--- a/efl/elementary/photocam.pyx
+++ b/efl/elementary/photocam.pyx
@@ -121,9 +121,9 @@ ELM_PHOTOCAM_ZOOM_MODE_LAST = enums.ELM_PHOTOCAM_ZOOM_MODE_LAST
121 121
122 122
123class PhotocamProgressInfo(object): 123class PhotocamProgressInfo(object):
124 """ 124 """PhotocamProgressInfo(...)
125 125
126 The info sent in the callback for the "download,progress" signals emitted 126 The info sent in the callback for the ``download,progress`` signals emitted
127 by Photocam while downloading remote urls. 127 by Photocam while downloading remote urls.
128 128
129 :var now: The amount of data received so far. 129 :var now: The amount of data received so far.
@@ -144,9 +144,9 @@ def _photocam_download_progress_conv(uintptr_t addr):
144 return ppi 144 return ppi
145 145
146class PhotocamErrorInfo(object): 146class PhotocamErrorInfo(object):
147 """ 147 """PhotocamErrorInfo(...)
148 148
149 The info sent in the callback for the "download,error" signals emitted 149 The info sent in the callback for the ``download,error`` signals emitted
150 by Photocam when fail to download remote urls. 150 by Photocam when fail to download remote urls.
151 151
152 :var status: The http error code (such as 401) 152 :var status: The http error code (such as 401)
@@ -168,10 +168,21 @@ def _photocam_download_error_conv(uintptr_t addr):
168 168
169 169
170cdef class Photocam(Object): 170cdef class Photocam(Object):
171 """
172
173 This is the class that actually implements the widget.
171 174
172 """This is the class that actually implements the widget.""" 175 """
173 176
174 def __init__(self, evasObject parent, *args, **kwargs): 177 def __init__(self, evasObject parent, *args, **kwargs):
178 """Photocam(...)
179
180 :param parent: The parent object
181 :type parent: :py:class:`efl.evas.Object`
182 :param \**kwargs: All the remaining keyword arguments are interpreted
183 as properties of the instance
184
185 """
175 self._set_obj(elm_photocam_add(parent.obj)) 186 self._set_obj(elm_photocam_add(parent.obj))
176 self._set_properties_from_keyword_args(kwargs) 187 self._set_properties_from_keyword_args(kwargs)
177 188
diff --git a/efl/elementary/plug.pyx b/efl/elementary/plug.pyx
index 8cb727c..d30f545 100644
--- a/efl/elementary/plug.pyx
+++ b/efl/elementary/plug.pyx
@@ -46,7 +46,6 @@ from efl.evas cimport Object as evasObject
46from object cimport Object 46from object cimport Object
47 47
48cdef class Plug(Object): 48cdef class Plug(Object):
49
50 """ 49 """
51 50
52 An object that allows one to show an image which other process created. 51 An object that allows one to show an image which other process created.
@@ -55,6 +54,14 @@ cdef class Plug(Object):
55 """ 54 """
56 55
57 def __init__(self, evasObject parent, *args, **kwargs): 56 def __init__(self, evasObject parent, *args, **kwargs):
57 """Plug(...)
58
59 :param parent: The parent object
60 :type parent: :py:class:`efl.evas.Object`
61 :param \**kwargs: All the remaining keyword arguments are interpreted
62 as properties of the instance
63
64 """
58 self._set_obj(elm_plug_add(parent.obj)) 65 self._set_obj(elm_plug_add(parent.obj))
59 self._set_properties_from_keyword_args(kwargs) 66 self._set_properties_from_keyword_args(kwargs)
60 67
diff --git a/efl/elementary/popup.pyx b/efl/elementary/popup.pyx
index b4cc2ca..71a0352 100644
--- a/efl/elementary/popup.pyx
+++ b/efl/elementary/popup.pyx
@@ -214,18 +214,17 @@ def _cb_object_item_conv(uintptr_t addr):
214 return _object_item_to_python(it) 214 return _object_item_to_python(it)
215 215
216cdef class PopupItem(ObjectItem): 216cdef class PopupItem(ObjectItem):
217
218 """ 217 """
219 218
220 An item for :py:class:`Popup`. 219 An item for the :py:class:`Popup` widget.
221 220
222 Default contents parts of the popup items that you can use for are: 221 Default contents parts of the popup items that you can use for are:
223 222
224 - "default" -Item's icon 223 - ``default`` - Item's icon
225 224
226 Default text parts of the popup items that you can use for are: 225 Default text parts of the popup items that you can use for are:
227 226
228 - "default" - Item's label 227 - ``default`` - Item's label
229 228
230 """ 229 """
231 cdef: 230 cdef:
@@ -276,8 +275,9 @@ cdef class PopupItem(ObjectItem):
276 self.args) 275 self.args)
277 276
278cdef class Popup(LayoutClass): 277cdef class Popup(LayoutClass):
278 """
279 279
280 """This is the class that actually implements the widget. 280 This is the class that actually implements the widget.
281 281
282 .. versionchanged:: 1.8 282 .. versionchanged:: 1.8
283 Inherits from LayoutClass. 283 Inherits from LayoutClass.
@@ -285,6 +285,14 @@ cdef class Popup(LayoutClass):
285 """ 285 """
286 286
287 def __init__(self, evasObject parent, *args, **kwargs): 287 def __init__(self, evasObject parent, *args, **kwargs):
288 """Popup(...)
289
290 :param parent: The parent object
291 :type parent: :py:class:`efl.evas.Object`
292 :param \**kwargs: All the remaining keyword arguments are interpreted
293 as properties of the instance
294
295 """
288 self._set_obj(elm_popup_add(parent.obj)) 296 self._set_obj(elm_popup_add(parent.obj))
289 self._set_properties_from_keyword_args(kwargs) 297 self._set_properties_from_keyword_args(kwargs)
290 298
diff --git a/efl/elementary/progressbar.pyx b/efl/elementary/progressbar.pyx
index 8882a5a..ad7c3a1 100644
--- a/efl/elementary/progressbar.pyx
+++ b/efl/elementary/progressbar.pyx
@@ -82,10 +82,21 @@ from efl.evas cimport Object as evasObject
82from layout_class cimport LayoutClass 82from layout_class cimport LayoutClass
83 83
84cdef class Progressbar(LayoutClass): 84cdef class Progressbar(LayoutClass):
85 """
85 86
86 """This is the class that actually implements the widget.""" 87 This is the class that actually implements the widget.
88
89 """
87 90
88 def __init__(self, evasObject parent, *args, **kwargs): 91 def __init__(self, evasObject parent, *args, **kwargs):
92 """Progressbar(...)
93
94 :param parent: The parent object
95 :type parent: :py:class:`efl.evas.Object`
96 :param \**kwargs: All the remaining keyword arguments are interpreted
97 as properties of the instance
98
99 """
89 self._set_obj(elm_progressbar_add(parent.obj)) 100 self._set_obj(elm_progressbar_add(parent.obj))
90 self._set_properties_from_keyword_args(kwargs) 101 self._set_properties_from_keyword_args(kwargs)
91 102
diff --git a/efl/elementary/radio.pyx b/efl/elementary/radio.pyx
index 39f7296..aa056c9 100644
--- a/efl/elementary/radio.pyx
+++ b/efl/elementary/radio.pyx
@@ -69,10 +69,21 @@ from efl.evas cimport Object as evasObject
69from layout_class cimport LayoutClass 69from layout_class cimport LayoutClass
70 70
71cdef class Radio(LayoutClass): 71cdef class Radio(LayoutClass):
72 """
72 73
73 """This is the class that actually implements the widget.""" 74 This is the class that actually implements the widget.
75
76 """
74 77
75 def __init__(self, evasObject parent, *args, **kwargs): 78 def __init__(self, evasObject parent, *args, **kwargs):
79 """Radio(...)
80
81 :param parent: The parent object
82 :type parent: :py:class:`efl.evas.Object`
83 :param \**kwargs: All the remaining keyword arguments are interpreted
84 as properties of the instance
85
86 """
76 self._set_obj(elm_radio_add(parent.obj)) 87 self._set_obj(elm_radio_add(parent.obj))
77 self._set_properties_from_keyword_args(kwargs) 88 self._set_properties_from_keyword_args(kwargs)
78 89
diff --git a/efl/elementary/scroller.pyx b/efl/elementary/scroller.pyx
index 6677606..66be273 100644
--- a/efl/elementary/scroller.pyx
+++ b/efl/elementary/scroller.pyx
@@ -164,7 +164,6 @@ ELM_SCROLLER_MOVEMENT_BLOCK_VERTICAL = enums.ELM_SCROLLER_MOVEMENT_BLOCK_VERTICA
164ELM_SCROLLER_MOVEMENT_BLOCK_HORIZONTAL = enums.ELM_SCROLLER_MOVEMENT_BLOCK_HORIZONTAL 164ELM_SCROLLER_MOVEMENT_BLOCK_HORIZONTAL = enums.ELM_SCROLLER_MOVEMENT_BLOCK_HORIZONTAL
165 165
166cdef class Scrollable(Object): 166cdef class Scrollable(Object):
167
168 """ 167 """
169 168
170 An Elementary scrollable interface will handle an internal **panning** 169 An Elementary scrollable interface will handle an internal **panning**
diff --git a/efl/elementary/segment_control.pyx b/efl/elementary/segment_control.pyx
index c46a4e6..0d398f8 100644
--- a/efl/elementary/segment_control.pyx
+++ b/efl/elementary/segment_control.pyx
@@ -68,8 +68,11 @@ def _cb_object_item_conv(uintptr_t addr):
68 return _object_item_to_python(it) 68 return _object_item_to_python(it)
69 69
70cdef class SegmentControlItem(ObjectItem): 70cdef class SegmentControlItem(ObjectItem):
71 """
71 72
72 """An item for :py:class:`SegmentControl`.""" 73 An item for :py:class:`SegmentControl`.
74
75 """
73 76
74 cdef: 77 cdef:
75 evasObject icon 78 evasObject icon
@@ -222,10 +225,21 @@ cdef class SegmentControlItem(ObjectItem):
222 elm_segment_control_item_selected_set(self.item, select) 225 elm_segment_control_item_selected_set(self.item, select)
223 226
224cdef class SegmentControl(LayoutClass): 227cdef class SegmentControl(LayoutClass):
228 """
229
230 This is the class that actually implements the widget.
225 231
226 """This is the class that actually implements the widget.""" 232 """
227 233
228 def __init__(self, evasObject parent, *args, **kwargs): 234 def __init__(self, evasObject parent, *args, **kwargs):
235 """SegmentControl(...)
236
237 :param parent: The parent object
238 :type parent: :py:class:`efl.evas.Object`
239 :param \**kwargs: All the remaining keyword arguments are interpreted
240 as properties of the instance
241
242 """
229 self._set_obj(elm_segment_control_add(parent.obj)) 243 self._set_obj(elm_segment_control_add(parent.obj))
230 self._set_properties_from_keyword_args(kwargs) 244 self._set_properties_from_keyword_args(kwargs)
231 245
diff --git a/efl/elementary/separator.pyx b/efl/elementary/separator.pyx
index 90bcbce..1de78b6 100644
--- a/efl/elementary/separator.pyx
+++ b/efl/elementary/separator.pyx
@@ -37,10 +37,21 @@ from efl.evas cimport Object as evasObject
37from layout_class cimport LayoutClass 37from layout_class cimport LayoutClass
38 38
39cdef class Separator(LayoutClass): 39cdef class Separator(LayoutClass):
40 """
40 41
41 """This is the class that actually implements the widget.""" 42 This is the class that actually implements the widget.
43
44 """
42 45
43 def __init__(self, evasObject parent, *args, **kwargs): 46 def __init__(self, evasObject parent, *args, **kwargs):
47 """Separator(...)
48
49 :param parent: The parent object
50 :type parent: :py:class:`efl.evas.Object`
51 :param \**kwargs: All the remaining keyword arguments are interpreted
52 as properties of the instance
53
54 """
44 self._set_obj(elm_separator_add(parent.obj)) 55 self._set_obj(elm_separator_add(parent.obj))
45 self._set_properties_from_keyword_args(kwargs) 56 self._set_properties_from_keyword_args(kwargs)
46 57
diff --git a/efl/elementary/slider.pyx b/efl/elementary/slider.pyx
index 25be424..25d0b4b 100644
--- a/efl/elementary/slider.pyx
+++ b/efl/elementary/slider.pyx
@@ -81,10 +81,21 @@ from efl.evas cimport Object as evasObject
81from layout_class cimport LayoutClass 81from layout_class cimport LayoutClass
82 82
83cdef class Slider(LayoutClass): 83cdef class Slider(LayoutClass):
84 """
84 85
85 """This is the class that actually implements the widget.""" 86 This is the class that actually implements the widget.
87
88 """
86 89
87 def __init__(self, evasObject parent, *args, **kwargs): 90 def __init__(self, evasObject parent, *args, **kwargs):
91 """Slider(...)
92
93 :param parent: The parent object
94 :type parent: :py:class:`efl.evas.Object`
95 :param \**kwargs: All the remaining keyword arguments are interpreted
96 as properties of the instance
97
98 """
88 self._set_obj(elm_slider_add(parent.obj)) 99 self._set_obj(elm_slider_add(parent.obj))
89 self._set_properties_from_keyword_args(kwargs) 100 self._set_properties_from_keyword_args(kwargs)
90 101
diff --git a/efl/elementary/slideshow.pyx b/efl/elementary/slideshow.pyx
index 06d1fc1..95179f6 100644
--- a/efl/elementary/slideshow.pyx
+++ b/efl/elementary/slideshow.pyx
@@ -231,8 +231,11 @@ cdef class SlideshowItemClass (object):
231 return None 231 return None
232 232
233cdef class SlideshowItem(ObjectItem): 233cdef class SlideshowItem(ObjectItem):
234 """
235
236 An item for the :class:`Slideshow` widget.
234 237
235 """An item for Slideshow.""" 238 """
236 239
237 cdef: 240 cdef:
238 SlideshowItemClass cls 241 SlideshowItemClass cls
@@ -373,10 +376,21 @@ cdef class SlideshowItem(ObjectItem):
373 elm_slideshow_item_show(self.item) 376 elm_slideshow_item_show(self.item)
374 377
375cdef class Slideshow(LayoutClass): 378cdef class Slideshow(LayoutClass):
379 """
376 380
377 """This is the class that actually implements the widget.""" 381 This is the class that actually implements the widget.
382
383 """
378 384
379 def __init__(self, evasObject parent, *args, **kwargs): 385 def __init__(self, evasObject parent, *args, **kwargs):
386 """Slideshow(...)
387
388 :param parent: The parent object
389 :type parent: :py:class:`efl.evas.Object`
390 :param \**kwargs: All the remaining keyword arguments are interpreted
391 as properties of the instance
392
393 """
380 self._set_obj(elm_slideshow_add(parent.obj)) 394 self._set_obj(elm_slideshow_add(parent.obj))
381 self._set_properties_from_keyword_args(kwargs) 395 self._set_properties_from_keyword_args(kwargs)
382 396
diff --git a/efl/elementary/spinner.pyx b/efl/elementary/spinner.pyx
index 6efad99..20b0e43 100644
--- a/efl/elementary/spinner.pyx
+++ b/efl/elementary/spinner.pyx
@@ -63,10 +63,21 @@ from efl.evas cimport Object as evasObject
63from layout_class cimport LayoutClass 63from layout_class cimport LayoutClass
64 64
65cdef class Spinner(LayoutClass): 65cdef class Spinner(LayoutClass):
66 """
66 67
67 """This is the class that actually implements the widget.""" 68 This is the class that actually implements the widget.
69
70 """
68 71
69 def __init__(self, evasObject parent, *args, **kwargs): 72 def __init__(self, evasObject parent, *args, **kwargs):
73 """Spinner(...)
74
75 :param parent: The parent object
76 :type parent: :py:class:`efl.evas.Object`
77 :param \**kwargs: All the remaining keyword arguments are interpreted
78 as properties of the instance
79
80 """
70 self._set_obj(elm_spinner_add(parent.obj)) 81 self._set_obj(elm_spinner_add(parent.obj))
71 self._set_properties_from_keyword_args(kwargs) 82 self._set_properties_from_keyword_args(kwargs)
72 83
diff --git a/efl/elementary/store.pyx b/efl/elementary/store.pyx
index 2807f37..b4612c1 100644
--- a/efl/elementary/store.pyx
+++ b/efl/elementary/store.pyx
@@ -270,8 +270,11 @@ cdef class StoreItemInfoFilesystem(object):
270 270
271 271
272cdef class Store(object): 272cdef class Store(object):
273 """
273 274
274 """The class that holds the implementation of the widget.""" 275 The class that holds the implementation of the widget.
276
277 """
275 278
276 cdef Elm_Store *st 279 cdef Elm_Store *st
277 280
diff --git a/efl/elementary/table.pyx b/efl/elementary/table.pyx
index a13616d..dc7ad35 100644
--- a/efl/elementary/table.pyx
+++ b/efl/elementary/table.pyx
@@ -46,7 +46,6 @@ from efl.evas cimport Object as evasObject
46from object cimport Object 46from object cimport Object
47 47
48cdef class Table(Object): 48cdef class Table(Object):
49
50 """ 49 """
51 50
52 This is the class that actually implement the widget. 51 This is the class that actually implement the widget.
@@ -54,6 +53,14 @@ cdef class Table(Object):
54 """ 53 """
55 54
56 def __init__(self, evasObject parent, *args, **kwargs): 55 def __init__(self, evasObject parent, *args, **kwargs):
56 """Table(...)
57
58 :param parent: The parent object
59 :type parent: :py:class:`efl.evas.Object`
60 :param \**kwargs: All the remaining keyword arguments are interpreted
61 as properties of the instance
62
63 """
57 self._set_obj(elm_table_add(parent.obj)) 64 self._set_obj(elm_table_add(parent.obj))
58 self._set_properties_from_keyword_args(kwargs) 65 self._set_properties_from_keyword_args(kwargs)
59 66
diff --git a/efl/elementary/theme.pyx b/efl/elementary/theme.pyx
index 6f3bb0a..1754333 100644
--- a/efl/elementary/theme.pyx
+++ b/efl/elementary/theme.pyx
@@ -93,7 +93,6 @@ from efl.utils.conversions cimport _ctouni, eina_list_strings_to_python_list
93from efl.eina cimport eina_list_free, eina_stringshare_del 93from efl.eina cimport eina_list_free, eina_stringshare_del
94 94
95cdef class Theme(object): 95cdef class Theme(object):
96
97 """ 96 """
98 97
99 This is the class that actually implements the widget. 98 This is the class that actually implements the widget.
diff --git a/efl/elementary/thumb.pyx b/efl/elementary/thumb.pyx
index 48d7f6a..8858683 100644
--- a/efl/elementary/thumb.pyx
+++ b/efl/elementary/thumb.pyx
@@ -210,10 +210,21 @@ ETHUMB_THUMB_ORIENT_ORIGINAL = enums.ETHUMB_THUMB_ORIENT_ORIGINAL
210 210
211 211
212cdef class Thumb(Object): 212cdef class Thumb(Object):
213 """
213 214
214 """This is the class that actually implements the widget.""" 215 This is the class that actually implements the widget.
216
217 """
215 218
216 def __init__(self, evasObject parent, *args, **kwargs): 219 def __init__(self, evasObject parent, *args, **kwargs):
220 """Thumb(...)
221
222 :param parent: The parent object
223 :type parent: :py:class:`efl.evas.Object`
224 :param \**kwargs: All the remaining keyword arguments are interpreted
225 as properties of the instance
226
227 """
217 self._set_obj(elm_thumb_add(parent.obj)) 228 self._set_obj(elm_thumb_add(parent.obj))
218 self._set_properties_from_keyword_args(kwargs) 229 self._set_properties_from_keyword_args(kwargs)
219 230
diff --git a/efl/elementary/toolbar.pyx b/efl/elementary/toolbar.pyx
index af3d725..26c8ef0 100644
--- a/efl/elementary/toolbar.pyx
+++ b/efl/elementary/toolbar.pyx
@@ -228,8 +228,11 @@ cdef void _toolbar_item_state_callback(void *data, Evas_Object *obj, void *event
228 item.item = NULL 228 item.item = NULL
229 229
230cdef class ToolbarItemState(object): 230cdef class ToolbarItemState(object):
231 """
232
233 A state for a :py:class:`ToolbarItem`.
231 234
232 """A state for a :py:class:`ToolbarItem`.""" 235 """
233 236
234 cdef Elm_Toolbar_Item_State *state 237 cdef Elm_Toolbar_Item_State *state
235 cdef object params 238 cdef object params
@@ -262,8 +265,11 @@ cdef class ToolbarItemState(object):
262 265
263 266
264cdef class ToolbarItem(ObjectItem): 267cdef class ToolbarItem(ObjectItem):
268 """
269
270 An item for the toolbar.
265 271
266 """An item for the toolbar.""" 272 """
267 273
268 cdef: 274 cdef:
269 object label 275 object label
@@ -764,7 +770,6 @@ cdef class ToolbarItem(ObjectItem):
764 770
765 771
766cdef class Toolbar(LayoutClass): 772cdef class Toolbar(LayoutClass):
767
768 """ 773 """
769 774
770 This is the class that actually implements the widget. 775 This is the class that actually implements the widget.
@@ -775,6 +780,14 @@ cdef class Toolbar(LayoutClass):
775 """ 780 """
776 781
777 def __init__(self, evasObject parent, *args, **kwargs): 782 def __init__(self, evasObject parent, *args, **kwargs):
783 """Toolbar(...)
784
785 :param parent: The parent object
786 :type parent: :py:class:`efl.evas.Object`
787 :param \**kwargs: All the remaining keyword arguments are interpreted
788 as properties of the instance
789
790 """
778 self._set_obj(elm_toolbar_add(parent.obj)) 791 self._set_obj(elm_toolbar_add(parent.obj))
779 self._set_properties_from_keyword_args(kwargs) 792 self._set_properties_from_keyword_args(kwargs)
780 793
diff --git a/efl/elementary/transit.pyx b/efl/elementary/transit.pyx
index 156880b..b9766a2 100644
--- a/efl/elementary/transit.pyx
+++ b/efl/elementary/transit.pyx
@@ -170,10 +170,10 @@ ELM_TRANSIT_TWEEN_MODE_ACCELERATE = enums.ELM_TRANSIT_TWEEN_MODE_ACCELERATE
170 170
171import traceback 171import traceback
172 172
173cdef class TransitCustomEffect: 173cdef class TransitCustomEffect(object):
174 """ 174 """TransitCustomEffect(...)
175 175
176 A prototype class for a Transit widgets custom effect. 176 A prototype class for a :class:`Transit` widgets custom effect.
177 177
178 Inherit this class and override methods to create your custom effect. 178 Inherit this class and override methods to create your custom effect.
179 179
@@ -242,11 +242,15 @@ cdef void elm_transit_del_cb(void *data, Elm_Transit *transit) with gil:
242 Py_DECREF(trans) 242 Py_DECREF(trans)
243 243
244cdef class Transit(object): 244cdef class Transit(object):
245
246 """ 245 """
247 246
248 This is the class that actually implement the widget.