Merge pull request #14 from gsauthof/verbatim

Add some missing verbatim markers

README.md

@@ -1,4 +1,4 @@
-#[Boost.Conversion](http://boost.org/libs/conversion)
+# [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

doc/Jamfile.v2

@@ -9,10 +9,10 @@ project doc/conversion ;
 using quickbook ;
 import boostbook ;
 
-xml conversion_lib : conversion.qbk ;
+xml conversion : conversion.qbk ;
 boostbook standalone
     :
-        conversion_lib
+        conversion
     :
         <xsl:param>boost.root=../../../..
         # File name of HTML output:
@@ -32,7 +32,7 @@ boostbook standalone
      ;
 
 ###############################################################################
-alias boostdoc : standalone ;
+alias boostdoc : conversion ;
 explicit boostdoc ;
 alias boostrelease ;
 explicit boostrelease ;

doc/conversion.qbk

@@ -7,7 +7,7 @@
 [article The Conversion Library
     [quickbook 1.6]
     [compatibility-mode 1.5]
-    [id conversion_lib]
+    [id conversion]
     [version 1.6]
     [authors [Stroustrup, Bjarne], [Abrahams, Dave], [Rasin, Boris], [Polukhin, Antony]]
     [copyright 2001 Beman Dawes]
@@ -91,7 +91,7 @@ crosscasts of pointers to polymorphic objects, but error notification in
 the form of a returned value of 0 is inconvenient to test, or worse yet,
 easy to forget to test. The throwing form of `dynamic_cast`, which
 works on references, can be used on pointers through the ugly expression
-`&dynamic_cast<T&>(*p), which causes undefined 
+`&dynamic_cast<T&>(*p)`, which causes undefined
 behavior if `p` is `0`. The `polymorphic_cast`
 template performs a `dynamic_cast` on a pointer, and throws an
 exception if the `dynamic_cast` returns 0.
@@ -99,12 +99,12 @@ exception if the `dynamic_cast` returns 0.
 For crosscasts, or when the success of a cast can only be known at runtime, 
 or when efficiency is not important, `polymorphic_cast` is preferred.
 
-The C++ built-in dynamic_cast must be used to cast references rather than pointers.
+The C++ built-in `dynamic_cast` must be used to cast references rather than pointers.
 It is also the only cast that can be used to check whether a given interface is supported; in that case a return of 0 isn't an error condition.
 
 [#polymorphic_pointer_cast]
-While polymorphic_downcast and polymorphic_cast work with built-in pointer types only,
-polymorphic_pointer_downcast and polymorphic_pointer_cast are more generic versions
+While `polymorphic_downcast` and `polymorphic_cast` work with built-in pointer types only,
+`polymorphic_pointer_downcast` and `polymorphic_pointer_cast` are more generic versions
 with support for any pointer type for which the following expressions would be valid:
 
 For `polymorphic_pointer_downcast`:
@@ -192,6 +192,6 @@ This includes C++ built-in pointers, `std::shared_ptr`,
 `polymorphic_pointer_downcast` was contributed by [@http://www.boost.org/people/boris_rasin.htm Boris Rasin]
 and `polymorphic_pointer_cast` by Antony Polukhin.
 
-An old numeric_cast that was contributed by [@http://www.boost.org/people/kevlin_henney.htm Kevlin Henney]
+An old `numeric_cast` that was contributed by [@http://www.boost.org/people/kevlin_henney.htm Kevlin Henney]
 is now superseeded by the [@boost:numeric_conversion/doc/html/html/boost_numericconversion/improved_numeric_cast__.html Boost Numeric Conversion Library]
 [endsect]

test/appveyor.yml

@@ -2,27 +2,23 @@
 # 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 2016.
+# Copyright Antony Polukhin 2016-2017.
 
 #
 # See https://svn.boost.org/trac/boost/wiki/TravisCoverals for description of this file
 # and how it can be used with Boost libraries.
 #
-# File revision #2
+# File revision #5
 
 init:
-    - set BRANCH_TO_TEST=%APPVEYOR_REPO_BRANCH%
-    - set BOOST_REMOVE=conversion
-
-os: Visual Studio 2015
-configuration: Debug
-platform: x64
+    - set BRANCH_TO_TEST=%APPVEYOR_REPO_BRANCH%  # Change to branch you wish to test. Use %APPVEYOR_REPO_BRANCH% for current branch.
+    - set BOOST_REMOVE=conversion                # Remove this folder from lib from full clone of Boost. If you are testing `any` repo, write here `any`.
 
 ###############################################################################################################
 # From this point and below code is same for all the Boost libs
 ###############################################################################################################
 
-version: 1.61.{build}-{branch}
+version: 1.64.{build}-{branch}
  
 # branches to build
 branches:
@@ -32,9 +28,8 @@ branches:
 skip_tags: true
 
 before_build:
-    # Set this to the name of the library
-    - set PROJECT_TO_TEST=%APPVEYOR_PROJECT_NAME%
-    - echo "Testing %PROJECT_TO_TEST%"
+    - set PATH=%PATH%;C:\\MinGW\\bin
+    - echo "Testing %APPVEYOR_PROJECT_NAME%"
     # Cloning Boost libraries (fast nondeep cloning)
     - set BOOST=C:/boost-local
     - git init %BOOST%
@@ -42,24 +37,22 @@ before_build:
     - 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 submodule update --init --merge --jobs 16
     - git remote set-branches --add origin %BRANCH_TO_TEST%
-    - git pull --recurse-submodules
-    - git status
+    #- git pull --recurse-submodules        # Updaes submodules to most recent version. Not required
     - rm -rf %BOOST%/libs/%BOOST_REMOVE%
-    - mv %APPVEYOR_BUILD_FOLDER% %BOOST%/libs/%PROJECT_TO_TEST%
-    - set TRAVIS_BUILD_DIR=%BOOST%/libs/%PROJECT_TO_TEST%
+    - mv %APPVEYOR_BUILD_FOLDER% %BOOST%/libs/%APPVEYOR_PROJECT_NAME%
 
 build_script:
     - call "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" x64
     - bootstrap.bat
     - b2.exe headers
-    - cd %BOOST%/libs/%PROJECT_TO_TEST%/test
+    - cd %BOOST%/libs/%APPVEYOR_PROJECT_NAME%/test
 
 after_build:
 before_test:
 test_script:
-  - ..\..\..\b2.exe address-model=64 architecture=x86 cxxflags="-DBOOST_TRAVISCI_BUILD" -sBOOST_BUILD_PATH=.
+    - ..\..\..\b2.exe address-model=32 architecture=x86 toolset=msvc,gcc cxxflags="-DBOOST_TRAVISCI_BUILD" -sBOOST_BUILD_PATH=.
 
 after_test:
 on_success:

test/cast_test.cpp

@@ -72,7 +72,7 @@ int main( int argc, char * argv[] )
 
     bool caught_exception = false;
     try { derived = polymorphic_cast<Derived*>( base ); }
-    catch (std::bad_cast)
+    catch (const std::bad_cast&)
         { cout<<"caught bad_cast\n"; caught_exception = true; }
     BOOST_TEST( caught_exception );
     //  the following is just so generated code can be inspected