docs: remove go/crosstool.rst

bazelbuild · Jul 9, 2024 · 92cc72d · 92cc72d
1 parent c53e32c
commit 92cc72d
Show file tree

Hide file tree

Showing 6 changed files with 8 additions and 356 deletions.
diff --git a/WORKSPACE b/WORKSPACE
@@ -83,7 +83,7 @@ http_archive(
 )
 
 # For manual testing against an LLVM toolchain.
-# Use --crosstool_top=@llvm_toolchain//:toolchain
+# Use --extra_toolchains=@llvm_toolchain//:toolchain
 http_archive(
     name = "com_grail_bazel_toolchain",
     sha256 = "fb762268ca70ced1a0f65d24f92cd881098afd34990ae5767df0ab325217620e",

diff --git a/docs/go/core/cross_compilation.md b/docs/go/core/cross_compilation.md
@@ -21,9 +21,7 @@ which disables cgo; cgo files will not be compiled, and C/C++ dependencies will
 not be compiled or linked.
 
 Cross-compiling cgo code is possible, but not fully supported. You will need to
-[write a CROSSTOOL file] that describes your C/C++ toolchain. You'll need to
-ensure it works by building `cc_binary` and `cc_library` targets with the
-`--cpu` command line flag set. Then, to build a mixed Go / C / C++ project,
-add `pure = "off"` to your `go_binary` target and run Bazel with `--cpu`
-and `--platforms`.
-
+[define and register a C/C++ toolchain and platforms]. You'll need to ensure it
+works by building `cc_binary` and `cc_library` targets with the `--platforms`
+command line flag set. Then, to build a mixed Go / C / C++ project, add
+`pure = "off"` to your `go_binary` target and run Bazel with `--platforms`.
diff --git a/docs/go/core/rules.bzl b/docs/go/core/rules.bzl
@@ -25,7 +25,7 @@
   [test_filter]: https://docs.bazel.build/versions/master/user-manual.html#flag--test_filter
   [test_env]: https://docs.bazel.build/versions/master/user-manual.html#flag--test_env
   [test_runner_fail_fast]: https://docs.bazel.build/versions/master/command-line-reference.html#flag--test_runner_fail_fast
-  [write a CROSSTOOL file]: https://github.com/bazelbuild/bazel/wiki/Yet-Another-CROSSTOOL-Writing-Tutorial
+  [define and register a C/C++ toolchain and platforms]: https://bazel.build/extending/toolchains#toolchain-definitions
   [bazel]: https://pkg.go.dev/github.com/bazelbuild/rules_go/go/tools/bazel?tab=doc
   [go_library]: #go_library
   [go_binary]: #go_binary

diff --git a/docs/go/core/rules.md b/docs/go/core/rules.md
@@ -27,7 +27,7 @@
   [test_filter]: https://docs.bazel.build/versions/master/user-manual.html#flag--test_filter
   [test_env]: https://docs.bazel.build/versions/master/user-manual.html#flag--test_env
   [test_runner_fail_fast]: https://docs.bazel.build/versions/master/command-line-reference.html#flag--test_runner_fail_fast
-  [write a CROSSTOOL file]: https://github.com/bazelbuild/bazel/wiki/Yet-Another-CROSSTOOL-Writing-Tutorial
+  [define and register a C/C++ toolchain and platforms]: https://bazel.build/extending/toolchains#toolchain-definitions
   [bazel]: https://pkg.go.dev/github.com/bazelbuild/rules_go/go/tools/bazel?tab=doc
   [go_library]: #go_library
   [go_binary]: #go_binary

diff --git a/go/core.rst b/go/core.rst
@@ -27,7 +27,7 @@ Core Go rules
 .. _test_filter: https://docs.bazel.build/versions/master/user-manual.html#flag--test_filter
 .. _test_env: https://docs.bazel.build/versions/master/user-manual.html#flag--test_env
 .. _test_runner_fail_fast: https://docs.bazel.build/versions/master/command-line-reference.html#flag--test_runner_fail_fast
-.. _write a CROSSTOOL file: https://github.com/bazelbuild/bazel/wiki/Yet-Another-CROSSTOOL-Writing-Tutorial
+.. _define and register a C/C++ toolchain and platforms: https://bazel.build/extending/toolchains#toolchain-definitions
 .. _bazel: https://pkg.go.dev/github.com/bazelbuild/rules_go/go/tools/bazel?tab=doc
 .. _introduction: /docs/go/core/rules.md#introduction
 .. _rules: /docs/go/core/rules.md#rules

diff --git a/go/crosstool.rst b/go/crosstool.rst