From: antognolli Date: Mon, 4 Jul 2011 18:31:23 +0000 (+0000) Subject: ecore/fd_handler - Add detailed description to this group. X-Git-Tag: 2.0_alpha~194^2~16 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=d43ed759c2b4878c09f1de17560c82e38d40d946;p=framework%2Fuifw%2Fecore.git ecore/fd_handler - Add detailed description to this group. git-svn-id: svn+ssh://svn.enlightenment.org/var/svn/e/trunk/ecore@61016 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33 --- diff --git a/src/lib/ecore/ecore_main.c b/src/lib/ecore/ecore_main.c index d2521ec..f1e731f 100644 --- a/src/lib/ecore/ecore_main.c +++ b/src/lib/ecore/ecore_main.c @@ -777,7 +777,21 @@ ecore_main_loop_select_func_get(void) * * Functions that deal with file descriptor handlers. * - * Examples with functions that deal with file descriptor handlers: + * The @ref Ecore_Fd_Handler can be used to watch a file descriptor for data + * available for reading, for the availability to write without blocking, and + * for errors on the file descriptor. + * + * ecore_main_fd_handler_add() is used to setup a handler for a given file + * descriptor. This file descriptor can be the standard input, a network socket, + * a stream received through some driver of a hardware decoder, etc. Thus it can + * contain errors, like a disconnection, a broken pipe, and so, and that's why + * it's possible to check for these errors with the @ref ECORE_FD_ERROR flag. + * + * An @ref Ecore_Fd_Handler can be used to watch on a file descriptor without + * blocking, still being able to receive events, expire timers, and other watch + * for other things that happen in the Ecore main loop. + * + * Example of use of a file descriptor handler: * @li @ref ecore_fd_handler_example_c */