libbladeRF: Updated header documentation

Added notes about (the lack of) thread safety and added descriptions for
added functionality.