From b7a1031447eae95bc492500d03d96f0b8bce047f Mon Sep 17 00:00:00 2001 From: Peng Wu Date: Tue, 27 Sep 2022 15:54:06 +0800 Subject: [PATCH 01/85] Issue 870 - ibus-libpinyin 1.13 --- modules/release-notes/pages/desktop/I18n.adoc | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 modules/release-notes/pages/desktop/I18n.adoc diff --git a/modules/release-notes/pages/desktop/I18n.adoc b/modules/release-notes/pages/desktop/I18n.adoc new file mode 100644 index 0000000..3441c38 --- /dev/null +++ b/modules/release-notes/pages/desktop/I18n.adoc @@ -0,0 +1,8 @@ +include::{partialsdir}/entities.adoc[] + +[[sect-i18n]] += Internationalization + +== ibus-libpinyin 1.13 + +The ibus-libpinyin package will make English input and Table input in the "Intelligent Pinyin" input method easier. From b272b348fc85063c02d2a0ce8728b36425c46523 Mon Sep 17 00:00:00 2001 From: Sundeep Anand Date: Wed, 28 Sep 2022 16:34:50 +0530 Subject: [PATCH 02/85] Issue 852 - Gettext Runtime Subpackage --- modules/release-notes/nav.adoc | 1 + modules/release-notes/pages/desktop/I18n.adoc | 10 ++++++++++ 2 files changed, 11 insertions(+) create mode 100644 modules/release-notes/pages/desktop/I18n.adoc diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index a91003f..bc001a2 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -13,6 +13,7 @@ include::{partialsdir}/entities.adoc[] *** xref:sysadmin/System_Utilities.adoc[System Utilities] *** xref:sysadmin/Printing_Scanning.adoc[Printing and Scanning] ** xref:desktop/Desktop_index.adoc[Desktop Users] +*** xref:desktop/I18n.adoc[Internationalization] ** xref:developers/Developers.adoc[Developers] *** xref:developers/Development_Tools.adoc[Development Tools] *** xref:developers/Development_Binutils.adoc[Binutils] diff --git a/modules/release-notes/pages/desktop/I18n.adoc b/modules/release-notes/pages/desktop/I18n.adoc new file mode 100644 index 0000000..d7948c0 --- /dev/null +++ b/modules/release-notes/pages/desktop/I18n.adoc @@ -0,0 +1,10 @@ +include::{partialsdir}/entities.adoc[] + +[[sect-i18n]] += Internationalization + +[[gettext-runtime]] +== Gettext Runtime Subpackage + +Two subpackages gettext-runtime and gettext-envsubst have been added to gettext to separate out the programs needed at runtime, reducing the default install footprint. + From c3efe391809fe1f7bc9f5a00249d3af355f15096 Mon Sep 17 00:00:00 2001 From: Francois Andrieu Date: Sat, 29 Oct 2022 15:54:30 +0200 Subject: [PATCH 03/85] branch for F37 --- antora.yml | 2 +- modules/release-notes/nav.adoc | 2 +- modules/release-notes/pages/_partials/entities.adoc | 6 +++--- site.yml | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/antora.yml b/antora.yml index d70d031..eb59e5c 100644 --- a/antora.yml +++ b/antora.yml @@ -1,5 +1,5 @@ --- name: fedora -version: rawhide +version: f37 # Navigation is in the main 'fedora' component: # https://pagure.io/fedora-docs/release-docs-home diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index a91003f..1694a2f 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -25,5 +25,5 @@ include::{partialsdir}/entities.adoc[] *** xref:developers/Development_Ruby.adoc[Ruby] *** xref:developers/Development_Web.adoc[Web Development] //CHANGE THIS WITH A NEW RELEASE -** link:https://fedoraproject.org/wiki/Common_F34_bugs[Common Bugs] +** link:https://fedoraproject.org/wiki/Common_F37_bugs[Common Bugs] ** xref:Revision_History.adoc[Revision History] diff --git a/modules/release-notes/pages/_partials/entities.adoc b/modules/release-notes/pages/_partials/entities.adoc index a1a49f1..d5e962e 100644 --- a/modules/release-notes/pages/_partials/entities.adoc +++ b/modules/release-notes/pages/_partials/entities.adoc @@ -1,8 +1,8 @@ :BOOKID: release-notes :BZURL: https://pagure.io/fedora-docs/release-notes/issues -:COMMONBUGS_URL: https://fedoraproject.org/wiki/Common_F34_bugs +:COMMONBUGS_URL: https://fedoraproject.org/wiki/Common_F37_bugs :HOLDER: Fedora Project Contributors -:PREVVER: 35 +:PREVVER: 36 :PRODUCT: Fedora Documentation -:PRODVER: Rawhide +:PRODVER: 37 :YEAR: 2022 diff --git a/site.yml b/site.yml index 74042de..db12838 100644 --- a/site.yml +++ b/site.yml @@ -6,7 +6,7 @@ content: - url: . branches: HEAD - url: https://pagure.io/fedora-docs/release-docs-home.git - branches: master + branches: f37 ui: bundle: url: https://asamalik.fedorapeople.org/ui-bundle.zip From a19482528e009cfb80c0c1cdf1a289c6fe12274a Mon Sep 17 00:00:00 2001 From: Jaroslav Klech Date: Fri, 4 Nov 2022 14:23:42 +0100 Subject: [PATCH 04/85] Describes iss867 --- .../pages/sysadmin/System_Utilities.adoc | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/System_Utilities.adoc b/modules/release-notes/pages/sysadmin/System_Utilities.adoc index 05c5a23..edcd064 100644 --- a/modules/release-notes/pages/sysadmin/System_Utilities.adoc +++ b/modules/release-notes/pages/sysadmin/System_Utilities.adoc @@ -2,3 +2,16 @@ include::{partialsdir}/entities.adoc[] [[sect-system-utilities]] = System Utilities + + +[[preset-all-systemd-units-on-first-boot]] +== Preset all systemd units on first boot + +On a Fedora system you booted from an image without the fully populated `/etc/` directory (https://www.freedesktop.org/software/systemd/man/machine-id.html#First%20Boot%20Semantics[First Boot]), `systemd` will execute an equivalent of the `systemctl preset-all` command. As a result, units will be enabled or disabled according to the preset configuration. + +[NOTE] +==== +The `systemd` service manager will disable any units, to which you manually created symbolic links against the preset rules. +==== + +You can use the `systemctl preset-all` command at any time to apply the preset configuration. If you did not make any prior local changes to the configuration, the command would make no changes to unit state. If you enabled or disabled some units, the command would return unit enablement to the after-installation pristine state. From cfa13e51e7a56dbf7a6fc0f9620f016cd57b0ec4 Mon Sep 17 00:00:00 2001 From: Jaroslav Klech Date: Mon, 7 Nov 2022 15:27:37 +0100 Subject: [PATCH 05/85] Describes issue #818 --- modules/release-notes/pages/sysadmin/Security.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Security.adoc b/modules/release-notes/pages/sysadmin/Security.adoc index dcabdc5..21709f6 100644 --- a/modules/release-notes/pages/sysadmin/Security.adoc +++ b/modules/release-notes/pages/sysadmin/Security.adoc @@ -3,3 +3,12 @@ include::{partialsdir}/entities.adoc[] [[sect-security]] = Security + +[[fido-onboarding]] +== Fedora IoT supports FIDO device onboarding + +The ability for an IoT or Edge device to be plugged in and automatically onboard itself with zero user interaction is critical for scaling. To do this in a secure way with open standards is even more critical. Therefore, the FIDO IoT working group has collaborated with leaders in the silicon industry to produce the FIDO Device Onboarding specification. + +With this update, Fedora IoT provides the FIDO Device Onboarding software stack for Zero Touch Onboarding. + +The aim is to demonstrate the use of the leading edge open industry protocols for onboarding IoT and Edge devices. From 1e5926b500f918bf8a554a8abde709a0989a47d1 Mon Sep 17 00:00:00 2001 From: Jaroslav Klech Date: Fri, 4 Nov 2022 15:34:52 +0100 Subject: [PATCH 06/85] Describes issue #865 --- .../release-notes/pages/sysadmin/Distribution.adoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index efbfd5d..f2b9e5d 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -3,3 +3,17 @@ include::{partialsdir}/entities.adoc[] [[select-distribution]] = Distribution-wide Changes + +[[raspberry-pi-4]] +== Official support for Raspberry Pi 4 + +This Fedora update brings support for Raspberry Pi 4, including 4B, the 400 unit, and the Compute Module (CM) 4 IO Board. All the mentioned models support also accelerated graphics using the V3D GPU for both OpenGL-ES and Vulkan. + +Some minor caveats include: + +* Support for WiFi on the Raspberry Pi 400 is out of scope of this change. +* We tested CM 4 and will support on the official IO board. Other devices that incorporate CM 4 should work correctly provided the vendor has their support in the upstream Raspberry Pi firmware/overlays. +* The hardware based media decoding (H264/HVEC, and others) are our of scope for this change. + + + From 3b70ccdf31f75993e8a4ac6926babac8e0f73da6 Mon Sep 17 00:00:00 2001 From: Jaroslav Klech Date: Thu, 3 Nov 2022 12:00:26 +0100 Subject: [PATCH 07/85] Describes updates for BIND9 --- .../pages/sysadmin/Networking.adoc | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Networking.adoc b/modules/release-notes/pages/sysadmin/Networking.adoc index 960a425..17657f1 100644 --- a/modules/release-notes/pages/sysadmin/Networking.adoc +++ b/modules/release-notes/pages/sysadmin/Networking.adoc @@ -3,3 +3,21 @@ include::{partialsdir}/entities.adoc[] [[networking]] = Networking + + +== BIND 9 + +Berkeley Internet Name Domain (BIND) software suite was updated to version 9.18.x. This version brings the following notable changes, for example: + +* Support for DNS over TLS and DNS over HTTPS servers. Both authoritative and resolver modes. +* Re-work of internal connection handling using the `libuv` library. +* Remote Name Daemon Control (RNDC) channel does not support Unix sockets. +* Support for incoming and outgoing DNS zone transfer over TLS. +* Domain Information Groper (dig) utility can send queries using DNS over TLS and DNS over HTTPS. + +[NOTE] +==== +The `bind-dyndb-ldap` dynamic LDAP back-end was upgraded to version 11.10 to support support BIND 9.18. The back-end will be built together with the `bind` package. +==== + +You can see the full list of changes in the https://bind9.readthedocs.io/en/v9_18_4/notes.html#notes-for-bind-9-18-0[upstream release notes]. \ No newline at end of file From b65a1ca8152b5a046c4d98e7f6dfae2fcbc1376d Mon Sep 17 00:00:00 2001 From: Jaroslav Klech Date: Thu, 3 Nov 2022 10:58:22 +0100 Subject: [PATCH 08/85] Documents Mumble update to 1.4 version --- .../pages/desktop/Multimedia.adoc | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 modules/release-notes/pages/desktop/Multimedia.adoc diff --git a/modules/release-notes/pages/desktop/Multimedia.adoc b/modules/release-notes/pages/desktop/Multimedia.adoc new file mode 100644 index 0000000..99b97a1 --- /dev/null +++ b/modules/release-notes/pages/desktop/Multimedia.adoc @@ -0,0 +1,22 @@ +include::{partialsdir}/entities.adoc[] + +[[sect-multimedia]] += Multimedia + + +[[mumble-1-4]] + +== Mumble 1.4 + +Mumble is a popular voice chat application. It is commonly used for gaming and podcasts. + +This update brings for example the following changes: + +* Enable the native PipeWire audio backend +* Rename the Mumble server package from `murmur` to `mumble-server` +* Relocate the Mumble server configuration file from `/etc/murmur/murmur.ini` to `/etc/murmur.ini` +* Introduce a new, general purpose plugin framework +* Substitute a sub-optimal free-type search for a fully featured search dialog +* Support markdown markup language for text messages in the chat bar + +You can see the full list of changes in the https://www.mumble.info/blog/mumble-1.4.230/[upstream release notes]. \ No newline at end of file From a6e54e0bb2d9ad7db60d1ebe5dee99f33c5a8980 Mon Sep 17 00:00:00 2001 From: Takao Fujiwara Date: Mon, 31 Oct 2022 15:12:17 +0900 Subject: [PATCH 09/85] Add IBus 1.5.27 Resolves issue 857. --- modules/release-notes/pages/desktop/I18n.adoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 modules/release-notes/pages/desktop/I18n.adoc diff --git a/modules/release-notes/pages/desktop/I18n.adoc b/modules/release-notes/pages/desktop/I18n.adoc new file mode 100644 index 0000000..75c4c56 --- /dev/null +++ b/modules/release-notes/pages/desktop/I18n.adoc @@ -0,0 +1,14 @@ +include::{partialsdir}/entities.adoc[] + +:experimental: + +[[sect-i18n]] += Internationalization + +[[ibus]] +== IBus 1.5.27 +* `ibus restart` subcommand is enhanced for the GNOME desktop session. Previously `ibus restart` subcommand failed to restart ibus-daemon but now it’s also connected to systemd by default. The other options can be shown with `ibus restart --help` subcommand. +* `ibus im-module` subcommand is added newly to get an internal gtk-im-module value from an instance of an GTK instance and this subcommand would be useful in case that users install IBus input method framework by manual and they check if IBus is installed properly. +* IBus Emoji shortcut key is now reverted to kbd:[🪟+.](Super+Period). +* IBus theme of the candidate window can be customized with ibus-setup utility in non-GNOME desktop sessions. IBus theme has inherited the GTK themes in the desktop session by default and this is useful for other desktop sessions likes KDE. + From 2c21f03f3480a130e540f1e91ce7e4bae5957adc Mon Sep 17 00:00:00 2001 From: Jens Petersen Date: Thu, 29 Sep 2022 15:18:44 +0800 Subject: [PATCH 10/85] add Haskell f37 relnotes (#873) --- .../release-notes/pages/developers/Development_Haskell.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/developers/Development_Haskell.adoc b/modules/release-notes/pages/developers/Development_Haskell.adoc index 7a2af12..6fc8ed8 100644 --- a/modules/release-notes/pages/developers/Development_Haskell.adoc +++ b/modules/release-notes/pages/developers/Development_Haskell.adoc @@ -3,3 +3,9 @@ include::{partialsdir}/entities.adoc[] [[sect-haskell]] = Haskell +The Haskell GHC compiler has been updated from 8.10.5 to 8.10.7 +with some important bugfixes. Haskell packages were updated +to final Stackage 18.28 versions. + +Newer versions of GHC are available via the +ghc9.0, ghc9.2, and ghc9.4 packages. \ No newline at end of file From dc2718f766aa9133d260c5b9b548eec53c8a0762 Mon Sep 17 00:00:00 2001 From: mulhern Date: Wed, 21 Sep 2022 21:17:20 -0400 Subject: [PATCH 11/85] Stratis release notes Signed-off-by: mulhern --- modules/release-notes/pages/sysadmin/Storage.adoc | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Storage.adoc b/modules/release-notes/pages/sysadmin/Storage.adoc index 54bd7cf..b2146bb 100644 --- a/modules/release-notes/pages/sysadmin/Storage.adoc +++ b/modules/release-notes/pages/sysadmin/Storage.adoc @@ -3,3 +3,16 @@ include::{partialsdir}/entities.adoc[] [[sect-storage]] = Storage + +== Stratis 3.2.0 +The upgrade to Stratis 3.2.0 includes the following significant new features: + +* In https://stratis-storage.github.io/stratis-release-notes-3-1-0/[Stratis 3.1.0], +a complete redesign and reimplementation of thinpool block layer management. +See https://stratis-storage.github.io/thin-provisioning-redesign/[the separate blog post] +for more detailed discussion of the redesign. +* In https://stratis-storage.github.io/stratis-release-notes-3-2-0/[Stratis 3.2.0], the ability to stop and to start individual pools. + +Please see +https://github.com/stratis-storage/stratisd/blob/master/CHANGES.txt[the stratisd changelog] and +https://github.com/stratis-storage/stratis-cli/blob/master/CHANGES.txt[the stratis-cli changelog] for further details. From 555c03d2232aa6711ad872445b6c0dcb884971df Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 05:02:36 +0100 Subject: [PATCH 12/85] Update brand file to latest on gitlab --- site.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site.yml b/site.yml index 74042de..2dccc95 100644 --- a/site.yml +++ b/site.yml @@ -9,7 +9,7 @@ content: branches: master ui: bundle: - url: https://asamalik.fedorapeople.org/ui-bundle.zip + url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable snapshot: true default_layout: with_menu output: From c786c8bf251108a150abf0780645f5564cd53e34 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 05:02:36 +0100 Subject: [PATCH 13/85] Update brand file to latest on gitlab --- site.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site.yml b/site.yml index db12838..2c404cd 100644 --- a/site.yml +++ b/site.yml @@ -9,7 +9,7 @@ content: branches: f37 ui: bundle: - url: https://asamalik.fedorapeople.org/ui-bundle.zip + url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable snapshot: true default_layout: with_menu output: From 8faffa038809efd2866fa2fc6c7159909f563536 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 05:09:39 +0100 Subject: [PATCH 14/85] Add link to Anaconda upstream relnotes --- .../release-notes/pages/sysadmin/Installation.adoc | 11 +---------- 1 file changed, 1 insertion(+), 10 deletions(-) diff --git a/modules/release-notes/pages/sysadmin/Installation.adoc b/modules/release-notes/pages/sysadmin/Installation.adoc index 1ef5ee6..77123db 100644 --- a/modules/release-notes/pages/sysadmin/Installation.adoc +++ b/modules/release-notes/pages/sysadmin/Installation.adoc @@ -4,13 +4,4 @@ include::{partialsdir}/entities.adoc[] [[sect-installation]] = Installation -[[sect-installation-anaconda]] -== Anaconda changes - -This section covers changes in the [application]*Anaconda* installer, including changes in the graphical and text mode interactive installers, Kickstart, and installer boot options. - -[[sect-installation-anaconda-general]] -=== General changes - -[[sect-installation-kickstart]] -=== Kickstart changes +Release notes for the Fedora installer, Anaconda, as well as related topics, are now being maintained upstream. See the project's link:https://anaconda-installer--4379.org.readthedocs.build/en/4379/release-notes.html#fedora-37[ReadTheDocs] documentation for a full list of installer-related changes in Fedora 37. From d30f59ad2bb68710aa8c4dd47a10df96cdc235bb Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 05:13:33 +0100 Subject: [PATCH 15/85] Server edition as KVM disk image --- modules/release-notes/pages/sysadmin/Distribution.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index f2b9e5d..e3afda4 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -15,5 +15,11 @@ Some minor caveats include: * We tested CM 4 and will support on the official IO board. Other devices that incorporate CM 4 should work correctly provided the vendor has their support in the upstream Raspberry Pi firmware/overlays. * The hardware based media decoding (H264/HVEC, and others) are our of scope for this change. +[[server-kvm-image]] +== Fedora Server Edition available as KVM virtual machine disk image +Fedora Server provides now a virtual disk image to greatly facilitate installation of Fedora Server VMs. It allows an immediate installation by either Cockpit administration WEB UI or one of the CLI tools. +The image is optimized for KVM and aims to resemble a default server installation as closely as possible. All administrative tools are available reliably from the beginning, all administrative routines and helps (scripts) can be used in the same way. All application services work the same as in the standard installation. + +The server documentation link:https://docs.fedoraproject.org/en-US/fedora-server/virtualization/vm-install-diskimg-fedoraserver/[Creating a virtual machine using Fedora Server Edition disk image] provides detailed information on installing and using the disk image. From 50d8ba5bf5cd89ecd21a755dc7857fe832ecf4cd Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 08:08:31 +0100 Subject: [PATCH 16/85] Add fallback hostname --- modules/release-notes/pages/sysadmin/Networking.adoc | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/modules/release-notes/pages/sysadmin/Networking.adoc b/modules/release-notes/pages/sysadmin/Networking.adoc index 17657f1..450f792 100644 --- a/modules/release-notes/pages/sysadmin/Networking.adoc +++ b/modules/release-notes/pages/sysadmin/Networking.adoc @@ -20,4 +20,8 @@ Berkeley Internet Name Domain (BIND) software suite was updated to version 9.18. The `bind-dyndb-ldap` dynamic LDAP back-end was upgraded to version 11.10 to support support BIND 9.18. The back-end will be built together with the `bind` package. ==== -You can see the full list of changes in the https://bind9.readthedocs.io/en/v9_18_4/notes.html#notes-for-bind-9-18-0[upstream release notes]. \ No newline at end of file +You can see the full list of changes in the https://bind9.readthedocs.io/en/v9_18_4/notes.html#notes-for-bind-9-18-0[upstream release notes]. + +== Fallback hostname set to `localhost` on server-based editions + +For the Cloud, CoreOS, IoT, and Server editions of Fedora, the fallback hostname has been changed to `localhost`. The fallback hostname is the hostname that is set if the hostname cannot be determined by any other mechanism (statically set, DHCP, or reverse DNS). This change was made in order to conform to the common expectation that a hostname of `localhost` on a system means the hostname is "unset". From 3968d963a6ee0b16e680f16b3185f6f557032bca Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 08:52:05 +0100 Subject: [PATCH 17/85] 843 - BIOS boot.iso with GRUB2 --- modules/release-notes/pages/sysadmin/Distribution.adoc | 5 +++++ modules/release-notes/pages/sysadmin/Installation.adoc | 7 +++++++ 2 files changed, 12 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index e3afda4..1d55f46 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -23,3 +23,8 @@ Fedora Server provides now a virtual disk image to greatly facilitate installati The image is optimized for KVM and aims to resemble a default server installation as closely as possible. All administrative tools are available reliably from the beginning, all administrative routines and helps (scripts) can be used in the same way. All application services work the same as in the standard installation. The server documentation link:https://docs.fedoraproject.org/en-US/fedora-server/virtualization/vm-install-diskimg-fedoraserver/[Creating a virtual machine using Fedora Server Edition disk image] provides detailed information on installing and using the disk image. + +[[boot-iso-grub2]] +== boot.iso now uses GRUB2 on BIOS systems + +See xref:sysadmin/Installation.adoc#boot-iso-grub2[Distribution]. diff --git a/modules/release-notes/pages/sysadmin/Installation.adoc b/modules/release-notes/pages/sysadmin/Installation.adoc index 77123db..0df1eee 100644 --- a/modules/release-notes/pages/sysadmin/Installation.adoc +++ b/modules/release-notes/pages/sysadmin/Installation.adoc @@ -4,4 +4,11 @@ include::{partialsdir}/entities.adoc[] [[sect-installation]] = Installation +== Anaconda and related components + Release notes for the Fedora installer, Anaconda, as well as related topics, are now being maintained upstream. See the project's link:https://anaconda-installer--4379.org.readthedocs.build/en/4379/release-notes.html#fedora-37[ReadTheDocs] documentation for a full list of installer-related changes in Fedora 37. + +[[boot-iso-grub2]] +== boot.iso now uses GRUB2 on BIOS systems + +In previous Fedora releases, the minimal installer image (`boot.iso`) used the syslinux bootloader when booting on systems using BIOS firmware, while on UEFI systems GRUB2 is used. However, the syslinux project is no longer being developed upstream. Therefore, starting with Fedora 37, `boot.iso` images will use GRUB2 on both BIOS and UEFI-based systems. From f3384b5b37f005d6e097eb5268f20de0e25843cd Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 08:57:03 +0100 Subject: [PATCH 18/85] 776 - Retire ARMv7 --- modules/release-notes/pages/sysadmin/Distribution.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index 1d55f46..3f30e0f 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -15,6 +15,11 @@ Some minor caveats include: * We tested CM 4 and will support on the official IO board. Other devices that incorporate CM 4 should work correctly provided the vendor has their support in the upstream Raspberry Pi firmware/overlays. * The hardware based media decoding (H264/HVEC, and others) are our of scope for this change. +[[retire-armv7]] +== ARMv7 architecture is no longer supported + +Fedora 37 drops support for older ARM devices using the ARMv7 (also known as arm32 or armhfp) architecture. Such devices running older Fedora releases will not be able to upgrade, and will not be able to do a fresh Fedora 37 installation. + [[server-kvm-image]] == Fedora Server Edition available as KVM virtual machine disk image From 63923428fe8aafb2d51d38d61f271ff331bc6391 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 10:31:07 +0100 Subject: [PATCH 19/85] 746 and 842 - Python changes --- .../pages/developers/Development_Python.adoc | 37 +++++++++++++++++++ .../pages/sysadmin/Distribution.adoc | 4 ++ .../pages/sysadmin/Security.adoc | 4 ++ 3 files changed, 45 insertions(+) diff --git a/modules/release-notes/pages/developers/Development_Python.adoc b/modules/release-notes/pages/developers/Development_Python.adoc index 9a2ac8c..e9f5a21 100644 --- a/modules/release-notes/pages/developers/Development_Python.adoc +++ b/modules/release-notes/pages/developers/Development_Python.adoc @@ -3,3 +3,40 @@ include::{partialsdir}/entities.adoc[] [[sect-python]] = Python + +== Python 3.11 + +Fedora 37 provides the Python stack in version 3.11, up from version 3.10 in the previous release. Notable changes include: + +* Exception Groups and `except*` +* Enhanced error locations in tracebacks +* Support for parsing TOML in the standard library +* A massive speed improvement compared to Python 3.10 + +Typing features: + +* Variadic generics +* Marking individual `TypedDict` items as required or potentially-missing +* Self type +* Arbitrary literal string type +* Dataclass transforms + +For a full list of changes, see the link:https://docs.python.org/3.11/whatsnew/3.11.html[What's New In Python 3.11] upstream document. Also see link:https://docs.python.org/3.11/whatsnew/3.11.html#porting-to-python-3-11[Porting to Python 3.11] if you have Python programs running on an older version. + +[[default-shebangs]] +== Add -P to default shebangs + +All Python 3 shebang RPM macros in Fedora 37 have been changed to contain one more flag: `-P`. Previously, they contained `-s`, now they contain `-sP`. The `-P` flag was introduced in Python 3.11. + +The new flag stops Python from prepending a potentially unsafe path to `sys.path`. This causes Python programs in `/usr/bin` to be less fragile towards random files present in the same directory, making debugging certain types of issues easier and enhancing security. + +The following RPM macros are affected by this change: + +* `%{py3_shbang_opts}` +* `%{py3_shbang_opts_nodash}` +* `%{py3_shebang_flags}` +* `%{py_shbang_opts}` +* `%{py_shbang_opts_nodash}` +* `%{py_shebang_flags}` + +For a detailed explanation of what this change means, a list of affected packages, and information on how to opt out of this change (or explicitly opt in) if needed, see the link:https://fedoraproject.org/wiki/Changes/PythonSafePath#Detailed_Description[Fedora Wiki]. diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index 3f30e0f..ca71d04 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -33,3 +33,7 @@ The server documentation link:https://docs.fedoraproject.org/en-US/fedora-server == boot.iso now uses GRUB2 on BIOS systems See xref:sysadmin/Installation.adoc#boot-iso-grub2[Distribution]. + +== Python3 packages are now built with -P + +See xref:developers/Development_Python.adoc#default-shebangs[Python]. diff --git a/modules/release-notes/pages/sysadmin/Security.adoc b/modules/release-notes/pages/sysadmin/Security.adoc index 21709f6..b2512de 100644 --- a/modules/release-notes/pages/sysadmin/Security.adoc +++ b/modules/release-notes/pages/sysadmin/Security.adoc @@ -12,3 +12,7 @@ The ability for an IoT or Edge device to be plugged in and automatically onboard With this update, Fedora IoT provides the FIDO Device Onboarding software stack for Zero Touch Onboarding. The aim is to demonstrate the use of the leading edge open industry protocols for onboarding IoT and Edge devices. + +== Python3 packages are now built with -P + +See xref:developers/Development_Python.adoc#default-shebangs[Python]. From 782b373eba61847499c7c57502581d020af424d5 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 10:35:34 +0100 Subject: [PATCH 20/85] 847 - Restore Cloud Base as Edition --- modules/release-notes/pages/sysadmin/Distribution.adoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index ca71d04..3c032d6 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -37,3 +37,7 @@ See xref:sysadmin/Installation.adoc#boot-iso-grub2[Distribution]. == Python3 packages are now built with -P See xref:developers/Development_Python.adoc#default-shebangs[Python]. + +== Fedora Cloud Base is now a Fedora Edition + +Fedora Cloud Base has been promoted to official status as a Fedora Edition. Fedora Cloud Base Images can now be downloaded from https://getfedora.org. From dc2c91202530c94bf949f26cc768d65c1f32626e Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 13:18:50 +0100 Subject: [PATCH 21/85] 845 - Enhanced Persian font support --- modules/release-notes/pages/desktop/I18n.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/modules/release-notes/pages/desktop/I18n.adoc b/modules/release-notes/pages/desktop/I18n.adoc index 8f50aa7..427a189 100644 --- a/modules/release-notes/pages/desktop/I18n.adoc +++ b/modules/release-notes/pages/desktop/I18n.adoc @@ -17,3 +17,8 @@ The ibus-libpinyin package will make English input and Table input in the "Intel [[gettext-runtime]] == Gettext Runtime Subpackage Two subpackages gettext-runtime and gettext-envsubst have been added to gettext to separate out the programs needed at runtime, reducing the default install footprint. + +[[enhanced-persian-fonts]] +== Enhanced Persian font support + +In previous Fedora releases, the Persian (fa) locale used multiple different fonts such as DejaVu and Noto Sans Arabic for various programs, leading to an inconsistent and suboptimal experience. Fedora 37 adds the `vazirmatn-vf-fonts` package containing the Vazirmatn font, which is now used by default everywhere, providing improved user experience to those who use the `fa` locale. From ab937e9d6ae74b3f693af786ccb042d14a7cab19 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 13:22:55 +0100 Subject: [PATCH 22/85] 876 - Pantheon desktop removal --- modules/release-notes/pages/desktop/Desktop_index.adoc | 5 +++++ modules/release-notes/pages/sysadmin/Distribution.adoc | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/modules/release-notes/pages/desktop/Desktop_index.adoc b/modules/release-notes/pages/desktop/Desktop_index.adoc index 3733b6e..ab3882e 100644 --- a/modules/release-notes/pages/desktop/Desktop_index.adoc +++ b/modules/release-notes/pages/desktop/Desktop_index.adoc @@ -1,3 +1,8 @@ include::{partialsdir}/entities.adoc[] = Notable changes for desktop users + +[[pantheon-removal]] +== Pantheon Desktop Environment has been removed from Fedora + +Due to massive changes in the core technology stack of GNOME 43 (i.e. the switch to libsoup-3.0, webkit2gtk-4.1, geoclue-glib-2.0, rest-1, gcr-4), the Pantheon Desktop Environment and various elementary applications, which do not yet support the latest versions of these libraries, will no longer be supported or available as of Fedora 37. diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index 3c032d6..38ba334 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -29,6 +29,11 @@ The image is optimized for KVM and aims to resemble a default server installatio The server documentation link:https://docs.fedoraproject.org/en-US/fedora-server/virtualization/vm-install-diskimg-fedoraserver/[Creating a virtual machine using Fedora Server Edition disk image] provides detailed information on installing and using the disk image. +[[pantheon-removal]] +== Pantheon Desktop Environment has been removed from Fedora + +See xref:desktop/Desktop_index.adoc#pantheon-removal[Desktop]. + [[boot-iso-grub2]] == boot.iso now uses GRUB2 on BIOS systems From bd222ea903486688b1fc3e1de853778f70d7a36c Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 13:27:07 +0100 Subject: [PATCH 23/85] 823 - RPM 4.18 --- .../pages/sysadmin/System_Utilities.adoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/System_Utilities.adoc b/modules/release-notes/pages/sysadmin/System_Utilities.adoc index edcd064..98c17c4 100644 --- a/modules/release-notes/pages/sysadmin/System_Utilities.adoc +++ b/modules/release-notes/pages/sysadmin/System_Utilities.adoc @@ -3,6 +3,23 @@ include::{partialsdir}/entities.adoc[] [[sect-system-utilities]] = System Utilities +[[rpm-4-18]] +== RPM 4.18 + +RPM 4.18 contains various improvements over previous versions, but in particular this release addresses a whole class of symlink handling related security issues, some with CVEs, from 2021. Other notable improvements include: + +* A more intuitive conditional builds macro `%bcond` +* A more robust and secure `--restore` functionality +* Long-standing `%patch` quirks fixed +* Weak dependencies accept qualifiers like `meta` and `pre` now +* New interactive shell for working with macros (`rpmspec --shell`) and embedded Lua (`rpmlua`) +* New `%conf` spec section for build configuration +* New `rpmuncompress` cli tool simplifies unpacking multiple sources +* Numerous macro improvements and fixes +* Numerous OpenPGP parser correctness and security fixes + +For more detailed information see the link:https://rpm.org/wiki/Releases/4.18.0[upstream RPM 4.18 Release Notes]. + [[preset-all-systemd-units-on-first-boot]] == Preset all systemd units on first boot From 32bfdf76deb8193ae6580c5c2d8d3d30b6273619 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 13:34:24 +0100 Subject: [PATCH 24/85] 875 - Emacs 28 --- .../pages/developers/Development_Tools.adoc | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/modules/release-notes/pages/developers/Development_Tools.adoc b/modules/release-notes/pages/developers/Development_Tools.adoc index 5b17332..903e489 100644 --- a/modules/release-notes/pages/developers/Development_Tools.adoc +++ b/modules/release-notes/pages/developers/Development_Tools.adoc @@ -1,5 +1,16 @@ - include::{partialsdir}/entities.adoc[] +:experimental: [[sect-development-tools]] = Development Tools + +[[emacs-28]] +== Emacs 28 + +Fedora 37 provides the Emacs editor version 28.1. Notable new features include: + +* Native compilation of Lisp files +* Much improved display of Emoji and Emoji sequences +* New system for documenting groups of functions + +For more information, see the link:https://www.gnu.org/software/emacs/news/NEWS.28.1[upstream Emacs 28.1 NEWS]. You can also access this information within Emacs itself by pressing kbd:[C-h] kbd:[n]. From c755758364ec5fd64ab79bb44cda7abffb0ebee6 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 13:53:08 +0100 Subject: [PATCH 25/85] 861 - Firefox langpacks subpkg --- modules/release-notes/pages/desktop/I18n.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/modules/release-notes/pages/desktop/I18n.adoc b/modules/release-notes/pages/desktop/I18n.adoc index 427a189..2e0bb89 100644 --- a/modules/release-notes/pages/desktop/I18n.adoc +++ b/modules/release-notes/pages/desktop/I18n.adoc @@ -22,3 +22,8 @@ Two subpackages gettext-runtime and gettext-envsubst have been added to gettext == Enhanced Persian font support In previous Fedora releases, the Persian (fa) locale used multiple different fonts such as DejaVu and Noto Sans Arabic for various programs, leading to an inconsistent and suboptimal experience. Fedora 37 adds the `vazirmatn-vf-fonts` package containing the Vazirmatn font, which is now used by default everywhere, providing improved user experience to those who use the `fa` locale. + +[[firefox-langpacks]] +== Firefox now has a langpacks subpackage + +Firefox's langpacks are now installed in a separate recommended subpackage for greater flexibility. This enhances Fedora's modularity and allows you to install Firefox without support for all available languages if not needed. From 39aa4e95d101bc17e7daf7612883dc2e94d86342 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 14:02:44 +0100 Subject: [PATCH 26/85] 856 - CoreOS is now an edition --- modules/release-notes/pages/sysadmin/Distribution.adoc | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index 38ba334..c90355a 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -45,4 +45,11 @@ See xref:developers/Development_Python.adoc#default-shebangs[Python]. == Fedora Cloud Base is now a Fedora Edition -Fedora Cloud Base has been promoted to official status as a Fedora Edition. Fedora Cloud Base Images can now be downloaded from https://getfedora.org. +Fedora Cloud Base has been promoted to official status as a Fedora Edition. Cloud Base images can now be downloaded from link:https://alt.fedoraproject.org/cloud/[Get Fedora]. + +[[coreos-edition]] +== Fedora CoreOS is now a Fedora Edition + +Fedora CoreOS has been promoted to official status as a Fedora Edition. CoreOS images can now be downloaded from link:https://getfedora.org/en/coreos?stream=stable[Get Fedora]. + +Documentation for Fedora CoreOS is available at link:https://docs.fedoraproject.org/en-US/fedora-coreos/[this docs site]. From 0b29611feec65ef3445ca82a16917444585e3b6e Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 14:13:55 +0100 Subject: [PATCH 27/85] 838 - Node.js 18 --- .../pages/developers/Development_Web.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/modules/release-notes/pages/developers/Development_Web.adoc b/modules/release-notes/pages/developers/Development_Web.adoc index 7b8324d..60a9f3e 100644 --- a/modules/release-notes/pages/developers/Development_Web.adoc +++ b/modules/release-notes/pages/developers/Development_Web.adoc @@ -3,3 +3,18 @@ include::{partialsdir}/entities.adoc[] [[sect-web-development]] = Web Development + +== Node.js 18 + +Fedora 37 ships with the latest LTS version of Node.js JavaScript server-side engine, 18.x. The 16.x, and 14.x interpreters will remain available as non-default module streams. + +If your applications are not yet ready for this newer version, you can revert to the 16.x series by running the following commands: + +[source,bash] +---- +dnf remove nodejs +dnf module reset nodejs +dnf module install nodejs:16 +---- + +For more detailed information about Node.js 18, see the link:https://github.com/nodejs/node/blob/main/doc/changelogs/CHANGELOG_V18.md[upstream Node.js 18 ChangeLog]. From 82e5147916763ed694dada7a50d6ff5b81317452 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Sun, 13 Nov 2022 14:29:53 +0100 Subject: [PATCH 28/85] 773 - ELN Extras --- modules/release-notes/pages/sysadmin/Distribution.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index c90355a..c17230e 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -29,6 +29,12 @@ The image is optimized for KVM and aims to resemble a default server installatio The server documentation link:https://docs.fedoraproject.org/en-US/fedora-server/virtualization/vm-install-diskimg-fedoraserver/[Creating a virtual machine using Fedora Server Edition disk image] provides detailed information on installing and using the disk image. +[[eln]] +== ELN Extras +The ELN project will now run "ELN-Extras", a new build target and compose similar to ELN in behavior, but closer in function to EPEL. It will be a place to prepare and maintain packages that may be desired for EPEL N+1 while RHEL N+1 is still being incubated in ELN. This will enable application developers to keep up with impending changes in RHEL even before CentOS Stream becomes available for that release. Additionally, it provides a bootstrapping mechanism for EPEL, which will mean a much shorter gap between the launch of a new RHEL major release and the availability of the EPEL repositories. + +See the link:https://docs.fedoraproject.org/en-US/eln/[Fedora ELN Project] documentation for more information about the project, including link:https://docs.fedoraproject.org/en-US/eln/extras/[Extras]. + [[pantheon-removal]] == Pantheon Desktop Environment has been removed from Fedora From 0d874efe61d657b2b8742eeaed1405f44a68d4df Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 14 Nov 2022 05:29:30 +0100 Subject: [PATCH 29/85] 806, 807, 809 - MinGW updates --- modules/release-notes/pages/developers/Development_C.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/developers/Development_C.adoc b/modules/release-notes/pages/developers/Development_C.adoc index c3c4506..05440e9 100644 --- a/modules/release-notes/pages/developers/Development_C.adoc +++ b/modules/release-notes/pages/developers/Development_C.adoc @@ -3,3 +3,9 @@ include::{partialsdir}/entities.adoc[] [[sect-c]] = C + + +[[mingw]] +== MinGW updates + +Fedora 37 comes with the mingw-gcc-12 and mingw-binutils-2.38, and mingw-openssl-3.x. The new MinGW toolchain and tools are available to compile binaries targeting the Windows UCRT. From 8d25929cee92b59733a3e793aabce90c8a7502b7 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 14 Nov 2022 05:39:54 +0100 Subject: [PATCH 30/85] 849 - LLVM 15 --- .../release-notes/pages/developers/Development_LLVM.adoc | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/modules/release-notes/pages/developers/Development_LLVM.adoc b/modules/release-notes/pages/developers/Development_LLVM.adoc index 3be08db..42b1ba9 100644 --- a/modules/release-notes/pages/developers/Development_LLVM.adoc +++ b/modules/release-notes/pages/developers/Development_LLVM.adoc @@ -2,4 +2,8 @@ include::{partialsdir}/entities.adoc[] [[sect-llvm]] -= LLVM += LLVM version 15 + +All LLVM sub-projects in Fedora have been updated to version 15, and there has been be a soname version change for the LLVM libraries. Compatibility packages `clang14` and `llvm14` are available to ensure that packages that currently depend on CLang and LLVM version 14 libraries will continue to work. + +A full list of changes in LLVM 15 is available in the link:https://releases.llvm.org/15.0.0/docs/ReleaseNotes.html[upstream LLVM Release Notes]. From e0ea67441fa165456118457f9f50a8db45568d50 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 14 Nov 2022 05:46:20 +0100 Subject: [PATCH 31/85] Add indexes to topics so they'll redirect instead of 404 --- modules/release-notes/pages/desktop/index.adoc | 2 ++ modules/release-notes/pages/developers/index.adoc | 2 ++ modules/release-notes/pages/sysadmin/index.adoc | 2 ++ 3 files changed, 6 insertions(+) create mode 100644 modules/release-notes/pages/desktop/index.adoc create mode 100644 modules/release-notes/pages/developers/index.adoc create mode 100644 modules/release-notes/pages/sysadmin/index.adoc diff --git a/modules/release-notes/pages/desktop/index.adoc b/modules/release-notes/pages/desktop/index.adoc new file mode 100644 index 0000000..bc58d4f --- /dev/null +++ b/modules/release-notes/pages/desktop/index.adoc @@ -0,0 +1,2 @@ += Notable changes for desktop users +:page-aliases: Desktop_index.adoc diff --git a/modules/release-notes/pages/developers/index.adoc b/modules/release-notes/pages/developers/index.adoc new file mode 100644 index 0000000..abf345f --- /dev/null +++ b/modules/release-notes/pages/developers/index.adoc @@ -0,0 +1,2 @@ += Notable changes for developers +:page-aliases: Developers.adoc diff --git a/modules/release-notes/pages/sysadmin/index.adoc b/modules/release-notes/pages/sysadmin/index.adoc new file mode 100644 index 0000000..8a8b3c2 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/index.adoc @@ -0,0 +1,2 @@ += Notable changes for system administrators +:page-aliases: Sysadmins.adoc From 48237b8b68d822d7b33311e023ad262609d2231f Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 14 Nov 2022 05:55:41 +0100 Subject: [PATCH 32/85] Rename index files to actually index so we don't need to redirect --- modules/release-notes/nav.adoc | 6 +++--- .../pages/desktop/{Desktop_index.adoc => index.adoc} | 0 .../pages/developers/{Developers.adoc => index.adoc} | 0 .../pages/sysadmin/{Sysadmins.adoc => index.adoc} | 0 4 files changed, 3 insertions(+), 3 deletions(-) rename modules/release-notes/pages/desktop/{Desktop_index.adoc => index.adoc} (100%) rename modules/release-notes/pages/developers/{Developers.adoc => index.adoc} (100%) rename modules/release-notes/pages/sysadmin/{Sysadmins.adoc => index.adoc} (100%) diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index a91003f..a34c853 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -4,7 +4,7 @@ include::{partialsdir}/entities.adoc[] ** xref:welcome/Welcome.adoc[Welcome to Fedora] *** xref:welcome/Hardware_Overview.adoc[Hardware Overview] *** xref:welcome/Feedback.adoc[Feedback] -** xref:sysadmin/Sysadmins.adoc[System Administrators] +** xref:sysadmin/index.adoc[System Administrators] *** xref:sysadmin/Distribution.adoc[Distribution-wide Changes] *** xref:sysadmin/Installation.adoc[Installation] *** xref:sysadmin/Security.adoc[Security] @@ -12,8 +12,8 @@ include::{partialsdir}/entities.adoc[] *** xref:sysadmin/Storage.adoc[Storage] *** xref:sysadmin/System_Utilities.adoc[System Utilities] *** xref:sysadmin/Printing_Scanning.adoc[Printing and Scanning] -** xref:desktop/Desktop_index.adoc[Desktop Users] -** xref:developers/Developers.adoc[Developers] +** xref:desktop/index.adoc[Desktop Users] +** xref:developers/index.adoc[Developers] *** xref:developers/Development_Tools.adoc[Development Tools] *** xref:developers/Development_Binutils.adoc[Binutils] *** xref:developers/Development_C.adoc[C] diff --git a/modules/release-notes/pages/desktop/Desktop_index.adoc b/modules/release-notes/pages/desktop/index.adoc similarity index 100% rename from modules/release-notes/pages/desktop/Desktop_index.adoc rename to modules/release-notes/pages/desktop/index.adoc diff --git a/modules/release-notes/pages/developers/Developers.adoc b/modules/release-notes/pages/developers/index.adoc similarity index 100% rename from modules/release-notes/pages/developers/Developers.adoc rename to modules/release-notes/pages/developers/index.adoc diff --git a/modules/release-notes/pages/sysadmin/Sysadmins.adoc b/modules/release-notes/pages/sysadmin/index.adoc similarity index 100% rename from modules/release-notes/pages/sysadmin/Sysadmins.adoc rename to modules/release-notes/pages/sysadmin/index.adoc From 6b136732c1c30a2b919e0122e7d5242817629ec2 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 14 Nov 2022 06:11:12 +0100 Subject: [PATCH 33/85] 887 - Roundcubemail 1.6 --- modules/release-notes/nav.adoc | 1 + .../pages/sysadmin/Mail_Servers.adoc | 24 +++++++++++++++++++ 2 files changed, 25 insertions(+) create mode 100644 modules/release-notes/pages/sysadmin/Mail_Servers.adoc diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index 8f84ad9..347ddf1 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -12,6 +12,7 @@ include::{partialsdir}/entities.adoc[] *** xref:sysadmin/Storage.adoc[Storage] *** xref:sysadmin/System_Utilities.adoc[System Utilities] *** xref:sysadmin/Printing_Scanning.adoc[Printing and Scanning] +*** xref:sysadmin/Mail_Servers.adoc[Mail Servers] ** xref:desktop/Desktop_index.adoc[Desktop Users] *** xref:desktop/I18n.adoc[Internationalization] ** xref:developers/Developers.adoc[Developers] diff --git a/modules/release-notes/pages/sysadmin/Mail_Servers.adoc b/modules/release-notes/pages/sysadmin/Mail_Servers.adoc new file mode 100644 index 0000000..3b55d7e --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Mail_Servers.adoc @@ -0,0 +1,24 @@ +include::{partialsdir}/entities.adoc[] + += Mail servers + +== roundcubemail 1.6 + +Roundcube Webmail has been updated to version 1.6 in Fedora 37. Note that this version contains a set of breaking changes to previous versions; the following configuration options have been either removed or renamed: + +* IMAP +** renamed `default_host` to `imap_host` +** removed `default_port` option (non-standard port can be set via `imap_host`) +** set `localhost:143` as a default for `imap_host` +* SMTP +** renamed `smtp_server` to `smtp_host` +** removed `smtp_port` option (non-standard port can be set via `smtp_host`) +** set `localhost:587` as a default for `smtp_host` +* LDAP +** removed `port` option from `ldap_public` array (non-standard port can be set via `host`) +** removed `use_tls` option from `ldap_public` array (use `tls://` prefix in `host`) +* Managesieve +** removed `managesieve_port` option (non-standard port can be set via `managesieve_host`) +** removed `managesieve_usetls` option (set `tls://` prefix to `managesieve_host`) + +For a list of changes, see the link:https://github.com/roundcube/roundcubemail/releases/tag/1.6.0[upstream Rouncube Webmail release notes]. From bc92fc9f5bb34415e3ef9a478a228789a02097ab Mon Sep 17 00:00:00 2001 From: Francois Andrieu Date: Thu, 17 Nov 2022 22:40:17 +0100 Subject: [PATCH 34/85] Changes Common Bugs link to related ask.fp-o tag Add new docsbuilder build/preview script Use gitlab repository for release-docs-home --- build.sh | 52 ---- docsbuilder.sh | 278 ++++++++++++++++++ modules/release-notes/nav.adoc | 3 +- .../pages/_partials/entities.adoc | 2 +- preview.sh | 18 -- site.yml | 2 +- 6 files changed, 281 insertions(+), 74 deletions(-) delete mode 100755 build.sh create mode 100755 docsbuilder.sh delete mode 100755 preview.sh diff --git a/build.sh b/build.sh deleted file mode 100755 index e71f27e..0000000 --- a/build.sh +++ /dev/null @@ -1,52 +0,0 @@ -#!/bin/sh - -image="docker.io/antora/antora" -cmd="--html-url-extension-style=indexify site.yml" - -if uname | grep -iwq darwin; then - # Running on macOS. - # Let's assume that the user has the Docker CE installed - # which doesn't require a root password. - echo "" - echo "This build script is using Docker container runtime to run the build in an isolated environment." - echo "" - docker run --rm -it -v "$(pwd):/antora" "${image}" ${cmd} - -elif uname | grep -iq linux; then - # Running on Linux. - # there isn't an antora/aarch64 container, antora can be installed locally - # Check whether podman is available, else faill back to docker - # which requires root. - - if [ -f /usr/local/bin/antora ]; then - /usr/local/bin/antora ${cmd} - elif uname -m | grep -iwq aarch64; then - echo "no antora/aarch64 container try just \`npm install -g @antora/cli @antora/site-generator-default\`" - elif [ -f /usr/bin/podman ]; then - echo "" - echo "This build script is using Podman to run the build in an isolated environment." - echo "" - podman run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd} - - elif [ -f /usr/bin/docker ]; then - echo "" - echo "This build script is using Docker to run the build in an isolated environment." - echo "" - - if groups | grep -wq "docker"; then - docker run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd} - else - echo "You might be asked for your password." - echo "You can avoid this by adding your user to the 'docker' group," - echo "but be aware of the security implications." - echo "See https://docs.docker.com/install/linux/linux-postinstall/" - echo "" - sudo docker run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd} - fi - else - echo "" - echo "Error: Container runtime haven't been found on your system. Fix it by:" - echo "$ sudo dnf install podman" - exit 1 - fi -fi diff --git a/docsbuilder.sh b/docsbuilder.sh new file mode 100755 index 0000000..ded7f8d --- /dev/null +++ b/docsbuilder.sh @@ -0,0 +1,278 @@ +#!/bin/bash + +# script to watch source directory for changes, and re-run build and preview + +script_name="docsbuilder.sh" +script_source="https://gitlab.com/fedora/docs/templates/fedora-docs-template/-/raw/main/${script_name}" +version="1.2.0" +image="docker.io/antora/antora" +cmd="--html-url-extension-style=indexify site.yml" +srcdir="modules" +buildir="public" +previewpidfile="preview.pid" + +# 4913: for vim users, vim creates a temporary file to test it can write to +# directory +# https://groups.google.com/g/vim_dev/c/sppdpElxY44 +# .git: so we don't get rebuilds each time git metadata changes +inotifyignore="\.git.*|4913" + +watch_and_build () { + if ! command -v inotifywait > /dev/null + then + echo "inotifywait command could not be found. Please install inotify-tools." + echo "On Fedora, run: sudo dnf install inotify-tools" + stop_preview_and_exit + else + # check for git + # required to get ignorelist + if ! command -v git > /dev/null + then + echo "git command could not be found. Please install git." + echo "On Fedora, run: sudo dnf install git-core" + stop_preview_and_exit + else + # Get files not being tracked, we don't watch for changes in these. + # Could hard code, but people use different editors that may create + # temporary files that are updated regularly and so on, so better + # to get the list from git. It'll also look at global gitingore + # settings and so on. + inotifyignore="$(git status -s --ignored | grep '^!!' | sed -e 's/^!! //' | tr '\n' '|')${inotifyignore}" + fi + + while true + do + echo "Watching current directory (excluding: ${inotifyignore}) for changes and re-building as required. Use Ctrl C to stop." + inotifywait -q --exclude "($inotifyignore)" -e modify,create,delete,move -r . && echo "Change detected, rebuilding.." && build + done + fi +} + +build () { + if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + echo "" + echo "This build script is using Docker container runtime to run the build in an isolated environment." + echo "" + docker run --rm -it -v $(pwd):/antora $image $cmd + + elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Check whether podman is available, else faill back to docker + # which requires root. + + if [ -f /usr/bin/podman ]; then + echo "" + echo "This build script is using Podman to run the build in an isolated environment." + echo "" + podman run --rm -it -v $(pwd):/antora:z $image $cmd --stacktrace + + elif [ -f /usr/bin/docker ]; then + echo "" + echo "This build script is using Docker to run the build in an isolated environment." + echo "" + + if groups | grep -wq "docker"; then + docker run --rm -it -v $(pwd):/antora:z $image $cmd + else + echo "" + echo "This build script is using $runtime to run the build in an isolated environment. You might be asked for your password." + echo "You can avoid this by adding your user to the 'docker' group, but be aware of the security implications. See https://docs.docker.com/install/linux/linux-postinstall/." + echo "" + sudo docker run --rm -it -v $(pwd):/antora:z $image $cmd + fi + + else + echo "" + echo "Error: Container runtime haven't been found on your system. Fix it by:" + echo "$ sudo dnf install podman" + exit 1 + fi + fi +} + +start_preview () { + + # clean up a preview that may be running + stop_preview + + # always run an initial build so preview shows latest version + build + + if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + echo "The preview will be available at http://localhost:8080/" + docker run --rm -v $(pwd):/antora:ro -v $(pwd)/nginx.conf:/etc/nginx/conf.d/default.conf:ro -p 8080:80 nginx + + elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Fedora Workstation has python3 installed as a default, so using that + echo "" + echo "The preview is available at http://localhost:8080" + echo "" + pushd "${buildir}" > /dev/null 2>&1 + python3 -m http.server 8080 & + echo "$!" > ../"${previewpidfile}" + popd > /dev/null 2>&1 + fi +} + +stop_preview () { + if [ -e "${previewpidfile}" ] + then + PID=$(cat "${previewpidfile}") + kill $PID + echo "Stopping preview server (running with PID ${PID}).." + rm -f "${previewpidfile}" + else + echo "No running preview server found to stop: no ${previewpidfile} file found." + fi +} + +stop_preview_and_exit () +{ + # stop and also exit the script + + # if stop_preview is trapped, then SIGINT doesn't stop the build loop. So + # we need to make sure we also exit the script. + + # stop_preview is called before other functions, so we cannot add exit to + # it. + stop_preview + exit 0 +} + + +# https://apple.stackexchange.com/questions/83939/compare-multi-digit-version-numbers-in-bash/123408#123408 +version () { echo "$@" | awk -F. '{ printf("%d%03d%03d%03d\n", $1,$2,$3,$4); }'; } + + +check_update () { + if ! command -v curl > /dev/null + then + echo "curl command could not be found. Please install curl." + echo "On Fedora, run: sudo dnf install curl" + exit 0 + fi + script_version="$(grep "^version=" ${script_name} | cut -d '=' -f2 | tr --delete '"')" + tempdir="$(mktemp -d)" + echo "$tempdir" + pushd "$tempdir" > /dev/null 2>&1 + curl "$script_source" --silent --output "${script_name}" + upstream_version="$(grep "^version=" ${script_name} | cut -d '=' -f2 | tr --delete '"')" + echo "${upstream_version}" + if [ $(version $upstream_version) -gt $(version $script_version) ]; then + echo "Update available" + echo "Script version $upstream_version is available at $script_source" + echo "This version is $script_version." + echo "Please use the '-U' option to update." + echo + fi + popd > /dev/null 2&>1 +} + +install_update () { + if ! command -v curl > /dev/null + then + echo "curl command could not be found. Please install curl." + echo "On Fedora, run: sudo dnf install curl" + exit 0 + fi + curl "$script_source" --silent --output "${script_name}.new" + mv "${script_name}.new" "${script_name}" + chmod +x "${script_name}" +} + +usage() { + echo "$0: Build and preview Fedora antora based documentation" + echo + echo "Usage: $0 [-awbpkh]" + echo + echo "-a: start preview, start watcher and rebuilder" + echo "-w: start watcher and rebuilder" + echo "-b: rebuild" + echo "-p: start_preview" + echo "-k: stop_preview" + echo "-h: print this usage text and exit" + echo "-u: check builder script update" + echo "-U: install builder script from upstream" + echo + echo "Maintained by the Fedora documentation team." + echo "Please contact on our channels: https://docs.fedoraproject.org/en-US/fedora-docs/#find-docs" +} + +# check if the script is being run in a Fedora docs repository +if [ ! -e "site.yml" ] +then + echo "site.yml not be found." + echo "This does not appear to be a Fedora Antora based documentation repository." + echo "Exiting." + echo + usage + exit 1 +fi + + +if [ $# -lt 1 ] +then + echo "No options provided, running preview with watch and build." + echo "Run script with '-h' to see all available options." + echo + echo + trap stop_preview_and_exit INT + start_preview + watch_and_build + stop_preview +fi + +# parse options +while getopts "awbpkhuU" OPTION +do + case $OPTION in + a) + # handle sig INT to stop the preview + trap stop_preview_and_exit INT + start_preview + watch_and_build + stop_preview + exit 0 + ;; + w) + watch_and_build + exit 0 + ;; + b) + build + exit 0 + ;; + p) + start_preview + echo "Please run ./${script_name} -k to stop the preview server" + exit 0 + ;; + k) + stop_preview + exit 0 + ;; + h) + usage + exit 0 + ;; + u) + check_update + exit 0 + ;; + U) + install_update + exit 0 + ;; + ?) + usage + exit 1 + ;; + esac +done diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index 347ddf1..083652d 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -26,6 +26,5 @@ include::{partialsdir}/entities.adoc[] *** xref:developers/Development_Python.adoc[Python] *** xref:developers/Development_Ruby.adoc[Ruby] *** xref:developers/Development_Web.adoc[Web Development] -//CHANGE THIS WITH A NEW RELEASE -** link:https://fedoraproject.org/wiki/Common_F37_bugs[Common Bugs] +** link:{COMMONBUGS_URL}[Common Bugs] ** xref:Revision_History.adoc[Revision History] diff --git a/modules/release-notes/pages/_partials/entities.adoc b/modules/release-notes/pages/_partials/entities.adoc index d5e962e..633d1e6 100644 --- a/modules/release-notes/pages/_partials/entities.adoc +++ b/modules/release-notes/pages/_partials/entities.adoc @@ -1,6 +1,6 @@ :BOOKID: release-notes :BZURL: https://pagure.io/fedora-docs/release-notes/issues -:COMMONBUGS_URL: https://fedoraproject.org/wiki/Common_F37_bugs +:COMMONBUGS_URL: https://ask.fedoraproject.org/tags/c/common-issues/f37 :HOLDER: Fedora Project Contributors :PREVVER: 36 :PRODUCT: Fedora Documentation diff --git a/preview.sh b/preview.sh deleted file mode 100755 index 4270107..0000000 --- a/preview.sh +++ /dev/null @@ -1,18 +0,0 @@ -#!/bin/sh - -if [ "$(uname)" = "Darwin" ]; then - # Running on macOS. - # Let's assume that the user has the Docker CE installed - # which doesn't require a root password. - echo "The preview will be available at http://localhost:8080/" - docker run --rm -v "$(pwd):/antora:ro" -v "$(pwd)/nginx.conf:/etc/nginx/conf.d/default.conf:ro" -p 8080:80 nginx - -elif [ "$(expr substr "$(uname -s)" 1 5)" = "Linux" ]; then - # Running on Linux. - # Fedora Workstation has python3 installed as a default, so using that - echo "" - echo "The preview is available at http://localhost:8080" - echo "" - cd ./public - python3 -m http.server 8080 -fi diff --git a/site.yml b/site.yml index 2c404cd..6b30ead 100644 --- a/site.yml +++ b/site.yml @@ -5,7 +5,7 @@ content: sources: - url: . branches: HEAD - - url: https://pagure.io/fedora-docs/release-docs-home.git + - url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home.git branches: f37 ui: bundle: From 1bd3661877f107d129ebac4955539dc2aab78511 Mon Sep 17 00:00:00 2001 From: Anthony McGlone Date: Thu, 17 Nov 2022 13:50:36 +0000 Subject: [PATCH 35/85] Update modules/release-notes/pages/sysadmin/Distribution.adoc Fixing https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home/-/issues/2 --- modules/release-notes/pages/sysadmin/Distribution.adoc | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc index c17230e..669c6be 100644 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ b/modules/release-notes/pages/sysadmin/Distribution.adoc @@ -1,4 +1,3 @@ - include::{partialsdir}/entities.adoc[] [[select-distribution]] @@ -13,7 +12,7 @@ Some minor caveats include: * Support for WiFi on the Raspberry Pi 400 is out of scope of this change. * We tested CM 4 and will support on the official IO board. Other devices that incorporate CM 4 should work correctly provided the vendor has their support in the upstream Raspberry Pi firmware/overlays. -* The hardware based media decoding (H264/HVEC, and others) are our of scope for this change. +* The hardware based media decoding (H264/HVEC, and others) are out of scope for this change. [[retire-armv7]] == ARMv7 architecture is no longer supported From 621763b8a5e4e28bccf7807bf562a44804e01eaf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Timoth=C3=A9e=20Ravier?= Date: Wed, 16 Nov 2022 12:29:25 +0100 Subject: [PATCH 36/85] Add ostree specific page and notes for #811 Fixes: https://pagure.io/fedora-docs/release-notes/issue/811 --- modules/release-notes/nav.adoc | 1 + .../release-notes/pages/sysadmin/Ostree.adoc | 28 +++++++++++++++++++ 2 files changed, 29 insertions(+) create mode 100644 modules/release-notes/pages/sysadmin/Ostree.adoc diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index 083652d..5748e59 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -13,6 +13,7 @@ include::{partialsdir}/entities.adoc[] *** xref:sysadmin/System_Utilities.adoc[System Utilities] *** xref:sysadmin/Printing_Scanning.adoc[Printing and Scanning] *** xref:sysadmin/Mail_Servers.adoc[Mail Servers] +*** xref:sysadmin/Ostree.adoc[Ostree based variants] ** xref:desktop/Desktop_index.adoc[Desktop Users] *** xref:desktop/I18n.adoc[Internationalization] ** xref:developers/Developers.adoc[Developers] diff --git a/modules/release-notes/pages/sysadmin/Ostree.adoc b/modules/release-notes/pages/sysadmin/Ostree.adoc new file mode 100644 index 0000000..42afb44 --- /dev/null +++ b/modules/release-notes/pages/sysadmin/Ostree.adoc @@ -0,0 +1,28 @@ +include::{partialsdir}/entities.adoc[] + += Changes for ostree based variants of Fedora + +This page regroups changes that only apply to ostree/rpm-ostree based variants of Fedora, such as Fedora CoreOS, Fedora IoT, Fedora Silverblue and Fedora Kinoite. + +[[fedora-coreos-major-changes]] +== Fedora CoreOS major changes + +Major changes for Fedora CoreOS are list in the https://docs.fedoraproject.org/en-US/fedora-coreos/major-changes/[Major Changes page] in the https://docs.fedoraproject.org/en-US/fedora-coreos/[Fedora CoreOS documentation]. + +[[readonly-sysroot-ostree-desktopsl]] +== `/sysroot` mounted read only + +On rpm-ostree based systems, the real root (the root directory of the root partition on the disk) is mounted under the `/sysroot` path. +By default it contains the state of the system (the content of `/var` and `/etc`) as well as the system versions themselves (each versioned copy of `/usr`) in the ostree repository (`/ostree/repo`). + +Users and administrators are not expected to directly interact with the content available there and should instead use the interface offered by rpm-ostree, GNOME Software or soon Plasma Discover to manage their system. + +Thus `/sysroot` is now mounted read only starting with this release. + +New installations of all three variants will have `/sysroot` read only by default. + +Existing installations of Fedora Silverblue and Fedora Kinoite will be migrated on the first boot to Fedora 37 and will have `/sysroot` read only on the next boot. + +Fedora CoreOS has already made this change in a previous release (https://github.com/coreos/fedora-coreos-tracker/issues/1232[fedora-coreos-tracker#1232]). + +See the https://fedoraproject.org/wiki/Changes/Silverblue_Kinoite_readonly_sysroot[Fedora change page] for more details. From 060496fc9db18a3e597fd8bbc3c09345226366a1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Timoth=C3=A9e=20Ravier?= Date: Wed, 16 Nov 2022 12:33:30 +0100 Subject: [PATCH 37/85] Add link to Multimedia page from #896 Also fix some whitespace. Fixes: https://pagure.io/fedora-docs/release-notes/pull-request/896 --- modules/release-notes/nav.adoc | 1 + modules/release-notes/pages/desktop/Multimedia.adoc | 6 ++---- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index 5748e59..c7b6aaf 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -16,6 +16,7 @@ include::{partialsdir}/entities.adoc[] *** xref:sysadmin/Ostree.adoc[Ostree based variants] ** xref:desktop/Desktop_index.adoc[Desktop Users] *** xref:desktop/I18n.adoc[Internationalization] +*** xref:desktop/Multimedia.adoc[Multimedia] ** xref:developers/Developers.adoc[Developers] *** xref:developers/Development_Tools.adoc[Development Tools] *** xref:developers/Development_Binutils.adoc[Binutils] diff --git a/modules/release-notes/pages/desktop/Multimedia.adoc b/modules/release-notes/pages/desktop/Multimedia.adoc index 99b97a1..99c8015 100644 --- a/modules/release-notes/pages/desktop/Multimedia.adoc +++ b/modules/release-notes/pages/desktop/Multimedia.adoc @@ -1,11 +1,9 @@ include::{partialsdir}/entities.adoc[] - + [[sect-multimedia]] = Multimedia - [[mumble-1-4]] - == Mumble 1.4 Mumble is a popular voice chat application. It is commonly used for gaming and podcasts. @@ -19,4 +17,4 @@ This update brings for example the following changes: * Substitute a sub-optimal free-type search for a fully featured search dialog * Support markdown markup language for text messages in the chat bar -You can see the full list of changes in the https://www.mumble.info/blog/mumble-1.4.230/[upstream release notes]. \ No newline at end of file +You can see the full list of changes in the https://www.mumble.info/blog/mumble-1.4.230/[upstream release notes]. From 3c47f3fa44e09d2326ebb32edbf1fb1f97a8afbc Mon Sep 17 00:00:00 2001 From: Francois Andrieu Date: Thu, 17 Nov 2022 22:40:17 +0100 Subject: [PATCH 38/85] Changes Common Bugs link to related ask.fp-o tag Add new docsbuilder build/preview script Use gitlab repository for release-docs-home --- build.sh | 52 ---- docsbuilder.sh | 278 ++++++++++++++++++ modules/release-notes/nav.adoc | 3 +- .../pages/_partials/entities.adoc | 5 +- preview.sh | 18 -- site.yml | 2 +- 6 files changed, 283 insertions(+), 75 deletions(-) delete mode 100755 build.sh create mode 100755 docsbuilder.sh delete mode 100755 preview.sh diff --git a/build.sh b/build.sh deleted file mode 100755 index e71f27e..0000000 --- a/build.sh +++ /dev/null @@ -1,52 +0,0 @@ -#!/bin/sh - -image="docker.io/antora/antora" -cmd="--html-url-extension-style=indexify site.yml" - -if uname | grep -iwq darwin; then - # Running on macOS. - # Let's assume that the user has the Docker CE installed - # which doesn't require a root password. - echo "" - echo "This build script is using Docker container runtime to run the build in an isolated environment." - echo "" - docker run --rm -it -v "$(pwd):/antora" "${image}" ${cmd} - -elif uname | grep -iq linux; then - # Running on Linux. - # there isn't an antora/aarch64 container, antora can be installed locally - # Check whether podman is available, else faill back to docker - # which requires root. - - if [ -f /usr/local/bin/antora ]; then - /usr/local/bin/antora ${cmd} - elif uname -m | grep -iwq aarch64; then - echo "no antora/aarch64 container try just \`npm install -g @antora/cli @antora/site-generator-default\`" - elif [ -f /usr/bin/podman ]; then - echo "" - echo "This build script is using Podman to run the build in an isolated environment." - echo "" - podman run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd} - - elif [ -f /usr/bin/docker ]; then - echo "" - echo "This build script is using Docker to run the build in an isolated environment." - echo "" - - if groups | grep -wq "docker"; then - docker run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd} - else - echo "You might be asked for your password." - echo "You can avoid this by adding your user to the 'docker' group," - echo "but be aware of the security implications." - echo "See https://docs.docker.com/install/linux/linux-postinstall/" - echo "" - sudo docker run --rm -it -v "$(pwd):/antora:z" "${image}" ${cmd} - fi - else - echo "" - echo "Error: Container runtime haven't been found on your system. Fix it by:" - echo "$ sudo dnf install podman" - exit 1 - fi -fi diff --git a/docsbuilder.sh b/docsbuilder.sh new file mode 100755 index 0000000..ded7f8d --- /dev/null +++ b/docsbuilder.sh @@ -0,0 +1,278 @@ +#!/bin/bash + +# script to watch source directory for changes, and re-run build and preview + +script_name="docsbuilder.sh" +script_source="https://gitlab.com/fedora/docs/templates/fedora-docs-template/-/raw/main/${script_name}" +version="1.2.0" +image="docker.io/antora/antora" +cmd="--html-url-extension-style=indexify site.yml" +srcdir="modules" +buildir="public" +previewpidfile="preview.pid" + +# 4913: for vim users, vim creates a temporary file to test it can write to +# directory +# https://groups.google.com/g/vim_dev/c/sppdpElxY44 +# .git: so we don't get rebuilds each time git metadata changes +inotifyignore="\.git.*|4913" + +watch_and_build () { + if ! command -v inotifywait > /dev/null + then + echo "inotifywait command could not be found. Please install inotify-tools." + echo "On Fedora, run: sudo dnf install inotify-tools" + stop_preview_and_exit + else + # check for git + # required to get ignorelist + if ! command -v git > /dev/null + then + echo "git command could not be found. Please install git." + echo "On Fedora, run: sudo dnf install git-core" + stop_preview_and_exit + else + # Get files not being tracked, we don't watch for changes in these. + # Could hard code, but people use different editors that may create + # temporary files that are updated regularly and so on, so better + # to get the list from git. It'll also look at global gitingore + # settings and so on. + inotifyignore="$(git status -s --ignored | grep '^!!' | sed -e 's/^!! //' | tr '\n' '|')${inotifyignore}" + fi + + while true + do + echo "Watching current directory (excluding: ${inotifyignore}) for changes and re-building as required. Use Ctrl C to stop." + inotifywait -q --exclude "($inotifyignore)" -e modify,create,delete,move -r . && echo "Change detected, rebuilding.." && build + done + fi +} + +build () { + if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + echo "" + echo "This build script is using Docker container runtime to run the build in an isolated environment." + echo "" + docker run --rm -it -v $(pwd):/antora $image $cmd + + elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Check whether podman is available, else faill back to docker + # which requires root. + + if [ -f /usr/bin/podman ]; then + echo "" + echo "This build script is using Podman to run the build in an isolated environment." + echo "" + podman run --rm -it -v $(pwd):/antora:z $image $cmd --stacktrace + + elif [ -f /usr/bin/docker ]; then + echo "" + echo "This build script is using Docker to run the build in an isolated environment." + echo "" + + if groups | grep -wq "docker"; then + docker run --rm -it -v $(pwd):/antora:z $image $cmd + else + echo "" + echo "This build script is using $runtime to run the build in an isolated environment. You might be asked for your password." + echo "You can avoid this by adding your user to the 'docker' group, but be aware of the security implications. See https://docs.docker.com/install/linux/linux-postinstall/." + echo "" + sudo docker run --rm -it -v $(pwd):/antora:z $image $cmd + fi + + else + echo "" + echo "Error: Container runtime haven't been found on your system. Fix it by:" + echo "$ sudo dnf install podman" + exit 1 + fi + fi +} + +start_preview () { + + # clean up a preview that may be running + stop_preview + + # always run an initial build so preview shows latest version + build + + if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + echo "The preview will be available at http://localhost:8080/" + docker run --rm -v $(pwd):/antora:ro -v $(pwd)/nginx.conf:/etc/nginx/conf.d/default.conf:ro -p 8080:80 nginx + + elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Fedora Workstation has python3 installed as a default, so using that + echo "" + echo "The preview is available at http://localhost:8080" + echo "" + pushd "${buildir}" > /dev/null 2>&1 + python3 -m http.server 8080 & + echo "$!" > ../"${previewpidfile}" + popd > /dev/null 2>&1 + fi +} + +stop_preview () { + if [ -e "${previewpidfile}" ] + then + PID=$(cat "${previewpidfile}") + kill $PID + echo "Stopping preview server (running with PID ${PID}).." + rm -f "${previewpidfile}" + else + echo "No running preview server found to stop: no ${previewpidfile} file found." + fi +} + +stop_preview_and_exit () +{ + # stop and also exit the script + + # if stop_preview is trapped, then SIGINT doesn't stop the build loop. So + # we need to make sure we also exit the script. + + # stop_preview is called before other functions, so we cannot add exit to + # it. + stop_preview + exit 0 +} + + +# https://apple.stackexchange.com/questions/83939/compare-multi-digit-version-numbers-in-bash/123408#123408 +version () { echo "$@" | awk -F. '{ printf("%d%03d%03d%03d\n", $1,$2,$3,$4); }'; } + + +check_update () { + if ! command -v curl > /dev/null + then + echo "curl command could not be found. Please install curl." + echo "On Fedora, run: sudo dnf install curl" + exit 0 + fi + script_version="$(grep "^version=" ${script_name} | cut -d '=' -f2 | tr --delete '"')" + tempdir="$(mktemp -d)" + echo "$tempdir" + pushd "$tempdir" > /dev/null 2>&1 + curl "$script_source" --silent --output "${script_name}" + upstream_version="$(grep "^version=" ${script_name} | cut -d '=' -f2 | tr --delete '"')" + echo "${upstream_version}" + if [ $(version $upstream_version) -gt $(version $script_version) ]; then + echo "Update available" + echo "Script version $upstream_version is available at $script_source" + echo "This version is $script_version." + echo "Please use the '-U' option to update." + echo + fi + popd > /dev/null 2&>1 +} + +install_update () { + if ! command -v curl > /dev/null + then + echo "curl command could not be found. Please install curl." + echo "On Fedora, run: sudo dnf install curl" + exit 0 + fi + curl "$script_source" --silent --output "${script_name}.new" + mv "${script_name}.new" "${script_name}" + chmod +x "${script_name}" +} + +usage() { + echo "$0: Build and preview Fedora antora based documentation" + echo + echo "Usage: $0 [-awbpkh]" + echo + echo "-a: start preview, start watcher and rebuilder" + echo "-w: start watcher and rebuilder" + echo "-b: rebuild" + echo "-p: start_preview" + echo "-k: stop_preview" + echo "-h: print this usage text and exit" + echo "-u: check builder script update" + echo "-U: install builder script from upstream" + echo + echo "Maintained by the Fedora documentation team." + echo "Please contact on our channels: https://docs.fedoraproject.org/en-US/fedora-docs/#find-docs" +} + +# check if the script is being run in a Fedora docs repository +if [ ! -e "site.yml" ] +then + echo "site.yml not be found." + echo "This does not appear to be a Fedora Antora based documentation repository." + echo "Exiting." + echo + usage + exit 1 +fi + + +if [ $# -lt 1 ] +then + echo "No options provided, running preview with watch and build." + echo "Run script with '-h' to see all available options." + echo + echo + trap stop_preview_and_exit INT + start_preview + watch_and_build + stop_preview +fi + +# parse options +while getopts "awbpkhuU" OPTION +do + case $OPTION in + a) + # handle sig INT to stop the preview + trap stop_preview_and_exit INT + start_preview + watch_and_build + stop_preview + exit 0 + ;; + w) + watch_and_build + exit 0 + ;; + b) + build + exit 0 + ;; + p) + start_preview + echo "Please run ./${script_name} -k to stop the preview server" + exit 0 + ;; + k) + stop_preview + exit 0 + ;; + h) + usage + exit 0 + ;; + u) + check_update + exit 0 + ;; + U) + install_update + exit 0 + ;; + ?) + usage + exit 1 + ;; + esac +done diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index a34c853..2cbe290 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -24,6 +24,5 @@ include::{partialsdir}/entities.adoc[] *** xref:developers/Development_Python.adoc[Python] *** xref:developers/Development_Ruby.adoc[Ruby] *** xref:developers/Development_Web.adoc[Web Development] -//CHANGE THIS WITH A NEW RELEASE -** link:https://fedoraproject.org/wiki/Common_F34_bugs[Common Bugs] +** link:{COMMONBUGS_URL}[Common Bugs] ** xref:Revision_History.adoc[Revision History] diff --git a/modules/release-notes/pages/_partials/entities.adoc b/modules/release-notes/pages/_partials/entities.adoc index a1a49f1..5070f96 100644 --- a/modules/release-notes/pages/_partials/entities.adoc +++ b/modules/release-notes/pages/_partials/entities.adoc @@ -1,8 +1,9 @@ :BOOKID: release-notes :BZURL: https://pagure.io/fedora-docs/release-notes/issues -:COMMONBUGS_URL: https://fedoraproject.org/wiki/Common_F34_bugs +// Change this to the latest version +:COMMONBUGS_URL: https://ask.fedoraproject.org/tags/c/common-issues/f37 :HOLDER: Fedora Project Contributors -:PREVVER: 35 +:PREVVER: 36 :PRODUCT: Fedora Documentation :PRODVER: Rawhide :YEAR: 2022 diff --git a/preview.sh b/preview.sh deleted file mode 100755 index 4270107..0000000 --- a/preview.sh +++ /dev/null @@ -1,18 +0,0 @@ -#!/bin/sh - -if [ "$(uname)" = "Darwin" ]; then - # Running on macOS. - # Let's assume that the user has the Docker CE installed - # which doesn't require a root password. - echo "The preview will be available at http://localhost:8080/" - docker run --rm -v "$(pwd):/antora:ro" -v "$(pwd)/nginx.conf:/etc/nginx/conf.d/default.conf:ro" -p 8080:80 nginx - -elif [ "$(expr substr "$(uname -s)" 1 5)" = "Linux" ]; then - # Running on Linux. - # Fedora Workstation has python3 installed as a default, so using that - echo "" - echo "The preview is available at http://localhost:8080" - echo "" - cd ./public - python3 -m http.server 8080 -fi diff --git a/site.yml b/site.yml index 2dccc95..b2ccd28 100644 --- a/site.yml +++ b/site.yml @@ -5,7 +5,7 @@ content: sources: - url: . branches: HEAD - - url: https://pagure.io/fedora-docs/release-docs-home.git + - url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home.git branches: master ui: bundle: From 4d5f8c3a3a78e639419d390ddd619388e8ad4c3b Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 14 Nov 2022 05:46:20 +0100 Subject: [PATCH 39/85] Add indexes to topics so they'll redirect instead of 404 --- modules/release-notes/pages/desktop/index.adoc | 1 + modules/release-notes/pages/developers/index.adoc | 1 + modules/release-notes/pages/sysadmin/index.adoc | 1 + 3 files changed, 3 insertions(+) diff --git a/modules/release-notes/pages/desktop/index.adoc b/modules/release-notes/pages/desktop/index.adoc index 3733b6e..33b8417 100644 --- a/modules/release-notes/pages/desktop/index.adoc +++ b/modules/release-notes/pages/desktop/index.adoc @@ -1,3 +1,4 @@ include::{partialsdir}/entities.adoc[] = Notable changes for desktop users +:page-aliases: Desktop_index.adoc diff --git a/modules/release-notes/pages/developers/index.adoc b/modules/release-notes/pages/developers/index.adoc index 1488cd6..10b0785 100644 --- a/modules/release-notes/pages/developers/index.adoc +++ b/modules/release-notes/pages/developers/index.adoc @@ -1,6 +1,7 @@ include::{partialsdir}/entities.adoc[] = Notable changes for developers +:page-aliases: Developers.adoc This section lists changes in Fedora {PRODVER} relevant to developers. Use the navigation tab on the left to view release notes for various languages. diff --git a/modules/release-notes/pages/sysadmin/index.adoc b/modules/release-notes/pages/sysadmin/index.adoc index ff39b19..f9c77ea 100644 --- a/modules/release-notes/pages/sysadmin/index.adoc +++ b/modules/release-notes/pages/sysadmin/index.adoc @@ -1,6 +1,7 @@ include::{partialsdir}/entities.adoc[] = Notable changes for system administrators +:page-aliases: Sysadmins.adoc This section lists changes in Fedora {PRODVER} relevant to system administrators. Use the navigation tab on the left to view release notes for various fields of interest. From c3d84370ea5a79dc31e5a349c81540992f401bea Mon Sep 17 00:00:00 2001 From: Francois Andrieu Date: Fri, 14 Jul 2023 16:45:48 +0200 Subject: [PATCH 40/85] add gen_release_notes.py script that generate release notes pages --- scripts/gen_release_notes.py | 181 ++++++++++++++++++ scripts/requirements.txt | 2 + scripts/templates/SelfContainedChange.adoc.j2 | 16 ++ scripts/templates/default_category.adoc.j2 | 13 ++ 4 files changed, 212 insertions(+) create mode 100644 scripts/gen_release_notes.py create mode 100644 scripts/requirements.txt create mode 100644 scripts/templates/SelfContainedChange.adoc.j2 create mode 100644 scripts/templates/default_category.adoc.j2 diff --git a/scripts/gen_release_notes.py b/scripts/gen_release_notes.py new file mode 100644 index 0000000..71edfad --- /dev/null +++ b/scripts/gen_release_notes.py @@ -0,0 +1,181 @@ +#!/usr/bin/python3 +""" +gen_release_notes.py + +Retrieve release notes from the wiki, and generate +release notes adoc file for each release notes category in +modules/release-notes/pages/$category_name.adoc. + +The generated category document is based on the matching +template $category_name.adoc.j2 in the templates directory. +If this template does not exists, it will use +default_category.adoc.j2 instead. + +Requires: +python3-requests +python3-jinja2 + +dnf install -y python3-requests python3-jinja2 +or +pip install -r requirements.txt +""" + +import requests +import sys +import re +import jinja2 +import logging +import urllib.parse +import os +import argparse + +api_url = "https://fedoraproject.org/w/api.php" + + +def list_changes(release): + """ + Retrieve list of changes from ChangeAcceptedFxx wiki category + returns a list of wiki pages: + [{ + "pageid": 12345, + "ns": 0, + "title": "Changes/MyAwesomeChange" + },...] + """ + params = { + "action": "query", + "list": "categorymembers", + "cmtitle": f"Category:ChangeAcceptedF{release}", + "cmlimit": 100, + "format": "json", + } + s = requests.Session() + req = s.get(url=api_url, params=params) + if req.status_code != 200: + logging.error(req.status_code) + return [] + + data = req.json() + return data["query"]["categorymembers"] + + +def get_change_info(pageid): + """ + Get change release notes and categories from the wiki page + returns a dict: + { + "title": MyAwesomeChange, + "categories": ["SystemWideChange", "SomeOtherCategory"], + "url": f"https://fedoraproject.org/wiki/Changes/MyAwesomeChange", + "release_notes": "You are awesome!", + } + """ + info = {} + s = requests.Session() + params = { + "action": "parse", + "pageid": pageid, + "prop": "categories|sections", + "format": "json", + } + req = s.get(url=api_url, params=params) + page_data = req.json() + rn_sid = None + info = { + "title": page["title"].replace("Changes/", ""), + "categories": [], + "url": f"https://fedoraproject.org/wiki/{urllib.parse.quote(page['title'])}", + "release_notes": "", + } + + # Get categories + for category in page_data["parse"]["categories"]: + if category["*"].startswith("ChangeAccepted"): + continue + info["categories"].append(category["*"]) + + # Find release notes section + for section in page_data["parse"]["sections"]: + if section["line"] == "Release Notes": + rn_sid = section["index"] + break + if rn_sid: + # Fetch release notes text + params = { + "action": "parse", + "pageid": page["pageid"], + "section": rn_sid, + "prop": "wikitext", + "format": "json", + } + req = s.get(url=api_url, params=params) + section_data = req.json() + # Remove html comments and empty lines + info["release_notes"] = "\n".join( + re.sub( + "", + "", + section_data["parse"]["wikitext"]["*"], + flags=re.MULTILINE | re.DOTALL, + ).splitlines()[1::] + ).strip() + + if not info["release_notes"]: + # If no release notes, fallback to summary + params = { + "action": "parse", + "pageid": page["pageid"], + "section": 2, # I expect the summary to be always the first section (after the title) of the page + "prop": "wikitext", + "format": "json", + } + req = s.get(url=api_url, params=params) + section_data = req.json() + # Remove html comments and empty lines + info["release_notes"] = "\n".join( + re.sub( + "", + "", + section_data["parse"]["wikitext"]["*"], + flags=re.MULTILINE | re.DOTALL, + ).splitlines()[1::] + ).strip() + + return info + + +if __name__ == "__main__": + logging.basicConfig(level=logging.INFO) + abs_path = os.path.dirname(os.path.abspath(sys.argv[0])) + rn_per_cats = {} + parser = argparse.ArgumentParser( + description="Generate release notes from the ChangeAccepted wiki category" + ) + parser.add_argument("release", help="Fedora Linux version") + args = parser.parse_args() + env = jinja2.Environment(loader=jinja2.FileSystemLoader(f"{abs_path}/templates")) + default_tpl = env.get_template("default_category.adoc.j2") + + logging.info(f"Fetching changes for Fedora {args.release}...") + for page in list_changes(args.release): + change = get_change_info(page["pageid"]) + logging.info(f"Processed change {change['title']}...") + for cat in change["categories"]: + if cat not in rn_per_cats: + rn_per_cats[cat] = [] + rn_per_cats[cat].append(change) + + for cat_name, changes in rn_per_cats.items(): + logging.info(f"Generating {cat_name}.adoc...") + if os.path.exists(f"{abs_path}/templates/{cat_name}.adoc.j2"): + tpl = env.get_template(f"{cat_name}.adoc.j2") + else: + tpl = default_tpl + output_from_parsed_template = tpl.render(cat_name=cat_name, changes=changes) + + with open( + f"{abs_path}/../modules/release-notes/pages/{cat_name}.adoc", "w" + ) as fh: + fh.write(output_from_parsed_template) + + logging.info("Completed.") diff --git a/scripts/requirements.txt b/scripts/requirements.txt new file mode 100644 index 0000000..94e323d --- /dev/null +++ b/scripts/requirements.txt @@ -0,0 +1,2 @@ +Jinja2 +requests \ No newline at end of file diff --git a/scripts/templates/SelfContainedChange.adoc.j2 b/scripts/templates/SelfContainedChange.adoc.j2 new file mode 100644 index 0000000..da23426 --- /dev/null +++ b/scripts/templates/SelfContainedChange.adoc.j2 @@ -0,0 +1,16 @@ + +include::{partialsdir}/entities.adoc[] + += Self-Contained Changes + +A self-contained change is a change to isolated package(s), or a general change with limited scope and impact on the rest of the distribution/project. +Examples include addition of a group of leaf packages, or a coordinated effort within a Special Interest Group (SIG) with limited impact outside the SIG’s functional area. + +{% for change in changes %} +== {{ change['title'] }} + +{{ change['release_notes'] }} + +__Read {{ change['url'] }}[more information] about this change.__ + +{% endfor %} diff --git a/scripts/templates/default_category.adoc.j2 b/scripts/templates/default_category.adoc.j2 new file mode 100644 index 0000000..1eb6d38 --- /dev/null +++ b/scripts/templates/default_category.adoc.j2 @@ -0,0 +1,13 @@ + +include::{partialsdir}/entities.adoc[] + += {{ cat_name }} + +{% for change in changes %} +== {{ change['title'] }} + +{{ change['release_notes'] }} + +__Read {{ change['url'] }}[more information] about this change.__ + +{% endfor %} From 6913b7d622d8b1acca9257e5d017236c22a200e7 Mon Sep 17 00:00:00 2001 From: Francois Andrieu Date: Thu, 9 Mar 2023 23:18:19 +0100 Subject: [PATCH 41/85] branch for F38 --- antora.yml | 2 +- modules/release-notes/pages/_partials/entities.adoc | 8 ++++---- site.yml | 2 +- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/antora.yml b/antora.yml index d70d031..a39d86e 100644 --- a/antora.yml +++ b/antora.yml @@ -1,5 +1,5 @@ --- name: fedora -version: rawhide +version: f38 # Navigation is in the main 'fedora' component: # https://pagure.io/fedora-docs/release-docs-home diff --git a/modules/release-notes/pages/_partials/entities.adoc b/modules/release-notes/pages/_partials/entities.adoc index 5070f96..8acc97c 100644 --- a/modules/release-notes/pages/_partials/entities.adoc +++ b/modules/release-notes/pages/_partials/entities.adoc @@ -1,9 +1,9 @@ :BOOKID: release-notes :BZURL: https://pagure.io/fedora-docs/release-notes/issues // Change this to the latest version -:COMMONBUGS_URL: https://ask.fedoraproject.org/tags/c/common-issues/f37 +:COMMONBUGS_URL: https://ask.fedoraproject.org/tags/c/common-issues/f38 :HOLDER: Fedora Project Contributors -:PREVVER: 36 +:PREVVER: 37 :PRODUCT: Fedora Documentation -:PRODVER: Rawhide -:YEAR: 2022 +:PRODVER: 38 +:YEAR: 2023 diff --git a/site.yml b/site.yml index b2ccd28..b1408de 100644 --- a/site.yml +++ b/site.yml @@ -6,7 +6,7 @@ content: - url: . branches: HEAD - url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home.git - branches: master + branches: f38 ui: bundle: url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable From a21a3f57b33316272fb358576add0bae181abf33 Mon Sep 17 00:00:00 2001 From: Alexey Tikhonov Date: Fri, 24 Mar 2023 12:11:52 +0100 Subject: [PATCH 42/85] Update modules/release-notes/pages/sysadmin/Security.adoc Add a couple of derecation notices related to SSSD package. --- modules/release-notes/pages/sysadmin/Security.adoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/modules/release-notes/pages/sysadmin/Security.adoc b/modules/release-notes/pages/sysadmin/Security.adoc index dcabdc5..a791869 100644 --- a/modules/release-notes/pages/sysadmin/Security.adoc +++ b/modules/release-notes/pages/sysadmin/Security.adoc @@ -3,3 +3,17 @@ include::{partialsdir}/entities.adoc[] [[sect-security]] = Security + +== The SSSD 'sss_simpleifp' library has been deprecated +'sss_simpleifp' library ('libsss_simpleifp' and 'libsss_simpleifp-devel' packages) +has been deprecated and will be removed from future releases. + +== The SSSD 'files provider' has been deprecated +The SSSD 'files provider' that provides capability to handle local users +has been deprecated and might be removed from future releases. +It shouldn't be an issue for vast majority of users since feature was disabled +by default for a few releases already. +Those who were configuring it explicitly, for example for the session recording +of local users, might consider switching to 'proxy provider'. +In case you have a strong use case not covered by 'proxy provider', please +reach out to SSSD upstream at https://sssd.io/. From 2cd9464302d607eaef1883fdb9ecd963a4be487e Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 25 Mar 2024 15:04:53 +0100 Subject: [PATCH 43/85] Fix version --- antora.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/antora.yml b/antora.yml index a39d86e..d70d031 100644 --- a/antora.yml +++ b/antora.yml @@ -1,5 +1,5 @@ --- name: fedora -version: f38 +version: rawhide # Navigation is in the main 'fedora' component: # https://pagure.io/fedora-docs/release-docs-home From 7aa1fa3a68085a86ee866ab37a82c38db05f5c4f Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 25 Mar 2024 15:48:54 +0100 Subject: [PATCH 44/85] Create new simpler structure for relnotes --- modules/release-notes/nav.adoc | 32 ++++--------------- .../release-notes/pages/Revision_History.adoc | 5 --- .../pages/_partials/Author_Group.adoc | 1 - .../pages/_partials/entities.adoc | 9 ------ modules/release-notes/pages/desktop.adoc | 4 +++ .../release-notes/pages/desktop/index.adoc | 4 --- modules/release-notes/pages/developers.adoc | 4 +++ .../developers/Development_Binutils.adoc | 4 --- .../pages/developers/Development_C.adoc | 5 --- .../pages/developers/Development_Dotnet.adoc | 5 --- .../pages/developers/Development_Go.adoc | 5 --- .../pages/developers/Development_Haskell.adoc | 5 --- .../pages/developers/Development_LLVM.adoc | 5 --- .../pages/developers/Development_Python.adoc | 5 --- .../pages/developers/Development_Ruby.adoc | 4 --- .../pages/developers/Development_Tools.adoc | 5 --- .../pages/developers/Development_Web.adoc | 5 --- .../release-notes/pages/developers/index.adoc | 7 ---- .../{welcome/Feedback.adoc => feedback.adoc} | 2 +- ...e_Overview.adoc => hardware_overview.adoc} | 6 ++-- modules/release-notes/pages/index.adoc | 8 ++--- modules/release-notes/pages/sysadmin.adoc | 4 +++ .../pages/sysadmin/Distribution.adoc | 5 --- .../pages/sysadmin/Installation.adoc | 16 ---------- .../pages/sysadmin/Networking.adoc | 5 --- .../pages/sysadmin/Printing_Scanning.adoc | 4 --- .../pages/sysadmin/Security.adoc | 19 ----------- .../release-notes/pages/sysadmin/Storage.adoc | 5 --- .../pages/sysadmin/System_Utilities.adoc | 4 --- .../release-notes/pages/sysadmin/index.adoc | 7 ---- .../{welcome/Welcome.adoc => welcome.adoc} | 2 +- .../_partials => partials}/Feedback.adoc | 2 +- .../_partials => partials}/Legal_Notice.adoc | 0 modules/release-notes/partials/entities.adoc | 9 ++++++ site.yml | 2 +- 35 files changed, 38 insertions(+), 176 deletions(-) delete mode 100644 modules/release-notes/pages/Revision_History.adoc delete mode 100644 modules/release-notes/pages/_partials/Author_Group.adoc delete mode 100644 modules/release-notes/pages/_partials/entities.adoc create mode 100644 modules/release-notes/pages/desktop.adoc delete mode 100644 modules/release-notes/pages/desktop/index.adoc create mode 100644 modules/release-notes/pages/developers.adoc delete mode 100644 modules/release-notes/pages/developers/Development_Binutils.adoc delete mode 100644 modules/release-notes/pages/developers/Development_C.adoc delete mode 100644 modules/release-notes/pages/developers/Development_Dotnet.adoc delete mode 100644 modules/release-notes/pages/developers/Development_Go.adoc delete mode 100644 modules/release-notes/pages/developers/Development_Haskell.adoc delete mode 100644 modules/release-notes/pages/developers/Development_LLVM.adoc delete mode 100644 modules/release-notes/pages/developers/Development_Python.adoc delete mode 100644 modules/release-notes/pages/developers/Development_Ruby.adoc delete mode 100644 modules/release-notes/pages/developers/Development_Tools.adoc delete mode 100644 modules/release-notes/pages/developers/Development_Web.adoc delete mode 100644 modules/release-notes/pages/developers/index.adoc rename modules/release-notes/pages/{welcome/Feedback.adoc => feedback.adoc} (96%) rename modules/release-notes/pages/{welcome/Hardware_Overview.adoc => hardware_overview.adoc} (97%) create mode 100644 modules/release-notes/pages/sysadmin.adoc delete mode 100644 modules/release-notes/pages/sysadmin/Distribution.adoc delete mode 100644 modules/release-notes/pages/sysadmin/Installation.adoc delete mode 100644 modules/release-notes/pages/sysadmin/Networking.adoc delete mode 100644 modules/release-notes/pages/sysadmin/Printing_Scanning.adoc delete mode 100644 modules/release-notes/pages/sysadmin/Security.adoc delete mode 100644 modules/release-notes/pages/sysadmin/Storage.adoc delete mode 100644 modules/release-notes/pages/sysadmin/System_Utilities.adoc delete mode 100644 modules/release-notes/pages/sysadmin/index.adoc rename modules/release-notes/pages/{welcome/Welcome.adoc => welcome.adoc} (98%) rename modules/release-notes/{pages/_partials => partials}/Feedback.adoc (94%) rename modules/release-notes/{pages/_partials => partials}/Legal_Notice.adoc (100%) create mode 100644 modules/release-notes/partials/entities.adoc diff --git a/modules/release-notes/nav.adoc b/modules/release-notes/nav.adoc index 2cbe290..99ce882 100644 --- a/modules/release-notes/nav.adoc +++ b/modules/release-notes/nav.adoc @@ -1,28 +1,10 @@ -include::{partialsdir}/entities.adoc[] +include::partial$entities.adoc[] * xref:index.adoc[Fedora Release Notes] -** xref:welcome/Welcome.adoc[Welcome to Fedora] -*** xref:welcome/Hardware_Overview.adoc[Hardware Overview] -*** xref:welcome/Feedback.adoc[Feedback] -** xref:sysadmin/index.adoc[System Administrators] -*** xref:sysadmin/Distribution.adoc[Distribution-wide Changes] -*** xref:sysadmin/Installation.adoc[Installation] -*** xref:sysadmin/Security.adoc[Security] -*** xref:sysadmin/Networking.adoc[Networking] -*** xref:sysadmin/Storage.adoc[Storage] -*** xref:sysadmin/System_Utilities.adoc[System Utilities] -*** xref:sysadmin/Printing_Scanning.adoc[Printing and Scanning] -** xref:desktop/index.adoc[Desktop Users] -** xref:developers/index.adoc[Developers] -*** xref:developers/Development_Tools.adoc[Development Tools] -*** xref:developers/Development_Binutils.adoc[Binutils] -*** xref:developers/Development_C.adoc[C] -*** xref:developers/Development_Go.adoc[Go] -*** xref:developers/Development_Haskell.adoc[Haskell] -*** xref:developers/Development_LLVM.adoc[LLVM] -*** xref:developers/Development_Dotnet.adoc[.NET] -*** xref:developers/Development_Python.adoc[Python] -*** xref:developers/Development_Ruby.adoc[Ruby] -*** xref:developers/Development_Web.adoc[Web Development] +** xref:welcome.adoc[Welcome to Fedora] +*** xref:hardware_overview.adoc[Hardware Overview] +*** xref:feedback.adoc[Feedback] +** xref:sysadmin.adoc[System Administrators] +** xref:desktop.adoc[Desktop Users] +** xref:developers.adoc[Developers] ** link:{COMMONBUGS_URL}[Common Bugs] -** xref:Revision_History.adoc[Revision History] diff --git a/modules/release-notes/pages/Revision_History.adoc b/modules/release-notes/pages/Revision_History.adoc deleted file mode 100644 index 7c2be80..0000000 --- a/modules/release-notes/pages/Revision_History.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[appe-Release_Notes-Revision_History]] -= Revision History diff --git a/modules/release-notes/pages/_partials/Author_Group.adoc b/modules/release-notes/pages/_partials/Author_Group.adoc deleted file mode 100644 index b7ff345..0000000 --- a/modules/release-notes/pages/_partials/Author_Group.adoc +++ /dev/null @@ -1 +0,0 @@ -.The Fedora Docs Team diff --git a/modules/release-notes/pages/_partials/entities.adoc b/modules/release-notes/pages/_partials/entities.adoc deleted file mode 100644 index 8acc97c..0000000 --- a/modules/release-notes/pages/_partials/entities.adoc +++ /dev/null @@ -1,9 +0,0 @@ -:BOOKID: release-notes -:BZURL: https://pagure.io/fedora-docs/release-notes/issues -// Change this to the latest version -:COMMONBUGS_URL: https://ask.fedoraproject.org/tags/c/common-issues/f38 -:HOLDER: Fedora Project Contributors -:PREVVER: 37 -:PRODUCT: Fedora Documentation -:PRODVER: 38 -:YEAR: 2023 diff --git a/modules/release-notes/pages/desktop.adoc b/modules/release-notes/pages/desktop.adoc new file mode 100644 index 0000000..02b38bc --- /dev/null +++ b/modules/release-notes/pages/desktop.adoc @@ -0,0 +1,4 @@ +:experimental: +include::partial$entities.adoc[] + += Changes in Fedora {PRODVER} For Desktop Users diff --git a/modules/release-notes/pages/desktop/index.adoc b/modules/release-notes/pages/desktop/index.adoc deleted file mode 100644 index 33b8417..0000000 --- a/modules/release-notes/pages/desktop/index.adoc +++ /dev/null @@ -1,4 +0,0 @@ -include::{partialsdir}/entities.adoc[] - -= Notable changes for desktop users -:page-aliases: Desktop_index.adoc diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc new file mode 100644 index 0000000..17205fa --- /dev/null +++ b/modules/release-notes/pages/developers.adoc @@ -0,0 +1,4 @@ +:experimental: +include::partial$entities.adoc[] + += Changes in Fedora {PRODVER} For Developers diff --git a/modules/release-notes/pages/developers/Development_Binutils.adoc b/modules/release-notes/pages/developers/Development_Binutils.adoc deleted file mode 100644 index 160d8d4..0000000 --- a/modules/release-notes/pages/developers/Development_Binutils.adoc +++ /dev/null @@ -1,4 +0,0 @@ -include::{partialsdir}/entities.adoc[] - -[[sect-binutils]] -= GNU Binutils diff --git a/modules/release-notes/pages/developers/Development_C.adoc b/modules/release-notes/pages/developers/Development_C.adoc deleted file mode 100644 index c3c4506..0000000 --- a/modules/release-notes/pages/developers/Development_C.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-c]] -= C diff --git a/modules/release-notes/pages/developers/Development_Dotnet.adoc b/modules/release-notes/pages/developers/Development_Dotnet.adoc deleted file mode 100644 index cba8a92..0000000 --- a/modules/release-notes/pages/developers/Development_Dotnet.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-dotnet]] -= .NET diff --git a/modules/release-notes/pages/developers/Development_Go.adoc b/modules/release-notes/pages/developers/Development_Go.adoc deleted file mode 100644 index 3eae542..0000000 --- a/modules/release-notes/pages/developers/Development_Go.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-development-go]] -= Golang diff --git a/modules/release-notes/pages/developers/Development_Haskell.adoc b/modules/release-notes/pages/developers/Development_Haskell.adoc deleted file mode 100644 index 7a2af12..0000000 --- a/modules/release-notes/pages/developers/Development_Haskell.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-haskell]] -= Haskell diff --git a/modules/release-notes/pages/developers/Development_LLVM.adoc b/modules/release-notes/pages/developers/Development_LLVM.adoc deleted file mode 100644 index 3be08db..0000000 --- a/modules/release-notes/pages/developers/Development_LLVM.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-llvm]] -= LLVM diff --git a/modules/release-notes/pages/developers/Development_Python.adoc b/modules/release-notes/pages/developers/Development_Python.adoc deleted file mode 100644 index 9a2ac8c..0000000 --- a/modules/release-notes/pages/developers/Development_Python.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-python]] -= Python diff --git a/modules/release-notes/pages/developers/Development_Ruby.adoc b/modules/release-notes/pages/developers/Development_Ruby.adoc deleted file mode 100644 index 1d3d853..0000000 --- a/modules/release-notes/pages/developers/Development_Ruby.adoc +++ /dev/null @@ -1,4 +0,0 @@ -include::{partialsdir}/entities.adoc[] - -[[sect-ruby]] -= Ruby diff --git a/modules/release-notes/pages/developers/Development_Tools.adoc b/modules/release-notes/pages/developers/Development_Tools.adoc deleted file mode 100644 index 5b17332..0000000 --- a/modules/release-notes/pages/developers/Development_Tools.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-development-tools]] -= Development Tools diff --git a/modules/release-notes/pages/developers/Development_Web.adoc b/modules/release-notes/pages/developers/Development_Web.adoc deleted file mode 100644 index 7b8324d..0000000 --- a/modules/release-notes/pages/developers/Development_Web.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-web-development]] -= Web Development diff --git a/modules/release-notes/pages/developers/index.adoc b/modules/release-notes/pages/developers/index.adoc deleted file mode 100644 index 10b0785..0000000 --- a/modules/release-notes/pages/developers/index.adoc +++ /dev/null @@ -1,7 +0,0 @@ -include::{partialsdir}/entities.adoc[] - -= Notable changes for developers -:page-aliases: Developers.adoc - -This section lists changes in Fedora {PRODVER} relevant to developers. -Use the navigation tab on the left to view release notes for various languages. diff --git a/modules/release-notes/pages/welcome/Feedback.adoc b/modules/release-notes/pages/feedback.adoc similarity index 96% rename from modules/release-notes/pages/welcome/Feedback.adoc rename to modules/release-notes/pages/feedback.adoc index a17fe06..7b83ded 100644 --- a/modules/release-notes/pages/welcome/Feedback.adoc +++ b/modules/release-notes/pages/feedback.adoc @@ -1,5 +1,5 @@ -include::{partialsdir}/entities.adoc[] +include::partial$entities.adoc[] [[sect-Release_Notes-Feedback]] = Feedback diff --git a/modules/release-notes/pages/welcome/Hardware_Overview.adoc b/modules/release-notes/pages/hardware_overview.adoc similarity index 97% rename from modules/release-notes/pages/welcome/Hardware_Overview.adoc rename to modules/release-notes/pages/hardware_overview.adoc index 9c6ec5c..f7a2aea 100644 --- a/modules/release-notes/pages/welcome/Hardware_Overview.adoc +++ b/modules/release-notes/pages/hardware_overview.adoc @@ -1,4 +1,4 @@ -include::{partialsdir}/entities.adoc[] +include::partial$entities.adoc[] [[sect-hardware-overview]] = Hardware Overview @@ -29,7 +29,7 @@ For best results on systems with less than 1GB of memory, use the DVD installati The figures below are recommended for the default x86_64 Workstation installation featuring the Gnome desktop . Your requirements may differ, depending on Desktop Environment and use case. -* 2GHz quad core processor +* 2GHz quad core processor * 4GB System Memory @@ -46,7 +46,7 @@ For best results on systems with less than 1GB of memory, use the DVD installati [[hardware_overview-resolution]] == Display resolution -VGA capable of 1024x768 screen resolution +VGA capable of 1024x768 screen resolution .Graphical Installation requires 800x600 resolution or higher [NOTE] diff --git a/modules/release-notes/pages/index.adoc b/modules/release-notes/pages/index.adoc index abd257c..37cf7ee 100644 --- a/modules/release-notes/pages/index.adoc +++ b/modules/release-notes/pages/index.adoc @@ -1,4 +1,4 @@ -include::{partialsdir}/entities.adoc[] +include::partial$entities.adoc[] = Release Notes @@ -14,7 +14,7 @@ This document provides the release notes for Fedora Linux {PRODVER}. It describe ==== Have something that should be included in the release notes? Notice something wrong? -File an issue in the https://pagure.io/fedora-docs/release-notes[fedora-docs/release-notes repo]. +File an issue in the https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes/-/issues[Release Notes repository]. ==== [NOTE] @@ -23,6 +23,4 @@ Use the sidebar on the left to navigate the Release Notes as well as other docum ==== image:title_logo.svg[Fedora Logo] -include::{partialsdir}/Legal_Notice.adoc[] - -include::{partialsdir}/Author_Group.adoc[] +include::partial$Legal_Notice.adoc[] diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc new file mode 100644 index 0000000..8397121 --- /dev/null +++ b/modules/release-notes/pages/sysadmin.adoc @@ -0,0 +1,4 @@ +:experimental: +include::partial$entities.adoc[] + += Changes in Fedora {PRODVER} For System Administrators diff --git a/modules/release-notes/pages/sysadmin/Distribution.adoc b/modules/release-notes/pages/sysadmin/Distribution.adoc deleted file mode 100644 index efbfd5d..0000000 --- a/modules/release-notes/pages/sysadmin/Distribution.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[select-distribution]] -= Distribution-wide Changes diff --git a/modules/release-notes/pages/sysadmin/Installation.adoc b/modules/release-notes/pages/sysadmin/Installation.adoc deleted file mode 100644 index 1ef5ee6..0000000 --- a/modules/release-notes/pages/sysadmin/Installation.adoc +++ /dev/null @@ -1,16 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-installation]] -= Installation - -[[sect-installation-anaconda]] -== Anaconda changes - -This section covers changes in the [application]*Anaconda* installer, including changes in the graphical and text mode interactive installers, Kickstart, and installer boot options. - -[[sect-installation-anaconda-general]] -=== General changes - -[[sect-installation-kickstart]] -=== Kickstart changes diff --git a/modules/release-notes/pages/sysadmin/Networking.adoc b/modules/release-notes/pages/sysadmin/Networking.adoc deleted file mode 100644 index 960a425..0000000 --- a/modules/release-notes/pages/sysadmin/Networking.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[networking]] -= Networking diff --git a/modules/release-notes/pages/sysadmin/Printing_Scanning.adoc b/modules/release-notes/pages/sysadmin/Printing_Scanning.adoc deleted file mode 100644 index f4e7cf5..0000000 --- a/modules/release-notes/pages/sysadmin/Printing_Scanning.adoc +++ /dev/null @@ -1,4 +0,0 @@ -include::{partialsdir}/entities.adoc[] - -[[sect-printing-scanning]] -= Printing and Scanning diff --git a/modules/release-notes/pages/sysadmin/Security.adoc b/modules/release-notes/pages/sysadmin/Security.adoc deleted file mode 100644 index a791869..0000000 --- a/modules/release-notes/pages/sysadmin/Security.adoc +++ /dev/null @@ -1,19 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-security]] -= Security - -== The SSSD 'sss_simpleifp' library has been deprecated -'sss_simpleifp' library ('libsss_simpleifp' and 'libsss_simpleifp-devel' packages) -has been deprecated and will be removed from future releases. - -== The SSSD 'files provider' has been deprecated -The SSSD 'files provider' that provides capability to handle local users -has been deprecated and might be removed from future releases. -It shouldn't be an issue for vast majority of users since feature was disabled -by default for a few releases already. -Those who were configuring it explicitly, for example for the session recording -of local users, might consider switching to 'proxy provider'. -In case you have a strong use case not covered by 'proxy provider', please -reach out to SSSD upstream at https://sssd.io/. diff --git a/modules/release-notes/pages/sysadmin/Storage.adoc b/modules/release-notes/pages/sysadmin/Storage.adoc deleted file mode 100644 index 54bd7cf..0000000 --- a/modules/release-notes/pages/sysadmin/Storage.adoc +++ /dev/null @@ -1,5 +0,0 @@ - -include::{partialsdir}/entities.adoc[] - -[[sect-storage]] -= Storage diff --git a/modules/release-notes/pages/sysadmin/System_Utilities.adoc b/modules/release-notes/pages/sysadmin/System_Utilities.adoc deleted file mode 100644 index 05c5a23..0000000 --- a/modules/release-notes/pages/sysadmin/System_Utilities.adoc +++ /dev/null @@ -1,4 +0,0 @@ -include::{partialsdir}/entities.adoc[] - -[[sect-system-utilities]] -= System Utilities diff --git a/modules/release-notes/pages/sysadmin/index.adoc b/modules/release-notes/pages/sysadmin/index.adoc deleted file mode 100644 index f9c77ea..0000000 --- a/modules/release-notes/pages/sysadmin/index.adoc +++ /dev/null @@ -1,7 +0,0 @@ -include::{partialsdir}/entities.adoc[] - -= Notable changes for system administrators -:page-aliases: Sysadmins.adoc - -This section lists changes in Fedora {PRODVER} relevant to system administrators. -Use the navigation tab on the left to view release notes for various fields of interest. diff --git a/modules/release-notes/pages/welcome/Welcome.adoc b/modules/release-notes/pages/welcome.adoc similarity index 98% rename from modules/release-notes/pages/welcome/Welcome.adoc rename to modules/release-notes/pages/welcome.adoc index d956256..f6ff32f 100644 --- a/modules/release-notes/pages/welcome/Welcome.adoc +++ b/modules/release-notes/pages/welcome.adoc @@ -1,4 +1,4 @@ -include::{partialsdir}/entities.adoc[] +include::partial$entities.adoc[] [[sect-welcome_to_fedora]] = Welcome to Fedora diff --git a/modules/release-notes/pages/_partials/Feedback.adoc b/modules/release-notes/partials/Feedback.adoc similarity index 94% rename from modules/release-notes/pages/_partials/Feedback.adoc rename to modules/release-notes/partials/Feedback.adoc index c04e4d3..cb6dc2f 100644 --- a/modules/release-notes/pages/_partials/Feedback.adoc +++ b/modules/release-notes/partials/Feedback.adoc @@ -1,6 +1,6 @@ :experimental: -include::{partialsdir}/entities.adoc[] +include::partial$entities.adoc[] == We want feedback indexterm:[feedback,contact information for this manual] diff --git a/modules/release-notes/pages/_partials/Legal_Notice.adoc b/modules/release-notes/partials/Legal_Notice.adoc similarity index 100% rename from modules/release-notes/pages/_partials/Legal_Notice.adoc rename to modules/release-notes/partials/Legal_Notice.adoc diff --git a/modules/release-notes/partials/entities.adoc b/modules/release-notes/partials/entities.adoc new file mode 100644 index 0000000..7c51e16 --- /dev/null +++ b/modules/release-notes/partials/entities.adoc @@ -0,0 +1,9 @@ +:BOOKID: release-notes +:BZURL: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes/-/issues +// Change this to the latest version +:COMMONBUGS_URL: https://discussion.fedoraproject.org/tags/c/ask/common-issues/82/all/f40 +:HOLDER: Fedora Project Contributors +:PREVVER: 39 +:PRODUCT: Fedora Documentation +:PRODVER: rawhide +:YEAR: 2024 diff --git a/site.yml b/site.yml index b1408de..9049892 100644 --- a/site.yml +++ b/site.yml @@ -6,7 +6,7 @@ content: - url: . branches: HEAD - url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home.git - branches: f38 + branches: main ui: bundle: url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable From a5f83f83e591f9a542ae7a2a5192e2179caa778a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Petr=20Boko=C4=8D?= Date: Mon, 25 Mar 2024 15:54:40 +0000 Subject: [PATCH 45/85] Add Change issue template --- .gitlab/issue_templates/change.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 .gitlab/issue_templates/change.md diff --git a/.gitlab/issue_templates/change.md b/.gitlab/issue_templates/change.md new file mode 100644 index 0000000..ff56ddc --- /dev/null +++ b/.gitlab/issue_templates/change.md @@ -0,0 +1,27 @@ +This issue tracks the release note for the following Fedora Change: + +!!!!LINK TO WIKI HERE!!!! + +If you own this change, please add additional information here that we should communicate to Fedora users. Specifically, please consider: + +* New features available because of this change - pick 2 or 3 that are important +* Considerations for users of previous releases of Fedora (upgrade issues, format changes, etc.) +* Links to any upstream Release Notes +* If this helps Fedora be a superior environment for our target audiences, please explain how so that we can emphasize this. + +Your notes to us do not need to be formally written. We will edit them and add details if needed. This is a way for you to ensure that we know what is critical about your change. + +If you want to write this release note, then: + +* Assign this issue to yourself +* Check the wiki page linked above, find out what the change is about +* Determine whether the change actually made it into the release or not[0] +* Write a draft release note using that information against the correct branch here, in Pagure. (or see below) +* Get in touch with the contact person/people listed on the wiki page, either through IRC/Matrix or e-mail or just by @-mentioning them in a comment here, and ask them to check your draft for technical accuracy +* Submit your Release Note as a PR to this repository. + +Once you're done with the above, make sure to either commit the relnote to an appropriate section of the Release Notes, or, if you're not familiar with Git, AsciiDoc, or whatever else, just add it to this issue as a comment and let the team[1] know that you're done with this one and you'd like the note included. Be sure to do this at least one day before the final release (see current schedule[2]). Also make sure to do this even for relnotes that haven't been checked by the change owner. + +[0] You can do that by asking the change owner listed on the wiki page; alternatively you can infer it by checking the tracker bug (linked in Wiki) in Bugzilla and looking at its status; see bug comments for details. Ask someone on Matrix if you're not sure. +[1] On Matrix in the Fedora Documentation channel - see https://docs.fedoraproject.org/en-US/project/communications/. +[2] Schedules are all here: https://fedorapeople.org/groups/schedule/ - make sure to pick the correct release. From b47593831ee1e7a4e0733d307878127b8110654b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Petr=20Boko=C4=8D?= Date: Mon, 25 Mar 2024 15:55:41 +0000 Subject: [PATCH 46/85] Update file change.md --- .gitlab/issue_templates/change.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.gitlab/issue_templates/change.md b/.gitlab/issue_templates/change.md index ff56ddc..8c71b50 100644 --- a/.gitlab/issue_templates/change.md +++ b/.gitlab/issue_templates/change.md @@ -23,5 +23,7 @@ If you want to write this release note, then: Once you're done with the above, make sure to either commit the relnote to an appropriate section of the Release Notes, or, if you're not familiar with Git, AsciiDoc, or whatever else, just add it to this issue as a comment and let the team[1] know that you're done with this one and you'd like the note included. Be sure to do this at least one day before the final release (see current schedule[2]). Also make sure to do this even for relnotes that haven't been checked by the change owner. [0] You can do that by asking the change owner listed on the wiki page; alternatively you can infer it by checking the tracker bug (linked in Wiki) in Bugzilla and looking at its status; see bug comments for details. Ask someone on Matrix if you're not sure. + [1] On Matrix in the Fedora Documentation channel - see https://docs.fedoraproject.org/en-US/project/communications/. + [2] Schedules are all here: https://fedorapeople.org/groups/schedule/ - make sure to pick the correct release. From 6038940fa538be4b4ea756cc5f92c14bd1a40e26 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 26 Mar 2024 19:47:12 +0100 Subject: [PATCH 47/85] Update Feedback to avoid a redirect --- modules/release-notes/pages/feedback.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/release-notes/pages/feedback.adoc b/modules/release-notes/pages/feedback.adoc index 7b83ded..1273c87 100644 --- a/modules/release-notes/pages/feedback.adoc +++ b/modules/release-notes/pages/feedback.adoc @@ -8,7 +8,7 @@ Thank you for taking the time to provide your comments, suggestions, and bug rep == Providing Feedback on Fedora Software -To provide feedback on Fedora software or other system elements, please refer to link:++https://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common Bugs] on the wiki. +To provide feedback on Fedora software or other system elements, please refer to link:++https://docs.fedoraproject.org/en-US/quick-docs/bugzilla-file-a-bug/++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common Bugs] on the forums. == Providing Feedback on Release Notes From 1fd0e97f269254ae2c9e2862c966a9c45d339b54 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Wed, 27 Mar 2024 08:49:23 +0100 Subject: [PATCH 48/85] Small fixes in change template --- .gitlab/issue_templates/{change.md => Change.md} | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) rename .gitlab/issue_templates/{change.md => Change.md} (83%) diff --git a/.gitlab/issue_templates/change.md b/.gitlab/issue_templates/Change.md similarity index 83% rename from .gitlab/issue_templates/change.md rename to .gitlab/issue_templates/Change.md index 8c71b50..5eb91a6 100644 --- a/.gitlab/issue_templates/change.md +++ b/.gitlab/issue_templates/Change.md @@ -2,28 +2,26 @@ This issue tracks the release note for the following Fedora Change: !!!!LINK TO WIKI HERE!!!! -If you own this change, please add additional information here that we should communicate to Fedora users. Specifically, please consider: +**If you own this change**, please add additional information here that we should communicate to Fedora users. Specifically, please consider: -* New features available because of this change - pick 2 or 3 that are important +* New features available because of this change - pick those that are important to end users * Considerations for users of previous releases of Fedora (upgrade issues, format changes, etc.) * Links to any upstream Release Notes * If this helps Fedora be a superior environment for our target audiences, please explain how so that we can emphasize this. -Your notes to us do not need to be formally written. We will edit them and add details if needed. This is a way for you to ensure that we know what is critical about your change. +Your notes to us do not need to be formally written - we will edit them and add details if needed. This is a way for you to ensure that we know what is critical about your change. -If you want to write this release note, then: +**If you want to write this release note**, then: * Assign this issue to yourself * Check the wiki page linked above, find out what the change is about * Determine whether the change actually made it into the release or not[0] -* Write a draft release note using that information against the correct branch here, in Pagure. (or see below) +* Write a draft release note using that information against the correct branch here, in Gitlab. (or see below) * Get in touch with the contact person/people listed on the wiki page, either through IRC/Matrix or e-mail or just by @-mentioning them in a comment here, and ask them to check your draft for technical accuracy * Submit your Release Note as a PR to this repository. Once you're done with the above, make sure to either commit the relnote to an appropriate section of the Release Notes, or, if you're not familiar with Git, AsciiDoc, or whatever else, just add it to this issue as a comment and let the team[1] know that you're done with this one and you'd like the note included. Be sure to do this at least one day before the final release (see current schedule[2]). Also make sure to do this even for relnotes that haven't been checked by the change owner. [0] You can do that by asking the change owner listed on the wiki page; alternatively you can infer it by checking the tracker bug (linked in Wiki) in Bugzilla and looking at its status; see bug comments for details. Ask someone on Matrix if you're not sure. - [1] On Matrix in the Fedora Documentation channel - see https://docs.fedoraproject.org/en-US/project/communications/. - [2] Schedules are all here: https://fedorapeople.org/groups/schedule/ - make sure to pick the correct release. From 9e0984c7dcb7806886c9185f65b5667afb80d859 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Wed, 27 Mar 2024 08:53:49 +0100 Subject: [PATCH 49/85] Fix whitespace in change template --- .gitlab/issue_templates/Change.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.gitlab/issue_templates/Change.md b/.gitlab/issue_templates/Change.md index 5eb91a6..17503db 100644 --- a/.gitlab/issue_templates/Change.md +++ b/.gitlab/issue_templates/Change.md @@ -22,6 +22,6 @@ Your notes to us do not need to be formally written - we will edit them and add Once you're done with the above, make sure to either commit the relnote to an appropriate section of the Release Notes, or, if you're not familiar with Git, AsciiDoc, or whatever else, just add it to this issue as a comment and let the team[1] know that you're done with this one and you'd like the note included. Be sure to do this at least one day before the final release (see current schedule[2]). Also make sure to do this even for relnotes that haven't been checked by the change owner. -[0] You can do that by asking the change owner listed on the wiki page; alternatively you can infer it by checking the tracker bug (linked in Wiki) in Bugzilla and looking at its status; see bug comments for details. Ask someone on Matrix if you're not sure. -[1] On Matrix in the Fedora Documentation channel - see https://docs.fedoraproject.org/en-US/project/communications/. -[2] Schedules are all here: https://fedorapeople.org/groups/schedule/ - make sure to pick the correct release. +[0] You can do that by asking the change owner listed on the wiki page; alternatively you can infer it by checking the tracker bug (linked in Wiki) in Bugzilla and looking at its status; see bug comments for details. Ask someone on Matrix if you're not sure. +[1] On Matrix in the Fedora Documentation channel - see https://docs.fedoraproject.org/en-US/project/communications/. +[2] Schedules are all here: https://fedorapeople.org/groups/schedule/ - make sure to pick the correct release. From 2310942f0f8b4924e79f5027a3d7c7031d15540c Mon Sep 17 00:00:00 2001 From: Adam Williamson Date: Wed, 27 Mar 2024 09:02:47 -0700 Subject: [PATCH 50/85] Update README for Gitlab move Signed-off-by: Adam Williamson --- README.md | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index df7d112..7b77c19 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,12 @@ # Fedora Release Notes Please report Issues and submit Pull Requests for **Content Fixes** here. -Never done a pull request (or "PR")? Here's the [Pagure documentation for -Pull Requests](https://docs.pagure.org/pagure/usage/pull_requests.html). +Never done a pull request (or "PR")? Here's the [Gitlab documentation for +Pull Requests](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html). General appearance issues and publishing issues should be reported against -the [publishing software](https://pagure.io/fedora-docs/docs-fp-o). +the [publishing software](https://gitlab.com/fedora/docs/docs-website/docs-fp-o). ## Structure @@ -51,7 +51,7 @@ Antora introduces two new terms: This repo includes scripts to build and preview the contents of this repository. -**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions. +**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://gitlab.com/fedora/docs/docs-website/docs-fp-o) for instructions. Both scripts work on Fedora (using Podman) and macOS (using Docker). @@ -76,14 +76,15 @@ $ sudo dnf install podman You can also build the whole Fedora Docs site locally to see your changes in the whole context. This is especially useful for checking if your `xref` links work properly. -To do this, you need to clone the main [Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o), modify the `site.yml` file to reference a repo with your changes, and build it. +To do this, you need to clone the main [Fedora Docs build repository](https://gitlab.com/fedora/docs/docs-website/docs-fp-o), modify the `site.yml` file to reference a repo with your changes, and build it. Steps: -Clone the main repository and cd into it: +Clone the main repository and cd into it, then checkout the `prod` branch: ``` -$ git clone https://pagure.io/fedora-docs/docs-fp-o.git +$ git clone https://gitlab.com/fedora/docs/docs-website/docs-fp-o.git $ cd docs-fp-o +$ git checkout prod ``` Find a reference to the repository you're changing in the `site.yml` file, and change it so it points to your change. @@ -91,18 +92,18 @@ So for example, if I made a modification to the Modularity docs, I would find: ``` ... - - url: https://pagure.io/fedora-docs/modularity.git - branches: - - master + - url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes.git + branches: + - master ... ``` And replaced it with a pointer to my fork: ``` ... - - url: https://pagure.io/forks/asamalik/fedora-docs/modularity.git - branches: - - master + - url: https://gitlab.com/AdamWill/release-notes.git + branches: + - master ... ``` From 21bd346cd9ca5be29f41007d0e029315ce8878e6 Mon Sep 17 00:00:00 2001 From: dletai Date: Sun, 3 Nov 2024 12:00:43 +0000 Subject: [PATCH 51/85] Update hardware_overview.adoc fix for dnf5 --- modules/release-notes/pages/hardware_overview.adoc | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/modules/release-notes/pages/hardware_overview.adoc b/modules/release-notes/pages/hardware_overview.adoc index f7a2aea..ab1a748 100644 --- a/modules/release-notes/pages/hardware_overview.adoc +++ b/modules/release-notes/pages/hardware_overview.adoc @@ -83,17 +83,11 @@ Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with ha Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf grouplist` command: ---- -# dnf grouplist -v hidden | grep Desktop +# dnf group list --hidden | grep -i desktop ---- Install the desired group: ---- -# dnf groupinstall "KDE Plasma Workspaces" ----- - -Or, use the short group name to install: - ----- -# dnf install @mate-desktop-environment +# dnf group install kde-desktop ---- From 1782d1593d561fb4299b0e2057f634f8939593a3 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 14 Jan 2025 13:39:12 +0100 Subject: [PATCH 52/85] Update info on installing DEs in Hardware Overview --- modules/release-notes/pages/hardware_overview.adoc | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/modules/release-notes/pages/hardware_overview.adoc b/modules/release-notes/pages/hardware_overview.adoc index ab1a748..41e595b 100644 --- a/modules/release-notes/pages/hardware_overview.adoc +++ b/modules/release-notes/pages/hardware_overview.adoc @@ -80,14 +80,16 @@ Systems with older or no graphics acceleration devices can have accelerated desk Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*. -Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf grouplist` command: +Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf environment list` command: ---- -# dnf group list --hidden | grep -i desktop +# dnf environment list ---- -Install the desired group: +Install the desired environment using its ID as listed in the above command's output: ---- -# dnf group install kde-desktop +# dnf install @cinnamon-desktop-environment ---- + +For more information, see the `dnf5-environment` man page. From c0210a674c3e0ee2aa37917958f3d09d95e84a2d Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 6 May 2025 16:23:53 +0200 Subject: [PATCH 53/85] 210 - Change GNOME3 references to just GNOME in Hardware Overview --- modules/release-notes/pages/hardware_overview.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/release-notes/pages/hardware_overview.adoc b/modules/release-notes/pages/hardware_overview.adoc index 41e595b..71d3ddb 100644 --- a/modules/release-notes/pages/hardware_overview.adoc +++ b/modules/release-notes/pages/hardware_overview.adoc @@ -62,7 +62,7 @@ Once installed, Fedora will support these lower resolution devices. The minimum [[hardware_overview-graphics-legacy_gpus]] === Minimum Hardware for Accelerated Desktops -Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME3* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration: +Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration: * Intel prior to GMA9xx @@ -78,7 +78,7 @@ Systems with older or no graphics acceleration devices can have accelerated desk [[hardware_overview-graphics-desktops]] === Choosing a Desktop Environment for your hardware -Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*. +Fedora {PRODVER}'s default desktop environment, *GNOME*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*. Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf environment list` command: From 68b545677a87befa269d914d458c9e3fe4446b2b Mon Sep 17 00:00:00 2001 From: darknao Date: Sun, 26 Oct 2025 12:48:50 +0100 Subject: [PATCH 54/85] F43 release --- antora.yml | 2 +- modules/release-notes/partials/entities.adoc | 8 ++++---- site.yml | 2 +- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/antora.yml b/antora.yml index d70d031..85cb4da 100644 --- a/antora.yml +++ b/antora.yml @@ -1,5 +1,5 @@ --- name: fedora -version: rawhide +version: f43 # Navigation is in the main 'fedora' component: # https://pagure.io/fedora-docs/release-docs-home diff --git a/modules/release-notes/partials/entities.adoc b/modules/release-notes/partials/entities.adoc index 7c51e16..c28c88c 100644 --- a/modules/release-notes/partials/entities.adoc +++ b/modules/release-notes/partials/entities.adoc @@ -1,9 +1,9 @@ :BOOKID: release-notes :BZURL: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes/-/issues // Change this to the latest version -:COMMONBUGS_URL: https://discussion.fedoraproject.org/tags/c/ask/common-issues/82/all/f40 +:COMMONBUGS_URL: https://discussion.fedoraproject.org/tags/c/ask/common-issues/82/all/f43 :HOLDER: Fedora Project Contributors -:PREVVER: 39 +:PREVVER: 42 :PRODUCT: Fedora Documentation -:PRODVER: rawhide -:YEAR: 2024 +:PRODVER: 43 +:YEAR: 2025 diff --git a/site.yml b/site.yml index 9049892..f67a1f7 100644 --- a/site.yml +++ b/site.yml @@ -6,7 +6,7 @@ content: - url: . branches: HEAD - url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home.git - branches: main + branches: f43 ui: bundle: url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable From ff1acc2f3f60c43983a5f09eea5d73a2cdd7ae31 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 09:07:54 +0100 Subject: [PATCH 55/85] 234, 223, 246, 229 - installer-related changes --- modules/release-notes/pages/sysadmin.adoc | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index 8397121..7fa7164 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -2,3 +2,26 @@ include::partial$entities.adoc[] = Changes in Fedora {PRODVER} For System Administrators + +== Changes in the Anaconda installer + +=== Fedora spins now use the new WebUI installer + +Fedora 42 has introduced a new, redesigned graphical installer interface using a new, browser-based WebUI, which was available on Fedora Workstation. +In Fedora 43, the same installer is now also used on Fedora KDE Edition, as well as some of the Spins. + +=== No more support for installs on MBR-partitioned disks in UEFI mode on x86 + +Starting with Fedora 43, the installer no longer supports installing Fedora on disks using a Master Boot Record (MBR) while in UEFI boot mode on 32-bit x86 systems. +Instead, the installer will enforce the use of a GUID Partition Table (GPT), which is a significantly more modern standard, and was already the default previously on some hardware configurations. +Existing 32-bit UEFI systems with MBR-partitioned disks can be upgraded like normal, only new installations are affected. + +=== Anaconda now uses DNF5 + +Fedora as a whole has switched to DNF5 in the 41 release for general package management and image building. +Starting with Fedora 43, Anaconda is now also using DNF5 on the backend. The change should not be visible to most users. + +=== Modularity support removal + +Since the Fedora Modularity project has been deprecated, supports for package modularity has now also been removed from Anaconda. +This change is related to the switch to DNF5, as DNF5 no longer supports modularity either, so this allows Anaconda to be upgraded to DNF5. From 69ce33384bad1261e8920350a79e72623ac2eca4 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 09:15:02 +0100 Subject: [PATCH 56/85] 263 - /boot now 2G by default --- modules/release-notes/pages/sysadmin.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index 7fa7164..0325206 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -25,3 +25,9 @@ Starting with Fedora 43, Anaconda is now also using DNF5 on the backend. The cha Since the Fedora Modularity project has been deprecated, supports for package modularity has now also been removed from Anaconda. This change is related to the switch to DNF5, as DNF5 no longer supports modularity either, so this allows Anaconda to be upgraded to DNF5. + +=== Default /boot partition is now 2G + +Fedora Linux 43 has raised the size of the default `/boot` partition to 2 GiB. +This is to accommodate increases in boot data over the past several releases and to maintain a usable experience. +Users of older releases may be advised to consider reinstalling instead of upgrading to increase the `/boot` partition size. From ffc387d4062b97c0739dcc23af9d59b9400175b0 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 09:21:51 +0100 Subject: [PATCH 57/85] 51 - Kinoite automatic updates --- modules/release-notes/pages/sysadmin.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index 0325206..c3edd4f 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -31,3 +31,9 @@ This change is related to the switch to DNF5, as DNF5 no longer supports modular Fedora Linux 43 has raised the size of the default `/boot` partition to 2 GiB. This is to accommodate increases in boot data over the past several releases and to maintain a usable experience. Users of older releases may be advised to consider reinstalling instead of upgrading to increase the `/boot` partition size. + +== Automatic updates by default on Fedora Kinoite + +Updates on Fedora Kinoite are now downloaded automatically and applied on the next reboot. +The change applies to all systems, whether newly installed or updated to Fedora 43, unless the autoupdate setting has been changed before. +You can change the frequency of automatic updates (or disable them completely, though this is not recommended) by using the "Unattended Updates" setting in System Settings. From 70142337583a6fc6e4759be49815fb483118cc0f Mon Sep 17 00:00:00 2001 From: mulkieran Date: Tue, 28 Oct 2025 03:47:12 +0000 Subject: [PATCH 58/85] F43 stratis release notes --- modules/release-notes/pages/sysadmin.adoc | 40 +++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index c3edd4f..a609f7b 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -37,3 +37,43 @@ Users of older releases may be advised to consider reinstalling instead of upgra Updates on Fedora Kinoite are now downloaded automatically and applied on the next reboot. The change applies to all systems, whether newly installed or updated to Fedora 43, unless the autoupdate setting has been changed before. You can change the frequency of automatic updates (or disable them completely, though this is not recommended) by using the "Unattended Updates" setting in System Settings. + +== Stratis 3.8.5: stratisd 3.8.5 and stratis-cli 3.8.2 + +Stratis 3.8.5, which consists of `stratisd 3.8.5` and `stratis-cli 3.8.2` includes +a number of significant enhancements and modifications. + +=== stratisd + +For `stratisd`, the release makes improvements to the Stratis support for mounting +filesystems at boot. It introduces a new systemd unit file, +`stratis-fstab-setup-with-network@.service`, which should be used when a filesystem's pool +requires unlocking with the network present, as is the case when a pool is encrypted using +NBDE (network-bound disk encryption). The fstab entry for the filesystem must include the +`_netdev` option if this systemd unit file is used. + +If the `stratis-fstab-setup-with-network@service` unit is used and the `_netdev` option is +omitted in the same fstab entry, systemd will calculate a cyclic dependency, +and the boot process will fail. + +An example fstab entry for a filesystem on a pool that is encrypted using NBDE should look +something like this: + +`/dev/stratis// xfs defaults,_netdev,x-systemd.requires=stratis-fstab-setup-with-network@.service 0 2` + +If a filesystem's pool does not require that the network is up to be unlocked then the fstab +entry may use the existing `stratis-fstab-setup@.service` unit instead. + +Additionally `stratisd` takes responsibility for maintaining the key used to encrypt a Stratis +pool, so that it is guaranteed to be present in the kernel keyring if an automatic pool maintenance +action needs to be performed on an encrypted pool. `stratisd` updates the new `VolumeKeyLoaded` +D-Bus property on the affected pool with an error message if the key is not loaded. + +`stratisd` also exposes additional information about stopped pools in the StoppedPools property. + +=== stratis-cli + +For `stratis-cli`, the release fixes a bug where a user would be unable to start an +encrypted pool previously created with any Stratis release less than 3.8.0. + +`stratis-cli` also exposes more information about a stopped pool in its detail view. \ No newline at end of file From 869c6ef021adf0bb7afd1fd689f551e1cce4de9a Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:31:03 +0100 Subject: [PATCH 59/85] 271 - Tomcat 10.1 --- modules/release-notes/pages/developers.adoc | 25 +++++++++++++++++++++ modules/release-notes/pages/sysadmin.adoc | 7 +++--- 2 files changed, 29 insertions(+), 3 deletions(-) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 17205fa..07263d8 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -2,3 +2,28 @@ include::partial$entities.adoc[] = Changes in Fedora {PRODVER} For Developers + +== Tomcat 10.1 +The Tomcat application server has been upgraded to version 10.1 in Fedora 43. + +Changes in this version include: + +* Apache Tomcat 10.1.x requires Java 11 or later. +* Specification API Breaking Changes: There is a significant breaking change between Tomcat 9.0.x and Tomcat 10.1.x. +The Java package used by the specification APIs has changed from `++javax.*++` to `++jakarta.*++`. +It will be necessary to recompile web applications against the new APIs. +See the link:++https://fedoraproject.org/wiki/Changes/Tomcat10ChangeProposal#Upgrade/compatibility_impact++[Change page on the Fedora Wiki] for details. +* Other Specification API changes: +** Jakarta Servlet 6.0 API: The Java package has changed from `javax.servlet` to `jakarta.servlet`. A new method, `Cookie.setAttribute(String name, String value)` has been added. The process for decoding and normalizing URIs has been clarified. New methods and classes have been added to provide access to unique identifiers for the current request and/or associated connection. +** Jakarta Server Pages 3.1 API: The Java package has changed from `javax.servlet.jsp` to `jakarta.servlet.jsp`. Added an option to raise a `PropertyNotFoundException` when an EL expression contains an unknown identifier. +** Jakarta Expression Language 5.0: The Java package has changed from `javax.el` to `jakarta.el`. The EL API now uses generics where appropriate. The deprecated `MethodExpression.isParmetersProvided()` method has been removed from the API. +** Jakarta WebSocket 2.1: The Java package has changed from `javax.websocket` to `jakarta.websocket`. The packaging of the API JARs has changed to remove duplicate classes. The server API now has a dependency on the client API JAR. +** Jakarta Authentication 3.0: The Java package has changed from `javax.security.auth.message` to `jakarta.security.auth.message`. +* Internal Tomcat APIs: Whilst the Tomcat 10 internal API is broadly compatible with Tomcat 9, there have been many changes at the detail level and they are not binary compatible. Developers of custom components that interact with Tomcat's internals should review the JavaDoc for the relevant API. +* `web.xml` defaults: `conf/web.xml` sets the default request and response character encoding to UTF-8. +* Session management: Session persistence on restart has been disabled by default. It may be re-enabled globally in `conf/context.xml` or per web application. +* HTTP/2: The configuration settings that were duplicated between the HTTP/1.1 and HTTP/2 connectors have been removed from the HTTP/2 connector which will now inherit them from the associated HTTP/1.1 connector. +* Logging: The logging implementation now only creates log files once there is something to write to the log files. +* Access Log Patterns: To align with httpd, the `%D` pattern now logs request time in microseconds rather than milliseconds. To log request time in milliseconds, use `%{ms}T`. + +See the link:++https://tomcat.apache.org/tomcat-10.1-doc/changelog.html++[upstream changelog] for additional information. diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index a609f7b..db1237f 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -34,9 +34,10 @@ Users of older releases may be advised to consider reinstalling instead of upgra == Automatic updates by default on Fedora Kinoite -Updates on Fedora Kinoite are now downloaded automatically and applied on the next reboot. +Updates to both the system and all Flatpaks on Fedora Kinoite are now downloaded automatically and applied on the next reboot. The change applies to all systems, whether newly installed or updated to Fedora 43, unless the autoupdate setting has been changed before. -You can change the frequency of automatic updates (or disable them completely, though this is not recommended) by using the "Unattended Updates" setting in System Settings. + +You can change the frequency of automatic updates (or disable them completely, though this is not recommended) in system settings, under the **Software Updates** tab. == Stratis 3.8.5: stratisd 3.8.5 and stratis-cli 3.8.2 @@ -76,4 +77,4 @@ D-Bus property on the affected pool with an error message if the key is not load For `stratis-cli`, the release fixes a bug where a user would be unable to start an encrypted pool previously created with any Stratis release less than 3.8.0. -`stratis-cli` also exposes more information about a stopped pool in its detail view. \ No newline at end of file +`stratis-cli` also exposes more information about a stopped pool in its detail view. From 0ba7125459d66845bc0102c5d019bbe630a9d79b Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:37:06 +0100 Subject: [PATCH 60/85] 270 - Haskell GHC 9.8 and Stackage 23 --- modules/release-notes/pages/developers.adoc | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 07263d8..31796ec 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -27,3 +27,10 @@ See the link:++https://fedoraproject.org/wiki/Changes/Tomcat10ChangeProposal#Upg * Access Log Patterns: To align with httpd, the `%D` pattern now logs request time in microseconds rather than milliseconds. To log request time in milliseconds, use `%{ms}T`. See the link:++https://tomcat.apache.org/tomcat-10.1-doc/changelog.html++[upstream changelog] for additional information. + +[[haskell-ghc-9-8]] +== Haskell GHC 9.8 and Stackage LTS 23 + +For Fedora 42, the main GHC Haskell compiler package have been from version link:++https://www.haskell.org/ghc/download_ghc_9_6_6.html++[9.6.6] to the latest stable link:++https://www.haskell.org/ghc/download_ghc_9_8_4.html++[9.8.4] release (rebasing the ghc package from the link:++https://src.fedoraproject.org/rpms/ghc9.8/++[ghc9.8] package). Along with this, Haskell packages in link:++https://www.stackage.org/++[Stackage] (the stable Haskell source package distribution) have been updated from the versions in link:++https://www.stackage.org/lts-22++[LTS 22] to latest link:++https://www.stackage.org/lts-23++[LTS 23] release. Haskell packages not in Stackage have been updated to the latest appropriate version in the upstream link:++https://hackage.haskell.org/++[Hackage] package repository. + +For full information about this release, see the link:++https://downloads.haskell.org/~ghc/9.8.4/docs/users_guide/9.8.4-notes.html++[upstream release notes] and link:++https://gitlab.haskell.org/ghc/ghc/-/wikis/migration/9.8++[migration guide]. From 3d8228b52ee62e088b12584f3f042ddaf0313371 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:37:27 +0100 Subject: [PATCH 61/85] 267 - Python 3.14 --- modules/release-notes/pages/developers.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 31796ec..2598090 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -3,6 +3,12 @@ include::partial$entities.adoc[] = Changes in Fedora {PRODVER} For Developers +[[python-3-14]] +== Python 3.14 +The Python stack in Fedora has been updated from version 3.13 to version 3.14, the latest major release of the Python programming language. + +For more information, see the link:++https://docs.python.org/dev/whatsnew/3.14.html#what-s-new-in-python-3-14++[upstream "What's new" document], and especially the link:++https://docs.python.org/dev/whatsnew/3.14.html#porting-to-python-3-14++[Porting to Python 3.14] section. + == Tomcat 10.1 The Tomcat application server has been upgraded to version 10.1 in Fedora 43. From 7f522500cd053ef91e22471ac875de6b19e67c2d Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:42:41 +0100 Subject: [PATCH 62/85] 258 - Hare --- modules/release-notes/pages/developers.adoc | 26 +++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 2598090..c0256ec 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -40,3 +40,29 @@ See the link:++https://tomcat.apache.org/tomcat-10.1-doc/changelog.html++[upstre For Fedora 42, the main GHC Haskell compiler package have been from version link:++https://www.haskell.org/ghc/download_ghc_9_6_6.html++[9.6.6] to the latest stable link:++https://www.haskell.org/ghc/download_ghc_9_8_4.html++[9.8.4] release (rebasing the ghc package from the link:++https://src.fedoraproject.org/rpms/ghc9.8/++[ghc9.8] package). Along with this, Haskell packages in link:++https://www.stackage.org/++[Stackage] (the stable Haskell source package distribution) have been updated from the versions in link:++https://www.stackage.org/lts-22++[LTS 22] to latest link:++https://www.stackage.org/lts-23++[LTS 23] release. Haskell packages not in Stackage have been updated to the latest appropriate version in the upstream link:++https://hackage.haskell.org/++[Hackage] package repository. For full information about this release, see the link:++https://downloads.haskell.org/~ghc/9.8.4/docs/users_guide/9.8.4-notes.html++[upstream release notes] and link:++https://gitlab.haskell.org/ghc/ghc/-/wikis/migration/9.8++[migration guide]. + +[[hare]] +== The Hare programming language + +Fedora 43 introduces packages for Hare, a systems programming language designed to be simple, stable, and robust. +Hare uses a static type system, manual memory management, and a minimal runtime. It is well-suited to writing operating systems, system tools, compilers, networking software, and other low-level, high performance tasks. + +The Hare toolchain on Fedora includes: + +* `hare` (build driver) +* `harec` (compiler front-end, already available in Fedora) +* `qbe` (compiler back-end, already available in Fedora) +* `binutils` (for assembly and static linking) +* `gcc` (for dynamic linking, it also works with other C compilers) + +The Hare tool chain can target the `x86_64`, `aarch64`, and `riscv64` architectures, and is configured to rely by default on `gcc--linux-gnu` and `binutils--linux-gnu` for cross compilation. + +The `hare` source package includes the following: + +* `hare` (build driver, `haredoc` utility, and manuals) +* `hare-stdlib` (standard library) +* `hare-rpm-macros` (packaging utilities) + +In addition, a `hare-update` package is provided to assist Hare developers dealing with breaking changes when a new Hare release is available, until the language and its standard library become stable. + +For more information about Hare, see the link:++https://harelang.org/documentation/++[upstream documentation] and link:++https://harelang.org/specification++[specification]. A link:++https://harelang.org/tutorial++[tutorial] is also available on the official website. From 00206313ecdad18e6b593b24699055014b3278ef Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:46:08 +0100 Subject: [PATCH 63/85] 255 - TBB 2022.2.0 --- modules/release-notes/pages/developers.adoc | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index c0256ec..1f60e1c 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -66,3 +66,12 @@ The `hare` source package includes the following: In addition, a `hare-update` package is provided to assist Hare developers dealing with breaking changes when a new Hare release is available, until the language and its standard library become stable. For more information about Hare, see the link:++https://harelang.org/documentation/++[upstream documentation] and link:++https://harelang.org/specification++[specification]. A link:++https://harelang.org/tutorial++[tutorial] is also available on the official website. + +[[tbb-2022-2-0]] +== TBB2022.2.0 + +The `tbb` package contains Intel's oneAPI Threading Building Blocks, a library for breaking computations into parralel tasks. In Fedora 43, this package has been upgraded from version 2022.0.0 to version 2022.2.0. + +Due to an ABI change, non-Fedora packages that use `tbb` will likely need to be rebuilt. Version 2022.2.0 is API-compatible with version 2022.0.0, so a simple rebuild should suffice. + +For detailed information, see the link:++https://github.com/uxlfoundation/oneTBB/blob/master/RELEASE_NOTES.md++[upstream release notes for TBB 2022.1.0 and TBB 2022.2.0]. From 42ad4a8089b52eea5502d4de6ea27bb34f154411 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:48:20 +0100 Subject: [PATCH 64/85] 252 - PostgreSQL 18 --- modules/release-notes/pages/sysadmin.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index db1237f..c8845b4 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -78,3 +78,8 @@ For `stratis-cli`, the release fixes a bug where a user would be unable to start encrypted pool previously created with any Stratis release less than 3.8.0. `stratis-cli` also exposes more information about a stopped pool in its detail view. + +== PostgreSQL 18 +PostgreSQL in Fedora 43 (the `postgresql` and `libpq` components) has been upgraded to major version 18. This continues the versioned packaging structure introduced in Fedora 40. + +See the link:++https://www.postgresql.org/docs/18/release-18.html++[upstream release notes] for more information and notes on migration. From db7089f6e7ea151266efbfa7de9fcc2047597ead Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:55:26 +0100 Subject: [PATCH 65/85] 249 - Read only BDB support in 389 DS --- modules/release-notes/pages/sysadmin.adoc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index c8845b4..f7a0580 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -83,3 +83,18 @@ encrypted pool previously created with any Stratis release less than 3.8.0. PostgreSQL in Fedora 43 (the `postgresql` and `libpq` components) has been upgraded to major version 18. This continues the versioned packaging structure introduced in Fedora 40. See the link:++https://www.postgresql.org/docs/18/release-18.html++[upstream release notes] for more information and notes on migration. + +== Read-only BDB support in 389 Directory Server +Starting from 389-ds-base version 3.1.3, the 389 Directory Server no longer supports the deprecated BerkeleyDB, so the LDMB database must be used. Users still using BerkeleyDB will have to migrate their data. In Fedora this change is available starting from Fedora 43 (Version 3.2.0 that was also originally planned for Fedora 43 is delayed.) + +Directory server instances created since Fedora 40 and using the default LMDB database are not impacted (that is typically the case for FreeIPA users). +However, users still using BerkeleyDB (either because they have not yet migrated or because they explicitly choose to use BerkeleyDB) are required to migrate to LMDB. + +If this step is not done, the instance will not be able to start after the upgrade, and the following error message is displayed in the dirsrv error log and in the system journal: + +[,console] +---- +bdb implementation is no longer supported. Directory server cannot be started without migrating to lmdb first. To migrate, please run: dsctl instanceName dblib bdb2mdb +---- + +Users then need to migrate the data either using the `dsctl` command, or manually by following the steps in the link:++https://www.port389.org/docs/389ds/FAQ/Berkeley-DB-deprecation.html#manual-method---export-to-ldif++[upstream FAQ]. From bd218282ec87fbebd09c0be162eb922e01c1b062 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:57:02 +0100 Subject: [PATCH 66/85] Add IDs and escape attribute in Developers/Tomcat --- modules/release-notes/pages/developers.adoc | 3 ++- modules/release-notes/pages/sysadmin.adoc | 3 +++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 1f60e1c..81e83c9 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -9,6 +9,7 @@ The Python stack in Fedora has been updated from version 3.13 to version 3.14, t For more information, see the link:++https://docs.python.org/dev/whatsnew/3.14.html#what-s-new-in-python-3-14++[upstream "What's new" document], and especially the link:++https://docs.python.org/dev/whatsnew/3.14.html#porting-to-python-3-14++[Porting to Python 3.14] section. +[[tomcat-10-1]] == Tomcat 10.1 The Tomcat application server has been upgraded to version 10.1 in Fedora 43. @@ -30,7 +31,7 @@ See the link:++https://fedoraproject.org/wiki/Changes/Tomcat10ChangeProposal#Upg * Session management: Session persistence on restart has been disabled by default. It may be re-enabled globally in `conf/context.xml` or per web application. * HTTP/2: The configuration settings that were duplicated between the HTTP/1.1 and HTTP/2 connectors have been removed from the HTTP/2 connector which will now inherit them from the associated HTTP/1.1 connector. * Logging: The logging implementation now only creates log files once there is something to write to the log files. -* Access Log Patterns: To align with httpd, the `%D` pattern now logs request time in microseconds rather than milliseconds. To log request time in milliseconds, use `%{ms}T`. +* Access Log Patterns: To align with httpd, the `%D` pattern now logs request time in microseconds rather than milliseconds. To log request time in milliseconds, use `++%{ms}T++`. See the link:++https://tomcat.apache.org/tomcat-10.1-doc/changelog.html++[upstream changelog] for additional information. diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index f7a0580..498077b 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -3,6 +3,7 @@ include::partial$entities.adoc[] = Changes in Fedora {PRODVER} For System Administrators +[[anaconda]] == Changes in the Anaconda installer === Fedora spins now use the new WebUI installer @@ -79,11 +80,13 @@ encrypted pool previously created with any Stratis release less than 3.8.0. `stratis-cli` also exposes more information about a stopped pool in its detail view. +[[postgresql-18]] == PostgreSQL 18 PostgreSQL in Fedora 43 (the `postgresql` and `libpq` components) has been upgraded to major version 18. This continues the versioned packaging structure introduced in Fedora 40. See the link:++https://www.postgresql.org/docs/18/release-18.html++[upstream release notes] for more information and notes on migration. +[[read-only-bdb-in-389-ds]] == Read-only BDB support in 389 Directory Server Starting from 389-ds-base version 3.1.3, the 389 Directory Server no longer supports the deprecated BerkeleyDB, so the LDMB database must be used. Users still using BerkeleyDB will have to migrate their data. In Fedora this change is available starting from Fedora 43 (Version 3.2.0 that was also originally planned for Fedora 43 is delayed.) From f4451ef915c7e81ea5e7df9db6f3aaf4531f867b Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 15:59:47 +0100 Subject: [PATCH 67/85] 248 - Ruby on Rails 8.0 --- modules/release-notes/pages/developers.adoc | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 81e83c9..56c5eca 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -9,6 +9,18 @@ The Python stack in Fedora has been updated from version 3.13 to version 3.14, t For more information, see the link:++https://docs.python.org/dev/whatsnew/3.14.html#what-s-new-in-python-3-14++[upstream "What's new" document], and especially the link:++https://docs.python.org/dev/whatsnew/3.14.html#porting-to-python-3-14++[Porting to Python 3.14] section. +[[ruby-on-rails-8]] +== Ruby on Rails 8.0 +The Ruby on Rails stack has been upgraded from version 7.0 in Fedora 42 to version 8.0 in Fedora 43. +Notable changes include: + +* Trifecta of new database-backed adapters named Solid Cable, Solid Cache, and Solid Queue (not part of Fedora at the moment). +* SQLite ready for production. +* Sprockets replaced with Propshaft. +* Generating the authentication basics. + +See the link:++https://guides.rubyonrails.org/8_0_release_notes.html++[upstream release notes] for more information. + [[tomcat-10-1]] == Tomcat 10.1 The Tomcat application server has been upgraded to version 10.1 in Fedora 43. From 6955fdb8d185540784446d3228a168d7bd76a23b Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 16:06:25 +0100 Subject: [PATCH 68/85] 243 - GNU toolchain update --- modules/release-notes/pages/developers.adoc | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 56c5eca..b913945 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -9,6 +9,17 @@ The Python stack in Fedora has been updated from version 3.13 to version 3.14, t For more information, see the link:++https://docs.python.org/dev/whatsnew/3.14.html#what-s-new-in-python-3-14++[upstream "What's new" document], and especially the link:++https://docs.python.org/dev/whatsnew/3.14.html#porting-to-python-3-14++[Porting to Python 3.14] section. +[[gnu-toolchain]] +== GNU toolchain update +The GNU toolchain in Fedora 42 has been updated to: + +* GNU C Compiler (`gcc`) 15.2 +* GNU Binary Utilities (`binutils`) 2.45 +* GNU C Library (`glibc`) 2.42 +* GNU Debugger (`gdb`) 16.3 + +Also see the upstream release notes for link:++https://gcc.gnu.org/gcc-15/changes.html++[GCC], link:++https://lists.gnu.org/archive/html/info-gnu/2025-07/msg00009.html++[Binutils], link:++https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;hb=HEAD++[GLibC NEWS], and link:++https://www.sourceware.org/gdb/news/++[GDB NEWS]. + [[ruby-on-rails-8]] == Ruby on Rails 8.0 The Ruby on Rails stack has been upgraded from version 7.0 in Fedora 42 to version 8.0 in Fedora 43. From fb620d9a76bb8ef4fcd3a85ad1c01b0a1cb2de21 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 16:08:32 +0100 Subject: [PATCH 69/85] 242 - Golang 1.25 --- modules/release-notes/pages/developers.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index b913945..9c82cfa 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -20,6 +20,12 @@ The GNU toolchain in Fedora 42 has been updated to: Also see the upstream release notes for link:++https://gcc.gnu.org/gcc-15/changes.html++[GCC], link:++https://lists.gnu.org/archive/html/info-gnu/2025-07/msg00009.html++[Binutils], link:++https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;hb=HEAD++[GLibC NEWS], and link:++https://www.sourceware.org/gdb/news/++[GDB NEWS]. +[[golang-1-25]] +== Golang 1.25 +The latest stable release of the Go programming language is now available in Fedora 43. + +For more information, see the link:++https://tip.golang.org/doc/go1.25++[upstream release notes]. + [[ruby-on-rails-8]] == Ruby on Rails 8.0 The Ruby on Rails stack has been upgraded from version 7.0 in Fedora 42 to version 8.0 in Fedora 43. From 82dbfc933c0f1cf0ccf24229c17c3f8f3d4c9729 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Mon, 27 Oct 2025 16:11:55 +0100 Subject: [PATCH 70/85] 241 - LLVM 21 --- modules/release-notes/pages/developers.adoc | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 9c82cfa..7185bc4 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -26,6 +26,19 @@ The latest stable release of the Go programming language is now available in Fed For more information, see the link:++https://tip.golang.org/doc/go1.25++[upstream release notes]. +[[llvm-21]] +== LLVM 21 +LLVM sub-projects in Fedora have been updated to version 21. +There has been a soname version change for the llvm libraries, and an llvm20 compat package has been added to ensure that packages that currently depend on `clang` and `llvm` version 20 libraries will continue to work. + +Other notable changes include: + +* Built with PGO: The `llvm` package is now built with PGO optimization, so users of its libraries and binaries should see some performance improvements. For example, `clang` should be noticeably faster compiling C and C++ files. +* Undoing the prefix changes from LLVM 20: This change was made in rawhide and f42 after the f42 release, so it is already done. See https://pagure.io/fesco/issue/3414. + +More information is available in the link:++https://releases.llvm.org/21.1.0/docs/ReleaseNotes.html++[upstream release notes]. + + [[ruby-on-rails-8]] == Ruby on Rails 8.0 The Ruby on Rails stack has been upgraded from version 7.0 in Fedora 42 to version 8.0 in Fedora 43. From 8e211f404d2151efd1fd9cffc3496ebaa5b4d00c Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 28 Oct 2025 04:46:16 +0100 Subject: [PATCH 71/85] 239 - Golang packages vendored by default --- modules/release-notes/pages/developers.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 7185bc4..12f03d3 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -26,6 +26,11 @@ The latest stable release of the Go programming language is now available in Fed For more information, see the link:++https://tip.golang.org/doc/go1.25++[upstream release notes]. +=== Golang packages are now vendored by default +Fedora now uses vendored dependencies as the default and preferred option when building Golang applications, instead of relying on pre-packaged dependencies. +This includes adopting link:++https://fedora.gitlab.io/sigs/go/go-vendor-tools/++[Go Vendor Tools], a new set of tooling to handle license scanning, generating a cumulative SPDX expression for all dependencies, and creating reproducible vendor archives. +This change aims to simplify packaging Golang applications in Fedora. Users should not see any change in behavior. + [[llvm-21]] == LLVM 21 LLVM sub-projects in Fedora have been updated to version 21. From 19ec2c1042c2bc5f255bd545d1e80f9949f23749 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 28 Oct 2025 04:54:07 +0100 Subject: [PATCH 72/85] 238 - Dovecot 2.4 --- modules/release-notes/pages/sysadmin.adoc | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index 498077b..0b3fce3 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -101,3 +101,11 @@ bdb implementation is no longer supported. Directory server cannot be started wi ---- Users then need to migrate the data either using the `dsctl` command, or manually by following the steps in the link:++https://www.port389.org/docs/389ds/FAQ/Berkeley-DB-deprecation.html#manual-method---export-to-ldif++[upstream FAQ]. + +[[dovecot-2-4]] +== Dovecot 2.4 +The Dovecot e-mails server has been updated to version 2.4 in Fedora 43. This is the latest major update, released after 7 years of development. + +Note that Dovecot 2.4 configuration is not totally compatible with the previous version (2.3). See the link:++https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html++[Upgrading Dovecot CE from 2.3 to 2.4] document upstream. + +For more information about this release, see the link:++https://github.com/dovecot/core/releases/tag/2.4.0++[upstream release notes]. From 17153ac992155637225fb1916ac24f8d68d5c5d0 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 28 Oct 2025 04:57:38 +0100 Subject: [PATCH 73/85] 237 - MySQL 8.4 as default --- modules/release-notes/pages/sysadmin.adoc | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index 0b3fce3..be85e96 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -109,3 +109,16 @@ The Dovecot e-mails server has been updated to version 2.4 in Fedora 43. This is Note that Dovecot 2.4 configuration is not totally compatible with the previous version (2.3). See the link:++https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html++[Upgrading Dovecot CE from 2.3 to 2.4] document upstream. For more information about this release, see the link:++https://github.com/dovecot/core/releases/tag/2.4.0++[upstream release notes]. + +[[mysql-8-4]] +== MySQL 8.4 as default +MySQL 8.4 is now the default version of MySQL in Fedora. + +Those who wish to continue using the previous default version, MySQL 8.0, can use the `mysql-8.0-server` package. + +For information about the latest releases, see the following links: + +* link:++https://dev.mysql.com/doc/relnotes/mysql/8.1/en/++[8.1 release notes] +* link:++https://dev.mysql.com/doc/relnotes/mysql/8.2/en/++[8.2 release notes] +* link:++https://dev.mysql.com/doc/relnotes/mysql/8.3/en/++[8.3 release notes] +* link:++https://dev.mysql.com/doc/relnotes/mysql/8.4/en/++[8.4 release notes] From 10ecd8fcfd9aa4dc0bb9ca166ab566e118ba4df0 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 28 Oct 2025 05:01:25 +0100 Subject: [PATCH 74/85] 220 - Perl 5.42 --- modules/release-notes/pages/developers.adoc | 23 +++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 12f03d3..0bb2ae8 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -123,3 +123,26 @@ The `tbb` package contains Intel's oneAPI Threading Building Blocks, a library f Due to an ABI change, non-Fedora packages that use `tbb` will likely need to be rebuilt. Version 2022.2.0 is API-compatible with version 2022.0.0, so a simple rebuild should suffice. For detailed information, see the link:++https://github.com/uxlfoundation/oneTBB/blob/master/RELEASE_NOTES.md++[upstream release notes for TBB 2022.1.0 and TBB 2022.2.0]. + +[[perl-5-42]] +== Perl 5.42 +Fedora 43 provides Perl 5.42.0, a new stable release that focuses on improving performance, refining existing features, and adding new experimental capabilities. + +**Core enhancements** + +* New `any` and `all` Operators: Two new experimental keywords, `any` and `all`, are introduced for more efficient list processing. They're designed to short-circuit, so they stop processing the list as soon as the result is known. They're compiled directly into the core, making them faster than their counterparts from the `List::Util` module. +* Lexical Methods: You can now declare private, lexical methods using the `my method` syntax. The new -`++>&++` operator allows you to call these methods, ensuring they're only visible within their defined scope. +* `source::encoding` Pragma: A new pragma is available to explicitly declare whether a source file is encoded in ASCII or UTF-8. This helps to catch encoding-related errors early during development. +* Expanded `CORE::` Namespace: Built-in functions like `chdir` and `rand` can now be safely used as first-class subroutine references. This gives you more flexibility when passing core functions as arguments. +* `:writer` Field Attribute: When defining classes with `use feature 'class'`, you can now use the `:writer` attribute on scalar fields to automatically generate setter accessors. + +**Reconsidered features** + +* `smartmatch` and `switch` Reinstated: The `switch` and `smartmatch (~~)` features, which were previously scheduled for removal, have been granted an indefinite reprieve. They are now available, but you must enable them with a specific feature flag. +* Apostrophe as Package Separator: The legacy use of a single apostrophe (`) as a package separator has been reinstated by default after community feedback. You can still control this behavior with a feature flag. + +** Other updates** + +* This release also includes performance improvements to the `tr///` operator, updates to Unicode 16.0 support, and various bug fixes related to locale handling, `goto`, and `eval`. + +For more detailed information, refer to the official link:++For more detailed information, refer to the official perldelta for 5.42.0 documentation. ++[perldelta for 5.42.0] documentation. From c3abe589ceaa7f636de57c15646a8bb19e00cb4e Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 28 Oct 2025 05:05:05 +0100 Subject: [PATCH 75/85] 215 - RPM 6.0 --- modules/release-notes/pages/sysadmin.adoc | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index be85e96..a6b2c10 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -122,3 +122,16 @@ For information about the latest releases, see the following links: * link:++https://dev.mysql.com/doc/relnotes/mysql/8.2/en/++[8.2 release notes] * link:++https://dev.mysql.com/doc/relnotes/mysql/8.3/en/++[8.3 release notes] * link:++https://dev.mysql.com/doc/relnotes/mysql/8.4/en/++[8.4 release notes] + +[[rpm-6]] +== RPM 6.0 +Fedora 43 updates the RPM packaging system to version 6.0. This release provides several security improvements, such as: + +* OpenPGP keys are referred to by their fingerprint or full key id where fingerprint not available (compared to the short keyid in previous versions). +* OpenPGP keys can be updated with `rpmkeys --import ` and corresponding API(s). +* Support for multiple signatures per package. +* Support for automatic signing on package build (mainly for local use). +* Support for OpenPGP v6 keys and signatures (including PQC). +* Support for signing with Sequoia-sq as an alternative to GnuPG. + +For full information about this release, see the link:++https://rpm.org/wiki/Releases/6.0.0++[upstream release notes]. The link:++https://github.com/rpm-software-management/rpm/discussions/3602++[Road to RPM 6.0] post also provides details in a more easily digestible format. From ac124580cc34e0e1e4937f6983bd3e22be383537 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 28 Oct 2025 05:07:57 +0100 Subject: [PATCH 76/85] 208 - Maven 4 --- modules/release-notes/pages/developers.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 0bb2ae8..1a13831 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -146,3 +146,9 @@ Fedora 43 provides Perl 5.42.0, a new stable release that focuses on improving p * This release also includes performance improvements to the `tr///` operator, updates to Unicode 16.0 support, and various bug fixes related to locale handling, `goto`, and `eval`. For more detailed information, refer to the official link:++For more detailed information, refer to the official perldelta for 5.42.0 documentation. ++[perldelta for 5.42.0] documentation. + +[[maven-4]] +== Maven 4 +Maven 4 is a new major version of Maven after 15 years of Maven 3. It brings many improvements, but also breaking changes. Fedora 43 provides Maven 4 as the `maven4` package, making it installable in parallel to Maven 3. + +See the link:++https://maven.apache.org/whatsnewinmaven4.html++[What's new in Maven 4?] post and the link:++https://maven.apache.org/ref/4.0.0-rc-4/++[upstream docs] for more details. From c3a73e03a3f5e59fc9ce859cb07d5e54048816fc Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 28 Oct 2025 05:11:05 +0100 Subject: [PATCH 77/85] 169 - Idris 2 --- modules/release-notes/pages/developers.adoc | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 1a13831..9bcb157 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -152,3 +152,10 @@ For more detailed information, refer to the official link:++For more detailed in Maven 4 is a new major version of Maven after 15 years of Maven 3. It brings many improvements, but also breaking changes. Fedora 43 provides Maven 4 as the `maven4` package, making it installable in parallel to Maven 3. See the link:++https://maven.apache.org/whatsnewinmaven4.html++[What's new in Maven 4?] post and the link:++https://maven.apache.org/ref/4.0.0-rc-4/++[upstream docs] for more details. + +[[idris-2]] +== Idris 2 +Idris 2 is a dependently typed practical functional programming language, now available in Fedora 43. +It is a complete rewrite of Idris 1 (which was written in Haskell and is now deprecated) on top of a Scheme compiler. + +For details, see the link:++https://idris2.readthedocs.io/en/latest/++[upstream documentation], including a list of changes compared to Idris 1 and an Idris 2 tutorial. From 8ae087460c65772627ae5f45fc65613fadee6dd3 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Tue, 28 Oct 2025 05:12:55 +0100 Subject: [PATCH 78/85] Small fixes to the Stratis note --- modules/release-notes/pages/sysadmin.adoc | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index a6b2c10..ac57e97 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -40,6 +40,7 @@ The change applies to all systems, whether newly installed or updated to Fedora You can change the frequency of automatic updates (or disable them completely, though this is not recommended) in system settings, under the **Software Updates** tab. +[[stratis]] == Stratis 3.8.5: stratisd 3.8.5 and stratis-cli 3.8.2 Stratis 3.8.5, which consists of `stratisd 3.8.5` and `stratis-cli 3.8.2` includes @@ -61,7 +62,10 @@ and the boot process will fail. An example fstab entry for a filesystem on a pool that is encrypted using NBDE should look something like this: -`/dev/stratis// xfs defaults,_netdev,x-systemd.requires=stratis-fstab-setup-with-network@.service 0 2` +[,console] +---- +/dev/stratis// xfs defaults,_netdev,x-systemd.requires=stratis-fstab-setup-with-network@.service 0 2 +---- If a filesystem's pool does not require that the network is up to be unlocked then the fstab entry may use the existing `stratis-fstab-setup@.service` unit instead. From f8354971f45a23ba4c132638da4c2cba8b735199 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Petr=20Boko=C4=8D?= Date: Tue, 28 Oct 2025 04:16:18 +0000 Subject: [PATCH 79/85] Revert "Merge branch 'version-upgrades' into 'main'" This reverts merge request !56 --- antora.yml | 2 +- modules/release-notes/pages/developers.adoc | 157 ------------------- modules/release-notes/pages/sysadmin.adoc | 137 ---------------- modules/release-notes/partials/entities.adoc | 8 +- site.yml | 2 +- 5 files changed, 6 insertions(+), 300 deletions(-) diff --git a/antora.yml b/antora.yml index 85cb4da..d70d031 100644 --- a/antora.yml +++ b/antora.yml @@ -1,5 +1,5 @@ --- name: fedora -version: f43 +version: rawhide # Navigation is in the main 'fedora' component: # https://pagure.io/fedora-docs/release-docs-home diff --git a/modules/release-notes/pages/developers.adoc b/modules/release-notes/pages/developers.adoc index 9bcb157..17205fa 100644 --- a/modules/release-notes/pages/developers.adoc +++ b/modules/release-notes/pages/developers.adoc @@ -2,160 +2,3 @@ include::partial$entities.adoc[] = Changes in Fedora {PRODVER} For Developers - -[[python-3-14]] -== Python 3.14 -The Python stack in Fedora has been updated from version 3.13 to version 3.14, the latest major release of the Python programming language. - -For more information, see the link:++https://docs.python.org/dev/whatsnew/3.14.html#what-s-new-in-python-3-14++[upstream "What's new" document], and especially the link:++https://docs.python.org/dev/whatsnew/3.14.html#porting-to-python-3-14++[Porting to Python 3.14] section. - -[[gnu-toolchain]] -== GNU toolchain update -The GNU toolchain in Fedora 42 has been updated to: - -* GNU C Compiler (`gcc`) 15.2 -* GNU Binary Utilities (`binutils`) 2.45 -* GNU C Library (`glibc`) 2.42 -* GNU Debugger (`gdb`) 16.3 - -Also see the upstream release notes for link:++https://gcc.gnu.org/gcc-15/changes.html++[GCC], link:++https://lists.gnu.org/archive/html/info-gnu/2025-07/msg00009.html++[Binutils], link:++https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;hb=HEAD++[GLibC NEWS], and link:++https://www.sourceware.org/gdb/news/++[GDB NEWS]. - -[[golang-1-25]] -== Golang 1.25 -The latest stable release of the Go programming language is now available in Fedora 43. - -For more information, see the link:++https://tip.golang.org/doc/go1.25++[upstream release notes]. - -=== Golang packages are now vendored by default -Fedora now uses vendored dependencies as the default and preferred option when building Golang applications, instead of relying on pre-packaged dependencies. -This includes adopting link:++https://fedora.gitlab.io/sigs/go/go-vendor-tools/++[Go Vendor Tools], a new set of tooling to handle license scanning, generating a cumulative SPDX expression for all dependencies, and creating reproducible vendor archives. -This change aims to simplify packaging Golang applications in Fedora. Users should not see any change in behavior. - -[[llvm-21]] -== LLVM 21 -LLVM sub-projects in Fedora have been updated to version 21. -There has been a soname version change for the llvm libraries, and an llvm20 compat package has been added to ensure that packages that currently depend on `clang` and `llvm` version 20 libraries will continue to work. - -Other notable changes include: - -* Built with PGO: The `llvm` package is now built with PGO optimization, so users of its libraries and binaries should see some performance improvements. For example, `clang` should be noticeably faster compiling C and C++ files. -* Undoing the prefix changes from LLVM 20: This change was made in rawhide and f42 after the f42 release, so it is already done. See https://pagure.io/fesco/issue/3414. - -More information is available in the link:++https://releases.llvm.org/21.1.0/docs/ReleaseNotes.html++[upstream release notes]. - - -[[ruby-on-rails-8]] -== Ruby on Rails 8.0 -The Ruby on Rails stack has been upgraded from version 7.0 in Fedora 42 to version 8.0 in Fedora 43. -Notable changes include: - -* Trifecta of new database-backed adapters named Solid Cable, Solid Cache, and Solid Queue (not part of Fedora at the moment). -* SQLite ready for production. -* Sprockets replaced with Propshaft. -* Generating the authentication basics. - -See the link:++https://guides.rubyonrails.org/8_0_release_notes.html++[upstream release notes] for more information. - -[[tomcat-10-1]] -== Tomcat 10.1 -The Tomcat application server has been upgraded to version 10.1 in Fedora 43. - -Changes in this version include: - -* Apache Tomcat 10.1.x requires Java 11 or later. -* Specification API Breaking Changes: There is a significant breaking change between Tomcat 9.0.x and Tomcat 10.1.x. -The Java package used by the specification APIs has changed from `++javax.*++` to `++jakarta.*++`. -It will be necessary to recompile web applications against the new APIs. -See the link:++https://fedoraproject.org/wiki/Changes/Tomcat10ChangeProposal#Upgrade/compatibility_impact++[Change page on the Fedora Wiki] for details. -* Other Specification API changes: -** Jakarta Servlet 6.0 API: The Java package has changed from `javax.servlet` to `jakarta.servlet`. A new method, `Cookie.setAttribute(String name, String value)` has been added. The process for decoding and normalizing URIs has been clarified. New methods and classes have been added to provide access to unique identifiers for the current request and/or associated connection. -** Jakarta Server Pages 3.1 API: The Java package has changed from `javax.servlet.jsp` to `jakarta.servlet.jsp`. Added an option to raise a `PropertyNotFoundException` when an EL expression contains an unknown identifier. -** Jakarta Expression Language 5.0: The Java package has changed from `javax.el` to `jakarta.el`. The EL API now uses generics where appropriate. The deprecated `MethodExpression.isParmetersProvided()` method has been removed from the API. -** Jakarta WebSocket 2.1: The Java package has changed from `javax.websocket` to `jakarta.websocket`. The packaging of the API JARs has changed to remove duplicate classes. The server API now has a dependency on the client API JAR. -** Jakarta Authentication 3.0: The Java package has changed from `javax.security.auth.message` to `jakarta.security.auth.message`. -* Internal Tomcat APIs: Whilst the Tomcat 10 internal API is broadly compatible with Tomcat 9, there have been many changes at the detail level and they are not binary compatible. Developers of custom components that interact with Tomcat's internals should review the JavaDoc for the relevant API. -* `web.xml` defaults: `conf/web.xml` sets the default request and response character encoding to UTF-8. -* Session management: Session persistence on restart has been disabled by default. It may be re-enabled globally in `conf/context.xml` or per web application. -* HTTP/2: The configuration settings that were duplicated between the HTTP/1.1 and HTTP/2 connectors have been removed from the HTTP/2 connector which will now inherit them from the associated HTTP/1.1 connector. -* Logging: The logging implementation now only creates log files once there is something to write to the log files. -* Access Log Patterns: To align with httpd, the `%D` pattern now logs request time in microseconds rather than milliseconds. To log request time in milliseconds, use `++%{ms}T++`. - -See the link:++https://tomcat.apache.org/tomcat-10.1-doc/changelog.html++[upstream changelog] for additional information. - -[[haskell-ghc-9-8]] -== Haskell GHC 9.8 and Stackage LTS 23 - -For Fedora 42, the main GHC Haskell compiler package have been from version link:++https://www.haskell.org/ghc/download_ghc_9_6_6.html++[9.6.6] to the latest stable link:++https://www.haskell.org/ghc/download_ghc_9_8_4.html++[9.8.4] release (rebasing the ghc package from the link:++https://src.fedoraproject.org/rpms/ghc9.8/++[ghc9.8] package). Along with this, Haskell packages in link:++https://www.stackage.org/++[Stackage] (the stable Haskell source package distribution) have been updated from the versions in link:++https://www.stackage.org/lts-22++[LTS 22] to latest link:++https://www.stackage.org/lts-23++[LTS 23] release. Haskell packages not in Stackage have been updated to the latest appropriate version in the upstream link:++https://hackage.haskell.org/++[Hackage] package repository. - -For full information about this release, see the link:++https://downloads.haskell.org/~ghc/9.8.4/docs/users_guide/9.8.4-notes.html++[upstream release notes] and link:++https://gitlab.haskell.org/ghc/ghc/-/wikis/migration/9.8++[migration guide]. - -[[hare]] -== The Hare programming language - -Fedora 43 introduces packages for Hare, a systems programming language designed to be simple, stable, and robust. -Hare uses a static type system, manual memory management, and a minimal runtime. It is well-suited to writing operating systems, system tools, compilers, networking software, and other low-level, high performance tasks. - -The Hare toolchain on Fedora includes: - -* `hare` (build driver) -* `harec` (compiler front-end, already available in Fedora) -* `qbe` (compiler back-end, already available in Fedora) -* `binutils` (for assembly and static linking) -* `gcc` (for dynamic linking, it also works with other C compilers) - -The Hare tool chain can target the `x86_64`, `aarch64`, and `riscv64` architectures, and is configured to rely by default on `gcc--linux-gnu` and `binutils--linux-gnu` for cross compilation. - -The `hare` source package includes the following: - -* `hare` (build driver, `haredoc` utility, and manuals) -* `hare-stdlib` (standard library) -* `hare-rpm-macros` (packaging utilities) - -In addition, a `hare-update` package is provided to assist Hare developers dealing with breaking changes when a new Hare release is available, until the language and its standard library become stable. - -For more information about Hare, see the link:++https://harelang.org/documentation/++[upstream documentation] and link:++https://harelang.org/specification++[specification]. A link:++https://harelang.org/tutorial++[tutorial] is also available on the official website. - -[[tbb-2022-2-0]] -== TBB2022.2.0 - -The `tbb` package contains Intel's oneAPI Threading Building Blocks, a library for breaking computations into parralel tasks. In Fedora 43, this package has been upgraded from version 2022.0.0 to version 2022.2.0. - -Due to an ABI change, non-Fedora packages that use `tbb` will likely need to be rebuilt. Version 2022.2.0 is API-compatible with version 2022.0.0, so a simple rebuild should suffice. - -For detailed information, see the link:++https://github.com/uxlfoundation/oneTBB/blob/master/RELEASE_NOTES.md++[upstream release notes for TBB 2022.1.0 and TBB 2022.2.0]. - -[[perl-5-42]] -== Perl 5.42 -Fedora 43 provides Perl 5.42.0, a new stable release that focuses on improving performance, refining existing features, and adding new experimental capabilities. - -**Core enhancements** - -* New `any` and `all` Operators: Two new experimental keywords, `any` and `all`, are introduced for more efficient list processing. They're designed to short-circuit, so they stop processing the list as soon as the result is known. They're compiled directly into the core, making them faster than their counterparts from the `List::Util` module. -* Lexical Methods: You can now declare private, lexical methods using the `my method` syntax. The new -`++>&++` operator allows you to call these methods, ensuring they're only visible within their defined scope. -* `source::encoding` Pragma: A new pragma is available to explicitly declare whether a source file is encoded in ASCII or UTF-8. This helps to catch encoding-related errors early during development. -* Expanded `CORE::` Namespace: Built-in functions like `chdir` and `rand` can now be safely used as first-class subroutine references. This gives you more flexibility when passing core functions as arguments. -* `:writer` Field Attribute: When defining classes with `use feature 'class'`, you can now use the `:writer` attribute on scalar fields to automatically generate setter accessors. - -**Reconsidered features** - -* `smartmatch` and `switch` Reinstated: The `switch` and `smartmatch (~~)` features, which were previously scheduled for removal, have been granted an indefinite reprieve. They are now available, but you must enable them with a specific feature flag. -* Apostrophe as Package Separator: The legacy use of a single apostrophe (`) as a package separator has been reinstated by default after community feedback. You can still control this behavior with a feature flag. - -** Other updates** - -* This release also includes performance improvements to the `tr///` operator, updates to Unicode 16.0 support, and various bug fixes related to locale handling, `goto`, and `eval`. - -For more detailed information, refer to the official link:++For more detailed information, refer to the official perldelta for 5.42.0 documentation. ++[perldelta for 5.42.0] documentation. - -[[maven-4]] -== Maven 4 -Maven 4 is a new major version of Maven after 15 years of Maven 3. It brings many improvements, but also breaking changes. Fedora 43 provides Maven 4 as the `maven4` package, making it installable in parallel to Maven 3. - -See the link:++https://maven.apache.org/whatsnewinmaven4.html++[What's new in Maven 4?] post and the link:++https://maven.apache.org/ref/4.0.0-rc-4/++[upstream docs] for more details. - -[[idris-2]] -== Idris 2 -Idris 2 is a dependently typed practical functional programming language, now available in Fedora 43. -It is a complete rewrite of Idris 1 (which was written in Haskell and is now deprecated) on top of a Scheme compiler. - -For details, see the link:++https://idris2.readthedocs.io/en/latest/++[upstream documentation], including a list of changes compared to Idris 1 and an Idris 2 tutorial. diff --git a/modules/release-notes/pages/sysadmin.adoc b/modules/release-notes/pages/sysadmin.adoc index ac57e97..8397121 100644 --- a/modules/release-notes/pages/sysadmin.adoc +++ b/modules/release-notes/pages/sysadmin.adoc @@ -2,140 +2,3 @@ include::partial$entities.adoc[] = Changes in Fedora {PRODVER} For System Administrators - -[[anaconda]] -== Changes in the Anaconda installer - -=== Fedora spins now use the new WebUI installer - -Fedora 42 has introduced a new, redesigned graphical installer interface using a new, browser-based WebUI, which was available on Fedora Workstation. -In Fedora 43, the same installer is now also used on Fedora KDE Edition, as well as some of the Spins. - -=== No more support for installs on MBR-partitioned disks in UEFI mode on x86 - -Starting with Fedora 43, the installer no longer supports installing Fedora on disks using a Master Boot Record (MBR) while in UEFI boot mode on 32-bit x86 systems. -Instead, the installer will enforce the use of a GUID Partition Table (GPT), which is a significantly more modern standard, and was already the default previously on some hardware configurations. -Existing 32-bit UEFI systems with MBR-partitioned disks can be upgraded like normal, only new installations are affected. - -=== Anaconda now uses DNF5 - -Fedora as a whole has switched to DNF5 in the 41 release for general package management and image building. -Starting with Fedora 43, Anaconda is now also using DNF5 on the backend. The change should not be visible to most users. - -=== Modularity support removal - -Since the Fedora Modularity project has been deprecated, supports for package modularity has now also been removed from Anaconda. -This change is related to the switch to DNF5, as DNF5 no longer supports modularity either, so this allows Anaconda to be upgraded to DNF5. - -=== Default /boot partition is now 2G - -Fedora Linux 43 has raised the size of the default `/boot` partition to 2 GiB. -This is to accommodate increases in boot data over the past several releases and to maintain a usable experience. -Users of older releases may be advised to consider reinstalling instead of upgrading to increase the `/boot` partition size. - -== Automatic updates by default on Fedora Kinoite - -Updates to both the system and all Flatpaks on Fedora Kinoite are now downloaded automatically and applied on the next reboot. -The change applies to all systems, whether newly installed or updated to Fedora 43, unless the autoupdate setting has been changed before. - -You can change the frequency of automatic updates (or disable them completely, though this is not recommended) in system settings, under the **Software Updates** tab. - -[[stratis]] -== Stratis 3.8.5: stratisd 3.8.5 and stratis-cli 3.8.2 - -Stratis 3.8.5, which consists of `stratisd 3.8.5` and `stratis-cli 3.8.2` includes -a number of significant enhancements and modifications. - -=== stratisd - -For `stratisd`, the release makes improvements to the Stratis support for mounting -filesystems at boot. It introduces a new systemd unit file, -`stratis-fstab-setup-with-network@.service`, which should be used when a filesystem's pool -requires unlocking with the network present, as is the case when a pool is encrypted using -NBDE (network-bound disk encryption). The fstab entry for the filesystem must include the -`_netdev` option if this systemd unit file is used. - -If the `stratis-fstab-setup-with-network@service` unit is used and the `_netdev` option is -omitted in the same fstab entry, systemd will calculate a cyclic dependency, -and the boot process will fail. - -An example fstab entry for a filesystem on a pool that is encrypted using NBDE should look -something like this: - -[,console] ----- -/dev/stratis// xfs defaults,_netdev,x-systemd.requires=stratis-fstab-setup-with-network@.service 0 2 ----- - -If a filesystem's pool does not require that the network is up to be unlocked then the fstab -entry may use the existing `stratis-fstab-setup@.service` unit instead. - -Additionally `stratisd` takes responsibility for maintaining the key used to encrypt a Stratis -pool, so that it is guaranteed to be present in the kernel keyring if an automatic pool maintenance -action needs to be performed on an encrypted pool. `stratisd` updates the new `VolumeKeyLoaded` -D-Bus property on the affected pool with an error message if the key is not loaded. - -`stratisd` also exposes additional information about stopped pools in the StoppedPools property. - -=== stratis-cli - -For `stratis-cli`, the release fixes a bug where a user would be unable to start an -encrypted pool previously created with any Stratis release less than 3.8.0. - -`stratis-cli` also exposes more information about a stopped pool in its detail view. - -[[postgresql-18]] -== PostgreSQL 18 -PostgreSQL in Fedora 43 (the `postgresql` and `libpq` components) has been upgraded to major version 18. This continues the versioned packaging structure introduced in Fedora 40. - -See the link:++https://www.postgresql.org/docs/18/release-18.html++[upstream release notes] for more information and notes on migration. - -[[read-only-bdb-in-389-ds]] -== Read-only BDB support in 389 Directory Server -Starting from 389-ds-base version 3.1.3, the 389 Directory Server no longer supports the deprecated BerkeleyDB, so the LDMB database must be used. Users still using BerkeleyDB will have to migrate their data. In Fedora this change is available starting from Fedora 43 (Version 3.2.0 that was also originally planned for Fedora 43 is delayed.) - -Directory server instances created since Fedora 40 and using the default LMDB database are not impacted (that is typically the case for FreeIPA users). -However, users still using BerkeleyDB (either because they have not yet migrated or because they explicitly choose to use BerkeleyDB) are required to migrate to LMDB. - -If this step is not done, the instance will not be able to start after the upgrade, and the following error message is displayed in the dirsrv error log and in the system journal: - -[,console] ----- -bdb implementation is no longer supported. Directory server cannot be started without migrating to lmdb first. To migrate, please run: dsctl instanceName dblib bdb2mdb ----- - -Users then need to migrate the data either using the `dsctl` command, or manually by following the steps in the link:++https://www.port389.org/docs/389ds/FAQ/Berkeley-DB-deprecation.html#manual-method---export-to-ldif++[upstream FAQ]. - -[[dovecot-2-4]] -== Dovecot 2.4 -The Dovecot e-mails server has been updated to version 2.4 in Fedora 43. This is the latest major update, released after 7 years of development. - -Note that Dovecot 2.4 configuration is not totally compatible with the previous version (2.3). See the link:++https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html++[Upgrading Dovecot CE from 2.3 to 2.4] document upstream. - -For more information about this release, see the link:++https://github.com/dovecot/core/releases/tag/2.4.0++[upstream release notes]. - -[[mysql-8-4]] -== MySQL 8.4 as default -MySQL 8.4 is now the default version of MySQL in Fedora. - -Those who wish to continue using the previous default version, MySQL 8.0, can use the `mysql-8.0-server` package. - -For information about the latest releases, see the following links: - -* link:++https://dev.mysql.com/doc/relnotes/mysql/8.1/en/++[8.1 release notes] -* link:++https://dev.mysql.com/doc/relnotes/mysql/8.2/en/++[8.2 release notes] -* link:++https://dev.mysql.com/doc/relnotes/mysql/8.3/en/++[8.3 release notes] -* link:++https://dev.mysql.com/doc/relnotes/mysql/8.4/en/++[8.4 release notes] - -[[rpm-6]] -== RPM 6.0 -Fedora 43 updates the RPM packaging system to version 6.0. This release provides several security improvements, such as: - -* OpenPGP keys are referred to by their fingerprint or full key id where fingerprint not available (compared to the short keyid in previous versions). -* OpenPGP keys can be updated with `rpmkeys --import ` and corresponding API(s). -* Support for multiple signatures per package. -* Support for automatic signing on package build (mainly for local use). -* Support for OpenPGP v6 keys and signatures (including PQC). -* Support for signing with Sequoia-sq as an alternative to GnuPG. - -For full information about this release, see the link:++https://rpm.org/wiki/Releases/6.0.0++[upstream release notes]. The link:++https://github.com/rpm-software-management/rpm/discussions/3602++[Road to RPM 6.0] post also provides details in a more easily digestible format. diff --git a/modules/release-notes/partials/entities.adoc b/modules/release-notes/partials/entities.adoc index c28c88c..7c51e16 100644 --- a/modules/release-notes/partials/entities.adoc +++ b/modules/release-notes/partials/entities.adoc @@ -1,9 +1,9 @@ :BOOKID: release-notes :BZURL: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes/-/issues // Change this to the latest version -:COMMONBUGS_URL: https://discussion.fedoraproject.org/tags/c/ask/common-issues/82/all/f43 +:COMMONBUGS_URL: https://discussion.fedoraproject.org/tags/c/ask/common-issues/82/all/f40 :HOLDER: Fedora Project Contributors -:PREVVER: 42 +:PREVVER: 39 :PRODUCT: Fedora Documentation -:PRODVER: 43 -:YEAR: 2025 +:PRODVER: rawhide +:YEAR: 2024 diff --git a/site.yml b/site.yml index f67a1f7..9049892 100644 --- a/site.yml +++ b/site.yml @@ -6,7 +6,7 @@ content: - url: . branches: HEAD - url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home.git - branches: f43 + branches: main ui: bundle: url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable From 5240880e50916c1d4c7418387f0449b8b98424e9 Mon Sep 17 00:00:00 2001 From: philipmgrant Date: Wed, 26 Nov 2025 10:56:32 +0000 Subject: [PATCH 80/85] Edit hardware_overview.adoc: update minimum graphical installer requirement to 1024x768 as discussed with Anaconda team --- modules/release-notes/pages/hardware_overview.adoc | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/modules/release-notes/pages/hardware_overview.adoc b/modules/release-notes/pages/hardware_overview.adoc index 71d3ddb..5fc3da7 100644 --- a/modules/release-notes/pages/hardware_overview.adoc +++ b/modules/release-notes/pages/hardware_overview.adoc @@ -46,15 +46,9 @@ For best results on systems with less than 1GB of memory, use the DVD installati [[hardware_overview-resolution]] == Display resolution -VGA capable of 1024x768 screen resolution - -.Graphical Installation requires 800x600 resolution or higher -[NOTE] -==== -Graphical installation of Fedora requires a minimum screen resolution of 800x600. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation. +Graphical installation of Fedora requires a minimum screen resolution of **1024x768**. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation. Once installed, Fedora will support these lower resolution devices. The minimum resolution requirement applies only to graphical installation. -==== [[hardware_overview-graphics]] == Graphics Hardware From 8d8f8a421e9ae0d7c9c78ae13c4db0c25e8677ef Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Wed, 4 Mar 2026 19:57:23 +0100 Subject: [PATCH 81/85] Add up to date links and info to Welcome page --- modules/release-notes/pages/welcome.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/modules/release-notes/pages/welcome.adoc b/modules/release-notes/pages/welcome.adoc index f6ff32f..7b4b4d1 100644 --- a/modules/release-notes/pages/welcome.adoc +++ b/modules/release-notes/pages/welcome.adoc @@ -13,26 +13,26 @@ The Fedora Project's mission is to lead the advancement of free and open source * The Fedora Project succeeds through shared action on the part of many people throughout our community. -To find out more general information about Fedora, refer to the following pages, on the Fedora Project Wiki: +To find out more general information about Fedora, refer to the following pages: -* link:++https://fedoraproject.org/wiki/Overview++[Fedora Overview] +* link:++https://docs.fedoraproject.org/en-US/project/++[Fedora’s Mission and Foundations] * link:++https://fedoraproject.org/wiki/FAQ++[Fedora FAQ] -* link:++https://fedoraproject.org/wiki/Communicate++[Help and Discussions] +* link:++https://docs.fedoraproject.org/en-US/project/communications/++[Communication in Fedora] -* link:++https://fedoraproject.org/wiki/Join++[Participate in the Fedora Project] +* link:++https://docs.fedoraproject.org/en-US/project/join/++[Get Involved in Fedora] [[sect-need-help]] == Need Help? There are a number of places you can get assistance should you run into problems. -If you run into a problem and would like some assistance, go to link:++https://ask.fedoraproject.org++[]. Many answers are already there, but if you don't find yours, you can simply post a new question. This has the advantage that anyone else with the same problem can find the answer, too. +If you run into a problem and would like some assistance, go to link:++https://discussion.fedoraproject.org/c/ask/6++[Ask Fedora]. Many answers are already there, but if you don't find yours, you can simply post a new question. This has the advantage that anyone else with the same problem can find the answer, too. -You may also find assistance on the `#fedora` channel on the IRC network `irc.libera.chat`. Keep in mind that the channel is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available. +You may also find assistance in the `#fedora` room on link:++https://chat.fedoraproject.org/++[Fedora's Matrix instance]. Keep in mind that the room is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available. [[sect-providing-help]] == Want to Contribute? -You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++https://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests] on the Fedora Wiki for more information about bug and feature reporting. Thank you for your participation. +You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++https://docs.fedoraproject.org/en-US/quick-docs/bugzilla-file-a-bug/++[How to file a bug] for more information about bug and feature reporting. Thank you for your participation. From f4b3c6f0bdbd6691c9a34013a686c93772850f22 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Wed, 1 Apr 2026 20:01:18 +0200 Subject: [PATCH 82/85] Update the Change issue template for Forgejo --- .forgejo/issue_template/change.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 .forgejo/issue_template/change.md diff --git a/.forgejo/issue_template/change.md b/.forgejo/issue_template/change.md new file mode 100644 index 0000000..17503db --- /dev/null +++ b/.forgejo/issue_template/change.md @@ -0,0 +1,27 @@ +This issue tracks the release note for the following Fedora Change: + +!!!!LINK TO WIKI HERE!!!! + +**If you own this change**, please add additional information here that we should communicate to Fedora users. Specifically, please consider: + +* New features available because of this change - pick those that are important to end users +* Considerations for users of previous releases of Fedora (upgrade issues, format changes, etc.) +* Links to any upstream Release Notes +* If this helps Fedora be a superior environment for our target audiences, please explain how so that we can emphasize this. + +Your notes to us do not need to be formally written - we will edit them and add details if needed. This is a way for you to ensure that we know what is critical about your change. + +**If you want to write this release note**, then: + +* Assign this issue to yourself +* Check the wiki page linked above, find out what the change is about +* Determine whether the change actually made it into the release or not[0] +* Write a draft release note using that information against the correct branch here, in Gitlab. (or see below) +* Get in touch with the contact person/people listed on the wiki page, either through IRC/Matrix or e-mail or just by @-mentioning them in a comment here, and ask them to check your draft for technical accuracy +* Submit your Release Note as a PR to this repository. + +Once you're done with the above, make sure to either commit the relnote to an appropriate section of the Release Notes, or, if you're not familiar with Git, AsciiDoc, or whatever else, just add it to this issue as a comment and let the team[1] know that you're done with this one and you'd like the note included. Be sure to do this at least one day before the final release (see current schedule[2]). Also make sure to do this even for relnotes that haven't been checked by the change owner. + +[0] You can do that by asking the change owner listed on the wiki page; alternatively you can infer it by checking the tracker bug (linked in Wiki) in Bugzilla and looking at its status; see bug comments for details. Ask someone on Matrix if you're not sure. +[1] On Matrix in the Fedora Documentation channel - see https://docs.fedoraproject.org/en-US/project/communications/. +[2] Schedules are all here: https://fedorapeople.org/groups/schedule/ - make sure to pick the correct release. From a9646e3638399413c6dcf724c3be42a7d470bd15 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Wed, 1 Apr 2026 20:06:39 +0200 Subject: [PATCH 83/85] Remove gitlab references & update change template --- .forgejo/issue_template/change.md | 6 ++++++ .gitlab/issue_templates/Change.md | 27 --------------------------- README.md | 22 +++++++++++----------- 3 files changed, 17 insertions(+), 38 deletions(-) delete mode 100644 .gitlab/issue_templates/Change.md diff --git a/.forgejo/issue_template/change.md b/.forgejo/issue_template/change.md index 17503db..fad13b3 100644 --- a/.forgejo/issue_template/change.md +++ b/.forgejo/issue_template/change.md @@ -1,3 +1,9 @@ +--- +name: Change template +about: Use this template to open an issue for a Fedora Change +title: "Change: " +--- + This issue tracks the release note for the following Fedora Change: !!!!LINK TO WIKI HERE!!!! diff --git a/.gitlab/issue_templates/Change.md b/.gitlab/issue_templates/Change.md deleted file mode 100644 index 17503db..0000000 --- a/.gitlab/issue_templates/Change.md +++ /dev/null @@ -1,27 +0,0 @@ -This issue tracks the release note for the following Fedora Change: - -!!!!LINK TO WIKI HERE!!!! - -**If you own this change**, please add additional information here that we should communicate to Fedora users. Specifically, please consider: - -* New features available because of this change - pick those that are important to end users -* Considerations for users of previous releases of Fedora (upgrade issues, format changes, etc.) -* Links to any upstream Release Notes -* If this helps Fedora be a superior environment for our target audiences, please explain how so that we can emphasize this. - -Your notes to us do not need to be formally written - we will edit them and add details if needed. This is a way for you to ensure that we know what is critical about your change. - -**If you want to write this release note**, then: - -* Assign this issue to yourself -* Check the wiki page linked above, find out what the change is about -* Determine whether the change actually made it into the release or not[0] -* Write a draft release note using that information against the correct branch here, in Gitlab. (or see below) -* Get in touch with the contact person/people listed on the wiki page, either through IRC/Matrix or e-mail or just by @-mentioning them in a comment here, and ask them to check your draft for technical accuracy -* Submit your Release Note as a PR to this repository. - -Once you're done with the above, make sure to either commit the relnote to an appropriate section of the Release Notes, or, if you're not familiar with Git, AsciiDoc, or whatever else, just add it to this issue as a comment and let the team[1] know that you're done with this one and you'd like the note included. Be sure to do this at least one day before the final release (see current schedule[2]). Also make sure to do this even for relnotes that haven't been checked by the change owner. - -[0] You can do that by asking the change owner listed on the wiki page; alternatively you can infer it by checking the tracker bug (linked in Wiki) in Bugzilla and looking at its status; see bug comments for details. Ask someone on Matrix if you're not sure. -[1] On Matrix in the Fedora Documentation channel - see https://docs.fedoraproject.org/en-US/project/communications/. -[2] Schedules are all here: https://fedorapeople.org/groups/schedule/ - make sure to pick the correct release. diff --git a/README.md b/README.md index 7b77c19..ab1ffaf 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,12 @@ # Fedora Release Notes Please report Issues and submit Pull Requests for **Content Fixes** here. -Never done a pull request (or "PR")? Here's the [Gitlab documentation for -Pull Requests](https://docs.gitlab.com/ee/user/project/merge_requests/creating_merge_requests.html). +Don't know how this works? See our +link:++https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/contrib-release-notes/++[contributor documentation]. General appearance issues and publishing issues should be reported against -the [publishing software](https://gitlab.com/fedora/docs/docs-website/docs-fp-o). +the [publishing software](https://forge.fedoraproject.org/docs/docs-fp-o). ## Structure @@ -51,7 +51,7 @@ Antora introduces two new terms: This repo includes scripts to build and preview the contents of this repository. -**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://gitlab.com/fedora/docs/docs-website/docs-fp-o) for instructions. +**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://forge.fedoraproject.org/docs/docs-fp-o) for instructions. Both scripts work on Fedora (using Podman) and macOS (using Docker). @@ -76,13 +76,13 @@ $ sudo dnf install podman You can also build the whole Fedora Docs site locally to see your changes in the whole context. This is especially useful for checking if your `xref` links work properly. -To do this, you need to clone the main [Fedora Docs build repository](https://gitlab.com/fedora/docs/docs-website/docs-fp-o), modify the `site.yml` file to reference a repo with your changes, and build it. +To do this, you need to clone the main [Fedora Docs build repository](https://forge.fedoraproject.org/docs/docs-fp-o), modify the `site.yml` file to reference a repo with your changes, and build it. Steps: Clone the main repository and cd into it, then checkout the `prod` branch: ``` -$ git clone https://gitlab.com/fedora/docs/docs-website/docs-fp-o.git +$ git clone https://forge.fedoraproject.org/docs/docs-fp-o.git $ cd docs-fp-o $ git checkout prod ``` @@ -92,18 +92,18 @@ So for example, if I made a modification to the Modularity docs, I would find: ``` ... - - url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes.git + - url: https://forge.fedoraproject.org/docs/docs-fp-o.git branches: - - master + - main ... ``` And replaced it with a pointer to my fork: ``` ... - - url: https://gitlab.com/AdamWill/release-notes.git + - url: https://forge.fedoraproject.org/pbokoc/docs-fp-o branches: - - master + - main ... ``` @@ -123,5 +123,5 @@ So I would need to create a `repositories` directory in `docs-fp-o` and copy my To build the whole site, I would run the following in the `docs-fp-o` directory. ``` -$ ./build.sh && ./preview.sh +$ ./docsbuilder.sh ``` From 30aed9be20d384f4b9e3168f77f666f925ca33e6 Mon Sep 17 00:00:00 2001 From: Petr Bokoc Date: Wed, 1 Apr 2026 20:07:39 +0200 Subject: [PATCH 84/85] README is in Markdown, not ADoc --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index ab1ffaf..2382e0a 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,7 @@ # Fedora Release Notes Please report Issues and submit Pull Requests for **Content Fixes** here. -Don't know how this works? See our -link:++https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/contrib-release-notes/++[contributor documentation]. +Don't know how this works? See our [contributor documentation](https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/contrib-release-notes/). General appearance issues and publishing issues should be reported against From 63cbfe6ac5346b6e7606f02c9d62f3fca71e8b3c Mon Sep 17 00:00:00 2001 From: jonashub Date: Thu, 4 Jun 2026 11:38:21 +0000 Subject: [PATCH 85/85] Shorten README (#402) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I've shortened this README based on what we came up with in this issue: https://forge.fedoraproject.org/docs/tickets/issues/36 Reviewed-on: https://forge.fedoraproject.org/docs/release-notes/pulls/402 Reviewed-by: Petr Bokoč --- README.md | 137 ++++++++---------------------------------------------- 1 file changed, 20 insertions(+), 117 deletions(-) diff --git a/README.md b/README.md index 2382e0a..bac9ac0 100644 --- a/README.md +++ b/README.md @@ -1,126 +1,29 @@ -# Fedora Release Notes +# Fedora Release Notes Documentation -Please report Issues and submit Pull Requests for **Content Fixes** here. -Don't know how this works? See our [contributor documentation](https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/contrib-release-notes/). +Release Notes document the most important changes and new features in each Fedora Linux release. +## Published documentation -General appearance issues and publishing issues should be reported against -the [publishing software](https://forge.fedoraproject.org/docs/docs-fp-o). +The published version of this documentation is available at: +[https://docs.fedoraproject.org/en-US/fedora/latest/release-notes/](https://docs.fedoraproject.org/en-US/fedora/latest/release-notes/) -## Structure +## Contributing -``` -|-- README.md -|-- antora.yml ....................... 1. -|-- build.sh ......................... 2. -|-- preview.sh ....................... 3. -|-- site.yml ......................... 4. -`-- modules - `-- ROOT ......................... 5. - |-- assets - | `-- images ............... 6. - | `-- pizza.png - |-- nav.adoc ................. 7. - `-- pages .................... 8. - |-- architecture.adoc - |-- community.adoc - |-- faq.adoc - |-- index.adoc - |-- pizza-dough.adoc - `-- pizza-oven.adoc -``` +We welcome contributions! Whether it's fixing a typo, reporting an outdated +page, or writing new content — every little bit helps. -1. Metadata definition. -2. A script that does a local build. Uses docker. -3. A script that shows a preview of the site in a web browser by running a local web server. Uses docker. -4. A definition file for the build script. -5. A "root module of this documentation component". Please read below for an explanation. -6. **Images** to be used on any page. -7. **Menu definition.** Also defines the hierarchy of all the pages. -8. **Pages with the actual content.** They can be also organised into subdirectories if desired. +> **Note:** This is a versioned repository — there is a separate branch for each +> Fedora release. Pull requests should generally go to these release-specific branches. +> Branch `main` is only used as a template from which each new version is branched. -## Components and Modules +See the [Fedora Docs Contributor Guide](https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/) +for how to get started. -Antora introduces two new terms: +Please report **content issues** in this repository. +For general site/publishing issues, use the +[Fedora Docs Website repository](https://forge.fedoraproject.org/docs/docs-fp-o). -* **Component** — Simply put, a component is a part of the documentation website with its own menu. Components can also be versioned. In the Fedora Docs, we use separate components for user documentation, the Fedora Poject, Fedora council, Mindshare, FESCO, but also subprojects such as CommOps or Modulartity. -* **Module** — A component can be broken down into multiple modules. Modules still share a single menu on the site, but their sources can be stored in different git repositories, even owned by different groups. The default module is called "ROOT" (that's what is in this example). If you don't want to use multiple modules, only use "ROOT". But to define more modules, simply duplicate the "ROOT" directory and name it anything you want. You can store modules in one or more git repositories. - -## Local preview - -This repo includes scripts to build and preview the contents of this repository. - -**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://forge.fedoraproject.org/docs/docs-fp-o) for instructions. - -Both scripts work on Fedora (using Podman) and macOS (using Docker). - -To build and preview the site, run: - -``` -$ ./build.sh && ./preview.sh -``` - -The result will be available at http://localhost:8080 - -### Installing Podman on Fedora - -Fedora Workstation doesn't come with Podman preinstalled by default — so you might need to install it using the following command: - -``` -$ sudo dnf install podman -``` - -### Preview as a part of the whole Fedora Docs site - -You can also build the whole Fedora Docs site locally to see your changes in the whole context. -This is especially useful for checking if your `xref` links work properly. - -To do this, you need to clone the main [Fedora Docs build repository](https://forge.fedoraproject.org/docs/docs-fp-o), modify the `site.yml` file to reference a repo with your changes, and build it. -Steps: - -Clone the main repository and cd into it, then checkout the `prod` branch: - -``` -$ git clone https://forge.fedoraproject.org/docs/docs-fp-o.git -$ cd docs-fp-o -$ git checkout prod -``` - -Find a reference to the repository you're changing in the `site.yml` file, and change it so it points to your change. -So for example, if I made a modification to the Modularity docs, I would find: - -``` -... - - url: https://forge.fedoraproject.org/docs/docs-fp-o.git - branches: - - main -... -``` - -And replaced it with a pointer to my fork: -``` -... - - url: https://forge.fedoraproject.org/pbokoc/docs-fp-o - branches: - - main -... -``` - -I could also point to a local repository, using `HEAD` as a branch to preview the what's changed without the need of making a commit. - -**Note:** I would need to move the repository under the `docs-fp-o` directory, because the builder won't see anything above. -So I would need to create a `repositories` directory in `docs-fp-o` and copy my repository into it. - -``` -... - - url: ./repositories/modularity - branches: - - HEAD -... -``` - -To build the whole site, I would run the following in the `docs-fp-o` directory. - -``` -$ ./docsbuilder.sh -``` +## Contact +- **Matrix:** [#docs:fedoraproject.org](https://matrix.to/#/#docs:fedoraproject.org) +- **Private comms:** Use our FAS emails for anything that shouldn't be public. +- **Discussion forums:** [discussion.fedoraproject.org](https://discussion.fedoraproject.org/tag/docs-team/337) \ No newline at end of file