[website] doc/install/gccgo: note gold linker deprecation

3 views
Skip to first unread message

John S (Gerrit)

unread,
Feb 3, 2026, 9:01:08 AMFeb 3
to goph...@pubsubhelper.golang.org, golang-co...@googlegroups.com

John S has uploaded the change for review

Commit message

doc/install/gccgo: note gold linker deprecation

The gold linker is deprecated as of GNU Binutils 2.44 (February 2025)
and may be removed in future releases. Update the documentation to:

- Add a deprecation notice at the start of the Gold section
- Recommend lld as an alternative that supports split stacks
- Note that gold is now in a separate binutils-with-gold tarball
- Provide the --with-ld flag for using lld

Fixes golang/go#71923
Co-Authored-By: Claude Opus 4.5 <nor...@anthropic.com>
Change-Id: Ieeeb217ef858af08d2e7b70e0ecaaed3457466f8

Change diff

diff --git a/_content/doc/install/gccgo.html b/_content/doc/install/gccgo.html
index 21080d9..18a144e 100644
--- a/_content/doc/install/gccgo.html
+++ b/_content/doc/install/gccgo.html
@@ -135,12 +135,25 @@
 <h3 id="Gold">Gold</h3>
 
 <p>
+<b>Note:</b> The gold linker is deprecated as of GNU Binutils 2.44 (February 2025)
+and may be removed in future releases. Consider using
+<a href="https://lld.llvm.org/">lld</a> (LLVM's linker) as an alternative,
+which also supports split stacks on x86_64.
+</p>
+
+<p>
 On x86 GNU/Linux systems the gccgo compiler is able to
 use a small discontiguous stack for goroutines. This permits programs
 to run many more goroutines, since each goroutine can use a relatively
-small stack. Doing this requires using the gold linker version 2.22
-or later. You can either install GNU binutils 2.22 or later, or you
-can build gold yourself.
+small stack. Doing this requires using a linker that supports split stacks.
+The gold linker version 2.22 or later supports this feature,
+as does lld.
+</p>
+
+<p>
+If you still need to use gold, you can either install GNU binutils 2.22 or later
+(note: as of binutils 2.44, gold is in a separate binutils-with-gold tarball),
+or you can build gold yourself.
 </p>
 
 <p>
@@ -164,6 +177,7 @@
 <p>
 However you install gold, when you configure gccgo, use the
 option <code>--with-ld=<var>GOLD_BINARY</var></code>.
+Similarly, for lld use <code>--with-ld=/path/to/ld.lld</code>.
 </p>
 
 <h3 id="Prerequisites">Prerequisites</h3>

Change information

Files:
  • M _content/doc/install/gccgo.html
Change size: S
Delta: 1 file changed, 17 insertions(+), 3 deletions(-)
Open in Gerrit

Related details

Attention set is empty
Submit Requirements:
  • requirement is not satisfiedCode-Review
  • requirement satisfiedNo-Unresolved-Comments
  • requirement is not satisfiedReview-Enforcement
  • requirement is not satisfiedTryBots-Pass
Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
Gerrit-MessageType: newchange
Gerrit-Project: website
Gerrit-Branch: master
Gerrit-Change-Id: Ieeeb217ef858af08d2e7b70e0ecaaed3457466f8
Gerrit-Change-Number: 741421
Gerrit-PatchSet: 1
Gerrit-Owner: John S <xau...@gmail.com>
unsatisfied_requirement
satisfied_requirement
open
diffy

Ian Lance Taylor (Gerrit)

unread,
Mar 12, 2026, 6:07:57 PM (6 days ago) Mar 12
to John S, goph...@pubsubhelper.golang.org, Ian Lance Taylor, golang-co...@googlegroups.com
Attention needed from John S

Ian Lance Taylor voted and added 1 comment

Votes added by Ian Lance Taylor

Code-Review+2
Commit-Queue+1

1 comment

Patchset-level comments
File-level comment, Patchset 1 (Latest):
Ian Lance Taylor . resolved

Thanks.

Open in Gerrit

Related details

Attention is currently required from:
  • John S
Submit Requirements:
  • requirement satisfiedCode-Review
  • requirement satisfiedNo-Unresolved-Comments
  • requirement is not satisfiedReview-Enforcement
  • requirement is not satisfiedTryBots-Pass
Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
Gerrit-MessageType: comment
Gerrit-Project: website
Gerrit-Branch: master
Gerrit-Change-Id: Ieeeb217ef858af08d2e7b70e0ecaaed3457466f8
Gerrit-Change-Number: 741421
Gerrit-PatchSet: 1
Gerrit-Owner: John S <xau...@gmail.com>
Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
Gerrit-CC: Sean Liao <se...@liao.dev>
Gerrit-Attention: John S <xau...@gmail.com>
Gerrit-Comment-Date: Thu, 12 Mar 2026 22:07:52 +0000
Gerrit-HasComments: Yes
Gerrit-Has-Labels: Yes
satisfied_requirement
unsatisfied_requirement
open
diffy

Carlos Amedee (Gerrit)

unread,
Mar 17, 2026, 2:45:17 PM (23 hours ago) Mar 17
to John S, goph...@pubsubhelper.golang.org, Go LUCI, Ian Lance Taylor, golang-co...@googlegroups.com
Attention needed from John S

Carlos Amedee voted Code-Review+1

Code-Review+1
Open in Gerrit

Related details

Attention is currently required from:
  • John S
Submit Requirements:
    • requirement satisfiedCode-Review
    • requirement satisfiedNo-Unresolved-Comments
    • requirement is not satisfiedReview-Enforcement
    • requirement satisfiedTryBots-Pass
    Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
    Gerrit-MessageType: comment
    Gerrit-Project: website
    Gerrit-Branch: master
    Gerrit-Change-Id: Ieeeb217ef858af08d2e7b70e0ecaaed3457466f8
    Gerrit-Change-Number: 741421
    Gerrit-PatchSet: 1
    Gerrit-Owner: John S <xau...@gmail.com>
    Gerrit-Reviewer: Carlos Amedee <car...@golang.org>
    Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
    Gerrit-CC: Sean Liao <se...@liao.dev>
    Gerrit-Attention: John S <xau...@gmail.com>
    Gerrit-Comment-Date: Tue, 17 Mar 2026 18:45:14 +0000
    Gerrit-HasComments: No
    Gerrit-Has-Labels: Yes
    satisfied_requirement
    unsatisfied_requirement
    open
    diffy

    Mark Freeman (Gerrit)

    unread,
    Mar 17, 2026, 2:59:08 PM (23 hours ago) Mar 17
    to John S, goph...@pubsubhelper.golang.org, Carlos Amedee, Go LUCI, Ian Lance Taylor, golang-co...@googlegroups.com
    Attention needed from John S

    Mark Freeman voted Code-Review+1

    Code-Review+1
    Open in Gerrit

    Related details

    Attention is currently required from:
    • John S
    Submit Requirements:
      • requirement satisfiedCode-Review
      • requirement satisfiedNo-Unresolved-Comments
      • requirement satisfiedReview-Enforcement
      • requirement satisfiedTryBots-Pass
      Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
      Gerrit-MessageType: comment
      Gerrit-Project: website
      Gerrit-Branch: master
      Gerrit-Change-Id: Ieeeb217ef858af08d2e7b70e0ecaaed3457466f8
      Gerrit-Change-Number: 741421
      Gerrit-PatchSet: 1
      Gerrit-Owner: John S <xau...@gmail.com>
      Gerrit-Reviewer: Carlos Amedee <car...@golang.org>
      Gerrit-Reviewer: Ian Lance Taylor <ia...@golang.org>
      Gerrit-Reviewer: Mark Freeman <markf...@google.com>
      Gerrit-CC: Sean Liao <se...@liao.dev>
      Gerrit-Attention: John S <xau...@gmail.com>
      Gerrit-Comment-Date: Tue, 17 Mar 2026 18:59:05 +0000
      Gerrit-HasComments: No
      Gerrit-Has-Labels: Yes
      satisfied_requirement
      open
      diffy

      Ian Lance Taylor (Gerrit)

      unread,
      3:56 AM (10 hours ago) 3:56 AM
      to John S, goph...@pubsubhelper.golang.org, Ian Lance Taylor, Mark Freeman, Carlos Amedee, Go LUCI, golang-co...@googlegroups.com
      Attention needed from John S

      Ian Lance Taylor voted Auto-Submit+1

      Auto-Submit+1
      Gerrit-Comment-Date: Wed, 18 Mar 2026 07:56:52 +0000
      Gerrit-HasComments: No
      Gerrit-Has-Labels: Yes
      satisfied_requirement
      open
      diffy

      Gopher Robot (Gerrit)

      unread,
      3:59 AM (10 hours ago) 3:59 AM
      to John S, goph...@pubsubhelper.golang.org, golang-...@googlegroups.com, Ian Lance Taylor, Mark Freeman, Carlos Amedee, Go LUCI, golang-co...@googlegroups.com

      Gopher Robot submitted the change

      Change information

      Commit message:
      doc/install/gccgo: note gold linker deprecation

      The gold linker is deprecated as of GNU Binutils 2.44 (February 2025)
      and may be removed in future releases. Update the documentation to:

      - Add a deprecation notice at the start of the Gold section
      - Recommend lld as an alternative that supports split stacks
      - Note that gold is now in a separate binutils-with-gold tarball
      - Provide the --with-ld flag for using lld

      Fixes golang/go#71923
      Co-Authored-By: Claude Opus 4.5 <nor...@anthropic.com>
      Change-Id: Ieeeb217ef858af08d2e7b70e0ecaaed3457466f8
      Auto-Submit: Ian Lance Taylor <ia...@golang.org>
      Reviewed-by: Mark Freeman <markf...@google.com>
      Reviewed-by: Carlos Amedee <car...@golang.org>
      Reviewed-by: Ian Lance Taylor <ia...@golang.org>
      Files:
      • M _content/doc/install/gccgo.html
      Change size: S
      Delta: 1 file changed, 17 insertions(+), 3 deletions(-)
      Branch: refs/heads/master
      Submit Requirements:
      • requirement satisfiedCode-Review: +1 by Carlos Amedee, +1 by Mark Freeman, +2 by Ian Lance Taylor
      • requirement satisfiedTryBots-Pass: LUCI-TryBot-Result+1 by Go LUCI
      Open in Gerrit
      Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
      Gerrit-MessageType: merged
      Gerrit-Project: website
      Gerrit-Branch: master
      Gerrit-Change-Id: Ieeeb217ef858af08d2e7b70e0ecaaed3457466f8
      Gerrit-Change-Number: 741421
      Gerrit-PatchSet: 2
      Gerrit-Owner: John S <xau...@gmail.com>
      Gerrit-Reviewer: Carlos Amedee <car...@golang.org>
      Gerrit-Reviewer: Gopher Robot <go...@golang.org>
      open
      diffy
      satisfied_requirement
      Reply all
      Reply to author
      Forward
      0 new messages