gccgo: docs should not recommend gold (deprecated) as default

[dilyanpalauzov]

Building GCCGO suggests at https://go.dev/doc/install/gccgo#Gold to use the gold linker, as it supports small discontiguous stack for goroutines, implying correctly that ld.bfd does not support this stack form.

Please update the above link to state that the gold linker is now deprecated, and include a statement for the mold, ld.lld, ld.bfd linkers, if they support small discontiguous stack for goroutines.

[dilyanpalauzov]

I do not think that the suggestion to install the deprecated gold linker as default linker (ld executable), by passing --enable-gold=default is a good idea.

[gabyhelp]

Related Issues

• gccgo: “use a small discontiguous stack for goroutines” may not be specified clearly enough to be implemented elsewhere #47622 (closed)
• gccgo: is discontiguous stack available in gold since binutils 2.21 or 2.22? #50378 (closed)

Related Documentation

• Setting up and using gccgo > Building > Gold

_{(Emoji vote if this was helpful or unhelpful; more detailed feedback welcome in this discussion.)}

[prattmic]

cc @ianlancetaylor