[pkgsrc/trunk]: pkgsrc replace-interpreter: make documentation more precise

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/8b2f2b3c56ce
branches:  trunk
changeset: 414082:8b2f2b3c56ce
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Tue Mar 24 04:40:34 2020 +0000

description:
replace-interpreter: make documentation more precise

There are several places in pkgsrc where the files to be patched are
listed individually instead of just saying util/*/*.sh. This is
unnecessarily detailed. Encourage package authors to use filename
patterns more often.

An example is REPLACE_PYTHON in lang/clang, which currently fails because
some of the listed files don't exist anymore.

diffstat:

 lang/python/application.mk          |  5 +++--
 mk/configure/replace-interpreter.mk |  8 ++++----
 2 files changed, 7 insertions(+), 6 deletions(-)

diffs (41 lines):

diff -r fd8dd3d5e0be -r 8b2f2b3c56ce lang/python/application.mk
--- a/lang/python/application.mk        Tue Mar 24 04:09:07 2020 +0000
+++ b/lang/python/application.mk        Tue Mar 24 04:40:34 2020 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: application.mk,v 1.12 2017/07/03 18:13:43 joerg Exp $
+# $NetBSD: application.mk,v 1.13 2020/03/24 04:40:34 rillig Exp $
 #
 # Replace the #! interpreter for Python scripts.
 #
@@ -10,7 +10,8 @@
 # Package-settable variables:
 #
 # REPLACE_PYTHON
-#      A list of Python scripts to be installed, relative to ${WRKSRC}.
+#      A list of filename patterns for Python scripts to be installed,
+#      relative to ${WRKSRC}.
 #
 # Keywords: python
 #
diff -r fd8dd3d5e0be -r 8b2f2b3c56ce mk/configure/replace-interpreter.mk
--- a/mk/configure/replace-interpreter.mk       Tue Mar 24 04:09:07 2020 +0000
+++ b/mk/configure/replace-interpreter.mk       Tue Mar 24 04:40:34 2020 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: replace-interpreter.mk,v 1.18 2020/03/22 21:31:21 rillig Exp $
+# $NetBSD: replace-interpreter.mk,v 1.19 2020/03/24 04:40:34 rillig Exp $
 
 # This file provides common templates for replacing #! interpreters
 # in script files.
@@ -12,9 +12,9 @@
 # REPLACE_PERL
 # REPLACE_PERL6
 # REPLACE_SH
-#      Lists of files relative to WRKSRC in which the #! interpreter
-#      should be replaced by the pkgsrc one. If any directories
-#      appear in the lists, they are silenty skipped, assuming that
+#      Lists of filename patterns relative to WRKSRC in which the #!
+#      interpreter should be replaced by the pkgsrc one. Any directories
+#      that appear in the lists are silenty skipped, assuming that
 #      they result from shell globbing expressions.
 #
 #      Use REPLACE_SH for shell programs that don't need any