Format and add document some

src/lib.rs

@@ -515,10 +515,16 @@ mod serde {
     }
 }
 
+/// Convert value to [`SmolStr`] using [`fmt::Display`], potentially without allocating.
+///
+/// Almost identical to [`ToString`], but converts to `SmolStr` instead.
 pub trait ToSmolStr {
     fn to_smolstr(&self) -> SmolStr;
 }
 
+/// Formats arguments to a [`SmolStr`], potentially without allocating.
+///
+/// See [`alloc::format!`] or [`format_args!`] for syntax documentation.
 #[macro_export]
 macro_rules! format_smolstr {
     ($($tt:tt)*) => {{
@@ -562,7 +568,11 @@ impl fmt::Write for Writer {
                 self.heap.reserve(self.len);
 
                 // copy existing inline bytes over to the heap
-                unsafe { self.heap.as_mut_vec().extend_from_slice(&self.inline[..old_len]); }
+                unsafe {
+                    self.heap
+                        .as_mut_vec()
+                        .extend_from_slice(&self.inline[..old_len]);
+                }
             }
         }
 
@@ -592,4 +602,4 @@ where
     fn to_smolstr(&self) -> SmolStr {
         format_smolstr!("{}", self)
     }
-}
+}

tests/test.rs

@@ -1,6 +1,6 @@
 use proptest::{prop_assert, prop_assert_eq, proptest};
 
-use smol_str::{SmolStr, format_smolstr};
+use smol_str::{format_smolstr, SmolStr};
 
 #[test]
 #[cfg(target_pointer_width = "64")]