From 873ac1e9006e0cead804b6e51e5b71f440bc4709 Mon Sep 17 00:00:00 2001
From: hi-rustin <rustin.liu@gmail.com>
Date: Fri, 25 Aug 2023 00:22:30 +0800
Subject: [PATCH] Add `target.<cfg>.linker` document

---
 src/doc/src/reference/config.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/src/doc/src/reference/config.md b/src/doc/src/reference/config.md
index d1f2b04d35e4..bef118acd355 100644
--- a/src/doc/src/reference/config.md
+++ b/src/doc/src/reference/config.md
@@ -1098,6 +1098,17 @@ This option is deprecated and unused.
 Specifies the linker which is passed to `rustc` (via [`-C linker`]) when the
 [`<triple>`] is being compiled for. By default, the linker is not overridden.
 
+##### `target.<cfg>.linker`
+This is similar to the [target linker](#targettriplelinker), but using
+a [`cfg()` expression]. 
+
+The config precedence is:
+1. `host.<triple>.linker`, if [host-config](unstable.md#host-config) is enabled.
+2. `target.<triple>.linker`
+3. `target.<cfg>.linker`
+
+It is an error if more than one `<cfg>` runner matches the current target.
+
 ##### `target.<triple>.runner`
 * Type: string or array of strings ([program path with args])
 * Default: none