Re: [boost] Proposal: Boost.Core

Subject: Re: [boost] Proposal: Boost.Core
From: Andrey Semashev (andrey.semashev_at_[hidden])
Date: 2014-06-01 18:19:17

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.