From 539a045dfbf846692c8539e42a1d98efefa2fae9 Mon Sep 17 00:00:00 2001
From: Adam Gemmell <adam.gemmell@arm.com>
Date: Thu, 8 Jan 2026 16:22:26 +0000
Subject: [PATCH] Rephrase embed-bitcode comment

---
 library/Cargo.toml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/library/Cargo.toml b/library/Cargo.toml
index 2a2c015811b8..b26e5f41c931 100644
--- a/library/Cargo.toml
+++ b/library/Cargo.toml
@@ -62,9 +62,10 @@ inherits = "release"
 codegen-units = 1
 debug = 1 # "limited"
 rustflags = [
-    # Unconditionally embedding bitcode is necessary for when users enable LTO.
-    # Until Cargo can rebuild the standard library with the user profile's `lto`
-    # setting, Cargo will force this to be `no`
+    # `profile.lto=off` implies `-Cembed-bitcode=no`, but unconditionally embedding
+    # bitcode is necessary for when users enable LTO.
+    # Required until Cargo can re-build the standard library based on the value
+    # of `profile.lto` in the user's profile.
     "-Cembed-bitcode=yes",
     # Enable frame pointers
     "-Zunstable-options",