core: doc fixes to thread.h