drivers: mbox: improve Doxygen

Fix a few Doxygen issues, e.g.

- References to structs
- Incorrect usage of `@a`, `@p`
- Unnecessary usages of `@typedef`
- Incorrect usages of `@retval`
- etc.

Signed-off-by: Gerard Marull-Paretas <gerard@teslabs.com>