X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=filter_common.c;h=1233c9ad80ac5c76d8d50c7b52a6abfe0f4a1219;hp=566d97edc9ee7eca82525f7854c4b81aed93c04d;hb=3b447b02e2d74d596ecf6f5f764bf847653d407c;hpb=d7b4aa3835197ee906f13f515040e1cda6385544

diff --git a/filter_common.c b/filter_common.c
index 566d97ed..1233c9ad 100644
--- a/filter_common.c
+++ b/filter_common.c
@@ -108,6 +108,11 @@ int check_filter_arg(char *fa, void **conf)
 	return -E_UNSUPPORTED_FILTER;
 }
 
+/**
+ * Print help text of each filter to stdout.
+ *
+ * \param detailed If non-zero, print detailed help.
+ */
 void print_filter_helps(int detailed)
 {
 	int i;
@@ -127,6 +132,17 @@ void print_filter_helps(int detailed)
 	}
 }
 
+/**
+ * Set select timeout of the the scheduler.
+ *
+ * \param s The scheduler.
+ * \param t The task struct of this filter.
+ *
+ * This looks at the status of the btr node of the filter. If data is available
+ * in the input queue of the filter, or if an error occured, a minimal timeout
+ * for the next select call is requested from the scheduler. Otherwise the
+ * scheduler timeout is left unchanged.
+ */
 void generic_filter_pre_select(struct sched *s, struct task *t)
 {
 	struct filter_node *fn = container_of(t, struct filter_node, task);
@@ -153,6 +169,8 @@ void generic_filter_pre_select(struct sched *s, struct task *t)
  * \param sample_rate Known to the decoder.
  * \param channels Known to the decoder.
  * \param result Ascii representation on the answer is stored here.
+ *
+ * \return Standard.
  */
 int decoder_execute(const char *cmd, unsigned sample_rate, unsigned channels,
 		char **result)