New documentation formatting

.drone.star

@@ -18,7 +18,7 @@ def main(ctx):
   linux_cxx("gcc 11 s390x", "g++-11", packages="g++-11", buildtype="boost", buildscript="drone", image="cppalliance/droneubuntu2004:multiarch", environment={'B2_TOOLSET': 'gcc-11', 'B2_CXXSTD': '17,2a'}, arch="s390x", globalenv=globalenv),
   linux_cxx("Clang 12 arm64", "clang++-12", packages="clang-12 libstdc++-9-dev", llvm_os="focal", llvm_ver="12", buildtype="boost", buildscript="drone", image="cppalliance/droneubuntu2004:multiarch", environment={'B2_TOOLSET': 'clang-12', 'B2_CXXSTD': '17,20', 'DRONE_JOB_UUID': '7719a1c783m'}, arch="arm64", globalenv=globalenv),
   linux_cxx("gcc 11 arm64", "g++-11", packages="g++-11", buildtype="boost", buildscript="drone", image="cppalliance/droneubuntu2004:multiarch", environment={'B2_TOOLSET': 'gcc-11', 'B2_CXXSTD': '17,2a', 'DRONE_JOB_UUID': '0716d9708dm'}, arch="arm64", globalenv=globalenv),
-  linux_cxx("docs", "g++", packages="docbook docbook-xml docbook-xsl python3-jinja2 xsltproc flex libfl-dev bison unzip rsync", buildtype="docs", buildscript="drone", image="cppalliance/droneubuntu1804:1", environment={'COMMENT': 'docs', 'DRONE_JOB_UUID': 'b6589fc6ab'}, globalenv=globalenv),
+  linux_cxx("docs", "g++", buildtype="docs", buildscript="drone", image="cppalliance/boost_superproject_build:24.04-v3", environment={'COMMENT': 'docs', 'DRONE_JOB_UUID': 'b6589fc6ab'}, globalenv=globalenv),
   linux_cxx("codecov", "g++-8", packages="g++-8", buildtype="codecov", buildscript="drone", image=linuxglobalimage, environment={'COMMENT': 'codecov.io', 'LCOV_BRANCH_COVERAGE': '0', 'B2_CXXSTD': '17', 'B2_TOOLSET': 'gcc-8', 'B2_DEFINES': 'BOOST_JSON_EXPENSIVE_TESTS BOOST_NO_STRESS_TEST=1', 'CODECOV_TOKEN': {'from_secret': 'codecov_token'}, 'B2_FLAGS': 'warnings=extra warnings-as-errors=on linkflags=-lstdc++fs', 'DRONE_JOB_UUID': '356a192b79'}, globalenv=globalenv),
   linux_cxx("Valgrind", "clang++-14", packages="clang-14 libc6-dbg libc++-dev libstdc++-9-dev", llvm_os="jammy", llvm_ver="14", buildscript="drone", buildtype="valgrind", image="cppalliance/droneubuntu2204:1", environment={'COMMENT': 'valgrind', 'B2_TOOLSET': 'clang-14', 'B2_CXXSTD': '11,14,17', 'B2_DEFINES': 'BOOST_NO_STRESS_TEST=1', 'B2_VARIANT': 'debug', 'B2_TESTFLAGS': 'testing.launcher=valgrind', 'VALGRIND_OPTS': '--error-exitcode=1'}, globalenv=globalenv),
   linux_cxx("ASan GCC", "g++-12", packages="g++-12", buildscript="drone", buildtype="boost", image="cppalliance/droneubuntu2204:1", environment={'COMMENT': 'asan', 'B2_VARIANT': 'debug', 'B2_TOOLSET': 'gcc-12', 'B2_CXXSTD': '11,14,17', 'B2_ASAN': '1', 'B2_DEFINES': 'BOOST_NO_STRESS_TEST=1', 'DRONE_EXTRA_PRIVILEGED': 'True'}, globalenv=globalenv, privileged=True),

.drone/drone.sh

@@ -103,36 +103,20 @@ elif [ "$DRONE_JOB_BUILDTYPE" == "docs" ]; then
 
 echo '==================================> INSTALL'
 
-export SELF=`basename $REPO_NAME`
-
-pwd
-cd ..
-mkdir -p $HOME/cache && cd $HOME/cache
-if [ ! -d doxygen ]; then git clone -b 'Release_1_8_15' --depth 1 https://github.com/doxygen/doxygen.git && echo "not-cached" ; else echo "cached" ; fi
-cd doxygen
-cmake -H. -Bbuild -DCMAKE_BUILD_TYPE=Release
-cd build
-sudo make install
-cd ../..
-cd ..
-BOOST_BRANCH=develop && [ "$TRAVIS_BRANCH" == "master" ] && BOOST_BRANCH=master || true
-git clone -b $BOOST_BRANCH https://github.com/boostorg/boost.git boost-root --depth 1
-cd boost-root
-export BOOST_ROOT=$(pwd)
-git submodule update --init libs/context
-git submodule update --init tools/boostbook
-git submodule update --init tools/boostdep
+common_install
 git submodule update --init tools/docca
-git submodule update --init tools/quickbook
-rsync -av $TRAVIS_BUILD_DIR/ libs/$SELF
-python tools/boostdep/depinst/depinst.py ../tools/quickbook
-./bootstrap.sh
-./b2 headers
+git submodule update --init tools/boostlook
 
 echo '==================================> SCRIPT'
 
-echo "using doxygen ; using boostbook ; using python : : python3 ;" > tools/build/src/user-config.jam
-./b2 -j3 libs/$SELF/doc//boostrelease
+cat >$BOOST_ROOT/tools/build/src/user-config.jam <<EOF
+using doxygen ;
+using asciidoctor ;
+using python : : python3 ;
+EOF
+
+export B2_TARGETS=libs/$SELF/doc//boostrelease
+$BOOST_ROOT/libs/$SELF/ci/travis/build.sh
 
 elif [ "$DRONE_JOB_BUILDTYPE" == "codecov" ]; then
 

CHANGELOG.adoc

@@ -0,0 +1,244 @@
+[pagelevels=1,toclevels=1]
+= Release Notes
+
+:issue: https://github.com/boostorg/json/issues/
+
+include::doc/pages/definitions.adoc[]
+
+== Boost 1.87.0
+
+.API Changes
+* {issue}991[#991] Conversion into structs ignores unknown keys.
+* {issue}1041[#1041] Exception wrapping behaviour for `value_to` is simplified.
+* {issue}1040[#1040] Deprecated initilaizer list behavior was removed.
+* {issue}1040[#1040] Deprecated type aliases were removed.
+
+
+.New Features
+* {issue}956[#956] <<direct_conversion,Direct serialization>>.
+* {issue}644[#644] Add GDB pretty printers for Boost.JSON types.
+
+.Fixes
+* {issue}1057[#1057] Use correct 64bit full multiplication for MinGW on ARM64.
+* {issue}1048[#1048] Fix parse_into handling of tuple of the wrong size.
+* {issue}1047[#1047] Check for input size larger than allowed size of sequence.
+* {issue}1034[#1034] Fix `value_ref` segfaulting on GCC 14.
+
+== Boost 1.86.0
+
+.Deprecation
+* Support for GCC versions older than version 5.0 is deprecated and **will
+  stop in Boost 1.88.0**.
+
+.API Changes
+* {issue}941[#941] `source_location` parameter was added to throwing accessor
+  functions.
+
+.New Features
+* {issue}940[#940] Parse option to tolerate invalid UTF-16 surrogate pairs,
+  and produce https://simonsapin.github.io/wtf-8/[WTF-8].
+* {issue}941[#941] Added accessor functions that return `system::result`.
+
+.Fixes
+* Handle missing error case in direct parsing.
+
+== Boost 1.85.0
+
+.New Dependencies
+* {issue}915[#915] Boost.Endian is now used to deal with endianness.
+
+.API Changes
+* {issue}881[#881] Aliases to Boost.System and Boost.Container components are
+  deprecated and **will be completely removed in 1.87.0**.
+
+.New Features
+* {issue}979[#979] Conversion of described classes supports private members
+* {issue}979[#979] Rvalue reference overload for `visit`.
+* {issue}977[#977] Add conversion support for path-like types.
+
+.Fixes
+* {issue}988[#988] Parsing into described classes correctly considers inherited
+  members.
+* {issue}975[#975] Conversion of self-referential sequences is disabled.
+* {issue}952[#952] Fixed reference handling in visit.
+
+== Boost 1.84.0
+
+.API Changes
+* {issue}925[#925] Add a conversion category for variants.
+* {issue}833[#833] Add a conversion category for optionals.
+* {issue}840[#840] Relax iterator requirements for constructors from iterator
+  pairs.
+
+.New Features
+* {issue}627[#627] Parsing directly into user types. See
+  <<direct_conversion,Direct Parsing>>.
+
+.Fixes
+* {issue}933[#933] Fix reading beyond input buffer.
+* {issue}920[#920] Fix inconsistent choice of init list constructor.
+* Documentation improvements.
+
+== Boost 1.83.0
+
+.API Changes
+* {issue}859[#859] The library now only throws {ref_system_error}, except for
+  when allocation failed, in which case `std::bad_alloc` is thrown.
+* {issue}884[#884] Serialization behavior can now be changed by
+  <<ref_serialize_options,`serialize_options`>>.
+
+.New Features
+* {issue}819[#819] <<contextual_conversions,Contextual conversions>>.
+* {issue}599[#599] <<ref_number_precision,Parser option>> for more precise
+  number parsing.
+* {issue}885[#885] Support <<ref_parse_options,`parse_options`>> in stream
+  `operator<<`.
+* {issue}397[#397] <<ref_parse_options,Parser option>> to allow `Infinity` and
+  `NaN` JSON literals.
+* {issue}901[#901] <<ref_number_precision,Parser mode>> that only validates
+  numbers rather than parsing them.
+* {issue}892[#892] Numbers with exponent larger than `INT_MAX` are accepted by
+  the parser and treated as infinity.
+
+.Fixes
+* {issue}901[#901] Fix `object` member functions that should provide strong
+  guarantee.
+* {issue}887[#887] Fix ambiguity of `end` call when `boost/range.hpp` is
+  included.
+* {issue}902[#902] Fix ASan failures.
+* {issue}904[#904] Fix error message for `error::size_mismatch`.
+* Fix conversion into tuple with const elements.
+
+== Boost 1.82.0
+
+.New Features
+* {issue}800[#800] <<ref_value_set_at_pointer,`set_at_pointer`>>.
+* {issue}570[#570] <<ref_value_hash_value_fr,`boost::hash` support>>.
+
+.Improvements
+* {issue}848[#848] <<ref_serializer_serializer,Caller-provided serializer
+  storage>> .
+* {issue}807[#807] `value_to` supports missing elements for `std::optional`.
+* Documentation improvements.
+
+.Fixes
+* {issue}876[#876] Fix parser suspend inside an escape character.
+* {issue}814[#814] Make sentinel() return a unique pointer.
+
+== Boost 1.81.0
+
+.API Changes
+* {issue}686[#686] Conversion traits were redesigned.
+* {issue}756[#756] Removed `condition::assign_error`.
+* {issue}758[#758] Removed `generic_category` alias.
+
+.New Features
+
+* {issue}749[#749] `object::stable_erase`.
+* {issue}778[#778] Added error condition for generic library errors.
+* {issue}619[#619] Added `parse` overload for `std::istream`.
+* {issue}619[#619] `operator>>` for `value`.
+
+.Improvements
+* {issue}686[#686] Null-like type conversion support (including
+  `std::nullptr_t`).
+* {issue}736[#736] Non-throwing conversion from `value` to user types.
+* {issue}677[#677] `value_to/from` supports `std::optional` and
+  `std::nullopt_t`.
+* {issue}517[#517] `value_to/from` supports `std::variant` and `std::monotype`.
+* {issue}626[#626] `value_to/from` supports supports described classes
+  and enums.
+* {issue}757[#757] Rvalue ref-qualified accessors for `value`.
+
+.Fixes
+* {issue}745[#745] Support for self-swap and self-move in `string`.
+* {issue}747[#747] Support for self-swap and self-move in `array`.
+* {issue}735[#735] Replaced C floating point constants with C++ equivalents.
+* Documentation improvements.
+
+== Boost 1.80.0
+
+.API Changes
+* {issue}703[#703] Add non-const `value::at` overloads.
+* {issue}717[#717] Add the ability to manually choose endianness of the
+  platform.
+* Add `string::subview()` overload.
+
+.Fixes
+* {issue}692[#692] Fix segfault in `array::erase(it)`.
+* {issue}697[#697] Fix low performance of `serialize` on libc{pp}.
+* {issue}708[#708] Fix ambiguous conversion to `std::string_view` on GCC 8.
+* {issue}717[#717] Fix parsing on big-endian platforms.
+* {issue}726[#726] Fix handling of comment after trailing comma.
+* Minor documentation fixes.
+
+== Boost 1.79.0
+
+.API Changes
+* {issue}650[#650] Standalone mode of the library is removed. Users who wish to
+  continue using standalone JSON can switch to
+  https://github.com/CPPAlliance/standalone-json.git[the C++ Alliance fork].
+
+.New Features
+* {issue}480[#480] Add support for JSON Pointer.
+
+.Improvements
+* Add `std::error_code` overloads.
+* {issue}680[#680] Add `boost::source_location` to `error_codes`.
+
+.Fixes
+* {issue}668[#668] Naturally grow string during serialization.
+
+== Boost 1.78.0
+
+.API Changes
+* {issue}628[#628] Standalone mode of the library is removed.
+
+== Boost 1.78.0
+
+.API Changes
+* {issue}628[#628] Standalone mode of the library is deprecated.
+
+.New Features
+* {issue}549[#549] {issue}550[#550] Allow external libraries to forward declare
+  <<ref_value_to,`value_to`>> and <<ref_value_from,`value_from`>>.
+
+.Fixes
+* {issue}608[#608] {issue}612[#612] Fixed signed integer overflow in number
+  parsing.
+* {issue}620[#620] Documentation fixes.
+
+.Improvements
+* {issue}557[#557] Add support for `/Zc:implicitNoexcept-` on MSVC.
+
+== Boost 1.77.0
+
+.New Features
+* {issue}538[#538] <<ref_string_operator_std_string_view,Implicit conversion
+  operator from `string` to `std::string_view`>>.
+* {issue}521[#521] {std_hash} specializations for JSON types.
+
+.Fixes
+* <<ref_object,`object`>> deallocates the correct size.
+* Fixed crash when constructing <<ref_array,`array`>> from a pair of iterators
+  that form an empty range.
+* <<ref_key_value_pair,`key_value_pair`>> allocates with the correct alignment.
+
+.Improvements
+* <<ref_value_to,`value_to`>> supports `TupleLike` types.
+* <<ref_value_to,`value_to`>> and <<ref_value_from,`value_from`>> support
+  {std_array} and similar types.
+
+== Boost 1.76.0
+
+.Fixes
+* {issue}481[#481] Refactored <<ref_value_from,value_from>> implementation;
+  user customizations are now always preferred over library-provided overloads.
+* {issue}484[#484] Fixed imprecise parsing for some floating point numbers.
+* {issue}485[#485] Fixed link errors in standalone mode, when used alongside
+  Boost.
+* {issue}497[#497] Fix Boost.Build builds on GCC 4.8.
+
+== Boost 1.75.0
+
+* Initial release.