fibre: Add extensive doxygen comments.

"Write your code for readability... the next person who reads it will
probably be you."

Signed-off-by: Daniel Thompson <daniel@redfelineninja.org.uk>