xargs.1: fix truncated examples on old troff

Seventh Edition Unix man(7)[1] and its descendants handle at most six
arguments to macros.  Excess arguments are ignored and not formatted.

[1] https://minnie.tuhs.org/cgi-bin/utree.pl?file=V7/usr/lib/tmac/tmac.an

* xargs/xargs.1 (EXAMPLES): Add quotes.

Discussed at:
https://lists.gnu.org/r/bug-findutils/2025-11/msg00094.html

Copyright-paperwork-exempt: Yes
This commit is contained in:
G. Branden Robinson 2025-11-18 21:48:38 -06:00 committed by Bernhard Voelker
parent 5c31ac2aeb
commit 4055cf7bbc

View File

@ -390,7 +390,7 @@ because it would not actually conflict.
.
.SH "EXAMPLES"
.nf
.B find /tmp \-name core \-type f \-print | xargs /bin/rm \-f
.B "find /tmp \-name core \-type f \-print | xargs /bin/rm \-f"
.fi
.P
Find files named
@ -402,7 +402,7 @@ Note that this will work incorrectly if there are
any filenames containing newlines or spaces.
.
.P
.B find /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm \-f
.B "find /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm \-f"
.P
Find files named
.B core
@ -412,7 +412,7 @@ and delete them, processing filenames in such a way that file or
directory names containing spaces or newlines are correctly handled.
.
.P
.B find /tmp \-depth \-name core \-type f \-delete
.B "find /tmp \-depth \-name core \-type f \-delete"
.P
Find files named
.B core
@ -431,7 +431,7 @@ process).
.
.P
.nf
.B cut \-d: \-f1 < /etc/passwd | sort | xargs echo
.B "cut \-d: \-f1 < /etc/passwd | sort | xargs echo"
.
.fi
Generates a compact listing of all the users on the system.