Enlightenment CVS committal
Author : onefang
Project : e17
Module : libs/ecore
Dir : e17/libs/ecore/src/lib/ecore
Modified Files:
ecore_main.c
Log Message:
More documentation for fd_handler return values as per the mailing list
discussion.
===================================================================
RCS file: /cvsroot/enlightenment/e17/libs/ecore/src/lib/ecore/ecore_main.c,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -3 -r1.20 -r1.21
--- ecore_main.c 20 Sep 2005 19:15:49 -0000 1.20
+++ ecore_main.c 19 Dec 2005 01:36:55 -0000 1.21
@@ -103,9 +103,19 @@
*
* @p func will be called during the execution of @ref ecore_main_loop_begin
* when the file descriptor is available for reading, or writing, or both.
+ *
+ * Normally the return value from the @p func is "zero means this handler is
+ * finished and can be deleted" as is usual for handler callbacks. However,
+ * if the @p buf_func is supplied, then the return value from the @p func is
"non
+ * zero means the handler should be called again in a tight loop".
+ *
* @p buf_func is called during event loop handling to check if data that has
* been read from the file descriptor is in a buffer and is available to
- * read.
+ * read. Some systems (notably xlib) handle their own buffering, and would
+ * otherwise not work with select(). These systems should use a @p buf_func.
+ * This is a most annoying hack, only ecore_x uses it, so refer to that for
+ * an example. NOTE - @p func should probably return "one" always if @p
buf_func
+ * is used, to avoid confusion with the other return walue semantics.
*
* @param fd The file descriptor to watch.
* @param flags To watch it for read (@c ECORE_FD_READ) and/or
-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems? Stop! Download the new AJAX search engine that makes
searching your log files as easy as surfing the web. DOWNLOAD SPLUNK!
http://ads.osdn.com/?ad_id=7637&alloc_id=16865&op=click
_______________________________________________
enlightenment-cvs mailing list
enlightenment-cvs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/enlightenment-cvs
