From owner-svn-doc-head@freebsd.org Mon Sep 16 11:32:39 2019 Return-Path: Delivered-To: svn-doc-head@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 6934EFD62A; Mon, 16 Sep 2019 11:32:39 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 46X3xz2Bxkz4Wgx; Mon, 16 Sep 2019 11:32:39 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 14E551FACD; Mon, 16 Sep 2019 11:32:39 +0000 (UTC) (envelope-from tobik@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id x8GBWcvR004805; Mon, 16 Sep 2019 11:32:38 GMT (envelope-from tobik@FreeBSD.org) Received: (from tobik@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id x8GBWcpS004801; Mon, 16 Sep 2019 11:32:38 GMT (envelope-from tobik@FreeBSD.org) Message-Id: <201909161132.x8GBWcpS004801@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: tobik set sender to tobik@FreeBSD.org using -f From: Tobias Kortkamp Date: Mon, 16 Sep 2019 11:32:38 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r53409 - in head/en_US.ISO8859-1/books/porters-handbook: special uses X-SVN-Group: doc-head X-SVN-Commit-Author: tobik X-SVN-Commit-Paths: in head/en_US.ISO8859-1/books/porters-handbook: special uses X-SVN-Commit-Revision: 53409 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 16 Sep 2019 11:32:39 -0000 Author: tobik (ports committer) Date: Mon Sep 16 11:32:38 2019 New Revision: 53409 URL: https://svnweb.freebsd.org/changeset/doc/53409 Log: Porter's Handbook: Document new GO_TARGET syntax Submitted by: dmgk Approved by: bcr Differential Revision: https://reviews.freebsd.org/D21609 Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Sep 16 09:32:07 2019 (r53408) +++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml Mon Sep 16 11:32:38 2019 (r53409) @@ -1313,6 +1313,24 @@ daviddengcn-go-colortext-186a3d44e920_GH0.tar. 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. + Modified: head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Sep 16 09:32:07 2019 (r53408) +++ head/en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml Mon Sep 16 11:32:38 2019 (r53409) @@ -1168,17 +1168,14 @@ USE_GNOME= gnomemenus3:build intlhack 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 @@ USE_GNOME= gnomemenus3:build intlhack 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}.