install with b2 - conflicting documentation
Hello, I am trying to build the regex library which I will then use through MinGW. I already installed MinGW and added ..\MinGW\bin to my system PATH. I now want to build regex and put it somewhere. I am aware of two different pieces of documentation detailing how to do this: http://www.boost.org/doc/libs/1_53_0/more/getting_started/windows.html#prepa... http://www.boost.org/doc/libs/1_53_0/doc/html/bbv2/installation.html The main difference seems to be whether you should be in BOOST_ROOT or BOOST_ROOT\tools\build\v2. Which is it? In either case I gather than I should do this $ bootstrap.bat gcc and in fact I've done that in both BOOST_ROOT and BOOST_ROOT\tools\build\v2 with apparent success. I just don't know what I'm supposed to do next. I tried running $ b2 --prefix=H:\boost-test --with-regex install from within BOOST_ROOT\tools\build\v2, and that put some stuff into H:\boost-text, but I couldn't find any actual library files. Before I screw around any more I thought I'd ask knowledgeable folks for the right way to do this. Thank you very much, kjoppy
On 23.06.2013 02:39, Kirk Joppy wrote:
Hello,
I am trying to build the regex library which I will then use through MinGW. I already installed MinGW and added ..\MinGW\bin to my system PATH.
I now want to build regex and put it somewhere. I am aware of two different pieces of documentation detailing how to do this:
http://www.boost.org/doc/libs/1_53_0/more/getting_started/windows.html#prepa...
http://www.boost.org/doc/libs/1_53_0/doc/html/bbv2/installation.html
The main difference seems to be whether you should be in BOOST_ROOT or BOOST_ROOT\tools\build\v2. Which is it?
If you are building Boost C++ Libraries, then it should be BOOST_ROOT, as explained by the former document. The latter document documents how you would install Boost.Build to your system, should you want it.
In either case I gather than I should do this
$ bootstrap.bat gcc
and in fact I've done that in both BOOST_ROOT and BOOST_ROOT\tools\build\v2 with apparent success. I just don't know what I'm supposed to do next. I tried running
$ b2 --prefix=H:\boost-test --with-regex install
from within BOOST_ROOT\tools\build\v2,
Try running same from BOOST_ROOT. HTH, Volodya
I think my trouble was the result of slightly confusing documentation so maybe this is a good chance to fix it. I also have some questions regarding the build system that I'd like to ask below and will indicate where I think the docs could be improved as I go along. Referring now to the instructions at http://www.boost.org/doc/libs/1_53_0/more/getting_started/windows.html#prepa... Section 5.2 indicates that the "simplified build" is available only with Visual Studio so I moved on to section 5.3. It says I need to use Boost.Build so I followed the instructions in section 5.3.1 with a slight modification. Here is what I typed into cmd.exe: $ cd boost_root\tools\build\v2\ $ bootstrap.bat gcc $ b2 install --prefix=boost_root\my-build Added boost_root\my-build\bin to PATH $ cd boost_root $ b2 --build-dir=boost_root\my-build\tmp toolset=gc --with-regex --layout=tagged stage In line 2, is "gcc" needed? If so is it just telling b2 what compiler tool chain to use? Why is it necessary to add boost_root\my-build\bin to PATH? Does the second invocation of b2 use executables from there? In the final invocation of b2, note that I did not follow the instructions and put --build-type=complete. Of course, the first time through I did do that but it takes forever and builds a ton of stuff I didn't need. I think it would be really useful to change the documentation so newbies like me don't spend a lot of time incorrectly building the entire lib set. The chance of getting things right the first time seems kind of low and it's a bit wasteful to wait an hour for each attempt, particularly since building only regex, which is all I needed, only takes a few seconds. The note about --with at the end of 5.3.4 should maybe be moved up. Also, I think it might be useful, particularly in the Windows instructions, to explain why the files are being written to a directory called stage. This confused me quite a lot until I realized that it makes sense in the Unix multi-user environment. I really think explaining the thinking behind how this is done in the documentation would be a great help to newcomers. My most important question is - do I actually need to go through the steps in building Boost.Build into boost_root\my-build? It seems like bootstrap.bat works from boost_root and makes b2.exe. What's the difference between doing that and doing it from boost_root\tools\build\v2 ? Ok, now the last thing is that this other set of instructions found here http://www.boost.org/doc/libs/1_53_0/doc/html/bbv2/installation.html really confused me. I now realize they are instructions for installing Boost.Build, but since I first found it through google search and didn't know what I was doing, I thought it was instructions for the libs. It might be useful to add an explicit note that they are not instructions for the lib and perhaps a link to the "getting started" page I refer to above. Thanks so much. I'm trying to understand "why?" and not just "what?" -kjoppy
participants (2)
-
Kirk Joppy -
Vladimir Prus