Add missing documentation of moods_event_handler() and btr_free_node().
authorAndre Noll <maan@systemlinux.org>
Sun, 10 Oct 2010 16:17:53 +0000 (18:17 +0200)
committerAndre Noll <maan@systemlinux.org>
Sun, 10 Oct 2010 16:17:53 +0000 (18:17 +0200)
buffer_tree.c
mood.c

index d92d986..3f1cc71 100644 (file)
@@ -670,6 +670,8 @@ static void flush_input_queue(struct btr_node *btrn)
 /**
  * Free all resources allocated by btr_new_node().
  *
+ * \param btrn Pointer to a btr node obtained by \ref btr_new_node().
+ *
  * Like free(3), it is OK to call this with a \p NULL pointer argument.
  */
 void btr_free_node(struct btr_node *btrn)
diff --git a/mood.c b/mood.c
index d24eac9..89ad80d 100644 (file)
--- a/mood.c
+++ b/mood.c
@@ -890,6 +890,17 @@ static int reload_current_mood(void)
        return ret;
 }
 
+/**
+ * Notification callback for the moods table.
+ *
+ * \param event Type of the event just occurred.
+ * \param pb Unused.
+ * \param data Its type depends on the event.
+ *
+ * This function performs actions required due to the occurrence of the given
+ * event. Possible actions include reload of the current mood and update of the
+ * score of an audio file.
+ */
 int moods_event_handler(enum afs_events event, __a_unused struct para_buffer *pb,
                void *data)
 {
@@ -926,4 +937,3 @@ int moods_event_handler(enum afs_events event, __a_unused struct para_buffer *pb
                return 1;
        }
 }
-