From Fedora Project Wiki
(change proposal for boost update in f28)
 
 
(7 intermediate revisions by 2 users not shown)
Line 13: Line 13:
 
<!-- Include you email address that you can be reached should people want to contact you about helping with your change, status is requested, or technical issues need to be resolved. If the change proposal is owned by a SIG, please also add a primary contact person. -->
 
<!-- Include you email address that you can be reached should people want to contact you about helping with your change, status is requested, or technical issues need to be resolved. If the change proposal is owned by a SIG, please also add a primary contact person. -->
 
* Email: jwakely@fedoraproject.org
 
* Email: jwakely@fedoraproject.org
* Release notes owner: <!--- To be assigned by docs team [[User:FASAccountName| Release notes owner name]] <email address> -->
+
* Release notes ticket: [https://pagure.io/fedora-docs/release-notes/issue/86 #86]
  
 
== Current status ==
 
== Current status ==
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=1537254 #1537254]
  
 
== Detailed Description ==
 
== Detailed Description ==
Line 36: Line 36:
 
== Benefit to Fedora ==
 
== Benefit to Fedora ==
  
Fedora 27 includes Boost 1.64 but the latest upstream release, Boost 1.64, was released on Apr 19th, 2017 (the 1.65.0 release isn't scheduled until August 9th so would be too late for F27).
+
Fedora 27 includes Boost 1.64 but the latest upstream release, Boost 1.66, was released on Dec 18th, 2017 (the 1.67.0 release isn't scheduled until April so would be too late for F28).
  
 
Fedora will stay relevant, as far as Boost clients are concerned. Boost 1.65 and Boost 1.66 bring five new libraries:
 
Fedora will stay relevant, as far as Boost clients are concerned. Boost 1.65 and Boost 1.66 bring five new libraries:
Line 54: Line 54:
 
* 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 "f28-boost" build system tag ([http://lists.fedoraproject.org/pipermail/devel/2011-November/159908.html discussion]): https://fedorahosted.org/rel-eng/ticket/6235 &rarr; <tt>f24-boost</tt>
+
** Request a "f28-boost" build system tag ([http://lists.fedoraproject.org/pipermail/devel/2011-November/159908.html discussion]): https://pagure.io/releng/issue/7278
 
** 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 64: Line 64:
 
** 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.
 
** 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: [https://pagure.io/releng/issues #Releng issue number] (a check of an impact with Release Engineering is needed) <!-- REQUIRED FOR SYSTEM WIDE AS WELL AS FOR SELF CONTAINED CHANGES -->
+
* Release engineering: [https://pagure.io/releng/issue/7254 #Releng issue 7254] (a check of an impact with Release Engineering is needed) <!-- REQUIRED FOR SYSTEM WIDE AS WELL AS FOR SELF CONTAINED CHANGES -->
 
** [[Fedora_Program_Management/ReleaseBlocking/Fedora{{FedoraVersionNumber|next}}|List of deliverables]]: All deliverables will include updated Boost packages
 
** [[Fedora_Program_Management/ReleaseBlocking/Fedora{{FedoraVersionNumber|next}}|List of deliverables]]: All deliverables will include updated Boost packages
  
* Policies and guidelines: N/A (not a System Wide Change) <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
+
* Policies and guidelines:
 
** Apart from scope, this is business as usual, so no policies, no guidelines.
 
** Apart from scope, this is business as usual, so no policies, no guidelines.
  
 
* Trademark approval: N/A (not needed for this Change)
 
* Trademark approval: N/A (not needed for this Change)
 
  
 
== Upgrade/compatibility impact ==
 
== Upgrade/compatibility impact ==
Line 97: Line 96:
 
== Contingency Plan ==
 
== Contingency Plan ==
  
* Contingency mechanism: Worst case scenario is to abandon the update and simply ship F27 with Boost 1.63, which is already in rawhide.
+
* Contingency mechanism: Worst case scenario is to abandon the update and simply ship F28 with Boost 1.64, 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 early July 2017, before the mass rebuild.
+
* Contingency deadline: We will know whether the change can be made once the rebuilds in the side tag are done, which will be late January 2018, before the mass rebuild.
  
 
* Blocks release? No
 
* Blocks release? No
Line 113: Line 112:
 
(Incomplete) Boost has been upgraded to version 1.66. Apart from a number of bugfixes and improvements to existing libraries, this brings several new libraries compared to Fedora 27: Boost.PolyCollection, Boost.Stacktrace, Boost.Beast, Boost.CallableTraits, Boost.Mp11.
 
(Incomplete) Boost has been upgraded to version 1.66. Apart from a number of bugfixes and improvements to existing libraries, this brings several new libraries compared to Fedora 27: Boost.PolyCollection, Boost.Stacktrace, Boost.Beast, Boost.CallableTraits, Boost.Mp11.
  
[[Category:ChangeReadyForWrangler]]
+
[[Category:ChangeAcceptedF28]]
  
 
[[Category:SystemWideChange]]
 
[[Category:SystemWideChange]]

Latest revision as of 14:48, 2 March 2018

Fedora 28 Boost 1.66 upgrade

Summary

This change brings Boost 1.66.0 to Fedora 28. This will mean F28 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 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 22 Change and Fedora 23 Change and Fedora 24 Change and Fedora 26 Change and Fedora 27 Change.

Benefit to Fedora

Fedora 27 includes Boost 1.64 but the latest upstream release, Boost 1.66, was released on Dec 18th, 2017 (the 1.67.0 release isn't scheduled until April so would be too late for F28).

Fedora will stay relevant, as far as Boost clients are concerned. Boost 1.65 and Boost 1.66 bring five new libraries:

  • Boost.PolyCollection: Fast containers of polymorphic objects
  • Boost.Stacktrace: Gather, store, copy and print backtraces
  • Boost.Beast: Portable HTTP, WebSocket, and network operations using only C++11 and Boost.Asio
  • Boost.CallableTraits: A header-only C++11 library for the compile-time inspection and manipulation of all 'callable' types.
  • Boost.Mp11: A C++11 metaprogramming library

One library has been removed:

  • Boost.TR1


Scope

  • Proposal owners:
    • Build will be done with Boost.Build v2 (which is the upstream-sanctioned way of building Boost)
    • Request a "f28-boost" build system tag (discussion): https://pagure.io/releng/issue/7278
    • 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.
  • 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: $ repoquery -s --releasever=rawhide --whatrequires libboost\* --disablerepo=* --enablerepo=fedora | sort -u

All clients: $ 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 F28 with Boost 1.64, 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 late January 2018, before the mass rebuild.
  • Blocks release? No
  • Blocks product? None


Documentation

Release Notes

(Incomplete) Boost has been upgraded to version 1.66. Apart from a number of bugfixes and improvements to existing libraries, this brings several new libraries compared to Fedora 27: Boost.PolyCollection, Boost.Stacktrace, Boost.Beast, Boost.CallableTraits, Boost.Mp11.