Index: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
@@ -1313,6 +1313,24 @@
like with Poudriere, remember to
run make clean before any testing.
+
+
+ Setting Output Binary Name or Installation Path
+
+ Some ports need to install the resulting binary under a
+ different name or to a path other than
+ the default ${PREFIX}/bin. This can be
+ done by using GO_TARGET tuple syntax,
+ for example:
+ GO_TARGET= ./cmd/ipfs:ipfs-go
+
+ will install ipfs binary as
+ ${PREFIX}/bin/ipfs-go and
+ GO_TARGET= ./dnscrypt-proxy:${PREFIX}/sbin/dnscrypt-proxy
+
+ will install dnscrypt-proxy to
+ ${PREFIX}/sbin.
+
Index: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
+++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml
@@ -1168,17 +1168,14 @@
GO_PKGNAME
- The name of the Go package.
- When building in GOPATH mode, this is the directory that
- will be created in ${GOPATH}/src and
- seen by the go. When building in
- modules-aware mode, no GOPATH directories will be created
- and GO_PKGNAME value will be only used
- as a default for GO_TARGET. If not set
- explicitly and GH_SUBDIR is present,
- GO_PKGNAME value will be inferred from
- ${GH_SUBDIR}, otherwise it will be set
- to ${PORTNAME}.
+ The name of the Go package
+ when building in GOPATH mode. This is the directory that
+ will be created in ${GOPATH}/src. If
+ not set explicitly and GH_SUBDIR or
+ GL_SUBDIR is present,
+ GO_PKGNAME will be inferred from it.
+ It is not needed when building in modules-aware
+ mode.
@@ -1186,8 +1183,12 @@
GO_TARGET
- The name of the packages to build. The default
- value is ${GO_PKGNAME}.
+ The packages to build. The default
+ value is ${GO_PKGNAME}.
+ GO_TARGET can also be a tuple in the
+ form package:path where path can be
+ either a simple filename or a full path starting with
+ ${PREFIX}.