Add some comments.

nnethercote · nnethercote · commit a61a85eb24ba · 2022-05-27T15:58:35.000+10:00
diff --git a/library/proc_macro/src/bridge/handle.rs b/library/proc_macro/src/bridge/handle.rs
@@ -8,6 +8,8 @@ use std::sync::atomic::{AtomicUsize, Ordering};
 
 pub(super) type Handle = NonZeroU32;
 
+/// A store that associates values of type `T` with numeric handles. A value can
+/// be looked up using its handle.
 pub(super) struct OwnedStore<T: 'static> {
     counter: &'static AtomicUsize,
     data: BTreeMap<Handle, T>,
@@ -49,6 +51,7 @@ impl<T> IndexMut<Handle> for OwnedStore<T> {
     }
 }
 
+/// Like `OwnedStore`, but avoids storing any value more than once.
 pub(super) struct InternedStore<T: 'static> {
     owned: OwnedStore<T>,
     interner: HashMap<T, Handle>,

Original file line number	Diff line number	Diff line change
`@@ -8,6 +8,8 @@ use std::sync::atomic::{AtomicUsize, Ordering};`
`8`	`8`
`9`	`9`	`pub(super) type Handle = NonZeroU32;`
`10`	`10`
	`11`	+/// A store that associates values of type `T` with numeric handles. A value can
	`12`	`+/// be looked up using its handle.`
`11`	`13`	`pub(super) struct OwnedStore<T: 'static> {`
`12`	`14`	`counter: &'static AtomicUsize,`
`13`	`15`	`data: BTreeMap<Handle, T>,`
`@@ -49,6 +51,7 @@ impl<T> IndexMut<Handle> for OwnedStore<T> {`
`49`	`51`	`}`
`50`	`52`	`}`
`51`	`53`
	`54`	+/// Like `OwnedStore`, but avoids storing any value more than once.
`52`	`55`	`pub(super) struct InternedStore<T: 'static> {`
`53`	`56`	`owned: OwnedStore<T>,`
`54`	`57`	`interner: HashMap<T, Handle>,`