From Fedora Project Wiki
(note C++14 requirement for Boost.Geometry)
 
(6 intermediate revisions by 3 users not shown)
Line 33: Line 33:
-->
-->
* FESCo issue: [https://pagure.io/fesco/issue/2524 #2524]
* FESCo issue: [https://pagure.io/fesco/issue/2524 #2524]
* Tracker bug: phttps://bugzilla.redhat.com/show_bug.cgi?id=1912501 #1912501]
* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=1912501 #1912501]
* Release notes tracker: [https://pagure.io/fedora-docs/release-notes/issue/621 #621]
* Release notes tracker: [https://pagure.io/fedora-docs/release-notes/issue/621 #621]


Line 55: Line 55:
* Proposal owners:
* Proposal owners:
** Build will be done with Boost.Build v2 (which is the upstream-sanctioned way of building Boost)
** Build will be done with Boost.Build v2 (which is the upstream-sanctioned way of building Boost)
** Request a "f34-boost" [https://docs.pagure.org/releng/sop_adding_side_build_targets.html build system tag] ([http://lists.fedoraproject.org/pipermail/devel/2011-November/159908.html discussion]):
** Request a "f34-boost" [https://docs.pagure.org/releng/sop_adding_side_build_targets.html build system tag] ([http://lists.fedoraproject.org/pipermail/devel/2011-November/159908.html discussion]): https://pagure.io/releng/issue/9956
<!-- TODO: link to correct side tag, the one for f33 was https://pagure.io/releng/issue/9474 -->
<!-- link to correct side tag, the one for f33 was https://pagure.io/releng/issue/9474 -->
<!-- N.B. next time use the side tag template: https://pagure.io/releng/issue/9419#comment-644377 -->
<!-- N.B. use the side tag template: https://pagure.io/releng/issue/9419#comment-644377 -->
** Build boost into that tag (take a look at the [http://koji.fedoraproject.org/koji/buildinfo?buildID=606493 build #606493] for inspiration)
** Build boost into that tag (take a look at the [http://koji.fedoraproject.org/koji/buildinfo?buildID=606493 build #606493] for inspiration)
** Post a request for rebuilds to fedora-devel
** Post a request for rebuilds to fedora-devel
Line 68: Line 68:




<!-- * Release engineering: [https://pagure.io/releng/issue/9421 #9421] (a check of an impact with Release Engineering is needed) -->
* Release engineering: [https://pagure.io/releng/issue/9950 #9950] (a check of an impact with Release Engineering is needed)


* Policies and guidelines:
* Policies and guidelines:
Line 87: Line 87:
== User Experience ==
== User Experience ==
* Expected to remain largely the same.
* Expected to remain largely the same.
* Developers building third-party software on Fedora may need to rebuild against the new Boost packages, and may need to adjust their code if the new Boost release is not source-compatible.
* Developers building third-party software on Fedora may need to rebuild against the new Boost packages, and may need to adjust their code if the new Boost release is not source-compatible. For example, the Boost.Geometry library no longer supports C++11 or older.
* Developers using `bjam` to build their own software will need to switch to using the new name for the tool, `b2`
 


== Dependencies ==
== Dependencies ==
Line 110: Line 110:
* https://www.boost.org/users/history/version_1_75_0.html (expected release mid December 2020)
* https://www.boost.org/users/history/version_1_75_0.html (expected release mid December 2020)
* https://www.boost.org/users/history/version_1_74_0.html (released on 14 August 2020)
* https://www.boost.org/users/history/version_1_74_0.html (released on 14 August 2020)
* https://www.boost.org/users/history/version_1_73_0.html (released on 28 April 2020)
* https://www.boost.org/users/history/version_1_72_0.html (released on 11 December 2019)
* https://www.boost.org/users/history/version_1_71_0.html (released on 19 August 2019)
* https://www.boost.org/users/history/version_1_70_0.html (released on 12 April 2019)
* https://www.boost.org/development/index.html
* https://www.boost.org/development/index.html


== Release Notes ==
== Release Notes ==
<!-- TODO -->
<!-- TODO -->

Latest revision as of 16:19, 29 January 2021

Boost 1.75 upgrade

Summary

This change brings Boost 1.75 to Fedora. This will mean Fedora ships with a recent upstream Boost release.

Owner

Current status

Detailed Description

The aim is to synchronize Fedora with the most recent Boost release. Because ABI stability is absent from Boost, this entails rebuilding of all dependent packages. This also entails the change owner assisting maintainers of client packages in decoding cryptic boost-ese seen in output from g++.

The equivalent changes for previous releases were Changes/F33Boost173, Fedora 30 Change, Fedora 29 Change, Fedora 28 Change, Fedora 27 Change, Fedora 26 Change, Fedora 25 Change, Fedora 24 Change, Fedora 23 Change and Fedora 22 Change.

Benefit to Fedora

Fedora 33 includes Boost 1.73 (released April 28th 2020).

Fedora will stay relevant, as far as Boost clients are concerned. In addition to serveral bug fixes and enhancements to existing components (including many as part of Boost 1.74's release) Boost 1.75 brings three new components:

  • Boost.STL_Interfaces, A library to assist in writing STL conforming iterators, views, and containers, from T. Zachary Laine (introduced in Boost 1.74).
  • Boost.JSON, A portable C++ library which provides containers and algorithms that implement JavaScript Object Notation, from Vinnie Falco, Krystian Stasiowski.
  • Boost.LEAF, A lightweight error handling library for C++11, from Krystian Stasiowski.
  • Boost.PFR, A C++14 library for very basic reflection, from Antony Polukhin.

Scope

  • Proposal owners:
    • Build will be done with Boost.Build v2 (which is the upstream-sanctioned way of building Boost)
    • Request a "f34-boost" build system tag (discussion): https://pagure.io/releng/issue/9956
    • Build boost into that tag (take a look at the build #606493 for inspiration)
    • Post a request for rebuilds to fedora-devel
    • Work on rebuilding dependent packages in the tag.
    • When most is done, re-tag all the packages to rawhide
    • Watch fedora-devel and assist in rebuilding broken Boost clients (by fixing the client, or Boost).
  • Other developers:
    • Those who depend on Boost DSOs will have to rebuild their packages. Feature owners will alleviate some of this work as indicated above, and will assist those whose packages fail to build in debugging them.


  • Release engineering: #9950 (a check of an impact with Release Engineering is needed)
  • Policies and guidelines:
    • Apart from scope, this is business as usual, so no new policies, no new guidelines.
  • Trademark approval: N/A (not needed for this Change)


Upgrade/compatibility impact

  • No manual configuration or data migration needed.
  • Some impact on other packages needing code changes to rebuild. Historically this hasn't been too much of a problem and could always be resolved before deadline.

How To Test

  • No special hardware is needed.
  • Integration testing simply consists of installing Boost packages (dnf install boost) on Fedora and checking that it does not break other packages (see below for a way to obtain a list of boost clients).


User Experience

  • Expected to remain largely the same.
  • Developers building third-party software on Fedora may need to rebuild against the new Boost packages, and may need to adjust their code if the new Boost release is not source-compatible. For example, the Boost.Geometry library no longer supports C++11 or older.


Dependencies

Packages that must be rebuilt: $ dnf repoquery -s --releasever=rawhide --whatrequires libboost\* --disablerepo=* --enablerepo=fedora | sort -u

All clients: $ dnf repoquery --releasever=rawhide --archlist=src --whatrequires boost-devel --disablerepo='*' --enablerepo=fedora-source

Contingency Plan

  • Contingency mechanism: Worst case scenario is to abandon the update and simply ship F34 with Boost 1.73, which is already in rawhide. It would also be possible to ship the 1.74.0 which would still be newer than in current Fedora releases and contains numerous fixes and improvements to existing Boost components.


  • Blocks release? No
  • Blocks product? None


Documentation

Release Notes