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.