git: cd8ea66a93 - main - handbook/cutting-edge: Add more details about MAKEOBJDIRPREFIX

From: Mateusz Piotrowski <0mp_at_FreeBSD.org>
Date: Wed, 04 Oct 2023 16:56:55 UTC 
The branch main has been updated by 0mp:

URL: https://cgit.FreeBSD.org/doc/commit/?id=cd8ea66a938b444da8537088a88b3afcb948cf11

commit cd8ea66a938b444da8537088a88b3afcb948cf11
Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
AuthorDate: 2023-10-03 15:30:02 +0000
Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
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.