fix(man): add ellipsis for multi-value positional arguments

Append `...` to positional arguments that accept multiple values
(e.g. `[FILES]...`), matching the `--help` output. Applies to both
the SYNOPSIS and OPTIONS sections.

https://claude.ai/code/session_01CrXuWDMVQsiUBoy6ceACsF

Author: claude

exports/pdu.1

@@ -2,7 +2,7 @@
 .SH NAME
 pdu \- Summarize disk usage of the set of files, recursively for directories.
 .SH SYNOPSIS
-\fBpdu\fR [\fB\-\-json\-input\fR] [\fB\-\-json\-output\fR] [\fB\-b\fR|\fB\-\-bytes\-format\fR \fIBYTES_FORMAT\fR] [\fB\-H\fR|\fB\-\-deduplicate\-hardlinks\fR] [\fB\-x\fR|\fB\-\-one\-file\-system\fR] [\fB\-\-top\-down\fR] [\fB\-\-align\-right\fR] [\fB\-q\fR|\fB\-\-quantity\fR \fIQUANTITY\fR] [\fB\-d\fR|\fB\-\-max\-depth\fR \fIMAX_DEPTH\fR] [\fB\-w\fR|\fB\-\-total\-width\fR \fITOTAL_WIDTH\fR] [\fB\-\-column\-width\fR \fITREE_WIDTH\fR \fIBAR_WIDTH\fR] [\fB\-m\fR|\fB\-\-min\-ratio\fR \fIMIN_RATIO\fR] [\fB\-\-no\-sort\fR] [\fB\-s\fR|\fB\-\-silent\-errors\fR] [\fB\-p\fR|\fB\-\-progress\fR] [\fB\-\-threads\fR \fITHREADS\fR] [\fB\-\-omit\-json\-shared\-details\fR] [\fB\-\-omit\-json\-shared\-summary\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIFILES\fR]
+\fBpdu\fR [\fB\-\-json\-input\fR] [\fB\-\-json\-output\fR] [\fB\-b\fR|\fB\-\-bytes\-format\fR \fIBYTES_FORMAT\fR] [\fB\-H\fR|\fB\-\-deduplicate\-hardlinks\fR] [\fB\-x\fR|\fB\-\-one\-file\-system\fR] [\fB\-\-top\-down\fR] [\fB\-\-align\-right\fR] [\fB\-q\fR|\fB\-\-quantity\fR \fIQUANTITY\fR] [\fB\-d\fR|\fB\-\-max\-depth\fR \fIMAX_DEPTH\fR] [\fB\-w\fR|\fB\-\-total\-width\fR \fITOTAL_WIDTH\fR] [\fB\-\-column\-width\fR \fITREE_WIDTH\fR \fIBAR_WIDTH\fR] [\fB\-m\fR|\fB\-\-min\-ratio\fR \fIMIN_RATIO\fR] [\fB\-\-no\-sort\fR] [\fB\-s\fR|\fB\-\-silent\-errors\fR] [\fB\-p\fR|\fB\-\-progress\fR] [\fB\-\-threads\fR \fITHREADS\fR] [\fB\-\-omit\-json\-shared\-details\fR] [\fB\-\-omit\-json\-shared\-summary\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIFILES\fR]...
 .SH DESCRIPTION
 Summarize disk usage of the set of files, recursively for directories.
 .PP
@@ -11,7 +11,7 @@ Copyright: Apache\-2.0 © 2021 Hoàng Văn Khải <https://github.com/KSXGitHub/
 Sponsor: https://github.com/sponsors/KSXGitHub
 .SH OPTIONS
 .TP
-[\fIFILES\fR]
+[\fIFILES\fR]...
 List of files and/or directories
 .TP
 \fB\-\-json\-input\fR

src/man_page.rs

@@ -115,16 +115,23 @@ fn render_synopsis_option(out: &mut String, arg: &Arg) {
     out.push(']');
 }
 
+fn is_multiple(arg: &Arg) -> bool {
+    arg.get_num_args()
+        .map(|range| range.max_values() > 1)
+        .unwrap_or(false)
+}
+
 fn render_synopsis_positional(out: &mut String, arg: &Arg) {
     let name = arg
         .get_value_names()
         .and_then(|names| names.first())
         .map(|name| name.as_str())
         .unwrap_or_else(|| arg.get_id().as_str());
+    let ellipsis = if is_multiple(arg) { "..." } else { "" };
     if arg.is_required_set() {
-        write!(out, "\\fI{}\\fR", roff_escape(name)).unwrap();
+        write!(out, "\\fI{}\\fR{ellipsis}", roff_escape(name)).unwrap();
     } else {
-        write!(out, "[\\fI{}\\fR]", roff_escape(name)).unwrap();
+        write!(out, "[\\fI{}\\fR]{ellipsis}", roff_escape(name)).unwrap();
     }
 }
 
@@ -194,10 +201,11 @@ fn render_option_header_positional(out: &mut String, arg: &Arg) {
         .and_then(|names| names.first())
         .map(|name| name.as_str())
         .unwrap_or_else(|| arg.get_id().as_str());
+    let ellipsis = if is_multiple(arg) { "..." } else { "" };
     if arg.is_required_set() {
-        writeln!(out, "\\fI{name}\\fR").unwrap();
+        writeln!(out, "\\fI{name}\\fR{ellipsis}").unwrap();
     } else {
-        writeln!(out, "[\\fI{name}\\fR]").unwrap();
+        writeln!(out, "[\\fI{name}\\fR]{ellipsis}").unwrap();
     }
 }