From b2019fa2df30e05617f87662113e908aa276d3af Mon Sep 17 00:00:00 2001
From: Antony Polukhin
Date: Tue, 3 Feb 2015 13:28:04 +0300
Subject: [PATCH] Added a README.md and improved some docs. Added TravicCI
integration
---
.travis.yml | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++++
README.md | 16 ++++++++++
index.html | 6 +++-
3 files changed, 106 insertions(+), 1 deletion(-)
create mode 100644 .travis.yml
create mode 100644 README.md
diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 0000000..ee5d380
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,85 @@
+# Use, modification, and distribution are
+# subject to 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)
+#
+# Copyright Antony Polukhin 2014.
+
+#
+# See https://svn.boost.org/trac/boost/wiki/TravisCoverals for description of this file
+# and how it can be used with Boost libraries.
+#
+
+os:
+ - linux
+
+env:
+ - CXX_STANDARD=c++98
+ - CXX_STANDARD=c++0x
+
+before_install:
+ # Set this to the name of your Boost library
+ # Autodetect library name by using the following code: - PROJECT_TO_TEST=$(basename $(pwd))
+ - PROJECT_TO_TEST=$(basename $(pwd))
+
+ # Autodetect Boost branch by using the following code: - BRANCH_TO_TEST=`git rev-parse --abbrev-ref HEAD`
+ # or by - BRANCH_TO_TEST=$TRAVIS_BRANCH or just directly specify it
+ - BRANCH_TO_TEST=$TRAVIS_BRANCH
+
+ # Files, which coverage results must be ignored (files from other projects). Example: - IGNORE_COVERAGE=
+ - IGNORE_COVERAGE=
+
+
+ # From this point and below code is same for all the Boost libs
+ # Cloning Boost libraries (fast nondeep cloning)
+ - PROJECT_DIR=`pwd`
+ - BOOST=$HOME/boost-local
+ - git init $BOOST
+ - cd $BOOST
+ - git remote add --no-tags -t $BRANCH_TO_TEST origin https://github.com/boostorg/boost.git
+ - git fetch --depth=1
+ - git checkout $BRANCH_TO_TEST
+ - git submodule update --init --merge
+ - git remote set-branches --add origin $BRANCH_TO_TEST
+ - git pull --recurse-submodules
+ - git submodule update --init
+ - git checkout $BRANCH_TO_TEST
+ - git submodule foreach "git reset --quiet --hard; git clean -fxd"
+ - git reset --hard; git clean -fxd
+ - git status
+ - rm -rf $BOOST/libs/$PROJECT_TO_TEST
+ - mv $PROJECT_DIR/../$PROJECT_TO_TEST/ $BOOST/libs/$PROJECT_TO_TEST
+ - PROJECT_DIR=$BOOST/libs/$PROJECT_TO_TEST
+ - ./bootstrap.sh
+ - ./b2 headers
+
+script:
+ - if [ "$CCFLAGS" != "" ]; then FLAGS="cxxflags=\"$CCFLAGS\" linkflags=\"$LINKFLAGS\""; else FLAGS=""; fi
+ - cd $BOOST/libs/$PROJECT_TO_TEST/test/
+ # `--coverage` flags required to generate coverage info for Coveralls
+ - ../../../b2 cxxflags="--coverage -std=$CXX_STANDARD" linkflags="--coverage"
+
+after_success:
+ # Copying Coveralls data to a separate folder
+ - mkdir -p $PROJECT_DIR/coverals
+ - find ../../../bin.v2/ -name "*.gcda" -exec cp "{}" $PROJECT_DIR/coverals/ \;
+ - find ../../../bin.v2/ -name "*.gcno" -exec cp "{}" $PROJECT_DIR/coverals/ \;
+
+ # Preparing Coveralls data by
+ # ... installing the tools
+ - sudo apt-get install -qq python-yaml lcov
+ # ... changind data format to a readable one
+ - lcov --directory $PROJECT_DIR/coverals --base-directory ./ --capture --output-file $PROJECT_DIR/coverals/coverage.info
+
+ # ... erasing /test/ /example/ folder data
+ - cd $BOOST
+ - lcov --remove $PROJECT_DIR/coverals/coverage.info "/usr*" "*/$PROJECT_TO_TEST/test/*" $IGNORE_COVERAGE "*/$PROJECT_TO_TEST/tests/*" "*/$PROJECT_TO_TEST/examples/*" "*/$PROJECT_TO_TEST/example/*" -o $PROJECT_DIR/coverals/coverage.info
+
+ # ... erasing data that is not related to this project directly
+ - OTHER_LIBS=`grep "submodule .*" .gitmodules | sed 's/\[submodule\ "\(.*\)"\]/"\*\/boost\/\1\.hpp" "\*\/boost\/\1\/\*"/g'| sed "/\"\*\/boost\/$PROJECT_TO_TEST\/\*\"/d" | sed ':a;N;$!ba;s/\n/ /g'`
+ - echo $OTHER_LIBS
+ - eval "lcov --remove $PROJECT_DIR/coverals/coverage.info $OTHER_LIBS -o $PROJECT_DIR/coverals/coverage.info"
+
+ # Sending data to Coveralls
+ - cd $PROJECT_DIR
+ - gem install coveralls-lcov
+ - coveralls-lcov coverals/coverage.info
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..35f9975
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+#[Boost.Conversion](http://boost.org/libs/conversion)
+Boost.Conversion is one of the [Boost C++ Libraries](http://github.com/boostorg). This library improves program safety and clarity by performing otherwise messy conversions.
+
+### Test results
+
+@ | Build | Tests coverage | More info
+----------------|-------------- | -------------- |-----------
+Develop branch: | [](https://travis-ci.org/apolukhin/conversion) | [](https://coveralls.io/r/apolukhin/conversion?branch=develop) | [details...](http://www.boost.org/development/tests/develop/developer/conversion.html)
+Master branch: | [](https://travis-ci.org/apolukhin/conversion) | [](https://coveralls.io/r/apolukhin/conversion?branch=master) | [details...](http://www.boost.org/development/tests/master/developer/conversion.html)
+
+
+[Open Issues](https://svn.boost.org/trac/boost/query?status=!closed&component=conversion&or&status=!closed&component=lexical_cast)
+
+### License
+
+Distributed under the [Boost Software License, Version 1.0](http://boost.org/LICENSE_1_0.txt).
diff --git a/index.html b/index.html
index 6dc9a96..afc39d3 100644
--- a/index.html
+++ b/index.html
@@ -27,10 +27,14 @@ Standard's built-in casts.
Conversion Library is
supplied by several headers:
- - The boost/cast header provides polymorphic_cast<>,
+
- The boost/polymorphic_cast.hpp and boost/polymorphic_pointer_cast.hpp
+ headers provide polymorphic_cast<>,
polymorphic_downcast<> and polymorphic_pointer_downcast<> to perform safe casting between
polymorphic types.
+ - The boost/implicit_cast.hpp header provides implicit_cast<>
+ to perform implicit casts only (no down-cast, no void*->T*, no U->T if T has only explicit constructors for U).
+
- The boost/lexical_cast header provides lexical_cast<>
general literal text conversions, such as an
int
represented as
a string
, or vice-versa.