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.
Details
Details
- Reviewers
brd wblock - Group Reviewers
manpages - Commits
- rS298759: Clarify build(7) instructions for alternate object directory.
- igor validation
- man output
Diff Detail
Diff Detail
- Repository
- rS FreeBSD src repository - subversion
- Lint
Lint Not Applicable - Unit
Tests Not Applicable
Event Timeline
Comment Actions
Update .Dd at the top of the file as well.
| build.7 | ||
|---|---|---|
| 198 ↗ | (On Diff #15611) | You need to keep the "The" at the start of the sentence. |
| 202 ↗ | (On Diff #15611) | Man page style has the new sentence start on a new line. |
| 202 ↗ | (On Diff #15611) | 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. |
| 285 ↗ | (On Diff #15611) | Start this sentence with "The" as well. |
| build.7 | ||
|---|---|---|
| 202 ↗ | (On Diff #15611) | 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 ↗ | (On Diff #15611) | See reply above. |