[src/trunk]: src/usr.bin/make make: fix description of .PREFIX

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

details:   https://anonhg.NetBSD.org/src/rev/2327feb33985
branches:  trunk
changeset: 374601:2327feb33985
user:      sjg <sjg%NetBSD.org@localhost>
date:      Sun May 07 16:32:47 2023 +0000

description:
make: fix description of .PREFIX

For at least 20 years, the setting of .PREFIX in make
has not matched the documentation.
Since the documented behavior does not match reality or
POSIX make, fix the documentation.

In FindDepsRegularPath str_basename is applied to .PREFIX
this is wrong, but I was unable to verify fixing it
was benign in NetBSD build - my NetBSD box (7.2)
was unable to build known-good src with or without any patches.

For now just document the behavior more accurately.

diffstat:

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

diffs (34 lines):

diff -r 911bddf57734 -r 2327feb33985 usr.bin/make/make.1
--- a/usr.bin/make/make.1       Sun May 07 16:24:28 2023 +0000
+++ b/usr.bin/make/make.1       Sun May 07 16:32:47 2023 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: make.1,v 1.361 2023/03/23 03:29:28 sjg Exp $
+.\"    $NetBSD: make.1,v 1.362 2023/05/07 16:32:47 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 March 22, 2023
+.Dd May 6, 2023
 .Dt MAKE 1
 .Os
 .Sh NAME
@@ -796,12 +796,10 @@ The list of sources for this target that
 known as
 .Sq Va \&? .
 .It Va .PREFIX
-The file prefix of the target, containing only the file portion, no suffix
-or preceding directory components; also known as
+The name of the target with suffix (if declared in
+.Ic .SUFFIXES )
+removed; also known as
 .Sq Va * .
-The suffix must be one of the known suffixes declared with
-.Ic .SUFFIXES ,
-or it is not recognized.
 .It Va .TARGET
 The name of the target; also known as
 .Sq Va @ .