Currently the comments per function have a note: Multithreading: Any thread. Which is not helpful in determining if calling it should be internally or externally synchronized.
Instead these notes should say: Multithreading: Internally synchronized. for when calling the function does not need to be synchronized with a mutex with any other threads, and Multithreading: Externally synchronized. when only a single thread should be calling this function at a time.
Currently the comments per function have a note:
Multithreading: Any thread.
Which is not helpful in determining if calling it should be internally or externally synchronized.Instead these notes should say:
Multithreading: Internally synchronized.
for when calling the function does not need to be synchronized with a mutex with any other threads, andMultithreading: Externally synchronized.
when only a single thread should be calling this function at a time.