On Sunday 01 June 2014 22:55:31 Peter Dimov wrote:
Andrey Semashev wrote:
Not sure if there's a need to add official docs, this tool is for Boost developers only and the headers pretty much reflect parts of windows.h. MSDN documents these APIs rather well.
No, you misunderstand; I was not suggesting to duplicate the MSDN documentation for every function and type, just list the function and types and what header defines them. And perhaps say a few words about BOOST_USE_WINDOWS_H, which is a legitimate user macro. BOOST_USE_WINAPI_VERSION is also a user macro, I suppose?
Yes, it is. I don't mind documenting. The problem is where that documentation should live. I don't want to expose documentation on implementation details to Boost users, encouraging them to use these tools.