Make sr_session_iteration() private

diff --git a/libsigrok-internal.h b/libsigrok-internal.h
index 5fc0fbfabcea5303a3669a71c739fbbe7f6c6842..453c6583f093dd01a45763959a687f1290d5ce25 100644 (file)
--- a/libsigrok-internal.h
+++ b/libsigrok-internal.h
@@ -116,6 +116,7 @@ SR_PRIV int sr_source_add(int fd, int events, int timeout,
 
 /*--- session.c -------------------------------------------------------------*/
 
+SR_PRIV int sr_session_iteration(gboolean block);
 SR_PRIV int sr_session_send(const struct sr_dev_inst *sdi,
                const struct sr_datafeed_packet *packet);
 SR_PRIV int sr_session_stop_sync(void);

diff --git a/proto.h b/proto.h
index b1adb35fd234d1060f333d18d21bd350d952dc52..821846f223abb66e91fc0e29049245a49572feb6 100644 (file)
--- a/proto.h
+++ b/proto.h
@@ -97,7 +97,6 @@ SR_API int sr_session_datafeed_callback_add(sr_datafeed_callback_t cb,
                void *cb_data);
 
 /* Session control */
-SR_API int sr_session_iteration(gboolean block);
 SR_API int sr_session_start(void);
 SR_API int sr_session_run(void);
 SR_API int sr_session_stop(void);

diff --git a/session.c b/session.c
index 720b5ae10819908b63018e1c8095cbfceed5bc49..514b620ab9f3ca3e2895757ca09387a70da2c1bd 100644 (file)
--- a/session.c
+++ b/session.c
@@ -239,9 +239,16 @@ SR_API int sr_session_datafeed_callback_add(sr_datafeed_callback_t cb, void *cb_
  * but driven by another scheduler, this can be used to poll the devices
  * from within that scheduler.
  *
+ * @param block If TRUE, this call will wait for any of the session's
+ *              sources to fire an event on the file descriptors, or
+ *              any of their timeouts to activate. In other words, this
+ *              can be used as a select loop.
+ *              If FALSE, all sources have their callback run, regardless
+ *              of file descriptor or timeout status.
+ *
  * @return SR_OK upon success, SR_ERR on errors.
  */
-SR_API int sr_session_iteration(gboolean block)
+SR_PRIV int sr_session_iteration(gboolean block)
 {
        unsigned int i;
        int ret;