add comments and slight formatting for status_bar method

Author: aaron-ang

src/uu/more/src/more.rs

@@ -645,7 +645,7 @@ impl<'a> Pager<'a> {
         wrong_key: Option<char>,
     ) -> UResult<()> {
         self.draw_lines(stdout, first_paint)?;
-        self.draw_prompt(stdout, wrong_key);
+        self.draw_status_bar(stdout, wrong_key);
         stdout.flush()?;
         Ok(())
     }
@@ -699,15 +699,13 @@ impl<'a> Pager<'a> {
         }
     }
 
-    /// Draws the status bar/prompt at the bottom of the screen
-    /// with appropriate progress information and user feedback
-    fn draw_prompt(&mut self, stdout: &mut impl Write, wrong_key: Option<char>) {
+    fn draw_status_bar(&mut self, stdout: &mut impl Write, wrong_key: Option<char>) {
         // Calculate the index of the last visible line
         let lower_mark = (self.upper_mark + self.content_rows).min(self.lines.len() - 1);
 
         // Determine progress information to display
         // - Show next file name when at EOF and there is a next file
-        // - Otherwise show percentage through current file (if available)
+        // - Otherwise show percentage of the file read (if available)
         let progress_info = if self.eof_reached && self.next_file.is_some() {
             format!("(Next file: {})", self.next_file.unwrap())
         } else {
@@ -730,13 +728,14 @@ impl<'a> Pager<'a> {
         // - In normal mode: ring bell (BELL char) on wrong key or show basic prompt
         let banner = match (self.silent, wrong_key) {
             (true, Some(key)) => format!(
-                "{status} [Unknown key: '{key}'. Press 'h' for instructions. (unimplemented)]"
+                "{status}[Unknown key: '{key}'. Press 'h' for instructions. (unimplemented)]"
             ),
             (true, None) => format!("{status}{HELP_MESSAGE}"),
             (false, Some(_)) => format!("{status}{BELL}"),
             (false, None) => status,
         };
 
+        // Draw the status bar at the bottom of the screen
         write!(
             stdout,
             "\r{}{banner}{}",
@@ -907,7 +906,7 @@ mod tests {
             .silent(true)
             .build();
         let mut buf = Vec::new();
-        pager.draw_prompt(&mut buf, None);
+        pager.draw_status_bar(&mut buf, None);
         let buf_str = String::from_utf8_lossy(&buf);
         assert!(buf_str.contains(HELP_MESSAGE));
     }