Module Name: src
Committed By: sjg
Date: Thu Nov 14 19:30:13 UTC 2024
Modified Files:
src/usr.bin/make: make.1
Log Message:
make.1 clarify use of MAKEOBJDIRPREFIX
Note that MAKEOBJDIRPREFIX should be an absolute path.
Also that MAKEOBJDIRPREFIX and MAKEOBJDIR *can* be set
via makefile variables, but that care is needed to avoid
unwanted side effects.
To generate a diff of this commit:
cvs rdiff -u -r1.380 -r1.381 src/usr.bin/make/make.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/usr.bin/make/make.1
diff -u src/usr.bin/make/make.1:1.380 src/usr.bin/make/make.1:1.381
--- src/usr.bin/make/make.1:1.380 Sun Nov 10 02:39:14 2024
+++ src/usr.bin/make/make.1 Thu Nov 14 19:30:13 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: make.1,v 1.380 2024/11/10 02:39:14 sjg Exp $
+.\" $NetBSD: make.1,v 1.381 2024/11/14 19:30:13 sjg Exp $
.\"
.\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -29,7 +29,7 @@
.\"
.\" from: @(#)make.1 8.4 (Berkeley) 3/19/94
.\"
-.Dd November 10, 2024
+.Dd November 14, 2024
.Dt MAKE 1
.Os
.Sh NAME
@@ -1165,6 +1165,7 @@ to help debug.
.It Va MAKEOBJDIRPREFIX
Used to create files in a separate directory, see
.Va .OBJDIR .
+It should be an absolute path.
.It Va .MAKE.OS
The name of the operating system, see
.Xr uname 1 .
@@ -2641,12 +2642,18 @@ and
.Ev MAKEOBJDIRPREFIX
and
.Ev MAKEOBJDIR
-may only be set in the environment or on the command line to
+should be set in the environment or on the command line to
.Nm
and not as makefile variables;
see the description of
.Sq Va .OBJDIR
for more details.
+It is possible to set these via makefile variables but unless done
+very early and the
+.Sq Ic .OBJDIR
+target is used to reset
+.Sq Va .OBJDIR ,
+there may be unexpected side effects.
.Sh FILES
.Bl -tag -width /usr/share/mk -compact
.It .depend
