From nobody Tue Jun 14 11:06:24 2022 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4101285A12D for ; Tue, 14 Jun 2022 11:06:25 +0000 (UTC) (envelope-from git@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) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4LMlxF1LNgz3hqf; Tue, 14 Jun 2022 11:06:25 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1655204785; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+debhO4Poz7kUQf/jzgIfnVEeyq1N9xa+bb+5QcRlGI=; b=VR+0z0dlFo5EPO/IMiIZsxvCKoFoyTpgK87NJ0WjU7rudGpPQjiGV+crs02WX/SCQN8WZo WsQqb6E112H7P+0xKgqbrgUPp2o+49VXofElrKHkjc2h1ElhvOKbS6ka+gA/LObPydNcWH 6S/Efy6wo5ON7GBAGX/QacUeZZQgl8YmEg7huJXjuCxW2rhEttIOlDnzlctxr6V1Dbu9Fh OcOYGfA9Er7i1J0sgnTidXtfKPggjp3AbkUg+aQnEXj68UEDIwP1ythvMzCRj8X6IiAx/c 4aAudfQYUX9v0OD0TnA4eJtK6ifkR97JUc4J7QoHMjG5N5Zw7S6BsxOfYySIiA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 0A615CCE; Tue, 14 Jun 2022 11:06:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 25EB6Oq6080188; Tue, 14 Jun 2022 11:06:24 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 25EB6Os6080187; Tue, 14 Jun 2022 11:06:24 GMT (envelope-from git) Date: Tue, 14 Jun 2022 11:06:24 GMT Message-Id: <202206141106.25EB6Os6080187@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Dmitri Goutnik Subject: git: 1cd6438370 - main - en/porters-handbook: Document go.mk changes List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dmgk X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1cd6438370a068eaa50eef866625ef5095f31a7c Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1655204785; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+debhO4Poz7kUQf/jzgIfnVEeyq1N9xa+bb+5QcRlGI=; b=Q0qDLMAMkFc1XCXCVUxBA0OX8/ssGic9kVpSkeg7jih7tEkCxi/KooVeRVYtmTvjO+foJv z48PxOF1MhJxnnAnbcyG3g417mLSeprmxPOtIGXmUFm7DCZXhB/68U+l/aqsNL2/BxsgCE CRdNfdwE4Z5xawCXT8m+XLZrDXnAhc/d9z2YsR/Q0E3v5mad42pN9zrznNPqaYPfEr/3kI jlh3BFOZd1UC0AHtRhXpRCTGtLDXdW2HMfo1kwaSZwYAA4C+OV8hyJtFcHXDSQPFVzCtjJ /XeklG3jQDxgNygZo4GMP/eE519IbCQ/lRKZSDk89zWRKsa8POqp/I185tgapw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1655204785; a=rsa-sha256; cv=none; b=cy9slSn7amtakM3QlNQvQcqvYUkNS0mwuNitz1p1bYQkBrQ2KTxXh+s+TET1E9mf5h994m ql1GNdKH+mHoGOvtEzlthY6zbVkWtZpGxV6hmbiqLkWGhBy+ZryOLFN6sISPW5sP3ZkSc/ P09QdfrBHYMJLdFneApdCqdVwpEBQMDw587BZQ7z7xQpvU2Y0HhGg+tFygNv7Q4FpJ35Fh lhT4E1VVHImd09Ol/40KC86SlIv3ZIBkzZkVu2sXoK45m8BgJyGAAoDtjzwGGaliVzjHXO tGGgFBU2iQI17Gx2cznG98T7UjCM2qtbBHRsmQU9E2yLZSjAgT5dNmaiPfO9Sg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dmgk (ports committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=1cd6438370a068eaa50eef866625ef5095f31a7c commit 1cd6438370a068eaa50eef866625ef5095f31a7c Author: Dmitri Goutnik AuthorDate: 2022-06-13 11:29:22 +0000 Commit: Dmitri Goutnik CommitDate: 2022-06-14 10:36:30 +0000 en/porters-handbook: Document go.mk changes Document Mk/Uses/go.mk changes introduced by ports 3012ca2179 (versioned Go ports). Approved by: ygy Differential Revision: https://reviews.freebsd.org/D35464 --- .../content/en/books/porters-handbook/uses/_index.adoc | 17 ++++------------- 1 file changed, 4 insertions(+), 13 deletions(-) diff --git a/documentation/content/en/books/porters-handbook/uses/_index.adoc b/documentation/content/en/books/porters-handbook/uses/_index.adoc index 51559eabf6..959bbb2c7f 100644 --- a/documentation/content/en/books/porters-handbook/uses/_index.adoc +++ b/documentation/content/en/books/porters-handbook/uses/_index.adoc @@ -637,14 +637,14 @@ See crossref:special[using-gnome,Using GNOME] for more information. Ports should not be created for Go libs, see crossref:special[go-libs,Go Libraries] for more information. ==== -Possible arguments: (none), `modules`, `no_targets`, `run` +Possible arguments: (none), `N.NN`, `N.NN-devel`, `modules`, `no_targets`, `run` Sets default values and targets used to build Go software. -A build dependency on the Go compiler port selected via `GO_PORT` is added. +A build dependency on the Go compiler port is added, port maintainers can set version required. By default the build is performed in GOPATH mode. If Go software uses modules, the modules-aware mode can be switched on with `modules` argument. -`no_targets` will setup build environment like `GO_ENV`, `GO_BUILDFLAGS` but skip creating `post-extract` and `do-{build,install,test}` targets. -`run` will also add a run dependency on what is in `GO_PORT`. +`no_targets` will setup build environment like `GO_ENV`, `GO_BUILDFLAGS` but skip creating extract and build targets. +`run` will also add a run dependency on the Go compiler port. The build process is controlled by several variables: @@ -679,15 +679,6 @@ Additional build arguments to be passed to `go build`. `GO_TESTFLAGS`:: Additional build arguments to be passed to `go test`. -`GO_PORT`:: -The Go compiler port to use. -By default this is package:lang/go[] but can be set to package:lang/go-devel[] in `make.conf` for testing with future Go versions. -+ -[WARNING] -==== -This variable must not be set by individual ports! -==== - See crossref:special[using-go,Building Go Applications] for usage examples. [[uses-gperf]]