Re: [boost] Boost.DLL formal review is ongoing

Subject: Re: [boost] Boost.DLL formal review is ongoing
From: Antony Polukhin (antoshkka_at_[hidden])
Date: 2015-07-07 14:36:09

2015-07-07 18:52 GMT+03:00 Fletcher, John P <j.p.fletcher_at_[hidden]>:

> This is where I had problems.  I went to the section "Getting Started" in
> the manual.  This I found confusing as it did not contain a simple
> example.  It also contained this statement
>
> "To start with the library you only need to include <boost/dll.hpp>
> header."
>
> which is not true for the getting started example which uses the
> boost_filesystemand boost_system libraries.
>
> Also, the first example here is a C++11 export, so I jumped to the (wrong)
> conclusion that C++11 is needed.
>
> Some of that is my fault, but I think that "Getting Started" should be
> rewritten to be clear for someone wanting to build a small example.
>
> It would also help for that small example to make clear that the main code
> and the library need to be compiled separately.  It would help to have a
> pointer to where to find how to build a linkable library for different
> compilers and systems, though I realise having all that information for
> different systems is too much to ask.
>
> There is a certain amount of advice on how to compile for Linux, including
> some compiler flags.  It would be very helpful if that could be gathered in
> one location so that all of it can be applied.
>

Thanks for multiple hints on how to improve the documents. You're not the
first who dislikes the "Getting started" section, it requires a good
rewrite.

-- 
Best regards,
Antony Polukhin