Kernel: Fix comment for doc build.

Add an asterisk to make the comment for `k_poll_signal_reset()` appear
in documentation and move an @brief down by one line.

Signed-off-by: Glenn Andrews <glenn.andrews.42@gmail.com>