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
'';