Skip to content

test: make the man-page readable + sync#10737

Merged
Ecordonnier merged 2 commits intouutils:mainfrom
matttbe:test-man-readable
Feb 5, 2026
Merged

test: make the man-page readable + sync#10737
Ecordonnier merged 2 commits intouutils:mainfrom
matttbe:test-man-readable

Conversation

@matttbe
Copy link
Contributor

@matttbe matttbe commented Feb 5, 2026

The previous version was all compacted, and clearly not readable.

image

Add a bunch of new lines and indentations to fix that.

The new version looks more like the one from GNU coreutils now.

While at it, also add STRING1 > STRING2 and STRING1 < STRING2 that were missing but supported.

Note: this PR fixes #8362. It is similar to #9005 (with more visual changes), but here, I only focused on fixing the man page. I'm not sure adding a generic test is easy to do and that useful. More changes and tests can be added once clap-rs/clap#5900 is implemented, but I think these modifications only in the man-pages are enough for the moment.

The previous version was all compacted, and clearly not readable. Add a
bunch of new lines and indentations to fix that.

The new version looks more like the one from GNU coreutils now.
When comparing this man-page with the one from GNU coreutils, I noticed
these two items were missing from the documentation while supported in
the app.

Adding them here using the same text from GNU coreutils.
@github-actions
Copy link

github-actions bot commented Feb 5, 2026

GNU testsuite comparison:

GNU test failed: tests/tail/symlink. tests/tail/symlink is passing on 'main'. Maybe you have to rebase?

@codspeed-hq
Copy link

codspeed-hq bot commented Feb 5, 2026

Merging this PR will degrade performance by 4.01%

❌ 1 regressed benchmark
✅ 283 untouched benchmarks
⏩ 38 skipped benchmarks1

⚠️ Please fix the performance issues or acknowledge them on CodSpeed.

Performance Changes

Mode Benchmark BASE HEAD Efficiency
Simulation cp_large_file[16] 367.6 µs 382.9 µs -4.01%

Comparing matttbe:test-man-readable (2b65dfd) with main (b556119)

Open in CodSpeed

Footnotes

  1. 38 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports.

@Ecordonnier Ecordonnier self-assigned this Feb 5, 2026
@Ecordonnier Ecordonnier merged commit 08354c9 into uutils:main Feb 5, 2026
154 of 156 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

man 1 test is badly formated

2 participants