docs: update for mixed Rust/non-Rust sources

2 files changed, 14 insertions, 4 deletions

diff --git a/docs/markdown/Rust.md b/docs/markdown/Rust.md
index 08580cdb6..452dad6e6 100644
--- a/docs/markdown/Rust.md
+++ b/docs/markdown/Rust.md
@@ -27,14 +27,20 @@ feature is stabilized.
 
 ## Mixing Rust and non-Rust sources
 
-Meson currently does not support creating a single target with Rust and non Rust
-sources mixed together, therefore one must compile multiple libraries and link
-them.
+*(Since 1.9.0)* Rust supports mixed targets, but only supports using
+`rustc` as the linker for such targets. If you need to use a non-Rust
+linker, or support Meson < 1.9.0, see below.
+
+Until Meson 1.9.0, Meson did not support creating a single target with
+Rust and non Rust sources mixed together. One had to compile a separate
+Rust `static_library` or `shared_library`, and link it into the C build
+target (e.g., a library or an executable).
 
 ```meson
 rust_lib = static_library(
     'rust_lib',
     sources : 'lib.rs',
+    rust_abi: 'c',
     ...
 )
 
@@ -44,7 +50,6 @@ c_lib = static_library(
     link_with : rust_lib,
 )
 ```
-This is an implementation detail of Meson, and is subject to change in the future.
 
 ## Mixing Generated and Static sources
 
diff --git a/docs/markdown/snippets/rust-mixed.md b/docs/markdown/snippets/rust-mixed.md
new file mode 100644
index 000000000..d42ab908d
--- /dev/null
+++ b/docs/markdown/snippets/rust-mixed.md
@@ -0,0 +1,5 @@
+## Rust and non-Rust sources in the same target
+
+Meson now supports creating a single target with Rust and non Rust
+sources mixed together.  In this case, if specified, `link_language`
+must be set to `rust`.