[src/trunk]: src/usr.bin/make Document .DELETE_ON_ERROR.

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

details:   https://anonhg.NetBSD.org/src/rev/8c3d39146aad
branches:  trunk
changeset: 347452:8c3d39146aad
user:      dholland <dholland%NetBSD.org@localhost>
date:      Fri Aug 26 23:37:54 2016 +0000

description:
Document .DELETE_ON_ERROR.

diffstat:

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

diffs (33 lines):

diff -r 39f4d4a96006 -r 8c3d39146aad usr.bin/make/make.1
--- a/usr.bin/make/make.1       Fri Aug 26 23:28:39 2016 +0000
+++ b/usr.bin/make/make.1       Fri Aug 26 23:37:54 2016 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: make.1,v 1.262 2016/08/18 19:23:20 wiz Exp $
+.\"    $NetBSD: make.1,v 1.263 2016/08/26 23:37:54 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 August 15, 2016
+.Dd August 26, 2016
 .Dt MAKE 1
 .Os
 .Sh NAME
@@ -2010,6 +2010,14 @@
 .Ic .DEFAULT Ns 's
 commands is set
 to the target's own name.
+.It Ic .DELETE_ON_ERROR
+If this target is present in the makefile, it globally causes make to
+delete targets whose commands fail.
+(By default, only targets whose commands are interrupted during
+execution are deleted.
+This is the historical behavior.)
+This setting can be used to help prevent half-finished or malformed
+targets from being left around and corrupting future rebuilds.
 .It Ic .END
 Any command lines attached to this target are executed after everything
 else is done.