Re: Bug#991969: D-I: news for Bullseye: help with firmware installation
On Sat, Aug 07, 2021 at 07:40:52AM +0200, Paul Gevers wrote:
>Hi,
>
>On 06-08-2021 21:52, Holger Wansing wrote:
>> I would like to add a paragraph to the release-notes, describing a bit the
>> new "install-firmware" mechanism via modalias, with a link to the new doc
>> in the installation-guide, for those who experience problems.
>>
>> Please find a patch attached.
>> (Additionally, I updated some links to D-I alpha and RC releases for Bullseye,
>> just for completeness. Better than keeping the old ones for Buster in this file.)
>>
>>
>> @debian-boot:
>> since there was no more comment, I'm turning this into a bugreport now.
>> We are already late before release date, and translators need time too...
>>
>> @release:
>> sorry for being late
>
>I've reordered it a bit, as the template was for a list of changes. As
>we now only have one section, let's call it a section.
>
>I have further fixed two wrongly ordered tags, used bullseye in the
>links and fixed a weird sentence in the next section.
>
>Before pushing, I hope to see comments from Justin.
I'll have a lash... I'm sure Justin can take it further though
>From 4c744fe5e3206521ceb3174eb34b5d6ea69c2eab Mon Sep 17 00:00:00 2001
>From: Holger Wansing <hwansing@mailbox.org>
>Date: Sat, 7 Aug 2021 07:31:28 +0200
>Subject: [PATCH] installing.dbk: add d-i firmware note
>
>Closes: #991969
>---
> en/installing.dbk | 43 ++++++++++++++++++++++++++++++++++---------
> 1 file changed, 34 insertions(+), 9 deletions(-)
>
>diff --git a/en/installing.dbk b/en/installing.dbk
>index 7a7e0674..10396c60 100644
>--- a/en/installing.dbk
>+++ b/en/installing.dbk
>@@ -44,21 +44,46 @@ for the &releasename; beta and RC releases available from the Debian
> Installer's <ulink url="&url-installer-news;">news history</ulink>.
> </para>
>
>-<!-- no major changes
>+<!-- no major changes -->
> <section id="inst-changes">
>+<!-- normal title
> <title>Major changes</title>
>+-->
>+<title>Help with installation of firmware</title>
>+<para>
>+ More and more, peripheral devices require firmware to be loaded as
>+ part of the hardware initialization. To help deal with this problem,
>+ the installer has been improved. Based on a hardware ID to firmware
>+ file mapping, if some of the installed hardware requires firmware
>+ files to be installed, the code installs them automatically.
>+</para>
How about
+ More and more, peripheral devices require firmware to be loaded as
+ part of the hardware initialization. To help deal with this problem,
+ the installer has a new feature. If some of the installed hardware
+ requires firmware files to be installed, the installer will try
+ to add them to the system, based on a mapping from hardware ID
+ to firmware file names.
>+</para>
>+<para>
>+ Please note, that this new functionality is restricted to the
I don't think the comma is needed. In fact why not just
+ This new functionality is restricted to the
>+ unofficial installer images with firmware included (see <ulink
>+ url="&url-installer;#firmware_nonfree">&url-installer;#firmware_nonfree</ulink>).
>+ The firmware is usually not DFSG compliant, so it is not possible to
>+ distribute it in Debian's main repository.
>+</para>
>+<para>
>+ If you experience problems related to (missing) firmware, you might
>+ want to read <ulink
+ If you experience problems related to (missing) firmware, please
+ read <ulink
>+ url="https://www.debian.org/releases/bullseye/amd64/ch06s04.en.html#completing-installed-system";>the
>+ dedicated chapter of the installation-guide</ulink>.
>+</para>
>+</section>
>
>-<!- -
>+<!-- (Disable if "no major changes" is in effect again)
> release-notes authors should check webwml repo or
> https://www.debian.org/devel/debian-installer/
>
>-Sources (for buster):
>+Sources (for bullseye):
>
>-https://www.debian.org/devel/debian-installer/News/2017/20170903
>-https://www.debian.org/devel/debian-installer/News/2017/20171206
>-https://www.debian.org/devel/debian-installer/News/2018/20180619
>-https://www.debian.org/devel/debian-installer/News/2018/20181215
>-https://www.debian.org/devel/debian-installer/News/2019/20190202
>+https://www.debian.org/devel/debian-installer/News/2019/20191205
>+https://www.debian.org/devel/debian-installer/News/2020/20200316
>+https://www.debian.org/devel/debian-installer/News/2020/20201206
>+https://www.debian.org/devel/debian-installer/News/2021/20210423
>+https://www.debian.org/devel/debian-installer/News/2021/20210614
>+https://www.debian.org/devel/debian-installer/News/2021/20210802
> - ->
>
> <!- - TODO: Add
>@@ -119,7 +144,7 @@ Marathi, Nepali, Punjabi, Tamil, Telugu, Tibetan, and Uyghur.
> <section id="inst-auto">
> <title>Automated installation</title>
> <para>
>-Some changes mentioned in the previous section also imply changes in
>+Some changes also imply changes in
> the support in the installer for automated installation using preconfiguration
> files. This means that if you have existing preconfiguration files that worked
> with the &oldreleasename; installer, you cannot expect these to work with the new
>--
>2.30.2
>
--
Reply to: