overview.xml: clarify wording

Fix listing typo (#130 )
The paragraph lists a couple of options and expands information on each element. However, the following explanation lists the first element, the first, the third, and the last, whereas the logic of the discussion aims to explain the listing as first, second, third, and last elements.
2026-01-19 16:32:15 +00:00 · 2025-09-13 10:38:35 +01:00 · 2025-09-13 10:36:14 +01:00 · 2025-09-12 16:21:44 +01:00 · 2025-08-27 23:08:03 +01:00 · 2025-08-25 16:44:05 +01:00
45 changed files with 1068 additions and 217 deletions
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,635 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+      - develop
+      - feature/**
+
+env:
+  UBSAN_OPTIONS: print_stacktrace=1
+
+jobs:
+  posix:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - toolset: gcc-4.8
+            cxxstd: "11"
+            container: ubuntu:18.04
+            os: ubuntu-latest
+            install: g++-4.8
+          - toolset: gcc-5
+            cxxstd: "11,14,1z"
+            container: ubuntu:18.04
+            os: ubuntu-latest
+            install: g++-5
+          - toolset: gcc-6
+            cxxstd: "11,14,1z"
+            container: ubuntu:18.04
+            os: ubuntu-latest
+            install: g++-6
+          - toolset: gcc-7
+            cxxstd: "11,14,17"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: g++-7
+          - toolset: gcc-8
+            cxxstd: "11,14,17,2a"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: g++-8
+          - toolset: gcc-9
+            cxxstd: "11,14,17,2a"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+          - toolset: gcc-10
+            cxxstd: "11,14,17,2a"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: g++-10
+          - toolset: gcc-11
+            cxxstd: "11,14,17,2a"
+            container: ubuntu:22.04
+            os: ubuntu-latest
+            install: g++-11
+          - toolset: gcc-12
+            cxxstd: "11,14,17,20,2b"
+            container: ubuntu:22.04
+            os: ubuntu-latest
+            install: g++-12
+          - toolset: gcc-13
+            cxxstd: "11,14,17,20,2b"
+            container: ubuntu:24.04
+            os: ubuntu-latest
+            install: g++-13
+          - toolset: clang
+            compiler: clang++-3.9
+            cxxstd: "11,14"
+            container: ubuntu:18.04
+            os: ubuntu-latest
+            install: clang-3.9
+          - toolset: clang
+            compiler: clang++-4.0
+            cxxstd: "11,14"
+            container: ubuntu:18.04
+            os: ubuntu-latest
+            install: clang-4.0
+          - toolset: clang
+            compiler: clang++-5.0
+            cxxstd: "11,14,1z"
+            container: ubuntu:18.04
+            os: ubuntu-latest
+            install: clang-5.0
+          - toolset: clang
+            compiler: clang++-6.0
+            cxxstd: "11,14,17"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: clang-6.0
+          - toolset: clang
+            compiler: clang++-7
+            cxxstd: "11,14,17"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: clang-7
+          - toolset: clang
+            compiler: clang++-8
+            cxxstd: "11,14,17"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: clang-8
+          - toolset: clang
+            compiler: clang++-9
+            cxxstd: "11,14,17,2a"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: clang-9
+          - toolset: clang
+            compiler: clang++-10
+            cxxstd: "11,14,17,2a"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: clang-10
+          - toolset: clang
+            compiler: clang++-11
+            cxxstd: "11,14,17,2a"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: clang-11
+          - toolset: clang
+            compiler: clang++-12
+            cxxstd: "11,14,17,2a"
+            container: ubuntu:20.04
+            os: ubuntu-latest
+            install: clang-12
+          - toolset: clang
+            compiler: clang++-13
+            cxxstd: "11,14,17,20,2b"
+            container: ubuntu:22.04
+            os: ubuntu-latest
+            install: clang-13
+          - toolset: clang
+            compiler: clang++-14
+            cxxstd: "11,14,17,20,2b"
+            container: ubuntu:22.04
+            os: ubuntu-latest
+            install: clang-14
+          - toolset: clang
+            compiler: clang++-15
+            cxxstd: "11,14,17,20,2b"
+            container: ubuntu:22.04
+            os: ubuntu-latest
+            install: clang-15
+          - toolset: clang
+            compiler: clang++-16
+            cxxstd: "11,14,17,20,2b"
+            container: ubuntu:24.04
+            os: ubuntu-latest
+            install: clang-16
+          - toolset: clang
+            compiler: clang++-17
+            cxxstd: "11,14,17,20,2b"
+            container: ubuntu:24.10
+            os: ubuntu-latest
+            install: clang-17
+          - toolset: clang
+            cxxstd: "11,14,17,20,2b"
+            os: macos-13
+          - toolset: clang
+            cxxstd: "11,14,17,20,2b"
+            os: macos-14
+          - toolset: clang
+            cxxstd: "11,14,17,20,23"
+            os: macos-15
+
+    runs-on: ${{matrix.os}}
+    container:
+      image: ${{matrix.container}}
+      volumes:
+        - /node20217:/node20217:rw,rshared
+        - ${{ startsWith(matrix.container, 'ubuntu:1') && '/node20217:/__e/node20:ro,rshared' || ' ' }}
+
+    defaults:
+      run:
+        shell: bash
+
+    steps:
+      - name: Install nodejs20glibc2.17
+        if: ${{ startsWith( matrix.container, 'ubuntu:1' ) }}
+        run: |
+          set -x
+          apt-get update
+          apt-get install -y curl xz-utils
+          curl -LO https://archives.boost.io/misc/node/node-v20.9.0-linux-x64-glibc-217.tar.xz
+          tar -xf node-v20.9.0-linux-x64-glibc-217.tar.xz --strip-components 1 -C /node20217
+
+      - name: Setup container environment
+        if: matrix.container
+        run: |
+          apt-get update
+          apt-get -y install sudo python3 git g++
+
+      - name: Install packages
+        if: matrix.install
+        run: |
+          sudo apt-get update
+          sudo apt-get -y install ${{matrix.install}}
+
+      - uses: actions/checkout@v4
+
+      - name: Setup Boost
+        run: |
+          echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY
+          LIBRARY=${GITHUB_REPOSITORY#*/}
+          echo LIBRARY: $LIBRARY
+          echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV
+          echo GITHUB_BASE_REF: $GITHUB_BASE_REF
+          echo GITHUB_REF: $GITHUB_REF
+          REF=${GITHUB_BASE_REF:-$GITHUB_REF}
+          REF=${REF#refs/heads/}
+          echo REF: $REF
+          BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true
+          echo BOOST_BRANCH: $BOOST_BRANCH
+          cd ..
+          git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY
+          git submodule update --init tools/boostdep
+          python3 tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY
+          ./bootstrap.sh
+          ./b2 -d0 headers
+
+      - name: Create user-config.jam
+        if: matrix.compiler
+        run: |
+          echo "using ${{matrix.toolset}} : : ${{matrix.compiler}} ;" > ~/user-config.jam
+
+      - name: Run tests
+        run: |
+          cd ../boost-root
+          ./b2 -j3 libs/$LIBRARY/test toolset=${{matrix.toolset}} cxxstd=${{matrix.cxxstd}} variant=debug,release
+
+  windows:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - toolset: msvc-14.0
+            cxxstd: "14,latest"
+            addrmd: 32,64
+            os: windows-2019
+          - toolset: msvc-14.2
+            cxxstd: "14,17,20,latest"
+            addrmd: 32,64
+            os: windows-2019
+          - toolset: msvc-14.3
+            cxxstd: "14,17,20,latest"
+            addrmd: 32,64
+            os: windows-2022
+          - toolset: clang-win
+            cxxstd: "14,17,20,latest"
+            addrmd: 32,64
+            os: windows-2022
+          - toolset: gcc
+            cxxstd: "11,14,17,2a"
+            addrmd: 64
+            os: windows-2019
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Boost
+        shell: cmd
+        run: |
+          echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY%
+          for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi
+          echo LIBRARY: %LIBRARY%
+          echo LIBRARY=%LIBRARY%>>%GITHUB_ENV%
+          echo GITHUB_BASE_REF: %GITHUB_BASE_REF%
+          echo GITHUB_REF: %GITHUB_REF%
+          if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF%
+          set BOOST_BRANCH=develop
+          for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master
+          echo BOOST_BRANCH: %BOOST_BRANCH%
+          cd ..
+          git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\
+          git submodule update --init tools/boostdep
+          python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" %LIBRARY%
+          cmd /c bootstrap
+          b2 -d0 headers
+
+      - name: Run tests
+        shell: cmd
+        run: |
+          cd ../boost-root
+          b2 -j3 libs/%LIBRARY%/test toolset=${{matrix.toolset}} cxxstd=${{matrix.cxxstd}} address-model=${{matrix.addrmd}} variant=debug,release embed-manifest-via=linker
+
+  posix-cmake-subdir:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-20.04
+          - os: ubuntu-22.04
+          - os: macos-13
+          - os: macos-14
+          - os: macos-15
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install packages
+        if: matrix.install
+        run: sudo apt-get -y install ${{matrix.install}}
+
+      - name: Setup Boost
+        run: |
+          echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY
+          LIBRARY=${GITHUB_REPOSITORY#*/}
+          echo LIBRARY: $LIBRARY
+          echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV
+          echo GITHUB_BASE_REF: $GITHUB_BASE_REF
+          echo GITHUB_REF: $GITHUB_REF
+          REF=${GITHUB_BASE_REF:-$GITHUB_REF}
+          REF=${REF#refs/heads/}
+          echo REF: $REF
+          BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true
+          echo BOOST_BRANCH: $BOOST_BRANCH
+          cd ..
+          git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY
+          git submodule update --init tools/boostdep
+          python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY
+
+      - name: Use library with add_subdirectory
+        run: |
+          cd ../boost-root/libs/$LIBRARY/test/cmake_subdir_test
+          mkdir __build__ && cd __build__
+          cmake ..
+          cmake --build .
+          ctest --output-on-failure --no-tests=error
+
+  posix-cmake-install:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-20.04
+          - os: ubuntu-22.04
+          - os: macos-13
+          - os: macos-14
+          - os: macos-15
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install packages
+        if: matrix.install
+        run: sudo apt-get -y install ${{matrix.install}}
+
+      - name: Setup Boost
+        run: |
+          echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY
+          LIBRARY=${GITHUB_REPOSITORY#*/}
+          echo LIBRARY: $LIBRARY
+          echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV
+          echo GITHUB_BASE_REF: $GITHUB_BASE_REF
+          echo GITHUB_REF: $GITHUB_REF
+          REF=${GITHUB_BASE_REF:-$GITHUB_REF}
+          REF=${REF#refs/heads/}
+          echo REF: $REF
+          BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true
+          echo BOOST_BRANCH: $BOOST_BRANCH
+          cd ..
+          git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY
+          git submodule update --init tools/boostdep
+          python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY
+
+      - name: Configure
+        run: |
+          cd ../boost-root
+          mkdir __build__ && cd __build__
+          cmake -DBOOST_INCLUDE_LIBRARIES=$LIBRARY -DCMAKE_INSTALL_PREFIX=~/.local ..
+
+      - name: Install
+        run: |
+          cd ../boost-root/__build__
+          cmake --build . --target install
+
+      - name: Use the installed library
+        run: |
+          cd ../boost-root/libs/$LIBRARY/test/cmake_install_test && mkdir __build__ && cd __build__
+          cmake -DCMAKE_INSTALL_PREFIX=~/.local ..
+          cmake --build .
+          ctest --output-on-failure --no-tests=error
+
+  posix-cmake-test:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-20.04
+          - os: ubuntu-22.04
+          - os: macos-13
+          - os: macos-14
+          - os: macos-15
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install packages
+        if: matrix.install
+        run: sudo apt-get -y install ${{matrix.install}}
+
+      - name: Setup Boost
+        run: |
+          echo GITHUB_REPOSITORY: $GITHUB_REPOSITORY
+          LIBRARY=${GITHUB_REPOSITORY#*/}
+          echo LIBRARY: $LIBRARY
+          echo "LIBRARY=$LIBRARY" >> $GITHUB_ENV
+          echo GITHUB_BASE_REF: $GITHUB_BASE_REF
+          echo GITHUB_REF: $GITHUB_REF
+          REF=${GITHUB_BASE_REF:-$GITHUB_REF}
+          REF=${REF#refs/heads/}
+          echo REF: $REF
+          BOOST_BRANCH=develop && [ "$REF" == "master" ] && BOOST_BRANCH=master || true
+          echo BOOST_BRANCH: $BOOST_BRANCH
+          cd ..
+          git clone -b $BOOST_BRANCH --depth 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          cp -r $GITHUB_WORKSPACE/* libs/$LIBRARY
+          git submodule update --init tools/boostdep
+          python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" $LIBRARY
+
+      - name: Configure
+        run: |
+          cd ../boost-root
+          mkdir __build__ && cd __build__
+          cmake -DBOOST_INCLUDE_LIBRARIES=$LIBRARY -DBUILD_TESTING=ON ..
+
+      - name: Build tests
+        run: |
+          cd ../boost-root/__build__
+          cmake --build . --target tests
+
+      - name: Run tests
+        run: |
+          cd ../boost-root/__build__
+          ctest --output-on-failure --no-tests=error
+
+  windows-cmake-subdir:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-2019
+          - os: windows-2022
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Boost
+        shell: cmd
+        run: |
+          echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY%
+          for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi
+          echo LIBRARY: %LIBRARY%
+          echo LIBRARY=%LIBRARY%>>%GITHUB_ENV%
+          echo GITHUB_BASE_REF: %GITHUB_BASE_REF%
+          echo GITHUB_REF: %GITHUB_REF%
+          if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF%
+          set BOOST_BRANCH=develop
+          for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master
+          echo BOOST_BRANCH: %BOOST_BRANCH%
+          cd ..
+          git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\
+          git submodule update --init tools/boostdep
+          python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" %LIBRARY%
+
+      - name: Use library with add_subdirectory (Debug)
+        shell: cmd
+        run: |
+          cd ../boost-root/libs/%LIBRARY%/test/cmake_subdir_test
+          mkdir __build__ && cd __build__
+          cmake ..
+          cmake --build . --config Debug
+          ctest --output-on-failure --no-tests=error -C Debug
+
+      - name: Use library with add_subdirectory (Release)
+        shell: cmd
+        run: |
+          cd ../boost-root/libs/%LIBRARY%/test/cmake_subdir_test/__build__
+          cmake --build . --config Release
+          ctest --output-on-failure --no-tests=error -C Release
+
+  windows-cmake-install:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-2019
+          - os: windows-2022
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Boost
+        shell: cmd
+        run: |
+          echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY%
+          for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi
+          echo LIBRARY: %LIBRARY%
+          echo LIBRARY=%LIBRARY%>>%GITHUB_ENV%
+          echo GITHUB_BASE_REF: %GITHUB_BASE_REF%
+          echo GITHUB_REF: %GITHUB_REF%
+          if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF%
+          set BOOST_BRANCH=develop
+          for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master
+          echo BOOST_BRANCH: %BOOST_BRANCH%
+          cd ..
+          git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\
+          git submodule update --init tools/boostdep
+          python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" %LIBRARY%
+
+      - name: Configure
+        shell: cmd
+        run: |
+          cd ../boost-root
+          mkdir __build__ && cd __build__
+          cmake -DBOOST_INCLUDE_LIBRARIES=%LIBRARY% -DCMAKE_INSTALL_PREFIX=C:/cmake-prefix ..
+
+      - name: Install (Debug)
+        shell: cmd
+        run: |
+          cd ../boost-root/__build__
+          cmake --build . --target install --config Debug
+
+      - name: Install (Release)
+        shell: cmd
+        run: |
+          cd ../boost-root/__build__
+          cmake --build . --target install --config Release
+
+      - name: Use the installed library (Debug)
+        shell: cmd
+        run: |
+          cd ../boost-root/libs/%LIBRARY%/test/cmake_install_test && mkdir __build__ && cd __build__
+          cmake -DCMAKE_INSTALL_PREFIX=C:/cmake-prefix ..
+          cmake --build . --config Debug
+          ctest --output-on-failure --no-tests=error -C Debug
+
+      - name: Use the installed library (Release)
+        shell: cmd
+        run: |
+          cd ../boost-root/libs/%LIBRARY%/test/cmake_install_test/__build__
+          cmake --build . --config Release
+          ctest --output-on-failure --no-tests=error -C Release
+
+  windows-cmake-test:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-2019
+          - os: windows-2022
+
+    runs-on: ${{matrix.os}}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Boost
+        shell: cmd
+        run: |
+          echo GITHUB_REPOSITORY: %GITHUB_REPOSITORY%
+          for /f %%i in ("%GITHUB_REPOSITORY%") do set LIBRARY=%%~nxi
+          echo LIBRARY: %LIBRARY%
+          echo LIBRARY=%LIBRARY%>>%GITHUB_ENV%
+          echo GITHUB_BASE_REF: %GITHUB_BASE_REF%
+          echo GITHUB_REF: %GITHUB_REF%
+          if "%GITHUB_BASE_REF%" == "" set GITHUB_BASE_REF=%GITHUB_REF%
+          set BOOST_BRANCH=develop
+          for /f %%i in ("%GITHUB_BASE_REF%") do if "%%~nxi" == "master" set BOOST_BRANCH=master
+          echo BOOST_BRANCH: %BOOST_BRANCH%
+          cd ..
+          git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root
+          cd boost-root
+          xcopy /s /e /q %GITHUB_WORKSPACE% libs\%LIBRARY%\
+          git submodule update --init tools/boostdep
+          python tools/boostdep/depinst/depinst.py --git_args "--jobs 3" %LIBRARY%
+
+      - name: Configure
+        shell: cmd
+        run: |
+          cd ../boost-root
+          mkdir __build__ && cd __build__
+          cmake -DBOOST_INCLUDE_LIBRARIES=%LIBRARY% -DBUILD_TESTING=ON ..
+
+      - name: Build tests (Debug)
+        shell: cmd
+        run: |
+          cd ../boost-root/__build__
+          cmake --build . --target tests --config Debug
+
+      - name: Run tests (Debug)
+        shell: cmd
+        run: |
+          cd ../boost-root/__build__
+          ctest --output-on-failure --no-tests=error -C Debug
+
+      - name: Build tests (Release)
+        shell: cmd
+        run: |
+          cd ../boost-root/__build__
+          cmake --build . --target tests --config Release
+
+      - name: Run tests (Release)
+        shell: cmd
+        run: |
+          cd ../boost-root/__build__
+          ctest --output-on-failure --no-tests=error -C Release
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -0,0 +1,63 @@
+# Generated by `boostdep --cmake program_options`
+# Copyright 2020, 2021 Peter Dimov
+# Distributed under the Boost Software License, Version 1.0.
+# https://www.boost.org/LICENSE_1_0.txt
+
+cmake_minimum_required(VERSION 3.8...3.20)
+
+project(boost_program_options VERSION "${BOOST_SUPERPROJECT_VERSION}" LANGUAGES CXX)
+
+add_library(boost_program_options
+  src/cmdline.cpp
+  src/config_file.cpp
+  src/convert.cpp
+  src/options_description.cpp
+  src/parsers.cpp
+  src/positional_options.cpp
+  src/split.cpp
+  src/utf8_codecvt_facet.cpp
+  src/value_semantic.cpp
+  src/variables_map.cpp
+  src/winmain.cpp
+)
+
+add_library(Boost::program_options ALIAS boost_program_options)
+
+target_include_directories(boost_program_options PUBLIC include)
+
+target_link_libraries(boost_program_options
+  PUBLIC
+    Boost::any
+    Boost::config
+    Boost::core
+    Boost::detail
+    Boost::function
+    Boost::iterator
+    Boost::lexical_cast
+    Boost::smart_ptr
+    Boost::static_assert
+    Boost::throw_exception
+    Boost::type_traits
+  PRIVATE
+    Boost::bind
+    Boost::tokenizer
+)
+
+target_compile_features(boost_program_options PUBLIC cxx_std_11)
+
+target_compile_definitions(boost_program_options
+  PUBLIC BOOST_PROGRAM_OPTIONS_NO_LIB
+  PRIVATE BOOST_PROGRAM_OPTIONS_SOURCE
+)
+
+if(BUILD_SHARED_LIBS)
+  target_compile_definitions(boost_program_options PUBLIC BOOST_PROGRAM_OPTIONS_DYN_LINK)
+else()
+  target_compile_definitions(boost_program_options PUBLIC BOOST_PROGRAM_OPTIONS_STATIC_LINK)
+endif()
+
+if(BUILD_TESTING AND EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/test/CMakeLists.txt")
+
+  add_subdirectory(test)
+
+endif()
--- a/11
+++ b/11
@@ -1,11 +0,0 @@
-#  Boost.ProgramOptions Library Jamfile
-#
-#  Copyright (c) 2018 James E. King III
-#
-#  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)
-
-# please order by name to ease maintenance
-build-project example ;
-build-project test ;
--- a/README.md
+++ b/README.md
@@ -14,8 +14,8 @@ Distributed under the [Boost Software License, Version 1.0](http://www.boost.org

 |Branch          | Travis | Appveyor | codecov.io | Deps | Docs | Tests |
 |:-------------: | ------ | -------- | ---------- | ---- | ---- | ----- |
-|[`master`](https://github.com/boostorg/program_options/tree/master) | [![Build Status](https://travis-ci.org/boostorg/program_options.svg?branch=master)](https://travis-ci.org/boostorg/program_options) | [![Build status](https://ci.appveyor.com/api/projects/status/e0quisadwh1v7ok5/branch/master?svg=true)](https://ci.appveyor.com/project/vprus/program-options/branch/master) | [![codecov](https://codecov.io/gh/boostorg/program_options/branch/master/graph/badge.svg)](https://codecov.io/gh/boostorg/program_options/branch/master) | [![Deps](https://img.shields.io/badge/deps-master-brightgreen.svg)](https://pdimov.github.io/boostdep-report/master/program_options.html) | [![Documentation](https://img.shields.io/badge/docs-master-brightgreen.svg)](http://www.boost.org/doc/libs/master/doc/html/program_options.html) | [![Enter the Matrix](https://img.shields.io/badge/matrix-master-brightgreen.svg)](http://www.boost.org/development/tests/master/developer/program_options.html) 
-|[`develop`](https://github.com/boostorg/program_options/tree/develop) | [![Build Status](https://travis-ci.org/boostorg/program_options.svg?branch=develop)](https://travis-ci.org/boostorg/program_options) | [![Build status](https://ci.appveyor.com/api/projects/status/e0quisadwh1v7ok5/branch/develop?svg=true)](https://ci.appveyor.com/project/vprus/program-options/branch/develop) | [![codecov](https://codecov.io/gh/boostorg/program_options/branch/develop/graph/badge.svg)](https://codecov.io/gh/boostorg/program_options/branch/develop) | [![Deps](https://img.shields.io/badge/deps-develop-brightgreen.svg)](https://pdimov.github.io/boostdep-report/develop/program_options.html) | [![Documentation](https://img.shields.io/badge/docs-develop-brightgreen.svg)](http://www.boost.org/doc/libs/develop/doc/html/program_options.html) | [![Enter the Matrix](https://img.shields.io/badge/matrix-develop-brightgreen.svg)](http://www.boost.org/development/tests/develop/developer/program_options.html)
+|[`master`](https://github.com/boostorg/program_options/tree/master) | [![Build Status](https://travis-ci.org/boostorg/program_options.svg?branch=master)](https://travis-ci.org/boostorg/program_options) | [![Build status](https://ci.appveyor.com/api/projects/status/e0quisadwh1v7ok5/branch/master?svg=true)](https://ci.appveyor.com/project/vprus/program-options/branch/master) | [![codecov](https://codecov.io/gh/boostorg/program_options/branch/master/graph/badge.svg)](https://codecov.io/gh/boostorg/program_options/branch/master) | [![Deps](https://img.shields.io/badge/deps-master-brightgreen.svg)](https://pdimov.github.io/boostdep-report/master/program_options.html) | [![Documentation](https://img.shields.io/badge/docs-master-brightgreen.svg)](http://www.boost.org/doc/libs/master/doc/html/program_options.html) | [![Enter the Matrix](https://img.shields.io/badge/matrix-master-brightgreen.svg)](https://regression.boost.io/master/developer/program_options.html) 
+|[`develop`](https://github.com/boostorg/program_options/tree/develop) | [![Build Status](https://travis-ci.org/boostorg/program_options.svg?branch=develop)](https://travis-ci.org/boostorg/program_options) | [![Build status](https://ci.appveyor.com/api/projects/status/e0quisadwh1v7ok5/branch/develop?svg=true)](https://ci.appveyor.com/project/vprus/program-options/branch/develop) | [![codecov](https://codecov.io/gh/boostorg/program_options/branch/develop/graph/badge.svg)](https://codecov.io/gh/boostorg/program_options/branch/develop) | [![Deps](https://img.shields.io/badge/deps-develop-brightgreen.svg)](https://pdimov.github.io/boostdep-report/develop/program_options.html) | [![Documentation](https://img.shields.io/badge/docs-develop-brightgreen.svg)](http://www.boost.org/doc/libs/develop/doc/html/program_options.html) | [![Enter the Matrix](https://img.shields.io/badge/matrix-develop-brightgreen.svg)](https://regression.boost.io/develop/developer/program_options.html)
 
 ### Directories

--- a/appveyor.yml
+++ b/appveyor.yml
@@ -1,78 +1,68 @@
-# Copyright 2016, 2017 Peter Dimov
-# Copyright (C) 2017, 2018 James E. King III
+# Copyright 2016-2019 Peter Dimov
 # Distributed under the Boost Software License, Version 1.0.
 # (See accompanying file LICENSE_1_0.txt or copy at http://boost.org/LICENSE_1_0.txt)

-# When copying this to a new library, be sure to update the name of the library
-# in two places (once each at the top of install: and test_script:)
-
 version: 1.0.{build}-{branch}

 shallow_clone: true

 branches:
  only:
-    - develop
    - master
-
-matrix:
-  allow_failures:
-    - MAYFAIL: true
+    - develop
+    - /feature\/.*/

 environment:
-  global:
-    APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
-    # see: http://www.boost.org/build/doc/html/bbv2/overview/invocation.html#bbv2.overview.invocation.properties
-    # to use the default for a given environment, comment it out; recommend you build debug and release however..
-    # on Windows it is important to exercise all the possibilities, especially shared vs static
-    # B2_ADDRESS_MODEL: address-model=64,32
-    # B2_LINK: link=shared,static
-    # B2_THREADING: threading=multi,single
-    B2_VARIANT: variant=release,debug
-    CXXSTD: 03
-
  matrix:
-    - FLAVOR: Visual Studio 2017
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+      TOOLSET: msvc-14.0
+      CXXSTD: 14,latest
+      ADDRMD: 32,64
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
      TOOLSET: msvc-14.1
-      B2_ADDRESS_MODEL: address-model=64,32
-    - FLAVOR: Visual Studio 2013
-      APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2013
-      TOOLSET: msvc-12.0
-    - FLAVOR:  mingw32
-      ARCH:    i686
-      B2_ADDRESS_MODEL: address-model=32
-      SCRIPT:  ci\mingw.bat
-    - FLAVOR:  mingw64
-      ARCH:    x86_64
-      B2_ADDRESS_MODEL: address-model=64
-      SCRIPT:  ci\mingw.bat
-    - FLAVOR: cygwin (64-bit)
-      ADDPATH: C:\cygwin64\bin;
-      B2_ADDRESS_MODEL: address-model=64
-      TOOLSET: gcc
-      MAYFAIL: true
-    - FLAVOR: cygwin (32-bit)
+      CXXSTD: 14,17,latest
+      ADDRMD: 32,64
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
+      TOOLSET: clang-win
+      CXXSTD: 14,17,latest
+      ADDRMD: 64
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
+      TOOLSET: clang-win
+      CXXSTD: 14,17,20,latest
+      ADDRMD: 64
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
      ADDPATH: C:\cygwin\bin;
-      B2_ADDRESS_MODEL: address-model=32
      TOOLSET: gcc
-      MAYFAIL: true
+      CXXSTD: 11,14,1z
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
+      ADDPATH: C:\cygwin64\bin;
+      TOOLSET: gcc
+      CXXSTD: 11,14,1z
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
+      ADDPATH: C:\mingw-w64\i686-8.1.0-posix-dwarf-rt_v6-rev0\mingw32\bin;
+      TOOLSET: gcc
+      CXXSTD: 11,14,17,2a
+    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
+      ADDPATH: C:\mingw-w64\x86_64-8.1.0-posix-seh-rt_v6-rev0\mingw64\bin;
+      TOOLSET: gcc
+      CXXSTD: 11,14,17,2a

 install:
-  - set SELF=program_options
+  - set BOOST_BRANCH=develop
+  - if "%APPVEYOR_REPO_BRANCH%" == "master" set BOOST_BRANCH=master
  - cd ..
-  - git clone -b %APPVEYOR_REPO_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root
+  - git clone -b %BOOST_BRANCH% --depth 1 https://github.com/boostorg/boost.git boost-root
  - cd boost-root
-  - git submodule update -q --init tools/boostdep
-  - git submodule update -q --init tools/build
-  - git submodule update -q --init tools/inspect
-  - xcopy /s /e /q %APPVEYOR_BUILD_FOLDER% libs\%SELF%
-  - python tools/boostdep/depinst/depinst.py --include example %SELF%
+  - git submodule update --init tools/boostdep
+  - xcopy /s /e /q %APPVEYOR_BUILD_FOLDER% libs\program_options\
+  - python tools/boostdep/depinst/depinst.py program_options
  - cmd /c bootstrap
-  - b2 headers
+  - b2 -d0 headers

 build: off

 test_script:
-  - set SELF=program_options
  - PATH=%ADDPATH%%PATH%
-  - IF DEFINED SCRIPT (call libs\%SELF%\%SCRIPT%) ELSE (b2 libs/%SELF% toolset=%TOOLSET% cxxstd=%CXXSTD% %CXXFLAGS% %DEFINES% %B2_ADDRESS_MODEL% %B2_LINK% %B2_THREADING% %B2_VARIANT% -j3)
+  - if not "%CXXSTD%" == "" set CXXSTD=cxxstd=%CXXSTD%
+  - if not "%ADDRMD%" == "" set ADDRMD=address-model=%ADDRMD%
+  - b2 -j3 libs/program_options/test toolset=%TOOLSET% %CXXSTD% %ADDRMD% variant=debug,release
--- a/build.jam
+++ b/build.jam
@@ -0,0 +1,32 @@
+# Copyright René Ferdinand Rivera Morell 2023-2024
+# Distributed under 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)
+
+require-b2 5.2 ;
+
+constant boost_dependencies :
+    /boost/any//boost_any
+    /boost/config//boost_config
+    /boost/core//boost_core
+    /boost/detail//boost_detail
+    /boost/function//boost_function
+    /boost/iterator//boost_iterator
+    /boost/lexical_cast//boost_lexical_cast
+    /boost/smart_ptr//boost_smart_ptr
+    /boost/static_assert//boost_static_assert
+    /boost/throw_exception//boost_throw_exception
+    /boost/type_traits//boost_type_traits ;
+
+project /boost/program_options
+    ;
+
+explicit
+    [ alias boost_program_options : build//boost_program_options ]
+    [ alias all : boost_program_options example test ]
+    ;
+
+call-if : boost-library program_options
+    : install boost_program_options
+    ;
+
--- a/build/Jamfile.v2
+++ b/build/Jamfile.v2
@@ -1,16 +1,25 @@

-project boost/program_options 
-    : source-location ../src 
+constant boost_dependencies_private :
+    /boost/bind//boost_bind
+    /boost/tokenizer//boost_tokenizer
+    ;
+
+project
+    : source-location ../src
+    : common-requirements <include>../include <library>$(boost_dependencies)
+    : requirements <library>$(boost_dependencies_private)
    ;

 SOURCES =
-    cmdline config_file options_description parsers variables_map 
+    cmdline config_file options_description parsers variables_map
    value_semantic positional_options utf8_codecvt_facet
    convert winmain split
    ;

-boost-lib program_options
+lib boost_program_options
    : $(SOURCES).cpp
    : # See https://svn.boost.org/trac/boost/ticket/5049
      <target-os>hpux,<toolset>gcc:<define>_INCLUDE_STDC__SOURCE_199901
-    ;
+      <link>shared:<define>BOOST_PROGRAM_OPTIONS_DYN_LINK=1
+      <define>BOOST_PROGRAM_OPTIONS_NO_LIB=1
+    ;
--- a/doc/Jamfile.v2
+++ b/doc/Jamfile.v2
@@ -2,15 +2,15 @@
 import toolset ;
 toolset.using doxygen ;

-boostbook program_option 
-    : program_options.xml 
-    : <implicit-dependency>autodoc 
+boostbook program_option
+    : program_options.xml
+    : <implicit-dependency>autodoc
      <xsl:param>boost.root=../../../..
      <format>pdf:<xsl:param>boost.url.prefix=http://www.boost.org/doc/libs/release/doc/html
    ;

-doxygen autodoc 
-    : [ glob ../../../boost/program_options/*.hpp ] ;
+doxygen autodoc
+    : [ glob ../include/boost/program_options/*.hpp ] ;

 ###############################################################################
 alias boostdoc
--- a/doc/acknowledgements.xml
+++ b/doc/acknowledgements.xml
@@ -8,7 +8,7 @@
 <section>
  <title>Acknowledgements</title>

-  <para>I'm very gratefull to all the people who helped with the development, 
+  <para>I'm very grateful to all the people who helped with the development, 
    by discussion, fixes, and as users. It was pleasant
    to see all that involvement, which made the library much better than it
    would be otherwise.
@@ -25,7 +25,7 @@
  <para>The formal review lead to numerous comments and enhancements. Pavol
  Droba helped with the option description semantic. Gennadiy Rozental has
  criticised many aspects of the library which caused various simplifications.
-  Pavel Vozenilek did carefull review of the implementation. A number of
+  Pavel Vozenilek did careful review of the implementation. A number of
  comments were made by:
    <itemizedlist>
      <listitem><para>David Abrahams</para></listitem>
--- a/doc/design.xml
+++ b/doc/design.xml
@@ -74,7 +74,7 @@
      of the library -- ascii and Unicode.
    </para>

-    <para>Another important point is that ascii strings are passed though
+    <para>Another important point is that ascii strings are passed through
      without modification. In other words, it's not possible to just convert
      ascii to Unicode and process the Unicode further. The problem is that the
      default conversion mechanism -- the <code>codecvt</code> facet -- might
@@ -85,7 +85,7 @@
      don't support Unicode option names. Unicode support is hard and
      requires a Boost-wide solution. Even comparing two arbitrary Unicode
      strings is non-trivial. Finally, using Unicode in option names is
-      related to internationalization, which has it's own
+      related to internationalization, which has its own
      complexities. E.g. if option names depend on current locale, then all
      program parts and other parts which use the name must be
      internationalized too.
@@ -210,4 +210,4 @@
     sgml-parent-document: ("program_options.xml" "section")
     sgml-set-face: t
     End:
-->
+-->
--- a/doc/howto.xml
+++ b/doc/howto.xml
@@ -23,7 +23,7 @@ options groups/hidden options
    <title>Non-conventional Syntax</title>

    <para>Sometimes, standard command line syntaxes are not enough. For
-    example, the gcc compiler has "-frtti" and -fno-rtti" options, and this
+    example, the gcc compiler has "-frtti" and "-fno-rtti" options, and this
    syntax is not directly supported.
    </para>

@@ -66,7 +66,7 @@ store(command_line_parser(ac, av).options(desc).extra_parser(reg_foo)

    <indexterm><primary>response files</primary></indexterm>

-    <para>Some operating system have very low limits of the command line
+    <para>Some operating systems have very low limits of the command line
      length. The common way to work around those limitations is using
      <firstterm>response files</firstterm>.  A response file is just a
      configuration file which uses the same syntax as the command line. If
@@ -304,7 +304,7 @@ void validate(boost::any& v,
      for the value, and in this case is either empty or contains an instance of
      the <code>magic_number</code> class. The second is the list of strings
      found in the next occurrence of the option. The remaining two parameters
-      are needed to workaround the lack of partial template specialization and
+      are needed to work around the lack of partial template specialization and
      partial function template ordering on some compilers.
    </para>

@@ -346,7 +346,7 @@ void validate(boost::any& v,
    <emphasis>some</emphasis> Unicode-aware options. They are different from
    ordinary options in that they accept <code>wstring</code> input, and
    process it using wide character streams. Creating an Unicode-aware option
-    is easy: just use the the <code>wvalue</code> function instead of the
+    is easy: just use the <code>wvalue</code> function instead of the
    regular <code>value</code>.
    </para>

@@ -379,7 +379,7 @@ locale::global(locale(""));
      implementation, though. The quick test involves three steps:
      <orderedlist>
        <listitem>
-          <para>Go the the "test" directory and build the "test_convert" binary.</para>
+          <para>Go to the "test" directory and build the "test_convert" binary.</para>
        </listitem>
        <listitem>
          <para>Set some non-ascii locale in the environment. On Linux, one can
--- a/doc/overview.xml
+++ b/doc/overview.xml
@@ -50,7 +50,7 @@
    provides a class which stores all option values and that class can be
    freely passed around your program to modules which need access to the
    options. All the other components can be used only in the place where
-    the actual parsing is the done.  However, it might also make sense for the
+    the actual parsing is done.  However, it might also make sense for the
    individual program modules to describe their options and pass them to the
    main module, which will merge all options. Of course, this is only
    important when the number of options is large and declaring them in one
@@ -185,9 +185,9 @@ desc.add_options()
    ("email", value&lt;string&gt;()->multitoken(), "email to send to")
    ;
      </programlisting>
-      For the first parameter, we specify only the name and the
+      For the first option, we specify only the name and the
      description. No value can be specified in the parsed source.
-      For the first option, the user must specify a value, using a single
+      For the second option, the user must specify a value, using a single
      token. For the third option, the user may either provide a single token
      for the value, or no token at all. For the last option, the value can
      span several tokens. For example, the following command line is OK:
@@ -208,7 +208,7 @@ desc.add_options()
        <para>The description string has one or more paragraphs, separated by
        the newline character ('\n'). When an option is output, the library
        will compute the indentation for options's description. Each of the
-        paragraph is output as a separate line with that intentation. If
+        paragraph is output as a separate line with that indentation. If
        a paragraph does not fit on one line it is spanned over multiple
        lines (which will have the same indentation).
        </para>
@@ -538,7 +538,7 @@ desc.add_options()
      </para>

      <para>The environment variables can be parsed with the
-      &parse_environment; function. The function have several overloaded
+      &parse_environment; function. The function has several overloaded
      versions. The first parameter is always an &options_description;
      instance, and the second specifies what variables must be processed, and
      what option names must correspond to it. To describe the second
@@ -546,13 +546,13 @@ desc.add_options()
      variables.</para>

      <para>If you have an option that should be specified via environment
-      variable, you need make up the variable's name. To avoid name clashes,
+      variable, you need to make up the variable's name. To avoid name clashes,
      we suggest that you use a sufficiently unique prefix for environment
      variables. Also, while option names are most likely in lower case,
      environment variables conventionally use upper case. So, for an option
      name <literal>proxy</literal> the environment variable might be called
      <envar>BOOST_PROXY</envar>. During parsing, we need to perform reverse
-      conversion of the names. This is accomplished by passing the choosen
+      conversion of the names. This is accomplished by passing the chosen
      prefix as the second parameter of the &parse_environment; function.
      Say, if you pass <literal>BOOST_</literal> as the prefix, and there are
      two variables, <envar>CVSROOT</envar> and <envar>BOOST_PROXY</envar>, the
@@ -588,7 +588,7 @@ desc.add_options()
    representations that are available in C++ literals are not supported by
    lexical_cast, and thus will not work with program_options.</para>

-    <para>Booleans a special in that there are multiple ways to come at them. 
+    <para>Booleans are special in that there are multiple ways to come at them. 
    Similar to another value type, it can be specified as <code>("my-option",
    value&lt;bool&gt;())</code>, and then set as:</para>
    <screen>
@@ -648,7 +648,7 @@ example --other-switch

          <row>
            <entry>&parse_command_line;</entry>
-            <entry>parses command line (simpified interface)</entry>
+            <entry>parses command line (simplified interface)</entry>
          </row>

          <row>
--- a/doc/program_options.xml
+++ b/doc/program_options.xml
@@ -70,7 +70,7 @@
    </para>

    <para>
-      Now let's see some examples of the library usage in the <xref
+      Now let's see some examples of the library usage in <xref
      linkend="program_options.tutorial"/>.
    </para>
    
--- a/include/boost/program_options/cmdline.hpp
+++ b/include/boost/program_options/cmdline.hpp
@@ -9,7 +9,7 @@
 namespace boost { namespace program_options { namespace command_line_style {
    /** Various possible styles of options.
        
-    There are "long" options, which start with "--" and "short",
+    There are "long" options, which start with "--", and "short",
    which start with either "-" or "/". Both kinds can be allowed or
    disallowed, see allow_long and allow_short. The allowed character
    for short options is also configurable.
@@ -51,7 +51,7 @@ namespace boost { namespace program_options { namespace command_line_style {
        /** Allow to merge several short options together,
            so that "-s -k" become "-sk". All of the options
            but last should accept no parameter. For example, if
-            "-s" accept a parameter, then "k" will be taken as
+            "-s" accepts a parameter, then "k" will be taken as
            parameter, not another short option. 
            Dos-style short options cannot be sticky.
        */
--- a/include/boost/program_options/detail/config_file.hpp
+++ b/include/boost/program_options/detail/config_file.hpp
@@ -76,7 +76,7 @@ namespace boost { namespace program_options { namespace detail {
            const std::set<std::string>& allowed_options,
            bool allow_unregistered = false);

-        virtual ~common_config_file_iterator() {}
+        BOOST_DEFAULTED_FUNCTION(virtual ~common_config_file_iterator(), {})

    public: // Method required by eof_iterator
        
--- a/include/boost/program_options/detail/parsers.hpp
+++ b/include/boost/program_options/detail/parsers.hpp
@@ -24,7 +24,7 @@ namespace boost { namespace program_options {
    basic_command_line_parser<charT>::
    basic_command_line_parser(int argc, const charT* const argv[])
    : detail::cmdline(
-        to_internal(std::vector<std::basic_string<charT> >(argv+1, argv+argc))),
+        to_internal(std::vector<std::basic_string<charT> >(argc ? argv+1 : argv, argv+argc))),
        m_desc()
    {}

--- a/include/boost/program_options/detail/value_semantic.hpp
+++ b/include/boost/program_options/detail/value_semantic.hpp
@@ -8,6 +8,10 @@

 #include <boost/throw_exception.hpp>

+#ifndef BOOST_NO_CXX17_HDR_OPTIONAL
+#   include <optional>
+#endif
+
 // forward declaration
 namespace boost { template<class T> class optional; }

@@ -146,7 +150,7 @@ namespace boost { namespace program_options {
                boost::any a;
                std::vector<std::basic_string<charT> > cv;
                cv.push_back(s[i]);
-                validate(a, cv, (T*)0, 0);                
+                validate(a, cv, static_cast<T*>(nullptr), 0);                
                tv->push_back(boost::any_cast<T>(a));
            }
            catch(const bad_lexical_cast& /*e*/) {
@@ -165,10 +169,26 @@ namespace boost { namespace program_options {
        validators::check_first_occurrence(v);
        validators::get_single_string(s);
        boost::any a;
-        validate(a, s, (T*)0, 0);
+        validate(a, s, static_cast<T*>(nullptr), 0);
        v = boost::any(boost::optional<T>(boost::any_cast<T>(a)));
    }

+#ifndef BOOST_NO_CXX17_HDR_OPTIONAL
+    /** Validates std::optional arguments. */
+    template<class T, class charT>
+    void validate(boost::any& v,
+                  const std::vector<std::basic_string<charT> >& s,
+                  std::optional<T>*,
+                  int)
+    {
+        validators::check_first_occurrence(v);
+        validators::get_single_string(s);
+        boost::any a;
+        validate(a, s, static_cast<T*>(nullptr), 0);
+        v = boost::any(std::optional<T>(boost::any_cast<T>(a)));
+    }
+#endif
+
    template<class T, class charT>
    void 
    typed_value<T, charT>::
@@ -181,7 +201,7 @@ namespace boost { namespace program_options {
        if (new_tokens.empty() && !m_implicit_value.empty())
            value_store = m_implicit_value;
        else
-            validate(value_store, new_tokens, (T*)0, 0);
+            validate(value_store, new_tokens, static_cast<T*>(nullptr), 0);
    }

    template<class T>
--- a/include/boost/program_options/eof_iterator.hpp
+++ b/include/boost/program_options/eof_iterator.hpp
@@ -11,12 +11,12 @@
 namespace boost {

    /** The 'eof_iterator' class is useful for constructing forward iterators
-        in cases where iterator extract data from some source and it's easy
+        in cases where the iterator extracts data from some source and it's easy
        to detect 'eof' \-- i.e. the situation where there's no data. One
        apparent example is reading lines from a file.

        Implementing such iterators using 'iterator_facade' directly would
-        require to create class with three core operation, a couple of
+        require to create class with three core operations, a couple of
        constructors. When using 'eof_iterator', the derived class should define
        only one method to get new value, plus a couple of constructors.

--- a/include/boost/program_options/errors.hpp
+++ b/include/boost/program_options/errors.hpp
@@ -35,7 +35,7 @@ namespace boost { namespace program_options {
    }

    /** Base class for all errors in the library. */
-    class BOOST_PROGRAM_OPTIONS_DECL error : public std::logic_error {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE error : public std::logic_error {
    public:
        error(const std::string& xwhat) : std::logic_error(xwhat) {}
    };
@@ -44,15 +44,15 @@ namespace boost { namespace program_options {
    /** Class thrown when there are too many positional options. 
        This is a programming error.
    */
-    class BOOST_PROGRAM_OPTIONS_DECL too_many_positional_options_error : public error {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE too_many_positional_options_error : public error {
    public:
        too_many_positional_options_error() 
         : error("too many positional options have been specified on the command line") 
        {}
    };

-    /** Class thrown when there are programming error related to style */
-    class BOOST_PROGRAM_OPTIONS_DECL invalid_command_line_style : public error {
+    /** Class thrown when there are programming errors related to style */
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE invalid_command_line_style : public error {
    public:
        invalid_command_line_style(const std::string& msg)
        : error(msg)
@@ -60,7 +60,7 @@ namespace boost { namespace program_options {
    };

    /** Class thrown if config file can not be read */
-    class BOOST_PROGRAM_OPTIONS_DECL reading_file : public error {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE reading_file : public error {
    public:
        reading_file(const char* filename)
         : error(std::string("can not read options configuration file '").append(filename).append("'"))
@@ -83,7 +83,7 @@ namespace boost { namespace program_options {
     *  Options are displayed in "canonical" form
     *      This is the most unambiguous form of the
     *      *parsed* option name and would correspond to
-     *      option_description::format_name()
+     *      option_description::format_name(),
     *      i.e. what is shown by print_usage()
     *  
     *  The "canonical" form depends on whether the option is
@@ -91,7 +91,7 @@ namespace boost { namespace program_options {
     *      or without a prefix (from a configuration file)
     *  
     *   */
-    class BOOST_PROGRAM_OPTIONS_DECL error_with_option_name : public error {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE error_with_option_name : public error {

    protected:
        /** can be
@@ -110,18 +110,18 @@ namespace boost { namespace program_options {
        std::map<std::string, string_pair > m_substitution_defaults;

    public:
-		/** template with placeholders */
-		std::string m_error_template;
+        /** template with placeholders */
+        std::string m_error_template;

-		error_with_option_name(const std::string& template_,
-                              const std::string& option_name = "",
-                              const std::string& original_token = "",
-                              int option_style               = 0);
+        error_with_option_name(const std::string& template_,
+                               const std::string& option_name = "",
+                               const std::string& original_token = "",
+                               int option_style = 0);

        /** gcc says that throw specification on dtor is loosened 
         *  without this line                                     
         *  */ 
-        ~error_with_option_name() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~error_with_option_name() BOOST_NOEXCEPT_OR_NOTHROW, {})


        //void dump() const
@@ -183,7 +183,7 @@ namespace boost { namespace program_options {

        /** Creates the error_message on the fly
         *      Currently a thin wrapper for substitute_placeholders() */
-        virtual const char* what() const throw();
+        virtual const char* what() const BOOST_NOEXCEPT_OR_NOTHROW override;

    protected:
        /** Used to hold the error text returned by what() */
@@ -204,28 +204,28 @@ namespace boost { namespace program_options {

    /** Class thrown when there are several option values, but
        user called a method which cannot return them all. */
-    class BOOST_PROGRAM_OPTIONS_DECL multiple_values : public error_with_option_name {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE multiple_values : public error_with_option_name {
    public:
        multiple_values() 
         : error_with_option_name("option '%canonical_option%' only takes a single argument"){}

-        ~multiple_values() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~multiple_values() BOOST_NOEXCEPT_OR_NOTHROW, {})
    };

    /** Class thrown when there are several occurrences of an
        option, but user called a method which cannot return 
        them all. */
-    class BOOST_PROGRAM_OPTIONS_DECL multiple_occurrences : public error_with_option_name {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE multiple_occurrences : public error_with_option_name {
    public:
        multiple_occurrences() 
         : error_with_option_name("option '%canonical_option%' cannot be specified more than once"){}

-        ~multiple_occurrences() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~multiple_occurrences() BOOST_NOEXCEPT_OR_NOTHROW, {})

    };

    /** Class thrown when a required/mandatory option is missing */
-    class BOOST_PROGRAM_OPTIONS_DECL required_option : public error_with_option_name {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE required_option : public error_with_option_name {
    public:
       // option name is constructed by the option_descriptor and never on the fly
       required_option(const std::string& option_name)
@@ -233,7 +233,7 @@ namespace boost { namespace program_options {
       {
       }

-       ~required_option() throw() {}
+       BOOST_DEFAULTED_FUNCTION(~required_option() BOOST_NOEXCEPT_OR_NOTHROW, {})
    };

    /** Base class of unparsable options,
@@ -243,11 +243,11 @@ namespace boost { namespace program_options {
     *  It makes no sense to have an option name, when we can't match an option to the
     *      parameter
     *  
-     *  Having this a part of the error_with_option_name hierachy makes error handling
+     *  Having this as part of the error_with_option_name hierarchy makes error handling
     *      a lot easier, even if the name indicates some sort of conceptual dissonance!
     *  
     *   */
-    class BOOST_PROGRAM_OPTIONS_DECL error_with_no_option_name : public error_with_option_name {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE error_with_no_option_name : public error_with_option_name {
    public:
        error_with_no_option_name(const std::string& template_,
                              const std::string& original_token = "")
@@ -256,40 +256,40 @@ namespace boost { namespace program_options {
        }

        /** Does NOT set option name, because no option name makes sense */
-        virtual void set_option_name(const std::string&) {}
+        virtual void set_option_name(const std::string&) override {}

-        ~error_with_no_option_name() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~error_with_no_option_name() BOOST_NOEXCEPT_OR_NOTHROW, {})
    };


    /** Class thrown when option name is not recognized. */
-    class BOOST_PROGRAM_OPTIONS_DECL unknown_option : public error_with_no_option_name {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE unknown_option : public error_with_no_option_name {
    public:
        unknown_option(const std::string& original_token = "")
        : error_with_no_option_name("unrecognised option '%canonical_option%'", original_token)
        {
        }

-        ~unknown_option() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~unknown_option() BOOST_NOEXCEPT_OR_NOTHROW, {})
    };



-    /** Class thrown when there's ambiguity amoung several possible options. */
-    class BOOST_PROGRAM_OPTIONS_DECL ambiguous_option : public error_with_no_option_name {
+    /** Class thrown when there's ambiguity among several possible options. */
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE ambiguous_option : public error_with_no_option_name {
    public:
        ambiguous_option(const std::vector<std::string>& xalternatives)
        : error_with_no_option_name("option '%canonical_option%' is ambiguous"),
            m_alternatives(xalternatives)
        {}

-        ~ambiguous_option() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~ambiguous_option() BOOST_NOEXCEPT_OR_NOTHROW, {})

-        const std::vector<std::string>& alternatives() const throw() {return m_alternatives;}
+        const std::vector<std::string>& alternatives() const BOOST_NOEXCEPT_OR_NOTHROW {return m_alternatives;}

    protected:
        /** Makes all substitutions using the template */
-        virtual void substitute_placeholders(const std::string& error_template) const;
+        virtual void substitute_placeholders(const std::string& error_template) const override;
    private:
        // TODO: copy ctor might throw
        std::vector<std::string> m_alternatives;
@@ -299,7 +299,7 @@ namespace boost { namespace program_options {
    /** Class thrown when there's syntax error either for command
     *  line or config file options. See derived children for
     *  concrete classes. */
-    class BOOST_PROGRAM_OPTIONS_DECL invalid_syntax : public error_with_option_name {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE invalid_syntax : public error_with_option_name {
    public:
        enum kind_t {
            long_not_allowed = 30,
@@ -320,7 +320,7 @@ namespace boost { namespace program_options {
        {
        }

-        ~invalid_syntax() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~invalid_syntax() BOOST_NOEXCEPT_OR_NOTHROW, {})

        kind_t kind() const {return m_kind;}

@@ -332,7 +332,7 @@ namespace boost { namespace program_options {
        kind_t m_kind;
    };

-    class BOOST_PROGRAM_OPTIONS_DECL invalid_config_file_syntax : public invalid_syntax {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE invalid_config_file_syntax : public invalid_syntax {
    public:
        invalid_config_file_syntax(const std::string& invalid_line, kind_t kind):
            invalid_syntax(kind)
@@ -340,27 +340,27 @@ namespace boost { namespace program_options {
            m_substitutions["invalid_line"] = invalid_line;
        }

-        ~invalid_config_file_syntax() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~invalid_config_file_syntax() BOOST_NOEXCEPT_OR_NOTHROW, {})

        /** Convenience functions for backwards compatibility */
-        virtual std::string tokens() const {return m_substitutions.find("invalid_line")->second;    }
+        virtual std::string tokens() const override {return m_substitutions.find("invalid_line")->second;    }
    };


    /** Class thrown when there are syntax errors in given command line */
-    class BOOST_PROGRAM_OPTIONS_DECL invalid_command_line_syntax : public invalid_syntax {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE invalid_command_line_syntax : public invalid_syntax {
    public:
        invalid_command_line_syntax(kind_t kind,
                       const std::string& option_name = "",
                       const std::string& original_token = "",
                       int option_style              = 0):
            invalid_syntax(kind, option_name, original_token, option_style) {}
-        ~invalid_command_line_syntax() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~invalid_command_line_syntax() BOOST_NOEXCEPT_OR_NOTHROW, {})
    };


    /** Class thrown when value of option is incorrect. */
-    class BOOST_PROGRAM_OPTIONS_DECL validation_error : public error_with_option_name {
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE validation_error : public error_with_option_name {
    public:
        enum kind_t {
            multiple_values_not_allowed = 30,
@@ -380,7 +380,7 @@ namespace boost { namespace program_options {
        {
        }

-        ~validation_error() throw() {}
+        BOOST_DEFAULTED_FUNCTION(~validation_error() BOOST_NOEXCEPT_OR_NOTHROW, {})

        kind_t kind() const { return m_kind; }

@@ -391,7 +391,7 @@ namespace boost { namespace program_options {
    };

    /** Class thrown if there is an invalid option value given */
-    class BOOST_PROGRAM_OPTIONS_DECL invalid_option_value 
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE invalid_option_value
        : public validation_error
    {
    public:
@@ -402,7 +402,7 @@ namespace boost { namespace program_options {
    };

    /** Class thrown if there is an invalid bool value given */
-    class BOOST_PROGRAM_OPTIONS_DECL invalid_bool_value 
+    class BOOST_PROGRAM_OPTIONS_DECL BOOST_SYMBOL_VISIBLE invalid_bool_value
        : public validation_error
    {
    public:
--- a/include/boost/program_options/options_description.hpp
+++ b/include/boost/program_options/options_description.hpp
@@ -105,7 +105,7 @@ namespace program_options {


        /** Returns the canonical name for the option description to enable the user to
-            recognised a matching option.
+            recognise a matching option.
            1) For short options ('-', '/'), returns the short name prefixed.
            2) For long options ('--' / '-') returns the first long name prefixed
            3) All other cases, returns the first long name (if present) or the short
--- a/include/boost/program_options/parsers.hpp
+++ b/include/boost/program_options/parsers.hpp
@@ -30,7 +30,7 @@ namespace boost { namespace program_options {

    /** Results of parsing an input source.
        The primary use of this class is passing information from parsers
-        component to value storage component. This class does not makes
+        component to value storage component. This class does not make
        much sense itself.
    */
    template<class charT>
@@ -48,7 +48,7 @@ namespace boost { namespace program_options {
        const options_description* description;

        /** Mainly used for the diagnostic messages in exceptions.
-         *  The canonical option prefix  for the parser which generated these results,
+         *  The canonical option prefix for the parser which generated these results,
         *  depending on the settings for basic_command_line_parser::style() or
         *  cmdline::style(). In order of precedence of command_line_style enums:
         *      allow_long
@@ -77,7 +77,7 @@ namespace boost { namespace program_options {
        basic_parsed_options<char> utf8_encoded_options;

        /** Mainly used for the diagnostic messages in exceptions.
-         *  The canonical option prefix  for the parser which generated these results,
+         *  The canonical option prefix for the parser which generated these results,
         *  depending on the settings for basic_command_line_parser::style() or
         *  cmdline::style(). In order of precedence of command_line_style enums:
         *      allow_long
@@ -120,7 +120,11 @@ namespace boost { namespace program_options {
        basic_command_line_parser(const std::vector<
                                  std::basic_string<charT> >& args);
        /** Creates a command line parser for the specified arguments
-            list. The parameters should be the same as passed to 'main'.
+            list. The parameters should be the same as passed to 'main', meaning:
+            @param argc Must be non-negative i.e. >= 0
+            @param argv Argv[argc] must be 0 e.g. nullptr and
+            if argc is >0 argv[0] up to argv[argc-1] must point to
+            null terminated strings
        */
        basic_command_line_parser(int argc, const charT* const argv[]);

@@ -146,7 +150,7 @@ namespace boost { namespace program_options {
            instance of basic_option<charT> will be added to result,
            with 'unrecognized' field set to 'true'. It's possible to
            collect all unrecognized options with the 'collect_unrecognized'
-            funciton.
+            function.
        */
        basic_command_line_parser& allow_unregistered();

@@ -210,7 +214,7 @@ namespace boost { namespace program_options {
    /** Collects the original tokens for all named options with
        'unregistered' flag set. If 'mode' is 'include_positional'
        also collects all positional options.
-        Returns the vector of origianl tokens for all collected
+        Returns the vector of original tokens for all collected
        options.
    */
    template<class charT>
@@ -250,8 +254,8 @@ namespace boost { namespace program_options {

    /** Splits a given string to a collection of single strings which
        can be passed to command_line_parser. The second parameter is
-        used to specify a collection of possible seperator chars used
-        for splitting. The seperator is defaulted to space " ".
+        used to specify a collection of possible separator chars used
+        for splitting. The separator is defaulted to space " ".
        Splitting is done in a unix style way, with respect to quotes '"'
        and escape characters '\'
    */
--- a/include/boost/program_options/positional_options.hpp
+++ b/include/boost/program_options/positional_options.hpp
@@ -37,7 +37,7 @@ namespace boost { namespace program_options {
    public:
        positional_options_description();

-        /** Species that up to 'max_count' next positional options
+        /** Specifies that up to 'max_count' next positional options
            should be given the 'name'. The value of '-1' means 'unlimited'. 
            No calls to 'add' can be made after call with 'max_value' equal to 
            '-1'.            
--- a/include/boost/program_options/value_semantic.hpp
+++ b/include/boost/program_options/value_semantic.hpp
@@ -51,7 +51,7 @@ namespace boost { namespace program_options {
        
        /** Parses a group of tokens that specify a value of option.
            Stores the result in 'value_store', using whatever representation
-            is desired. May be be called several times if value of the same
+            is desired. May be called several times if value of the same
            option is specified more than once.
        */
        virtual void parse(boost::any& value_store, 
@@ -71,7 +71,7 @@ namespace boost { namespace program_options {
        virtual ~value_semantic() {}
    };

-    /** Helper class which perform necessary character conversions in the 
+    /** Helper class which performs necessary character conversions in the 
        'parse' method and forwards the data further.
    */
    template<class charT>
@@ -92,7 +92,7 @@ namespace boost { namespace program_options {
    private: // base overrides
        void parse(boost::any& value_store, 
                   const std::vector<std::string>& new_tokens,
-                   bool utf8) const;
+                   bool utf8) const override;
    protected: // interface for derived classes.
        virtual void xparse(boost::any& value_store, 
                            const std::vector<std::string>& new_tokens) 
@@ -112,7 +112,7 @@ namespace boost { namespace program_options {
    private: // base overrides
        void parse(boost::any& value_store, 
                   const std::vector<std::string>& new_tokens,
-                   bool utf8) const;
+                   bool utf8) const override;
    protected: // interface for derived classes.
 #if !defined(BOOST_NO_STD_WSTRING)
        virtual void xparse(boost::any& value_store, 
@@ -130,34 +130,34 @@ namespace boost { namespace program_options {
        : m_zero_tokens(zero_tokens)
        {}

-        std::string name() const;
+        std::string name() const override;

-        unsigned min_tokens() const;
-        unsigned max_tokens() const;
+        unsigned min_tokens() const override;
+        unsigned max_tokens() const override;

-        bool is_composing() const { return false; }
+        bool is_composing() const override { return false; }

-        bool is_required() const { return false; }
+        bool is_required() const override { return false; }
        
        /** If 'value_store' is already initialized, or new_tokens
-            has more than one elements, throws. Otherwise, assigns
+            has more than one element, throws. Otherwise, assigns
            the first string from 'new_tokens' to 'value_store', without
            any modifications.
         */
        void xparse(boost::any& value_store,
-                    const std::vector<std::string>& new_tokens) const;
+                    const std::vector<std::string>& new_tokens) const override;

        /** Does nothing. */
-        bool apply_default(boost::any&) const { return false; }
+        bool apply_default(boost::any&) const override { return false; }

        /** Does nothing. */
-        void notify(const boost::any&) const {}        
+        void notify(const boost::any&) const override {}
    private:
        bool m_zero_tokens;
    };

 #ifndef BOOST_NO_RTTI
-    /** Base class for all option that have a fixed type, and are
+    /** Base class for all options that have a fixed type, and are
        willing to announce this type to the outside world.
        Any 'value_semantics' for which you want to find out the
        type can be dynamic_cast-ed to typed_value_base. If conversion
@@ -218,7 +218,7 @@ namespace boost { namespace program_options {

        /** Specifies an implicit value, which will be used
            if the option is given, but without an adjacent value.
-            Using this implies that an explicit value is optional,
+            Using this implies that an explicit value is optional.
        */
        typed_value* implicit_value(const T &v)
        {
@@ -228,7 +228,7 @@ namespace boost { namespace program_options {
            return this;
        }

-        /** Specifies the name used to to the value in help message.  */
+        /** Specifies the name used for the value in the help message.  */
        typed_value* value_name(const std::string& name)
        {
            m_value_name = name;
@@ -278,7 +278,7 @@ namespace boost { namespace program_options {
        }

        /** Specifies that no tokens may be provided as the value of
-            this option, which means that only presense of the option
+            this option, which means that only presence of the option
            is significant. For such option to be useful, either the
            'validate' function should be specialized, or the 
            'implicit_value' method should be also used. In most
@@ -299,11 +299,11 @@ namespace boost { namespace program_options {

    public: // value semantic overrides

-        std::string name() const;
+        std::string name() const override;

-        bool is_composing() const { return m_composing; }
+        bool is_composing() const override { return m_composing; }

-        unsigned min_tokens() const
+        unsigned min_tokens() const override
        {
            if (m_zero_tokens || !m_implicit_value.empty()) {
                return 0;
@@ -312,7 +312,7 @@ namespace boost { namespace program_options {
            }
        }

-        unsigned max_tokens() const {
+        unsigned max_tokens() const override {
            if (m_multitoken) {
                return std::numeric_limits<unsigned>::max BOOST_PREVENT_MACRO_SUBSTITUTION();
            } else if (m_zero_tokens) {
@@ -322,19 +322,19 @@ namespace boost { namespace program_options {
            }
        }

-        bool is_required() const { return m_required; }
+        bool is_required() const override { return m_required; }

        /** Creates an instance of the 'validator' class and calls
            its operator() to perform the actual conversion. */
        void xparse(boost::any& value_store, 
                    const std::vector< std::basic_string<charT> >& new_tokens) 
-            const;
+            const override;

        /** If default value was specified via previous call to 
            'default_value', stores that value into 'value_store'.
            Returns true if default value was stored.
        */
-        virtual bool apply_default(boost::any& value_store) const
+        virtual bool apply_default(boost::any& value_store) const override
        {
            if (m_default_value.empty()) {
                return false;
@@ -347,12 +347,12 @@ namespace boost { namespace program_options {
        /** If an address of variable to store value was specified
            when creating *this, stores the value there. Otherwise,
            does nothing. */
-        void notify(const boost::any& value_store) const;
+        void notify(const boost::any& value_store) const override;

    public: // typed_value_base overrides
        
 #ifndef BOOST_NO_RTTI
-        const std::type_info& value_type() const
+        const std::type_info& value_type() const override
        {
            return typeid(T);
        }
--- a/include/boost/program_options/variables_map.hpp
+++ b/include/boost/program_options/variables_map.hpp
@@ -62,7 +62,7 @@ namespace boost { namespace program_options {
        : v(xv), m_defaulted(xdefaulted)
        {}

-        /** If stored value if of type T, returns that value. Otherwise,
+        /** If stored value is of type T, returns that value. Otherwise,
            throws boost::bad_any_cast exception. */
       template<class T>
       const T& as() const {
@@ -138,7 +138,7 @@ namespace boost { namespace program_options {
        const abstract_variables_map* m_next;
    };

-    /** Concrete variables map which store variables in real map.
+    /** Concrete variables map which stores variables in real map.

        This class is derived from std::map<std::string, variable_value>,
        so you can use all map operators to examine its content.
@@ -162,7 +162,7 @@ namespace boost { namespace program_options {
    private:
        /** Implementation of abstract_variables_map::get
            which does 'find' in *this. */
-        const variable_value& get(const std::string& name) const;
+        const variable_value& get(const std::string& name) const override;

        /** Names of option with 'final' values \-- which should not
            be changed by subsequence assignments. */
--- a/meta/libraries.json
+++ b/meta/libraries.json
@@ -11,5 +11,6 @@
    ],
    "maintainers": [
        "Vladimir Prus <vladimir.prus -at- gmail.com>"
-    ]
+    ],
+    "cxxstd": "11"
 }
--- a/src/cmdline.cpp
+++ b/src/cmdline.cpp
@@ -3,7 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>

 #include <boost/config.hpp>
@@ -15,7 +17,7 @@
 #include <boost/program_options/positional_options.hpp>
 #include <boost/throw_exception.hpp>

-#include <boost/bind.hpp>
+#include <boost/bind/bind.hpp>

 #include <string>
 #include <utility>
@@ -29,6 +31,8 @@

 #include <iostream>

+using namespace boost::placeholders;
+
 namespace boost { namespace program_options {

    using namespace std;
--- a/src/config_file.cpp
+++ b/src/config_file.cpp
@@ -3,8 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-
-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>

 #include <boost/program_options/detail/config_file.hpp>
--- a/src/convert.cpp
+++ b/src/convert.cpp
@@ -13,15 +13,18 @@

 #include <boost/config.hpp>

-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>
 #include <boost/program_options/detail/convert.hpp>
 #include <boost/program_options/detail/utf8_codecvt_facet.hpp>
 #include <boost/throw_exception.hpp>

-#include <boost/bind.hpp>
+#include <boost/bind/bind.hpp>

 using namespace std;
+using namespace boost::placeholders;

 namespace boost { namespace detail {

--- a/src/options_description.cpp
+++ b/src/options_description.cpp
@@ -4,8 +4,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-
-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>
 #include <boost/program_options/options_description.hpp>
 // FIXME: this is only to get multiple_occurrences class
--- a/src/parsers.cpp
+++ b/src/parsers.cpp
@@ -6,7 +6,9 @@

 #include <boost/config.hpp>

-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>
 #include <boost/program_options/parsers.hpp>
 #include <boost/program_options/options_description.hpp>
@@ -16,7 +18,7 @@
 #include <boost/program_options/environment_iterator.hpp>
 #include <boost/program_options/detail/convert.hpp>

-#include <boost/bind.hpp>
+#include <boost/bind/bind.hpp>
 #include <boost/throw_exception.hpp>

 #include <cctype>
@@ -61,6 +63,7 @@ extern char** environ;
 #endif

 using namespace std;
+using namespace boost::placeholders;

 namespace boost { namespace program_options {

@@ -152,7 +155,16 @@ namespace boost { namespace program_options {
        {
            boost::throw_exception(reading_file(filename));
        }
-        return parse_config_file(strm, desc, allow_unregistered);
+
+        basic_parsed_options<charT> result
+                = parse_config_file(strm, desc, allow_unregistered);
+
+        if (strm.bad())
+        {
+            boost::throw_exception(reading_file(filename));
+        }
+
+        return result;
    }

    template
--- a/src/positional_options.cpp
+++ b/src/positional_options.cpp
@@ -3,7 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>

 #include <boost/program_options/positional_options.hpp>
--- a/src/split.cpp
+++ b/src/split.cpp
@@ -3,7 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif

 #include <boost/program_options/parsers.hpp>
 #include <boost/tokenizer.hpp>
--- a/src/utf8_codecvt_facet.cpp
+++ b/src/utf8_codecvt_facet.cpp
@@ -3,7 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>

 #define BOOST_UTF8_BEGIN_NAMESPACE \
--- a/src/value_semantic.cpp
+++ b/src/value_semantic.cpp
@@ -3,7 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>
 #include <boost/program_options/value_semantic.hpp>
 #include <boost/program_options/detail/convert.hpp>
@@ -258,7 +260,7 @@ namespace boost { namespace program_options {
    }


-    const char* error_with_option_name::what() const throw()
+    const char* error_with_option_name::what() const BOOST_NOEXCEPT_OR_NOTHROW
    {
        // will substitute tokens each time what is run()
        substitute_placeholders(m_error_template);
--- a/src/variables_map.cpp
+++ b/src/variables_map.cpp
@@ -3,8 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-
-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/config.hpp>
 #include <boost/program_options/parsers.hpp>
 #include <boost/program_options/options_description.hpp>
--- a/src/winmain.cpp
+++ b/src/winmain.cpp
@@ -3,7 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

-#define BOOST_PROGRAM_OPTIONS_SOURCE
+#ifndef BOOST_PROGRAM_OPTIONS_SOURCE
+# define BOOST_PROGRAM_OPTIONS_SOURCE
+#endif
 #include <boost/program_options/parsers.hpp>
 #include <cctype>

--- a/test/CMakeLists.txt
+++ b/test/CMakeLists.txt
@@ -0,0 +1,27 @@
+# Copyright 2018-2020 Peter Dimov
+# Distributed under 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
+
+include(BoostTest OPTIONAL RESULT_VARIABLE HAVE_BOOST_TEST)
+
+if(NOT HAVE_BOOST_TEST)
+  return()
+endif()
+
+set(BOOST_TEST_LINK_LIBRARIES Boost::program_options)
+
+boost_test(TYPE run SOURCES options_description_test.cpp)
+boost_test(TYPE run SOURCES parsers_test.cpp ARGUMENTS ${CMAKE_CURRENT_SOURCE_DIR}/config_test.cfg)
+boost_test(TYPE run SOURCES variable_map_test.cpp)
+boost_test(TYPE run SOURCES cmdline_test.cpp)
+boost_test(TYPE run SOURCES positional_options_test.cpp)
+boost_test(TYPE run SOURCES unicode_test.cpp)
+boost_test(TYPE run SOURCES winmain.cpp)
+boost_test(TYPE run SOURCES exception_test.cpp)
+boost_test(TYPE run SOURCES split_test.cpp)
+boost_test(TYPE run SOURCES unrecognized_test.cpp)
+boost_test(TYPE run SOURCES required_test.cpp ARGUMENTS ${CMAKE_CURRENT_SOURCE_DIR}/required_test.cfg)
+boost_test(TYPE run SOURCES exception_txt_test.cpp)
+boost_test(TYPE run SOURCES optional_test.cpp)
+
+boost_test(TYPE run SOURCES quick.cpp ARGUMENTS --path=initial LINK_LIBRARIES Boost::core)
--- a/test/Jamfile.v2
+++ b/test/Jamfile.v2
@@ -35,10 +35,10 @@ test-suite program_options :
    [ po-test required_test.cpp : required_test.cfg ]
    [ po-test exception_txt_test.cpp ]
    [ po-test optional_test.cpp ]
-    [ run options_description_test.cpp : : : <rtti>off <define>BOOST_NO_RTTI <define>BOOST_NO_TYPEID : options_description_no_rtti_test ]
+    [ run options_description_test.cpp : : : <rtti>off : options_description_no_rtti_test ]
    ;
        
-exe test_convert : test_convert.cpp ;   
+exe test_convert : test_convert.cpp /boost/timer//boost_timer ;

 # `quick` target (for CI)
 run quick.cpp : --path=initial ;
--- a/test/cmake_install_test/CMakeLists.txt
+++ b/test/cmake_install_test/CMakeLists.txt
@@ -0,0 +1,18 @@
+# Copyright 2018, 2019 Peter Dimov
+# Distributed under 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
+
+cmake_minimum_required(VERSION 3.5...3.16)
+
+project(cmake_install_test LANGUAGES CXX)
+
+find_package(boost_program_options REQUIRED)
+find_package(boost_core REQUIRED)
+
+add_executable(quick ../quick.cpp)
+target_link_libraries(quick Boost::program_options Boost::core)
+
+enable_testing()
+add_test(NAME quick COMMAND quick --path=initial)
+
+add_custom_target(check COMMAND ${CMAKE_CTEST_COMMAND} --output-on-failure -C $<CONFIG>)
--- a/test/cmake_subdir_test/CMakeLists.txt
+++ b/test/cmake_subdir_test/CMakeLists.txt
@@ -0,0 +1,18 @@
+# Copyright 2018, 2019 Peter Dimov
+# Distributed under 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
+
+cmake_minimum_required(VERSION 3.5...3.16)
+
+project(cmake_subdir_test LANGUAGES CXX)
+
+set(BOOST_INCLUDE_LIBRARIES program_options)
+add_subdirectory(../../../.. boostorg/boost)
+
+add_executable(quick ../quick.cpp)
+target_link_libraries(quick Boost::program_options Boost::core)
+
+enable_testing()
+add_test(NAME quick COMMAND quick --path=initial)
+
+add_custom_target(check COMMAND ${CMAKE_CTEST_COMMAND} --output-on-failure -C $<CONFIG>)
--- a/test/exception_txt_test.cpp
+++ b/test/exception_txt_test.cpp
@@ -152,7 +152,7 @@ void test_invalid_option_value_exception_msg()
 {
    options_description desc;
    desc.add_options()
-        ("int-option,d", value< int >(),	"An option taking an integer")
+        ("int-option,d", value< int >(),        "An option taking an integer")
    ;

    vector<vector<const char*> > argv;
@@ -308,7 +308,7 @@ void test_invalid_bool_value_exception_msg()
 {
    options_description desc; 
    desc.add_options()
-        ("bool_option,b",	value< bool>(),	"bool_option")
+        ("bool_option,b",       value< bool>(), "bool_option")
        ;


--- a/test/optional_test.cpp
+++ b/test/optional_test.cpp
@@ -7,6 +7,9 @@ namespace po = boost::program_options;

 #include <boost/optional.hpp>

+#ifndef BOOST_NO_CXX17_HDR_OPTIONAL
+#   include <optional>
+#endif
 #include <string>

 #include "minitest.hpp"
@@ -19,9 +22,10 @@ std::vector<std::string> sv(const char* array[], unsigned size)
    return r;
 }

+template<template<typename> class OptionalType>
 void test_optional()
 {
-    boost::optional<int> foo, bar, baz;
+    OptionalType<int> foo, bar, baz;

    po::options_description desc;
    desc.add_options()
@@ -48,6 +52,9 @@ void test_optional()

 int main(int, char*[])
 {
-    test_optional();
+    test_optional<boost::optional>();
+#ifndef BOOST_NO_CXX17_HDR_OPTIONAL
+    test_optional<std::optional>();
+#endif
    return 0;
 }
--- a/test/parsers_test.cpp
+++ b/test/parsers_test.cpp
@@ -300,6 +300,10 @@ void test_config_file(const char* config_file)
    check_value(a2[6], "m1.v3", "3");
 }

+#if defined(__CYGWIN__)
+  extern "C" int putenv (char *__string);
+#endif
+
 void test_environment()
 {
    options_description desc;
@@ -308,7 +312,7 @@ void test_environment()
        ("bar", new untyped_value, "")
        ;

-#if (defined(_WIN32) && ! defined(__BORLANDC__)) || (defined(__CYGWIN__))
+#if defined(_WIN32) && ! defined(BOOST_BORLANDC) && ! defined(BOOST_EMBTC)
    _putenv("PO_TEST_FOO=1");
 #else
    putenv(const_cast<char*>("PO_TEST_FOO=1"));
--- a/test/test_convert.cpp
+++ b/test/test_convert.cpp
@@ -3,6 +3,9 @@
 // (See accompanying file LICENSE_1_0.txt
 // or copy at http://www.boost.org/LICENSE_1_0.txt)

+// This will eventually stop working when <boost/progress.hpp> is removed
+#define BOOST_TIMER_ENABLE_DEPRECATED
+
 #include <cstring>
 #include <cassert>
 #include <string>
--- a/test/winmain.cpp
+++ b/test/winmain.cpp
@@ -9,13 +9,12 @@
 #include <cctype>
 #include <iostream>
 #include <stdlib.h>
+#include <boost/program_options/parsers.hpp>

 using namespace std;
-
-#include <boost/program_options/parsers.hpp>
 using namespace boost::program_options;

-void check_equal(const std::vector<string>& actual, char **expected, int n)
+void check_equal(const std::vector<string>& actual, const char **expected, int n)
 {
    if (actual.size() != n)
    {
@@ -39,7 +38,7 @@ void test_winmain()

 #define C ,
 #define TEST(input, expected) \
-    char* BOOST_PP_CAT(e, __LINE__)[] = expected;\
+    const char* BOOST_PP_CAT(e, __LINE__)[] = expected;\
    vector<string> BOOST_PP_CAT(v, __LINE__) = split_winmain(input);\
    check_equal(BOOST_PP_CAT(v, __LINE__), BOOST_PP_CAT(e, __LINE__),\
                sizeof(BOOST_PP_CAT(e, __LINE__))/sizeof(char*));
Author	SHA1	Message	Date
Vladimir Prus	902aaedaaa	overview.xml: clarify wording	2025-09-13 10:38:35 +01:00
Marcos Simental	6b2bc88964	Fix listing typo (#130 ) The paragraph lists a couple of options and expands information on each element. However, the following explanation lists the first element, the first, the third, and the last, whereas the logic of the discussion aims to explain the listing as first, second, third, and last elements.	2025-09-13 10:36:14 +01:00
bmagistro	5fd247085c	Add override on overriden functions for c++11 (#145 ) Signed-off-by: Ben Magistro <koncept1@gmail.com>	2025-09-12 16:21:44 +01:00
ivanpanch	4287ba32b7	docs: correct spelling and grammar	2025-08-27 23:08:03 +01:00
Alexander Grund	fd4a02f7e9	Update Link to regression test matrix in README (#148 )	2025-08-25 16:44:05 +01:00
bmagistro	18e51b74d4	Update to modern style cast (#143 ) Signed-off-by: Ben Magistro <koncept1@gmail.com>	2025-08-19 13:09:23 +01:00
Peter Dimov	6ccf63be0e	Merge pull request #138 from grafikrobot/modular Add support for modular build structure.	2025-05-02 19:16:19 +03:00
Rene Rivera	96078fd217	Move include to target.	2025-04-17 09:08:04 -05:00
Rene Rivera	43f34bebc7	Bump some containers to get correct compilers.	2025-04-12 22:39:12 -05:00
Rene Rivera	fed4374934	Fix name of some containers.	2025-04-12 22:06:58 -05:00
Rene Rivera	a403a4014c	Need some utils for the node20 install.	2025-04-12 21:59:05 -05:00
Rene Rivera	87c0d641fd	Tweak to use mostly containers and usable nodejs20.	2025-04-12 21:40:03 -05:00
Rene Rivera	59abe72281	Use available macOS versions on GAH.	2025-04-12 20:36:24 -05:00
Rene Rivera	d35a57a156	Update build deps.	2024-08-02 22:17:56 -05:00
Rene Rivera	0cbac86ed0	Adjust doc build to avoid boost-root references.	2024-07-28 11:07:54 -05:00
Rene Rivera	f5fce8a124	Split b2 dependencies into public and private.	2024-07-26 17:32:48 -05:00
Rene Rivera	b77aeaa36b	Move inter-lib dependencies to a project variable and into the build targets.	2024-07-23 22:34:23 -05:00
Rene Rivera	292b605203	Update copyright dates.	2024-07-20 22:52:04 -05:00
Rene Rivera	eff0d37026	Bump B2 require to 5.2	2024-06-14 11:33:56 -05:00
Rene Rivera	88a9672fcc	Sync from upstream.	2024-06-10 21:40:14 -05:00
Lukas Friembichler	ca9ed9bd43	Typo, whitespace	2024-06-05 13:34:34 +01:00
Rene Rivera	31b0ede169	Add requires-b2 check to top-level build file.	2024-05-05 09:00:01 -05:00
Rene Rivera	80d3576414	Add missing NO_LIB usage requirements.	2024-04-28 20:16:25 -05:00
Rene Rivera	59f09593bb	Sync from upstream.	2024-04-10 07:56:56 -05:00
Peter Dimov	5cf65662fb	Merge branch 'master' into develop	2024-04-08 05:56:25 +03:00
Andrey Semashev	27f9276945	Fix C++20 incompatibility from using exception specifications. C++20 removed support for `throw()` exception specifications, so at least clang-19 is now emitting errors on them. Replaced exception specifications with BOOST_NOEXCEPT_OR_NOTHROW, which converts `throw()` to `noexcept`, but keeps the code formally compatible with C++03.	2024-04-08 03:17:53 +03:00
Peter Dimov	d1ddaa8a0e	Fix Cygwin failures	2024-04-08 03:15:51 +03:00
Peter Dimov	c832f18c08	Update appveyor.yml	2024-04-07 20:51:10 +03:00
Peter Dimov	8f848d8b75	Merge pull request #133 from Lastique/feature/fix_cxx23_nothrow Fix C++20 incompatibility from using exception specifications	2024-04-07 20:34:34 +03:00
Andrey Semashev	1d7cceff6c	Fix C++20 incompatibility from using exception specifications. C++20 removed support for `throw()` exception specifications, so at least clang-19 is now emitting errors on them. Replaced exception specifications with BOOST_NOEXCEPT_OR_NOTHROW, which converts `throw()` to `noexcept`, but keeps the code formally compatible with C++03.	2024-04-07 19:43:41 +03:00
Peter Dimov	5f233f00be	Update ci.yml	2024-04-07 19:25:38 +03:00
Rene Rivera	944550e78c	Switch to library requirements instead of source. As source puts extra source in install targets.	2024-03-29 21:15:59 -05:00
Rene Rivera	5fb238c49e	Make the library modular usable.	2024-03-11 08:38:17 -05:00
Sylvain Joubert	fafcca13d8	Add support for std::optional (#132 )	2024-03-05 22:57:52 +02:00
Markus Klemm	2b8bac66a9	Allow argc to be zero	2023-12-16 18:35:09 +00:00
Peter Dimov	3aae04bf65	Define BOOST_TIMER_ENABLE_DEPRECATED in test_convert.cpp	2023-10-21 18:46:22 +03:00
Peter Dimov	f941ba88a7	Avoid macro redefinition warnings	2023-10-21 18:41:37 +03:00
Peter Dimov	dbec456b8a	Regenerate CMakeLists.txt	2023-10-21 18:38:25 +03:00
Peter Dimov	9f29f8e104	Remove C++03 from ci.yml	2023-10-21 18:37:30 +03:00
Peter Dimov	93f4114948	Update cxxstd requirement in meta/libraries.json; dependencies such as Any require C++11	2023-10-21 18:36:37 +03:00
Peter Dimov	a97daf413d	Add test/CMakeLists.txt	2023-10-21 18:26:31 +03:00
Peter Dimov	3777e67b9f	Add cmake_install_test, cmake_subdir_test	2023-10-21 18:19:29 +03:00
Peter Dimov	c8cd11ddf5	Update ci.yml	2023-10-21 18:13:15 +03:00
Ed Catmur	847b130e19	Use BOOST_DEFAULTED_FUNCTION on empty destructors (#122 ) The compiler-generated copy constructor and copy assignment operator are deprecated since C++11 on classes with user-declared destructors. This change allows clean compilation with the -Wdeprecated-copy-dtor/-Wdeprecated-copy-with-user-provided-dtor flag. Co-authored-by: Ed Catmur <edward.catmur@mavensecurities.com>	2023-02-23 14:39:17 +03:00
Edward Diener	0a1e54ba90	[skip ci] Add "cxxstd" metadata field	2021-07-11 18:02:14 +03:00
Peter Dimov	7bcbb4ea23	Update ci.yml	2021-06-09 19:14:13 +03:00
Peter Dimov	827426db9c	Do not define BOOST_PROGRAM_OPTIONS_SOURCE in CMakeLists.txt	2021-06-09 18:43:51 +03:00
Peter Dimov	e9403da22d	Update ci.yml	2021-05-28 18:33:52 +03:00
Peter Dimov	36052766c7	Update ci.yml	2021-05-28 17:43:33 +03:00
Peter Dimov	ddfaf00542	Merge pull request #106 from boostorg/pr/exception-visibility Mark exception classes as BOOST_SYMBOL_VISIBLE	2021-05-28 17:37:37 +03:00
Peter Dimov	ce6a40b81a	Add CMakeLists.txt	2021-05-28 00:53:15 +03:00
Peter Dimov	7a7f0ce1fa	Mark the rest of the exception classes as BOOST_SYMBOL_VISIBLE	2021-02-02 21:41:06 +02:00
Peter Dimov	f1e9b5dc15	Add back _DECL to exception classes to avoid warnings when an exported class inherits from a non-exported one	2021-02-02 21:41:06 +02:00
Peter Dimov	df8412fe9e	Mark header-only exception classes as visible	2021-02-02 21:41:06 +02:00
Peter Dimov	3c0d0fa6ee	msvc-14.2 /std:c++latest no longer allows literal to char* conversions (#105 )	2021-02-02 22:24:32 +03:00
Peter Dimov	f62555fa75	Add .github/workflows	2021-02-02 20:34:50 +02:00
Peter Dimov	43cc2af3b1	Merge branch 'master' into develop	2021-02-02 19:19:09 +02:00
Edward Diener	0414abe3f4	Unbreak Embarcadero C++ clang-based compilers * Change __BORLANDC__ to BOOST_BORLANDC, which is defined in Boost config for the Embarcadero non-clang-based compilers. * Restored a Borland check. * Specify std:: for all standard identifiers and remove 'using namespace std:'. * Removed std:: from C header abort call. * Moved 'using namespace std;' after header file inclusions	2020-08-25 19:30:10 +03:00
Mateusz Łoskot	a2379420f6	Avoid deprecated bind placeholders in global namespace This fixes numerous compilation warnings: note: #pragma message: The practice of declaring the Bind placeholders (_1, _2, ...) in the global namespace is deprecated. Please use <boost/bind/bind.hpp> + using namespace boost::placeholders, or define BOOST_BIND_GLOBAL_PLACEHOLDERS to retain the current behavior.	2020-04-01 14:13:13 +03:00
Peter Dimov	fcffe08c83	Remove manual RTTI defines	2019-06-01 22:19:45 +03:00
Vladimir Prus	bc0c90a70f	Merge branch 'develop'	2018-07-06 17:35:40 +03:00
Vladimir Prus	331ed69055	Merge branch 'develop'	2018-07-06 10:36:17 +03:00
Vladimir Prus	46ad442da1	Merge branch 'develop'	2018-06-27 22:32:29 +03:00
Vladimir Prus	46caf622db	Merge branch 'develop'	2018-03-15 22:21:23 +03:00
Johannes Spangenberg	fcee593529	fix suppressing I/O error in parse_config_file corresponding issue: https://svn.boost.org/trac10/ticket/13125	2017-07-24 22:22:31 +03:00
Vladimir Prus	d9ef3853c6	Merge branch 'develop'	2017-07-24 21:48:56 +03:00
Vladimir Prus	acaa4c94e1	Merge branch 'develop'	2017-06-25 21:41:31 +03:00
Vladimir Prus	0565d1ee16	Merge from develop for 1.65.0 - Make options with implicit value use next token, like it did before. - Support boost::optional option variables. - Fix syntax error with BOOST_NO_EXCEPTIONS - Fix uninitlized position_key in some cases.	2017-06-24 20:06:06 +03:00
Rene Rivera	abbb5c12a6	Add, and update, documentation build targets.	2016-10-10 11:39:52 -05:00
Vladimir Prus	fae2d4c57b	Merge from develop for 1.59 - Fix compilation errors, missing dllexport and warnings on Windows and/or MSVC (Daniela Engert, Marcel Raad) - Fix unintialized fields (Zoey Greer) - Stop options with implicit value from consuming separate tokens (Michael John Decker) - Make multitoken limit be max int, not 32K (Hans Hohenfeld) - Code formatting and documentation fixes (Jurko, Lauri Nurmi) - Minimal support for no-rtti build (Minmin Gong) - Don't increment environment pointer past the end (Vladimir Prus)	2015-06-09 09:54:19 +03:00
Vladimir Prus	9d7c987526	Remove tabs.	2013-12-04 09:17:17 +04:00
Vladimir Prus	0a7005d7c6	Merge branch 'develop'	2013-12-04 09:13:36 +04:00
Michel Morin	fb4f36f3ee	Merge r86524 (Correct broken links to C++ standard papers); fixes #9212 [SVN r86673]	2013-11-13 03:22:55 +00:00
Vladimir Prus	2ceb54f9a2	Merge: Really fixes #7049 . [SVN r82556]	2013-01-20 07:13:55 +00:00
Vladimir Prus	e8e538036d	Merge program_options revisions 79280 and 79283. [SVN r79758]	2012-07-26 16:22:04 +00:00
Vladimir Prus	f271e1ffce	Merge from trunk. [SVN r78362]	2012-05-06 18:13:25 +00:00
Dave Abrahams	63e8f1c954	Summary: Moved libs/detail/utf8_codecvt_facet.cpp to boost/detail/utfâ¦â¦8_codecvt_facet.ipp Author: Dave Abrahams <dave@boostpro.com> [SVN r78119]	2012-04-21 22:36:59 +00:00
Vladimir Prus	43e53664f2	Merge: Allow to specify how option's value is named in help message. Fixes #4781. [SVN r77932]	2012-04-12 09:40:34 +00:00
Vladimir Prus	cddd2c593f	Merge from trunk. [SVN r77829]	2012-04-08 10:02:26 +00:00
Jürgen Hunold	c054a3b034	Merge 73299,73301,73308 from ^/trunk ------------------------------------------------------------------------ r73299 \| jhunold \| 2011-07-22 14:08:03 +0200 (Fr, 22 Jul 2011) \| 2 lines Enable visibility support. Refs #2114. ------------------------------------------------------------------------ r73301 \| jhunold \| 2011-07-22 16:15:45 +0200 (Fr, 22 Jul 2011) \| 2 lines Enable visibility support. Refs #2114. ------------------------------------------------------------------------ r73308 \| jhunold \| 2011-07-23 11:24:35 +0200 (Sa, 23 Jul 2011) \| 2 lines Enable visibility support. Refs #2114. ------------------------------------------------------------------------ [SVN r73381]	2011-07-26 17:40:21 +00:00
Marshall Clow	cf09cfde1f	Merging fixes for #3909 to release branch [SVN r68077]	2011-01-13 01:46:49 +00:00
Marshall Clow	ec3192a6c8	fix typo [SVN r67037]	2010-12-05 20:39:48 +00:00
Marshall Clow	abd32c88fc	Merge doc patches to release; fixes #3992 , fixes #4858 [SVN r67034]	2010-12-05 20:36:54 +00:00
Jürgen Hunold	0c04bde7e0	Merge 65318,65319 from ^/trunk ------------------------------------------------------------------------ r65318 \| jhunold \| 2010-09-06 10:43:06 +0200 (Mo, 06 Sep 2010) \| 3 lines Suppress msvc warning 4251 about templates as base classes not having a dll-interface. Suppress msvc warning 4275 about base class std::logic_error not having a dll-interface. ------------------------------------------------------------------------ r65319 \| jhunold \| 2010-09-06 16:14:09 +0200 (Mo, 06 Sep 2010) \| 2 lines Fix: windows does not have wait(), use own macros instead. ------------------------------------------------------------------------ [SVN r65326]	2010-09-07 05:52:45 +00:00
Vladimir Prus	cd1b58aac2	Merge from trunk [SVN r63911]	2010-07-12 07:14:14 +00:00
Daniel James	310a638dc8	Merge documentation fixes. * Use `doc/src/.css` instead of `doc/html/.css`. * Remove wiki and people directories. * Some documentation fixes. * Left out `minimal.css` changes and boostbook changes because of clashes. [SVN r63347]	2010-06-26 12:30:09 +00:00
Vladimir Prus	cbacc90d8f	Merge from trunk [SVN r61962]	2010-05-14 06:55:15 +00:00
Vladimir Prus	ab9901f553	Merge from trunk. [SVN r58818]	2010-01-08 21:00:57 +00:00
Troy D. Straszheim	5820ee9f7f	rm cmake from the release branch before it goes out broken. Policy dictates that you never commit to release, you commit to trunk and merge to release. [SVN r56941]	2009-10-17 01:10:45 +00:00
Troy D. Straszheim	67ba23b8d9	Add basic copyright/license to keep cmake out of the inspection report [SVN r55095]	2009-07-22 21:51:01 +00:00
Vladimir Prus	c3cb7cf05d	Merge from trunk [SVN r54884]	2009-07-11 12:00:18 +00:00
Jeremiah Willcock	bdbd3dfc42	Fixed almost all tab and min/max issues found by inspect tool [SVN r53142]	2009-05-20 19:41:20 +00:00
Douglas Gregor	15c990b7af	Fix CMake build of Program Options DLL tests [SVN r52847]	2009-05-08 06:13:08 +00:00
Douglas Gregor	1a884cef74	Fix CMake test builds for ProgramOptions and Units libraries. [SVN r52843]	2009-05-07 23:53:56 +00:00
Vladimir Prus	3c6401b19a	Prevent multitoken options from eating tokens after '--' separator. Thanks to Gevorg Voskanyan for the bug report and the testcase. [SVN r52440]	2009-04-17 09:45:00 +00:00
Vladimir Prus	ed4847e0a7	Fix warnings [SVN r52439]	2009-04-17 09:35:10 +00:00
Vladimir Prus	6eef67f5ba	Merge from trunk [SVN r52211]	2009-04-06 09:43:03 +00:00
Vladimir Prus	91d9cabb51	When processing value multitoken options, don't eat futher options. Fixes #469. [SVN r52154]	2009-04-03 13:42:29 +00:00
John Maddock	22e8d11888	Merge PDF build changes from Trunk. [SVN r51417]	2009-02-23 18:39:32 +00:00
Troy D. Straszheim	b55001a061	merge of cmake build files from trunk per beman [SVN r50756]	2009-01-24 18:57:20 +00:00
Vladimir Prus	2a16575f98	Merge from trunk. No code changes, only properties and docs and examples [SVN r47336]	2008-07-12 09:03:18 +00:00
Vladimir Prus	f14a369077	Merge r43992 [SVN r47335]	2008-07-12 08:58:04 +00:00
Vladimir Prus	9df5124fed	Don't hardcode cout. Suggested by Guido Ziliotti. [SVN r47285]	2008-07-10 09:40:04 +00:00
Vladimir Prus	86487c7b63	Add example of zero_tokens [SVN r45450]	2008-05-17 07:28:17 +00:00
Vladimir Prus	6cd68a2fd9	Clarify docs. Fixes #1530 . [SVN r45448]	2008-05-17 07:06:59 +00:00
Vladimir Prus	f0eae2ccfe	Merge from trunk: Tolerate argc being zero. Patch from C. K. Jester-Young. [SVN r43331]	2008-02-20 14:55:25 +00:00
Beman Dawes	b2a01d9405	Full merge from trunk at revision 41356 of entire boost-root tree. [SVN r41370]	2007-11-25 18:38:02 +00:00
Beman Dawes	2d0c627d34	Full merge from trunk at revision 41356 of entire boost-root tree. [SVN r41369]	2007-11-25 18:07:19 +00:00
Beman Dawes	2cc29f6dfa	Starting point for releases [SVN r39706]	2007-10-05 14:25:06 +00:00
nobody	198b29d107	This commit was manufactured by cvs2svn to create tag 'Version_1_34_1'. [SVN r38286]	2007-07-24 19:28:14 +00:00
Thomas Witt	f407b6ce47	Applying patch to fix example build. [SVN r38153]	2007-07-06 19:20:51 +00:00
Vladimir Prus	87938cfa8e	Merge: Add missing include, to try to fix compilation on sun [SVN r37006]	2007-02-19 19:28:49 +00:00
Hartmut Kaiser	9a73a1c412	Trying to fix sun-5.8 error. [SVN r36943]	2007-02-15 01:25:10 +00:00
Daniel James	37143a449d	Fix a broken link [SVN r36653]	2007-01-07 22:51:27 +00:00
Vladimir Prus	2e0e9fd30b	Merge: Fix dynamic linking [SVN r35992]	2006-11-10 20:31:43 +00:00
Vladimir Prus	1bd588d677	Merge from HEAD. Allow building of shared versions of some Boost.Test libraries. Adjust tests to use always use static linking to Boost.Test, since linking to the shared version requires test changes. Patch from Juergen Hunold. [SVN r35990]	2006-11-10 19:59:52 +00:00
Beman Dawes	d83e0dea37	Merged copyright and license addition [SVN r35907]	2006-11-07 19:27:00 +00:00
Rene Rivera	54daca4c09	Remove obsolete Boost.Build v1 files. [SVN r35880]	2006-11-06 17:10:46 +00:00
John Maddock	f4eac99310	Fix for Borland compilers. [SVN r35652]	2006-10-18 12:33:54 +00:00
Vladimir Prus	a367a1b021	Make intel happy [SVN r35034]	2006-09-07 08:06:16 +00:00
Gennaro Prota	720d0455dd	avoid bogus detection of min/max guideline violation (Inspect tool) [SVN r34784]	2006-07-29 21:00:31 +00:00
Hartmut Kaiser	aad1a60172	Just another fix for the Intel DLL issue. [SVN r34196]	2006-06-06 14:30:28 +00:00
Hartmut Kaiser	1e4d1dee3d	Fixed intel 9.1 dll export problem. [SVN r34168]	2006-06-04 15:50:47 +00:00
Hartmut Kaiser	e718d0a8a5	Try to fix Intel dll issue on Windows. [SVN r34104]	2006-05-26 16:52:54 +00:00
Hartmut Kaiser	ab30ec28eb	Fixed a dllimport/dllexport problem. [SVN r34049]	2006-05-20 22:14:41 +00:00
Vladimir Prus	682f1b7670	Merge from trunk [SVN r33992]	2006-05-18 06:06:53 +00:00
Vladimir Prus	43577d0ca8	Merge from trunk [SVN r33970]	2006-05-15 14:06:24 +00:00
Vladimir Prus	d05b400b13	Merge from trunk [SVN r33787]	2006-04-24 09:51:01 +00:00
Vladimir Prus	4863727509	Merge from trunk [SVN r33785]	2006-04-24 09:41:50 +00:00
Vladimir Prus	7d90a1b1b2	Merge from trunk [SVN r33783]	2006-04-24 09:15:27 +00:00
Vladimir Prus	ac9830625b	Merge from trunk [SVN r33781]	2006-04-24 08:52:43 +00:00
Vladimir Prus	252a3f9ebd	Merge from trunk [SVN r33779]	2006-04-24 08:29:05 +00:00
Vladimir Prus	b1dc87da3c	Merge from trunk [SVN r33777]	2006-04-24 08:02:07 +00:00
nobody	1fbf955272	This commit was manufactured by cvs2svn to create branch 'RC_1_34_0'. [SVN r33417]	2006-03-21 02:26:31 +00:00