document

Author: bend-n

library/core/src/array/drain.rs

@@ -1,4 +1,3 @@
-#![allow(dead_code)]
 use crate::marker::Destruct;
 use crate::mem::ManuallyDrop;
 
@@ -50,7 +49,7 @@ impl<T: [const] Destruct, U, const N: usize, F: FnMut(T) -> U> const Drop
 }
 impl<'a, T, U, const N: usize, F: FnMut(T) -> U> Drain<'a, T, U, N, F> {
     /// SAFETY: must be called without indexing out of bounds.
-    // FIXME: this is a hack for `let guard = Guard(array); |i| f(guard[i])`.
+    // FIXME(const-hack): this is a hack for `let guard = Guard(array); |i| f(guard[i])`.
     pub(super) const unsafe fn new(array: [T; N], f: &'a mut F) -> Self {
         Self { array: ManuallyDrop::new(array), moved: 0, f }
     }

library/core/src/ops/try_trait.rs

@@ -381,6 +381,7 @@ pub(crate) type ChangeOutputType<T: Try<Residual: Residual<V>>, V> =
 /// Not currently planned to be exposed publicly, so just `pub(crate)`.
 #[repr(transparent)]
 pub(crate) struct NeverShortCircuit<T>(pub T);
+// FIXME(const-hack): replace with `|a| NeverShortCircuit(f(a))` when const closures added.
 pub(crate) struct Wrapped<T, A, F: FnMut(A) -> T> {
     f: F,
     p: PhantomData<(T, A)>,