kernel/thread_stack: Document hardware shadow stack macros

While these are not expected to be used by applications in normal
scenarios, they are still public and document them can be helpful in
non-normal scenarios.

Signed-off-by: Ederson de Souza <ederson.desouza@intel.com>