ceph/src/boost/libs/fiber/doc/installing.qbk

   1 [/
   2       Copyright Oliver Kowalke, Nat Goodspeed 2016.
   3  Distributed under the Boost Software License, Version 1.0.
   4     (See accompanying file LICENSE_1_0.txt or copy at
   5           http://www.boost.org/LICENSE_1_0.txt
   6 ]
   7
   8 [section:installing Appendix: Installing and Running Tests]
   9
  10 [heading Installing the Fiber library]
  11
  12 As Fiber is not yet officially part of Boost, it is necessary to embed it in
  13 an existing [@http://www.boost.org/users/download/ Boost source tree].
  14
  15 The [@https://github.com/olk/boost-fiber/archive/master.zip downloaded Fiber
  16 library] can be placed into an existing Boost source tree by moving the
  17 top-level Fiber directory to `libs/fiber` under the top-level Boost directory,
  18 then further moving `libs/fiber/include/boost/fiber` (in other words, the
  19 Fiber library's `include/boost/fiber` directory) to `boost/fiber` under the
  20 top-level Boost directory.
  21
  22 On a Posix system such as Linux or OS X, you may use symlinks instead.
  23
  24 Create a symlink from the Boost directory's `libs/fiber` to the top-level
  25 Fiber directory, e.g.:
  26
  27     cd ~/boost_1_61_0
  28     ln -s ~/boost-fiber-master libs/fiber
  29
  30 Then create a symlink from the Boost directory's `boost/fiber` to the Fiber
  31 library's `include/boost/fiber` directory:
  32
  33     cd boost
  34     ln -s ../libs/fiber/include/boost/fiber fiber
  35
  36 For some versions of the Boost.Build system, it was important to use a
  37 relative symlink of that form for `boost/fiber`.
  38
  39 [#tests]
  40 [heading Running Tests]
  41
  42 Once the Fiber library has been overlaid (or symlinked) into the Boost source
  43 tree this way, the Boost.Build system can build it like any other Boost
  44 library. In particular:
  45
  46     cd ~/boost_1_61_0
  47     ./bootstrap.sh
  48     ./b2 libs/fiber/test
  49
  50 On Windows, the commands would look more like:
  51
  52     cd /D %HOMEDRIVE%%HOMEPATH%\boost_1_61_0
  53     bootstrap
  54     b2 libs\fiber\test
  55
  56 [endsect]