Skip to content

Easy outdated cheatcodes + boot help texts#501

Draft
zeha wants to merge 12 commits intomasterfrom
zeha/reviewtexts
Draft

Easy outdated cheatcodes + boot help texts#501
zeha wants to merge 12 commits intomasterfrom
zeha/reviewtexts

Conversation

@zeha
Copy link
Member

@zeha zeha commented Feb 17, 2026

I asked Claude to review cheatcodes.txt and the grub help texts. It identified some low-hanging fruits. See below for a list, and also for some things that need discussion / deeper investigation.

I do not propose to merge this as is, as some changes need a deeper review and also the alignment is all fucked.

#296

LLM-generated Summary

Review and update outdated information in grml-cheatcodes.txt and boot/grub/help/*.txt.

Each change is a separate commit with a reason in the commit message.

cheatcodes.txt changes

  • fix "Logival" typo — simple typo, LogivalLogical in the lvm boot option description
  • update HTTP URLs to HTTPS — all 4 http://grml.org and http://wiki.grml.org URLs now use HTTPS
  • replace portmap with rpcbind in services example — portmap was replaced by rpcbind in all Grml flavours (commit ac64887). The example services={espeakup,portmap,...} now uses rpcbind
  • replace reiserfs with ext4 in isofrom example — reiserfsprogs was dropped from all flavours (commit 73fb627). The isofrom= filesystem prefix example now uses ext4 instead of reiserfs
  • update mkpasswd example to use sha-512 — the -H flag is deprecated in current mkpasswd (whois package) in favor of -m, and md5 password hashes are insecure. Updated to mkpasswd -m sha-512. Also removed the (available in Grml >=2013.09) note
  • remove /dev/hd* from read-only description — the /dev/hd* device naming scheme is from the old IDE subsystem, which was removed from the Linux kernel in version 5.14

grub help changes

  • remove ieee1394 blacklist example and update firewire-core — the old ieee1394 firewire stack was removed from the kernel in 2.6.37 (2011). The "new (Juju)" firewire-core is now the only stack, so the qualifier was also dropped
  • remove ide?= kernel option — the IDE subsystem was removed from the Linux kernel in version 5.14 (2021). The ide?= parameter no longer exists
  • update outdated device names in config examples — replaced /dev/fd0 (floppy) with /dev/sdb1 and /dev/hda2 (old IDE naming) with /dev/sda2 in config.txt usage examples
  • remove home= boot optionhome= was deprecated and its handler was removed from grml-autoconfig (no match in autoconfig.functions). The option silently does nothing
  • remove /etc/init.d reference from services= descriptionservice_wrapper() in grml-autoconfig now uses systemctl directly, not init.d scripts
  • update kernel documentation path for md/RAIDDocumentation/md.txt was moved to Documentation/admin-guide/md.rst in kernel 4.10

Points for discussion

VNC notes

Lines 180 and 185 of grml-cheatcodes.txt say "[Note: Grml 2011.12+ doesn't include a VNC server.]" and "[Note: Grml 2011.12+ doesn't include a VNC client.]". However, x11vnc is listed in config/package_config/GRML_FULL, and config_vnc() in autoconfig.functions actively uses it. These notes appear to be outdated — or x11vnc was re-added at some point after 2011.12. Worth investigating whether the notes should be removed or updated, and whether vnc_connect (which uses vncviewer) actually works.

read-only boot option and modern device types

The read-only description now says /dev/sd* only. This should be investigated: does the actual implementation also cover /dev/mmcblk* (eMMC/SD cards) and /dev/nvme* (NVMe) devices? If not, it probably should, and the documentation should reflect whatever the implementation does.

wiki.grml.org tips link

The multiboot USB pen link (https://wiki.grml.org/doku.php?id=tips#multiboot_usb_pen) may not be stable long-term. It could be worth replacing this with a link to the actual tips/documentation on grml.org proper, but that would need stable, non-wiki URLs to point to first.

Right-alignment in grub help

Some of the edits in boot/grub/help/cheatcodes.txt break the right-alignment pattern that some (but not all) of the original lines followed. The file was already inconsistent in this regard. Worth deciding whether to enforce consistent alignment across the file or accept the current state.

portmap debconf entry

config/debconf/GRMLBASE still contains a portmap portmap/loopback boolean false entry (line 7). This may be dead config if portmap is no longer installed, or it may be provided by rpcbind's compatibility layer. Worth checking separately.

🤖 Generated with Claude Code

zeha and others added 12 commits February 17, 2026 11:32
Fix typo "Logival Volumes" → "Logical Volumes" in the lvm boot
option description.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
grml.org and wiki.grml.org support HTTPS. Update all plain HTTP
URLs to use HTTPS.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
portmap was replaced by rpcbind in Debian (and in all Grml flavours,
per commit ac64887). Update the example service name accordingly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
reiserfsprogs was dropped from all Grml flavours (commit 73fb627).
Use ext4 as the example filesystem for the isofrom= prefix instead,
as it is far more commonly used.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The -H flag is deprecated in current mkpasswd (from whois package)
in favor of -m. Additionally, md5 password hashes are considered
insecure; use sha-512 instead. Also remove the "available in Grml
>=2013.09" note as that version is long past.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The /dev/hd* device naming scheme is from the old IDE subsystem,
which was removed from the Linux kernel in version 5.14. All IDE
devices have been handled by libata (using /dev/sd*) for many years.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The old ieee1394 firewire stack was removed from the Linux kernel in
version 2.6.37 (2011). The "new (Juju)" firewire stack (firewire-core)
is now the only firewire stack, so drop the "new (Juju)" qualifier.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The IDE subsystem was removed from the Linux kernel in version 5.14
(2021). All IDE devices are now handled by the libata subsystem.
The ide?= kernel parameter no longer exists.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace /dev/fd0 (floppy disk) and /dev/hda2 (old IDE naming) with
current device names. Floppy drives are obsolete, and the /dev/hd*
naming scheme is from the old IDE subsystem removed in kernel 5.14.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The home= boot option was deprecated and its handler was removed
from grml-autoconfig. The option silently does nothing, so remove
it from the documentation to avoid misleading users.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
grml-autoconfig's service_wrapper() now uses systemctl, not
/etc/init.d scripts. Remove the misleading init.d path hint from
the services= boot option description.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The kernel documentation was reorganized in kernel 4.10; md.txt was
moved to Documentation/admin-guide/md.rst.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@zeha zeha changed the title Update outdated info in cheatcodes and grub help texts Easy outdated cheatcodes + boo help texts Feb 17, 2026
@zeha zeha changed the title Easy outdated cheatcodes + boo help texts Easy outdated cheatcodes + boot help texts Feb 17, 2026
@github-actions
Copy link

🐳 Docker image for this PR is available:

docker pull ghcr.io/grml/grml-live:pr-501

@github-actions
Copy link

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant