Bug#991627: marked as done (installation-guide: expand firmware-related documentation)
Your message dated Fri, 30 Jul 2021 19:33:29 +0000
with message-id <E1m9YG9-000Cu2email@example.com>
and subject line Bug#991627: fixed in installation-guide 20210730
has caused the Debian Bug report #991627,
regarding installation-guide: expand firmware-related documentation
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact firstname.lastname@example.org
Debian Bug Tracking System
Contact email@example.com with problems
--- Begin Message ---
X-Debbugs-Cc: firstname.lastname@example.org, email@example.com
[ RT and isenkram maintainers in the loop for information ]
This bug report is about the first part of the proposal outlined in this
other bug report:
which is trying to be a bit more helpful regarding firmware problems.
Looking at the amd64 documentation, there are several places where
firmware is mentioned:
- 2.1.5, which basically points at 2.2.
- 2.2, which pretends graphics cards should work at least minimally
(which tends not to be true), and which also points at 6.4.
- 6.4, which documents a number of things.
At first glance, I'm proposing:
- not to change 2.1.5;
- to amend 2.2, mentioning graphics cards might be problematic, and
mentioning nomodeset as a possible workaround (plus another pointer
at 6.4 right after that);
- to extend 6.4, mentioning nomodeset again (for people who haven't
seen 2.2 first), as well as an automated way to detect and install
For now, both commits are in a pu/firmware-v0 branch in the installation
I'm not very used to best practices when it comes to end-user doc in
general and to the installation-guide package in general, so I'd be
happy for other to build on those suggested changes, and amend/reword as
- There's a copy-paste for the “nomodeset” option, which I suppose
could be avoided with some include logic. This might avoid duplicate
works on the l10n front (which might be important due to the next
- This is a *possible* workaround, as I have not been able to test it
(I couldn't reproduce the black screen issue with test hardware). I
plan to have some kind of survey organized to see if people affected
by this issue can confirm.
- 6.4.1 points at `unofficial/non-free/firmware/` which have been made
to work out of the box (as much as possible) as detailed in #989863,
but “the archive (tar or zip) on a separate support” use case wasn't
tackled yet (in particular detecting graphics firmware might be
required, even if the installer didn't spot that on its own due to
using generic drivers). I don't think it makes sense to document that
separately, as we might improve this in a point release, and the
“nomodeset workaround” + “isenkram procedure” combination should be
enough to fix things up from the installed system.
- I documented in a note what happens with that “isenkram procedure”
since mentioning non-free seemed to be the bare minimum. We might
skip mentioning contrib though (see earlier note in 6.4.2; the logic
is exactly the same though — same code!).
- Documenting what isenkram-autoinstall-firmware does means we should
check what happens for each major release, to keep up with the
current implementation. Doing that once every two years doesn't seem
Cyril Brulebois (firstname.lastname@example.org) <https://debamax.com/>
D-I release manager989863 -- Release team member -- Freelance Consultant
--- End Message ---
--- Begin Message ---
Done: Cyril Brulebois <email@example.com>
We believe that the bug you reported is fixed in the latest version of
installation-guide, which is due to be installed in the Debian FTP archive.
A summary of the changes between this version and the previous one is
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to firstname.lastname@example.org,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
Cyril Brulebois <email@example.com> (supplier of updated installation-guide package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing firstname.lastname@example.org)
-----BEGIN PGP SIGNED MESSAGE-----
Date: Fri, 30 Jul 2021 20:25:02 +0200
Maintainer: Debian Install System Team <email@example.com>
Changed-By: Cyril Brulebois <firstname.lastname@example.org>
installation-guide (20210730) unstable; urgency=medium
[ Holger Wansing ]
* Remove outdated-translation mark for Japanese.
[ Cyril Brulebois ]
* Expand firmware-related documentation (Closes: #991627):
- Mention rebooting into the installed system can result in a black
screen or garbled display.
- Mention possible workarounds (nomodeset, VT switching).
- Mention an isenkram-based procedure to automatically install
firmware packages from within the installed system.
* Refresh README.
[ Updated translations ]
* Catalan by d
* Japanese by YOSHINO Yoshihito
* Chinese (simplified) by Boyuan Yang <email@example.com>
ca89ff2102bcc367926e27ba2ba18a4af755919a 2868 installation-guide_20210730.dsc
7e6486c4f2e241339da315bda6c22958ddcec8da 3750476 installation-guide_20210730.tar.xz
3ab81f02ed7e78aec149c29c3b878c5acf561a10 6017 installation-guide_20210730_source.buildinfo
31e3dcd1f178c1f9474b37aa6257edc4df2782e05f16618572ca963a84f004af 2868 installation-guide_20210730.dsc
18f663efc760cbe71e775a8a151428bec8bafaa5947c071f81a33c03c9fdda71 3750476 installation-guide_20210730.tar.xz
1cbf248e044cb66a2ada489817b72ac5149a603fe2b71d525d10e4a56a3e36e4 6017 installation-guide_20210730_source.buildinfo
187480ee15009fbb80e085bd18e86360 2868 doc optional installation-guide_20210730.dsc
c5bf7802aca7059cda61910b8015131f 3750476 doc optional installation-guide_20210730.tar.xz
ee8c2f1268115337b872292017e20868 6017 doc optional installation-guide_20210730_source.buildinfo
-----BEGIN PGP SIGNATURE-----
-----END PGP SIGNATURE-----
--- End Message ---