clean up docs a little

Author: HawaiianSpork

arrow-data/src/transform/mod.rs

@@ -724,10 +724,6 @@ impl<'a> MutableArrayData<'a> {
     /// Extends the in progress array with a region of the input arrays, returning an error on
     /// overflow.
     ///
-    /// Prefer this over [`extend`](Self::extend) to handle cases where the data exceeds the
-    /// capacity of the offset type (e.g. more than 2 GiB in a `StringArray`). The error message
-    /// will indicate which array type overflowed and suggest a larger type.
-    ///
     /// # Arguments
     /// * `index` - the index of array that you want to copy values from
     /// * `start` - the start index of the chunk (inclusive)

arrow-data/src/transform/utils.rs

@@ -30,9 +30,6 @@ pub(super) fn resize_for_bits(buffer: &mut MutableBuffer, len: usize) {
 }
 
 /// Extends `buffer` with the re-based offsets from `offsets`, returning an error on overflow.
-///
-/// Use this instead of [`extend_offsets`] to get a proper error when data exceeds the
-/// capacity of the offset type (e.g. when appending more than 2 GiB into a `StringArray`).
 pub(super) fn try_extend_offsets<T: ArrowNativeType + Integer + CheckedAdd>(
     buffer: &mut MutableBuffer,
     mut last_offset: T,