The porter's handbook Go chapter: update for D21562

[dmgk]

Summary

Document GO_TARGET tuple form, clarify that GO_PKGNAME is not needed in modules mode.

[tobik]

en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

1174 ↗

(On Diff #61955)

and seen by the <command>go</command>.

When reading this back out loud this sounds really weird to me and I do not think it adds much information. Can we drop it?

1178 ↗

(On Diff #61955)

s/Not needed/It is not needed/

1186 ↗

(On Diff #61955)

"The packages to build."

1191–1196 ↗

(On Diff #61955)

I think everything after "Specifying" would be better moved to one or more small concrete examples in 6.5.8. Building Go Applications.

[dmgk]

en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

1191–1196 ↗

(On Diff #61955)

If you could provide any help with examples, I'd appreciate it, documentation is not my strong suit :)

[tobik]

en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

1191–1196 ↗

(On Diff #61955)

This can be something really simple like https://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/building.html#cargo-ex2
maybe with the examples you have already given in the summary of D21562.

[dmgk]

Update GO_PKGNAME description, add GO_TARGET tuple form examples.

[tobik]

Looks ok to me, but one of the Doc Committers needs to approve.

[bcr]

In D21609#472006, @tobik wrote:

Looks ok to me, but one of the Doc Committers needs to approve.

Let me be the one: Approved! ;)