[src/trunk]: src/usr.bin/make Document what the magic variable .MAKE.EXPAND_V...

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

details:   https://anonhg.NetBSD.org/src/rev/7bb32007dc9d
branches:  trunk
changeset: 354586:7bb32007dc9d
user:      dholland <dholland%NetBSD.org@localhost>
date:      Thu Jun 22 13:21:21 2017 +0000

description:
Document what the magic variable .MAKE.EXPAND_VARIABLES actually does.

diffstat:

 usr.bin/make/make.1 |  12 +++++++++---
 1 files changed, 9 insertions(+), 3 deletions(-)

diffs (40 lines):

diff -r 1c602b0d466b -r 7bb32007dc9d usr.bin/make/make.1
--- a/usr.bin/make/make.1       Thu Jun 22 13:13:51 2017 +0000
+++ b/usr.bin/make/make.1       Thu Jun 22 13:21:21 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: make.1,v 1.267 2017/06/19 19:58:24 christos Exp $
+.\"    $NetBSD: make.1,v 1.268 2017/06/22 13:21:21 dholland 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 June 19, 2017
+.Dd June 22, 2017
 .Dt MAKE 1
 .Os
 .Sh NAME
@@ -207,7 +207,9 @@
 .It Ar V
 Force the
 .Fl V
-option to print raw values of variables.
+option to print raw values of variables, overriding the default behavior
+set via
+.Va .MAKE.EXPAND_VARIABLES.
 .It Ar v
 Print debugging information about variable assignment.
 .It Ar x
@@ -781,6 +783,10 @@
 A boolean that controls the default behavior of the
 .Fl V
 option.
+If true, variable values printed with
+.Fl V
+are fully expanded; if false, the raw variable contents (which may
+include additional unexpanded variable references) are shown.
 .It Va .MAKE.EXPORTED
 The list of variables exported by
 .Nm .