ceph/src/boost/libs/graph/README.md

   1 Boost Graph Library  [![Build Status](https://travis-ci.org/boostorg/graph.svg?branch=develop)](https://travis-ci.org/boostorg/graph)
   2 ===================
   3
   4 A generic interface for traversing graphs, using C++ templates.
   5
   6 The full documentation is available on [boost.org](http://www.boost.org/doc/libs/release/libs/graph/doc/index.html).
   7
   8 ## Support, bugs and feature requests ##
   9
  10 Bugs and feature requests can be reported through the [Github issue page](https://github.com/boostorg/graph/issues).
  11
  12 See also:
  13
  14 * [Current open issues](https://github.com/boostorg/graph/issues)
  15 * [Closed issues](https://github.com/boostorg/graph/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aclosed)
  16 * Old issues still open on [Trac](https://svn.boost.org/trac/boost/query?status=!closed&component=graph&desc=1&order=id)
  17 * Closed issues on [Trac](https://svn.boost.org/trac/boost/query?status=closed&component=graph&col=id&col=summary&col=status&col=owner&col=type&col=milestone&col=version&desc=1&order=id)).
  18
  19 You can submit your changes through a [pull request](https://github.com/boostorg/graph/pulls). One of the maintainers will take a look (remember that it can take some time).
  20
  21 There is no mailing-list specific to Boost Graph, although you can use the general-purpose Boost [mailing-list](http://lists.boost.org/mailman/listinfo.cgi/boost-users) using the tag [graph].
  22
  23
  24 ## Development ##
  25
  26 |                  |  Master  |   Develop   |
  27 |------------------|----------|-------------|
  28 | Travis           | [![Build Status](https://travis-ci.org/boostorg/graph.svg?branch=master)](https://travis-ci.org/boostorg/graph)  |  [![Build Status](https://travis-ci.org/boostorg/graph.svg)](https://travis-ci.org/boostorg/graph) |
  29 | Appveyor         | [![Build status](https://ci.appveyor.com/api/projects/status/78gegk21tc1g3v8d/branch/master?svg=true)](https://ci.appveyor.com/project/jzmaddock/graph/branch/master) | [![Build status](https://ci.appveyor.com/api/projects/status/78gegk21tc1g3v8d/branch/develop?svg=true)](https://ci.appveyor.com/project/jzmaddock/graph/branch/develop)  |
  30
  31
  32 Clone the whole boost project, which includes the individual Boost projects as submodules ([see boost+git doc](https://github.com/boostorg/boost/wiki/Getting-Started)):
  33
  34     git clone https://github.com/boostorg/boost
  35     cd boost
  36     git submodule update --init
  37
  38 The Boost Graph Library is located in `libs/graph/`.
  39
  40 Boost Graph Library is mostly made of headers but also contains some compiled components. Here are the build commands:
  41
  42     ./bootstrap.sh            <- compile b2
  43     ./b2 headers              <- just installs headers
  44     ./b2                      <- build compiled components
  45
  46 **Note:** The Boost Graph Library cannot currently be built outside of Boost itself.
  47
  48 ### Running tests ###
  49 First, make sure you are in `libs/graph/test`.
  50 You can either run all the 300+ tests listed in `Jamfile.v2` or run a single test:
  51
  52     ../../../b2                        <- run all tests
  53     ../../../b2 cycle_canceling_test   <- single test
  54
  55 You can also check the [regression tests reports](http://beta.boost.org/development/tests/develop/developer/graph.html).