X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=filter_common.c;h=6fb9bd96ef8278b3e328198e24db78664a956542;hp=099d056ef1514e2f606adf30d779308b58bead95;hb=5e8d8a8eea6de9459ebdf4498f9f061c84bfa63a;hpb=9d8fdf8898418711558f70a9630b2444036d8285

diff --git a/filter_common.c b/filter_common.c
index 099d056e..6fb9bd96 100644
--- a/filter_common.c
+++ b/filter_common.c
@@ -25,6 +25,16 @@
 /** The array of supported filters. */
 static struct filter filters[NUM_SUPPORTED_FILTERS] = {FILTER_ARRAY};
 
+/**
+ * Obtain a reference to a filter structure.
+ *
+ * \param filter_num Between zero and NUM_SUPPORTED_FILTERS, inclusively.
+ *
+ * \return Pointer to the filter identified by the given filter number.
+ *
+ * It is a fatal error if the given number is out of range. In this case
+ * the function aborts.
+ */
 const struct filter *filter_get(int filter_num)
 {
 	assert(filter_num >= 0);