[PATCH 35/42] xargs.1: fix font markup nit

"G. Branden Robinson" <[email protected]> Tue, 18 Nov 2025 21:49:23 -0600
Newsgroups gmane.comp.gnu.findutils.bugs
Message-ID <20251119034923.73hppx6ayi36v4na@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 d797b079..5d30e685 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
@@ -385,7 +398,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-----

iQIzBAABCAAdFiEEh3PWHWjjDgcrENwa0Z6cfXEmbc4FAmkdPkMACgkQ0Z6cfXEm
bc46gQ/+ONcLVmkHAjxNzWn6EkuFbDwh9RgkgWy/UAZmY4ODeB1ty/St5rK/9gSA
s+11cBoTj4NLZL+B8mlAheBswZoMs1LffkVzeK+xooAQiJjdhUNvpiefJ9Fxw8Qz
ocDuVpyncaoenehe7O0PiZCLTdSVHPlgwQnyB4re4BqPkX6cIa8qCMxsJtl21RGE
KBkUNgucuck0wnUqB/zhFVxDuRg1mHNKP7c+3LSf4VIWRdq/I/PDLhgjycWDpbCq
wrZn2JBOWDR4cHWBBxp40Vp2VdJxs6XveIzVqb9ePr1evZTacDVyD+cfhD74R43h
cI05hp7cA0INcBKEGMv1aD6OJ7vR5hh7Xe/uf1HMwx0U/E1BBbZAINsIChBC4Do3
GQyjMw0nSucM60kkTsCSxbBPy5mVz5PlHPQ4TFjIkb2GusnOR9rqym/BTRfkvc1n
zJ2/6I4/BU0q1kzRr59U2K6ciXi1cgcN6dTmL6BB8TBjucHtnlWerk/oPNw5HGl1
u9jkDlLE7RT/w/7V84IhjPSoKMacMPwyJOusqFZpskOcQ8ElzDPz/Pq7O8j/1Ipu
Sd88VeNkPo/cKKf3N+RoejDy9JE6oC3bhCvbrvoVbOUsfCl5LCRW/8Dq/IKyl6kx
+aeT4UhFGFAWyUgZBMtO0PtfSf27le+mAgtvttGUcI0aGg1wiYE=
=2H8W
-----END PGP SIGNATURE-----