kernel/os_task: Update doxygen comments in the header file

[wpiet]

Adds missing parameter names to function declarations Amends/adds the documentation for macros, functions and structures. Adjusts the formatting for better readability.