block: doxify block_FifoNew() and block_FifoRelease()

diff --git a/src/misc/block.c b/src/misc/block.c
index 0a408cc26d15766b7d531542638b7a36cd2f65b4..a5c4b40105faf0ffd930bf5f27110e0c38e05c25 100644 (file)
--- a/src/misc/block.c
+++ b/src/misc/block.c
@@ -522,6 +522,11 @@ struct block_fifo_t
     bool          b_force_wake;
 };
 
+/**
+ * Creates a thread-safe FIFO queue of blocks.
+ * See also block_FifoPut() and block_FifoGet().
+ * @return the FIFO or NULL on memory error
+ */
 block_fifo_t *block_FifoNew( void )
 {
     block_fifo_t *p_fifo = malloc( sizeof( block_fifo_t ) );
@@ -539,6 +544,10 @@ block_fifo_t *block_FifoNew( void )
     return p_fifo;
 }
 
+/**
+ * Destroys a FIFO created by block_FifoNew().
+ * Any queued blocks are also destroyed.
+ */
 void block_FifoRelease( block_fifo_t *p_fifo )
 {
     block_FifoEmpty( p_fifo );