CVS commit: pkgsrc/mk

["Leonardo Taccari" <leot%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   leot
Date:           Sat May  4 17:58:53 UTC 2024

Modified Files:
        pkgsrc/mk: bsd.pkg.mk

Log Message:
mk: Document ALLOW_NETWORK_ACCESS

This can be useful for e.g. `show-go-modules` or similar targets where
such use is okay.

(Probably we should adjust such targets in order to unconditionally set
ALLOW_NETWORK_ACCESS because they are likely not very useful otherwise,
but this is a separate problem.)


To generate a diff of this commit:
cvs rdiff -u -r1.2054 -r1.2055 pkgsrc/mk/bsd.pkg.mk

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/mk/bsd.pkg.mk
diff -u pkgsrc/mk/bsd.pkg.mk:1.2054 pkgsrc/mk/bsd.pkg.mk:1.2055
--- pkgsrc/mk/bsd.pkg.mk:1.2054 Tue Apr 30 20:59:25 2024
+++ pkgsrc/mk/bsd.pkg.mk        Sat May  4 17:58:53 2024
@@ -1,4 +1,4 @@
-#      $NetBSD: bsd.pkg.mk,v 1.2054 2024/04/30 20:59:25 wiz Exp $
+#      $NetBSD: bsd.pkg.mk,v 1.2055 2024/05/04 17:58:53 leot Exp $
 #
 # This file is in the public domain.
 #
@@ -184,6 +184,20 @@ ALL_ENV+=  PREFIX=${PREFIX}
 ALL_ENV+=      MAKELEVEL=0
 ALL_ENV+=      CONFIG_SITE=${PKGSRC_CONFIG_SITE:U}
 .if !defined(ALLOW_NETWORK_ACCESS)
+
+#ALLOW_NETWORK_ACCESS=
+#      If defined network access is permitted also outside the "fetch" phase.
+#
+#      Network access should be permitted only during the "fetch" phase.
+#      By defining this variable fetching is permitted also in other phases.
+#      This can be useful to MAINTAINERs for fetching distfiles to initialize
+#      a package or for custom packages.
+#
+#      Possible: defined, not defined
+#      Default: undefined
+#
+# Keywords: fetch download network
+
 # try stopping downloads during configure/build/...
 ALL_ENV+=      ftp_proxy=downloads-forbidden-except-during-fetch
 ALL_ENV+=      http_proxy=downloads-forbidden-except-during-fetch