From 1c191c304aa5629e31c93bec395fe4255ecca9ce Mon Sep 17 00:00:00 2001
From: "Joshua M. Clulow" <jmc@oxide.computer>
Date: Tue, 17 Mar 2020 15:04:29 -0700
Subject: [PATCH] review feedback: add a comment describing the situation

---
 src/librustc_codegen_ssa/back/link.rs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/librustc_codegen_ssa/back/link.rs b/src/librustc_codegen_ssa/back/link.rs
index d7081e60bd1f..fb6154eb3926 100644
--- a/src/librustc_codegen_ssa/back/link.rs
+++ b/src/librustc_codegen_ssa/back/link.rs
@@ -841,6 +841,12 @@ pub fn linker_and_flavor(sess: &Session) -> (PathBuf, LinkerFlavor) {
                     }
                     LinkerFlavor::Gcc => {
                         if cfg!(target_os = "solaris") {
+                            // On historical Solaris systems, "cc" may have
+                            // been Sun Studio, which is not flag-compatible
+                            // with "gcc".  This history casts a long shadow,
+                            // and many modern illumos distributions today
+                            // ship GCC as "gcc" without also making it
+                            // available as "cc".
                             "gcc"
                         } else {
                             "cc"