Boost logo

Boost :

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.


Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk