readme and some comments

Author: jdonszelmann

README.md

@@ -88,9 +88,9 @@ compared here can grow unbounded (though in benchmarks they weren't filled over
 
 # Features
 
-| name  | default | description                                                                                                  |
-|-------|---------|--------------------------------------------------------------------------------------------------------------|
-| alloc | ✓       | Disable this feature to remove the dependency on alloc. Disabling this feature  makes `ringbuffer` `no_std`. |
+| name  | default | description                                                                                                |
+|-------|---------|------------------------------------------------------------------------------------------------------------|
+| alloc | ✓       | Disable this feature to remove the dependency on alloc.                                                    |
 
 # License
 

src/with_alloc/alloc_ringbuffer.rs

@@ -324,6 +324,7 @@ unsafe impl<T, SIZE: RingbufferSize> RingBuffer<T> for AllocRingBuffer<T, SIZE>
 
     #[inline]
     fn fill_with<F: FnMut() -> T>(&mut self, mut f: F) {
+        // This clear is necessary so that the drop methods are called.
         self.clear();
 
         self.readptr = 0;