regen

1 files changed, 26 insertions, 6 deletions

diff --git a/doc/pkgsrc.txt b/doc/pkgsrc.txt
index b947fabdf03..d7a28c9fdee 100644
--- a/doc/pkgsrc.txt
+++ b/doc/pkgsrc.txt
@@ -4824,6 +4824,22 @@ headers and libraries for these dependencies are also symlinked into $
 {BUILDLINK_DIR} whenever the pkg buildlink3.mk file is included. Dependencies
 are only added for directly include buildlink3.mk files.
 
+When providing a buildlink3.mk and including other buildlink3.mk files in it,
+please only add necessary ones. I.e. those whose libraries or header files are
+automatically exposed when the package is use.
+
+In particular, if only an executable (bin/foo) is linked against a library,
+that library does not need to be propagated in the buildlink3.mk file.
+
+The following steps should help you decide if a buildlink3.mk file needs to be
+included:
+
+  * Run ldd on all installed libraries and look against what other libraries
+    they link. The packages providing these must be buildlinked.
+
+  * Look at the installed header files: What headers do they include? The
+    packages providing these files must be buildlinked.
+
 14.2.2. Updating BUILDLINK_API_DEPENDS.pkg and BUILDLINK_ABI_DEPENDS.pkg in
 buildlink3.mk files
 
@@ -7496,15 +7512,19 @@ Perl5 modules will install into different places depending on the version of
 perl used during the build process. To address this, pkgsrc will append lines
 to the PLIST corresponding to the files listed in the installed .packlist file
 generated by most perl5 modules. This is invoked by defining PERL5_PACKLIST to
-a space-separated list of paths to packlist files, e.g.:
+a space-separated list of packlist files relative to PERL5_PACKLIST_DIR
+(PERL5_INSTALLVENDORARCH by default), e.g.:
 
-PERL5_PACKLIST= ${PERL5_SITEARCH}/auto/Pg/.packlist
+PERL5_PACKLIST= auto/Pg/.packlist
 
 
-The variables PERL5_SITELIB, PERL5_SITEARCH, and PERL5_ARCHLIB represent the
-three locations in which perl5 modules may be installed, and may be used by
-perl5 packages that don't have a packlist. These three variables are also
-substituted for in the PLIST.
+The perl5 config variables installarchlib, installscript, installvendorbin,
+installvendorscript, installvendorarch, installvendorlib, installvendorman1dir,
+and installvendorman3dir represent those locations in which components of perl5
+modules may be installed, provided as variable with uppercase and prefixed with
+PERL5_, e.g. PERL5_INSTALLARCHLIB and may be used by perl5 packages that don't
+have a packlist. These variables are also substituted for in the PLIST as
+uppercase prefixed with PERL5_SUB_.
 
 19.6.7. Packages installing info files