diff --git a/nixos/modules/system/boot/loader/grub/grub.nix b/nixos/modules/system/boot/loader/grub/grub.nix index e47afd061e2b..b73eefd39e32 100644 --- a/nixos/modules/system/boot/loader/grub/grub.nix +++ b/nixos/modules/system/boot/loader/grub/grub.nix @@ -365,22 +365,22 @@ in Whether to invoke grub-install with --removable. - Unless turn this on, GRUB will install itself somewhere (exactly - where depends on other config variables) in - boot.loader.efi.efiSysMountPoint. If you've set + Unless you turn this on, GRUB will install itself somewhere in + boot.loader.efi.efiSysMountPoint (exactly where + depends on other config variables). If you've set boot.loader.efi.canTouchEfiVariables *AND* you are currently booted in UEFI mode, then GRUB will use - efibootmgr to modify the boot order in the NVRAM's - EFI variables of your computer to include this location. If you are - *not* booted in UEFI mode at the time grub is being installed, the + efibootmgr to modify the boot order in the + EFI variables of your firmware to include this location. If you are + *not* booted in UEFI mode at the time GRUB is being installed, the NVRAM will not be modified, and your system will not find GRUB at - boot time. GRUB will still succeed (althgouh you'll see a warning - printed "efibootmgr: EFI variables are not supported on - this system."). + boot time. However, GRUB will still return success so you may miss + the warning that gets printed ("efibootmgr: EFI variables + are not supported on this system."). - If you do turn this feature on, then GRUB will install itself - in a specific special location within efiSysMountPoint - (namely EFI/boot/boot$arch.efi) which is the firmwares + If you turn this feature on, GRUB will install itself in a special + location within efiSysMountPoint (namely + EFI/boot/boot$arch.efi) which the firmwares are hardcoded to try first, regardless of NVRAM EFI variables. To summarize, turn this on if: @@ -389,7 +389,7 @@ in but you are currently booted in legacy mode You want to make a drive that will boot regardless of the NVRAM state of the computer (like a USB "removable" drive) - You simply dislike the idea of depending on some NVRAM + You simply dislike the idea of depending on NVRAM state to make your drive bootable '';