CVS commit: pkgsrc/lang/go

["Roland Illig" <rillig%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   rillig
Date:           Sat Jan 27 15:49:30 UTC 2018

Modified Files:
        pkgsrc/lang/go: go-package.mk

Log Message:
lang/go: add examples to the go-package.mk documentation


To generate a diff of this commit:
cvs rdiff -u -r1.10 -r1.11 pkgsrc/lang/go/go-package.mk

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

Modified files:

Index: pkgsrc/lang/go/go-package.mk
diff -u pkgsrc/lang/go/go-package.mk:1.10 pkgsrc/lang/go/go-package.mk:1.11
--- pkgsrc/lang/go/go-package.mk:1.10   Mon Mar 20 22:33:21 2017
+++ pkgsrc/lang/go/go-package.mk        Sat Jan 27 15:49:30 2018
@@ -1,6 +1,39 @@
-# $NetBSD: go-package.mk,v 1.10 2017/03/20 22:33:21 bsiegert Exp $
+# $NetBSD: go-package.mk,v 1.11 2018/01/27 15:49:30 rillig Exp $
 #
 # This file implements common logic for compiling Go programs in pkgsrc.
+#
+# === Package-settable variables ===
+#
+# GO_SRCPATH (required)
+#      The patch that can be used with "go get" to import the current
+#      package. This is usually the URL without the leading protocol.
+#
+#      Examples:
+#              github.com/username/repository
+#              gopkg.in/check.v1
+#
+# GO_DIST_BASE (optional)
+#      Path this package extracts to.
+#
+#      Default:
+#              The last path component of ${GO_SRCPATH}
+#      Examples:
+#              ${GITHUB_PROJECT}-${GITHUB_TAG}*
+#              ${GITHUB_PROJECT}-${GITHUB_TAG:S/v//}
+#              ${DISTNAME}
+#
+# GO_BUILD_PATTERN (optional)
+#      Argument used for 'go install'.
+#      In most cases, the default is fine.
+#
+#      Default:
+#              "${GO_SRCPATH}/...", which means all files below GO_SRCPATH.
+#
+# Keywords: go golang
+#
+
+# Implementation notes
+#
 # The compiled Go code is tied to a specific compiler version, and the
 # compilation is fast. So the plan is:
 #
@@ -15,25 +48,6 @@
 # All packages build-depend on the "master" Go release. Go packages
 # need to be revbumped when lang/go is updated.
 #
-# Packages using this should set GO_SRCPATH to the path that could
-# be used with "go get" (usually the URL without the leading protocol).
-#
-# === Package-settable variables ===
-#
-# GO_SRCPATH
-#      Path used for go 'import' lines in source code.
-#
-# GO_DIST_BASE
-#      Path this package extracts to; only set it if it's not the same
-#      as GO_SRCPATH.
-#
-# GO_BUILD_PATTERN
-#      Argument used for 'go install'
-#      Defaults to "${GO_SRCPATH}/..." which means all files
-#      below GO_SRCPATH.
-#
-# Keywords: go
-#
 
 .include "../../lang/go/version.mk"