reorganize and update documentation; fix compiler warning

git-svn-id: svn://svn.linux1394.org/libraw1394/trunk@144 53a565d1-3bb7-0310-b661-cf11e63c67ab

1 files changed, 0 insertions, 53 deletions

diff --git a/src/eventloop.c b/src/eventloop.c
index 982f700..5c3fc03 100644
--- a/src/eventloop.c
+++ b/src/eventloop.c
@@ -27,17 +27,6 @@
 #include "raw1394_private.h"
 
 
-/**
- * raw1394_loop_iterate - get and process one event message
- *
- * Get one new message through handle and process it with the registered message
- * handler.  This function will return %-1 for an error or the return value of
- * the handler which got executed.  The default handlers always return zero.
- *
- * Note that some other library functions may call this function multiple times
- * to wait for their completion, some handler return values may get lost if you
- * use these.
- **/
 int raw1394_loop_iterate(struct raw1394_handle *handle)
 {
         struct raw1394_request req;
@@ -115,13 +104,6 @@ int raw1394_loop_iterate(struct raw1394_handle *handle)
 }
 
 
-/**
- * raw1394_set_bus_reset_handler - set bus reset handler
- * @new_h: pointer to new handler
- *
- * Sets the handler to be called on every bus reset to @new_h and returns the
- * old handler. The default handler just calls raw1394_update_generation().
- **/
 bus_reset_handler_t raw1394_set_bus_reset_handler(struct raw1394_handle *handle,
                                                   bus_reset_handler_t new)
 {
@@ -133,19 +115,6 @@ bus_reset_handler_t raw1394_set_bus_reset_handler(struct raw1394_handle *handle,
         return old;
 }
 
-/**
- * raw1394_set_tag_handler - set request completion handler
- * @new_h: pointer to new handler
- *
- * Sets the handler to be called whenever a request completes to @new_h and
- * returns the old handler.  The default handler interprets the tag as a pointer
- * to a &struct raw1394_reqhandle and calls the callback in there.
- *
- * Care must be taken when replacing the tag handler and calling the synchronous
- * versions of the transaction functions (i.e. raw1394_read(), raw1394_write(),
- * raw1394_lock(), raw1394_iso_write()) since these do pass pointers to &struct
- * raw1394_reqhandle as the tag and expect the callback to be invoked.
- **/
 tag_handler_t raw1394_set_tag_handler(struct raw1394_handle *handle, 
                                       tag_handler_t new)
 {
@@ -169,17 +138,6 @@ arm_tag_handler_t raw1394_set_arm_tag_handler(struct raw1394_handle *handle,
 }
 
 
-/**
- * raw1394_set_iso_handler - set isochronous packet handler
- * @new_h: pointer to new handler
- *
- * Sets the handler to be called when an isochronous packet is received to
- * @new_h and returns the old handler.  The default handler does nothing.
- *
- * In order to actually get iso packet events, receiving on a specific channel
- * first has to be enabled with raw1394_start_iso_rcv() and can be stopped again
- * with raw1394_stop_iso_rcv().
- **/
 iso_handler_t raw1394_set_iso_handler(struct raw1394_handle *handle,
                                       unsigned int channel, iso_handler_t new)
 {
@@ -201,17 +159,6 @@ iso_handler_t raw1394_set_iso_handler(struct raw1394_handle *handle,
         return NULL;
 }
 
-/**
- * raw1394_set_fcp_handler - set FCP handler
- * @new_h: pointer to new handler
- *
- * Sets the handler to be called when either FCP command or FCP response
- * registers get written to @new_h and returns the old handler.  The default
- * handler does nothing.
- *
- * In order to actually get FCP events, you have to enable it with
- * raw1394_start_fcp_listen() and can stop it with raw1394_stop_fcp_listen().
- **/
 fcp_handler_t raw1394_set_fcp_handler(struct raw1394_handle *handle,
                                       fcp_handler_t new)
 {