Apply suggestions from code review

Co-authored-by: Ralf Jung <[email protected]>

Author: oli-obk

tests/ui/statics/const_generics.rs

@@ -1,5 +1,6 @@
-//! check that we lose the information that `BAR` points to `FOO`
+//! Check that we lose the information that `BAR` points to `FOO`
 //! when going through a const generic.
+//! This is not an intentional guarantee, it just describes the status quo.
 
 //@ run-pass
 // With optimizations, LLVM will deduplicate the constant `X` whose
@@ -16,6 +17,7 @@
 static FOO: usize = 42;
 const BAR: &usize = &FOO;
 fn foo<const X: &'static usize>() {
+    // Without optimizations, `X` ends up pointing to a copy of `FOO` instead of `FOO` itself.
     assert_eq!(cfg!(opt), std::ptr::eq(X, &FOO));
 }