[src/trunk]: src/usr.bin/make Document the fact that lack of shell meta chars...

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

details:   https://anonhg.NetBSD.org/src/rev/2622a0abc5d0
branches:  trunk
changeset: 781592:2622a0abc5d0
user:      sjg <sjg%NetBSD.org@localhost>
date:      Mon Sep 17 01:23:45 2012 +0000

description:
Document the fact that lack of shell meta chars in a command
results in direct exec in compat mode.

diffstat:

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

diffs (32 lines):

diff -r ac671ba0cad9 -r 2622a0abc5d0 usr.bin/make/make.1
--- a/usr.bin/make/make.1       Sun Sep 16 22:22:45 2012 +0000
+++ b/usr.bin/make/make.1       Mon Sep 17 01:23:45 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: make.1,v 1.206 2012/08/30 22:35:37 wiz Exp $
+.\"    $NetBSD: make.1,v 1.207 2012/09/17 01:23:45 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 August 30, 2012
+.Dd September 16, 2012
 .Dt MAKE 1
 .Os
 .Sh NAME
@@ -2042,6 +2042,13 @@
 To be compatible with Makefiles that do this, one can use
 .Fl B
 to disable this behavior.
+.Pp
+In compatability mode, each command is run in a separate process.
+If the command contains any shell meta characters
+.Pq Ql #=|^(){};&<>*?[]:$`\e\en
+it will be passed to the shell, otherwise
+.Nm
+will attempt direct execution.
 .Sh SEE ALSO
 .Xr mkdep 1
 .Sh HISTORY