doc: a note on spm_wait()