Clarify confusing sentence in TRPL: FFI

After talking with @graydon on #rust-internals, this is hopefully clarifying.

Fixes #25586

diff --git a/src/doc/trpl/ffi.md b/src/doc/trpl/ffi.md
index 9ede835e521c9a7e26212cec3c96392f537269be..8077f04ed60842b49aba8b7080b7eb5539a1201c 100644 (file)
--- a/src/doc/trpl/ffi.md
+++ b/src/doc/trpl/ffi.md
@@ -342,8 +342,10 @@ Note that frameworks are only available on OSX targets.
 The different `kind` values are meant to differentiate how the native library
 participates in linkage. From a linkage perspective, the rust compiler creates
 two flavors of artifacts: partial (rlib/staticlib) and final (dylib/binary).
-Native dynamic libraries and frameworks are propagated to the final artifact
-boundary, while static libraries are not propagated at all.
+Native dynamic library and framework dependencies are propagated to the final
+artifact boundary, while static library dependencies are not propagated at
+all, because the static libraries are integrated directly into the subsequent
+artifact.
 
 A few examples of how this model can be used are: