module adapter: add and cleanup doxygen comments in generic.h

Flesh out the documentation around the module API. More document updates
to follow.

Signed-off-by: Liam Girdwood <liam.r.girdwood@linux.intel.com>

Author: lrgirdwo