kern: sem: added documentation to semaphores.

 * Added a module to doxygen for semaphores.
 * Added doxygen comments to all sem functions and data structures

Signed-off-by: Michel Megens <dev@michelmegens.net>