docs: this llvm feature only supports the ELF object format

diff --git a/src/doc/unstable-book/src/compiler-flags/emit-stack-sizes.md b/src/doc/unstable-book/src/compiler-flags/emit-stack-sizes.md
index b5456f9ba39aeab40a8b806ffa7fb934cea94d79..47f45a0b91f8572ff12eab0ece815c8ff5fdd798 100644 (file)
--- a/src/doc/unstable-book/src/compiler-flags/emit-stack-sizes.md
+++ b/src/doc/unstable-book/src/compiler-flags/emit-stack-sizes.md
@@ -8,6 +8,10 @@ The tracking issue for this feature is: [#54192]
 
 The rustc flag `-Z emit-stack-sizes` makes LLVM emit stack size metadata.
 
+> **NOTE**: This LLVM feature only supports the ELF object format as of LLVM
+> 8.0. Using this flag with targets that use other object formats (e.g. macOS
+> and Windows) will result in it being ignored.
+
 Consider this crate:
 
 ```