> This sort of information can also be conveyed by a documentation comment on the function or a pseudo-keyword: > #define NATIVE_THREAD_ONLY > NATIVE_THREAD_O

> This sort of information can also be conveyed by a documentation comment on the function or a pseudo-keyword: > #define NATIVE_THREAD_ONLY > NATIVE_THREAD_ONLY int foo(); > The Win32 API tends to like using these (IN, OUT, INOUT, etc.), but I'm not too fond of them. The use in Windows is not purely informational or for documentation. They have static analysis tools (prefast and prefix) that actually parse them and issue warnings for incorrect usage in code.