diff --git a/src/doc/src/reference/build-scripts.md b/src/doc/src/reference/build-scripts.md
index 68e8d404f1f..6a60902c46b 100644
--- a/src/doc/src/reference/build-scripts.md
+++ b/src/doc/src/reference/build-scripts.md
@@ -183,7 +183,11 @@ through the library target's public API.
 The optional `KIND` may be one of `dylib`, `static`, or `framework`. See the
 [rustc book][option-link] for more detail.
 
+Note that if you don't specify the `KIND` when using `rustc-link-lib`, the default linkage modifiers won't be applied. 
+For instance, [`+bundled` linkage modifier][bundled-link] won't be used in conjunction with `static` by default.
+
 [option-link]: ../../rustc/command-line-arguments.md#option-l-link-lib
+[bundled-link]: ../../rustc/command-line-arguments.md#linking-modifiers-bundle
 [FFI]: ../../nomicon/ffi.md