[PATCH 33/42] xargs.1: set file names in italics

"G. Branden Robinson" <[email protected]> Tue, 18 Nov 2025 21:49:04 -0600
Newsgroups	gmane.comp.gnu.findutils.bugs
Message-ID	<20251119034904.wnapz4tfkm4fzgce@illithid>
...not roman.

groff_man_style(7):
   Font style macros
...
     .I [text]
            Set text in an italic or oblique face.  Given no argument, I
            plants a one‐line input trap; text on the next line, which
            can be further formatted with a macro, is set in an italic
            or oblique face.

            Use italics for file and path names, for environment
            variables, for C data types, for enumeration or preprocessor
            constants in C, for variant (user‐replaceable) portions of
            syntax synopses, for the first occurrence (only) of a
            technical concept being introduced, for names of journals
            and of literary works longer than an article, and anywhere a
            parameter requiring replacement by the user is encountered.
            An exception involves variant text in a context already
            typeset in italics, such as file or path names with
            replaceable components; in such cases, follow the convention
            of mathematical typography: set the file or path name in
            italics as usual but use roman for the variant part (see IR
            and RI below), and italics again in running roman text when
            referring to the variant material.
---
 xargs/xargs.1 | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/xargs/xargs.1 b/xargs/xargs.1
index 95a2045f..3922a20f 100644
--- a/xargs/xargs.1
+++ b/xargs/xargs.1
@@ -401,9 +401,9 @@ .SH "EXAMPLES"
 .fi
 .P
 Find files named
-.B core
+.I core
 in or below the directory
-.B /tmp
+.I /tmp
 and delete them.
 Note that this will work incorrectly if there are
 any filenames containing newlines or spaces.
@@ -412,9 +412,9 @@ .SH "EXAMPLES"
 .B "find /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm \-f"
 .P
 Find files named
-.B core
+.I core
 in or below the directory
-.B /tmp
+.I /tmp
 and delete them, processing filenames in such a way that file or
 directory names containing spaces or newlines are correctly handled.
 .
@@ -422,9 +422,9 @@ .SH "EXAMPLES"
 .B "find /tmp \-depth \-name core \-type f \-delete"
 .P
 Find files named
-.B core
+.I core
 in or below the directory
-.B /tmp
+.I /tmp
 and delete them, but more efficiently than in the previous example
 (because we avoid the need to use
 .BR fork (2)
-- 
2.30.2
signature.asc (application/pgp-signature, 833 B)