More comments

Author: gridbugs

src/source/buffered.rs

@@ -75,7 +75,10 @@ where
     fn drop(&mut self) {
         // This is necessary to prevent stack overflows deallocating long chains of the mutually
         // recursive `Frame` and `FrameData` types. This iteratively traverses as much of the
-        // chain as needs to be deallocated, and repeatedly "pops" the head off the list.
+        // chain as needs to be deallocated, and repeatedly "pops" the head off the list. This
+        // solves the problem, as when the time comes to actually deallocate the `FrameData`,
+        // the `next` field will contain a `Frame::End`, or an `Arc` with additional references,
+        // so the depth of recursive drops will be bounded.
         loop {
             if let Ok(arc_next) = self.next.get_mut() {
                 if let Some(next_ref) = Arc::get_mut(arc_next) {