libbladeRF & liblms: Header file doxygen-stubs and minor cleanup

Added a couple minor tweaks to headers.

Mostly, this changeset consists of some preliminary doxygen-ification.
Through FIXME and TODO markers, doxygen now runs without warning.
Someone more knowledgeable than I will have to fill some of these in.