From cd8ea66a938b444da8537088a88b3afcb948cf11 Mon Sep 17 00:00:00 2001
From: Mateusz Piotrowski <0mp@FreeBSD.org>
Date: Tue, 3 Oct 2023 17:30:02 +0200
Subject: [PATCH] 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.
---
 .../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 07e97a396f3a..ec6f8537f61b 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.