Initial uefi(8) man page

[emaste]

add vt(4) xref

[brueffer]

share/man/man8/uefi.8

44 ↗

(On Diff #2013)

double "in"

48 ↗

(On Diff #2013)

Further down only the "file system" spelling is used, so it should be consistent here.

61 ↗

(On Diff #2013)

firmare -> firmware

82 ↗

(On Diff #2013)

laods -> loads

101 ↗

(On Diff #2013)

This should be something like the following:

[...]
for use by
.Xr bsdinstall 8
and the
.Ar bootcode
argument to
.Xr gpart 8 .

130 ↗

(On Diff #2013)

The first sort key in SEE ALSO is section, then manpage name (and no period at the end):

.Sh SEE ALSO
.Xr vt 4 ,
.Xr msdosfs 5 ,
.Xr boot 8 ,
.Xr gpart 8

[emaste]

address review feedback from brueffer

[emaste]

connect uefi.8 to the build

[emaste]

Closed by commit rS273218 (authored by @emaste).

[wblock]

textproc/igor checks for whitespace and spelling problems, among others. It is a good idea to run it on man pages and even plain text files before commit:
igor -R Makefile | less -RS
igor -R uefi.8 | less -RS

For man pages, it is also useful to run
mandoc -Tlint uefi.8

head/share/man/man8/Makefile

35

There is a bunch of trailing whitespace on this line.

head/share/man/man8/uefi.8

34

Trailing whitespace.

46

spelling: "parition"

103

Trailing whitespace.

[emaste]

head/share/man/man8/uefi.8

33

uefi.8:33:.Sh DESCRIPTION used here:but .Sh SYNOPSIS has not been defined

Presumably this can be ignored

113

Should this be renamed to BUGS (and moved to the end)?

[emaste]

address wblock comments

[emaste]

Move CAVEATS to end as suggested by mandoc -T lint

share/man/man8/uefi.8

133 ↗

(On Diff #2021)

It seems mandoc -Tlint treats CAVEATS as BUGS

[wblock]

head/share/man/man8/uefi.8

33

Yes. A typical man page has a minimum set of eight sections in order. Man pages that do not apply to ordinary commands leave out the synopsis.

113

Kind of depends on how you look at it. "Bug" says "it is present but does not work correctly" while caveats could be warnings about differences from expectations or unimplemented things.

[emaste]

head/share/man/man8/uefi.8

113

Ok - these are legitimately CAVEATS I think. I was mainly confused by mandoc -Tlint's complaint about ordering, as mdoc(7) does not describe CAVEATS, but mandoc -Tlint seems to treat it as BUGS.

[emaste]

Closed by commit rS273235 (authored by @emaste).