Expose the new trait and Allocation

Author: 197g

alloc-traits/src/lib.rs

@@ -24,6 +24,10 @@ mod local;
 mod ref_;
 
 pub use crate::layout::{Layout, NonZeroLayout};
-pub use crate::local::{AllocTime, Allocation, LocalAlloc};
+pub use crate::local::{AllocTime, LocalAlloc};
+#[deprecated="Use the name `LocalAllocation` instead"]
+pub use crate::local::Allocation;
+pub use crate::local::Allocation as LocalAllocation;
 #[allow(deprecated)]
 pub use crate::local::Invariant;
+pub use crate::ref_::{AllocRef, Allocation as RefAllocation};

alloc-traits/src/ref_.rs

@@ -80,7 +80,12 @@ impl Allocation {
     }
 }
 
-/// Note the 
+/// A reference is an `AllocRef`.
+///
+/// Note the lifetime of the references is exactly the same as the lifetime of the trait. If the
+/// reference outlived the parameter then the returned allocations would not live long enough.
+/// Conversely, if the parameter outlived the lifetime then it would not be possible to construct
+/// the reference necessary for the trait.
 unsafe impl<'rf, T> AllocRef for &'rf T
     where T: LocalAlloc<'rf>
 {