add more comments

Signed-off-by: Yuchen Liang <[email protected]>

pageserver/src/virtual_file/owned_buffers_io/aligned_buffer/buffer.rs

@@ -5,6 +5,7 @@ use std::{
 
 use super::{alignment::Alignment, raw::RawAlignedBuffer};
 
+/// An shared, immutable aligned buffer type.
 pub struct AlignedBuffer<A: Alignment> {
     /// Shared raw buffer.
     raw: Arc<RawAlignedBuffer<A>>,

pageserver/src/virtual_file/owned_buffers_io/aligned_buffer/buffer_mut.rs

@@ -6,6 +6,7 @@ use super::{
     raw::RawAlignedBuffer,
 };
 
+/// A mutable aligned buffer type.
 #[derive(Debug)]
 pub struct AlignedBufferMut<A: Alignment> {
     raw: RawAlignedBuffer<A>,
@@ -207,7 +208,7 @@ fn panic_advance(idx: usize, len: usize) -> ! {
     );
 }
 
-/// Safety: [`IoBufferMut`] has exclusive ownership of the io buffer,
+/// Safety: [`AlignedBufferMut`] has exclusive ownership of the io buffer,
 /// and the location remains stable even if [`Self`] is moved.
 unsafe impl<A: Alignment> tokio_epoll_uring::IoBuf for AlignedBufferMut<A> {
     fn stable_ptr(&self) -> *const u8 {

pageserver/src/virtual_file/owned_buffers_io/aligned_buffer/raw.rs

@@ -16,7 +16,7 @@ unsafe impl Send for AlignedBufferPtr {}
 // SAFETY: We gurantees no one besides `IoBufferPtr` itself has the raw pointer.
 unsafe impl Sync for AlignedBufferPtr {}
 
-/// An aligned buffer type used for I/O.
+/// An aligned buffer type.
 #[derive(Debug)]
 pub struct RawAlignedBuffer<A: Alignment> {
     ptr: AlignedBufferPtr,