git: cd8ea66a93 - main - handbook/cutting-edge: Add more details about MAKEOBJDIRPREFIX
Mateusz Piotrowski <[email protected]>
| Newsgroups | gmane.os.freebsd.devel.cvs.doc |
|---|---|
| Message-ID | <[email protected]> |
The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/doc/commit/?id=cd8ea66a938b444da8537088a88b3afcb948cf11 commit cd8ea66a938b444da8537088a88b3afcb948cf11 Author: Mateusz Piotrowski <[email protected]> AuthorDate: 2023-10-03 15:30:02 +0000 Commit: Mateusz Piotrowski <[email protected]> CommitDate: 2023-10-04 16:54:28 +0000 handbook/cutting-edge: Add more details about MAKEOBJDIRPREFIX Previously, the handbook suggested /tmp for MAKEOBJDIRPREFIX. This was fine, but suggesting /tmp/obj instead is even better as build artifacts will not mix with other files in /tmp. Also note that MAKEOBJDIRPREFIX must exist. Sponsored by: Klara, Inc. --- documentation/content/en/books/handbook/cutting-edge/_index.adoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc index 07e97a396f..ec6f8537f6 100644 --- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc +++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc @@ -1179,10 +1179,11 @@ For example, the following `tools/build/make.py` invocation builds the world: [source,shell] .... -MAKEOBJDIRPREFIX=/tmp tools/build/make.py -j 8 TARGET=arm64 TARGET_ARCH=aarch64 buildworld +MAKEOBJDIRPREFIX=/tmp/obj tools/build/make.py -j 8 TARGET=arm64 TARGET_ARCH=aarch64 buildworld .... -It builds the world for target `aarch64:arm64` on 8 CPUs and uses [.filename]#/tmp# for object files. +It builds the world for target `aarch64:arm64` on 8 CPUs and uses [.filename]#/tmp/obj# for object files. Note that the variables `MAKEOBJDIRPREFIX`, `TARGET`, and `TARGET_ARCH` are mandatory when building on non-FreeBSD hosts. +Also, make sure to create the object directory pointed to by the `MAKEOBJDIRPREFIX` environment variable. Refer to man:arch[7] and man:build[7] for more details.