1Boost Config Library
2============================
3
4This library provides configuration support for the Boost C++ libraries.
5
6The full documentation is available on [boost.org](http://www.boost.org/doc/libs/release/libs/config/index.html).
7
8|                  |  Master  |   Develop   |
9|------------------|----------|-------------|
10| Drone            |  [![Build Status](https://drone.cpp.al/api/badges/boostorg/config/status.svg?ref=refs/heads/master)](https://drone.cpp.al/boostorg/config) | [![Build Status](https://drone.cpp.al/api/badges/boostorg/config/status.svg)](https://drone.cpp.al/boostorg/config) |
11| Travis           | [![Build Status](https://travis-ci.org/boostorg/config.svg?branch=master)](https://travis-ci.org/boostorg/config)  |  [![Build Status](https://travis-ci.org/boostorg/config.png)](https://travis-ci.org/boostorg/config) |
12| Appveyor         | [![Build status](https://ci.appveyor.com/api/projects/status/wo2n2mhoy8vegmuo/branch/master?svg=true)](https://ci.appveyor.com/project/jzmaddock/config/branch/master) | [![Build status](https://ci.appveyor.com/api/projects/status/wo2n2mhoy8vegmuo/branch/develop?svg=true)](https://ci.appveyor.com/project/jzmaddock/config/branch/develop) |
13
14## Support, bugs and feature requests ##
15
16Bugs and feature requests can be reported through the [Gitub issue tracker](https://github.com/boostorg/config/issues)
17(see [open issues](https://github.com/boostorg/config/issues) and
18[closed issues](https://github.com/boostorg/config/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aclosed)).
19
20You can submit your changes through a [pull request](https://github.com/boostorg/config/pulls).
21
22There is no mailing-list specific to Boost Config, although you can use the general-purpose Boost [mailing-list](http://lists.boost.org/mailman/listinfo.cgi/boost-users) using the tag [config].
23
24
25## Development ##
26
27Clone the whole boost project, which includes the individual Boost projects as submodules ([see boost+git doc](https://github.com/boostorg/boost/wiki/Getting-Started)):
28
29    git clone https://github.com/boostorg/boost
30    cd boost
31    git submodule update --init
32
33The Boost Config Library is located in `libs/config/`.
34
35### Running tests ###
36First, make sure you are in `libs/config/test`.
37You can either run all the tests listed in `Jamfile.v2` or run a single test:
38
39    ../../../b2                        <- run all tests
40    ../../../b2 config_info            <- single test
41
42### For developers ###
43Please check the [Guidelines for Boost Authors](http://www.boost.org/doc/libs/release/libs/config/doc/html/boost_config/guidelines_for_boost_authors.html). from the full documentation.
44