2
0
mirror of https://github.com/boostorg/fiber.git synced 2026-02-19 14:22:23 +00:00
Files
fiber/doc/installing.qbk
Nat Goodspeed 4146812990 Add 'Installing and Running Tests' section.
Add ["text] macro for enclosing "text" in curly double quotes.
2016-02-09 20:14:45 -05:00

57 lines
1.8 KiB
Plaintext

[/
Copyright Oliver Kowalke, Nat Goodspeed 2016.
Distributed under the Boost Software License, Version 1.0.
(See accompanying file LICENSE_1_0.txt or copy at
http://www.boost.org/LICENSE_1_0.txt
]
[section:installing Installing and Running Tests]
[heading Installing the Fiber library]
As Fiber is not yet officially part of Boost, it is necessary to embed it in
an existing [@http://www.boost.org/users/download/ Boost source tree].
The [@https://github.com/olk/boost-fiber/archive/master.zip downloaded Fiber
library] can be placed into an existing Boost source tree by moving the
top-level Fiber directory to `libs/fiber` under the top-level Boost directory,
then further moving `libs/fiber/include/boost/fiber` (in other words, the
Fiber library's `include/boost/fiber` directory) to `boost/fiber` under the
top-level Boost directory.
On a Posix system such as Linux or OS X, you may use symlinks instead.
Create a symlink from the Boost directory's `libs/fiber` to the top-level
Fiber directory, e.g.:
cd ~/boost_1_61_0
ln -s ~/boost-fiber-master libs/fiber
Then create a symlink from the Boost directory's `boost/fiber` to the Fiber
library's `include/boost/fiber` directory:
cd boost
ln -s ../libs/fiber/include/boost/fiber fiber
For some versions of the Boost.Build system, it was important to use a
relative symlink of that form for `boost/fiber`.
[#tests]
[heading Running Tests]
Once the Fiber library has been overlaid (or symlinked) into the Boost source
tree this way, the Boost.Build system can build it like any other Boost
library. In particular:
cd ~/boost_1_61_0
./bootstrap.sh
./b2 libs/fiber/test
On Windows, the commands would look more like:
cd /D %HOMEDRIVE%%HOMEPATH%\boost_1_61_0
bootstrap
b2 libs\fiber\test
[endsect]