[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-----