[pkgsrc/trunk]: pkgsrc/lang/perl5 Improved documentation for "make help".

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/9deb30993b6e
branches:  trunk
changeset: 373605:9deb30993b6e
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun Jan 07 11:40:57 2018 +0000

description:
Improved documentation for "make help".

diffstat:

 lang/perl5/module.mk   |   7 ++++++-
 lang/perl5/packlist.mk |  16 ++++++++++------
 2 files changed, 16 insertions(+), 7 deletions(-)

diffs (52 lines):

diff -r c6a32ff9d311 -r 9deb30993b6e lang/perl5/module.mk
--- a/lang/perl5/module.mk      Sun Jan 07 11:39:36 2018 +0000
+++ b/lang/perl5/module.mk      Sun Jan 07 11:40:57 2018 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: module.mk,v 1.72 2016/02/06 00:46:11 mef Exp $
+# $NetBSD: module.mk,v 1.73 2018/01/07 11:40:57 rillig Exp $
 #
 # This Makefile fragment is intended to be included by packages that build
 # and install perl5 modules.
@@ -30,6 +30,11 @@
 #                      "Module::Build::Tiny", "Module::Install", or
 #                      "Module::Install::Bundled" depending on which framework
 #                      is used to build/install the module.
+#
+# See also:
+#      PERL5_PACKLIST
+#
+# Keywords: perl perl5
 
 .include "../../lang/perl5/license.mk"
 
diff -r c6a32ff9d311 -r 9deb30993b6e lang/perl5/packlist.mk
--- a/lang/perl5/packlist.mk    Sun Jan 07 11:39:36 2018 +0000
+++ b/lang/perl5/packlist.mk    Sun Jan 07 11:40:57 2018 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: packlist.mk,v 1.19 2014/11/13 17:48:59 tron Exp $
+# $NetBSD: packlist.mk,v 1.20 2018/01/07 11:40:57 rillig Exp $
 #
 # This Makefile fragment is intended to be included by packages that
 # create packlist files.  This file is automatically included by
@@ -11,12 +11,16 @@
 #      When set to "yes" (the default), automatically generates the
 #      PLIST for the pkgsrc package from the Perl packlist.
 #
-# PERL5_PACKLIST_DIR   "install*arch" directory under which packlist
-#                      files are installed; defaults to
-#                      ${PERL5_INSTALLVENDORARCH}.
+# PERL5_PACKLIST_DIR
+#      The "install*arch" directory under which packlist files are
+#      installed. Only needs to be overridden in very special cases.
 #
-# PERL5_PACKLIST       list of packlist files relative to
-#                      ${PERL5_PACKLIST_DIR}.
+#      Default: ${PERL5_INSTALLVENDORARCH}
+#
+# PERL5_PACKLIST
+#      The list of packlist files relative to ${PERL5_PACKLIST_DIR}.
+#
+#      Example: .auto/Text/Trim/.packlist
 
 .if !defined(_PERL5_PACKLIST_MK)
 _PERL5_PACKLIST_MK=    # defined