fix: resolve broken intra-doc links in tail, csplit, and split utilities

naoNao89 · naoNao89 · commit 712091a85464 · 2025-11-01T15:40:51.000+07:00
Fixed broken intra-doc links that reference struct fields and enum variants
across three utilities. These caused rustdoc warnings that are treated as
errors in CI with -Dwarnings flag.

Changes:
- tail/chunks.rs:211: [Some(bytes)] → `Some(bytes)`
- csplit/csplit.rs:283: [self.dev_null] → `self.dev_null`
- csplit/csplit.rs:575: [self.size] → `self.size`
- split/number.rs:115: [Err(Overflow)] → `Err(Overflow)`
- split/number.rs:125: [Err(Overflow)] → `Err(Overflow)`
- split/number.rs:215: [Err(Overflow)] → `Err(Overflow)`
diff --git a/src/uu/csplit/src/csplit.rs b/src/uu/csplit/src/csplit.rs
@@ -280,7 +280,7 @@ impl SplitWriter<'_> {
     }
 
     /// Writes the line to the current split.
-    /// If [`self.dev_null`] is true, then the line is discarded.
+    /// If `self.dev_null` is true, then the line is discarded.
     ///
     /// # Errors
     ///
@@ -572,7 +572,7 @@ where
         self.size = size;
     }
 
-    /// Add a line to the buffer. If the buffer has [`self.size`] elements, then its head is removed and
+    /// Add a line to the buffer. If the buffer has `self.size` elements, then its head is removed and
     /// the new line is pushed to the buffer. The removed head is then available in the returned
     /// option.
     fn add_line_to_buffer(&mut self, ln: usize, line: String) -> Option<String> {
diff --git a/src/uu/split/src/number.rs b/src/uu/split/src/number.rs
@@ -112,7 +112,7 @@ impl Number {
     ///
     /// If incrementing this number would result in an overflow beyond
     /// the maximum representable number, then return
-    /// [`Err(Overflow)`]. The [`FixedWidthNumber`] overflows, but
+    /// `Err(Overflow)`. The [`FixedWidthNumber`] overflows, but
     /// [`DynamicWidthNumber`] does not.
     ///
     /// The [`DynamicWidthNumber`] follows a non-standard incrementing
@@ -122,7 +122,7 @@ impl Number {
     ///
     /// # Errors
     ///
-    /// This method returns [`Err(Overflow)`] when attempting to
+    /// This method returns `Err(Overflow)` when attempting to
     /// increment beyond the largest representable number.
     ///
     /// # Examples
@@ -212,7 +212,7 @@ impl FixedWidthNumber {
     ///
     /// This method adds one to this number. If incrementing this
     /// number would require more digits than are available with the
-    /// specified width, then this method returns [`Err(Overflow)`].
+    /// specified width, then this method returns `Err(Overflow)`.
     fn increment(&mut self) -> Result<(), Overflow> {
         for i in (0..self.digits.len()).rev() {
             // Increment the current digit.
diff --git a/src/uu/tail/src/chunks.rs b/src/uu/tail/src/chunks.rs
@@ -208,7 +208,7 @@ impl BytesChunk {
 
     /// Fills `self.buffer` with maximal [`BUFFER_SIZE`] number of bytes, draining the reader by
     /// that number of bytes. If EOF is reached (so 0 bytes are read), then returns
-    /// [`UResult<None>`] or else the result with [`Some(bytes)`] where bytes is the number of bytes
+    /// [`UResult<None>`] or else the result with `Some(bytes)` where bytes is the number of bytes
     /// read from the source.
     pub fn fill(&mut self, filehandle: &mut impl BufRead) -> UResult<Option<usize>> {
         let num_bytes = filehandle.read(&mut self.buffer)?;
