[PATCH 33/40] xargs/xargs.1: Fix font markup nit.
"G. Branden Robinson" <[email protected]> Thu, 13 Nov 2025 10:50:41 -0600
| Newsgroups | gmane.comp.gnu.findutils.bugs |
|---|---|
| Message-ID | <20251113165041.thpcfvkm4eap52ou@illithid> |
Favor man(7) font macros over *roff font selection escape sequences. Macros are (a) visually less cluttered, (b) interfere less with spell checking, and (c), in groff man(7), automatically apply italic corrections, which otherwise requires explicit use of GNU troff extension escape sequences (`\/` and `\,`). --- xargs/xargs.1 | 36 ++++++++++++++++++++++++++---------- 1 file changed, 26 insertions(+), 10 deletions(-) diff --git a/xargs/xargs.1 b/xargs/xargs.1 index ceb42998..3c8cd69b 100644 --- a/xargs/xargs.1 +++ b/xargs/xargs.1 @@ -122,7 +122,8 @@ .SH OPTIONS . .TP .BI \-E " eof-str" -Set the end-of-file string to \fIeof-str\fR. +Set the end-of-file string to +.IR eof-str . If the end-of-file string occurs as a line of input, the rest of the input is ignored. If neither @@ -139,7 +140,9 @@ .SH OPTIONS .B \-E instead, because it is POSIX compliant while this option is not. -If \fIeof-str\fR is omitted, there is no end-of-file string. +If +.I eof-str +is omitted, there is no end-of-file string. If neither .B \-E nor @@ -147,7 +150,9 @@ .SH OPTIONS is used, no end-of-file string is used. .TP .BI \-I " replace-str" -Replace occurrences of \fIreplace-str\fR in the initial-arguments with +Replace occurrences of +.I replace-str +in the initial-arguments with names read from standard input. Also, unquoted blanks do not terminate input items; instead the separator is the newline character. @@ -178,7 +183,9 @@ .SH OPTIONS instead. .TP .BI \-L " max-lines" -Use at most \fImax-lines\fR nonblank input lines per command line. +Use at most +.I max-lines +nonblank input lines per command line. Trailing blanks cause an input line to be logically continued on the next input line. Implies @@ -203,7 +210,9 @@ .SH OPTIONS instead. .TP .BI \-n " max-args\fR, \fI" "\-\-max\-args" \fR=\fImax-args -Use at most \fImax-args\fR arguments per command line. +Use at most +.I max-args +arguments per command line. Fewer than .I max-args arguments will be used if the size (see the @@ -299,7 +308,9 @@ .SH OPTIONS This option is a GNU extension. .TP .BI \-s " max-chars\fR, \fI" \-\-max\-chars "=\fImax-chars\fR" -Use at most \fImax-chars\fR characters per command line, including the +Use at most +.I max-chars +characters per command line, including the command and initial-arguments and the terminating nulls at the ends of the argument strings. The largest allowed value is system-dependent, and is calculated as the @@ -367,12 +378,14 @@ .SH OPTIONS .PP The options .B \-\-max-lines -(\fB\-L\fP, \fB\-l\fP), +.RB ( \-L , +.BR \-l ), .B \-\-replace -(\fB\-I\fP, \fB\-i\fP) +.RB ( \-I , +.BR \-i ), and .B \-\-max-args -(\fB\-n\fP) +.RB ( \-n ) are mutually exclusive. If some of them are specified at the same time, then .B xargs @@ -386,7 +399,10 @@ .SH OPTIONS The exception to this rule is that the special .I max-args value -\*(lq\fB\-n\fP\fI1\fP\*(rq) +\*(lq1\*(rq +(\*(lq\c +.BI \-n 1\c +\*(rq) is ignored after the .B \-\-replace option and its aliases -- 2.30.2
signature.asc
(application/pgp-signature, 833 B)
-----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAmkWDGEACgkQ0Z6cfXEm bc4q2w/7BwFoqxWMf76LsuGqkUERVnb4j6IRK1qCmE9NyNde5eilg8rQTvs4aMBo zRmwiP7QHawI6BLqcg183tHi7DwF3CM/YbdkdEXZbvPartAYyoEHQN7uSyy+V+ZF kwvUP40I4pvzRhLbISx0zAQDuLGBP6V3DrdDAFGzaAZY/X0chA9W4Za/BaeqY0ih GycCSr1ePDhTfLhx/fXhQ32DkbTOixANtQR7MF/6dHe408yRG9qk9/1tNhAr0Z47 n+VMPgQfAOWiXBZexd6sb9hq8Emm8m9VOoKu348dbj/s0ZftoA+gUQmLxsk7zycI Ag3FlIWvqH4GIY8OjlYXaa3IiO6/gyU5hMMdWo9wYMrEqdJbDvISfFJIDcUNfeXz +yGNo3MQh4SkoiyYYeoxAdkyMCI62sbQ7/GiRzuvCIOxuviz8s8xNriJTKqj3GlN 3fvuFwWiB8H8V7/uOCtdSLYOZynyoaSnXjaGYabhFll7KA5CiFU4ur8eahwP7hC9 ROikJVl0EI/J7FwlXYc058u9BX6Yb2MiG0df4PLNweCno4+cO9zgVnrPJuir3j/i gvz5m0gPl928fe5xA0OsED4TVFKYivXDlUT/LFPxs5z1bHkbqfw37X5BXbDqEvVd Ir5CteTaftbTKxjoV5DXu4dWYj7Frtl3SOo5UEWXc+wel5jtHcs= =tcvw -----END PGP SIGNATURE-----