git: 1cd6438370 - main - en/porters-handbook: Document go.mk changes

The branch main has been updated by dmgk (ports committer):

URL: https://cgit.FreeBSD.org/doc/commit/?id=1cd6438370a068eaa50eef866625ef5095f31a7c

commit 1cd6438370a068eaa50eef866625ef5095f31a7c
Author:     Dmitri Goutnik <dmgk@FreeBSD.org>
AuthorDate: 2022-06-13 11:29:22 +0000
Commit:     Dmitri Goutnik <dmgk@FreeBSD.org>
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]]