build(7) instructions for alternate dir should be clearer

[sd_beastie.io]

Summary

buildworld and buildkernel should be clearer about how to use alternate directories for building. Would be nice to point out to set MAKEOBJDIRPREFIX like installworld and installkernel does.

Test Plan

• igor validation
• man output

[bjk]

Update .Dd at the top of the file as well.

build.7

198

You need to keep the "The" at the start of the sentence.

202

Man page style has the new sentence start on a new line.

202

It is probably more technically correct to say that MAKEOBJDIRPREFIX is set in make's environment; just setting an unexported shell variable would be local to the shell; setting it on the make command line works for make but is treated slightly differently than inheriting it from the shell environment.
(The same discussion applies to the next chunk.)

285

Start this sentence with "The" as well.
Also, "build location" is not exactly a well-defined concept; it may be better to use more words and say that "the location of the object files generated by this build can be changed from the default..."

[sd_beastie.io]

build.7

202

I wanted to quickly remind users that the variable can be set to change the build output directory, similar to installworld and installkernel does. This acts as a quick reminder in case people are jumping straight to these sections instead of reading the whole man page. Yes RTFM is a separate discussion :) There is already text in the beginning of the man page and in the environment section that talks more in detail about all the variables.

I did change it to make variable as the rest of the text references. And changed build location to object directory.

285

See reply above.

[sd_beastie.io]

Updated based on review comments.

[wblock]

build.7

200

"directory" is redundant here.

202

.Xr make 1
variable.

288

"directory" is redundant here, too.

290

.Xr make 1
variable.

[sd_beastie.io]

Updated based on wblock's review comments

[wblock]

Looks okay to me.