From 1d4738d24aaec8acaf5a90bb935f3dd2daba8c9d Mon Sep 17 00:00:00 2001 From: Denis 'GNUtoo' Carikli Date: Mon, 11 Nov 2024 22:07:49 +0100 Subject: [PATCH] website: docs: grub: review and add GNU Boot context. Signed-off-by: Denis 'GNUtoo' Carikli Acked-by: Adrien Bourmault --- website/pages/docs/grub/index.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/website/pages/docs/grub/index.md b/website/pages/docs/grub/index.md index 08b61ab..de00450 100644 --- a/website/pages/docs/grub/index.md +++ b/website/pages/docs/grub/index.md @@ -1,17 +1,16 @@ --- title: GRUB payload -x-unreviewed: true ... TODO: this guide should be reviewed and updated. Some info might be out of date. [GNU GRUB](https://www.gnu.org/software/grub/) already has excellent -documentation, but there are aspects of Libreboot that deserve special -treatment. Libreboot provides the option to boot GNU GRUB directly, running on +documentation, but there are aspects of GNU Boot that deserve special +treatment. GNU Boot provides the option to boot GNU GRUB directly, running on bare metal (instead of using BIOS or UEFI services). -[The GNU+Linux section](../gnulinux/) also has Libreboot-specific guides for +[The GNU+Linux section](../gnulinux/) also has GNU Boot specific guides for dealing with GNU+Linux distributions when using GNU GRUB directly, in this setup. [A similar section exists for BSD operating systems](../bsd/) @@ -33,17 +32,17 @@ files: When you build GRUB from source, you can use the `grub-mklayout` program to create a special keymap file for GRUB. [Learn how to build GRUB](../build/) -When you've built GRUB, using `lbmk` (libreboot build system), take your kepmap -file (generated by ckbcomp) and run it through `grub-mklayout` like so: +When you've built GRUB, using GNU Boot, take your kepmap file (generated by +ckbcomp) and run it through `grub-mklayout` like so: cat frazerty | ./grub/grub-mklayout -o frazerty.gkb Place the newly created `.gkb` file under `resources/grub/keymap` in lbmk. When -you build Libreboot, a ROM image with GRUB payload and your newly created +you build GNU Boot, an image with GRUB payload and your newly created keymap will be available under the `bin/` directory. -[Learn how to build Libreboot ROM images](../build/) +[Learn how to build GNU Boot images](../build/) -Many keymaps exist in the Libreboot build system, but sometimes you must +Many keymaps exist in the GNU Boot build system, but sometimes you must manually tweak the file created by `ckbcomp`, adjusting the scan codes in that file, before converting to a GRUB keymap file. Therefore, it would be unwise to automatically add all keymaps in GRUB.