Latest revision as of 14:58, 24 March 2023

FontAwesome6

Summary

Update the FontAwesome package in Fedora to version 6.x, with a compatibility package for packages still needing 4.x.

Owner

Name: Jerry James
Email: loganjerry@gmail.com

Affected maintainers

Current status

Targeted release: Fedora Linux 39
Last updated: 2023-03-24
devel thread
FESCo issue: #2968
Tracker bug: #2181567
Release notes tracker: #971

Detailed Description

The fontawesome-fonts package in Fedora is currently on version 4.7.0. Meanwhile, some packages now require version 5.x or 6.x of the fonts. Since most consumers still want version 4.7.0, the proposal is to introduce a fontawesome4-fonts compatibility package, and move the fontawesome-fonts package to the most recent release, currently version 6.3.0.

Feedback

Benefit to Fedora

Some user-facing applications will be able to display the latest versions of the FontAwesome icons, which have undergone a number of updates and cleanups to provide a more pleasing look. In addition, many new icons have been added in the 5.x and 6.x versions. For example, version 6.x contains a Fedora icon, while previous versions do not.

Scope

Proposal owners:
- The fontawesome-fonts package will be updated to version 6.3.0.
- The python-pydata-sphinx-theme package will be updated to version 0.13.1, which requires FontAwesome 6.x.
- The python-QtAwesome package will be updated to version 1.2.2, which includes FontAwesome 6.x support, and changed to unbundle those fonts that can be unbundled.
- The python-sphinx_ansible_theme package will be updated to version 0.10.1, which permits some spec file simplifications, and updated to depend on fontawesome4-fonts.
- The python-XStatic-Font-Awesome package will be updated to version 6.2.1.1, which requires FontAwesome 6.x.
- The texlive package will be updated to remove an unnecessary dependency on fontawesome-fonts.
- Two new packages will be added to the distribution:
  - fontawesome4-fonts, a nearly exact copy of the current fontawesome-fonts package
  - python-accessible-pygments, to support upgrading the python-pydata-sphinx-theme package
- One package will be retired from the distribution:
  - fontawesome5-fonts, which will be obsoleted by fontawesome-fonts, since version 6.x is backwards compatible with 5.x
- The following packages will be updated to depend on fontawesome4-fonts instead of fontawesome-fonts:
  - freeipa
  - ipsilon
  - python-acme
  - python-f5-sdk
  - python-streamlink
  - sympa
- The following packages will be updated to unbundle the FontAwesome CSS files and depend on fontawesome4-fonts:
  - python-nbclassic
- The following packages will be updated to unbundle the FontAwesome 4.x fonts and depend on fontawesome4-fonts:
  - dogtag-pki
- The following packages will be updated to unbundle the FontAwesome 6.x fonts:
  - R-fontawesome
- The following packages will be updated to build documentation with the new version of python-pydata-sphinx-theme:
  - python-networkx
- Finally, the cantata package will be updated to version 2.5.0, which is the final upstream version. Since upstream has declared itself dead, a patch to use FontAwesome 6.x will be added to the cantata package, so that we can someday retire fontawesome4-fonts.
- All of these changes are available for inspection at this COPR. Changes for an individual package can be seen in jjames's fork of that package.
- Several packages do not need any changes, because they already depend on font(fontawesome), rather than on fontawesome-fonts, as suggested by the font guidelines.
  - coq
  - libgpuarray
  - libsemigroups
  - python-BTrees
  - python-primecountpy
  - python-sphinx_rtd_theme

Other developers:

Maintainers of the packages listed above will need to review the proposed changes and merge them if they are acceptable. Afterwards, I will build all packages in a side tag and merge to Rawhide once all builds are complete.

Release engineering: N/A (not needed for this Change)

Policies and guidelines: N/A (not needed for this Change)

Trademark approval: N/A (not needed for this Change)

Alignment with Community Initiatives:

Upgrade/compatibility impact

Users should not notice this change, except for having fewer bundled copies of the FontAwesome icons on disk.

How To Test

Install packages from the the FontAwesome6 COPR. Launch each one and verify that it displays the expected icons.

User Experience

Users should not see any changes, except for a disk space savings if they have more than one affected package installed.

Dependencies

All dependencies are listed above and will be updated together. If maintainers do not respond to pull requests in a timely manner, then provenpackager privileges can be used to merge the pull requests and do the builds together. The definition of "timely manner" is up for debate.

Contingency Plan

Contingency mechanism: (What to do? Who will do it?) N/A (not a System Wide Change)
Contingency deadline: N/A (not a System Wide Change)
Blocks release? N/A (not a System Wide Change), Yes/No

Documentation

N/A (not a System Wide Change)

Release Notes

The fontawesome-fonts package has been upgraded to version 6.3.0, and a compatibility fontawesome4-fonts package has been introduced for applications that still require FontAwesome 4.7.0. For packages that can use the FontAwesome 6.x icons, the changes described in the FontAwesome changelog are now available. Packages that use the FontAwesome 4.x icons do not have any user-visible changes.

@@ Line 1: / Line 1: @@
-{{admon/important | Comments and Explanations | The page source contains comments providing guidance to fill out each section. They are invisible when viewing this page. To read it, choose the "view source" link.<br/> '''Copy the source to a ''new page'' before making changes!  DO NOT EDIT THIS TEMPLATE FOR YOUR CHANGE PROPOSAL.'''}}
-{{admon/tip | Guidance | For details on how to fill out this form, see the [https://docs.fedoraproject.org/en-US/program_management/changes_guide/ documentation].}}
-{{admon/tip | Report issues | To report an issue with this template, file an issue in the [https://pagure.io/fedora-pgm/pgm_docs pgm_docs repo].}}
 <!-- The actual name of your proposed change page should look something like: Changes/Your_Change_Proposal_Name.  This keeps all change proposals in the same namespace -->
 = FontAwesome6 <!-- The name of your change proposal --> =
-{{Change_Proposal_Banner}}
 == Summary ==
@@ Line 27: / Line 19: @@
 -->
-Affected maintainers:
+=== Affected maintainers ===
 * [[User:xavierb|Xavier Bachelot]]
 * [[User:lbalhar|Lumír Balhar]]
@@ Line 65: / Line 57: @@
 == Current status ==
-[[Category:ChangePageIncomplete]]
+[[Category:ChangeAcceptedF39]]
 <!-- When your change proposal page is completed and ready for review and announcement -->
 <!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
@@ Line 83: / Line 75: @@
 ON_QA -> change is fully code complete
 -->
-* FESCo issue: <will be assigned by the Wrangler>
+* [https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/LCETWWN477NI26IHZ4NX4F3NWPM6GWER/ devel thread]
-* Tracker bug: <will be assigned by the Wrangler>
+* FESCo issue: [https://pagure.io/fesco/issue/2968 #2968]
-* Release notes tracker: <will be assigned by the Wrangler>
+* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=2181567 #2181567]
+* Release notes tracker: [https://pagure.io/fedora-docs/release-notes/issue/971 #971]
 == Detailed Description ==
@@ Line 127: / Line 120: @@
 * Proposal owners:
 <!-- What work do the feature owners have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
-The fontawesome-fonts package will be updated to version 6.3.0.
+** The fontawesome-fonts package will be updated to version 6.3.0.
-The python-pydata-sphinx-theme package will be updated to version 0.13.1, which requires FontAwesome 6.x.
+** The python-pydata-sphinx-theme package will be updated to version 0.13.1, which requires FontAwesome 6.x.
-The python-QtAwesome package will be updated to version 1.2.2, which includes FontAwesome 6.x support, and changed to unbundle those fonts that can be unbundled.
+** The python-QtAwesome package will be updated to version 1.2.2, which includes FontAwesome 6.x support, and changed to unbundle those fonts that can be unbundled.
-The python-sphinx_ansible_theme package will be updated to version 0.10.1, which permits some spec file simplifications, and updated to depende on fontawesome4-fonts.
+** The python-sphinx_ansible_theme package will be updated to version 0.10.1, which permits some spec file simplifications, and updated to depend on fontawesome4-fonts.
-The python-XStatic-Font-Awesome package will be updated to version 6.2.1.1, which requires FontAwesome 6.x.
+** The python-XStatic-Font-Awesome package will be updated to version 6.2.1.1, which requires FontAwesome 6.x.
-The texlive package will be updated to remove an unnecessary dependency on fontawesome-fonts.
+** The texlive package will be updated to remove an unnecessary dependency on fontawesome-fonts.
-Two new packages will be added to the distribution:
+** Two new packages will be added to the distribution:
-    - fontawesome4-fonts, a nearly exact copy of the current fontawesome-fonts package
+*** fontawesome4-fonts, a nearly exact copy of the current fontawesome-fonts package
-    - python-accessible-pygments, to support upgrading the python-pydata-sphinx-theme package
+*** python-accessible-pygments, to support upgrading the python-pydata-sphinx-theme package
-One package will be retired from the distribution:
+** One package will be retired from the distribution:
-    - fontawesome5-fonts, which will be obsoleted by fontawesome-fonts, since version 6.x is backwards compatible with 5.x
+*** fontawesome5-fonts, which will be obsoleted by fontawesome-fonts, since version 6.x is backwards compatible with 5.x
-The following packages will be updated to depend on fontawesome4-fonts instead of fontawesome-fonts:
+** The following packages will be updated to depend on fontawesome4-fonts instead of fontawesome-fonts:
-    - freeipa
+*** freeipa
-    - ipsilon
+*** ipsilon
-    - python-acme
+*** python-acme
-    - python-f5-sdk
+*** python-f5-sdk
-    - python-streamlink
+*** python-streamlink
-    - sympa
+*** sympa
-The following packages will be updated to unbundle the FontAwesome CSS files and depend on fontawesome4-fonts:
+** The following packages will be updated to unbundle the FontAwesome CSS files and depend on fontawesome4-fonts:
-    - python-nbclassic
+*** python-nbclassic
-The following packages will be updated to unbundle the FontAwesome 4.x fonts and depend on fontawesome4-fonts:
+** The following packages will be updated to unbundle the FontAwesome 4.x fonts and depend on fontawesome4-fonts:
-    - dogtag-pki
+*** dogtag-pki
-The following packages will be updated to unbundle the FontAwesome 6.x fonts:
+** The following packages will be updated to unbundle the FontAwesome 6.x fonts:
-    - R-fontawesome
+*** R-fontawesome
-The following packages will be updated to build documentation with the new version of python-pydata-sphinx-theme:
+** The following packages will be updated to build documentation with the new version of python-pydata-sphinx-theme:
-    - python-networkx
+*** python-networkx
-Finally, the cantata package will be updated to version 2.5.0, which is the final upstream version.  Since upstream has declared itself dead, a patch to use FontAwesome 6.x will be added to the cantata package, so that we can someday retire fontawesome4-fonts.
+** Finally, the cantata package will be updated to version 2.5.0, which is the final upstream version.  Since upstream has declared itself dead, a patch to use FontAwesome 6.x will be added to the cantata package, so that we can someday retire fontawesome4-fonts.
+** All of these changes are available for inspection at [https://copr.fedorainfracloud.org/coprs/jjames/FontAwesome6 this COPR].  Changes for an individual package can be seen in jjames's fork of that package.
-All of these changes are available for inspection at [https://copr.fedorainfracloud.org/coprs/jjames/FontAwesome6 this COPR].  Changes for an individual package can be seen in jjames's fork of that package.
+** Several packages do not need any changes, because they already depend on `font(fontawesome)`, rather than on fontawesome-fonts, as suggested by [https://docs.fedoraproject.org/en-US/packaging-guidelines/FontsPolicy/#_dependencies_to_font_packages_in_other_packages the font guidelines].
+*** coq
-Several packages do not need any changes, because they already depend on `font(fontawesome)`, rather than on fontawesome-fonts, as suggested by [https://docs.fedoraproject.org/en-US/packaging-guidelines/FontsPolicy/#_dependencies_to_font_packages_in_other_packages the font guidelines].
+*** libgpuarray
-    - coq
+*** libsemigroups
-    - libgpuarray
+*** python-BTrees
-    - libsemigroups
+*** python-primecountpy
-    - python-BTrees
+*** python-sphinx_rtd_theme
-    - python-primecountpy
-    - python-sphinx_rtd_theme
 * Other developers: <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 <!-- What work do other developers have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
+Maintainers of the packages listed above will need to review the proposed changes and merge them if they are acceptable.  Afterwards, I will build all packages in a side tag and merge to Rawhide once all builds are complete.
-* Release engineering: [https://pagure.io/releng/issues #Releng issue number] <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
+* Release engineering: N/A (not needed for this Change) <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 <!-- Does this feature require coordination with release engineering (e.g. changes to installer image generation or update package delivery)?  Is a mass rebuild required?  include a link to the releng issue.
 The issue is required to be filed prior to feature submission, to ensure that someone is on board to do any process development work and testing and that all changes make it into the pipeline; a bullet point in a change is not sufficient communication -->
@@ Line 178: / Line 170: @@
 <!-- If your Change may require trademark approval (for example, if it is a new Spin), file a ticket ( https://pagure.io/Fedora-Council/tickets/issues ) requesting trademark approval from the Fedora Council. This approval will be done via the Council's consensus-based process. -->
-* Alignment with Objectives:
+* Alignment with Community Initiatives:
 <!-- Does your proposal align with the current Fedora Objectives: https://docs.fedoraproject.org/en-US/project/objectives/ ? It's okay if it doesn't, but it's something to consider -->
 == Upgrade/compatibility impact ==
 <!-- What happens to systems that have had a previous versions of Fedora installed and are updated to the version containing this change? Will anything require manual configuration or data migration? Will any existing functionality be no longer supported? -->
+Users should not notice this change, except for having fewer bundled copies of the FontAwesome icons on disk.
-<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 == How To Test ==
@@ Line 201: / Line 191: @@
 . What are the expected results of those actions?
 -->
+Install packages from the [https://copr.fedorainfracloud.org/coprs/jjames/FontAwesome6 the FontAwesome6 COPR].  Launch each one and verify that it displays the expected icons.
-<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 == User Experience ==
@@ Line 216: / Line 204: @@
   - Green has been scientifically proven to be the most relaxing color. The move to a default background color of green with green text will result in Fedora users being the most relaxed users of any operating system.
 -->
+Users should not see any changes, except for a disk space savings if they have more than one affected package installed.
 == Dependencies ==
 <!-- What other packages (RPMs) depend on this package?  Are there changes outside the developers' control on which completion of this change depends?  In other words, completion of another change owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate?  Other upstream projects like the kernel (if this is not a kernel change)? -->
+All dependencies are listed above and will be updated together.  If maintainers do not respond to pull requests in a timely manner, then provenpackager privileges can be used to merge the pull requests and do the builds together.  The definition of "timely manner" is up for debate.
-<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 == Contingency Plan ==
@@ Line 231: / Line 218: @@
 <!-- Does finishing this feature block the release, or can we ship with the feature in incomplete state? -->
 * Blocks release? N/A (not a System Wide Change), Yes/No <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 == Documentation ==
@@ Line 245: / Line 231: @@
 Release Notes are not required for initial draft of the Change Proposal but has to be completed by the Change Freeze.
 -->
+The fontawesome-fonts package has been upgraded to version 6.3.0, and a compatibility fontawesome4-fonts package has been introduced for applications that still require FontAwesome 4.7.0.  For packages that can use the FontAwesome 6.x icons, the changes described in [https://fontawesome.com/docs/changelog/ the FontAwesome changelog] are now available.  Packages that use the FontAwesome 4.x icons do not have any user-visible changes.

Search

Changes/FontAwesome6: Difference between revisions