From Fedora Project Wiki
m (Added a link for Boost 1.69 documentation)
(correction: Boost.Signals has been removed, not just deprecated.)
 
(10 intermediate revisions by 3 users not shown)
Line 26: Line 26:
 
CLOSED as NEXTRELEASE -> change is completed and verified and will be delivered in next release under development
 
CLOSED as NEXTRELEASE -> change is completed and verified and will be delivered in next release under development
 
-->
 
-->
* Tracker bug: <will be assigned by the Wrangler>
+
* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=1661633 #1661633]
 +
* Release engineering tracker: [https://pagure.io/releng/issue/8061 #8061]
 +
* Release Notes tracker: [https://pagure.io/fedora-docs/release-notes/issue/269 #269]
 
* [https://github.com/boostorg/boost/releases Boost releases on GitHub]
 
* [https://github.com/boostorg/boost/releases Boost releases on GitHub]
 
* [https://src.fedoraproject.org/rpms/boost/commits/master Boost on Pagure (Fedora Git repository)]
 
* [https://src.fedoraproject.org/rpms/boost/commits/master Boost on Pagure (Fedora Git repository)]
 +
** [https://src.fedoraproject.org/rpms/boost/tree/90fdd43d4d59b04455bc08aac0a8b1a3344722af (90fdd4) 2018-12-15 - Rebase for Boost-1.69 - Clean build]
 
** [https://src.fedoraproject.org/rpms/boost/tree/15eed9824241f8b84ecdbb952c75e8eda4cda9da (15eed9) 2018-12-01 - Rebase for Boost-1.68 - Clean build]
 
** [https://src.fedoraproject.org/rpms/boost/tree/15eed9824241f8b84ecdbb952c75e8eda4cda9da (15eed9) 2018-12-01 - Rebase for Boost-1.68 - Clean build]
  
Line 37: Line 40:
  
 
== Benefit to Fedora ==
 
== Benefit to Fedora ==
Fedora 29 includes Boost 1.67 but the latest upstream release, Boost 1.68, was released on August 9th, 2018 (the 1.69 release is scheduled for mid-November 2018, so it should be in time for F30).
+
Fedora 29 includes Boost 1.66, but the latest upstream release, Boost 1.69, was released on December 12th, 2018.
  
Fedora will stay relevant, as far as Boost clients are concerned. Boost 1.68 brings two new libraries:
+
Fedora will stay relevant, as far as Boost clients are concerned. Boost 1.69 brings two new components:
* [https://www.boost.org/doc/libs/1_68_0/doc/html/yap.html YAP], an expression template library for C++14 and later, from Zach Laine.
+
* [https://www.boost.org/libs/yap/ Boost.YAP], an expression template library for C++14 and later, from Zach Laine.
 +
* [https://www.boost.org/libs/safe_numerics/ Boost.Safe Numerics], a library for guaranteed correct integer arithmetic for C++14 and later, from Robert Ramey.
  
 
== Scope ==
 
== Scope ==
 
* 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 "f30-boost" build system tag ([http://lists.fedoraproject.org/pipermail/devel/2011-November/159908.html discussion]): https://pagure.io/releng/issue/7614
+
** Request a "f30-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/8061
 
** 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 78: Line 82:
 
== Dependencies ==
 
== Dependencies ==
 
Packages that must be rebuilt:
 
Packages that must be rebuilt:
<code>$ repoquery -s --releasever=rawhide --whatrequires libboost\* --disablerepo=* --enablerepo=fedora | sort -u</code>
+
<code>$ dnf repoquery -s --releasever=rawhide --whatrequires libboost\* --disablerepo=* --enablerepo=fedora | sort -u</code>
  
 
All clients:
 
All clients:
<code>$ repoquery --releasever=rawhide --archlist=src --whatrequires boost-devel --disablerepo='*' --enablerepo=fedora-source</code>
+
<code>$ dnf repoquery --releasever=rawhide --archlist=src --whatrequires boost-devel --disablerepo='*' --enablerepo=fedora-source</code>
  
 
== Contingency Plan ==
 
== Contingency Plan ==
Line 92: Line 96:
  
 
== Documentation ==
 
== Documentation ==
* https://www.boost.org/users/history/version_1_69_0.html (should be released on the 12 December 2018)
+
* https://www.boost.org/users/history/version_1_69_0.html (released on the 12 December 2018)
 
* https://www.boost.org/users/history/version_1_68_0.html (released on the 9 August 2018)
 
* https://www.boost.org/users/history/version_1_68_0.html (released on the 9 August 2018)
 
* https://www.boost.org/development/index.html
 
* https://www.boost.org/development/index.html
  
 
== Release Notes ==
 
== Release Notes ==
(Incomplete) Boost has been upgraded to version 1.69. Apart from a number of bug fixes and improvements to existing libraries, this brings a new library compared to Fedora 29: Boost.YAP.
+
Boost has been upgraded to version 1.69. Apart from a number of bug fixes and improvements to existing libraries, compared to Fedora 29, this brings:
 +
* A new library: [https://www.boost.org/libs/yap/ Boost.YAP]
 +
* A new header-only component: [https://www.boost.org/libs/safe_numerics/ Boost.Safe Numerics]
 +
* The removal of the Boost.Signals library, replaced by the header-only [https://www.boost.org/doc/libs/1_69_0/libs/signals2/ Boost.Signals2] component
  
[[Category:ChangeAnnounced]]
+
[[Category:ChangeAcceptedF30]]
  
 
[[Category:SystemWideChange]]
 
[[Category:SystemWideChange]]

Latest revision as of 17:52, 25 January 2019


Boost 1.69 upgrade

Summary

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

Owner

  • Name: Jonathan Wakely
  • Email: jwakely at fedoraproject dot org
  • Release notes owner:

Current status

Detailed Description

The aim is to synchronize Fedora with the most recent Boost release. Because ABI stability is one of explicit Boost non-goals, this entails rebuilding of all dependent packages. This has also always entailed yours truly assisting maintainers of client packages in decoding cryptic boost-ese seen in output from g++. Such care is to be expected this time around as well.

The equivalent changes for previous releases were 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 29 includes Boost 1.66, but the latest upstream release, Boost 1.69, was released on December 12th, 2018.

Fedora will stay relevant, as far as Boost clients are concerned. Boost 1.69 brings two new components:

  • Boost.YAP, an expression template library for C++14 and later, from Zach Laine.
  • Boost.Safe Numerics, a library for guaranteed correct integer arithmetic for C++14 and later, from Robert Ramey.

Scope

  • Proposal owners:
    • Build will be done with Boost.Build v2 (which is the upstream-sanctioned way of building Boost)
    • Request a "f30-boost" build system tag (discussion): https://pagure.io/releng/issue/8061
    • 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: [1] (a check of an impact with Release Engineering is needed)
  • Policies and guidelines:
    • Apart from scope, this is business as usual, so no policies, no guidelines.
  • Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

  • No impact on system upgrade.
  • No manual configuration or data migration needed.
  • Some impact on other packages. Historically this hasn't been too big 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.

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 F30 with Boost 1.67, which is already in rawhide.
  • Contingency deadline: We will know whether the change can be made once the rebuilds in the side tag are done, which will be January 2019, ideally before the mass rebuild.
  • Blocks release? No
  • Blocks product? None

Documentation

Release Notes

Boost has been upgraded to version 1.69. Apart from a number of bug fixes and improvements to existing libraries, compared to Fedora 29, this brings: