*
* \param rb The ringbuffer identifier
*
- * This function always succeeds and never returns a number greater than the
+ * \return This function always succeeds. It returns a number less than the
* size of the ring buffer.
*/
unsigned ringbuffer_filled(struct ringbuffer *rb)