tree 781ee12a9873a6cda71b7c37fc787f0b78785c36
parent d8d119fd9c04335fc5dfd71aecb49edc92599770
author Andy Ross <andyross@google.com> 1685117571 -0700
committer jgl-meta <126111723+jgl-meta@users.noreply.github.com> 1685135375 -0400

kernel/sched: Rename/redocument wait_for_switch() -> z_sched_switch_spin()

This trick turns out also to be needed by the abort/join code.
Promote it to a more formal-looking internal API and clean up the
documentation to (hopefully) clarify the exact behavior and better
explain the need.

This is one of the more... enchanted bits of the scheduler, and while
the trick is IMHO pretty clean, it remains a big SMP footgun.

Signed-off-by: Andy Ross <andyross@google.com>