gptboot.efi: Add man page

[imp]

Summary

Add a man page for gptboot.efi. Describe when and how to use this as it differes
from the BIOS cases. Include cross reference for the preferred method described
in efibootmgr(8) as well as cross links in both gptboot(8) and gptboot.efi(8) to
the other.

This man page was heavily copied from the gptboot.8 man page by Warren Block.
They are different enough to need separate man pages for clarity, but there's
enough similarity that I worry about the duplication. In the really long term,
gptboot(8) will disappear, so having the same info here will help when that
day comes.

Not fixed at this time is the need to document boot1.efi and to overhaul
loader.8 to fold in changes from the last several years.

[rpokala]

stand/efi/gptboot/gptboot.efi.8

43

For BIOS-based computers,
.Xr gpart 8
is used instead.

BIOS-based systems use
.Xr gptboot 8
instead, which is installed with
.Xr gpart 8 .

50

When what is booted ...

71

BIOS so the next bootable item in the UEFI's Boot Manager's

firmware, so the next bootable item in the UEFIs Boot Manager's

72

list.

list is tried.

[pstef]

stand/efi/gptboot/gptboot.efi.8

50

I have trouble parsing this.

[crees]

A couple of suggestions inline.

stand/efi/gptboot/gptboot.efi.8

71

I wonder if you should put a comma here, or rewrite.

If it does not find an eligible partition, control is returned to the UEFI BIOS, so the next bootable item (...) list is tried.

278

Is that an alias? :)

[imp]

Add better hints to look elsewhere and fix a typo.

[crees]

With due attention to @rpokola 's comment above, great.

stand/efi/gptboot/gptboot.efi.8

71

Sorry, last one- I think rpakola's suggestion of s,BIOS,firmware, was right here as well.

[imp]

updating coming, mark everything as done since I think the next update addresses these items.

[imp]

Rewrite text that was unclear based on feedback from reviewers.

[imp]

minor copyright tweak due to all rights reserved being ambiguous otherwise.

[imp]

start to crossref boot1.efi. loader.efi is still hopeless.

[mhorne]

This is excellent. If duplication is a concern, maybe PARTITION ATTRIBUTES could just be a pointer to gptboot.8.

stand/efi/gptboot/gptboot.efi.8

53

You might make mechanism plural, as in the previous sentence.

226

227

[rpokala]

stand/efi/gptboot/gptboot.efi.8

61

When what boots cannot depend on host-supplied UEFI variables, or
when bugs in the UEFI implementation prevent that,
.Nm
is used to bridge the gap.

Perhaps:

When deciding what to boot cannot depend on host-supplied UEFI variables,
or when bugs in the UEFI implementation prevent that,
.Nm
is used to bridge the gap.

71

"firmware"

[imp]

stand/efi/gptboot/gptboot.efi.8

227

So this is now official? Cool.

[imp]

Changes from mhorne.

[imp]

More from Ravi and move definition of ESP earlier to first use.

[imp]

stand/efi/gptboot/gptboot.efi.8

61

reworded a little differently to avoid the maybe too informal / idiomatic 'bridge the gap'.

[rpokala]

stand/efi/gptboot/gptboot.efi.8

38–62

Usually the expanded version comes first, then the initialization:

is installed in the EFI System Partition (ESP).

59

s/reply/rely/

[imp]

more nits from rpokala

[rpokala]

stand/efi/gptboot/gptboot.efi.8

268–271

gpart isn't used for UEFI, so you can drop that. But I'd add

.Xr gptboot 8

and

.Xr loader.efi 8

(vestigial though the latter may be at the moment).

stand/i386/gptboot/gptboot.8

43

.Xr gpart.efi 8

.Xr gptboot.efi 8

[imp]

stand/efi/gptboot/gptboot.efi.8

268–271

gpart is used with UEFI to mark partitions as bootme or bootonce.

[imp]

update for latest feedback from rpokala