Fix small doc mistakes

boa_interner/src/interned_str.rs

@@ -35,15 +35,15 @@ impl InternedStr {
     /// could cause Undefined Behaviour.
     #[inline]
     pub(super) unsafe fn as_str(&self) -> &str {
-        // SAFETY: The user must verify the invariants
+        // SAFETY: The caller must verify the invariants
         // specified on the struct definition.
         unsafe { self.ptr.as_ref() }
     }
 }
 
 impl std::hash::Hash for InternedStr {
     fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
-        // SAFETY: The user must verify the invariants
+        // SAFETY: The caller must verify the invariants
         // specified in the struct definition.
         unsafe {
             self.as_str().hash(state);
@@ -55,15 +55,15 @@ impl Eq for InternedStr {}
 
 impl PartialEq for InternedStr {
     fn eq(&self, other: &Self) -> bool {
-        // SAFETY: The user must verify the invariants
+        // SAFETY: The caller must verify the invariants
         // specified in the struct definition.
         unsafe { self.as_str() == other.as_str() }
     }
 }
 
 impl Borrow<str> for InternedStr {
     fn borrow(&self) -> &str {
-        // SAFETY: The user must verify the invariants
+        // SAFETY: The caller must verify the invariants
         // specified in the struct definition.
         unsafe { self.as_str() }
     }

boa_interner/src/lib.rs

@@ -232,10 +232,9 @@ impl Interner {
     /// memory inside `head` and that it won't be invalidated
     /// by allocations and deallocations.
     unsafe fn generate_symbol(&mut self, string: NonNull<str>) -> Sym {
-        // SAFETY:  a static `str` lives throughout the entirety of the
-        //          program, so an `InternedStr` pointing to it
-        //          is always safe to use.
         let next = Sym::new(self.len() + 1).expect("Adding one makes `self.len()` always `> 0`");
+        // SAFETY: The caller has to maintain the invariants specified
+        // on the function.
         unsafe {
             let interned = InternedStr::new(string);
             self.spans.push(interned.clone());

boa_interner/src/sym.rs

@@ -98,7 +98,7 @@ impl Sym {
     pub(super) const unsafe fn new_unchecked(value: usize) -> Self {
         Self {
             value:
-            // SAFETY: The user must ensure the invariants of the function.
+            // SAFETY: The caller must ensure the invariants of the function.
             unsafe {
                 NonZeroUsize::new_unchecked(value)
             },