[src/trunk]: src/usr.bin/make Document .OBJDIR target.

[sjg <sjg%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/06ee5229b0af
branches:  trunk
changeset: 808847:06ee5229b0af
user:      sjg <sjg%NetBSD.org@localhost>
date:      Fri Jun 05 05:37:42 2015 +0000

description:
Document .OBJDIR target.

diffstat:

 usr.bin/make/make.1 |  20 +++++++++++++++-----
 1 files changed, 15 insertions(+), 5 deletions(-)

diffs (53 lines):

diff -r c3e82155fb56 -r 06ee5229b0af usr.bin/make/make.1
--- a/usr.bin/make/make.1       Fri Jun 05 05:03:21 2015 +0000
+++ b/usr.bin/make/make.1       Fri Jun 05 05:37:42 2015 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: make.1,v 1.247 2015/04/10 08:43:32 wiz Exp $
+.\"    $NetBSD: make.1,v 1.248 2015/06/05 05:37:42 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 April 9, 2015
+.Dd June 4, 2015
 .Dt MAKE 1
 .Os
 .Sh NAME
@@ -993,14 +993,15 @@
 .Ql Ev MAKEOBJDIR .
 .Pp
 .Ql Va .OBJDIR
-may be modified in the makefile as a global variable.
+may be modified in the makefile via the special target
+.Ql Ic .OBJDIR .
 In all cases,
 .Nm
 will
 .Xr chdir 2
-to
+to the specified directory if it exists, and set
 .Ql Va .OBJDIR
-and set
+and
 .Ql Ev PWD
 to that directory before executing any targets.
 .
@@ -2001,6 +2002,15 @@
 Synonym for
 .Ic .NOTPARALLEL ,
 for compatibility with other pmake variants.
+.It Ic .OBJDIR
+The source is a new value for
+.Ql Va .OBJDIR .
+If it exists,
+.Nm
+will
+.Xr chdir 2
+to it and update the value of 
+.Ql Va .OBJDIR .
 .It Ic .ORDER
 The named targets are made in sequence.
 This ordering does not add targets to the list of targets to be made.